unixdev.net


Switch to SpeakEasy.net DSL

The Modular Manual Browser

Home Page
Manual: (SunOS-5.10)
Page:
Section:
Apropos / Subsearch:
optional field

nscd.conf(4)                     File Formats                     nscd.conf(4)



NAME
       nscd.conf - name service cache daemon configuration

SYNOPSIS
       /etc/nscd.conf

DESCRIPTION
       The    nscd.conf   file  contains  the  configuration  information  for
       nscd(1M). Each line specifies either an  attribute and a  value, or  an
       attribute,  cachename,  and  a   value.  Fields are separated either by
       <&lt;SPACE>&gt; or <&lt;TAB>&gt; characters.  A  `#' (number sign) indicates the begin-
       ning  of a comment; characters up to the end of the line are not inter-
       preted by  nscd.

       cachename is represented by  hosts, ipnodes, passwd, group,  exec_attr,
       prof_attr, or user_attr.

       attribute supports the following:

       logfile debug-file-name                 Specifies  name  of the file to
                                               which  debug  info  should   be
                                               written.    Use   /dev/tty  for
                                               standard output.



       debug-level value                       Sets the debug  level  desired.
                                               value  may  range  from  0 (the
                                               default) to  10.  Use  of  this
                                               option  causes  nscd(1M) to run
                                               in  the  foreground   and   not
                                               become a daemon.  Note that the
                                               output of the debugging command
                                               is  not  likely  to  remain the
                                               same  from  release-to-release;
                                               scripts should  not rely on its
                                               format.



       enable-cache cachename value            Enables or disables the  speci-
                                               fied   cache.    value  may  be
                                               either yes or no.



       positive-time-to-live cachename value   Sets the time-to-live for posi-
                                               tive     entries    (successful
                                               queries)   in   the   specified
                                               cache.    value  is  in integer
                                               seconds.      Larger     values
                                               increase  cache  hit  rates and
                                               reduce mean response times, but
                                               increase  problems  with  cache
                                               coherence.   Note  that   sites
                                               that  push  (update)  NIS  maps
                                               nightly can set the value to be
                                               the  equivalent  of 12 hours or
                                               more with very good performance
                                               implications.



       negative-time-to-live cachename value   Sets the time-to-live for nega-
                                               tive   entries    (unsuccessful
                                               queries)   in   the   specified
                                               cache.   value  is  in  integer
                                               seconds. Can result in signifi-
                                               cant  performance  improvements
                                               if   there  are  several  files
                                               owned by uids (user IDs) not in
                                               system   databases;  should  be
                                               kept  small  to  reduce   cache
                                               coherency problems.



       suggested-size cachename value          Sets  the  suggested  number of
                                               hash buckets in  the  specified
                                               cache. This parameter should be
                                               changed only if the  number  of
                                               entries  in  the  cache exceeds
                                               the suggested size by more than
                                               a   factor  of  four  or  five.
                                               Since this is the internal hash
                                               table   size,    value   should
                                               remain a prime number for opti-
                                               mum efficiency.



       keep-hot-count cachename value          This   attribute   allows   the
                                               administrator to set the number
                                               of  entries nscd(1M) is to keep
                                               current in the specified cache.
                                               value   is  an  integer  number
                                               which  should  approximate  the
                                               number  of  entries  frequently
                                               used during the day.



       check-files cachename value             Enables  or  disables  checking
                                               the file belonging to the spec-
                                               ified  cachename  for  changes.
                                               If   enabled   (which   is  the
                                               default), changes in the corre-
                                               sponding  file  cause the cache
                                               to  be  invalidated  within  10
                                               seconds.  Can  be  disabled  if
                                               files are never modified for  a
                                               slight  performance boost, par-
                                               ticularly over NFS.  value  may
                                               be either yes or no.



SEE ALSO
       nscd(1M), group(4), hosts(4), ipnodes(4), passwd(4)



SunOS 5.10                        13 May 2004                     nscd.conf(4)