Provided by: nscd_2.15-0ubuntu10_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)