##### Synopsis

    #include <ctl_api.h>
    unsigned ctl_wait_semaphore(CTL_SEMAPHORE_t *s,
                                unsigned use_timeout,
                                CTL_TIME_t timeout);

##### Description

The ctl_wait_semaphore waits for the semaphore pointed at by s to be non-zero. If the semaphore is zero then the caller will block unless use_timeout is non-zero and the current time reaches the timeout value. If the timeout occured the function returns zero otherwise it returns one.

##### Restrictions

This function should not be called from an interrupt service routine.

##### Portability

ctl_wait_semaphore is provided in every implementation of the CrossWorks tasking library.

##### See Also

Semaphores