Network device transmission queue. More...
#include "net-device.h"
Public Types | |
typedef Callback< void > | WakeCallback |
Callback invoked by netdevices to wake upper layers. More... | |
Public Member Functions | |
NetDeviceQueue () | |
virtual | ~NetDeviceQueue () |
Ptr< QueueLimits > | GetQueueLimits () |
Get queue limits to this queue. More... | |
bool | IsStopped (void) const |
Get the status of the device transmission queue. More... | |
void | NotifyQueuedBytes (uint32_t bytes) |
Called by the netdevice to report the number of bytes queued to the device queue. More... | |
void | NotifyTransmittedBytes (uint32_t bytes) |
Called by the netdevice to report the number of bytes it is going to transmit. More... | |
void | ResetQueueLimits () |
Reset queue limits state. More... | |
void | SetQueueLimits (Ptr< QueueLimits > ql) |
Set queue limits to this queue. More... | |
virtual void | SetWakeCallback (WakeCallback cb) |
Set the wake callback. More... | |
virtual void | Start (void) |
Called by the device to start this device transmission queue. More... | |
virtual void | Stop (void) |
Called by the device to stop this device transmission queue. More... | |
virtual void | Wake (void) |
Called by the device to wake the queue disc associated with this device transmission queue. More... | |
![]() | |
SimpleRefCount () | |
Constructor. More... | |
SimpleRefCount (const SimpleRefCount &o) | |
Copy constructor. More... | |
uint32_t | GetReferenceCount (void) const |
Get the reference count of the object. More... | |
SimpleRefCount & | operator= (const SimpleRefCount &o) |
Assignment. More... | |
void | Ref (void) const |
Increment the reference count. More... | |
void | Unref (void) const |
Decrement the reference count. More... | |
Private Attributes | |
Ptr< QueueLimits > | m_queueLimits |
Queue limits object. More... | |
bool | m_stoppedByDevice |
True if the queue has been stopped by the device. More... | |
bool | m_stoppedByQueueLimits |
True if the queue has been stopped by a queue limits object. More... | |
WakeCallback | m_wakeCallback |
Wake callback. More... | |
Additional Inherited Members | |
![]() | |
static void | Cleanup (void) |
Noop. More... | |
Network device transmission queue.
This class stores information about a single transmission queue of a network device that is exposed to queue discs. Such information includes the state of the transmission queue (whether it has been stopped or not) and data used by techniques such as Byte Queue Limits.
This class roughly models the struct netdev_queue of Linux.
Definition at line 161 of file net-device.h.
typedef Callback< void > ns3::NetDeviceQueue::WakeCallback |
Callback invoked by netdevices to wake upper layers.
Definition at line 196 of file net-device.h.
ns3::NetDeviceQueue::NetDeviceQueue | ( | ) |
Definition at line 75 of file net-device.cc.
References NS_LOG_FUNCTION.
|
virtual |
Definition at line 82 of file net-device.cc.
References NS_LOG_FUNCTION.
Ptr< QueueLimits > ns3::NetDeviceQueue::GetQueueLimits | ( | ) |
Get queue limits to this queue.
Definition at line 179 of file net-device.cc.
References m_queueLimits, and NS_LOG_FUNCTION.
bool ns3::NetDeviceQueue::IsStopped | ( | void | ) | const |
Get the status of the device transmission queue.
Called by queue discs to enquire about the status of a given transmission queue. This is the analogous to the netif_tx_queue_stopped function of the Linux kernel.
Definition at line 88 of file net-device.cc.
References m_stoppedByDevice, and m_stoppedByQueueLimits.
void ns3::NetDeviceQueue::NotifyQueuedBytes | ( | uint32_t | bytes | ) |
Called by the netdevice to report the number of bytes queued to the device queue.
bytes | number of bytes queued to the device queue |
Definition at line 124 of file net-device.cc.
References m_queueLimits, m_stoppedByQueueLimits, and NS_LOG_FUNCTION.
void ns3::NetDeviceQueue::NotifyTransmittedBytes | ( | uint32_t | bytes | ) |
Called by the netdevice to report the number of bytes it is going to transmit.
bytes | number of bytes the device is going to transmit |
Definition at line 140 of file net-device.cc.
References ns3::Callback< R, T1, T2, T3, T4, T5, T6, T7, T8, T9 >::IsNull(), m_queueLimits, m_stoppedByQueueLimits, m_wakeCallback, and NS_LOG_FUNCTION.
void ns3::NetDeviceQueue::ResetQueueLimits | ( | ) |
Reset queue limits state.
Definition at line 161 of file net-device.cc.
References m_queueLimits, and NS_LOG_FUNCTION.
void ns3::NetDeviceQueue::SetQueueLimits | ( | Ptr< QueueLimits > | ql | ) |
Set queue limits to this queue.
ql | the queue limits associated to this queue |
Definition at line 172 of file net-device.cc.
References m_queueLimits, and NS_LOG_FUNCTION.
|
virtual |
Set the wake callback.
cb | the callback to set |
Called by the traffic control layer to set the wake callback. The wake callback is invoked by the device whenever it is needed to "wake" the upper layers (i.e., solicitate the queue disc associated with this transmission queue (in case of multi-queue aware queue discs) or to the network device (otherwise) to send packets down to the device).
Definition at line 118 of file net-device.cc.
References m_wakeCallback.
|
virtual |
Called by the device to start this device transmission queue.
This is the analogous to the netif_tx_start_queue function of the Linux kernel.
Definition at line 94 of file net-device.cc.
References m_stoppedByDevice.
Referenced by Wake().
|
virtual |
Called by the device to stop this device transmission queue.
This is the analogous to the netif_tx_stop_queue function of the Linux kernel.
Definition at line 100 of file net-device.cc.
References m_stoppedByDevice.
|
virtual |
Called by the device to wake the queue disc associated with this device transmission queue.
This is done by invoking the wake callback. This is the analogous to the netif_tx_wake_queue function of the Linux kernel.
Definition at line 106 of file net-device.cc.
References ns3::Callback< R, T1, T2, T3, T4, T5, T6, T7, T8, T9 >::IsNull(), m_wakeCallback, and Start().
|
private |
Queue limits object.
Definition at line 242 of file net-device.h.
Referenced by GetQueueLimits(), NotifyQueuedBytes(), NotifyTransmittedBytes(), ResetQueueLimits(), and SetQueueLimits().
|
private |
True if the queue has been stopped by the device.
Definition at line 240 of file net-device.h.
Referenced by IsStopped(), Start(), and Stop().
|
private |
True if the queue has been stopped by a queue limits object.
Definition at line 241 of file net-device.h.
Referenced by IsStopped(), NotifyQueuedBytes(), and NotifyTransmittedBytes().
|
private |
Wake callback.
Definition at line 243 of file net-device.h.
Referenced by NotifyTransmittedBytes(), SetWakeCallback(), and Wake().