From fc22b3d6507c6745911b9dfcc68f1e665ae13dbc Mon Sep 17 00:00:00 2001 From: Daniel Baumann Date: Mon, 15 Apr 2024 21:43:11 +0200 Subject: Adding upstream version 4.22.0. Signed-off-by: Daniel Baumann --- upstream/debian-unstable/man3/pthread_once.3 | 34 ++++++++++++++++++++++++++++ 1 file changed, 34 insertions(+) create mode 100644 upstream/debian-unstable/man3/pthread_once.3 (limited to 'upstream/debian-unstable/man3/pthread_once.3') diff --git a/upstream/debian-unstable/man3/pthread_once.3 b/upstream/debian-unstable/man3/pthread_once.3 new file mode 100644 index 00000000..8ba47a36 --- /dev/null +++ b/upstream/debian-unstable/man3/pthread_once.3 @@ -0,0 +1,34 @@ +.TH PTHREAD_ONCE 3 LinuxThreads + +.SH NAME +pthread_once \- once-only initialization + +.SH SYNOPSIS +.B #include + +.BI "pthread_once_t " once_control " = PTHREAD_ONCE_INIT;" + +.BI "int pthread_once(pthread_once_t *" once_control ", void (*" init_routine ") (void));" + +.SH DESCRIPTION + +The purpose of \fBpthread_once\fP 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 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 to record that initialization has +been performed. Subsequent calls to \fBpthread_once\fP with the same +\fBonce_control\fP argument do nothing. + +.SH "RETURN VALUE" +\fBpthread_once\fP always returns 0. + +.SH ERRORS +None. + +.SH AUTHOR +Xavier Leroy + -- cgit v1.2.3