summaryrefslogtreecommitdiffstats
path: root/lib
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
parentb5e718b1432fba45f848c4e5a660f18e4780fea5 (diff)
downloadFreeBSD-src-8bc4d4bba797a5e4f4a8e7a2f9593c56f5314b02.zip
FreeBSD-src-8bc4d4bba797a5e4f4a8e7a2f9593c56f5314b02.tar.gz
mdoc(7) fixes.
Approved by: re (blanket)
Diffstat (limited to 'lib')
-rw-r--r--lib/libc/posix1e/mac.conf.511
-rw-r--r--lib/libc_r/man/pthread_getconcurrency.346
-rw-r--r--lib/libpam/modules/pam_chroot/pam_chroot.88
-rw-r--r--lib/libpthread/man/pthread_attr_get_np.33
4 files changed, 38 insertions, 30 deletions
diff --git a/lib/libc/posix1e/mac.conf.5 b/lib/libc/posix1e/mac.conf.5
index c382345..4fa58ae 100644
--- a/lib/libc/posix1e/mac.conf.5
+++ b/lib/libc/posix1e/mac.conf.5
@@ -34,16 +34,15 @@
.Os
.Sh NAME
.Nm mac.conf
-.Nd Format of the MAC library configuration file
+.Nd format of the MAC library configuration file
.Sh DESCRIPTION
The
.Nm
file configures the default label elements to be used by policy-agnostic
applications that operate on MAC labels.
-.Nm
-contains a series of default label sets specified by object class,
+A file contains a series of default label sets specified by object class,
in addition to blank lines and comments preceded by a
-.Dv #
+.Ql #
symbol.
.Pp
Each declaration consists of a single line with two fields separated
@@ -53,7 +52,7 @@ as used by the
library calls prior to an application invocation of a function from
.Xr mac_get 3 .
Label element names may optionally begin with a
-.Dv ?
+.Ql \&?
symbol to indicate that a failure to retrieve the label element for
an object should be silently ignored, and improves usability if the
set of MAC policies may change over time.
@@ -86,9 +85,9 @@ label due to the respective policy not being present will be ignored.
MAC library configuration file.
.El
.Sh SEE ALSO
+.Xr mac 3 ,
.Xr mac_get 3 ,
.Xr mac_prepare 3 ,
-.Xr mac 3 ,
.Xr mac 4 ,
.Xr mac 9
.Sh HISTORY
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 .
diff --git a/lib/libpam/modules/pam_chroot/pam_chroot.8 b/lib/libpam/modules/pam_chroot/pam_chroot.8
index f76dc4b..e55c908 100644
--- a/lib/libpam/modules/pam_chroot/pam_chroot.8
+++ b/lib/libpam/modules/pam_chroot/pam_chroot.8
@@ -3,7 +3,7 @@
.\"
.\" Portions of this software were developed for the FreeBSD Project by
.\" ThinkSec AS and NAI Labs, the Security Research Division of Network
-.\" Associates, Inc. under DARPA/SPAWAR contract N66001-01-C-8035
+.\" Associates, Inc. under DARPA/SPAWAR contract N66001-01-C-8035
.\" ("CBOSS"), as part of the DARPA CHATS research program.
.\"
.\" Redistribution and use in source and binary forms, with or without
@@ -48,11 +48,11 @@
The chroot service module for PAM chroots users into either a
predetermined directory or one derived from their home directory.
If a user's home directory as specified in the
-.Dv passwd
+.Vt passwd
structure returned by
.Xr getpwnam 3
contains the string
-.Dq /./ ,
+.Dq Li /./ ,
the portion of the directory name to the left of that string is used
as the chroot directory, and the portion to the right will be the
current working directory inside the chroot tree.
@@ -63,7 +63,7 @@ and
options (see below) are used.
.Bl -tag -width ".Cm also_root"
.It Cm also_root
-Do not hold user id 0 exempt from the chroot requirement.
+Do not hold user ID 0 exempt from the chroot requirement.
.It Cm always
Report a failure if a chroot directory could not be derived from the
user's home directory, and the
diff --git a/lib/libpthread/man/pthread_attr_get_np.3 b/lib/libpthread/man/pthread_attr_get_np.3
index bf856d4..82e1065 100644
--- a/lib/libpthread/man/pthread_attr_get_np.3
+++ b/lib/libpthread/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.
OpenPOWER on IntegriCloud