From cd31d44075ae2f15e3388c615df68063d6936585 Mon Sep 17 00:00:00 2001 From: Ruslan Ermilov Date: Tue, 30 Dec 2003 14:59:10 +0000 Subject: [PATCH] Pull some changes (mostly cosmetic) from libc_r manpages in preparation for the merge. --- lib/libpthread/man/pthread_equal.3 | 3 +- lib/libpthread/man/pthread_exit.3 | 3 +- lib/libpthread/man/pthread_getspecific.3 | 6 ++-- lib/libpthread/man/pthread_join.3 | 6 ++-- lib/libpthread/man/pthread_key_create.3 | 6 ++-- lib/libpthread/man/pthread_key_delete.3 | 6 ++-- lib/libpthread/man/pthread_kill.3 | 6 ++-- lib/libpthread/man/pthread_mutex_destroy.3 | 6 ++-- lib/libpthread/man/pthread_mutex_init.3 | 6 ++-- lib/libpthread/man/pthread_mutex_lock.3 | 6 ++-- lib/libpthread/man/pthread_mutex_trylock.3 | 6 ++-- lib/libpthread/man/pthread_mutex_unlock.3 | 6 ++-- lib/libpthread/man/pthread_mutexattr.3 | 30 ++++++++++++------- lib/libpthread/man/pthread_once.3 | 3 +- lib/libpthread/man/pthread_rwlock_wrlock.3 | 1 + .../man/pthread_rwlockattr_destroy.3 | 3 +- .../man/pthread_rwlockattr_getpshared.3 | 3 +- lib/libpthread/man/pthread_rwlockattr_init.3 | 3 +- .../man/pthread_rwlockattr_setpshared.3 | 6 ++-- lib/libpthread/man/pthread_schedparam.3 | 9 ++++-- lib/libpthread/man/pthread_self.3 | 3 +- lib/libpthread/man/pthread_setspecific.3 | 13 ++++---- lib/libpthread/man/pthread_sigmask.3 | 6 ++-- lib/libpthread/man/pthread_testcancel.3 | 3 +- lib/libpthread/man/sem_destroy.3 | 9 ++++-- lib/libpthread/man/sem_getvalue.3 | 11 ++++--- lib/libpthread/man/sem_init.3 | 22 ++++++++------ lib/libpthread/man/sem_post.3 | 12 +++++--- lib/libpthread/man/sem_wait.3 | 9 ++++-- lib/libpthread/man/sigwait.3 | 6 ++-- 30 files changed, 143 insertions(+), 75 deletions(-) diff --git a/lib/libpthread/man/pthread_equal.3 b/lib/libpthread/man/pthread_equal.3 index 1d1984356823..1ed85319b961 100644 --- a/lib/libpthread/man/pthread_equal.3 +++ b/lib/libpthread/man/pthread_equal.3 @@ -63,6 +63,7 @@ None. .Xr pthread_create 3 , .Xr pthread_exit 3 .Sh STANDARDS +The .Fn pthread_equal -conforms to +function conforms to .St -p1003.1-96 . diff --git a/lib/libpthread/man/pthread_exit.3 b/lib/libpthread/man/pthread_exit.3 index 9d9c730e90a3..2a4295885a27 100644 --- a/lib/libpthread/man/pthread_exit.3 +++ b/lib/libpthread/man/pthread_exit.3 @@ -99,6 +99,7 @@ None. .Xr pthread_create 3 , .Xr pthread_join 3 .Sh STANDARDS +The .Fn pthread_exit -conforms to +function conforms to .St -p1003.1-96 . diff --git a/lib/libpthread/man/pthread_getspecific.3 b/lib/libpthread/man/pthread_getspecific.3 index 515982eff77e..d59003f4e281 100644 --- a/lib/libpthread/man/pthread_getspecific.3 +++ b/lib/libpthread/man/pthread_getspecific.3 @@ -61,8 +61,9 @@ has been deleted with .Fn pthread_key_delete is undefined. .Pp +The .Fn pthread_getspecific -may be called from a thread-specific data destructor function. +function may be called from a thread-specific data destructor function. .Sh RETURN VALUES The .Fn pthread_getspecific @@ -78,6 +79,7 @@ None. .Xr pthread_key_delete 3 , .Xr pthread_setspecific 3 .Sh STANDARDS +The .Fn pthread_getspecific -conforms to +function conforms to .St -p1003.1-96 . diff --git a/lib/libpthread/man/pthread_join.3 b/lib/libpthread/man/pthread_join.3 index 005a94a30d75..dc27b9e51194 100644 --- a/lib/libpthread/man/pthread_join.3 +++ b/lib/libpthread/man/pthread_join.3 @@ -79,8 +79,9 @@ function will return zero. Otherwise an error number will be returned to indicate the error. .Sh ERRORS +The .Fn pthread_join -will fail if: +function will fail if: .Bl -tag -width Er .It Bq Er EINVAL The implementation has detected that the value specified by @@ -99,6 +100,7 @@ specifies the calling thread. .Xr wait 2 , .Xr pthread_create 3 .Sh STANDARDS +The .Fn pthread_join -conforms to +function conforms to .St -p1003.1-96 . diff --git a/lib/libpthread/man/pthread_key_create.3 b/lib/libpthread/man/pthread_key_create.3 index 81da624c84cf..a818e1a52364 100644 --- a/lib/libpthread/man/pthread_key_create.3 +++ b/lib/libpthread/man/pthread_key_create.3 @@ -87,8 +87,9 @@ and returns zero. Otherwise an error number will be returned to indicate the error. .Sh ERRORS +The .Fn pthread_key_create -will fail if: +function will fail if: .Bl -tag -width Er .It Bq Er EAGAIN The system lacked the necessary resources to create another thread-specific @@ -102,6 +103,7 @@ Insufficient memory exists to create the key. .Xr pthread_key_delete 3 , .Xr pthread_setspecific 3 .Sh STANDARDS +The .Fn pthread_key_create -conforms to +function conforms to .St -p1003.1-96 . diff --git a/lib/libpthread/man/pthread_key_delete.3 b/lib/libpthread/man/pthread_key_delete.3 index b71142bed0d0..c7861af50ce2 100644 --- a/lib/libpthread/man/pthread_key_delete.3 +++ b/lib/libpthread/man/pthread_key_delete.3 @@ -80,8 +80,9 @@ function will return zero. Otherwise an error number will be returned to indicate the error. .Sh ERRORS +The .Fn pthread_key_delete -will fail if: +function will fail if: .Bl -tag -width Er .It Bq Er EINVAL The @@ -93,6 +94,7 @@ value is invalid. .Xr pthread_key_create 3 , .Xr pthread_setspecific 3 .Sh STANDARDS +The .Fn pthread_key_delete -conforms to +function conforms to .St -p1003.1-96 . diff --git a/lib/libpthread/man/pthread_kill.3 b/lib/libpthread/man/pthread_kill.3 index 277467dc325c..1ef879a2f765 100644 --- a/lib/libpthread/man/pthread_kill.3 +++ b/lib/libpthread/man/pthread_kill.3 @@ -55,8 +55,9 @@ If successful, returns 0. Otherwise, an error number is returned. .Sh ERRORS +The .Fn pthread_kill -will fail if: +function will fail if: .Bl -tag -width Er .It Bq Er ESRCH .Fa thread @@ -70,6 +71,7 @@ is an invalid or unsupported signal number. .Xr pthread_self 3 , .Xr raise 3 .Sh STANDARDS +The .Fn pthread_kill -conforms to +function conforms to .St -p1003.1-96 diff --git a/lib/libpthread/man/pthread_mutex_destroy.3 b/lib/libpthread/man/pthread_mutex_destroy.3 index 64b902775894..d6c4bcd5e446 100644 --- a/lib/libpthread/man/pthread_mutex_destroy.3 +++ b/lib/libpthread/man/pthread_mutex_destroy.3 @@ -50,8 +50,9 @@ If successful, will return zero, otherwise an error number will be returned to indicate the error. .Sh ERRORS +The .Fn pthread_mutex_destroy -will fail if: +function will fail if: .Bl -tag -width Er .It Bq Er EINVAL The value specified by @@ -67,6 +68,7 @@ is locked by another thread. .Xr pthread_mutex_trylock 3 , .Xr pthread_mutex_unlock 3 .Sh STANDARDS +The .Fn pthread_mutex_destroy -conforms to +function conforms to .St -p1003.1-96 . diff --git a/lib/libpthread/man/pthread_mutex_init.3 b/lib/libpthread/man/pthread_mutex_init.3 index b0f232fe0931..bbc00a0c1405 100644 --- a/lib/libpthread/man/pthread_mutex_init.3 +++ b/lib/libpthread/man/pthread_mutex_init.3 @@ -54,8 +54,9 @@ will return zero and put the new mutex id into .Fa mutex , otherwise an error number will be returned to indicate the error. .Sh ERRORS +The .Fn pthread_mutex_init -will fail if: +function will fail if: .Bl -tag -width Er .It Bq Er EINVAL The value specified by @@ -70,6 +71,7 @@ The process cannot allocate enough memory to create another mutex. .Xr pthread_mutex_trylock 3 , .Xr pthread_mutex_unlock 3 .Sh STANDARDS +The .Fn pthread_mutex_init -conforms to +function conforms to .St -p1003.1-96 . diff --git a/lib/libpthread/man/pthread_mutex_lock.3 b/lib/libpthread/man/pthread_mutex_lock.3 index cbcfb25e8094..b5039a77fcdf 100644 --- a/lib/libpthread/man/pthread_mutex_lock.3 +++ b/lib/libpthread/man/pthread_mutex_lock.3 @@ -52,8 +52,9 @@ If successful, will return zero, otherwise an error number will be returned to indicate the error. .Sh ERRORS +The .Fn pthread_mutex_lock -will fail if: +function will fail if: .Bl -tag -width Er .It Bq Er EINVAL The value specified by @@ -69,6 +70,7 @@ A deadlock would occur if the thread blocked waiting for .Xr pthread_mutex_trylock 3 , .Xr pthread_mutex_unlock 3 .Sh STANDARDS +The .Fn pthread_mutex_lock -conforms to +function conforms to .St -p1003.1-96 . diff --git a/lib/libpthread/man/pthread_mutex_trylock.3 b/lib/libpthread/man/pthread_mutex_trylock.3 index a5b1b6e71cf8..049006f916f1 100644 --- a/lib/libpthread/man/pthread_mutex_trylock.3 +++ b/lib/libpthread/man/pthread_mutex_trylock.3 @@ -53,8 +53,9 @@ If successful, will return zero, otherwise an error number will be returned to indicate the error. .Sh ERRORS +The .Fn pthread_mutex_trylock -will fail if: +function will fail if: .Bl -tag -width Er .It Bq Er EINVAL The value specified by @@ -70,6 +71,7 @@ is already locked. .Xr pthread_mutex_lock 3 , .Xr pthread_mutex_unlock 3 .Sh STANDARDS +The .Fn pthread_mutex_trylock -conforms to +function conforms to .St -p1003.1-96 . diff --git a/lib/libpthread/man/pthread_mutex_unlock.3 b/lib/libpthread/man/pthread_mutex_unlock.3 index b9c870dd7774..77784e1b1962 100644 --- a/lib/libpthread/man/pthread_mutex_unlock.3 +++ b/lib/libpthread/man/pthread_mutex_unlock.3 @@ -52,8 +52,9 @@ If successful, will return zero, otherwise an error number will be returned to indicate the error. .Sh ERRORS +The .Fn pthread_mutex_unlock -will fail if: +function will fail if: .Bl -tag -width Er .It Bq Er EINVAL The value specified by @@ -69,6 +70,7 @@ The current thread does not hold a lock on .Xr pthread_mutex_lock 3 , .Xr pthread_mutex_trylock 3 .Sh STANDARDS +The .Fn pthread_mutex_unlock -conforms to +function conforms to .St -p1003.1-96 . diff --git a/lib/libpthread/man/pthread_mutexattr.3 b/lib/libpthread/man/pthread_mutexattr.3 index 286da2857167..f97602615be1 100644 --- a/lib/libpthread/man/pthread_mutexattr.3 +++ b/lib/libpthread/man/pthread_mutexattr.3 @@ -89,23 +89,26 @@ to the location pointed to by the second function parameter. If successful, these functions return 0. Otherwise, an error number is returned to indicate the error. .Sh ERRORS +The .Fn pthread_mutexattr_init -will fail if: +function will fail if: .Bl -tag -width Er .It Bq Er ENOMEM Out of memory. .El .Pp +The .Fn pthread_mutexattr_destroy -will fail if: +function will fail if: .Bl -tag -width Er .It Bq Er EINVAL Invalid value for .Fa attr . .El .Pp +The .Fn pthread_mutexattr_setprioceiling -will fail if: +function will fail if: .Bl -tag -width Er .It Bq Er EINVAL Invalid value for @@ -114,16 +117,18 @@ or invalid value for .Fa prioceiling . .El .Pp +The .Fn pthread_mutexattr_getprioceiling -will fail if: +function will fail if: .Bl -tag -width Er .It Bq Er EINVAL Invalid value for .Fa attr . .El .Pp +The .Fn pthread_mutexattr_setprotocol -will fail if: +function will fail if: .Bl -tag -width Er .It Bq Er EINVAL Invalid value for @@ -132,16 +137,18 @@ or invalid value for .Fa protocol . .El .Pp +The .Fn pthread_mutexattr_getprotocol -will fail if: +function will fail if: .Bl -tag -width Er .It Bq Er EINVAL Invalid value for .Fa attr . .El .Pp +The .Fn pthread_mutexattr_settype -will fail if: +function will fail if: .Bl -tag -width Er .It Bq Er EINVAL Invalid value for @@ -150,8 +157,9 @@ or invalid value for .Fa type . .El .Pp +The .Fn pthread_mutexattr_gettype -will fail if: +function will fail if: .Bl -tag -width Er .It Bq Er EINVAL Invalid value for @@ -160,12 +168,14 @@ Invalid value for .Sh SEE ALSO .Xr pthread_mutex_init 3 .Sh STANDARDS +The .Fn pthread_mutexattr_init and .Fn pthread_mutexattr_destroy -conform to +functions conform to .St -p1003.1-96 .Pp +The .Fn pthread_mutexattr_setprioceiling , .Fn pthread_mutexattr_getprioceiling , .Fn pthread_mutexattr_setprotocol , @@ -173,5 +183,5 @@ conform to .Fn pthread_mutexattr_settype , and .Fn pthread_mutexattr_gettype -conform to +functions conform to .St -susv2 diff --git a/lib/libpthread/man/pthread_once.3 b/lib/libpthread/man/pthread_once.3 index 6527822207a4..4bdaf95586df 100644 --- a/lib/libpthread/man/pthread_once.3 +++ b/lib/libpthread/man/pthread_once.3 @@ -100,6 +100,7 @@ indicate the error. .Sh ERRORS None. .Sh STANDARDS +The .Fn pthread_once -conforms to +function conforms to .St -p1003.1-96 . diff --git a/lib/libpthread/man/pthread_rwlock_wrlock.3 b/lib/libpthread/man/pthread_rwlock_wrlock.3 index c5e9f9980818..6f4c45d0bba8 100644 --- a/lib/libpthread/man/pthread_rwlock_wrlock.3 +++ b/lib/libpthread/man/pthread_rwlock_wrlock.3 @@ -61,6 +61,7 @@ and functions will return zero. Otherwise an error number will be returned to indicate the error. .Sh SEE ALSO +.Xr pthread_rwlock_init 3 , .Xr pthread_rwlock_rdlock 3 , .Xr pthread_rwlock_tryrdlock 3 , .Xr pthread_rwlock_unlock 3 diff --git a/lib/libpthread/man/pthread_rwlockattr_destroy.3 b/lib/libpthread/man/pthread_rwlockattr_destroy.3 index b5965369f4bc..17cabf325492 100644 --- a/lib/libpthread/man/pthread_rwlockattr_destroy.3 +++ b/lib/libpthread/man/pthread_rwlockattr_destroy.3 @@ -55,8 +55,9 @@ The function is expected to conform to .St -susv2 . .Sh ERRORS +The .Fn pthread_rwlockattr_destroy -may fail if: +function may fail if: .Bl -tag -width Er .It Bq Er EINVAL The value specified by diff --git a/lib/libpthread/man/pthread_rwlockattr_getpshared.3 b/lib/libpthread/man/pthread_rwlockattr_getpshared.3 index ee1a20e98021..9b6870afdf37 100644 --- a/lib/libpthread/man/pthread_rwlockattr_getpshared.3 +++ b/lib/libpthread/man/pthread_rwlockattr_getpshared.3 @@ -67,8 +67,9 @@ The function is expected to conform to .St -susv2 . .Sh ERRORS +The .Fn pthread_rwlockattr_getpshared -may fail if: +function may fail if: .Bl -tag -width Er .It Bq Er EINVAL The value specified by diff --git a/lib/libpthread/man/pthread_rwlockattr_init.3 b/lib/libpthread/man/pthread_rwlockattr_init.3 index 44ad18b6d25d..724e93b90e50 100644 --- a/lib/libpthread/man/pthread_rwlockattr_init.3 +++ b/lib/libpthread/man/pthread_rwlockattr_init.3 @@ -56,8 +56,9 @@ The function is expected to conform to .St -susv2 . .Sh ERRORS +The .Fn pthread_rwlockattr_init -will fail if: +function will fail if: .Bl -tag -width Er .It Bq Er ENOMEM Insufficient memory exists to initialize the attribute object. diff --git a/lib/libpthread/man/pthread_rwlockattr_setpshared.3 b/lib/libpthread/man/pthread_rwlockattr_setpshared.3 index a4fba8c94fed..fe7933679f80 100644 --- a/lib/libpthread/man/pthread_rwlockattr_setpshared.3 +++ b/lib/libpthread/man/pthread_rwlockattr_setpshared.3 @@ -43,8 +43,9 @@ function sets the process shared attribute of .Fa attr to the value referenced by .Fa pshared . +The .Fa pshared -may be one of two values: +argument may be one of two values: .Bl -tag -width PTHREAD_PROCESS_PRIVATE .It Dv PTHREAD_PROCESS_SHARED Any thread of any process that has access to the memory where the @@ -69,8 +70,9 @@ The function is expected to conform to .St -susv2 . .Sh ERRORS +The .Fn pthread_rwlockattr_setpshared -will fail if: +function will fail if: .Bl -tag -width Er .It Bq Er EINVAL The value specified by diff --git a/lib/libpthread/man/pthread_schedparam.3 b/lib/libpthread/man/pthread_schedparam.3 index 831c2ca20f4e..89702eabf007 100644 --- a/lib/libpthread/man/pthread_schedparam.3 +++ b/lib/libpthread/man/pthread_schedparam.3 @@ -62,8 +62,9 @@ and no more than If successful, these functions return 0. Otherwise, an error number is returned to indicate the error. .Sh ERRORS +The .Fn pthread_setschedparam -will fail if: +function will fail if: .Bl -tag -width Er .It Bq Er EINVAL Invalid value for @@ -75,16 +76,18 @@ Non-existent thread .Va thread . .El .Pp +The .Fn pthread_getschedparam -will fail if: +function will fail if: .Bl -tag -width Er .It Bq Er ESRCH Non-existent thread .Va thread . .El .Sh STANDARDS +The .Fn pthread_setschedparam and .Fn pthread_getschedparam -conform to +functions conform to .St -susv2 diff --git a/lib/libpthread/man/pthread_self.3 b/lib/libpthread/man/pthread_self.3 index 82ac89ee935c..4d6aa2bffd20 100644 --- a/lib/libpthread/man/pthread_self.3 +++ b/lib/libpthread/man/pthread_self.3 @@ -56,6 +56,7 @@ None. .Xr pthread_create 3 , .Xr pthread_equal 3 .Sh STANDARDS +The .Fn pthread_self -conforms to +function conforms to .St -p1003.1-96 . diff --git a/lib/libpthread/man/pthread_setspecific.3 b/lib/libpthread/man/pthread_setspecific.3 index f429fa568997..079743ab2857 100644 --- a/lib/libpthread/man/pthread_setspecific.3 +++ b/lib/libpthread/man/pthread_setspecific.3 @@ -64,18 +64,20 @@ has been deleted with .Fn pthread_key_delete is undefined. .Pp +The .Fn pthread_setspecific -may be called from a thread-specific data destructor function, however this -may result in lost storage or infinite loops. +function may be called from a thread-specific data destructor function, +however this may result in lost storage or infinite loops. .Sh RETURN VALUES -If successful, the +If successful, the .Fn pthread_setspecific function will return zero. Otherwise an error number will be returned to indicate the error. .Sh ERRORS +The .Fn pthread_setspecific -will fail if: +function will fail if: .Bl -tag -width Er .It Bq Er ENOMEM Insufficient memory exists to associate the value with the @@ -90,6 +92,7 @@ value is invalid. .Xr pthread_key_create 3 , .Xr pthread_key_delete 3 .Sh STANDARDS +The .Fn pthread_setspecific -conforms to +function conforms to .St -p1003.1-96 . diff --git a/lib/libpthread/man/pthread_sigmask.3 b/lib/libpthread/man/pthread_sigmask.3 index 489f8541a7aa..c4125430d960 100644 --- a/lib/libpthread/man/pthread_sigmask.3 +++ b/lib/libpthread/man/pthread_sigmask.3 @@ -77,8 +77,9 @@ If successful, returns 0. Otherwise, an error is returned. .Sh ERRORS +The .Fn pthread_sigmask -will fail if: +function will fail if: .Bl -tag -width Er .It Bq Er EINVAL .Fa how @@ -91,6 +92,7 @@ is not one of the defined values. .Xr sigsuspend 2 , .Xr sigsetops 3 .Sh STANDARDS +The .Fn pthread_sigmask -conforms to +function conforms to .St -p1003.1-96 diff --git a/lib/libpthread/man/pthread_testcancel.3 b/lib/libpthread/man/pthread_testcancel.3 index eb945e2872e4..8aea0f9b7719 100644 --- a/lib/libpthread/man/pthread_testcancel.3 +++ b/lib/libpthread/man/pthread_testcancel.3 @@ -197,8 +197,9 @@ or .Sh SEE ALSO .Xr pthread_cancel 3 .Sh STANDARDS +The .Fn pthread_testcancel -conforms to +function conforms to .St -p1003.1-96 . .Sh AUTHORS This man page was written by diff --git a/lib/libpthread/man/sem_destroy.3 b/lib/libpthread/man/sem_destroy.3 index aa4bae7c6fc5..8cd9be1e25b8 100644 --- a/lib/libpthread/man/sem_destroy.3 +++ b/lib/libpthread/man/sem_destroy.3 @@ -51,8 +51,9 @@ is unusable until re-initialized by another call to .Sh RETURN VALUES .Rv -std sem_destroy .Sh ERRORS +The .Fn sem_destroy -will fail if: +function will fail if: .Bl -tag -width Er .It Bq Er EINVAL .Fa sem @@ -63,10 +64,12 @@ There are currently threads blocked on the semaphore that points to. .El .Sh SEE ALSO -.Xr sem_init 3 +.Xr sem_init 3 , +.Xr sem 4 .Sh STANDARDS +The .Fn sem_destroy -conforms to +function conforms to .St -p1003.1-96 . .Pp POSIX does not define the behavior of diff --git a/lib/libpthread/man/sem_getvalue.3 b/lib/libpthread/man/sem_getvalue.3 index 115355286ade..f03bfd37d311 100644 --- a/lib/libpthread/man/sem_getvalue.3 +++ b/lib/libpthread/man/sem_getvalue.3 @@ -37,7 +37,7 @@ .Sh SYNOPSIS .In semaphore.h .Ft int -.Fn sem_getvalue "sem_t *sem" "int *sval" +.Fn sem_getvalue "sem_t * restrict sem" "int * restrict sval" .Sh DESCRIPTION The .Fn sem_getvalue @@ -51,8 +51,9 @@ is actually run. .Sh RETURN VALUES .Rv -std sem_getvalue .Sh ERRORS +The .Fn sem_getvalue -will fail if: +function will fail if: .Bl -tag -width Er .It Bq Er EINVAL .Fa sem @@ -61,10 +62,12 @@ points to an invalid semaphore. .Sh SEE ALSO .Xr sem_post 3 , .Xr sem_trywait 3 , -.Xr sem_wait 3 +.Xr sem_wait 3 , +.Xr sem 4 .Sh STANDARDS +The .Fn sem_getvalue -conforms to +function conforms to .St -p1003.1-96 . .Pp The value of the semaphore is never negative, even if there are threads blocked diff --git a/lib/libpthread/man/sem_init.3 b/lib/libpthread/man/sem_init.3 index 8fac8d6019f1..c70bbaeef548 100644 --- a/lib/libpthread/man/sem_init.3 +++ b/lib/libpthread/man/sem_init.3 @@ -54,19 +54,21 @@ Following a successful call to .Fn sem_init , .Fa sem can be used as an argument in subsequent calls to -.Fa sem_wait , -.Fa sem_trywait , -.Fa sem_post , +.Xr sem_wait 3 , +.Xr sem_trywait 3 , +.Xr sem_post 3 , and -.Fa sem_destroy . +.Xr sem_destroy 3 . +The .Fa sem -is no longer valid after a successful call to -.Fa sem_destroy . +argument is no longer valid after a successful call to +.Xr sem_destroy 3 . .Sh RETURN VALUES .Rv -std sem_init .Sh ERRORS +The .Fn sem_init -will fail if: +function will fail if: .Bl -tag -width Er .It Bq Er EINVAL .Fa value @@ -80,10 +82,12 @@ Unable to initialize a shared semaphore. .Xr sem_destroy 3 , .Xr sem_post 3 , .Xr sem_trywait 3 , -.Xr sem_wait 3 +.Xr sem_wait 3 , +.Xr sem 4 .Sh STANDARDS +The .Fn sem_init -conforms to +function conforms to .St -p1003.1-96 . .Pp This implementation does not support shared semaphores, and reports this fact diff --git a/lib/libpthread/man/sem_post.3 b/lib/libpthread/man/sem_post.3 index c2dd70417d94..918fef5bce92 100644 --- a/lib/libpthread/man/sem_post.3 +++ b/lib/libpthread/man/sem_post.3 @@ -49,13 +49,15 @@ is called, then the highest priority thread that has been blocked the longest on the semaphore will be allowed to return from .Fn sem_wait . .Pp +The .Fn sem_post -is signal-reentrant and may be called within signal handlers. +function is signal-reentrant and may be called within signal handlers. .Sh RETURN VALUES .Rv -std sem_post .Sh ERRORS +The .Fn sem_post -will fail if: +function will fail if: .Bl -tag -width Er .It Bq Er EINVAL .Fa sem @@ -63,8 +65,10 @@ points to an invalid semaphore. .El .Sh SEE ALSO .Xr sem_trywait 3 , -.Xr sem_wait 3 +.Xr sem_wait 3 , +.Xr sem 4 .Sh STANDARDS +The .Fn sem_post -conforms to +function conforms to .St -p1003.1-96 . diff --git a/lib/libpthread/man/sem_wait.3 b/lib/libpthread/man/sem_wait.3 index 25a0b05a3d75..9294367a22c2 100644 --- a/lib/libpthread/man/sem_wait.3 +++ b/lib/libpthread/man/sem_wait.3 @@ -59,10 +59,11 @@ an error is returned. .Sh RETURN VALUES .Rv -std .Sh ERRORS +The .Fn sem_wait and .Fn sem_trywait -will fail if: +functions will fail if: .Bl -tag -width Er .It Bq Er EINVAL .Fa sem @@ -77,10 +78,12 @@ will fail if: The semaphore value was zero, and thus could not be decremented. .El .Sh SEE ALSO -.Xr sem_post 3 +.Xr sem_post 3 , +.Xr sem 4 .Sh STANDARDS +The .Fn sem_wait and .Fn sem_trywait -conform to +functions conform to .St -p1003.1-96 . diff --git a/lib/libpthread/man/sigwait.3 b/lib/libpthread/man/sigwait.3 index 6a2e05ee02cd..47341f0686a9 100644 --- a/lib/libpthread/man/sigwait.3 +++ b/lib/libpthread/man/sigwait.3 @@ -65,8 +65,9 @@ returns 0 and sets the location pointed to by to the cleared signal number. Otherwise, an error number is returned. .Sh ERRORS +The .Fn sigwait -will fail if: +function will fail if: .Bl -tag -width Er .It Bq Er EINVAL .Fa set @@ -79,6 +80,7 @@ specifies one or more invalid signal numbers. .Xr pause 3 , .Xr pthread_sigmask 3 .Sh STANDARDS +The .Fn sigwait -conforms to +function conforms to .St -p1003.1-96