cmsg.3: CONFORMING TO: note which CMSG_* APIs are in current and upcoming POSIX

[thirdparty/man-pages.git] / man8 / nscd.8

diff --git a/man8/nscd.8 b/man8/nscd.8
index bb89d0e1111f7eb7be7b5e3e934a8c8100350852..a0b3733e40d024b7361a9008203792b6ed11d893 100644 (file)
--- a/man8/nscd.8
+++ b/man8/nscd.8
@@ -1,7 +1,7 @@
-.\" -*- nroff -*-
 .\" Copyright 1999 SuSE GmbH Nuernberg, Germany
 .\" Author: Thorsten Kukuk <kukuk@suse.de>
 .\"
+.\" %%%LICENSE_START(GPLv2+_SW_3_PARA)
 .\" 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
@@ -13,27 +13,34 @@
 .\" 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.
+.\" License along with this manual; if not, see
+.\" <http://www.gnu.org/licenses/>.
+.\" %%%LICENSE_END
 .\"
-.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 2015-05-07 "GNU" "Linux Programmer's Manual"
 .SH NAME
-/usr/sbin/nscd \- name service cache daemon
+nscd \- name service cache daemon
 .SH DESCRIPTION
-Nscd is a daemon that provides a cache for the most common name service
+.B 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 cacheing for accesses of the
+.PP
+.B nscd
+provides caching for accesses of the
 .BR passwd (5),
 .BR group (5),
-and
 .BR hosts (5)
+.BR services (5)
+and
+.I netgroup
 databases through standard libc interfaces, such as
 .BR getpwnam (3),
 .BR getpwuid (3),
@@ -41,7 +48,7 @@ databases through standard libc interfaces, such as
 .BR getgrgid (3),
 .BR gethostbyname (3),
 and others.
-
+.PP
 There are two caches for each database:
 a positive one for items found, and a negative one
 for items not found.
@@ -55,17 +62,35 @@ calls remain uncached as a result.
 .B "\-\-help"
 will give you a list with all options and what they do.
 .SH NOTES
-Nscd doesn't know anything about the underlaying protocols for a
-service.
-This also means, that if you change
+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
+.I /etc/hosts
+and
 .I /etc/resolv.conf
-for DNS queries, nscd will continue to use the old one if you have
-configured
-.I /etc/nsswitch.conf
-to use DNS for host lookups.
-In such a case, you need to restart
-nscd.
-.SH "SEE ALSO"
+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 nonstandard 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:
+.PP
+.in +4n
+.EX
+$ \fBnscd -i\fP \fI<database>\fP
+.EE
+.in
+.SH SEE ALSO
 .BR nscd.conf (5),
 .BR nsswitch.conf (5)
 .\" .SH AUTHOR