2004-11-03 13:51:07 +00:00
|
|
|
.\" -*- 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-06 17:20:13 +00:00
|
|
|
.\" 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"
|
2004-11-03 13:51:07 +00:00
|
|
|
.SH NAME
|
2005-07-06 07:41:37 +00:00
|
|
|
/usr/sbin/nscd \- name service cache daemon
|
2004-11-03 13:51:07 +00:00
|
|
|
.SH DESCRIPTION
|
|
|
|
Nscd is a daemon that provides a cache for the most common name service
|
2007-04-12 22:42:49 +00:00
|
|
|
requests.
|
|
|
|
The default configuration file,
|
2004-11-03 13:51:07 +00:00
|
|
|
.IR /etc/nscd.conf ,
|
2007-04-12 22:42:49 +00:00
|
|
|
determines the behavior of the cache daemon.
|
|
|
|
See
|
2004-11-03 13:51:07 +00:00
|
|
|
.BR nscd.conf (5).
|
|
|
|
|
2007-06-07 12:55:11 +00:00
|
|
|
Nscd provides caching for accesses of the
|
2004-11-03 13:51:07 +00:00
|
|
|
.BR passwd (5),
|
|
|
|
.BR group (5),
|
|
|
|
and
|
2007-05-21 21:25:44 +00:00
|
|
|
.BR hosts (5)
|
2004-11-03 13:51:07 +00:00
|
|
|
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
|
2007-04-12 22:42:49 +00:00
|
|
|
for items not found.
|
|
|
|
Each cache has a separate TTL (time-to-live)
|
2004-11-03 13:51:07 +00:00
|
|
|
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
|
2008-12-06 17:20:13 +00:00
|
|
|
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
|
2009-01-18 01:42:23 +00:00
|
|
|
.I /etc/hosts
|
|
|
|
and
|
|
|
|
.I /etc/resolv.conf
|
2008-12-06 17:20:13 +00:00
|
|
|
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
|
accept.2, execve.2, futimesat.2, getresuid.2, getrlimit.2, madvise.2, mq_getsetattr.2, msgctl.2, nice.2, open.2, poll.2, setresuid.2, shmctl.2, sigaction.2, times.2, utimensat.2, __setfpucw.3, atoi.3, endian.3, err.3, euidaccess.3, fenv.3, fopencookie.3, fpurge.3, getgrouplist.3, getutmp.3, j0.3, lgamma.3, netlink.3, pthread_attr_init.3, pthread_attr_setaffinity_np.3, pthread_cleanup_push_defer_np.3, pthread_getattr_np.3, pthread_kill_other_threads_np.3, pthread_setaffinity_np.3, pthread_tryjoin_np.3, pthread_yield.3, random_r.3, readdir.3, rtnetlink.3, scanf.3, setenv.3, significand.3, sigsetops.3, strerror.3, strstr.3, sysv_signal.3, termios.3, timegm.3, unlocked_stdio.3, y0.3, locale.5, bootparam.7, feature_test_macros.7, ip.7, locale.7, pthreads.7, rtld-audit.7, nscd.8: Global fix: s/non-standard/nonstandard/
The tendency in English, as prescribed in style guides like
Chicago MoS, is towards removing hyphens after prefixes
like "non-" etc.
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2010-01-16 16:37:52 +00:00
|
|
|
required by nonstandard NSS modules, if any are specified in
|
2008-12-06 17:20:13 +00:00
|
|
|
.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:
|
|
|
|
|
2009-01-18 01:42:23 +00:00
|
|
|
$ \fBnscd -i\fP \fI<database>\fP
|
2004-11-03 13:51:07 +00:00
|
|
|
.SH "SEE ALSO"
|
|
|
|
.BR nscd.conf (5),
|
|
|
|
.BR nsswitch.conf (5)
|
2007-05-16 03:40:19 +00:00
|
|
|
.\" .SH AUTHOR
|
|
|
|
.\" .B nscd
|
|
|
|
.\" was written by Thorsten Kukuk and Ulrich Drepper.
|