aboutsummaryrefslogtreecommitdiffstats
path: root/man/man3/makecontext.3
diff options
context:
space:
mode:
authorAlejandro Colomar <alx@kernel.org>2023-07-17 22:43:18 +0200
committerAlejandro Colomar <alx@kernel.org>2025-03-30 12:31:37 +0200
commita82917ada0509758ac6d717402858536af3a032d (patch)
treece8bc810a6c9f2f0ef5c7641392613d6b8a2ed0e /man/man3/makecontext.3
parentc47826785d91e9cd8c2957d789e50a50e36833e0 (diff)
downloadman-pages-a82917ada0509758ac6d717402858536af3a032d.tar.gz
man/: srcfix (\fX => \f[X])
While doing this global change, fix other minor issues found nearby. Signed-off-by: Alejandro Colomar <alx@kernel.org>
Diffstat (limited to 'man/man3/makecontext.3')
-rw-r--r--man/man3/makecontext.331
1 files changed, 22 insertions, 9 deletions
diff --git a/man/man3/makecontext.3 b/man/man3/makecontext.3
index 45009a7a6c..4255e555fb 100644
--- a/man/man3/makecontext.3
+++ b/man/man3/makecontext.3
@@ -40,20 +40,26 @@ between multiple threads of control within a process.
The
.BR makecontext ()
function modifies the context pointed to
-by \fIucp\fP (which was obtained from a call to
+by
+.I ucp
+(which was obtained from a call to
.BR getcontext (3)).
Before invoking
.BR makecontext (),
the caller must allocate a new stack
-for this context and assign its address to \fIucp\->uc_stack\fP,
+for this context and assign its address to
+.IR ucp\->uc_stack ,
and define a successor context and
-assign its address to \fIucp\->uc_link\fP.
+assign its address to
+.IR ucp\->uc_link .
.P
When this context is later activated (using
.BR setcontext (3)
or
.BR swapcontext ())
-the function \fIfunc\fP is called,
+the function
+.I func
+is called,
and passed the series of integer
.RI ( int )
arguments that follow
@@ -66,14 +72,19 @@ If the successor context pointer is NULL, the thread exits.
The
.BR swapcontext ()
function saves the current context in
-the structure pointed to by \fIoucp\fP, and then activates the
-context pointed to by \fIucp\fP.
+the structure pointed to by
+.IR oucp ,
+and then activates
+the context pointed to by
+.IR ucp .
.SH RETURN VALUE
When successful,
.BR swapcontext ()
does not return.
-(But we may return later, in case \fIoucp\fP is
-activated, in which case it looks like
+(But we may return later, in case
+.I oucp
+is activated,
+in which case it looks like
.BR swapcontext ()
returns 0.)
On error,
@@ -121,7 +132,9 @@ Removed in POSIX.1-2008,
citing portability issues, and
recommending that applications be rewritten to use POSIX threads instead.
.SH NOTES
-The interpretation of \fIucp\->uc_stack\fP is just as in
+The interpretation of
+.I ucp\->uc_stack
+is just as in
.BR sigaltstack (2),
namely, this struct contains the start and length of a memory area
to be used as the stack, regardless of the direction of growth of