summaryrefslogtreecommitdiffstats
path: root/man3/makecontext.3
diff options
context:
space:
mode:
Diffstat (limited to 'man3/makecontext.3')
-rw-r--r--man3/makecontext.315
1 files changed, 7 insertions, 8 deletions
diff --git a/man3/makecontext.3 b/man3/makecontext.3
index c4e2378..5fc342f 100644
--- a/man3/makecontext.3
+++ b/man3/makecontext.3
@@ -6,7 +6,7 @@
.\"
.\" 2006-08-02, mtk, Added example program
.\"
-.TH makecontext 3 2023-07-20 "Linux man-pages 6.05.01"
+.TH makecontext 3 2023-10-31 "Linux man-pages 6.7"
.SH NAME
makecontext, swapcontext \- manipulate user context
.SH LIBRARY
@@ -15,7 +15,7 @@ Standard C library
.SH SYNOPSIS
.nf
.B #include <ucontext.h>
-.PP
+.P
.BI "void makecontext(ucontext_t *" ucp ", void (*" func ")(), int " argc \
", ...);"
.BI "int swapcontext(ucontext_t *restrict " oucp ,
@@ -36,7 +36,7 @@ and
.BR swapcontext ()
that allow user-level context switching
between multiple threads of control within a process.
-.PP
+.P
The
.BR makecontext ()
function modifies the context pointed to
@@ -48,7 +48,7 @@ the caller must allocate a new stack
for this context and assign its address to \fIucp\->uc_stack\fP,
and define a successor context and
assign its address to \fIucp\->uc_link\fP.
-.PP
+.P
When this context is later activated (using
.BR setcontext (3)
or
@@ -62,7 +62,7 @@ the caller must specify the number of these arguments in
.IR argc .
When this function returns, the successor context is activated.
If the successor context pointer is NULL, the thread exits.
-.PP
+.P
The
.BR swapcontext ()
function saves the current context in
@@ -112,7 +112,6 @@ T} Thread safety T{
MT-Safe race:oucp race:ucp
T}
.TE
-.sp 1
.SH STANDARDS
None.
.SH HISTORY
@@ -129,7 +128,7 @@ to be used as the stack, regardless of the direction of growth of
the stack.
Thus, it is not necessary for the user program to
worry about this direction.
-.PP
+.P
On architectures where
.I int
and pointer types are the same size
@@ -152,7 +151,7 @@ The example program below demonstrates the use of
and
.BR swapcontext ().
Running the program produces the following output:
-.PP
+.P
.in +4n
.EX
.RB "$" " ./a.out"