]>
Commit | Line | Data |
---|---|---|
fea681da MK |
1 | .\" Copyright 1999 SuSE GmbH Nuernberg, Germany |
2 | .\" Author: Thorsten Kukuk <kukuk@suse.de> | |
3 | .\" | |
f0008367 | 4 | .\" %%%LICENSE_START(GPLv2+_SW_3_PARA) |
fea681da MK |
5 | .\" This program is free software; you can redistribute it and/or |
6 | .\" modify it under the terms of the GNU General Public License as | |
7 | .\" published by the Free Software Foundation; either version 2 of the | |
8 | .\" License, or (at your option) any later version. | |
9 | .\" | |
10 | .\" This program is distributed in the hope that it will be useful, | |
11 | .\" but WITHOUT ANY WARRANTY; without even the implied warranty of | |
12 | .\" MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the GNU | |
13 | .\" General Public License for more details. | |
14 | .\" | |
15 | .\" You should have received a copy of the GNU General Public | |
c715f741 MK |
16 | .\" License along with this manual; if not, see |
17 | .\" <http://www.gnu.org/licenses/>. | |
8ff7380d | 18 | .\" %%%LICENSE_END |
fea681da | 19 | .\" |
ac7302a6 PB |
20 | .\" 2008-12-05 Petr Baudis <pasky@suse.cz> |
21 | .\" Rewrite the NOTES section to reflect modern reality | |
22 | .\" | |
67d2c687 | 23 | .TH NSCD 8 2015-05-07 "GNU" "Linux Programmer's Manual" |
fea681da | 24 | .SH NAME |
3c6d314a | 25 | nscd \- name service cache daemon |
fea681da | 26 | .SH DESCRIPTION |
4ba752a1 MK |
27 | .B nscd |
28 | is a daemon that provides a cache for the most common name service | |
c13182ef MK |
29 | requests. |
30 | The default configuration file, | |
fea681da | 31 | .IR /etc/nscd.conf , |
c13182ef MK |
32 | determines the behavior of the cache daemon. |
33 | See | |
fea681da | 34 | .BR nscd.conf (5). |
2dad4c59 | 35 | .PP |
4ba752a1 MK |
36 | .B nscd |
37 | provides caching for accesses of the | |
fea681da MK |
38 | .BR passwd (5), |
39 | .BR group (5), | |
a7e1c01a | 40 | .BR hosts (5) |
c0293ab6 | 41 | .BR services (5) |
d9b0993a MK |
42 | and |
43 | .I netgroup | |
fea681da MK |
44 | databases through standard libc interfaces, such as |
45 | .BR getpwnam (3), | |
46 | .BR getpwuid (3), | |
47 | .BR getgrnam (3), | |
48 | .BR getgrgid (3), | |
49 | .BR gethostbyname (3), | |
50 | and others. | |
2dad4c59 | 51 | .PP |
fea681da MK |
52 | There are two caches for each database: |
53 | a positive one for items found, and a negative one | |
c13182ef MK |
54 | for items not found. |
55 | Each cache has a separate TTL (time-to-live) | |
fea681da MK |
56 | period for its data. |
57 | Note that the shadow file is specifically not cached. | |
58 | .BR getspnam (3) | |
59 | calls remain uncached as a result. | |
fea681da MK |
60 | .SH OPTIONS |
61 | .TP | |
62 | .B "\-\-help" | |
63 | will give you a list with all options and what they do. | |
fea681da | 64 | .SH NOTES |
ac7302a6 | 65 | The daemon will try to watch for changes in configuration files |
15079abb | 66 | appropriate for each database (e.g., |
ac7302a6 PB |
67 | .I /etc/passwd |
68 | for the | |
69 | .I passwd | |
70 | database or | |
68aeaa00 SV |
71 | .I /etc/hosts |
72 | and | |
73 | .I /etc/resolv.conf | |
ac7302a6 PB |
74 | for the |
75 | .I hosts | |
76 | database), and flush the cache when these are changed. | |
77 | However, this will happen only after a short delay (unless the | |
78 | .BR inotify (7) | |
79 | mechanism is available and glibc 2.9 or later is available), | |
80 | and this auto-detection does not cover configuration files | |
c8f2dd47 | 81 | required by nonstandard NSS modules, if any are specified in |
ac7302a6 PB |
82 | .IR /etc/nsswitch.conf . |
83 | In that case, you need to run the following command | |
84 | after changing the configuration file of the database so that | |
85 | .B nscd | |
86 | invalidates its cache: | |
019d9ee8 MK |
87 | .PP |
88 | .in +4n | |
89 | .EX | |
90 | $ \fBnscd -i\fP \fI<database>\fP | |
91 | .EE | |
92 | .in | |
47297adb | 93 | .SH SEE ALSO |
fea681da MK |
94 | .BR nscd.conf (5), |
95 | .BR nsswitch.conf (5) | |
fd7f0a7f MK |
96 | .\" .SH AUTHOR |
97 | .\" .B nscd | |
98 | .\" was written by Thorsten Kukuk and Ulrich Drepper. |