summaryrefslogtreecommitdiffstats
diff options
context:
space:
mode:
authortrhodes <trhodes@FreeBSD.org>2006-04-29 01:34:03 +0000
committertrhodes <trhodes@FreeBSD.org>2006-04-29 01:34:03 +0000
commite56faa8cbea137c2c640b953d9642b6a3a32d9e5 (patch)
treef073d1202c946359fd4ca6aa60b3bcf656e0254c
parenta3815ff8a15faced65f56516cfe1e548a81cf365 (diff)
downloadFreeBSD-src-e56faa8cbea137c2c640b953d9642b6a3a32d9e5.zip
FreeBSD-src-e56faa8cbea137c2c640b953d9642b6a3a32d9e5.tar.gz
Follow FreeBSD mdoc(7) conventions:
- Remove hard sentence breaks; - Avoid using double negatives or "sexist" language; - Expand contractions; - Remove a blank line; - Some grammar changes. Usually we do not "hard code" requests to submit bugs to the author, but I will leave this go for now.
-rw-r--r--usr.sbin/cached/cached.878
-rw-r--r--usr.sbin/nscd/nscd.878
2 files changed, 86 insertions, 70 deletions
diff --git a/usr.sbin/cached/cached.8 b/usr.sbin/cached/cached.8
index 5a8693a..64ea5d8 100644
--- a/usr.sbin/cached/cached.8
+++ b/usr.sbin/cached/cached.8
@@ -24,13 +24,12 @@
.\"
.\" $FreeBSD$
.\"
-
.Dd October 20, 2005
.Dt CACHED 8
.Os
.Sh NAME
.Nm cached
-.Nd caching server daemon
+.Nd "caching server daemon"
.Sh SYNOPSIS
.Nm
.Op Fl nst
@@ -38,53 +37,58 @@
.Op Fl I Ar cachename
.Sh DESCRIPTION
.Nm
-- is the system caching daemon.
+is the system caching daemon.
It can cache almost all types of data and is basically intended to be used
-with
+with the
.Pa nsswitch
subsystem.
-The cache is actually per-user. It means that each user can work only with the
-cached data, that were cached by him and can't poison the cache of other users.
+The cache is actually per-user.
+This means that each user can work only with the
+cached data that was cached locally and cannot poison the cache of other users.
+The
.Nm
-supports 2 types of caching:
+utility supports two types of caching:
.Bl -tag -width Pair
.It Sy Type
.Sy Description
.It Common caching
Each cached element is the the key+value pair.
-This type of caching supports policies, which are applied, when maximum
+This type of caching supports policies which are applied when maximum
number of cached elements is exceeded.
-3 policies are available:
+Three policies are available:
.Pa FIFO
(first in - first out),
.Pa LRU
(least recently used) and
.Pa LFU
(least frequently used).
-This type of caching is used with
+This type of caching is used with the
.Fn getXXXbyname
-- like functions.
+family of functions.
.It Multipart caching
Each cached element is the part of the elements sequence.
-This type of caching is intended to be used with
+This type of caching is intended to be used with the
.Fn getXXXent
-- like functions.
+family of functions.
.El
.Pp
+The
.Nm
-is able not only to cache elements, but to perform the actual nsswitch
-lookups by itself. To enable this feature use
+utility is able not only to cache elements, but to perform the actual nsswitch
+lookups by itself.
+To enable this feature use the
.Pa perform-actual-lookups
parameter in the
.Xr cached.conf 5
.Pp
+The
.Nm
-recognizes the following runtime options:
+utility recognizes the following runtime options:
.Bl -tag -width indent
.It Fl n
Do not daemonize.
.Nm
-doesn't fork and doesn't disconnect itself from the terminal.
+will not fork or disconnect itself from the terminal.
.It Fl s
Single-threaded mode.
Forces using only one thread for all processing purposes (it overrides
@@ -95,44 +99,49 @@ parameter in the
file).
.It Fl t
Trace mode.
-All trace messages would be written to the stdout.
+All trace messages will be written to stdout.
This mode is usually used with
.Fl n
and
.Fl s
-flags for debugging purposes.
+flags are used for debugging purposes.
.It Fl i Ar cachename
-Invalidates personal cache. When specified,
+Invalidates personal cache.
+When specified,
.Nm
-acts as the administration tool. It asks the already
-running
+acts as the administration tool.
+It asks the already running
.Nm
to invalidate the specified part of the cache of the
-calling user. For example, you may want sometimes
-to invalidate your
+calling user.
+For example, sometimes you may want to invalidate your
.Pa hosts
-cache. You can specify
+cache.
+You can specify
.Pa all
as the
.Pa cachename
-to invalidate your personal cache as a whole. You
-can't use this option for the cachename, for which
+to invalidate your personal cache as a whole.
+You cannot use this option for the cachename, for which
the
.Pa perform-actual-lookups
option is enabled.
.It Fl I Ar cachename
-Invalidates the cache for every user. When specified,
+Invalidates the cache for every user.
+When specified,
.Nm
-acts as the administration tool. It asks the already
+acts as the administration tool.
+It asks the already
running
.Nm
to invalidate the specified part of the cache for
-every user. You can specify
+every user.
+You can specify
.Pa all
as the
.Pa cachename
-to invalidate the whole cache. Only root can use this
-option.
+to invalidate the whole cache.
+Only the root can use this option.
.El
.Sh FILES
.Xr cached.conf 5
@@ -141,8 +150,7 @@ option.
.Xr nsswitch.conf 5
.Xr nsdispatch 3
.Sh "AUTHORS"
-Michael Bushkov
-.Aq bushman@rsu.ru
+.An Michael Bushkov Aq bushman@rsu.ru
.Sh "BUGS"
-To report bugs or suggestions please mail me
+To report bugs or suggestions please mail me:
.Aq bushman@rsu.ru
diff --git a/usr.sbin/nscd/nscd.8 b/usr.sbin/nscd/nscd.8
index 5a8693a..64ea5d8 100644
--- a/usr.sbin/nscd/nscd.8
+++ b/usr.sbin/nscd/nscd.8
@@ -24,13 +24,12 @@
.\"
.\" $FreeBSD$
.\"
-
.Dd October 20, 2005
.Dt CACHED 8
.Os
.Sh NAME
.Nm cached
-.Nd caching server daemon
+.Nd "caching server daemon"
.Sh SYNOPSIS
.Nm
.Op Fl nst
@@ -38,53 +37,58 @@
.Op Fl I Ar cachename
.Sh DESCRIPTION
.Nm
-- is the system caching daemon.
+is the system caching daemon.
It can cache almost all types of data and is basically intended to be used
-with
+with the
.Pa nsswitch
subsystem.
-The cache is actually per-user. It means that each user can work only with the
-cached data, that were cached by him and can't poison the cache of other users.
+The cache is actually per-user.
+This means that each user can work only with the
+cached data that was cached locally and cannot poison the cache of other users.
+The
.Nm
-supports 2 types of caching:
+utility supports two types of caching:
.Bl -tag -width Pair
.It Sy Type
.Sy Description
.It Common caching
Each cached element is the the key+value pair.
-This type of caching supports policies, which are applied, when maximum
+This type of caching supports policies which are applied when maximum
number of cached elements is exceeded.
-3 policies are available:
+Three policies are available:
.Pa FIFO
(first in - first out),
.Pa LRU
(least recently used) and
.Pa LFU
(least frequently used).
-This type of caching is used with
+This type of caching is used with the
.Fn getXXXbyname
-- like functions.
+family of functions.
.It Multipart caching
Each cached element is the part of the elements sequence.
-This type of caching is intended to be used with
+This type of caching is intended to be used with the
.Fn getXXXent
-- like functions.
+family of functions.
.El
.Pp
+The
.Nm
-is able not only to cache elements, but to perform the actual nsswitch
-lookups by itself. To enable this feature use
+utility is able not only to cache elements, but to perform the actual nsswitch
+lookups by itself.
+To enable this feature use the
.Pa perform-actual-lookups
parameter in the
.Xr cached.conf 5
.Pp
+The
.Nm
-recognizes the following runtime options:
+utility recognizes the following runtime options:
.Bl -tag -width indent
.It Fl n
Do not daemonize.
.Nm
-doesn't fork and doesn't disconnect itself from the terminal.
+will not fork or disconnect itself from the terminal.
.It Fl s
Single-threaded mode.
Forces using only one thread for all processing purposes (it overrides
@@ -95,44 +99,49 @@ parameter in the
file).
.It Fl t
Trace mode.
-All trace messages would be written to the stdout.
+All trace messages will be written to stdout.
This mode is usually used with
.Fl n
and
.Fl s
-flags for debugging purposes.
+flags are used for debugging purposes.
.It Fl i Ar cachename
-Invalidates personal cache. When specified,
+Invalidates personal cache.
+When specified,
.Nm
-acts as the administration tool. It asks the already
-running
+acts as the administration tool.
+It asks the already running
.Nm
to invalidate the specified part of the cache of the
-calling user. For example, you may want sometimes
-to invalidate your
+calling user.
+For example, sometimes you may want to invalidate your
.Pa hosts
-cache. You can specify
+cache.
+You can specify
.Pa all
as the
.Pa cachename
-to invalidate your personal cache as a whole. You
-can't use this option for the cachename, for which
+to invalidate your personal cache as a whole.
+You cannot use this option for the cachename, for which
the
.Pa perform-actual-lookups
option is enabled.
.It Fl I Ar cachename
-Invalidates the cache for every user. When specified,
+Invalidates the cache for every user.
+When specified,
.Nm
-acts as the administration tool. It asks the already
+acts as the administration tool.
+It asks the already
running
.Nm
to invalidate the specified part of the cache for
-every user. You can specify
+every user.
+You can specify
.Pa all
as the
.Pa cachename
-to invalidate the whole cache. Only root can use this
-option.
+to invalidate the whole cache.
+Only the root can use this option.
.El
.Sh FILES
.Xr cached.conf 5
@@ -141,8 +150,7 @@ option.
.Xr nsswitch.conf 5
.Xr nsdispatch 3
.Sh "AUTHORS"
-Michael Bushkov
-.Aq bushman@rsu.ru
+.An Michael Bushkov Aq bushman@rsu.ru
.Sh "BUGS"
-To report bugs or suggestions please mail me
+To report bugs or suggestions please mail me:
.Aq bushman@rsu.ru
OpenPOWER on IntegriCloud