Default variable details
Some of the debops.nscd
default variables have more extensive configuration
than simple strings or lists, here you can find documentation and examples for
them.
nscd__configuration
The nscd__*_configuration
variables define the contents of the
/etc/nscd.conf
configuration file. The variables are merged in order
defined by the nscd__combined_configuration
variable, which allows
modification of the default configuration through the Ansible inventory. See
nscd.conf(5) for possible configuration parameters and their values.
Examples
See nscd__default_configuration
variable for an example of
existing configuration.
Syntax
The variables contain a list of YAML dictionaries, each dictionary can have specific parameters:
name
Required. Name of the NSS service to cache. If the
name
parameter is set to'global'
, and theoptions
parameter is defined, this creates a special "global" section at the beginning of the configuration file.The
name
parameter is used as an anchor to merge multiple configuration entries with the same name together.state
Optional. If not specified or
present
, a given configuration section will be included in the generated configuration file. Ifabsent
, a given configuration section will be removed from the generated file. Ifcomment
, the configuration section will be present, but commented out.comment
Optional. String or YAML text block with a comment added before a given configuration section.
options
Optional. A list of configuration options which should be included in a given configuration section. This parameter only makes sense in the "global" section, and otherwise should not be present in configuration entries. See the nscd.conf(5) manual page for the possible configuration options.
Each list element is defined as a YAML dictionary with specific parameters:
name
Required. The configuration option name.
value
Required. The configuration option value. Can be defined as a string, an integer or a boolean.
state
Optional. If not specified or
present
, a given configuration option will be included in the generated configuration file. Ifabsent
, a given configuration option will be removed from the generated file. Ifcomment
, the configuration option will be present, but commented out.
The parameters described below are based on the configuration options defined
in the nscd.conf(5) manual page. All of the parameters are usually
required for a given configuration section to work; different nscd
flavors
will use different parameters.
enable_cache
Boolean. Enable or disable cache for a given NSS service.
positive_time_to_live
Number of seconds after which an existing entry is removed from cache.
negative_time_to_live
Number of seconds after which a non-existent entry is removed from cache.
suggested_size
Size of the hash that is used to store cached entries. Its value should be a prime number.
check_files
Boolean. If
True
, the service checks the contents of the/etc/passwd
,/etc/group
and/etc/hosts
files and invalidates the cached entries if the files changed.persistent
Boolean. If
True
, cached entries of a given NSS service will be kept between nscd daemon restarts.shared
Boolean. If
True
, the memory mapped for cache is shared with the service clients directly instead of forcing them to talk to the daemon.max_db_size
Specify the maximum size of the cache for a given NSS service.
auto_propagate
Boolean. When set to
False
for thepasswd
orgroup
service, then the.byname
requests are not added topasswd.byuid
orgroup.bygid
cache. This may help for tables containing multiple records for the sameid
value.