d/freebsd-nq
1
0
Fork 0
Code Issues Pull Requests Packages Projects Releases Wiki Activity
9bcd7482b2
freebsd-nq/share/man/man3/pthread_rwlockattr_setpshared.3

93 lines
2.9 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
.\"
Remove mentions that PTHREAD_PROCESS_SHARED is not supported from man pages. Also add support for process-shared synchronization objects to the HISTORY sections where they already exist.
2016-05-31 21:16:34 +00:00
.Dd May 31, 2016
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_SETPSHARED 3
.Os
.Sh NAME
.Nm pthread_rwlockattr_setpshared
.Nd set 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
Fixed bitrot in synopsis. The change from "int *pshared" to "int pshared" hadn't reached here.
1999-12-23 16:51:27 +00:00
.Fn pthread_rwlockattr_setpshared "pthread_rwlockattr_t *attr" "int 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_setpshared
function sets the process shared attribute of
.Fa attr
to the value referenced by
.Fa pshared .
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
.Fa pshared
The .Fn function. Use .Xr where appropriate.
2003-03-24 16:05:24 +00:00
argument 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_setpshared
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_setpshared
The .Fn function. Use .Xr where appropriate.
2003-03-24 16:05:24 +00:00
function will 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
or
.Fa pshared
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_getpshared 3 ,
sort SEE ALSO
2014-12-26 22:41:10 +00:00
.Xr pthread_rwlockattr_init 3
Sort sections.
2005-01-21 08:36:40 +00:00
.Sh STANDARDS
The
.Fn pthread_rwlockattr_setpshared
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_setpshared
function first appeared in
.Fx 3.0 .
Remove mentions that PTHREAD_PROCESS_SHARED is not supported from man pages. Also add support for process-shared synchronization objects to the HISTORY sections where they already exist.
2016-05-31 21:16:34 +00:00
Support for process-shared read/write locks appeared in
.Fx 11.0 .
Reference in New Issue Copy Permalink