nscd.8: Correct NOTES section on reloading configuration files

It behaved this way at least since "Sun Oct 18 15:02:11 1998 +0000",
some four months after including the nscd implementation in glibc. But
there does seem to be a short window between glibc-2.1 and glibc-2.1.3
when nscd -i was not available, I don't think it's worth muddling the
point of the page with that, though.

Signed-off-by: Petr Baudis <pasky@suse.cz>
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
This commit is contained in:
Petr Baudis 2008-12-06 12:20:13 -05:00 committed by Michael Kerrisk
parent 450c838664
commit ac7302a628
1 changed files with 26 additions and 11 deletions

View File

@ -17,7 +17,10 @@
.\" write to the Free Software Foundation, Inc., 59 Temple Place - Suite 330, .\" write to the Free Software Foundation, Inc., 59 Temple Place - Suite 330,
.\" Boston, MA 02111-1307, USA. .\" Boston, MA 02111-1307, USA.
.\" .\"
.TH NSCD 8 1999-10-01 "GNU" "Linux Programmer's Manual" .\" 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 .SH NAME
/usr/sbin/nscd \- name service cache daemon /usr/sbin/nscd \- name service cache daemon
.SH DESCRIPTION .SH DESCRIPTION
@ -55,16 +58,28 @@ calls remain uncached as a result.
.B "\-\-help" .B "\-\-help"
will give you a list with all options and what they do. will give you a list with all options and what they do.
.SH NOTES .SH NOTES
Nscd doesn't know anything about the underlying protocols for a The daemon will try to watch for changes in configuration files
service. appropriate for each database (e.g.
This also means, that if you change .I /etc/passwd
.I /etc/resolv.conf for the
for DNS queries, nscd will continue to use the old one if you have .I passwd
configured database or
.I /etc/nsswitch.conf .IR "/etc/hosts " and " /etc/resolv.conf"
to use DNS for host lookups. for the
In such a case, you need to restart .I hosts
nscd. 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" .SH "SEE ALSO"
.BR nscd.conf (5), .BR nscd.conf (5),
.BR nsswitch.conf (5) .BR nsswitch.conf (5)