diff options
| author | Jacob McDonnell <jacob@jacobmcdonnell.com> | 2026-04-25 19:54:44 -0400 |
|---|---|---|
| committer | Jacob McDonnell <jacob@jacobmcdonnell.com> | 2026-04-25 19:54:44 -0400 |
| commit | a9157ce950dfe2fc30795d43b9d79b9d1bffc48b (patch) | |
| tree | 9df484304b560466d145e662c1c254ff0e9ae0ba /static/openbsd/man3/pthread_barrier_init.3 | |
| parent | 160aa82b2d39c46ad33723d7d909cb4972efbb03 (diff) | |
docs: Added All OpenBSD Manuals
Diffstat (limited to 'static/openbsd/man3/pthread_barrier_init.3')
| -rw-r--r-- | static/openbsd/man3/pthread_barrier_init.3 | 103 |
1 files changed, 103 insertions, 0 deletions
diff --git a/static/openbsd/man3/pthread_barrier_init.3 b/static/openbsd/man3/pthread_barrier_init.3 new file mode 100644 index 00000000..9404c2b6 --- /dev/null +++ b/static/openbsd/man3/pthread_barrier_init.3 @@ -0,0 +1,103 @@ +.\" $OpenBSD: pthread_barrier_init.3,v 1.6 2025/06/07 00:16:52 schwarze Exp $ +.\" +.\" Copyright (c) 2012 Paul Irofti <paul@irofti.net> +.\" +.\" Permission to use, copy, modify, and distribute this software for any +.\" purpose with or without fee is hereby granted, provided that the above +.\" copyright notice and this permission notice appear in all copies. +.\" +.\" THE SOFTWARE IS PROVIDED "AS IS" AND THE AUTHOR DISCLAIMS ALL WARRANTIES +.\" WITH REGARD TO THIS SOFTWARE INCLUDING ALL IMPLIED WARRANTIES OF +.\" MERCHANTABILITY AND FITNESS. IN NO EVENT SHALL THE AUTHOR BE LIABLE FOR +.\" ANY SPECIAL, DIRECT, INDIRECT, OR CONSEQUENTIAL DAMAGES OR ANY DAMAGES +.\" WHATSOEVER RESULTING FROM LOSS OF USE, DATA OR PROFITS, WHETHER IN AN +.\" ACTION OF CONTRACT, NEGLIGENCE OR OTHER TORTIOUS ACTION, ARISING OUT OF +.\" OR IN CONNECTION WITH THE USE OR PERFORMANCE OF THIS SOFTWARE. +.\" +.\" +.Dd $Mdocdate: June 7 2025 $ +.Dt PTHREAD_BARRIER_INIT 3 +.Os +.Sh NAME +.Nm pthread_barrier_init , +.Nm pthread_barrier_destroy +.Nd initialize and destroy a barrier object +.Sh SYNOPSIS +.Lb libpthread +.In pthread.h +.Ft int +.Fn pthread_barrier_init "pthread_barrier_t *barrier" "pthread_barrierattr_t *attr" "unsigned int count" +.Ft int +.Fn pthread_barrier_destroy "pthread_barrier_t *barrier" +.Sh DESCRIPTION +The +.Fn pthread_barrier_init +function creates a new barrier object, with attributes specified with +.Fa attr +and with a threshold specified with +.Fa count . +If +.Fa attr +is +.Dv NULL , +the default attributes are used. +The +.Fa count +argument is later used by the +.Fn pthread_barrier_wait +function to check if the required number of threads reached the barrier. +.Pp +The +.Fn pthread_barrier_destroy +function frees the resources allocated for +.Fa barrier . +.Sh RETURN VALUES +If successful, +.Fn pthread_barrier_init +and +.Fn pthread_barrier_destroy +return zero; +otherwise an error number is returned to indicate the error. +.Sh ERRORS +.Fn pthread_barrier_init +will fail if: +.Bl -tag -width Er +.It Bq Er EINVAL +The value specified by +.Fa barrier +or +.Fa attr +is invalid. +.It Bq Er ENOMEM +The process cannot allocate enough memory to create another barrier object. +.It Bq Er ENOTSUP +The attributes specified by +.Fa attr +are not supported by the current implementation. +.El +.Pp +.Fn pthread_barrier_destroy +will fail if: +.Bl -tag -width Er +.It Bq Er EINVAL +The value specified by +.Fa barrier +is invalid. +.It Bq Er EBUSY +There are still threads waiting on the barrier. +.El +.Sh SEE ALSO +.Xr pthread_barrier_wait 3 , +.Xr pthread_barrierattr_getpshared 3 , +.Xr pthread_barrierattr_init 3 +.Sh STANDARDS +.Fn pthread_barrier_init +and +.Fn pthread_barrier_destroy +conform to +.St -p1003.1-2008 . +.Sh BUGS +Currently only private barriers are supported and the pshared attribute is +always set that way. +Any attempts to change that value will trigger +.Er ENOTSUP . |
