Hello,
the following patch adds description of max-db-size and auto-propagate
options,
adds most default values for options and other minor modifications.
The changes in general are based on [1].
Default values are taken from [2] and [3].
Ordering and format of options are based on [4].
Patch is against man-pages 3.41.
peter
[1] http://sourceware.org/git/?p=glibc.git;a=tree;f=nscd;hb=HEAD
[2] http://sourceware.org/git/?p=glibc.git;a=blob;f=nscd/nscd.h;hb=HEAD
[3]
http://sourceware.org/git/?p=glibc.git;a=blob;f=nscd/connections.c;hb=HEAD
[4] http://sourceware.org/git/?p=glibc.git;a=blob;f=nscd/nscd.conf;hb=HEAD
--- nscd.conf.5.org-upstream 2012-05-10 22:13:23.000000000 +0200
+++ nscd.conf.5 2012-05-29 13:46:56.684793432 +0200
@@ -34,48 +34,91 @@
comment; following characters, up to the end of the line,
are not interpreted by nscd.
-Valid services are \fIpasswd\fP, \fIgroup\fP, or \fIhosts\fP.
+Valid services are \fIpasswd\fP, \fIgroup\fP, \fIhosts\fP, \fIservices\fP
+or \fInetgroup\fP.
.B logfile
-.I debug-file-name
+.I <file>
.RS
Specifies name of the file to which debug info should be written.
.RE
.B debug-level
-.I value
+.I <level>
.RS
Sets the desired debug level.
+The default is 0.
.RE
.B threads
-.I number
+.I <number>
.RS
This is the number of threads that are started to wait for
requests.
At least five threads will always be created.
.RE
+.B max-threads
+.I <number>
+.RS
+Specifies the maximum number of threads. The default is 32.
+.RE
+
.B server-user
-.I user
+.I <user>
.RS
If this option is set, nscd will run as this user and not as root.
If a separate cache for every user is used (\-S parameter), this
option is ignored.
.RE
+.B stat-user
+.I <user>
+.RS
+Specifies the user who is allowed to request statistics.
+.RE
+
+.B reload-count
+unlimited |
+.I <number>
+.RS
+Limit on the number of times a cached entry gets reloaded without being
used
+before it gets removed.
+The default is 5.
+.RE
+
+.B paranoia
+.I <yes|no>
+.RS
+Enabling paranoia mode causes nscd to restart itself periodically.
+The default is no.
+.RE
+
+.B restart-interval
+.I <time>
+.RS
+Sets the restart interval to
+.I time
+seconds
+if periodic restart is enabled by enabling
+.B paranoia
+mode.
+The default is 3600.
+.RE
+
.B enable-cache
-.I service
+.I <service>
.I <yes|no>
.RS
Enables or disables the specified
.I service
cache.
+The default is no.
.RE
.B positive-time-to-live
-.I service
-.I value
+.I <service>
+.I <value>
.RS
Sets the TTL (time-to-live) for positive entries (successful queries)
in the specified cache for
@@ -87,8 +130,8 @@
.RE
.B negative-time-to-live
-.I service
-.I value
+.I <service>
+.I <value>
.RS
Sets the TTL (time-to-live) for negative entries (unsuccessful queries)
in the specified cache for
@@ -102,16 +145,17 @@
.RE
.B suggested-size
-.I service
-.I value
+.I <service>
+.I <value>
.RS
This is the internal hash table size,
.I value
should remain a prime number for optimum efficiency.
+The default is 211.
.RE
.B check-files
-.I service
+.I <service>
.I <yes|no>
.RS
Enables or disables checking the file belonging to the specified
@@ -120,50 +164,14 @@
The files are
.IR /etc/passwd ,
.IR /etc/group ,
+.IR /etc/hosts
and
-.IR /etc/hosts .
-.RE
-
-.B max-threads
-.I threads
-.RS
-Specifies the maximum number of threads to be started.
-.RE
-
-.B stat-user
-.I username
-.RS
-Specifies the user who is allowed to request statistics.
-.RE
-
-.B reload-count
-unlimited |
-.I number
-.RS
-Limit on the number of times a cached entry gets reloaded without being
used
-before it gets removed.
-The default is 5.
-.RE
-
-.B paranoia
-.I <yes|no>
-.RS
-Enabling paranoia mode causes nscd to restart itself periodically.
-.RE
-
-.B restart-interval
-.I time
-.RS
-Sets the restart interval to
-.I time
-seconds
-if periodic restart is enabled by enabling
-.B paranoia
-mode.
+.IR /etc/services .
+The default is yes.
.RE
.B persistent
-.I service
+.I <service>
.I <yes|no>
.RS
Keep the content of the cache for
@@ -171,10 +179,11 @@
over server restarts; useful when
.B paranoia
mode is set.
+The default is no.
.RE
.B shared
-.I service
+.I <service>
.I <yes|no>
.RS
The memory mapping of the nscd databases for
@@ -182,7 +191,32 @@
is shared with the clients so
that they can directly search in them instead of having to ask the
daemon over the socket each time a lookup is performed.
+The default is no.
+.RE
+
+.B max-db-size
+.I <service>
+.I <bytes>
+.RS
+The maximum allowable size of the database files in bytes for the
+.IR service .
+The default is 33554432.
.RE
+
+.B auto-propagate
+.I <service>
+.I <yes|no>
+.RS
+When set to
+.IR no " for " passwd " or " group " service, then the " .byname
+requests are not added to
+.IR passwd.byuid " or " group.bygid
+cache.
+This can help with tables containing multiple records for the same id.
+The default is yes. This option is valid only for services
+.IR passwd " and " group ".
+.RE
+
.SH "SEE ALSO"
.BR nscd (8)
.\" .SH AUTHOR
--
To unsubscribe from this list: send the line "unsubscribe linux-man" in
the body of a message to majordomo@xxxxxxxxxxxxxxx
More majordomo info at http://vger.kernel.org/majordomo-info.html
