Skip site navigation (1)Skip section navigation (2)

FreeBSD Man Pages

Man Page or Keyword Search:
Man Architecture
Apropos Keyword Search (all sections) Output format
home | help
NSCD.CONF(5)              FreeBSD File Formats Manual             NSCD.CONF(5)

     nscd.conf - nscd configuration file

     The nscd.conf file is used by the nscd(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.

     Each line specifies either an attribute and a value, or an attribute, a
     cachename and a value.  Usual cachenames are ``passwd'', ``group'',
     ``hosts'', ``services'', ``protocols'' and ``rpc''.  You can also use any
     other cachename (for example, if some third-party application uses

     threads [value]
             Number of threads, which would listen for connections and process
             requests.  The minimum is 1.  The default value is 8.

     enable-cache [cachename] [yes | no]
             Enables or disables the cache for specified cachename.

     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.

     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), and lfu (least-frequently-used).  The default policy is

     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.

     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

     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
             (5-10 times) greater than the default hash table size (257).

     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.

     perform-actual-lookups [cachename] [yes | no]
             If enabled, the nscd(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 nscd(8) will act similarly to the NSCD.

             NOTE: this feature is currently experimental -- it supports only
             ``passwd'', ``group'' and ``services'' cachenames.

     You can use the `#' symbol at the beginning of the line for comments.



     Michael Bushkov <>

     Please send bug reports and suggestions to <>.

FreeBSD 11.0-PRERELEASE         April 30, 2006         FreeBSD 11.0-PRERELEASE


Want to link to this manual page? Use this URL:

home | help