Semaphore definitions. More...

Detailed Description

Semaphore definitions.

Author: Martine Lenders mlend.nosp@m.ers@.nosp@m.inf.f.nosp@m.u-be.nosp@m.rlin..nosp@m.de; Christian Mehlis mehli.nosp@m.s@in.nosp@m.f.fu-.nosp@m.berl.nosp@m.in.de; René Kijewski kijew.nosp@m.ski@.nosp@m.inf.f.nosp@m.u-be.nosp@m.rlin..nosp@m.de; Víctor Ariño victo.nosp@m.r.ar.nosp@m.ino@z.nosp@m.ii.a.nosp@m.ero

Definition in file sema.h.

#include <stdint.h>
#include "mutex.h"
#include "ztimer.h"

Include dependency graph for sema.h:

This graph shows which files directly or indirectly include this file:

Macros
#define	SEMA_CREATE(value) { (value), SEMA_OK, MUTEX_INIT }
	Creates semaphore statically.

#define	SEMA_CREATE_LOCKED() { (0), SEMA_OK, MUTEX_INIT_LOCKED }
	Creates semaphore statically initialized to 0.

Enumerations
enum	sema_state_t { SEMA_OK = 0 , SEMA_DESTROY }
	A Semaphore states. More...

Functions
void	sema_create (sema_t *sema, unsigned int value)
	Creates semaphore dynamically.

void	sema_destroy (sema_t *sema)
	Destroys a semaphore.

static unsigned	sema_get_value (const sema_t *sema)
	Get a semaphore's current value.

int	_sema_wait_ztimer (sema_t sema, int block, ztimer_clock_t clock, uint32_t timeout)
	Wait for a semaphore, blocking or non-blocking.

static int	sema_wait (sema_t *sema)
	Wait for a semaphore being posted (without timeout).

static int	sema_try_wait (sema_t *sema)
	Test if the semaphore is posted.

static int	sema_wait_timed (sema_t *sema, uint64_t timeout)
	Wait for a semaphore being posted with a 64bit timeout.

static int	sema_wait_timed_ztimer (sema_t sema, ztimer_clock_t clock, uint32_t timeout)
	Wait for a semaphore being posted, using ztimer as backend.

int	sema_post (sema_t *sema)
	Signal semaphore.

Data Structures