Penguin
Recent Changes
Blame: nscd.conf(5)
EditPageHistoryDiffInfoLikePages
Annotated edit history of nscd.conf(5) version 1, including all changes. View license author blame.
Rev Author # Line
1 perry 1 NSCD.CONF
2 !!!NSCD.CONF
3 NAME
4 DESCRIPTION
5 GENERAL OPTIONS
6 CACHE OPTIONS
7 EXAMPLE
8 SEE ALSO
9 ----
10 !!NAME
11
12
13 nscd.conf - configuration file for Name Service Caching Daemon
14 !!DESCRIPTION
15
16
17 The caches nscd(8) uses as well as some generic
18 options can be configured in
19 ''/etc/nscd.conf''.
20
21
22 The configuration file consists of a set of lines. All empty
23 lines, and all text on a line after a '#', will be ignored.
24 All remaining lines denote the setting of an option. There
25 are two kinds of options: General options influence
26 nscd(8)'s general behaviour, while cache options only
27 affect the named cache. Options are set like
28 this:
29
30
31 general_option option
32 cache_option cache_name option
33 !!GENERAL OPTIONS
34
35
36 __logfile__ ''file''
37
38
39 Specifies the name of the debug log-file that nscd(8)
40 should use if __debug-level__ is higher than __0__. If
41 this option is not set, nscd(8) will write its debug
42 output to stderr.
43
44
45 __debug-level__ ''level''
46
47
48 If ''level'' is higher than __0__, nscd(8) will
49 create some debug output. The higher the level, the more
50 output that is produced.
51
52
53 __threads__ ''#threads''
54
55
56 This option sets the number of threads that nscd(8)
57 should use by default. It can be overridden by calling
58 nscd(8) with the ''-t'' or ''--nthreads''
59 argument. If neither this configuration option nor the
60 command line argument is given, nscd(8) uses 5
61 threads by default. The minimum is 3. More threads means
62 more simultaneous connections that nscd(8) can
63 handle.
64
65
66 __server-user__ ''user''
67
68
69 By default, nscd(8) is run as user root. This option
70 can be set to force nscd(8) to drop root privileges
71 after startup. It cannot be used when nscd(8) is
72 called with the ''-S'' or ''--secure'' argument. Also
73 note that some services require that nscd run as root, so
74 using this may break those lookup services.
75 !!CACHE OPTIONS
76
77
78 All cache options take two arguments, the first one denoting
79 the service or cache the options is going to affect.
80 Currently ''service'' can be one of __passwd__,
81 __group__ or __hosts__.
82
83
84 __enable-cache__ ''service bool''
85
86
87 ''bool'' must be one of __yes__ or __no__. Each
88 cache is disabled by default and must be enabled explicitly
89 by setting this options to __yes__.
90
91
92 __positive-time-to-live__ ''service
93 secs''
94
95
96 This is the number of seconds after which a cached entry is
97 removed from the cache. This defaults to 3600 seconds (i. e.
98 one hour).
99
100
101 __negative-time-to-live__ ''service
102 secs''
103
104
105 If an entry is not found by the Name Service, it is added to
106 the cache and marked as
107 password__ and __host__ cache and
108 to 60 seconds for the __group__ cache.
109
110
111 __suggested-size__ ''service
112 prime-number''
113
114
115 This option sets the size of the hash that is used to store
116 the cache entries. As this is a hash, it should be
117 reasonably larger than the maximum number of entries that is
118 expected to be cached simultaneously and should be a prime
119 number. It defaults to a size of 211 entries.
120
121
122 __check-files__ ''service bool''
123
124
125 ''bool'' must be one of __yes__ (default) or
126 __no__. If file checking is enabled, nscd(8)
127 periodically checks the modification time of
128 ''/etc/passwd'', ''/etc/group'', or ''/etc/hosts''
129 (for the __passwd__, __group__, and __host__ cache
130 respectively) and invalidates the cache if the file has
131 changed since the last check.
132 !!EXAMPLE
133
134
135 # This is a comment.
136 logfile /var/log/nscd.log
137 threads 6
138 server-user nobody
139 debug-level 0
140 enable-cache passwd yes
141 positive-time-to-live passwd 600
142 negative-time-to-live passwd 20
143 suggested-size passwd 211
144 check-files passwd yes
145 enable-cache group yes
146 positive-time-to-live group 3600
147 negative-time-to-live group 60
148 suggested-size group 211
149 check-files group yes
150 enable-cache hosts yes
151 positive-time-to-live hosts 3600
152 negative-time-to-live hosts 20
153 suggested-size hosts 211
154 check-files hosts yes
155 !!SEE ALSO
156
157
158 nscd(8), nsswitch.conf(5)
159 ----
This page is a man page (or other imported legacy content). We are unable to automatically determine the license status of this page.