Provided by: nscd_2.27-3ubuntu1.6_amd64 bug

NAME

       nscd.conf - configuration file for Name Service Caching Daemon

DESCRIPTION

       /etc/nscd.conf configures the caches used by nscd(8) as well as some generic options.  nscd(8) is able to
       use a configuration file at a different location, when supplied with the -f or --config-file command line
       option.

       The  configuration  file  consists of a set of lines.  Empty lines, and text after a '#' is ignored.  All
       remaining lines denote the setting of an option.  White space  before  and  after  options,  and  between
       options and option arguments is ignored.

       There  are  two  kinds  of  options:  General  options influence nscd(8)'s general behaviour, while cache
       related options only affect the specified cache. Options are set like this:

         general_option option
         cache_option cache_name option

GENERAL OPTIONS

       logfile file
              Specifies the name of the debug log-file that nscd(8) should use if debug-level is higher than  0.
              If this option is not set, nscd(8) will write its debug output to stderr.

       debug-level level
              If  level  is higher than 0, nscd(8) will create some debug output. The higher the level, the more
              verbose the output.

       threads #threads
              This option sets the number of threads that nscd(8) should use by default. It can be overridden by
              calling  nscd(8)  with the -t or --nthreads argument. If neither this configuration option nor the
              command line argument is given, nscd(8) uses 5 threads by default. The minimum is 3. More  threads
              means more simultaneous connections that nscd(8) can handle.

       max-threads #threads
              Specifies the maximum number of threads to be started.

       server-user user
              By  default,  nscd(8)  is  run  as user root. This option can be set to force nscd(8) to drop root
              privileges after startup. It cannot be used when  nscd(8)  is  called  with  the  -S  or  --secure
              argument.  Also  note  that  some  services require that nscd run as root, so using this may break
              those lookup services.

       stat-user user
              Specifies the user who is allowed to request statistics.

       paranoia bool
              bool must be one of  yes  or  no.   Enabling  paranoia  mode  causes  nscd(8)  to  restart  itself
              periodically.

       restart-interval time
              Sets  the  restart  interval  to  time seconds if periodic restart is enabled by enabling paranoia
              mode. The default value is 3600.

CACHE OPTIONS

       All cache options take two arguments. The first one denotes  the  service  or  cache  the  option  should
       affect. Currently service can be one of passwd, group, or hosts.

       enable-cache service bool
              bool  must  be one of yes or no.  Each cache is disabled by default and must be enabled explicitly
              by setting this options to yes.

       positive-time-to-live service secs
              This is the number of seconds after which a cached entry is removed from the cache. This  defaults
              to 3600 seconds (i. e.  one hour).

       negative-time-to-live service secs
              If  an  entry  is  not  found  by  the  Name  Service, it is added to the cache and marked as "not
              existent". This option sets the number of seconds after which such a not existent entry is removed
              from the cache. This defaults to 20 seconds for the password and host caches and to 60 seconds for
              the group cache.

       suggested-size service prime-number
              This option sets the size of the hash that is used to store the cache entries. As this is a  hash,
              it  should  be  reasonably larger than the maximum number of entries that is expected to be cached
              simultaneously and should be a prime number. It defaults to a size of 211 entries.

       check-files service bool
              bool must be one of yes (default) or no.  If file checking is enabled, nscd(8) periodically checks
              the  modification  time of /etc/passwd, /etc/group, or /etc/hosts (for the passwd, group, and host
              cache respectively) and invalidates the cache if the file has changed since the last check.

       persistent service bool
              bool must be one of yes (default) or no.  Keep the content of the cache for service  over  nscd(8)
              restarts. Useful when paranoia mode is set.

       shared service bool
              bool  must be one of yes (default) or no.  The memory mapping of the nscd(8) databases for service
              is shared with the clients so that they can directly search in them instead of having to  ask  the
              daemon over the socket each time a lookup is performed.

       reload-count #number
              Sets  the  number  of  times  a cached record is reloaded before it is pruned from the cache. Each
              cache record has a timeout, when that timeout expires, nscd(8) will either reload  it  (query  the
              NSS service again if the data hasn't changed), or drop it.

       max-db-size service number-of-bytes
              Sets the maximum allowable size for the service.

       auto-propagate service bool
              When  set  to  no  for  passwd  or  group  service,  then  the  .byname  requests are not added to
              passwd.byuid or group.bygid cache. This may help for tables containing multiple  records  for  the
              same id.

EXAMPLE

       # This is a comment.

           logfile                 /var/log/nscd.log
           threads                 6
           server-user             nobody
           debug-level             0

           enable-cache            passwd          yes
           positive-time-to-live   passwd          600
           negative-time-to-live   passwd          20
           suggested-size          passwd          211
           check-files             passwd          yes

           enable-cache            group           yes
           positive-time-to-live   group           3600
           negative-time-to-live   group           60
           suggested-size          group           211
           check-files             group           yes

           enable-cache            hosts           yes
           positive-time-to-live   hosts           3600
           negative-time-to-live   hosts           20
           suggested-size          hosts           211
           check-files             hosts           yes

SEE ALSO

       nscd(8), nsswitch.conf(5)