Debian Codegraph @

upstream/fedora-44/man8/nscd.8

raw
1 .\" Copyright 1999 SuSE GmbH Nuernberg, Germany
2 .\" Author: Thorsten Kukuk <[email protected]>
3 .\"
4 .\" SPDX-License-Identifier: GPL-2.0-or-later
5 .\"
6 .\" 2008-12-05 Petr Baudis <[email protected]>
7 .\" Rewrite the NOTES section to reflect modern reality
8 .\"
9 .TH nscd 8 2024-05-02 "Linux man-pages 6.13"
10 .SH NAME
11 nscd \- name service cache daemon
12 .SH DESCRIPTION
13 .B nscd
14 is a daemon that provides a cache for the most common name service
15 requests.
16 The default configuration file,
17 .IR /etc/nscd.conf ,
18 determines the behavior of the cache daemon.
19 See
20 .BR nscd.conf (5).
21 .P
22 .B nscd
23 provides caching for accesses of the
24 .BR passwd (5),
25 .BR group (5),
26 .BR hosts (5)
27 .BR services (5)
28 and
29 .I netgroup
30 databases through standard libc interfaces, such as
31 .BR getpwnam (3),
32 .BR getpwuid (3),
33 .BR getgrnam (3),
34 .BR getgrgid (3),
35 .BR gethostbyname (3),
36 and others.
37 .P
38 There are two caches for each database:
39 a positive one for items found, and a negative one
40 for items not found.
41 Each cache has a separate TTL (time-to-live)
42 period for its data.
43 Note that the shadow file is specifically not cached.
44 .BR getspnam (3)
45 calls remain uncached as a result.
46 .SH OPTIONS
47 .TP
48 .B "\-\-help"
49 will give you a list with all options and what they do.
50 .SH NOTES
51 The daemon will try to watch for changes in configuration files
52 appropriate for each database (e.g.,
53 .I /etc/passwd
54 for the
55 .I passwd
56 database or
57 .I /etc/hosts
58 and
59 .I /etc/resolv.conf
60 for the
61 .I hosts
62 database), and flush the cache when these are changed.
63 However, this will happen only after a short delay (unless the
64 .BR inotify (7)
65 mechanism is available and glibc 2.9 or later is available),
66 and this auto-detection does not cover configuration files
67 required by nonstandard NSS modules, if any are specified in
68 .IR /etc/nsswitch.conf .
69 In that case, you need to run the following command
70 after changing the configuration file of the database so that
71 .B nscd
72 invalidates its cache:
73 .P
74 .in +4n
75 .EX
76 $ \fBnscd \-i\fP \fI<database>\fP
77 .EE
78 .in
79 .SH SEE ALSO
80 .BR nscd.conf (5),
81 .BR nsswitch.conf (5)
82 .\" .SH AUTHOR
83 .\" .B nscd
84 .\" was written by Thorsten Kukuk and Ulrich Drepper.