original/man8/nscd.8

   1 .\" Copyright 1999 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 .\" 2008-12-05 Petr Baudis <pasky@suse.cz>
  21 .\"     Rewrite the NOTES section to reflect modern reality
  22 .\"
  23 .TH NSCD 8 2012-05-10 "GNU" "Linux Programmer's Manual"
  24 .SH NAME
  25 nscd \- name service cache daemon
  26 .SH DESCRIPTION
  27 Nscd is a daemon that provides a cache for the most common name service
  28 requests.
  29 The default configuration file,
  30 .IR /etc/nscd.conf ,
  31 determines the behavior of the cache daemon.
  32 See
  33 .BR nscd.conf (5).
  34
  35 Nscd provides caching for accesses of the
  36 .BR passwd (5),
  37 .BR group (5),
  38 and
  39 .BR hosts (5)
  40 databases through standard libc interfaces, such as
  41 .BR getpwnam (3),
  42 .BR getpwuid (3),
  43 .BR getgrnam (3),
  44 .BR getgrgid (3),
  45 .BR gethostbyname (3),
  46 and others.
  47
  48 There are two caches for each database:
  49 a positive one for items found, and a negative one
  50 for items not found.
  51 Each cache has a separate TTL (time-to-live)
  52 period for its data.
  53 Note that the shadow file is specifically not cached.
  54 .BR getspnam (3)
  55 calls remain uncached as a result.
  56 .SH OPTIONS
  57 .TP
  58 .B "\-\-help"
  59 will give you a list with all options and what they do.
  60 .SH NOTES
  61 The daemon will try to watch for changes in configuration files
  62 appropriate for each database (e.g.,
  63 .I /etc/passwd
  64 for the
  65 .I passwd
  66 database or
  67 .I /etc/hosts
  68 and
  69 .I /etc/resolv.conf
  70 for the
  71 .I hosts
  72 database), and flush the cache when these are changed.
  73 However, this will happen only after a short delay (unless the
  74 .BR inotify (7)
  75 mechanism is available and glibc 2.9 or later is available),
  76 and this auto-detection does not cover configuration files
  77 required by nonstandard NSS modules, if any are specified in
  78 .IR /etc/nsswitch.conf .
  79 In that case, you need to run the following command
  80 after changing the configuration file of the database so that
  81 .B nscd
  82 invalidates its cache:
  83
  84     $ \fBnscd -i\fP \fI<database>\fP
  85 .SH SEE ALSO
  86 .BR nscd.conf (5),
  87 .BR nsswitch.conf (5)
  88 .\" .SH AUTHOR
  89 .\" .B nscd
  90 .\" was written by Thorsten Kukuk and Ulrich Drepper.
  91 .SH COLOPHON
  92 This page is part of release 3.79 of the Linux
  93 .I man-pages
  94 project.
  95 A description of the project,
  96 information about reporting bugs,
  97 and the latest version of this page,
  98 can be found at
  99 \%http://www.kernel.org/doc/man\-pages/.