raw/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 "GNU C Library"
  21 .SH NAME
  22 /etc/nscd.conf - name service cache daemon configuration file
  23 .SH DESCRIPTION
  24 The file
  25 .B /etc/nscd.conf
  26 is read from
  27 .BR nscd (8)
  28 at startup. Each line specifies either an attribute and a value, or an
  29 attribute, service, and a value. Fields are separated either by SPACE
  30 or TAB characters. A `#' (number sign) indicates the beginning of a
  31 comment; following characters, up to the end of the line,
  32 are not interpreted by nscd.
  33
  34
  35 Valid services are passwd, group, or hosts.
  36
  37 .B logfile
  38 .I debug-file-name
  39 .RS
  40 Specifies name of the file to which debug info should be written.
  41 .RE
  42
  43 .B debug-level
  44 .I value
  45 .RS
  46 Sets the desired debug level.
  47 .RE
  48
  49 .B threads
  50 .I number
  51 .RS
  52 This is the number of threads that are started to wait for
  53 requests. At least five threads will always be created.
  54 .RE
  55
  56 .B server-user
  57 .I user
  58 .RS
  59 If this option is set, nscd will run as this user and not as root.
  60 If a separate cache for every user is used (-S parameter), this
  61 option is ignored.
  62 .RE
  63
  64 .B enable-cache
  65 .I service
  66 .I <yes|no>
  67 .RS
  68 Enables or disables the specified
  69 .I service
  70 cache.
  71 .RE
  72
  73 .B positive-time-to-live
  74 .I service
  75 .I value
  76 .RS
  77 Sets the TTL (time-to-live) for positive entries (successful queries)
  78 in the specified cache for
  79 .IR service .
  80 .I Value
  81 is in seconds. Larger values increase cache hit rates and reduce mean
  82 response times, but increase problems with cache coherence.
  83 .RE
  84
  85 .B negative-time-to-live
  86 .I service
  87 .I value
  88 .RS
  89 Sets the TTL (time-to-live) for negative entries (unsuccessful queries)
  90 in the specified cache for
  91 .IR service .
  92 .I Value
  93 is in seconds. Can result in significant performance improvements if there
  94 are several files owned by uids (user IDs) not in system databases (for
  95 example untarring the linux kernel sources as root); should be kept small
  96 to reduce cache coherency problems.
  97 .RE
  98
  99 .B suggested-size
 100 .I service
 101 .I value
 102 .RS
 103 This is the internal hash table size,
 104 .I value
 105 should remain a prime number for optimum efficiency.
 106 .RE
 107
 108 .B check-files
 109 .I service
 110 .I <yes|no>
 111 .RS
 112 Enables or disables checking the file belonging to the specified
 113 .I service
 114 for changes. The files are
 115 .IR /etc/passwd ,
 116 .IR /etc/group ,
 117 and
 118 .IR /etc/hosts .
 119 .RE
 120
 121 .SH "SEE ALSO"
 122 .BR nscd (8)
 123 .SH AUTHOR
 124 .B nscd
 125 was written by Thorsten Kukuk and Ulrich Drepper.