aboutsummaryrefslogtreecommitdiffstats
path: root/man/man3/pthread_once.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/pthread_once.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/pthread_once.3')
-rw-r--r--man/man3/pthread_once.337
1 files changed, 27 insertions, 10 deletions
diff --git a/man/man3/pthread_once.3 b/man/man3/pthread_once.3
index 2497f95d18..11445fe200 100644
--- a/man/man3/pthread_once.3
+++ b/man/man3/pthread_once.3
@@ -21,23 +21,40 @@ once-only initialization
.
.
.SH DESCRIPTION
-The purpose of \fBpthread_once\fP is
+The purpose of
+.BR pthread_once ()
+is
to ensure that a piece of initialization code is executed at most once.
-The \fIonce_control\fP argument points to a static or extern variable
-statically initialized to \fBPTHREAD_ONCE_INIT\fP.
+The
+.I once_control
+argument points to a static or extern variable
+statically initialized to
+.BR PTHREAD_ONCE_INIT .
.P
-The first time \fBpthread_once\fP is called
-with a given \fIonce_control\fP argument,
-it calls \fIinit_routine\fP with no argument
-and changes the value of the \fIonce_control\fP variable
+The first time
+.BR pthread_once ()
+is called
+with a given
+.I once_control
+argument,
+it calls
+.I init_routine
+with no argument
+and changes the value of the
+.I once_control
+variable
to record that initialization has been performed.
-Subsequent calls to \fBpthread_once\fP
-with the same \fBonce_control\fP argument
+Subsequent calls to
+.BR pthread_once ()
+with the same
+.I once_control
+argument
do nothing.
.
.
.SH "RETURN VALUE"
-\fBpthread_once\fP always returns 0.
+.BR pthread_once ()
+always returns 0.
.
.
.SH ERRORS