Loading...
Searching...
No Matches
thread
Go to the documentation of this file.
// vi:set ft=cpp: -*- Mode: C++ -*-
/*
* (c) 2008-2009 Adam Lackorzynski <adam@os.inf.tu-dresden.de>,
* Alexander Warg <warg@os.inf.tu-dresden.de>
* economic rights: Technische Universität Dresden (Germany)
*
* License: see LICENSE.spdx (in this directory or the directories above)
*/
#pragma once
#include <l4/sys/capability>
#include <l4/sys/snd_destination>
#include <l4/sys/thread.h>
namespace L4 {
class Thread :
public Kobject_t<Thread, Snd_destination, L4_PROTO_THREAD,
Type_info::Demand_t<1> >
{
public:
l4_msgtag_t ex_regs(l4_addr_t ip, l4_addr_t sp,
l4_umword_t flags,
l4_utcb_t *utcb = l4_utcb()) noexcept
{ return l4_thread_ex_regs_u(cap(), ip, sp, flags, utcb); }
l4_msgtag_t ex_regs(l4_addr_t *ip, l4_addr_t *sp,
l4_umword_t *flags,
l4_utcb_t *utcb = l4_utcb()) noexcept
{ return l4_thread_ex_regs_ret_u(cap(), ip, sp, flags, utcb); }
class Attr
{
private:
friend class L4::Thread;
l4_utcb_t *_u;
public:
explicit Attr(l4_utcb_t *utcb = l4_utcb()) noexcept : _u(utcb)
{ l4_thread_control_start_u(utcb); }
void pager(Cap<void> const &pager) noexcept
{ l4_thread_control_pager_u(pager.cap(), _u); }
Cap<void> pager() noexcept
{ return Cap<void>(l4_utcb_mr_u(_u)->mr[1]); }
void exc_handler(Cap<void> const &exc_handler) noexcept
{ l4_thread_control_exc_handler_u(exc_handler.cap(), _u); }
Cap<void> exc_handler() noexcept
{ return Cap<void>(l4_utcb_mr_u(_u)->mr[2]); }
void bind(l4_utcb_t *thread_utcb, Cap<Task> const &task) noexcept
{ l4_thread_control_bind_u(thread_utcb, task.cap(), _u); }
void alien(int on) noexcept
{ l4_thread_control_alien_u(_u, on); }
};
l4_msgtag_t control(Attr const &attr) noexcept
{ return l4_thread_control_commit_u(cap(), attr._u); }
l4_msgtag_t switch_to(l4_utcb_t *utcb = l4_utcb()) noexcept
{ return l4_thread_switch_u(cap(), utcb); }
l4_msgtag_t stats_time(l4_kernel_clock_t *us,
l4_utcb_t *utcb = l4_utcb()) noexcept
{ return l4_thread_stats_time_u(cap(), us, utcb); }
l4_msgtag_t vcpu_resume_start(l4_utcb_t *utcb = l4_utcb()) noexcept
{ return l4_thread_vcpu_resume_start_u(utcb); }
l4_msgtag_t vcpu_resume_commit(l4_msgtag_t tag,
l4_utcb_t *utcb = l4_utcb()) noexcept
{ return l4_thread_vcpu_resume_commit_u(cap(), tag, utcb); }
l4_msgtag_t vcpu_control(l4_addr_t vcpu_state, l4_utcb_t *utcb = l4_utcb())
noexcept
{ return l4_thread_vcpu_control_u(cap(), vcpu_state, utcb); }
l4_msgtag_t vcpu_control_ext(l4_addr_t ext_vcpu_state,
l4_utcb_t *utcb = l4_utcb()) noexcept
{ return l4_thread_vcpu_control_ext_u(cap(), ext_vcpu_state, utcb); }
l4_msgtag_t register_del_irq(Cap<Irq> irq, l4_utcb_t *u = l4_utcb()) noexcept
{ return l4_thread_register_del_irq_u(cap(), irq.cap(), u); }
class Modify_senders
{
private:
friend class Thread;
l4_utcb_t *utcb;
unsigned cnt;
public:
explicit Modify_senders(l4_utcb_t *u = l4_utcb()) noexcept
: utcb(u), cnt(1)
{
l4_utcb_mr_u(utcb)->mr[0] = L4_THREAD_MODIFY_SENDER_OP;
}
int add(l4_umword_t match_mask, l4_umword_t match,
l4_umword_t del_bits, l4_umword_t add_bits) noexcept
{
l4_msg_regs_t *m = l4_utcb_mr_u(utcb);
if (cnt >= L4_UTCB_GENERIC_DATA_SIZE - 4)
return -L4_ENOMEM;
m->mr[cnt++] = match_mask;
m->mr[cnt++] = match;
m->mr[cnt++] = del_bits;
m->mr[cnt++] = add_bits;
return 0;
}
};
l4_msgtag_t modify_senders(Modify_senders const &todo) noexcept
{
return l4_ipc_call(cap(), todo.utcb, l4_msgtag(L4_PROTO_THREAD, todo.cnt, 0, 0), L4_IPC_NEVER);
}
l4_msgtag_t register_doorbell_irq(Cap<Irq> irq, l4_utcb_t *u = l4_utcb()) noexcept
{ return l4_thread_register_doorbell_irq_u(cap(), irq.cap(), u); }
};
}
capability
L4::Cap related definitions.
L4::Cap_base::cap
l4_cap_idx_t cap() const noexcept
Return capability selector.
Definition capability.h:49
L4::Cap
C++ interface for capabilities.
Definition capability.h:224
L4::Kobject_t
Helper class to create an L4Re interface class that is derived from a single base class.
Definition __typeinfo.h:750
L4::Kobject::cap
l4_cap_idx_t cap() const noexcept
Return capability selector.
Definition kobject:69
L4::Thread::Attr
Thread attributes used for control().
Definition thread:138
L4::Thread::Attr::pager
void pager(Cap< void > const &pager) noexcept
Set the pager capability selector.
Definition thread:161
L4::Thread::Attr::exc_handler
void exc_handler(Cap< void > const &exc_handler) noexcept
Set the exception-handler capability selector.
Definition thread:180
L4::Thread::Attr::Attr
Attr(l4_utcb_t *utcb=l4_utcb()) noexcept
Create a thread-attribute object with the given UTCB.
Definition thread:151
L4::Thread::Attr::exc_handler
Cap< void > exc_handler() noexcept
Get the capability selector used for exception messages.
Definition thread:189
L4::Thread::Attr::bind
void bind(l4_utcb_t *thread_utcb, Cap< Task > const &task) noexcept
Bind the thread to a task.
Definition thread:218
L4::Thread::Attr::pager
Cap< void > pager() noexcept
Get the capability selector used for page-fault messages.
Definition thread:170
L4::Thread::Attr::alien
void alien(int on) noexcept
Enable alien mode.
Definition thread:224
L4::Thread::Modify_senders
Class wrapping a list of rules which modify the sender label of IPC messages inbound to this thread.
Definition thread:449
L4::Thread::Modify_senders::add
int add(l4_umword_t match_mask, l4_umword_t match, l4_umword_t del_bits, l4_umword_t add_bits) noexcept
Add a rule.
Definition thread:481
L4::Thread
C++ L4 kernel thread interface, see Thread for the C interface.
Definition thread:55
L4::Thread::register_doorbell_irq
l4_msgtag_t register_doorbell_irq(Cap< Irq > irq, l4_utcb_t *u=l4_utcb()) noexcept
Register an IRQ that will trigger when a forwarded virtual interrupt is pending.
Definition thread:553
L4::Thread::control
l4_msgtag_t control(Attr const &attr) noexcept
Commit the given thread-attributes object.
Definition thread:243
L4::Thread::register_del_irq
l4_msgtag_t register_del_irq(Cap< Irq > irq, l4_utcb_t *u=l4_utcb()) noexcept
Register an IRQ that will trigger upon deletion events.
Definition thread:427
L4::Thread::vcpu_resume_commit
l4_msgtag_t vcpu_resume_commit(l4_msgtag_t tag, l4_utcb_t *utcb=l4_utcb()) noexcept
Resume from vCPU asynchronous IPC handler, commit.
Definition thread:334
L4::Thread::switch_to
l4_msgtag_t switch_to(l4_utcb_t *utcb=l4_utcb()) noexcept
Switch execution to this thread.
Definition thread:253
L4::Thread::stats_time
l4_msgtag_t stats_time(l4_kernel_clock_t *us, l4_utcb_t *utcb=l4_utcb()) noexcept
Get consumed time of thread in us.
Definition thread:264
L4::Thread::vcpu_control
l4_msgtag_t vcpu_control(l4_addr_t vcpu_state, l4_utcb_t *utcb=l4_utcb()) noexcept
Enable the vCPU feature for the thread.
Definition thread:358
L4::Thread::modify_senders
l4_msgtag_t modify_senders(Modify_senders const &todo) noexcept
Apply sender modification rules.
Definition thread:525
L4::Thread::ex_regs
l4_msgtag_t ex_regs(l4_addr_t ip, l4_addr_t sp, l4_umword_t flags, l4_utcb_t *utcb=l4_utcb()) noexcept
Exchange basic thread registers.
Definition thread:84
L4::Thread::vcpu_control_ext
l4_msgtag_t vcpu_control_ext(l4_addr_t ext_vcpu_state, l4_utcb_t *utcb=l4_utcb()) noexcept
Enable the extended vCPU feature for the thread.
Definition thread:398
L4::Thread::vcpu_resume_start
l4_msgtag_t vcpu_resume_start(l4_utcb_t *utcb=l4_utcb()) noexcept
Resume from vCPU asynchronous IPC handler, start.
Definition thread:283
L4::Thread::ex_regs
l4_msgtag_t ex_regs(l4_addr_t *ip, l4_addr_t *sp, l4_umword_t *flags, l4_utcb_t *utcb=l4_utcb()) noexcept
Exchange basic thread registers and return previous values.
Definition thread:119
l4_umword_t
unsigned long l4_umword_t
Unsigned machine word.
Definition l4int.h:40
l4_addr_t
unsigned long l4_addr_t
Address type.
Definition l4int.h:34
l4_kernel_clock_t
l4_uint64_t l4_kernel_clock_t
Kernel clock type.
Definition l4int.h:53
L4_ENOMEM
@ L4_ENOMEM
No memory.
Definition err.h:39
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_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
@ L4_PROTO_THREAD
Protocol for messages to a thread object.
Definition types.h:54
L4_THREAD_MODIFY_SENDER_OP
@ L4_THREAD_MODIFY_SENDER_OP
Modify all senders IDs that match the given pattern.
Definition thread.h:740
l4_thread_vcpu_control_ext_u
l4_msgtag_t l4_thread_vcpu_control_ext_u(l4_cap_idx_t thread, l4_addr_t ext_vcpu_state, l4_utcb_t *utcb) L4_NOTHROW
Enable the extended vCPU feature for the thread.
Definition thread.h:1059
l4_thread_ex_regs_ret_u
l4_msgtag_t l4_thread_ex_regs_ret_u(l4_cap_idx_t thread, l4_addr_t *ip, l4_addr_t *sp, l4_umword_t *flags, l4_utcb_t *utcb) L4_NOTHROW
Exchange basic thread registers and return previous values.
Definition thread.h:823
l4_thread_vcpu_control_u
l4_msgtag_t l4_thread_vcpu_control_u(l4_cap_idx_t thread, l4_addr_t vcpu_state, l4_utcb_t *utcb) L4_NOTHROW
Enable the vCPU feature for the thread.
Definition thread.h:1044
l4_thread_ex_regs_u
l4_msgtag_t l4_thread_ex_regs_u(l4_cap_idx_t thread, l4_addr_t ip, l4_addr_t sp, l4_umword_t flags, l4_utcb_t *utcb) L4_NOTHROW
Exchange basic thread registers.
Definition thread.h:812
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
thread.h
Common thread related definitions.
L4
L4 low-level kernel interface.
Definition l4sys-l4f-groups.dox:50
snd_destination
The C++ Sender destination interface.
l4_msgtag_t
Message tag data structure.
Definition types.h:154
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