summaryrefslogtreecommitdiffstats
path: root/share/man/man3
diff options
context:
space:
mode:
Diffstat (limited to 'share/man/man3')
-rw-r--r--share/man/man3/pthread_attr_get_np.310
-rw-r--r--share/man/man3/pthread_barrier_destroy.318
-rw-r--r--share/man/man3/pthread_rwlock_destroy.314
-rw-r--r--share/man/man3/pthread_rwlock_init.318
-rw-r--r--share/man/man3/pthread_rwlock_rdlock.324
-rw-r--r--share/man/man3/pthread_rwlock_unlock.316
-rw-r--r--share/man/man3/pthread_rwlock_wrlock.324
-rw-r--r--share/man/man3/pthread_rwlockattr_destroy.314
-rw-r--r--share/man/man3/pthread_rwlockattr_getpshared.318
-rw-r--r--share/man/man3/pthread_rwlockattr_init.316
-rw-r--r--share/man/man3/pthread_rwlockattr_setpshared.318
-rw-r--r--share/man/man3/stdarg.314
12 files changed, 102 insertions, 102 deletions
diff --git a/share/man/man3/pthread_attr_get_np.3 b/share/man/man3/pthread_attr_get_np.3
index 6a31d33..479fa42 100644
--- a/share/man/man3/pthread_attr_get_np.3
+++ b/share/man/man3/pthread_attr_get_np.3
@@ -68,6 +68,11 @@ The
.Fn pthread_attr_get_np
function will always return a pointer to the thread's real stack address,
regardless of its value in the original attributes structure.
+.Sh RETURN VALUES
+If successful,
+.Fn pthread_attr_get_np
+function returns 0.
+Otherwise, an error number is returned to indicate the error.
.Sh EXAMPLES
.Bd -literal
size_t
@@ -83,11 +88,6 @@ my_thread_stack_size(pthread_t pid)
return(size);
}
.Ed
-.Sh RETURN VALUES
-If successful,
-.Fn pthread_attr_get_np
-function returns 0.
-Otherwise, an error number is returned to indicate the error.
.Sh ERRORS
The
.Fn pthread_attr_get_np
diff --git a/share/man/man3/pthread_barrier_destroy.3 b/share/man/man3/pthread_barrier_destroy.3
index c579e7d..6786ba3 100644
--- a/share/man/man3/pthread_barrier_destroy.3
+++ b/share/man/man3/pthread_barrier_destroy.3
@@ -75,6 +75,15 @@ any of them will be released is determined by the
argument to
.Fn pthread_barrier_init .
Once the threads have been released the barrier will be reset.
+.Sh IMPLEMENTATION NOTES
+In both
+.Lb libpthread
+and
+.Lb libthr
+the
+.Dv PTHREAD_BARRIER_SERIAL_THREAD
+return value will
+always be returned by the last thread to reach the barrier.
.Sh RETURN VALUES
If successful,
both
@@ -92,15 +101,6 @@ Otherwise, an error number will be returned to indicate the error.
.Pp
None of these functions will return
.Er EINTR .
-.Sh IMPLEMENTATION NOTES
-In both
-.Lb libpthread
-and
-.Lb libthr
-the
-.Dv PTHREAD_BARRIER_SERIAL_THREAD
-return value will
-always be returned by the last thread to reach the barrier.
.Sh ERRORS
The
.Fn pthread_barrier_destroy
diff --git a/share/man/man3/pthread_rwlock_destroy.3 b/share/man/man3/pthread_rwlock_destroy.3
index f44aea6..5d7eafa 100644
--- a/share/man/man3/pthread_rwlock_destroy.3
+++ b/share/man/man3/pthread_rwlock_destroy.3
@@ -49,13 +49,6 @@ If successful, the
function will return zero.
Otherwise an error number will be returned
to indicate the error.
-.Sh SEE ALSO
-.Xr pthread_rwlock_init 3
-.Sh STANDARDS
-The
-.Fn pthread_rwlock_destroy
-function is expected to conform to
-.St -susv2 .
.Sh ERRORS
The
.Fn pthread_rwlock_destroy
@@ -78,6 +71,13 @@ The value specified by
.Fa lock
is invalid.
.El
+.Sh SEE ALSO
+.Xr pthread_rwlock_init 3
+.Sh STANDARDS
+The
+.Fn pthread_rwlock_destroy
+function is expected to conform to
+.St -susv2 .
.Sh HISTORY
The
.Fn pthread_rwlock_destroy
diff --git a/share/man/man3/pthread_rwlock_init.3 b/share/man/man3/pthread_rwlock_init.3
index baee444..b4f8f7f 100644
--- a/share/man/man3/pthread_rwlock_init.3
+++ b/share/man/man3/pthread_rwlock_init.3
@@ -57,15 +57,6 @@ If successful, the
function will return zero.
Otherwise an error number will be returned
to indicate the error.
-.Sh SEE ALSO
-.Xr pthread_rwlockattr_init 3 ,
-.Xr pthread_rwlockattr_setpshared 3 ,
-.Xr pthread_rwlock_destroy 3
-.Sh STANDARDS
-The
-.Fn pthread_rwlock_init
-function is expected to conform to
-.St -susv2 .
.Sh ERRORS
The
.Fn pthread_rwlock_init
@@ -95,6 +86,15 @@ The value specified by
.Fa attr
is invalid.
.El
+.Sh SEE ALSO
+.Xr pthread_rwlockattr_init 3 ,
+.Xr pthread_rwlockattr_setpshared 3 ,
+.Xr pthread_rwlock_destroy 3
+.Sh STANDARDS
+The
+.Fn pthread_rwlock_init
+function is expected to conform to
+.St -susv2 .
.Sh HISTORY
The
.Fn pthread_rwlock_init
diff --git a/share/man/man3/pthread_rwlock_rdlock.3 b/share/man/man3/pthread_rwlock_rdlock.3
index 6b8affd..e4c0b73 100644
--- a/share/man/man3/pthread_rwlock_rdlock.3
+++ b/share/man/man3/pthread_rwlock_rdlock.3
@@ -77,18 +77,6 @@ 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_trywrlock 3 ,
-.Xr pthread_rwlock_unlock 3 ,
-.Xr pthread_rwlock_wrlock 3
-.Sh STANDARDS
-The
-.Fn pthread_rwlock_rdlock
-and
-.Fn pthread_rwlock_tryrdlock
-functions are expected to conform to
-.St -susv2 .
.Sh ERRORS
The
.Fn pthread_rwlock_tryrdlock
@@ -122,6 +110,18 @@ is invalid.
Insufficient memory exists to initialize the lock (applies to
statically initialized locks only).
.El
+.Sh SEE ALSO
+.Xr pthread_rwlock_init 3 ,
+.Xr pthread_rwlock_trywrlock 3 ,
+.Xr pthread_rwlock_unlock 3 ,
+.Xr pthread_rwlock_wrlock 3
+.Sh STANDARDS
+The
+.Fn pthread_rwlock_rdlock
+and
+.Fn pthread_rwlock_tryrdlock
+functions are expected to conform to
+.St -susv2 .
.Sh HISTORY
The
.Fn pthread_rwlock_rdlock
diff --git a/share/man/man3/pthread_rwlock_unlock.3 b/share/man/man3/pthread_rwlock_unlock.3
index 91ba9f0..652ad22 100644
--- a/share/man/man3/pthread_rwlock_unlock.3
+++ b/share/man/man3/pthread_rwlock_unlock.3
@@ -57,14 +57,6 @@ to indicate the error.
The results are undefined if
.Fa lock
is not held by the calling thread.
-.Sh SEE ALSO
-.Xr pthread_rwlock_rdlock 3 ,
-.Xr pthread_rwlock_wrlock 3
-.Sh STANDARDS
-The
-.Fn pthread_rwlock_unlock
-function is expected to conform to
-.St -susv2 .
.Sh ERRORS
The
.Fn pthread_rwlock_unlock
@@ -77,6 +69,14 @@ is invalid.
.It Bq Er EPERM
The current thread does not own the read/write lock.
.El
+.Sh SEE ALSO
+.Xr pthread_rwlock_rdlock 3 ,
+.Xr pthread_rwlock_wrlock 3
+.Sh STANDARDS
+The
+.Fn pthread_rwlock_unlock
+function is expected to conform to
+.St -susv2 .
.Sh HISTORY
The
.Fn pthread_rwlock_unlock
diff --git a/share/man/man3/pthread_rwlock_wrlock.3 b/share/man/man3/pthread_rwlock_wrlock.3
index 5349504..c4fa422 100644
--- a/share/man/man3/pthread_rwlock_wrlock.3
+++ b/share/man/man3/pthread_rwlock_wrlock.3
@@ -63,18 +63,6 @@ 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
-.Sh STANDARDS
-The
-.Fn pthread_rwlock_wrlock
-and
-.Fn pthread_rwlock_trywrlock
-functions are expected to conform to
-.St -susv2 .
.Sh ERRORS
The
.Fn pthread_rwlock_trywrlock
@@ -101,6 +89,18 @@ is invalid.
Insufficient memory exists to initialize the lock (applies to
statically initialized locks only).
.El
+.Sh SEE ALSO
+.Xr pthread_rwlock_init 3 ,
+.Xr pthread_rwlock_rdlock 3 ,
+.Xr pthread_rwlock_tryrdlock 3 ,
+.Xr pthread_rwlock_unlock 3
+.Sh STANDARDS
+The
+.Fn pthread_rwlock_wrlock
+and
+.Fn pthread_rwlock_trywrlock
+functions are expected to conform to
+.St -susv2 .
.Sh HISTORY
The
.Fn pthread_rwlock_wrlock
diff --git a/share/man/man3/pthread_rwlockattr_destroy.3 b/share/man/man3/pthread_rwlockattr_destroy.3
index 8ccc219..f798939 100644
--- a/share/man/man3/pthread_rwlockattr_destroy.3
+++ b/share/man/man3/pthread_rwlockattr_destroy.3
@@ -50,13 +50,6 @@ If successful, the
function will return zero.
Otherwise an error number will be returned
to indicate the error.
-.Sh SEE ALSO
-.Xr pthread_rwlockattr_init 3
-.Sh STANDARDS
-The
-.Fn pthread_rwlockattr_destroy
-function is expected to conform to
-.St -susv2 .
.Sh ERRORS
The
.Fn pthread_rwlockattr_destroy
@@ -67,6 +60,13 @@ The value specified by
.Fa attr
is invalid.
.El
+.Sh SEE ALSO
+.Xr pthread_rwlockattr_init 3
+.Sh STANDARDS
+The
+.Fn pthread_rwlockattr_destroy
+function is expected to conform to
+.St -susv2 .
.Sh HISTORY
The
.Fn pthread_rwlockattr_destroy
diff --git a/share/man/man3/pthread_rwlockattr_getpshared.3 b/share/man/man3/pthread_rwlockattr_getpshared.3
index acda6e9..f23406c 100644
--- a/share/man/man3/pthread_rwlockattr_getpshared.3
+++ b/share/man/man3/pthread_rwlockattr_getpshared.3
@@ -62,15 +62,6 @@ If successful, the
function will return zero.
Otherwise an error number will be returned
to indicate the error.
-.Sh SEE ALSO
-.Xr pthread_rwlockattr_init 3 ,
-.Xr pthread_rwlockattr_setpshared 3 ,
-.Xr pthread_rwlock_init 3
-.Sh STANDARDS
-The
-.Fn pthread_rwlockattr_getpshared
-function is expected to conform to
-.St -susv2 .
.Sh ERRORS
The
.Fn pthread_rwlockattr_getpshared
@@ -81,6 +72,15 @@ The value specified by
.Fa attr
is invalid.
.El
+.Sh SEE ALSO
+.Xr pthread_rwlockattr_init 3 ,
+.Xr pthread_rwlockattr_setpshared 3 ,
+.Xr pthread_rwlock_init 3
+.Sh STANDARDS
+The
+.Fn pthread_rwlockattr_getpshared
+function is expected to conform to
+.St -susv2 .
.Sh HISTORY
The
.Fn pthread_rwlockattr_getpshared
diff --git a/share/man/man3/pthread_rwlockattr_init.3 b/share/man/man3/pthread_rwlockattr_init.3
index 0020386..8869993 100644
--- a/share/man/man3/pthread_rwlockattr_init.3
+++ b/share/man/man3/pthread_rwlockattr_init.3
@@ -48,6 +48,14 @@ If successful, the
function will return zero.
Otherwise an error number will be returned
to indicate the error.
+.Sh ERRORS
+The
+.Fn pthread_rwlockattr_init
+function will fail if:
+.Bl -tag -width Er
+.It Bq Er ENOMEM
+Insufficient memory exists to initialize the attribute object.
+.El
.Sh SEE ALSO
.Xr pthread_rwlockattr_destroy 3 ,
.Xr pthread_rwlockattr_getpshared 3 ,
@@ -58,14 +66,6 @@ The
.Fn pthread_rwlockattr_init
function is expected to conform to
.St -susv2 .
-.Sh ERRORS
-The
-.Fn pthread_rwlockattr_init
-function will fail if:
-.Bl -tag -width Er
-.It Bq Er ENOMEM
-Insufficient memory exists to initialize the attribute object.
-.El
.Sh HISTORY
The
.Fn pthread_rwlockattr_init
diff --git a/share/man/man3/pthread_rwlockattr_setpshared.3 b/share/man/man3/pthread_rwlockattr_setpshared.3
index b4d2ecb..a8e99b3 100644
--- a/share/man/man3/pthread_rwlockattr_setpshared.3
+++ b/share/man/man3/pthread_rwlockattr_setpshared.3
@@ -64,15 +64,6 @@ If successful, the
function will return zero.
Otherwise an error number will be returned
to indicate the error.
-.Sh SEE ALSO
-.Xr pthread_rwlockattr_getpshared 3 ,
-.Xr pthread_rwlockattr_init 3 ,
-.Xr pthread_rwlock_init 3
-.Sh STANDARDS
-The
-.Fn pthread_rwlockattr_setpshared
-function is expected to conform to
-.St -susv2 .
.Sh ERRORS
The
.Fn pthread_rwlockattr_setpshared
@@ -85,6 +76,15 @@ or
.Fa pshared
is invalid.
.El
+.Sh SEE ALSO
+.Xr pthread_rwlockattr_getpshared 3 ,
+.Xr pthread_rwlockattr_init 3 ,
+.Xr pthread_rwlock_init 3
+.Sh STANDARDS
+The
+.Fn pthread_rwlockattr_setpshared
+function is expected to conform to
+.St -susv2 .
.Sh HISTORY
The
.Fn pthread_rwlockattr_setpshared
diff --git a/share/man/man3/stdarg.3 b/share/man/man3/stdarg.3
index 7f29f2a..92a26f7 100644
--- a/share/man/man3/stdarg.3
+++ b/share/man/man3/stdarg.3
@@ -196,6 +196,13 @@ void foo(char *fmt, ...)
va_end(ap);
}
.Ed
+.Sh COMPATIBILITY
+These macros are
+.Em not
+compatible with the historic macros they replace.
+A backward compatible version can be found in the include
+file
+.In varargs.h .
.Sh STANDARDS
The
.Fn va_start ,
@@ -205,13 +212,6 @@ and
.Fn va_end
macros conform to
.St -isoC-99 .
-.Sh COMPATIBILITY
-These macros are
-.Em not
-compatible with the historic macros they replace.
-A backward compatible version can be found in the include
-file
-.In varargs.h .
.Sh BUGS
Unlike the
.Em varargs
OpenPOWER on IntegriCloud