mirror of https://github.com/mkerrisk/man-pages
89 lines
2.7 KiB
Groff
89 lines
2.7 KiB
Groff
.\" -*- nroff -*-
|
|
.\" Copyright 1999 SuSE GmbH Nuernberg, Germany
|
|
.\" Author: Thorsten Kukuk <kukuk@suse.de>
|
|
.\"
|
|
.\" This program is free software; you can redistribute it and/or
|
|
.\" modify it under the terms of the GNU General Public License as
|
|
.\" published by the Free Software Foundation; either version 2 of the
|
|
.\" License, or (at your option) any later version.
|
|
.\"
|
|
.\" This program is distributed in the hope that it will be useful,
|
|
.\" but WITHOUT ANY WARRANTY; without even the implied warranty of
|
|
.\" MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the GNU
|
|
.\" General Public License for more details.
|
|
.\"
|
|
.\" You should have received a copy of the GNU General Public
|
|
.\" License along with this program; see the file COPYING. If not,
|
|
.\" write to the Free Software Foundation, Inc., 59 Temple Place - Suite 330,
|
|
.\" Boston, MA 02111-1307, USA.
|
|
.\"
|
|
.\" 2008-12-05 Petr Baudis <pasky@suse.cz>
|
|
.\" Rewrite the NOTES section to reflect modern reality
|
|
.\"
|
|
.TH NSCD 8 2008-12-05 "GNU" "Linux Programmer's Manual"
|
|
.SH NAME
|
|
/usr/sbin/nscd \- name service cache daemon
|
|
.SH DESCRIPTION
|
|
Nscd is a daemon that provides a cache for the most common name service
|
|
requests.
|
|
The default configuration file,
|
|
.IR /etc/nscd.conf ,
|
|
determines the behavior of the cache daemon.
|
|
See
|
|
.BR nscd.conf (5).
|
|
|
|
Nscd provides caching for accesses of the
|
|
.BR passwd (5),
|
|
.BR group (5),
|
|
and
|
|
.BR hosts (5)
|
|
databases through standard libc interfaces, such as
|
|
.BR getpwnam (3),
|
|
.BR getpwuid (3),
|
|
.BR getgrnam (3),
|
|
.BR getgrgid (3),
|
|
.BR gethostbyname (3),
|
|
and others.
|
|
|
|
There are two caches for each database:
|
|
a positive one for items found, and a negative one
|
|
for items not found.
|
|
Each cache has a separate TTL (time-to-live)
|
|
period for its data.
|
|
Note that the shadow file is specifically not cached.
|
|
.BR getspnam (3)
|
|
calls remain uncached as a result.
|
|
.SH OPTIONS
|
|
.TP
|
|
.B "\-\-help"
|
|
will give you a list with all options and what they do.
|
|
.SH NOTES
|
|
The daemon will try to watch for changes in configuration files
|
|
appropriate for each database (e.g.
|
|
.I /etc/passwd
|
|
for the
|
|
.I passwd
|
|
database or
|
|
.IR "/etc/hosts " and " /etc/resolv.conf"
|
|
for the
|
|
.I hosts
|
|
database), and flush the cache when these are changed.
|
|
However, this will happen only after a short delay (unless the
|
|
.BR inotify (7)
|
|
mechanism is available and glibc 2.9 or later is available),
|
|
and this auto-detection does not cover configuration files
|
|
required by non-standard NSS modules, if any are specified in
|
|
.IR /etc/nsswitch.conf .
|
|
In that case, you need to run the following command
|
|
after changing the configuration file of the database so that
|
|
.B nscd
|
|
invalidates its cache:
|
|
|
|
$ \fBnscd -i \fI<database>\fP
|
|
.SH "SEE ALSO"
|
|
.BR nscd.conf (5),
|
|
.BR nsswitch.conf (5)
|
|
.\" .SH AUTHOR
|
|
.\" .B nscd
|
|
.\" was written by Thorsten Kukuk and Ulrich Drepper.
|