nscd.conf(4)

1nscd.conf(4)                     File Formats                     nscd.conf(4)
2
3
4

NAME

6       nscd.conf - name service cache daemon configuration
7

SYNOPSIS

9       /etc/nscd.conf
10
11

DESCRIPTION

13       The nscd.conf file contains the configuration information for nscd(1M).
14       Each line specifies either an attribute and a value, or  an  attribute,
15       cachename,  and  a  value.  Fields are separated either by SPACE or TAB
16       characters. A `#' (number sign) indicates the beginning of  a  comment;
17       characters up to the end of the line are not interpreted by nscd.
18
19
20       cachename  is  represented by hosts, ipnodes, passwd, group, exec_attr,
21       prof_attr, user_attr, ethers,  rpc,  protocols,  networks,  bootparams,
22       audit_user, auth_attr, services, netmasks, printers, or project.
23
24
25       The attribute field supports the following:
26
27       check-files cachename value
28
29           Enables  or  disables  checking the file belonging to the specified
30           cachename for changes. If enabled (which is the  default),  changes
31           in  the corresponding file cause the cache to be invalidated within
32           10 seconds. Can be disabled if  files  are  never  modified  for  a
33           slight  performance  boost,  particularly  over  NFS.  value may be
34           either yes or no.
35
36
37       debug-level value
38
39           Sets the debug level desired. value may range from 0 (the  default)
40           to  10. Use of this option causes nscd(1M) to run in the foreground
41           and not become a daemon. Note that the output of the debugging com‐
42           mand  is  not  likely  to  remain the same from release-to-release;
43           scripts should not rely on its format.
44
45
46       enable-cache cachename value
47
48           Enables or disables the specified cache. value may be either yes or
49           no.
50
51
52       enable-per-user-lookup value
53
54           Enables  or disables the ability of nscd to create a per-user nscd.
55           A per-user nscd performs per-user lookups and manages the  per-user
56           cache.  The  per-user  lookups  might not be possible if the corre‐
57           sponding name service switch backends do not support it or are  not
58           configured  to do so. The value of this attribute can be either yes
59           or no.
60
61
62       keep-hot-count cachename value
63
64           This attribute allows  the  administrator  to  set  the  number  of
65           entries  nscd(1M)  is to keep current in the specified cache. value
66           is an integer number which should approximate the number of entries
67           frequently used during the day.
68
69
70       logfile debug-file-name
71
72           Specifies  name  of the file to which debug info should be written.
73           Use /dev/tty for standard output.
74
75
76       maximum-per-user-nscd value
77
78           Sets the maximum number of per-user nscds that can be  created  and
79           managed by the main nscd daemon. The value is an integer.
80
81
82       negative-time-to-live cachename value
83
84           Sets  the  time-to-live for negative entries (unsuccessful queries)
85           in the specified cache. value is in integer seconds. Can result  in
86           significant  performance  improvements  if  there are several files
87           owned by uids (user IDs) not in system databases;  should  be  kept
88           small to reduce cache coherency problems.
89
90
91       per-user-nscd-time-to-live value
92
93           Sets  the  time-to-live value for a per-user nscd based on the last
94           time the per-user nscd was active. The value  is  an  integer  that
95           specifies a number of seconds.
96
97
98       positive-time-to-live cachename value
99
100           Sets  the time-to-live for positive entries (successful queries) in
101           the specified cache. value is in  integer  seconds.  Larger  values
102           increase  cache  hit  rates  and  reduce  mean  response times, but
103           increase problems with cache coherence. Note that sites  that  push
104           (update) NIS maps nightly can set the value to be the equivalent of
105           12 hours or more with very good performance implications.
106
107
108       suggested-size cachename value
109
110           Sets the suggested number of hash buckets in the  specified  cache.
111           This  parameter  should be changed only if the number of entries in
112           the cache exceeds the suggested size by more than a factor of  four
113           or  five.  Since this is the internal hash table size, value should
114           remain a prime number for optimum efficiency.
115
116           This attribute is obsolete and will be silently ignored.  nscd  now
117           automatically adjusts the hash table size.
118
119

ATTRIBUTES

121       See attributes(5) for descriptions of the following attributes:
122
123
124
125
126       ┌─────────────────────────────┬─────────────────────────────┐
127       │      ATTRIBUTE TYPE         │      ATTRIBUTE VALUE        │
128       ├─────────────────────────────┼─────────────────────────────┤
129       │Availibility                 │SUNWcsu                      │
130       ├─────────────────────────────┼─────────────────────────────┤
131       │Interface Stability          │Committed                    │
132       └─────────────────────────────┴─────────────────────────────┘
133

NAME

SYNOPSIS

DESCRIPTION

ATTRIBUTES

SEE ALSO