summaryrefslogtreecommitdiffstats
path: root/share/man/man3/pthread_rwlock_timedrdlock.3
diff options
context:
space:
mode:
authorru <ru@FreeBSD.org>2004-06-17 17:49:30 +0000
committerru <ru@FreeBSD.org>2004-06-17 17:49:30 +0000
commitc5e3be2b7c773a43ddb3ba7e6ea11476dc4a367d (patch)
tree661c943a38cd068c55a2383430095b604ce22499 /share/man/man3/pthread_rwlock_timedrdlock.3
parentbbd8cdb07b554ccecb7ead05d36280e58505f8e5 (diff)
downloadFreeBSD-src-c5e3be2b7c773a43ddb3ba7e6ea11476dc4a367d.zip
FreeBSD-src-c5e3be2b7c773a43ddb3ba7e6ea11476dc4a367d.tar.gz
Fixed markup bugs.
Spell function correctly when talking about restarting after a signal.
Diffstat (limited to 'share/man/man3/pthread_rwlock_timedrdlock.3')
-rw-r--r--share/man/man3/pthread_rwlock_timedrdlock.325
1 files changed, 13 insertions, 12 deletions
diff --git a/share/man/man3/pthread_rwlock_timedrdlock.3 b/share/man/man3/pthread_rwlock_timedrdlock.3
index d08ea72..752c775 100644
--- a/share/man/man3/pthread_rwlock_timedrdlock.3
+++ b/share/man/man3/pthread_rwlock_timedrdlock.3
@@ -28,8 +28,8 @@
.Dt PTHREAD_RWLOCK_TIMEDRDLOCK 3
.Os
.Sh NAME
-.Nm pthread_rwlock_timedrdlock ,
-.Nd acquire a read-write lock for reading or give up after a specified period
+.Nm pthread_rwlock_timedrdlock
+.Nd "acquire a read-write lock for reading or give up after a specified period"
.Sh LIBRARY
.Lb libpthread
.Lb libthr
@@ -47,15 +47,14 @@ this wait shall be terminated when
.Fa abs_timeout
expires.
.Pp
-.Pp
A thread may hold multiple concurrent read locks.
The
-.Fn pthread_rwlock_unlock
+.Xr pthread_rwlock_unlock 3
function must be called once for each lock acquired.
.Pp
If the thread should be interrupted by a signal,
the
-.Fn pthread_rwlock_wrlock
+.Fn pthread_rwlock_timedrdlock
function will be automatically restarted after the thread returns from
the signal handler.
.Pp
@@ -69,17 +68,18 @@ To prevent writer starvation, writers are favored over readers.
.Sh RETURN VALUES
If successful, the
.Fn pthread_rwlock_timedrdlock
-function will return zero. Otherwise an error number will be returned
-to indicate the error.
+function will return zero.
+Otherwise, an error number will be returned to indicate the error.
.Pp
-This function shall not return an error code of EINTR.
+This function shall not return an error code of
+.Er EINTR .
.Sh ERRORS
The
.Fn pthread_rwlock_timedrdlock
function will fail if:
.Bl -tag -width Er
.It Bq Er ETIMEDOUT
-The lock could not be acquired before the specified timeout expired
+The lock could not be acquired before the specified timeout expired.
.El
.Pp
The
@@ -99,13 +99,14 @@ The value specified by
.Fa rwlock
does not refer to an initialized read-write lock object,
or the
-.Fa abs_timeout nanosecond value is less than zero or
+.Fa abs_timeout
+nanosecond value is less than zero or
greater than or equal to 1 billion.
.El
.Sh SEE ALSO
.Xr pthread_rwlock_init 3 ,
-.Xr pthread_rwlock_timedwrlock 3
-.Xr pthread_rwlock_unlock 3 ,
+.Xr pthread_rwlock_timedwrlock 3 ,
+.Xr pthread_rwlock_unlock 3
.Sh STANDARDS
The
.Fn pthread_rwlock_timedrdlock
OpenPOWER on IntegriCloud