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

NAME

6       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, hosts, services, or netgroup.
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.  The default is 0.
23
24       threads number
25              This is the number of threads that are started to wait  for  re‐
26              quests.  At least five threads will always be created.
27
28       max-threads number
29              Specifies the maximum number of threads.  The default is 32.
30
31       server-user user
32              If  this  option  is  set, nscd will run as this user and not as
33              root.  If a separate cache for every user is  used  (-S  parame‐
34              ter), this option is ignored.
35
36       stat-user user
37              Specifies the user who is allowed to request statistics.
38
39       reload-count unlimited | number
40              Limit  on the number of times a cached entry gets reloaded with‐
41              out being used before it gets removed.  The default is 5.
42
43       paranoia <yes|no>
44              Enabling paranoia mode causes nscd to  restart  itself  periodi‐
45              cally.  The default is no.
46
47       restart-interval time
48              Sets the restart interval to time seconds if periodic restart is
49              enabled by enabling paranoia mode.  The default is 3600.
50
51       enable-cache service <yes|no>
52              Enables or disables the specified service cache.  The default is
53              no.
54
55       positive-time-to-live service value
56              Sets  the  TTL  (time-to-live)  for positive entries (successful
57              queries) in the specified cache for service.  Value is  in  sec‐
58              onds.   Larger  values  increase cache hit rates and reduce mean
59              response times, but increase problems with cache coherence.
60
61       negative-time-to-live service value
62              Sets the TTL (time-to-live) for negative  entries  (unsuccessful
63              queries)  in  the specified cache for service.  Value is in sec‐
64              onds.  Can result in  significant  performance  improvements  if
65              there  are  several files owned by UIDs (user IDs) not in system
66              databases (for example untarring the  Linux  kernel  sources  as
67              root); should be kept small to reduce cache coherency problems.
68
69       suggested-size service value
70              This  is  the  internal  hash  table size, value should remain a
71              prime number for optimum efficiency.  The default is 211.
72
73       check-files service <yes|no>
74              Enables or disables checking the file belonging to the specified
75              service  for  changes.   The  files are /etc/passwd, /etc/group,
76              /etc/hosts, /etc/services, and /etc/netgroup.   The  default  is
77              yes.
78
79       persistent service <yes|no>
80              Keep  the content of the cache for service over server restarts;
81              useful when paranoia mode is set.  The default is no.
82
83       shared service <yes|no>
84              The memory mapping of the nscd databases for service  is  shared
85              with  the  clients  so that they can directly search in them in‐
86              stead of having to ask the daemon over the socket  each  time  a
87              lookup is performed.  The default is no.
88
89       max-db-size service bytes
90              The  maximum allowable size, in bytes, of the database files for
91              the service.  The default is 33554432.
92
93       auto-propagate service <yes|no>
94              When set to no for passwd or group service, then the .byname re‐
95              quests are not added to passwd.byuid or group.bygid cache.  This
96              can help with tables containing multiple records  for  the  same
97              ID.  The default is yes.  This option is valid only for services
98              passwd and group.
99

NOTES

101       The default values stated in this manual page originate from the source
102       code  of  nscd(8)  and  are used if not overridden in the configuration
103       file.  The default values used in the configuration file of  your  dis‐
104       tribution might differ.
105

SEE ALSO

107       nscd(8)
108

COLOPHON

110       This  page  is  part of release 5.13 of the Linux man-pages project.  A
111       description of the project, information about reporting bugs,  and  the
112       latest     version     of     this    page,    can    be    found    at
113       https://www.kernel.org/doc/man-pages/.
114
115
116
117GNU                               2020-12-21                      NSCD.CONF(5)
Impressum