Loading...
Searching...
No Matches
thread_group.h
Go to the documentation of this file.
/*
* Copyright (C) 2022-2025 Kernkonzept GmbH.
* Author(s): Adam Lackorzynski <adam@os.inf.tu-dresden.de>
* Frank Mehnert <frank.mehnert@kernkonzept.com>
*
* License: see LICENSE.spdx (in this directory or the directories above)
*/
#pragma once
#include <l4/sys/types.h>
#include <l4/sys/utcb.h>
enum L4_thread_group_ops
{
L4_THREAD_GROUP_ADD_OP = 2UL,
L4_THREAD_GROUP_REMOVE_OP = 3UL,
};
enum L4_thread_group_policy
{
L4_THREAD_GROUP_POLICY_STRICT_CORE_LOCAL = 0,
L4_THREAD_GROUP_POLICY_SOFT_CORE_LOCAL = 1,
};
L4_INLINE l4_msgtag_t
l4_thread_group_add(l4_cap_idx_t tg,
l4_cap_idx_t thread) L4_NOTHROW;
L4_INLINE l4_msgtag_t
l4_thread_group_add_u(l4_cap_idx_t tg,
l4_cap_idx_t thread,
l4_utcb_t *utcb) L4_NOTHROW;
L4_INLINE l4_msgtag_t
l4_thread_group_remove(l4_cap_idx_t tg,
l4_cap_idx_t thread) L4_NOTHROW;
L4_INLINE l4_msgtag_t
l4_thread_group_remove_u(l4_cap_idx_t tg,
l4_cap_idx_t thread,
l4_utcb_t *utcb) L4_NOTHROW;
/* IMPLEMENTATION -----------------------------------------------------------*/
#include <l4/sys/ipc.h>
L4_INLINE l4_msgtag_t
l4_thread_group_add_u(l4_cap_idx_t tg,
l4_cap_idx_t thread,
l4_utcb_t *utcb) L4_NOTHROW
{
l4_msg_regs_t *v = l4_utcb_mr_u(utcb);
v->mr[0] = L4_THREAD_GROUP_ADD_OP;
v->mr[1] = l4_map_obj_control(0, 0);
v->mr[2] = l4_obj_fpage(thread, 0, L4_CAP_FPAGE_RWS).raw;
return l4_ipc_call(tg, utcb,
l4_msgtag(L4_PROTO_THREAD_GROUP, 1, 1, 0), L4_IPC_NEVER);
}
L4_INLINE l4_msgtag_t
l4_thread_group_remove_u(l4_cap_idx_t tg,
l4_cap_idx_t thread,
l4_utcb_t *utcb) L4_NOTHROW
{
l4_msg_regs_t *v = l4_utcb_mr_u(utcb);
v->mr[0] = L4_THREAD_GROUP_REMOVE_OP;
v->mr[1] = l4_map_obj_control(0, 0);
v->mr[2] = l4_obj_fpage(thread, 0, L4_CAP_FPAGE_RWS).raw;
return l4_ipc_call(tg, utcb,
l4_msgtag(L4_PROTO_THREAD_GROUP, 1, 1, 0), L4_IPC_NEVER);
}
L4_INLINE l4_msgtag_t
l4_thread_group_add(l4_cap_idx_t tg,
l4_cap_idx_t thread) L4_NOTHROW
{
return l4_thread_group_add_u(tg, thread, l4_utcb());
}
L4_INLINE l4_msgtag_t
l4_thread_group_remove(l4_cap_idx_t tg,
l4_cap_idx_t thread) L4_NOTHROW
{
return l4_thread_group_remove_u(tg, thread, l4_utcb());
}
l4_cap_idx_t
unsigned long l4_cap_idx_t
Capability selector type.
Definition types.h:336
l4_obj_fpage
l4_fpage_t l4_obj_fpage(l4_cap_idx_t obj, unsigned int order, unsigned char rights) L4_NOTHROW
Create a kernel-object flexpage.
Definition __l4_fpage.h:715
L4_CAP_FPAGE_RWS
@ L4_CAP_FPAGE_RWS
Read, interface specific 'W', and 'S' rights for capability flexpages.
Definition __l4_fpage.h:206
l4_ipc_call
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:565
l4_map_obj_control
l4_umword_t l4_map_obj_control(l4_umword_t spot, unsigned grant) L4_NOTHROW
Create the first word for a map item that is a send item for the object space.
Definition __l4_fpage.h:749
l4_msgtag
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:405
L4_PROTO_THREAD_GROUP
@ L4_PROTO_THREAD_GROUP
Protocol for messages to a thread group obj.
Definition types.h:51
l4_thread_group_remove
l4_msgtag_t l4_thread_group_remove(l4_cap_idx_t tg, l4_cap_idx_t thread) L4_NOTHROW
Remove thread from a thread group.
Definition thread_group.h:121
l4_thread_group_add
l4_msgtag_t l4_thread_group_add(l4_cap_idx_t tg, l4_cap_idx_t thread) L4_NOTHROW
Add thread to a thread group.
Definition thread_group.h:114
L4_IPC_NEVER
#define L4_IPC_NEVER
never timeout
Definition __timeout.h:76
l4_utcb_t
struct l4_utcb_t l4_utcb_t
Opaque type for the UTCB.
Definition utcb.h:56
l4_utcb
l4_utcb_t * l4_utcb(void) L4_NOTHROW L4_PURE
Get the UTCB address.
Definition utcb.h:346
L4_NOTHROW
#define L4_NOTHROW
Mark a function declaration and definition as never throwing an exception.
Definition compiler.h:161
L4_INLINE
#define L4_INLINE
L4 Inline function attribute.
Definition compiler.h:51
ipc.h
Common IPC interface.
types.h
Common L4 ABI Data Types.
utcb.h
UTCB definitions.
l4_msgtag_t
Message tag data structure.
Definition types.h:154
l4_fpage_t::raw
l4_umword_t raw
Raw value.
Definition __l4_fpage.h:78
l4_msg_regs_t
Encapsulation of the message-register block in the UTCB.
Definition utcb.h:68
l4_msg_regs_t::mr
l4_umword_t mr[L4_UTCB_GENERIC_DATA_SIZE]
Message registers.
Definition utcb.h:69