Tribblix: manual page: nscd.conf.5

NSCD.CONF(5) File Formats and Configurations NSCD.CONF(5)

NAME

nscd.conf - name service cache daemon configuration

SYNOPSIS

/etc/nscd.conf

DESCRIPTION

The nscd.conf file contains the configuration information for
nscd(8). Each line specifies either an attribute and a value, or an
attribute, cachename, and a value. Fields are separated either by
SPACE or TAB characters. A `#' (number sign) indicates the beginning
of a comment; characters up to the end of the line are not
interpreted by nscd.

cachename is represented by hosts, ipnodes, passwd, group, exec_attr,
prof_attr, user_attr, ethers, rpc, protocols, networks, bootparams,
auth_attr, services, netmasks, printers, or project.

The attribute field supports the following:

check-files cachename value

Enables or disables checking the file belonging to the specified
cachename for changes. If enabled (which is the default), changes
in the corresponding file cause the cache to be invalidated
within 10 seconds. Can be disabled if files are never modified
for a slight performance boost, particularly over NFS. value may
be either yes or no.

debug-level value

Sets the debug level desired. value may range from 0 (the
default) to 10. Use of this option causes nscd(8) to run in the
foreground and not become a daemon. Note that the output of the
debugging command is not likely to remain the same from release-
to-release; scripts should not rely on its format.

enable-cache cachename value

Enables or disables the specified cache. value may be either yes
or no.

enable-per-user-lookup value

Enables or disables the ability of nscd to create a per-user
nscd. A per-user nscd performs per-user lookups and manages the
per-user cache. The per-user lookups might not be possible if
the corresponding name service switch backends do not support it
or are not configured to do so. The value of this attribute can
be either yes or no.

keep-hot-count cachename value

This attribute allows the administrator to set the number of
entries nscd(8) is to keep current in the specified cache. value
is an integer number which should approximate the number of
entries frequently used during the day.

logfile debug-file-name

Specifies name of the file to which debug info should be written.
Use /dev/tty for standard output.

maximum-per-user-nscd value

Sets the maximum number of per-user nscds that can be created and
managed by the main nscd daemon. The value is an integer.

negative-time-to-live cachename value

Sets the time-to-live for negative entries (unsuccessful queries)
in the specified cache. value is in integer seconds. Can result
in significant performance improvements if there are several
files owned by uids (user IDs) not in system databases; should be
kept small to reduce cache coherency problems.

per-user-nscd-time-to-live value

Sets the time-to-live value for a per-user nscd based on the last
time the per-user nscd was active. The value is an integer that
specifies a number of seconds.

positive-time-to-live cachename value

Sets the time-to-live for positive entries (successful queries)
in the specified cache. value is in integer seconds. Larger
values increase cache hit rates and reduce mean response times,
but increase problems with cache coherence. Note that sites that
push (update) NIS maps nightly can set the value to be the
equivalent of 12 hours or more with very good performance
implications.

suggested-size cachename value

Sets the suggested number of hash buckets in the specified cache.
This parameter should be changed only if the number of entries in
the cache exceeds the suggested size by more than a factor of
four or five. Since this is the internal hash table size, value
should remain a prime number for optimum efficiency.

This attribute is obsolete and will be silently ignored. nscd now
automatically adjusts the hash table size.

ATTRIBUTES

NAME

SYNOPSIS

DESCRIPTION

ATTRIBUTES

SEE ALSO