L4Re Operating System Framework – Interface and Usage Documentation
Loading...
Searching...
No Matches
semaphore.h
Go to the documentation of this file.
1
6/*
7 * (c) 2015 Alexander Warg <alexander.warg@kernkonzept.com>
8 *
9 * This file is part of TUD:OS and distributed under the terms of the
10 * GNU General Public License 2.
11 * Please see the COPYING-GPL-2 file for details.
12 *
13 * As a special exception, you may use this file as part of a free software
14 * library without restriction. Specifically, if other files instantiate
15 * templates or use macros or inline functions from this file, or you compile
16 * this file and link it with other files to produce an executable, this
17 * file does not by itself cause the resulting executable to be covered by
18 * the GNU General Public License. This exception does not however
19 * invalidate any other reasons why the executable file might be covered by
20 * the GNU General Public License.
21 */
22
23#pragma once
24
25#include <l4/sys/irq.h>
26
36enum L4_semaphore_op
37{
38 L4_SEMAPHORE_OP_DOWN = 0,
39 // semaphore up is IRQ_OP_TRIGGER with IRQ/Triggerable protocol
40};
41
60
65l4_semaphore_up_u(l4_cap_idx_t sem, l4_utcb_t *utcb) L4_NOTHROW
66{
67 return l4_irq_trigger_u(sem, utcb);
68}
69
90
95l4_semaphore_down_u(l4_cap_idx_t sem, l4_timeout_t to,
96 l4_utcb_t *utcb) L4_NOTHROW;
97
98
100l4_semaphore_down_u(l4_cap_idx_t sem, l4_timeout_t to,
101 l4_utcb_t *utcb) L4_NOTHROW
102{
103 l4_msg_regs_t *m = l4_utcb_mr_u(utcb);
104 m->mr[0] = L4_SEMAPHORE_OP_DOWN;
105 return l4_ipc_call(sem, utcb, l4_msgtag(L4_PROTO_SEMAPHORE, 1, 0, 0), to);
106}
107
108
111{
112 return l4_semaphore_down_u(sem, to, l4_utcb());
113}
114
unsigned long l4_cap_idx_t
Capability selector type.
Definition types.h:358
l4_msgtag_t l4_ipc_call(l4_cap_idx_t object, l4_utcb_t *utcb, l4_msgtag_t tag, l4_timeout_t timeout) L4_NOTHROW
Object call (usual invocation).
Definition ipc.h:550
l4_msgtag_t l4_irq_trigger_u(l4_cap_idx_t irq, l4_utcb_t *utcb) L4_NOTHROW
Trigger the object.
Definition irq.h:262
l4_msgtag_t l4_irq_trigger(l4_cap_idx_t irq) L4_NOTHROW
Trigger an IRQ.
Definition irq.h:305
l4_msgtag_t l4_msgtag(long label, unsigned words, unsigned items, unsigned flags) L4_NOTHROW
Create a message tag from the specified values.
Definition types.h:427
@ L4_PROTO_SEMAPHORE
Protocol for semaphore objects.
Definition types.h:72
l4_msgtag_t l4_semaphore_up(l4_cap_idx_t sem) L4_NOTHROW
Semaphore up operation (wrapper for trigger()).
Definition semaphore.h:56
l4_msgtag_t l4_semaphore_down(l4_cap_idx_t sem, l4_timeout_t timeout) L4_NOTHROW
Semaphore down operation.
Definition semaphore.h:110
struct l4_utcb_t l4_utcb_t
Opaque type for the UTCB.
Definition utcb.h:67
l4_utcb_t * l4_utcb(void) L4_NOTHROW L4_PURE
Get the UTCB address.
Definition utcb.h:340
#define L4_NOTHROW
Mark a function declaration and definition as never throwing an exception.
Definition compiler.h:188
#define L4_INLINE
L4 Inline function attribute.
Definition compiler.h:62
C Irq interface.
Message tag data structure.
Definition types.h:163
Encapsulation of the message-register block in the UTCB.
Definition utcb.h:79
l4_umword_t mr[L4_UTCB_GENERIC_DATA_SIZE]
Message registers.
Definition utcb.h:80
Timeout pair.
Definition __timeout.h:59