summaryrefslogtreecommitdiffstats
path: root/lib
diff options
context:
space:
mode:
authorcharnier <charnier@FreeBSD.org>2003-03-24 16:05:24 +0000
committercharnier <charnier@FreeBSD.org>2003-03-24 16:05:24 +0000
commitd0441d10b5801db1d53f885fa707ae3768d2c98d (patch)
tree71e3892a3a656b566e2fb0d980a8bc0a6fe0c300 /lib
parentf0ffe0ef9f006aa0c680f7def2d63f561eaade3f (diff)
downloadFreeBSD-src-d0441d10b5801db1d53f885fa707ae3768d2c98d.zip
FreeBSD-src-d0441d10b5801db1d53f885fa707ae3768d2c98d.tar.gz
The .Fn function. Use .Xr where appropriate.
Diffstat (limited to 'lib')
-rw-r--r--lib/libc/gen/sem_destroy.36
-rw-r--r--lib/libc/gen/sem_getvalue.36
-rw-r--r--lib/libc/gen/sem_init.319
-rw-r--r--lib/libc/gen/sem_wait.36
-rw-r--r--lib/libc/sys/sigwait.26
-rw-r--r--lib/libc_r/man/pthread_attr_get_np.33
-rw-r--r--lib/libc_r/man/pthread_condattr.39
-rw-r--r--lib/libc_r/man/pthread_create.36
-rw-r--r--lib/libc_r/man/pthread_detach.36
-rw-r--r--lib/libc_r/man/pthread_equal.33
-rw-r--r--lib/libc_r/man/pthread_exit.33
-rw-r--r--lib/libc_r/man/pthread_getspecific.36
-rw-r--r--lib/libc_r/man/pthread_join.36
-rw-r--r--lib/libc_r/man/pthread_key_create.36
-rw-r--r--lib/libc_r/man/pthread_key_delete.36
-rw-r--r--lib/libc_r/man/pthread_kill.36
-rw-r--r--lib/libc_r/man/pthread_mutex_destroy.36
-rw-r--r--lib/libc_r/man/pthread_mutex_init.36
-rw-r--r--lib/libc_r/man/pthread_mutex_lock.36
-rw-r--r--lib/libc_r/man/pthread_mutex_trylock.36
-rw-r--r--lib/libc_r/man/pthread_mutex_unlock.36
-rw-r--r--lib/libc_r/man/pthread_mutexattr.330
-rw-r--r--lib/libc_r/man/pthread_once.33
-rw-r--r--lib/libc_r/man/pthread_rwlockattr_destroy.33
-rw-r--r--lib/libc_r/man/pthread_rwlockattr_getpshared.33
-rw-r--r--lib/libc_r/man/pthread_rwlockattr_setpshared.36
-rw-r--r--lib/libc_r/man/pthread_schedparam.39
-rw-r--r--lib/libc_r/man/pthread_self.33
-rw-r--r--lib/libc_r/man/pthread_setspecific.313
-rw-r--r--lib/libc_r/man/pthread_sigmask.36
-rw-r--r--lib/libc_r/man/pthread_testcancel.33
-rw-r--r--lib/libc_r/man/sem_destroy.36
-rw-r--r--lib/libc_r/man/sem_getvalue.36
-rw-r--r--lib/libc_r/man/sem_init.319
-rw-r--r--lib/libc_r/man/sem_wait.36
-rw-r--r--lib/libc_r/man/sigwait.36
36 files changed, 166 insertions, 89 deletions
diff --git a/lib/libc/gen/sem_destroy.3 b/lib/libc/gen/sem_destroy.3
index c79b558..9b88b02 100644
--- a/lib/libc/gen/sem_destroy.3
+++ b/lib/libc/gen/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
@@ -66,8 +67,9 @@ points to.
.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/libc/gen/sem_getvalue.3 b/lib/libc/gen/sem_getvalue.3
index 9517ffb..694ced4 100644
--- a/lib/libc/gen/sem_getvalue.3
+++ b/lib/libc/gen/sem_getvalue.3
@@ -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
@@ -64,8 +65,9 @@ points to an invalid semaphore.
.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/libc/gen/sem_init.3 b/lib/libc/gen/sem_init.3
index f9eec78..46394b4 100644
--- a/lib/libc/gen/sem_init.3
+++ b/lib/libc/gen/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
@@ -83,8 +85,9 @@ Unable to initialize a shared semaphore.
.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/libc/gen/sem_wait.3 b/lib/libc/gen/sem_wait.3
index 84a17b3..735061e 100644
--- a/lib/libc/gen/sem_wait.3
+++ b/lib/libc/gen/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
@@ -80,8 +81,9 @@ The semaphore value was zero, and thus could not be decremented.
.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/libc/sys/sigwait.2 b/lib/libc/sys/sigwait.2
index e20595e..3ff8a52 100644
--- a/lib/libc/sys/sigwait.2
+++ b/lib/libc/sys/sigwait.2
@@ -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
diff --git a/lib/libc_r/man/pthread_attr_get_np.3 b/lib/libc_r/man/pthread_attr_get_np.3
index bf856d4..82e1065 100644
--- a/lib/libc_r/man/pthread_attr_get_np.3
+++ b/lib/libc_r/man/pthread_attr_get_np.3
@@ -87,8 +87,9 @@ If successful,
function returns 0.
Otherwise, an error number is returned to indicate the error.
.Sh ERRORS
+The
.Fn pthread_attr_get_np
-will fail if:
+function will fail if:
.Bl -tag -width Er
.It Bq Er EINVAL
Invalid value for one of given parameters.
diff --git a/lib/libc_r/man/pthread_condattr.3 b/lib/libc_r/man/pthread_condattr.3
index 478e112..fb0c318 100644
--- a/lib/libc_r/man/pthread_condattr.3
+++ b/lib/libc_r/man/pthread_condattr.3
@@ -61,15 +61,17 @@ function destroys a condition attribute object.
If successful, these functions return 0.
Otherwise, an error number is returned to indicate the error.
.Sh ERRORS
+The
.Fn pthread_condattr_init
-will fail if:
+function will fail if:
.Bl -tag -width Er
.It Bq Er ENOMEM
Out of memory.
.El
.Pp
+The
.Fn pthread_condattr_destroy
-will fail if:
+function will fail if:
.Bl -tag -width Er
.It Bq Er EINVAL
Invalid value for
@@ -78,8 +80,9 @@ Invalid value for
.Sh SEE ALSO
.Xr pthread_cond_init 3
.Sh STANDARDS
+The
.Fn pthread_condattr_init
and
.Fn pthread_condattr_destroy
-conform to
+functions conform to
.St -p1003.1-96
diff --git a/lib/libc_r/man/pthread_create.3 b/lib/libc_r/man/pthread_create.3
index 35f783c..32f1875 100644
--- a/lib/libc_r/man/pthread_create.3
+++ b/lib/libc_r/man/pthread_create.3
@@ -99,8 +99,9 @@ function will return zero.
Otherwise an error number will be returned to
indicate the error.
.Sh ERRORS
+The
.Fn pthread_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, or
@@ -118,6 +119,7 @@ is invalid.
.Xr pthread_exit 3 ,
.Xr pthread_join 3
.Sh STANDARDS
+The
.Fn pthread_create
-conforms to
+function conforms to
.St -p1003.1-96 .
diff --git a/lib/libc_r/man/pthread_detach.3 b/lib/libc_r/man/pthread_detach.3
index 15729af..55dd222 100644
--- a/lib/libc_r/man/pthread_detach.3
+++ b/lib/libc_r/man/pthread_detach.3
@@ -69,8 +69,9 @@ These early drafts
also passed a pointer to pthread_t as the argument.
Beware!
.Sh ERRORS
+The
.Fn pthread_detach
-will fail if:
+function will fail if:
.Bl -tag -width Er
.It Bq Er EINVAL
The implementation has detected that the value specified by
@@ -84,6 +85,7 @@ thread ID,
.Sh SEE ALSO
.Xr pthread_join 3
.Sh STANDARDS
+The
.Fn pthread_detach
-conforms to
+function conforms to
.St -p1003.1-96 .
diff --git a/lib/libc_r/man/pthread_equal.3 b/lib/libc_r/man/pthread_equal.3
index 8b733da..9b10fad 100644
--- a/lib/libc_r/man/pthread_equal.3
+++ b/lib/libc_r/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/libc_r/man/pthread_exit.3 b/lib/libc_r/man/pthread_exit.3
index 0bfdad6..1398307 100644
--- a/lib/libc_r/man/pthread_exit.3
+++ b/lib/libc_r/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/libc_r/man/pthread_getspecific.3 b/lib/libc_r/man/pthread_getspecific.3
index c7a04fa..a7999e5 100644
--- a/lib/libc_r/man/pthread_getspecific.3
+++ b/lib/libc_r/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/libc_r/man/pthread_join.3 b/lib/libc_r/man/pthread_join.3
index 98ae70d..513e291 100644
--- a/lib/libc_r/man/pthread_join.3
+++ b/lib/libc_r/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/libc_r/man/pthread_key_create.3 b/lib/libc_r/man/pthread_key_create.3
index 7075dcc..a2b0918 100644
--- a/lib/libc_r/man/pthread_key_create.3
+++ b/lib/libc_r/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/libc_r/man/pthread_key_delete.3 b/lib/libc_r/man/pthread_key_delete.3
index bc0cf8a..c025857 100644
--- a/lib/libc_r/man/pthread_key_delete.3
+++ b/lib/libc_r/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/libc_r/man/pthread_kill.3 b/lib/libc_r/man/pthread_kill.3
index e46e2b2..94434bf 100644
--- a/lib/libc_r/man/pthread_kill.3
+++ b/lib/libc_r/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/libc_r/man/pthread_mutex_destroy.3 b/lib/libc_r/man/pthread_mutex_destroy.3
index 59d2b48..1ae5147 100644
--- a/lib/libc_r/man/pthread_mutex_destroy.3
+++ b/lib/libc_r/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/libc_r/man/pthread_mutex_init.3 b/lib/libc_r/man/pthread_mutex_init.3
index c3fb60c..11fbee9 100644
--- a/lib/libc_r/man/pthread_mutex_init.3
+++ b/lib/libc_r/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
@@ -72,6 +73,7 @@ The temporarily lacks the resources 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/libc_r/man/pthread_mutex_lock.3 b/lib/libc_r/man/pthread_mutex_lock.3
index cc35ff2..01628c8 100644
--- a/lib/libc_r/man/pthread_mutex_lock.3
+++ b/lib/libc_r/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/libc_r/man/pthread_mutex_trylock.3 b/lib/libc_r/man/pthread_mutex_trylock.3
index 5de24ce..a40bf97 100644
--- a/lib/libc_r/man/pthread_mutex_trylock.3
+++ b/lib/libc_r/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/libc_r/man/pthread_mutex_unlock.3 b/lib/libc_r/man/pthread_mutex_unlock.3
index f6bc457..8e05cce 100644
--- a/lib/libc_r/man/pthread_mutex_unlock.3
+++ b/lib/libc_r/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/libc_r/man/pthread_mutexattr.3 b/lib/libc_r/man/pthread_mutexattr.3
index b6d84d1..91fde14 100644
--- a/lib/libc_r/man/pthread_mutexattr.3
+++ b/lib/libc_r/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/libc_r/man/pthread_once.3 b/lib/libc_r/man/pthread_once.3
index 7ad97fe..aed9698 100644
--- a/lib/libc_r/man/pthread_once.3
+++ b/lib/libc_r/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/libc_r/man/pthread_rwlockattr_destroy.3 b/lib/libc_r/man/pthread_rwlockattr_destroy.3
index 3ba97cf..65c6d3f 100644
--- a/lib/libc_r/man/pthread_rwlockattr_destroy.3
+++ b/lib/libc_r/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/libc_r/man/pthread_rwlockattr_getpshared.3 b/lib/libc_r/man/pthread_rwlockattr_getpshared.3
index 56bda44..227f512 100644
--- a/lib/libc_r/man/pthread_rwlockattr_getpshared.3
+++ b/lib/libc_r/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/libc_r/man/pthread_rwlockattr_setpshared.3 b/lib/libc_r/man/pthread_rwlockattr_setpshared.3
index e19e66c..f04bf9f 100644
--- a/lib/libc_r/man/pthread_rwlockattr_setpshared.3
+++ b/lib/libc_r/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/libc_r/man/pthread_schedparam.3 b/lib/libc_r/man/pthread_schedparam.3
index c76f4d90..ea72087 100644
--- a/lib/libc_r/man/pthread_schedparam.3
+++ b/lib/libc_r/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/libc_r/man/pthread_self.3 b/lib/libc_r/man/pthread_self.3
index 899af43..db7dd29 100644
--- a/lib/libc_r/man/pthread_self.3
+++ b/lib/libc_r/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/libc_r/man/pthread_setspecific.3 b/lib/libc_r/man/pthread_setspecific.3
index 5bc274c..a2c47d0 100644
--- a/lib/libc_r/man/pthread_setspecific.3
+++ b/lib/libc_r/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/libc_r/man/pthread_sigmask.3 b/lib/libc_r/man/pthread_sigmask.3
index 5efa925..df97ce1 100644
--- a/lib/libc_r/man/pthread_sigmask.3
+++ b/lib/libc_r/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/libc_r/man/pthread_testcancel.3 b/lib/libc_r/man/pthread_testcancel.3
index 6467ac6..de69294 100644
--- a/lib/libc_r/man/pthread_testcancel.3
+++ b/lib/libc_r/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/libc_r/man/sem_destroy.3 b/lib/libc_r/man/sem_destroy.3
index c79b558..9b88b02 100644
--- a/lib/libc_r/man/sem_destroy.3
+++ b/lib/libc_r/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
@@ -66,8 +67,9 @@ points to.
.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/libc_r/man/sem_getvalue.3 b/lib/libc_r/man/sem_getvalue.3
index 9517ffb..694ced4 100644
--- a/lib/libc_r/man/sem_getvalue.3
+++ b/lib/libc_r/man/sem_getvalue.3
@@ -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
@@ -64,8 +65,9 @@ points to an invalid semaphore.
.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/libc_r/man/sem_init.3 b/lib/libc_r/man/sem_init.3
index f9eec78..46394b4 100644
--- a/lib/libc_r/man/sem_init.3
+++ b/lib/libc_r/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
@@ -83,8 +85,9 @@ Unable to initialize a shared semaphore.
.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/libc_r/man/sem_wait.3 b/lib/libc_r/man/sem_wait.3
index 84a17b3..735061e 100644
--- a/lib/libc_r/man/sem_wait.3
+++ b/lib/libc_r/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
@@ -80,8 +81,9 @@ The semaphore value was zero, and thus could not be decremented.
.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/libc_r/man/sigwait.3 b/lib/libc_r/man/sigwait.3
index e20595e..3ff8a52 100644
--- a/lib/libc_r/man/sigwait.3
+++ b/lib/libc_r/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
OpenPOWER on IntegriCloud