1NSCD.CONF(5)               Linux Programmer's Manual              NSCD.CONF(5)
2
3
4

NAME

6       /etc/nscd.conf - name service cache daemon configuration file
7

DESCRIPTION

9       The  file  /etc/nscd.conf  is  read from nscd(8) at startup.  Each line
10       specifies either an attribute and a value, or  an  attribute,  service,
11       and  a  value.  Fields are separated either by SPACE or TAB characters.
12       A '#' (number sign) indicates the beginning  of  a  comment;  following
13       characters, up to the end of the line, are not interpreted by nscd.
14
15       Valid services are passwd, group, or hosts.
16
17       logfile debug-file-name
18              Specifies  name  of the file to which debug info should be writ‐
19              ten.
20
21       debug-level value
22              Sets the desired debug level.
23
24       threads number
25              This is the number of threads  that  are  started  to  wait  for
26              requests.  At least five threads will always be created.
27
28       server-user user
29              If  this  option  is  set, nscd will run as this user and not as
30              root.  If a separate cache for every user is  used  (-S  parame‐
31              ter), this option is ignored.
32
33       enable-cache service <yes|no>
34              Enables or disables the specified service cache.
35
36       positive-time-to-live service value
37              Sets  the  TTL  (time-to-live)  for positive entries (successful
38              queries) in the specified cache for service.  Value is  in  sec‐
39              onds.   Larger  values  increase cache hit rates and reduce mean
40              response times, but increase problems with cache coherence.
41
42       negative-time-to-live service value
43              Sets the TTL (time-to-live) for negative  entries  (unsuccessful
44              queries)  in  the specified cache for service.  Value is in sec‐
45              onds.  Can result in  significant  performance  improvements  if
46              there  are  several files owned by UIDs (user IDs) not in system
47              databases (for example untarring the  linux  kernel  sources  as
48              root); should be kept small to reduce cache coherency problems.
49
50       suggested-size service value
51              This  is  the  internal  hash  table size, value should remain a
52              prime number for optimum efficiency.
53
54       check-files service <yes|no>
55              Enables or disables checking the file belonging to the specified
56              service for changes.  The files are /etc/passwd, /etc/group, and
57              /etc/hosts.
58
59       max-threads threads
60              Specifies the maximum number of threads to be started.
61
62       stat-user username
63              Specifies the user who is allowed to request statistics.
64
65       reload-count unlimited | number
66              Limit on the number of times a cached entry gets reloaded  with‐
67              out being used before it gets removed.  The default is 5.
68
69       paranoia <yes|no>
70              Enabling  paranoia  mode  causes nscd to restart itself periodi‐
71              cally.
72
73       restart-interval time
74              Sets the restart interval to time seconds if periodic restart is
75              enabled by enabling paranoia mode.
76
77       persistent service <yes|no>
78              Keep  the content of the cache for service over server restarts;
79              useful when paranoia mode is set.
80
81       shared service <yes|no>
82              The memory mapping of the nscd databases for service  is  shared
83              with  the  clients  so  that  they  can  directly search in them
84              instead of having to ask the daemon over the socket each time  a
85              lookup is performed.
86
87       max-db-size service number-of-bytes
88              The maximum allowable size for the service.
89
90       auto-propagate service <yes|no>
91              When  set  to  no  for passwd or group service, then the .byname
92              requests are not added to  passwd.byuid  or  group.bygid  cache.
93              This  may  help  for  tables containing multiple records for the
94              same id.
95

SEE ALSO

97       nscd(8)
98

COLOPHON

100       This page is part of release 3.25 of the Linux  man-pages  project.   A
101       description  of  the project, and information about reporting bugs, can
102       be found at http://www.kernel.org/doc/man-pages/.
103
104
105
106GNU                               1999-10-01                      NSCD.CONF(5)
Impressum