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

FreeBSD Manual Pages

  
 
  

home | help
NSCD.CONF(5)		      File Formats Manual		  NSCD.CONF(5)

NAME
       nscd.conf -- nscd configuration file

DESCRIPTION
       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 nsswitch).

       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.	Possi-
	       ble  policies  are:  fifo  (first-in-first-out),	lru (least-re-
	       cently-used), and  lfu  (least-frequently-used).	  The  default
	       policy is lru.

       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 fifo.

       negative-confidence-threshold [cachename] [value]
	       The number of times a query must	have failed before  the	 cache
	       accepts	that  the  element  can	 not be	found.	At the default
	       value of	1 each negative	query result is	cached and immediately
	       returned	from the cache on  further  queries.   Higher  numbers
	       cause  queries to be retried at the configured data sources the
	       given number of times, before the negative result  is  returned
	       from  the  cache	 on further queries.  This allows to probe for
	       the existence of	an entry, and then to create it	if it did  not
	       exist,  without	the negative probe result preventing access to
	       the new entry for the duration of the negative TTL.

       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.

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

FILES
       /etc/nscd.conf

SEE ALSO
       nscd(8)

AUTHORS
       Michael Bushkov <bushman@FreeBSD.org>

FreeBSD	13.2			October	6, 2018			  NSCD.CONF(5)

NAME | DESCRIPTION | NOTES | FILES | SEE ALSO | AUTHORS

Want to link to this manual page? Use this URL:
<https://man.freebsd.org/cgi/man.cgi?query=nscd.conf&sektion=5&manpath=FreeBSD+14.0-RELEASE+and+Ports>

home | help