original/man5/nscd.conf.5

   1 .\" -*- nroff -*-
   2 .\" Copyright (c) 1999, 2000 SuSE GmbH Nuernberg, Germany
   3 .\" Author: Thorsten Kukuk <kukuk@suse.de>
   4 .\"
   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 program; see the file COPYING.  If not,
  17 .\" write to the Free Software Foundation, Inc., 59 Temple Place - Suite 330,
  18 .\" Boston, MA 02111-1307, USA.
  19 .\"
  20 .TH NSCD.CONF 5 1999-10-01 "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, or \fIhosts\fP.
  38
  39 .B logfile
  40 .I debug-file-name
  41 .RS
  42 Specifies name of the file to which debug info should be written.
  43 .RE
  44
  45 .B debug-level
  46 .I value
  47 .RS
  48 Sets the desired debug level.
  49 .RE
  50
  51 .B threads
  52 .I number
  53 .RS
  54 This is the number of threads that are started to wait for
  55 requests.
  56 At least five threads will always be created.
  57 .RE
  58
  59 .B server-user
  60 .I user
  61 .RS
  62 If this option is set, nscd will run as this user and not as root.
  63 If a separate cache for every user is used (\-S parameter), this
  64 option is ignored.
  65 .RE
  66
  67 .B enable-cache
  68 .I service
  69 .I <yes|no>
  70 .RS
  71 Enables or disables the specified
  72 .I service
  73 cache.
  74 .RE
  75
  76 .B positive-time-to-live
  77 .I service
  78 .I value
  79 .RS
  80 Sets the TTL (time-to-live) for positive entries (successful queries)
  81 in the specified cache for
  82 .IR service .
  83 .I Value
  84 is in seconds.
  85 Larger values increase cache hit rates and reduce mean
  86 response times, but increase problems with cache coherence.
  87 .RE
  88
  89 .B negative-time-to-live
  90 .I service
  91 .I value
  92 .RS
  93 Sets the TTL (time-to-live) for negative entries (unsuccessful queries)
  94 in the specified cache for
  95 .IR service .
  96 .I Value
  97 is in seconds.
  98 Can result in significant performance improvements if there
  99 are several files owned by UIDs (user IDs) not in system databases (for
 100 example untarring the linux kernel sources as root); should be kept small
 101 to reduce cache coherency problems.
 102 .RE
 103
 104 .B suggested-size
 105 .I service
 106 .I value
 107 .RS
 108 This is the internal hash table size,
 109 .I value
 110 should remain a prime number for optimum efficiency.
 111 .RE
 112
 113 .B check-files
 114 .I service
 115 .I <yes|no>
 116 .RS
 117 Enables or disables checking the file belonging to the specified
 118 .I service
 119 for changes.
 120 The files are
 121 .IR /etc/passwd ,
 122 .IR /etc/group ,
 123 and
 124 .IR /etc/hosts .
 125 .RE
 126
 127 .B max-threads
 128 .I threads
 129 .RS
 130 Specifies the maximum number of threads to be started.
 131 .RE
 132
 133 .B stat-user
 134 .I username
 135 .RS
 136 Specifies the user who is allowed to request statistics.
 137 .RE
 138
 139 .B reload-count
 140 unlimited |
 141 .I number
 142 .RS
 143 Limit on the number of times a cached entry gets reloaded without being used
 144 before it gets removed.
 145 The default is 5.
 146 .RE
 147
 148 .B paranoia
 149 .I <yes|no>
 150 .RS
 151 Enabling paranoia mode causes nscd to restart itself periodically.
 152 .RE
 153
 154 .B restart-interval
 155 .I time
 156 .RS
 157 Sets the restart interval to
 158 .I time
 159 seconds
 160 if periodic restart is enabled by enabling
 161 .B paranoia
 162 mode.
 163 .RE
 164
 165 .B persistent
 166 .I service
 167 .I <yes|no>
 168 .RS
 169 Keep the content of the cache for
 170 .I service
 171 over server restarts; useful when
 172 .B paranoia
 173 mode is set.
 174 .RE
 175
 176 .B shared
 177 .I service
 178 .I <yes|no>
 179 .RS
 180 The memory mapping of the nscd databases for
 181 .I service
 182 is shared with the clients so
 183 that they can directly search in them instead of having to ask the
 184 daemon over the socket each time a lookup is performed.
 185 .RE
 186 .SH "SEE ALSO"
 187 .BR nscd (8)
 188 .\" .SH AUTHOR
 189 .\" .B nscd
 190 .\" was written by Thorsten Kukuk and Ulrich Drepper.