1/* Copyright (c) 1998-2022 Free Software Foundation, Inc.
2 This file is part of the GNU C Library.
3
4 The GNU C Library is free software; you can redistribute it and/or
5 modify it under the terms of the GNU Lesser General Public
6 License as published by the Free Software Foundation; either
7 version 2.1 of the License, or (at your option) any later version.
8
9 The GNU C Library is distributed in the hope that it will be useful,
10 but WITHOUT ANY WARRANTY; without even the implied warranty of
11 MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the GNU
12 Lesser General Public License for more details.
13
14 You should have received a copy of the GNU Lesser General Public
15 License along with the GNU C Library; if not, see
16 <https://www.gnu.org/licenses/>. */
17
18#ifndef _NSCD_H
19#define _NSCD_H 1
20
21#include <pthread.h>
22#include <stdbool.h>
23#include <time.h>
24#include <sys/uio.h>
25
26/* The declarations for the request and response types are in the file
27 "nscd-client.h", which should contain everything needed by client
28 functions. */
29#include "nscd-client.h"
30
31
32/* Handle databases. */
33typedef enum
34{
35 pwddb,
36 grpdb,
37 hstdb,
38 servdb,
39 netgrdb,
40 lastdb
41} dbtype;
42
43
44/* Default limit on the number of times a value gets reloaded without
45 being used in the meantime. NSCD does not throw a value out as
46 soon as it times out. It tries to reload the value from the
47 server. Only if the value has not been used for so many rounds it
48 is removed. */
49#define DEFAULT_RELOAD_LIMIT 5
50
51
52/* Time before restarting the process in paranoia mode. */
53#define RESTART_INTERVAL (60 * 60)
54
55
56/* Stack size for worker threads. */
57#define NSCD_THREAD_STACKSIZE 1024 * 1024 * (sizeof (void *) / 4)
58
59/* Maximum size of stack frames we allow the thread to use. We use
60 80% of the thread stack size. */
61#define MAX_STACK_USE ((8 * NSCD_THREAD_STACKSIZE) / 10)
62
63/* Records the file registered per database that when changed
64 or modified requires invalidating the database. */
65struct traced_file
66{
67 /* Tracks the last modified time of the traced file. */
68 __time64_t mtime;
69 /* Support multiple registered files per database. */
70 struct traced_file *next;
71 int call_res_init;
72 /* Requires Inotify support to do anything useful. */
73#define TRACED_FILE 0
74#define TRACED_DIR 1
75 int inotify_descr[2];
76# ifndef PATH_MAX
77# define PATH_MAX 1024
78# endif
79 /* The parent directory is used to scan for creation/deletion. */
80 char dname[PATH_MAX];
81 /* Just the name of the file with no directory component. */
82 char *sfname;
83 /* The full-path name of the registered file. */
84 char fname[];
85};
86
87/* Initialize a `struct traced_file`. As input we need the name
88 of the file, and if invalidation requires calling res_init.
89 If CRINIT is 1 then res_init will be called after invalidation
90 or if the traced file is changed in any way, otherwise it will
91 not. */
92static inline void
93init_traced_file(struct traced_file *file, const char *fname, int crinit)
94{
95 char *dname;
96 file->mtime = 0;
97 file->inotify_descr[TRACED_FILE] = -1;
98 file->inotify_descr[TRACED_DIR] = -1;
99 strcpy (dest: file->fname, src: fname);
100 /* Compute the parent directory name and store a copy. The copy makes
101 it much faster to add/remove watches while nscd is running instead
102 of computing this over and over again in a temp buffer. */
103 file->dname[0] = '\0';
104 dname = strrchr (s: fname, c: '/');
105 if (dname != NULL)
106 {
107 size_t len = (size_t)(dname - fname);
108 if (len > sizeof (file->dname))
109 abort ();
110 memcpy (dest: file->dname, src: file->fname, len: len);
111 file->dname[len] = '\0';
112 }
113 /* The basename is the name just after the last forward slash. */
114 file->sfname = &dname[1];
115 file->call_res_init = crinit;
116}
117
118#define define_traced_file(id, filename) \
119static union \
120{ \
121 struct traced_file file; \
122 char buf[sizeof (struct traced_file) + sizeof (filename)]; \
123} id##_traced_file;
124
125/* Structure describing dynamic part of one database. */
126struct database_dyn
127{
128 pthread_rwlock_t lock;
129 pthread_cond_t prune_cond;
130 pthread_mutex_t prune_lock;
131 pthread_mutex_t prune_run_lock;
132 time_t wakeup_time;
133
134 int enabled;
135 int check_file;
136 int clear_cache;
137 int persistent;
138 int shared;
139 int propagate;
140 struct traced_file *traced_files;
141 const char *db_filename;
142 size_t suggested_module;
143 size_t max_db_size;
144
145 unsigned long int postimeout; /* In seconds. */
146 unsigned long int negtimeout; /* In seconds. */
147
148 int wr_fd; /* Writable file descriptor. */
149 int ro_fd; /* Unwritable file descriptor. */
150
151 const struct iovec *disabled_iov;
152
153 struct database_pers_head *head;
154 char *data;
155 size_t memsize;
156 pthread_mutex_t memlock;
157 bool mmap_used;
158 bool last_alloc_failed;
159};
160
161
162/* Paths of the file for the persistent storage. */
163#define _PATH_NSCD_PASSWD_DB "/var/db/nscd/passwd"
164#define _PATH_NSCD_GROUP_DB "/var/db/nscd/group"
165#define _PATH_NSCD_HOSTS_DB "/var/db/nscd/hosts"
166#define _PATH_NSCD_SERVICES_DB "/var/db/nscd/services"
167#define _PATH_NSCD_NETGROUP_DB "/var/db/nscd/netgroup"
168
169/* Path used when not using persistent storage. */
170#define _PATH_NSCD_XYZ_DB_TMP "/var/run/nscd/dbXXXXXX"
171
172/* Maximum alignment requirement we will encounter. */
173#define BLOCK_ALIGN_LOG 3
174#define BLOCK_ALIGN (1 << BLOCK_ALIGN_LOG)
175#define BLOCK_ALIGN_M1 (BLOCK_ALIGN - 1)
176
177/* Default value for the maximum size of the database files. */
178#define DEFAULT_MAX_DB_SIZE (32 * 1024 * 1024)
179
180/* Number of bytes of data we initially reserve for each hash table bucket. */
181#define DEFAULT_DATASIZE_PER_BUCKET 1024
182
183/* Default module of hash table. */
184#define DEFAULT_SUGGESTED_MODULE 211
185
186
187/* Number of seconds between two cache pruning runs if we do not have
188 better information when it is really needed. */
189#define CACHE_PRUNE_INTERVAL 15
190
191
192/* Global variables. */
193extern struct database_dyn dbs[lastdb] attribute_hidden;
194extern const char *const dbnames[lastdb];
195extern const char *const serv2str[LASTREQ];
196
197extern const struct iovec pwd_iov_disabled;
198extern const struct iovec grp_iov_disabled;
199extern const struct iovec hst_iov_disabled;
200extern const struct iovec serv_iov_disabled;
201extern const struct iovec netgroup_iov_disabled;
202
203
204/* Initial number of threads to run. */
205extern int nthreads;
206/* Maximum number of threads to use. */
207extern int max_nthreads;
208
209/* Inotify descriptor. */
210extern int inotify_fd;
211
212/* User name to run server processes as. */
213extern const char *server_user;
214
215/* Name and UID of user who is allowed to request statistics. */
216extern const char *stat_user;
217extern uid_t stat_uid;
218
219/* Time the server was started. */
220extern time_t start_time;
221
222/* Number of times clients had to wait. */
223extern unsigned long int client_queued;
224
225/* Maximum needed alignment. */
226extern const size_t block_align;
227
228/* Number of times a value is reloaded without being used. UINT_MAX
229 means unlimited. */
230extern unsigned int reload_count;
231
232/* Pagesize minus one. */
233extern uintptr_t pagesize_m1;
234
235/* Nonzero if paranoia mode is enabled. */
236extern int paranoia;
237/* Time after which the process restarts. */
238extern time_t restart_time;
239/* How much time between restarts. */
240extern time_t restart_interval;
241/* Old current working directory. */
242extern const char *oldcwd;
243/* Old user and group ID. */
244extern uid_t old_uid;
245extern gid_t old_gid;
246
247
248/* Prototypes for global functions. */
249
250/* Wrapper functions with error checking for standard functions. */
251#include <programs/xmalloc.h>
252
253/* nscd.c */
254extern void termination_handler (int signum) __attribute__ ((__noreturn__));
255extern int nscd_open_socket (void);
256void notify_parent (int child_ret);
257void do_exit (int child_ret, int errnum, const char *format, ...);
258
259/* connections.c */
260extern void nscd_init (void);
261extern void register_traced_file (size_t dbidx, struct traced_file *finfo);
262#ifdef HAVE_INOTIFY
263extern void install_watches (struct traced_file *finfo);
264#endif
265extern void close_sockets (void);
266extern void start_threads (void) __attribute__ ((__noreturn__));
267
268/* nscd_conf.c */
269extern int nscd_parse_file (const char *fname,
270 struct database_dyn dbs[lastdb]);
271
272/* nscd_stat.c */
273extern void send_stats (int fd, struct database_dyn dbs[lastdb]);
274extern int receive_print_stats (void) __attribute__ ((__noreturn__));
275
276/* cache.c */
277extern struct datahead *cache_search (request_type, const void *key,
278 size_t len, struct database_dyn *table,
279 uid_t owner);
280extern int cache_add (int type, const void *key, size_t len,
281 struct datahead *packet, bool first,
282 struct database_dyn *table, uid_t owner,
283 bool prune_wakeup);
284extern time_t prune_cache (struct database_dyn *table, time_t now, int fd);
285
286/* pwdcache.c */
287extern void addpwbyname (struct database_dyn *db, int fd, request_header *req,
288 void *key, uid_t uid);
289extern void addpwbyuid (struct database_dyn *db, int fd, request_header *req,
290 void *key, uid_t uid);
291extern time_t readdpwbyname (struct database_dyn *db, struct hashentry *he,
292 struct datahead *dh);
293extern time_t readdpwbyuid (struct database_dyn *db, struct hashentry *he,
294 struct datahead *dh);
295
296/* grpcache.c */
297extern void addgrbyname (struct database_dyn *db, int fd, request_header *req,
298 void *key, uid_t uid);
299extern void addgrbygid (struct database_dyn *db, int fd, request_header *req,
300 void *key, uid_t uid);
301extern time_t readdgrbyname (struct database_dyn *db, struct hashentry *he,
302 struct datahead *dh);
303extern time_t readdgrbygid (struct database_dyn *db, struct hashentry *he,
304 struct datahead *dh);
305
306/* hstcache.c */
307extern void addhstbyname (struct database_dyn *db, int fd, request_header *req,
308 void *key, uid_t uid);
309extern void addhstbyaddr (struct database_dyn *db, int fd, request_header *req,
310 void *key, uid_t uid);
311extern void addhstbynamev6 (struct database_dyn *db, int fd,
312 request_header *req, void *key, uid_t uid);
313extern void addhstbyaddrv6 (struct database_dyn *db, int fd,
314 request_header *req, void *key, uid_t uid);
315extern time_t readdhstbyname (struct database_dyn *db, struct hashentry *he,
316 struct datahead *dh);
317extern time_t readdhstbyaddr (struct database_dyn *db, struct hashentry *he,
318 struct datahead *dh);
319extern time_t readdhstbynamev6 (struct database_dyn *db, struct hashentry *he,
320 struct datahead *dh);
321extern time_t readdhstbyaddrv6 (struct database_dyn *db, struct hashentry *he,
322 struct datahead *dh);
323
324/* aicache.c */
325extern void addhstai (struct database_dyn *db, int fd, request_header *req,
326 void *key, uid_t uid);
327extern time_t readdhstai (struct database_dyn *db, struct hashentry *he,
328 struct datahead *dh);
329
330
331/* initgrcache.c */
332extern void addinitgroups (struct database_dyn *db, int fd,
333 request_header *req, void *key, uid_t uid);
334extern time_t readdinitgroups (struct database_dyn *db, struct hashentry *he,
335 struct datahead *dh);
336
337/* servicecache.c */
338extern void addservbyname (struct database_dyn *db, int fd,
339 request_header *req, void *key, uid_t uid);
340extern time_t readdservbyname (struct database_dyn *db, struct hashentry *he,
341 struct datahead *dh);
342extern void addservbyport (struct database_dyn *db, int fd,
343 request_header *req, void *key, uid_t uid);
344extern time_t readdservbyport (struct database_dyn *db, struct hashentry *he,
345 struct datahead *dh);
346
347/* netgroupcache.c */
348extern void addinnetgr (struct database_dyn *db, int fd, request_header *req,
349 void *key, uid_t uid);
350extern time_t readdinnetgr (struct database_dyn *db, struct hashentry *he,
351 struct datahead *dh);
352extern void addgetnetgrent (struct database_dyn *db, int fd,
353 request_header *req, void *key, uid_t uid);
354extern time_t readdgetnetgrent (struct database_dyn *db, struct hashentry *he,
355 struct datahead *dh);
356
357/* mem.c */
358extern void *mempool_alloc (struct database_dyn *db, size_t len,
359 int data_alloc);
360extern void gc (struct database_dyn *db);
361
362
363/* nscd_setup_thread.c */
364extern int setup_thread (struct database_dyn *db);
365
366/* cachedumper.c */
367extern void nscd_print_cache (const char *name);
368
369/* Special version of TEMP_FAILURE_RETRY for functions returning error
370 values. */
371#define TEMP_FAILURE_RETRY_VAL(expression) \
372 (__extension__ \
373 ({ long int __result; \
374 do __result = (long int) (expression); \
375 while (__result == EINTR); \
376 __result; }))
377
378#endif /* nscd.h */
379

source code of glibc/nscd/nscd.h