110 lines
4.4 KiB
Groff
110 lines
4.4 KiB
Groff
.\" Copyright (c) 2005 Michael Bushkov <bushman@rsu.ru>
|
|
.\" All rights reserved.
|
|
.\"
|
|
.\" Redistribution and use in source and binary forms, with or without
|
|
.\" modification, are permitted provided that the following conditions
|
|
.\" are met:
|
|
.\" 1. Redistributions of source code must retain the above copyright
|
|
.\" notice, this list of conditions and the following disclaimer.
|
|
.\" 2. Redistributions in binary form must reproduce the above copyright
|
|
.\" notice, this list of conditions and the following disclaimer in the
|
|
.\" documentation and/or other materials provided with the distribution.
|
|
.\"
|
|
.\" THIS SOFTWARE IS PROVIDED BY THE AUTHOR AND CONTRIBUTORS ``AS IS'' AND
|
|
.\" ANY EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT LIMITED TO, THE
|
|
.\" IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE
|
|
.\" ARE DISCLAIMED. IN NO EVENT SHALL THE AUTHOR OR CONTRIBUTORS BE LIABLE
|
|
.\" FOR ANY DIRECT, INDIRECT, INCIDENTAL, SPECIAL, EXEMPLARY, OR CONSEQUENTIAL
|
|
.\" DAMAGES (INCLUDING, BUT NOT LIMITED TO, PROCUREMENT OF SUBSTITUTE GOODS
|
|
.\" OR SERVICES; LOSS OF USE, DATA, OR PROFITS; OR BUSINESS INTERRUPTION)
|
|
.\" HOWEVER CAUSED AND ON ANY THEORY OF LIABILITY, WHETHER IN CONTRACT, STRICT
|
|
.\" LIABILITY, OR TORT (INCLUDING NEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY
|
|
.\" OUT OF THE USE OF THIS SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF
|
|
.\" SUCH DAMAGE.
|
|
.\"
|
|
.\" $FreeBSD$
|
|
.\"
|
|
.Dd April 30, 2006
|
|
.Dt CACHED.CONF 5
|
|
.Os
|
|
.Sh NAME
|
|
.Nm cached.conf
|
|
.Nd "caching daemon configuration file manual page"
|
|
.Sh "DESCRIPTION"
|
|
.Nm
|
|
is used by the
|
|
.Xr cached 8
|
|
daemon and is read on its startup.
|
|
Its syntax is mostly similar to the nscd.conf syntax in Linux and Solaris.
|
|
It has some differences, though - see them below.
|
|
.Pp
|
|
Each line specifies either an attribute and a value, or an attribute,
|
|
a cachename and a value.
|
|
Usual cachenames are passwd, groups, hosts, services, protocols and rpc.
|
|
You can also use any other cachename (for example, if some third-party
|
|
application uses nsswitch).
|
|
.Pp
|
|
.Bl -tag -width Pair
|
|
.It Sy threads [value]
|
|
Number of threads, which would listen for connections and process requests.
|
|
The minimum is 1.
|
|
The default value is 8.
|
|
.It Sy enable-cache [cachename] [yes|no]
|
|
Enables or disables the cache for specified cachename.
|
|
.It Sy positive-time-to-live [cachename] [value]
|
|
Sets the TTL (time-to-live) for the specified cache in seconds.
|
|
Larger values can increase system's performance, but they also can affect
|
|
the cache coherence.
|
|
The default value is 3600.
|
|
.It Sy positive-policy [cachename] [fifo|lru|lfu]
|
|
The policy that is applied to erase some of the cache elements, when the
|
|
size limit of the given cachename is exceeded.
|
|
Possible policies are: fifo (first-in-first-out), lru (least-recently-used),
|
|
lfu (least-frequently-used).
|
|
The default policy is lru.
|
|
.It Sy negative-time-to-live [cachename] [value]
|
|
The TTL of the negative cached elements in seconds.
|
|
The larger values can significantly increase system performance in some
|
|
environments (when dealing with files with UIDs, which are not in system
|
|
databases, for example).
|
|
This number should be kept low to avoid the cache coherence problems.
|
|
The default value is 60.
|
|
.It Sy negative-policy [cachename] [fifo|lru|lfu]
|
|
The same as the positive-policy, but this one is applied to the negative
|
|
elements of the given cachename.
|
|
The default policy is fifo.
|
|
.It Sy suggested-size [cachename] [value]
|
|
This is the internal hash table size.
|
|
The value should be a prime number for optimum performance.
|
|
You should only change this value when the number of cached elements is
|
|
significantly (in 5-10 times) greater then the default hash table size (255).
|
|
.It Sy keep-hot-count [cachename] [value]
|
|
The size limit of the cache with the given cachename.
|
|
When it is exceeded, the policy will be applied.
|
|
The default value is 2048.
|
|
.It Sy perform-actual-lookups [cachename] [yes|no]
|
|
If enabled, the
|
|
.Xr cached 8
|
|
does not simply receive and cache the NSS-requests results, but performs
|
|
all the lookups by itself and only returns the responses.
|
|
If this feature is enabled, then for the given cachename
|
|
.Xr cached 8
|
|
will act similarly to the NSCD.
|
|
.Pp
|
|
.Pa NOTE:
|
|
this feature is currently experimental - it supports only passwd, groups and
|
|
services cachenames.
|
|
.El
|
|
.Sh "NOTES"
|
|
You can use
|
|
.Sq #
|
|
symbol at the beginning of the line for comments.
|
|
.Sh "SEE ALSO"
|
|
.Xr cached 8
|
|
.Sh "AUTHORS"
|
|
Michael Bushkov
|
|
.Aq bushman@rsu.ru
|
|
.Sh "BUGS"
|
|
To report bugs or suggestions please mail me
|
|
.Aq bushman@rsu.ru
|