d/freebsd-skq
1
0
Fork 0
Code Issues Pull Requests Packages Projects Releases Wiki Activity
8746bc9187
freebsd-skq/share/man/man3/pthread_rwlockattr_getpshared.3

87 lines
2.8 KiB
Groff
Raw Normal View History

Implement pthread read/write locks as defined by Version 2 of the Single UNIX Specification. As with our standard mutexes, process shared locks are not supported at this time.
1998-09-07 19:01:43 +00:00
.\" Copyright (c) 1998 Alex Nash
.\" All rights reserved.
.\"
.\" Redistribution and use in source and binary forms, with or without
.\" modification, are permitted provided that the following conditions
.\" are met:
.\" 1. Redistributions of source code must retain the above copyright
.\" notice, this list of conditions and the following disclaimer.
.\" 2. Redistributions in binary form must reproduce the above copyright
.\" notice, this list of conditions and the following disclaimer in the
.\" documentation and/or other materials provided with the distribution.
.\"
.\" THIS SOFTWARE IS PROVIDED BY THE AUTHOR AND CONTRIBUTORS ``AS IS'' AND
.\" ANY EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT LIMITED TO, THE
.\" IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE
.\" ARE DISCLAIMED. IN NO EVENT SHALL THE AUTHOR OR CONTRIBUTORS BE LIABLE
.\" FOR ANY DIRECT, INDIRECT, INCIDENTAL, SPECIAL, EXEMPLARY, OR CONSEQUENTIAL
.\" DAMAGES (INCLUDING, BUT NOT LIMITED TO, PROCUREMENT OF SUBSTITUTE GOODS
.\" OR SERVICES; LOSS OF USE, DATA, OR PROFITS; OR BUSINESS INTERRUPTION)
.\" HOWEVER CAUSED AND ON ANY THEORY OF LIABILITY, WHETHER IN CONTRACT, STRICT
.\" LIABILITY, OR TORT (INCLUDING NEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY
.\" OUT OF THE USE OF THIS SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF
.\" SUCH DAMAGE.
.\"
$Id$ -> $FreeBSD$
1999-08-28 00:22:10 +00:00
.\" $FreeBSD$
Implement pthread read/write locks as defined by Version 2 of the Single UNIX Specification. As with our standard mutexes, process shared locks are not supported at this time.
1998-09-07 19:01:43 +00:00
.\"
POSIX compliance improvements in the pthread(3) functions. This basically adds makes use of the C99 restrict keyword, and also adds some 'const's to four threading functions: pthread_mutexattr_gettype(), pthread_mutexattr_getprioceiling(), pthread_mutexattr_getprotocol(), and pthread_mutex_getprioceiling. The changes are in accordance to POSIX/SUSv4-2018. Hinted by: DragonFlyBSD Relnotes: yes MFC after: 1 month Differential Revision: D16722
2018-08-18 01:05:38 +00:00
.Dd August 17, 2018
Implement pthread read/write locks as defined by Version 2 of the Single UNIX Specification. As with our standard mutexes, process shared locks are not supported at this time.
1998-09-07 19:01:43 +00:00
.Dt PTHREAD_RWLOCKATTR_GETPSHARED 3
.Os
.Sh NAME
.Nm pthread_rwlockattr_getpshared
Typo fix (set --> get). Obtained from: OpenBSD (David Leonard)
1999-03-22 23:13:37 +00:00
.Nd get the process shared attribute
Introduce .Lb macro to libc_r manpages.
2000-04-22 15:50:29 +00:00
.Sh LIBRARY
Have a single set of POSIX threads man pages. The LIBRARY section of each manpage lists libraries that have corresponding interfaces implemented. Prodded by: threads Reviewed by: deischen
2004-01-14 21:44:26 +00:00
.Lb libpthread
Implement pthread read/write locks as defined by Version 2 of the Single UNIX Specification. As with our standard mutexes, process shared locks are not supported at this time.
1998-09-07 19:01:43 +00:00
.Sh SYNOPSIS
mdoc(7) police: Use the new .In macro for #include statements.
2001-10-01 16:09:29 +00:00
.In pthread.h
Implement pthread read/write locks as defined by Version 2 of the Single UNIX Specification. As with our standard mutexes, process shared locks are not supported at this time.
1998-09-07 19:01:43 +00:00
.Ft int
POSIX compliance improvements in the pthread(3) functions. This basically adds makes use of the C99 restrict keyword, and also adds some 'const's to four threading functions: pthread_mutexattr_gettype(), pthread_mutexattr_getprioceiling(), pthread_mutexattr_getprotocol(), and pthread_mutex_getprioceiling. The changes are in accordance to POSIX/SUSv4-2018. Hinted by: DragonFlyBSD Relnotes: yes MFC after: 1 month Differential Revision: D16722
2018-08-18 01:05:38 +00:00
.Fn pthread_rwlockattr_getpshared "const pthread_rwlockattr_t *restrict attr" "int *restrict pshared"
Implement pthread read/write locks as defined by Version 2 of the Single UNIX Specification. As with our standard mutexes, process shared locks are not supported at this time.
1998-09-07 19:01:43 +00:00
.Sh DESCRIPTION
The
.Fn pthread_rwlockattr_getpshared
function is used to get the process shared setting of a read/write
Mechanically kill hard sentence breaks and double whitespaces.
2004-07-03 18:29:24 +00:00
lock attribute object.
The setting is returned via
Implement pthread read/write locks as defined by Version 2 of the Single UNIX Specification. As with our standard mutexes, process shared locks are not supported at this time.
1998-09-07 19:01:43 +00:00
.Fa pshared ,
and may be one of two values:
mdoc(7) police: fix markup.
2001-03-02 09:59:58 +00:00
.Bl -tag -width PTHREAD_PROCESS_PRIVATE
.It Dv PTHREAD_PROCESS_SHARED
Implement pthread read/write locks as defined by Version 2 of the Single UNIX Specification. As with our standard mutexes, process shared locks are not supported at this time.
1998-09-07 19:01:43 +00:00
Any thread of any process that has access to the memory where the
read/write lock resides can manipulate the lock.
mdoc(7) police: fix markup.
2001-03-02 09:59:58 +00:00
.It Dv PTHREAD_PROCESS_PRIVATE
Implement pthread read/write locks as defined by Version 2 of the Single UNIX Specification. As with our standard mutexes, process shared locks are not supported at this time.
1998-09-07 19:01:43 +00:00
Only threads created within the same process as the thread that
Mechanically kill hard sentence breaks and double whitespaces.
2004-07-03 18:29:24 +00:00
initialized the read/write lock can manipulate the lock.
This is
Implement pthread read/write locks as defined by Version 2 of the Single UNIX Specification. As with our standard mutexes, process shared locks are not supported at this time.
1998-09-07 19:01:43 +00:00
the default value.
.El
.Sh RETURN VALUES
If successful, the
.Fn pthread_rwlockattr_getpshared
Mechanically kill hard sentence breaks and double whitespaces.
2004-07-03 18:29:24 +00:00
function will return zero.
Otherwise an error number will be returned
Implement pthread read/write locks as defined by Version 2 of the Single UNIX Specification. As with our standard mutexes, process shared locks are not supported at this time.
1998-09-07 19:01:43 +00:00
to indicate the error.
.Sh ERRORS
The .Fn function. Use .Xr where appropriate.
2003-03-24 16:05:24 +00:00
The
Implement pthread read/write locks as defined by Version 2 of the Single UNIX Specification. As with our standard mutexes, process shared locks are not supported at this time.
1998-09-07 19:01:43 +00:00
.Fn pthread_rwlockattr_getpshared
The .Fn function. Use .Xr where appropriate.
2003-03-24 16:05:24 +00:00
function may fail if:
Implement pthread read/write locks as defined by Version 2 of the Single UNIX Specification. As with our standard mutexes, process shared locks are not supported at this time.
1998-09-07 19:01:43 +00:00
.Bl -tag -width Er
.It Bq Er EINVAL
The value specified by
.Fa attr
is invalid.
.El
Sort sections.
2005-01-21 08:36:40 +00:00
.Sh SEE ALSO
sort SEE ALSO
2014-12-26 22:41:10 +00:00
.Xr pthread_rwlock_init 3 ,
Sort sections.
2005-01-21 08:36:40 +00:00
.Xr pthread_rwlockattr_init 3 ,
sort SEE ALSO
2014-12-26 22:41:10 +00:00
.Xr pthread_rwlockattr_setpshared 3
Sort sections.
2005-01-21 08:36:40 +00:00
.Sh STANDARDS
The
.Fn pthread_rwlockattr_getpshared
function is expected to conform to
.St -susv2 .
Implement pthread read/write locks as defined by Version 2 of the Single UNIX Specification. As with our standard mutexes, process shared locks are not supported at this time.
1998-09-07 19:01:43 +00:00
.Sh HISTORY
The
.Fn pthread_rwlockattr_getpshared
function first appeared in
.Fx 3.0 .
Reference in New Issue Copy Permalink