RTI Connext DDS Micro  Version 2.4.6
 All Data Structures Files Functions Variables Typedefs Enumerations Enumerator Macros Groups Pages
OSAPI Semaphore

Abstract Semaphore API. More...

Typedefs

typedef struct OSAPI_Semaphore OSAPI_Semaphore_T
 Abstract semaphore object. More...
 

Functions

OSAPI_Semaphore_TOSAPI_Semaphore_new (void)
 Create a semaphore. More...
 
RTI_BOOL OSAPI_Semaphore_delete (OSAPI_Semaphore_T *self)
 Delete a semaphore. More...
 
RTI_BOOL OSAPI_Semaphore_take (OSAPI_Semaphore_T *self, RTI_INT32 timeout, RTI_INT32 *fail_reason)
 Take a semaphore. More...
 
RTI_BOOL OSAPI_Semaphore_give (OSAPI_Semaphore_T *self)
 Give a semaphore. More...
 

Detailed Description

Abstract Semaphore API.

Typedef Documentation

typedef struct OSAPI_Semaphore OSAPI_Semaphore_T

Abstract semaphore object.

Function Documentation

OSAPI_Semaphore_T* OSAPI_Semaphore_new ( void  )

Create a semaphore.

Returns
Pointer to a semaphore with a value of 1 on success, NULL on failure.
See Also
Introduction, OSAPI_Semaphore_delete
RTI_BOOL OSAPI_Semaphore_delete ( OSAPI_Semaphore_T self)

Delete a semaphore.

Parameters
[in]selfSemaphore created with OSAPI_Semaphore_new.
Returns
RTI_TRUE on success, RTI_FALSE on failure.
See Also
Introduction, OSAPI_Semaphore_new
RTI_BOOL OSAPI_Semaphore_take ( OSAPI_Semaphore_T self,
RTI_INT32  timeout,
RTI_INT32 *  fail_reason 
)

Take a semaphore.

Parameters
[in]selfSemaphore previously created with OSAPI_Semaphore_new.
[in]timeoutTimeout in ms. The take call will wait at most timeout ms before returning. If OSAPI_SEMAPHORE_TIMEOUT_INFINITE is specified, the call will not return until the semaphore has a value of 1 or higher.
[out]fail_reasonThis parameter is not used, but present for compatibility reasons.
Returns
RTI_TRUE on success, RTI_FALSE on failure.
See Also
Introduction, OSAPI_Semaphore_give
RTI_BOOL OSAPI_Semaphore_give ( OSAPI_Semaphore_T self)

Give a semaphore.

Parameters
[in]selfSemaphore previously created with OSAPI_Semaphore_new.
Returns
RTI_TRUE on success, RTI_FALSE on failure.
See Also
Introduction, OSAPI_Semaphore_take

RTI Connext DDS Micro Version 2.4.6 Copyright © Mon Jan 25 2016 Real-Time Innovations, Inc