original/man5/nscd.conf.5

   1 .\" Copyright (c) 1999, 2000 SuSE GmbH Nuernberg, Germany
   2 .\" Author: Thorsten Kukuk <kukuk@suse.de>
   3 .\"
   4 .\" %%%LICENSE_START(GPLv2+_SW_3_PARA)
   5 .\" This program is free software; you can redistribute it and/or
   6 .\" modify it under the terms of the GNU General Public License as
   7 .\" published by the Free Software Foundation; either version 2 of the
   8 .\" License, or (at your option) any later version.
   9 .\"
  10 .\" This program is distributed in the hope that it will be useful,
  11 .\" but WITHOUT ANY WARRANTY; without even the implied warranty of
  12 .\" MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.  See the GNU
  13 .\" General Public License for more details.
  14 .\"
  15 .\" You should have received a copy of the GNU General Public
  16 .\" License along with this manual; if not, see
  17 .\" <http://www.gnu.org/licenses/>.
  18 .\" %%%LICENSE_END
  19 .\"
  20 .TH NSCD.CONF 5 2014-02-07 "GNU" "Linux Programmer's Manual"
  21 .SH NAME
  22 /etc/nscd.conf \- name service cache daemon configuration file
  23 .SH DESCRIPTION
  24 The file
  25 .I /etc/nscd.conf
  26 is read from
  27 .BR nscd (8)
  28 at startup.
  29 Each line specifies either an attribute and a value, or an
  30 attribute, service, and a value.
  31 Fields are separated either by SPACE
  32 or TAB characters.
  33 A \(aq#\(aq (number sign) indicates the beginning of a
  34 comment; following characters, up to the end of the line,
  35 are not interpreted by nscd.
  36
  37 Valid services are \fIpasswd\fP, \fIgroup\fP, \fIhosts\fP, \fIservices\fP,
  38 or \fInetgroup\fP.
  39
  40 .B logfile
  41 .I debug-file-name
  42 .RS
  43 Specifies name of the file to which debug info should be written.
  44 .RE
  45
  46 .B debug-level
  47 .I value
  48 .RS
  49 Sets the desired debug level.
  50 The default is 0.
  51 .RE
  52
  53 .B threads
  54 .I number
  55 .RS
  56 This is the number of threads that are started to wait for
  57 requests.
  58 At least five threads will always be created.
  59 .RE
  60
  61 .B max-threads
  62 .I number
  63 .RS
  64 Specifies the maximum number of threads.
  65 The default is 32.
  66 .RE
  67
  68 .B server-user
  69 .I user
  70 .RS
  71 If this option is set, nscd will run as this user and not as root.
  72 If a separate cache for every user is used (\-S parameter), this
  73 option is ignored.
  74 .RE
  75
  76 .B stat-user
  77 .I user
  78 .RS
  79 Specifies the user who is allowed to request statistics.
  80 .RE
  81
  82 .B reload-count
  83 unlimited |
  84 .I number
  85 .RS
  86 Limit on the number of times a cached entry gets reloaded without being used
  87 before it gets removed.
  88 The default is 5.
  89 .RE
  90
  91 .B paranoia
  92 .I <yes|no>
  93 .RS
  94 Enabling paranoia mode causes nscd to restart itself periodically.
  95 The default is no.
  96 .RE
  97
  98 .B restart-interval
  99 .I time
 100 .RS
 101 Sets the restart interval to
 102 .I time
 103 seconds
 104 if periodic restart is enabled by enabling
 105 .B paranoia
 106 mode.
 107 The default is 3600.
 108 .RE
 109
 110 .B enable-cache
 111 .I service
 112 .I <yes|no>
 113 .RS
 114 Enables or disables the specified
 115 .I service
 116 cache.
 117 The default is no.
 118 .RE
 119
 120 .B positive-time-to-live
 121 .I service
 122 .I value
 123 .RS
 124 Sets the TTL (time-to-live) for positive entries (successful queries)
 125 in the specified cache for
 126 .IR service .
 127 .I Value
 128 is in seconds.
 129 Larger values increase cache hit rates and reduce mean
 130 response times, but increase problems with cache coherence.
 131 .RE
 132
 133 .B negative-time-to-live
 134 .I service
 135 .I value
 136 .RS
 137 Sets the TTL (time-to-live) for negative entries (unsuccessful queries)
 138 in the specified cache for
 139 .IR service .
 140 .I Value
 141 is in seconds.
 142 Can result in significant performance improvements if there
 143 are several files owned by UIDs (user IDs) not in system databases (for
 144 example untarring the Linux kernel sources as root); should be kept small
 145 to reduce cache coherency problems.
 146 .RE
 147
 148 .B suggested-size
 149 .I service
 150 .I value
 151 .RS
 152 This is the internal hash table size,
 153 .I value
 154 should remain a prime number for optimum efficiency.
 155 The default is 211.
 156 .RE
 157
 158 .B check-files
 159 .I service
 160 .I <yes|no>
 161 .RS
 162 Enables or disables checking the file belonging to the specified
 163 .I service
 164 for changes.
 165 The files are
 166 .IR /etc/passwd ,
 167 .IR /etc/group ,
 168 .IR /etc/hosts ,
 169 .I /etc/services
 170 and
 171 .IR /etc/netgroup .
 172 The default is yes.
 173 .RE
 174
 175 .B persistent
 176 .I service
 177 .I <yes|no>
 178 .RS
 179 Keep the content of the cache for
 180 .I service
 181 over server restarts; useful when
 182 .B paranoia
 183 mode is set.
 184 The default is no.
 185 .RE
 186
 187 .B shared
 188 .I service
 189 .I <yes|no>
 190 .RS
 191 The memory mapping of the nscd databases for
 192 .I service
 193 is shared with the clients so
 194 that they can directly search in them instead of having to ask the
 195 daemon over the socket each time a lookup is performed.
 196 The default is no.
 197 .RE
 198
 199 .B max-db-size
 200 .I service
 201 .I bytes
 202 .RS
 203 The maximum allowable size, in bytes, of the database files for the
 204 .IR service .
 205 The default is 33554432.
 206 .RE
 207
 208 .B auto-propagate
 209 .I service
 210 .I <yes|no>
 211 .RS
 212 When set to
 213 .IR no
 214 for
 215 .I passwd
 216 or
 217 .I group
 218 service, then the
 219 .I .byname
 220 requests are not added to
 221 .IR passwd.byuid
 222 or
 223 .I group.bygid
 224 cache.
 225 This can help with tables containing multiple records for the same ID.
 226 The default is yes.
 227 This option is valid only for services
 228 .IR passwd
 229 and
 230 .IR group .
 231 .RE
 232 .SH NOTES
 233 The default values stated in this manual page originate
 234 from the source code of
 235 .BR nscd (8)
 236 and are used if not overridden in the configuration file.
 237 The default values used in the configuration file of
 238 your distribution might differ.
 239 .SH SEE ALSO
 240 .BR nscd (8)
 241 .\" .SH AUTHOR
 242 .\" .B nscd
 243 .\" was written by Thorsten Kukuk and Ulrich Drepper.
 244 .SH COLOPHON
 245 This page is part of release 3.67 of the Linux
 246 .I man-pages
 247 project.
 248 A description of the project,
 249 information about reporting bugs,
 250 and the latest version of this page,
 251 can be found at
 252 \%http://www.kernel.org/doc/man\-pages/.