diff --git a/share/man/man3/pthread_rwlock_timedrdlock.3 b/share/man/man3/pthread_rwlock_timedrdlock.3 index d08ea72fe32d..752c7754de5a 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 diff --git a/share/man/man3/pthread_rwlock_timedwrlock.3 b/share/man/man3/pthread_rwlock_timedwrlock.3 index efe45dcc302e..ff0e167a7dd5 100644 --- a/share/man/man3/pthread_rwlock_timedwrlock.3 +++ b/share/man/man3/pthread_rwlock_timedwrlock.3 @@ -28,8 +28,8 @@ .Dt PTHREAD_RWLOCK_TIMEDWRLOCK 3 .Os .Sh NAME -.Nm pthread_rwlock_timedwrlock , -.Nd acquire a read-write lock for writing or give up after a specified period +.Nm pthread_rwlock_timedwrlock +.Nd "acquire a read-write lock for writing or give up after a specified period" .Sh LIBRARY .Lb libpthread .Lb libthr @@ -49,9 +49,9 @@ expires. .Pp If the thread should be interrupted by a signal, the -.Fn pthread_rwlock_wrlock +.Fn pthread_rwlock_timedwrlock function will be automatically restarted after the thread returns from -the signal handler. +the signal handler. .Pp The calling thread may deadlock if at the time the call is made it holds @@ -63,17 +63,18 @@ To prevent writer starvation, writers are favored over readers. .Sh RETURN VALUES If successful, the .Fn pthread_rwlock_timedwrlock -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_timedwrlock function shall 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 @@ -88,13 +89,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_timedrdlock 3 -.Xr pthread_rwlock_unlock 3 , +.Xr pthread_rwlock_timedrdlock 3 , +.Xr pthread_rwlock_unlock 3 .Sh STANDARDS The .Fn pthread_rwlock_timedwrlock