ACE
6.3.3
|
Implements a user-space queue to send Reactor notifications. More...
#include <Notification_Queue.h>
Public Member Functions | |
ACE_Notification_Queue () | |
~ACE_Notification_Queue () | |
int | open () |
Pre-allocate resources in the queue. More... | |
void | reset () |
Release all resources in the queue. More... | |
int | purge_pending_notifications (ACE_Event_Handler *eh, ACE_Reactor_Mask mask) |
Remove all elements in the queue matching eh and mask . More... | |
int | push_new_notification (ACE_Notification_Buffer const &buffer) |
Add a new notification to the queue. More... | |
int | pop_next_notification (ACE_Notification_Buffer ¤t, bool &more_messages_queued, ACE_Notification_Buffer &next) |
Extract the next notification from the queue. More... | |
Private Types | |
typedef ACE_Intrusive_List< ACE_Notification_Queue_Node > | Buffer_List |
Private Member Functions | |
int | allocate_more_buffers () |
Allocate more memory for the queue. More... | |
Private Member Functions inherited from ACE_Copy_Disabled | |
ACE_Copy_Disabled (void) | |
Default constructor. More... | |
Private Attributes | |
ACE_Unbounded_Queue< ACE_Notification_Queue_Node * > | alloc_queue_ |
Buffer_List | notify_queue_ |
Keeps track of all pending notifications. More... | |
Buffer_List | free_queue_ |
Keeps track of all free buffers. More... | |
ACE_SYNCH_MUTEX | notify_queue_lock_ |
Synchronization for handling of queues. More... | |
Implements a user-space queue to send Reactor notifications.
The ACE_Reactor uses a pipe to send wake up the thread running the event loop from other threads. This pipe can be limited in size under some operating systems. For some applications, this limit presents a problem. A user-space notification queue is used to overcome those limitations. The queue tries to use as few resources on the pipe as possible, while keeping all the data in user space.
This code was refactored from Select_Reactor_Base.
ACE_Notification_Queue::ACE_Notification_Queue | ( | ) |
ACE_Notification_Queue::~ACE_Notification_Queue | ( | ) |
|
private |
Allocate more memory for the queue.
int ACE_Notification_Queue::open | ( | void | ) |
Pre-allocate resources in the queue.
int ACE_Notification_Queue::pop_next_notification | ( | ACE_Notification_Buffer & | current, |
bool & | more_messages_queued, | ||
ACE_Notification_Buffer & | next | ||
) |
Extract the next notification from the queue.
int ACE_Notification_Queue::purge_pending_notifications | ( | ACE_Event_Handler * | eh, |
ACE_Reactor_Mask | mask | ||
) |
Remove all elements in the queue matching eh
and mask
.
I suggest reading the documentation in ACE_Reactor to find a more detailed description. This is just a helper function.
int ACE_Notification_Queue::push_new_notification | ( | ACE_Notification_Buffer const & | buffer | ) |
Add a new notification to the queue.
void ACE_Notification_Queue::reset | ( | ) |
Release all resources in the queue.
|
private |
Keeps track of allocated arrays of type ACE_Notification_Buffer. The idea is to amortize allocation costs by allocating multiple ACE_Notification_Buffer objects at a time.
|
private |
Keeps track of all free buffers.
|
private |
Keeps track of all pending notifications.
|
private |
Synchronization for handling of queues.