From 71e1a86a033c380f85dd300d788af63bfef25bab Mon Sep 17 00:00:00 2001 From: "Luke T. Shumaker" Date: Thu, 26 Sep 2024 19:36:54 -0600 Subject: wip reorg --- libcr_ipc/coroutine_sema.h | 35 +++++++++++++++++++++++++++++++++++ 1 file changed, 35 insertions(+) create mode 100644 libcr_ipc/coroutine_sema.h (limited to 'libcr_ipc/coroutine_sema.h') diff --git a/libcr_ipc/coroutine_sema.h b/libcr_ipc/coroutine_sema.h new file mode 100644 index 0000000..57d5855 --- /dev/null +++ b/libcr_ipc/coroutine_sema.h @@ -0,0 +1,35 @@ +/* coroutine_sema.h - Simple semaphores for coroutine.{h,c} + * + * Copyright (C) 2024 Luke T. Shumaker + * SPDX-Licence-Identifier: AGPL-3.0-or-later + */ + +#ifndef _COROUTINE_SEMA_H_ +#define _COROUTINE_SEMA_H_ + +/** + * A cr_sema_t is a fair unbounded[1] counting semaphore. + * + * [1]: Well, INT_MAX + */ +typedef struct sema_t cr_sema_t; + +/** + * Increment the semaphore, + * + * @blocks never + * @yields never + * @run_in anywhere (coroutine, sighandler) + */ +void cr_sema_signal(cr_sema_t *sema); + +/** + * Wait until the semaphore is >0, then decrement it. + * + * @blocks maybe + * @yields maybe + * @may_run_in coroutine + */ +void cr_sema_wait(cr_sema_t *sema); + +#endif /* _COROUTINE_SEMA_H_ */ -- cgit v1.2.3-2-g168b