summaryrefslogtreecommitdiffstats
path: root/lib/libc_r
diff options
context:
space:
mode:
authorru <ru@FreeBSD.org>2003-05-24 19:53:08 +0000
committerru <ru@FreeBSD.org>2003-05-24 19:53:08 +0000
commit8bc4d4bba797a5e4f4a8e7a2f9593c56f5314b02 (patch)
tree43ba2b4be0e9dd899512258a0bca1c34d504cf69 /lib/libc_r
parentb5e718b1432fba45f848c4e5a660f18e4780fea5 (diff)
downloadFreeBSD-src-8bc4d4bba797a5e4f4a8e7a2f9593c56f5314b02.zip
FreeBSD-src-8bc4d4bba797a5e4f4a8e7a2f9593c56f5314b02.tar.gz
mdoc(7) fixes.
Approved by: re (blanket)
Diffstat (limited to 'lib/libc_r')
-rw-r--r--lib/libc_r/man/pthread_getconcurrency.346
1 files changed, 27 insertions, 19 deletions
diff --git a/lib/libc_r/man/pthread_getconcurrency.3 b/lib/libc_r/man/pthread_getconcurrency.3
index e744378..d71599a 100644
--- a/lib/libc_r/man/pthread_getconcurrency.3
+++ b/lib/libc_r/man/pthread_getconcurrency.3
@@ -27,7 +27,7 @@
.Dt PTHREAD_GETCONCURRENCY 3
.Os
.Sh NAME
-.Nm pthread_getconcurrency,
+.Nm pthread_getconcurrency ,
.Nm pthread_setconcurrency
.Nd get or set level of concurrency
.Sh LIBRARY
@@ -35,7 +35,7 @@
.Sh SYNOPSIS
.In pthread.h
.Ft int
-.Fn pthread_getconcurrency "void"
+.Fn pthread_getconcurrency void
.Ft int
.Fn pthread_setconcurrency "int new_level"
.Sh DESCRIPTION
@@ -43,29 +43,37 @@ The
.Fn pthread_getconcurrency
function allows an application to inform the threads implementation
of its desired concurrency level,
-.Va new_level .
+.Fa new_level .
The actual level of concurrency provided by the implementation
-as a result of this function call is unspecified. If new_level is
-zero, it causes the implementation to maintain the concurrency
+as a result of this function call is unspecified.
+If
+.Fa new_level
+is zero, it causes the implementation to maintain the concurrency
level at its discretion as if
.Fn pthread_setconcurrency
-was never called. The
+was never called.
+The
.Fn pthread_getconcurrency
function returns the value set by a previous call to the
.Fn pthread_setconcurrency
-function. If the
+function.
+If the
.Fn pthread_setconcurrency
function was not previously called, this function returns zero to
indicate that the implementation is maintaining the concurrency
-level. When an application calls
-.Fn pthread_setconcurrency
+level.
+When an application calls
+.Fn pthread_setconcurrency ,
it is informing the implementation of its desired concurrency
-level. The implementation uses this as a hint, not a requirement.
+level.
+The implementation uses this as a hint, not a requirement.
.Sh RETURN VALUES
If successful, the
.Fn pthread_setconcurrency
-function returns zero. Otherwise, an error number is returned
-to indicate the error. The
+function returns zero.
+Otherwise, an error number is returned
+to indicate the error.
+The
.Fn pthread_getconcurrency
function always returns the concurrency level set by a previous
call to
@@ -82,21 +90,21 @@ function will fail if:
.Bl -tag -width Er
.It Bq Er EINVAL
The value specified by
-.Va new_level
+.Fa new_level
is negative.
.It Bq Er EAGAIN
-The value specific by
-.Va new_level
+The value specified by
+.Fa new_level
would cause a system resource to be exceeded.
.El
.Sh APPLICATION USAGE
Use of these functions changes the state of the underlying
-concurrency upon which the application depends. Library
-developers are advised to not use the
+concurrency upon which the application depends.
+Library developers are advised to not use the
.Fn pthread_getconcurrency
and
.Fn pthread_setconcurrency
-functions since their use may conflict with an applications
+functions since their use may conflict with an application's
use of these functions.
.Sh STANDARDS
The
@@ -104,4 +112,4 @@ The
and
.Fn pthread_setconcurrency
functions conform to
-.St -susv2
+.St -susv2 .
OpenPOWER on IntegriCloud