ost::Runlist Class Reference

A runlist is used to restrict concurrent exection to a limited set of concurrent sessions, much like a semaphore. More...

#include <misc.h>

Inheritance diagram for ost::Runlist:

ost::Mutex

List of all members.

Public Member Functions

 Runlist (unsigned count=1)
 Create a new runlist with a specified limit.
bool add (Runable *run)
 Add a runable object to this runlist.
void del (Runable *run)
 Remove a runable object from the wait list or notify when it is done running so that the used count can be decremented.
void set (unsigned limit)
 Set the limit.

Protected Member Functions

void check (void)

Protected Attributes

unsigned limit
unsigned used


Detailed Description

A runlist is used to restrict concurrent exection to a limited set of concurrent sessions, much like a semaphore.

However, the runlist differs in that it notifies objects when they become ready to run, rather than requiring them to wait and "block" for the semaphore count to become low enough to continue.

Author:
David Sugar <dyfet@ostel.com> list of runable objects.

Constructor & Destructor Documentation

ost::Runlist::Runlist ( unsigned  count = 1  ) 

Create a new runlist with a specified limit.

Parameters:
count limit before wait queuing.


Member Function Documentation

void ost::Runlist::check ( void   )  [protected]

bool ost::Runlist::add ( Runable run  ) 

Add a runable object to this runlist.

If the number of entries running is below the limit, then add returns true otherwise the entry is added to the list.

Returns:
true if immediately ready to run
Parameters:
run pointer to runable object.

void ost::Runlist::del ( Runable run  ) 

Remove a runable object from the wait list or notify when it is done running so that the used count can be decremented.

Parameters:
run pointer to runable object.

void ost::Runlist::set ( unsigned  limit  ) 

Set the limit.

Parameters:
limit to use.


Member Data Documentation

unsigned ost::Runlist::limit [protected]

unsigned ost::Runlist::used [protected]


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

Generated on Fri Jan 8 01:25:57 2016 for GNU CommonC++ by  doxygen 1.5.6