projects / thirdparty / man-pages.git / blame
| Commit | Line | Data |
|---|---|---|
| fea681da MK |
1 | .\" Copyright 1999 SuSE GmbH Nuernberg, Germany |
| 2 | .\" Author: Thorsten Kukuk <kukuk@suse.de> | |
| 3 | .\" | |
| e4a74ca8 | 4 | .\" SPDX-License-Identifier: GPL-2.0-or-later |
| fea681da | 5 | .\" |
| ac7302a6 PB |
6 | .\" 2008-12-05 Petr Baudis <pasky@suse.cz> |
| 7 | .\" Rewrite the NOTES section to reflect modern reality | |
| 8 | .\" | |
| 45186a5d | 9 | .TH NSCD 8 2015-05-07 "Linux man-pages (unreleased)" |
| fea681da | 10 | .SH NAME |
| 3c6d314a | 11 | nscd \- name service cache daemon |
| fea681da | 12 | .SH DESCRIPTION |
| 4ba752a1 MK |
13 | .B nscd |
| 14 | is a daemon that provides a cache for the most common name service | |
| c13182ef MK |
15 | requests. |
| 16 | The default configuration file, | |
| fea681da | 17 | .IR /etc/nscd.conf , |
| c13182ef MK |
18 | determines the behavior of the cache daemon. |
| 19 | See | |
| fea681da | 20 | .BR nscd.conf (5). |
| 2dad4c59 | 21 | .PP |
| 4ba752a1 MK |
22 | .B nscd |
| 23 | provides caching for accesses of the | |
| fea681da MK |
24 | .BR passwd (5), |
| 25 | .BR group (5), | |
| a7e1c01a | 26 | .BR hosts (5) |
| c0293ab6 | 27 | .BR services (5) |
| d9b0993a MK |
28 | and |
| 29 | .I netgroup | |
| fea681da MK |
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. | |
| 2dad4c59 | 37 | .PP |
| fea681da MK |
38 | There are two caches for each database: |
| 39 | a positive one for items found, and a negative one | |
| c13182ef MK |
40 | for items not found. |
| 41 | Each cache has a separate TTL (time-to-live) | |
| fea681da MK |
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. | |
| fea681da MK |
46 | .SH OPTIONS |
| 47 | .TP | |
| 48 | .B "\-\-help" | |
| 49 | will give you a list with all options and what they do. | |
| fea681da | 50 | .SH NOTES |
| ac7302a6 | 51 | The daemon will try to watch for changes in configuration files |
| 15079abb | 52 | appropriate for each database (e.g., |
| ac7302a6 PB |
53 | .I /etc/passwd |
| 54 | for the | |
| 55 | .I passwd | |
| 56 | database or | |
| 68aeaa00 SV |
57 | .I /etc/hosts |
| 58 | and | |
| 59 | .I /etc/resolv.conf | |
| ac7302a6 PB |
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 | |
| c8f2dd47 | 67 | required by nonstandard NSS modules, if any are specified in |
| ac7302a6 PB |
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: | |
| 019d9ee8 MK |
73 | .PP |
| 74 | .in +4n | |
| 75 | .EX | |
| f764b455 | 76 | $ \fBnscd \-i\fP \fI<database>\fP |
| 019d9ee8 MK |
77 | .EE |
| 78 | .in | |
| 47297adb | 79 | .SH SEE ALSO |
| fea681da MK |
80 | .BR nscd.conf (5), |
| 81 | .BR nsswitch.conf (5) | |
| fd7f0a7f MK |
82 | .\" .SH AUTHOR |
| 83 | .\" .B nscd | |
| 84 | .\" was written by Thorsten Kukuk and Ulrich Drepper. |