interface xdc.runtime.knl.ISemaphore
index URL

Interface implemented by all front-end semaphore providers

SemThread and SemProcess. [EXPERIMENTAL] Semaphores can be used for synchronization and mutual exclusion. [ more ... ]
XDCspec summary sourced in xdc/runtime/knl/ISemaphore.xdc
interface ISemaphore {  ...
// inherits xdc.runtime.IModule
instance:  ...
XDCspec declarations sourced in xdc/runtime/knl/ISemaphore.xdc
package xdc.runtime.knl;
 
interface ISemaphore {
module-wide constants & types
    const UInt FOREVER// Used as the timeout value to specify wait forever = ~(0);
 
    enum Mode// Types of semaphores {
        Mode_COUNTING// Counting semaphore,
        Mode_BINARY// Binary Semaphore
    };
 
    enum PendStatus// Error codes returned by Semaphore_pend {
        PendStatus_ERROR,
        PendStatus_TIMEOUT,
        PendStatus_SUCCESS
    };
module-wide config parameters
    metaonly config Types.Common$ common$// Common module configuration parameters;
 
 
instance:
per-instance config parameters
    config ISemaphore.Mode mode// Semaphore mode. Default is COUNTING = ISemaphore.Mode_COUNTING;
per-instance functions
    Int pend// Wait for the semaphore to become available(UInt timeout, Error.Block *eb);
    Bool post// Increment the semaphore count(Error.Block *eb);
}
DETAILS
SemThread and SemProcess. [EXPERIMENTAL] Semaphores can be used for synchronization and mutual exclusion.
pend() is used to wait for a semaphore. The timeout parameter allows the caller to wait until a timeout, wait indefinitely, or not wait at all. The return value indicates whether or not the wait was successful.
post() is used to signal a semaphore. If no thread is waiting on the semaphore, then post() increments the semaphore count (for binary semaphores, the count is always 0 or 1).
 
const ISemaphore.FOREVER
index URL

Used as the timeout value to specify wait forever

XDCspec declarations sourced in xdc/runtime/knl/ISemaphore.xdc
const UInt FOREVER = ~(0);
 
 
enum ISemaphore.Mode
index URL

Types of semaphores

XDCspec declarations sourced in xdc/runtime/knl/ISemaphore.xdc
enum Mode {
    Mode_COUNTING,
    // Counting semaphore
    Mode_BINARY
    // Binary Semaphore
};
 
 
enum ISemaphore.PendStatus
index URL

Error codes returned by Semaphore_pend

XDCspec declarations sourced in xdc/runtime/knl/ISemaphore.xdc
enum PendStatus {
    PendStatus_ERROR,
    PendStatus_TIMEOUT,
    PendStatus_SUCCESS
};
 
 
metaonly config ISemaphore.common$  // module-wide
index URL

Common module configuration parameters

XDCspec declarations sourced in xdc/runtime/knl/ISemaphore.xdc
metaonly config Types.Common$ common$;
 
DETAILS
All modules have this configuration parameter. Its name contains the '$' character to ensure it does not conflict with configuration parameters declared by the module. This allows new configuration parameters to be added in the future without any chance of breaking existing modules.
 
config ISemaphore.mode  // instance
index URL

Semaphore mode. Default is COUNTING

XDCspec declarations sourced in xdc/runtime/knl/ISemaphore.xdc
config ISemaphore.Mode mode = ISemaphore.Mode_COUNTING;
 
DETAILS
When mode is BINARY , the semaphore has only two states, available and unavailable. When mode is COUNTING, the semaphore keeps track of number of times a semaphore is posted.
 
ISemaphore.pend()  // instance
index URL

Wait for the semaphore to become available

XDCspec declarations sourced in xdc/runtime/knl/ISemaphore.xdc
Int pend(UInt timeout, Error.Block *eb);
 
ARGUMENTS
timeout — timeout in microseconds
eb — error block
DETAILS
RETURNS
refer to description above
 
ISemaphore.post()  // instance
index URL

Increment the semaphore count

XDCspec declarations sourced in xdc/runtime/knl/ISemaphore.xdc
Bool post(Error.Block *eb);
 
ARGUMENTS
eb — error block
RETURNS
true for success, false for error in error block
generated on Thu, 01 Mar 2012 16:58:44 GMT