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'', ``groups'',
     ``hosts'',	``services'', ``protocols'' and	``rpc''.  You can also use any
     other cachename (for example, if some third-party application uses	nss-

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

     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'', ``groups'' 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	10.1			April 30, 2006			  FreeBSD 10.1


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

home | help