mirror of
https://github.com/drasko/codezero.git
synced 2026-04-03 10:39:04 +02:00
Added manual pages - Not release quality yet.
This commit is contained in:
65
docs/man/man7/l4_thread_control.7
Normal file
65
docs/man/man7/l4_thread_control.7
Normal file
@@ -0,0 +1,65 @@
|
||||
.TH L4_THREAD_CONTROL 7 2009-11-02 "Codezero" "Codezero Programmer's Manual"
|
||||
.SH NAME
|
||||
.nf
|
||||
.BR "l4_thread_control" "- create, destroy, suspend and resume threads."
|
||||
|
||||
.SH SYNOPSIS
|
||||
.nf
|
||||
.B #include <l4lib/arch/syscalls.h>
|
||||
.B #include <l4lib/arch/syslib.h>
|
||||
|
||||
.BI "int l4_thread_control(unsigned int " "action" ", struct task_ids *" "ids" ")"
|
||||
.SH DESCRIPTION
|
||||
.BR l4_thread_control()
|
||||
manipulates threads in the system.
|
||||
.fi
|
||||
This is a privileged call that can be used by pagers only.
|
||||
|
||||
|
||||
The
|
||||
.I action
|
||||
field is the main action specifier where one of the following may be supplied as valid actions.
|
||||
|
||||
.TP
|
||||
.B THREAD_CREATE
|
||||
Creates a new thread in a new or existing space depending on the spid argument
|
||||
.TP
|
||||
.B THREAD_DESTROY
|
||||
Destroys a thread, and its address space if it is the only thread left
|
||||
.TP
|
||||
.B THREAD_SUSPEND
|
||||
Suspends execution of a thread
|
||||
.TP
|
||||
.B THREAD_RUN
|
||||
Run/Resumes execution of a thread
|
||||
.TP
|
||||
.B THREAD_RECYCLE
|
||||
Reuses threads UTCB/Address space
|
||||
.TP
|
||||
.B THREAD_WAIT
|
||||
Wait for thread to complete
|
||||
|
||||
.ti 8
|
||||
The
|
||||
.IR "ids.tid" " and " "ids.spid"
|
||||
arguments specify the thread and address space that is going to be manipulated with the specified
|
||||
.I "action"
|
||||
argument.
|
||||
|
||||
.ti 10
|
||||
.BI "struct" " task_ids "
|
||||
{
|
||||
.ti 18
|
||||
.BI "int" " tid" ";"
|
||||
.ti 18
|
||||
.BI "int" " spid" ";"
|
||||
.ti 18
|
||||
.BI "int" " tgid" ";"
|
||||
.ti 10
|
||||
};
|
||||
|
||||
.SH L4 Userspace Library Functions
|
||||
.nf
|
||||
N/A
|
||||
|
||||
|
||||
Reference in New Issue
Block a user