summaryrefslogtreecommitdiff
diff options
context:
space:
mode:
authorCarlos O'Donell <carlos@redhat.com>2019-03-20 22:11:32 -0400
committerCarlos O'Donell <carlos@redhat.com>2019-08-19 09:57:58 -0400
commitd34d4c80226b3f5a1b51a8e5b005a52fba07d7ba (patch)
treecc63db70c07ade522747582bfc46c8832f166ae3
parent4b7c74179c8928d971d370e1137d202f891a4cf5 (diff)
downloadglibc-d34d4c80226b3f5a1b51a8e5b005a52fba07d7ba.tar.gz
nscd: Improve nscd.conf comments.
This change adds a warning to nscd.conf about running multiple caching services together and that it may lead to unexpected behaviours. Also we add a note that enabling the 'shared' option will cause cache hit rates to be misreported (a side effect of the implementation). v2 - Rewrite comment to avoid implementation details.
-rw-r--r--ChangeLog4
-rw-r--r--nscd/nscd.conf6
2 files changed, 10 insertions, 0 deletions
diff --git a/ChangeLog b/ChangeLog
index 393be10851..96d1b9c744 100644
--- a/ChangeLog
+++ b/ChangeLog
@@ -1,5 +1,9 @@
2019-08-19 Carlos O'Donell <carlos@redhat.com>
+ * nscd/nscd.conf: Add warning and comment about shared option.
+
+2019-08-19 Carlos O'Donell <carlos@redhat.com>
+
* nss/nsswitch.conf: Expand comments, and simplify defaults.
* manual/nss.texi (NSS Basics): List all known databases.
(Services in the NSS configuration): Mention automount.
diff --git a/nscd/nscd.conf b/nscd/nscd.conf
index 39b875912d..487ffe461d 100644
--- a/nscd/nscd.conf
+++ b/nscd/nscd.conf
@@ -3,6 +3,9 @@
#
# An example Name Service Cache config file. This file is needed by nscd.
#
+# WARNING: Running nscd with a secondary caching service like sssd may lead to
+# unexpected behaviour, especially with how long entries are cached.
+#
# Legal entries are:
#
# logfile <file>
@@ -23,6 +26,9 @@
# check-files <service> <yes|no>
# persistent <service> <yes|no>
# shared <service> <yes|no>
+# NOTE: Setting 'shared' to a value of 'yes' will accelerate the lookup,
+# but those lookups will not be counted as cache hits
+# i.e. 'nscd -g' may show '0%'.
# max-db-size <service> <number bytes>
# auto-propagate <service> <yes|no>
#