mirror/freebsd
1
0
Fork 0
mirror of https://git.FreeBSD.org/src.git synced 2024-12-15 10:17:20 +00:00
Code Issues Releases Activity

Added pthread read/write locks.

Browse Source
This commit is contained in:
Alexander Langer 1998-09-12 13:53:58 +00:00
parent dc5af0d5d4
commit d4a76feb0a
Notes: svn2git 2020-12-20 02:59:44 +00:00 
svn path=/head/; revision=39098
1 changed files with 43 additions and 4 deletions
Show Stats Download Patch File Download Diff File Expand all files Collapse all files

47
share/man/man3/pthread.3
View File

@ -28,9 +28,9 @@
.\" OUT OF THE USE OF THIS SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF
.\" SUCH DAMAGE.
.\"
.\" $Id: pthread.3,v 1.5 1998/01/02 19:19:50 alex Exp $
.\" $Id: pthread.3,v 1.6 1998/04/10 09:33:09 jb Exp $
.\"
.Dd April 4, 1996
.Dd September 10, 1998
.Dt PTHREAD 3
.Os BSD 4
.Sh NAME
@ -47,7 +47,7 @@ The POSIX thread functions are summarized in this section in the following
groups:
.Bl -bullet -offset indent
.It
Thread routines
Thread Routines
.It
Attribute Object Routines
.It
@ -55,6 +55,8 @@ Mutex Routines
.It
Condition Variable Routines
.It
Read/Write Lock Routines
.It
Per-Thread Context Routines
.It
Cleanup Routines
@ -148,6 +150,36 @@ Wait no longer than the specified time for a condition and lock the specified mu
.It int Fn pthread_cond_wait "pthread_cond_t *" "pthread_mutex_t *mutex"
Wait for a condition and lock the specified mutex.
.El
.Sh READ/WRITE LOCK ROUTINES
.Bl -tag -width Er
.It int Fn pthread_rwlock_destroy "pthread_rwlock_t *lock"
Destroy a read/write lock object.
.It int Fn pthread_rwlock_init "pthread_rwlock_t *lock" "const pthread_rwlockattr_t *attr"
Initialize a read/write lock object.
.It int Fn pthread_rwlock_rdlock "pthread_rwlock_t *lock"
Lock a read/write lock for reading, blocking until the lock can be
acquired.
.It int Fn pthread_rwlock_tryrdlock "pthread_rwlock_t *lock"
Attempt to lock a read/write lock for reading, without blocking if the
lock is unavailable.
.It int Fn pthread_rwlock_trywrlock "pthread_rwlock_t *lock"
Attempt to lock a read/write lock for writing, without blocking if the
lock is unavailable.
.It int Fn pthread_rwlock_unlock "pthread_rwlock_t *lock"
Unlock a read/write lock.
.It int Fn pthread_rwlock_wrlock "pthread_rwlock_t *lock"
Lock a read/write lock for writing, blocking until the lock can be
acquired.
.It int Fn pthread_rwlockattr_destroy "pthread_rwlockattr_t *attr"
Destroy a read/write lock attribute object.
.It int Fn pthread_rwlockattr_getpshared "pthread_rwlockattr_t *attr" "int *pshared"
Retrieve the process shared setting for the read/write lock attribute
object.
.It int Fn pthread_rwlockattr_init "pthread_rwlockattr_t *attr"
Initialize a read/write lock attribute object.
.It int Fn pthread_rwlockattr_setpshared "pthread_rwlockattr_t *attr" "int *pshared"
Set the process shared setting for the read/write lock attribute object.
.El
.Sh PER-THREAD CONTEXT ROUTINES
.Bl -tag -width Er
.It int Fn pthread_key_create "pthread_key_t *key" "void (*routine)(void *)"
@ -197,7 +229,9 @@ with the
.Fa pthread_
prefix and not
.Fa _np
suffix conform to IEEE
suffix or
.Fa pthread_rwlock
prefix conform to IEEE
.Pq Dq Tn POSIX
Std 1003.1 Second Edition 1996-07-12
.Pp
@ -206,3 +240,8 @@ The functions in libc_r with the
prefix and
.Fa _np
suffix are non-portable extensions to POSIX threads.
.Pp
The functions in libc_r with the
.Fa pthread_rwlock
prefix are extensions created by The Open Group as part of the Single
UNIX Specification, Version 2.