Improve the options info a bit more.
[rsync.git] / loadparm.c
blobdfc0b07780dc9b801ab43ce87129f7fae7d17f2a
1 /*
2 * This program is free software; you can redistribute it and/or modify
3 * it under the terms of the GNU General Public License as published by
4 * the Free Software Foundation; either version 3 of the License, or
5 * (at your option) any later version.
7 * This program is distributed in the hope that it will be useful,
8 * but WITHOUT ANY WARRANTY; without even the implied warranty of
9 * MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the
10 * GNU General Public License for more details.
12 * You should have received a copy of the GNU General Public License along
13 * with this program; if not, visit the http://fsf.org website.
15 * This is based on loadparm.c from Samba, written by Andrew Tridgell
16 * and Karl Auer. Some of the changes are:
18 * Copyright (C) 2001, 2002 Martin Pool <mbp@samba.org>
19 * Copyright (C) 2003-2020 Wayne Davison
22 /* Load parameters.
24 * This module provides suitable callback functions for the params
25 * module. It builds the internal table of section details which is
26 * then used by the rest of the server.
28 * To add a parameter:
30 * 1) add it to the global_vars or local_vars structure definition
31 * 2) add it to the parm_table
32 * 3) add it to the list of available functions (eg: using FN_GLOBAL_STRING())
33 * 4) initialise it in the Defaults static structure
35 * Notes:
36 * The configuration file is processed sequentially for speed. For this
37 * reason, there is a fair bit of sequence-dependent code here - ie., code
38 * which assumes that certain things happen before others. In particular, the
39 * code which happens at the boundary between sections is delicately poised,
40 * so be careful!
43 #include "rsync.h"
44 #include "itypes.h"
45 #include "default-dont-compress.h"
47 extern item_list dparam_list;
49 #define strequal(a, b) (strcasecmp(a, b)==0)
50 #define BOOLSTR(b) ((b) ? "Yes" : "No")
52 #ifndef LOG_DAEMON
53 #define LOG_DAEMON 0
54 #endif
56 /* the following are used by loadparm for option lists */
57 typedef enum {
58 P_BOOL, P_BOOLREV, P_CHAR, P_INTEGER,
59 P_OCTAL, P_PATH, P_STRING, P_ENUM
60 } parm_type;
62 typedef enum {
63 P_LOCAL, P_GLOBAL, P_NONE
64 } parm_class;
66 struct enum_list {
67 int value;
68 char *name;
71 struct parm_struct {
72 char *label;
73 parm_type type;
74 parm_class class;
75 void *ptr;
76 struct enum_list *enum_list;
77 unsigned flags;
80 #ifndef GLOBAL_NAME
81 #define GLOBAL_NAME "global"
82 #endif
84 /* some helpful bits */
85 #define iSECTION(i) ((local_vars*)section_list.items)[i]
86 #define LP_SNUM_OK(i) ((i) >= 0 && (i) < (int)section_list.count)
87 #define SECTION_PTR(s, p) (((char*)(s)) + (ptrdiff_t)(((char*)(p))-(char*)&Vars.l))
89 /* This structure describes global (ie., server-wide) parameters. */
90 typedef struct {
91 char *bind_address;
92 char *daemon_chroot;
93 char *daemon_gid;
94 char *daemon_uid;
95 char *motd_file;
96 char *pid_file;
97 char *socket_options;
99 /* Each _EXP var tracks if the associated char* var has been expanded yet or not. */
100 BOOL bind_address_EXP;
101 BOOL daemon_chroot_EXP;
102 BOOL daemon_gid_EXP;
103 BOOL daemon_uid_EXP;
104 BOOL motd_file_EXP;
105 BOOL pid_file_EXP;
106 BOOL socket_options_EXP;
108 int listen_backlog;
109 int rsync_port;
111 BOOL proxy_protocol;
112 } global_vars;
114 /* This structure describes a single section. Their order must match the
115 * initializers below, which you can accomplish by keeping each sub-section
116 * sorted. (e.g. in vim, just visually select each subsection and use !sort.)
117 * NOTE: the char* variables MUST all remain at the start of the struct! */
118 typedef struct {
119 char *auth_users;
120 char *charset;
121 char *comment;
122 char *dont_compress;
123 char *early_exec;
124 char *exclude;
125 char *exclude_from;
126 char *filter;
127 char *gid;
128 char *hosts_allow;
129 char *hosts_deny;
130 char *include;
131 char *include_from;
132 char *incoming_chmod;
133 char *lock_file;
134 char *log_file;
135 char *log_format;
136 char *name;
137 char *outgoing_chmod;
138 char *path;
139 char *postxfer_exec;
140 char *prexfer_exec;
141 char *refuse_options;
142 char *secrets_file;
143 char *syslog_tag;
144 char *temp_dir;
145 char *uid;
147 /* Each _EXP var tracks if the associated char* var has been expanded yet or not. */
148 BOOL auth_users_EXP;
149 BOOL charset_EXP;
150 BOOL comment_EXP;
151 BOOL dont_compress_EXP;
152 BOOL early_exec_EXP;
153 BOOL exclude_EXP;
154 BOOL exclude_from_EXP;
155 BOOL filter_EXP;
156 BOOL gid_EXP;
157 BOOL hosts_allow_EXP;
158 BOOL hosts_deny_EXP;
159 BOOL include_EXP;
160 BOOL include_from_EXP;
161 BOOL incoming_chmod_EXP;
162 BOOL lock_file_EXP;
163 BOOL log_file_EXP;
164 BOOL log_format_EXP;
165 BOOL name_EXP;
166 BOOL outgoing_chmod_EXP;
167 BOOL path_EXP;
168 BOOL postxfer_exec_EXP;
169 BOOL prexfer_exec_EXP;
170 BOOL refuse_options_EXP;
171 BOOL secrets_file_EXP;
172 BOOL syslog_tag_EXP;
173 BOOL temp_dir_EXP;
174 BOOL uid_EXP;
176 int max_connections;
177 int max_verbosity;
178 int syslog_facility;
179 int timeout;
181 BOOL fake_super;
182 BOOL forward_lookup;
183 BOOL ignore_errors;
184 BOOL ignore_nonreadable;
185 BOOL list;
186 BOOL munge_symlinks;
187 BOOL numeric_ids;
188 BOOL read_only;
189 BOOL reverse_lookup;
190 BOOL strict_modes;
191 BOOL transfer_logging;
192 BOOL use_chroot;
193 BOOL write_only;
194 } local_vars;
196 /* This structure describes the global variables (g) as well as the globally
197 * specified values of the local variables (l), which are used when modules
198 * don't specify their own values. */
199 typedef struct {
200 global_vars g;
201 local_vars l;
202 } all_vars;
204 /* The application defaults for all the variables. "Defaults" is
205 * used to re-initialize "Vars" before each config-file read.
207 * In order to keep these sorted in the same way as the structure
208 * above, use the variable name in the leading comment, including a
209 * trailing ';' (to avoid a sorting problem with trailing digits). */
210 static const all_vars Defaults = {
211 /* ==== global_vars ==== */
213 /* bind_address; */ NULL,
214 /* daemon_chroot; */ NULL,
215 /* daemon_gid; */ NULL,
216 /* daemon_uid; */ NULL,
217 /* motd_file; */ NULL,
218 /* pid_file; */ NULL,
219 /* socket_options; */ NULL,
221 /* bind_address_EXP; */ False,
222 /* daemon_chroot_EXP; */ False,
223 /* daemon_gid_EXP; */ False,
224 /* daemon_uid_EXP; */ False,
225 /* motd_file_EXP; */ False,
226 /* pid_file_EXP; */ False,
227 /* socket_options_EXP; */ False,
229 /* listen_backlog; */ 5,
230 /* rsync_port; */ 0,
232 /* proxy_protocol; */ False,
235 /* ==== local_vars ==== */
237 /* auth_users; */ NULL,
238 /* charset; */ NULL,
239 /* comment; */ NULL,
240 /* dont_compress; */ DEFAULT_DONT_COMPRESS,
241 /* early_exec; */ NULL,
242 /* exclude; */ NULL,
243 /* exclude_from; */ NULL,
244 /* filter; */ NULL,
245 /* gid; */ NULL,
246 /* hosts_allow; */ NULL,
247 /* hosts_deny; */ NULL,
248 /* include; */ NULL,
249 /* include_from; */ NULL,
250 /* incoming_chmod; */ NULL,
251 /* lock_file; */ DEFAULT_LOCK_FILE,
252 /* log_file; */ NULL,
253 /* log_format; */ "%o %h [%a] %m (%u) %f %l",
254 /* name; */ NULL,
255 /* outgoing_chmod; */ NULL,
256 /* path; */ NULL,
257 /* postxfer_exec; */ NULL,
258 /* prexfer_exec; */ NULL,
259 /* refuse_options; */ NULL,
260 /* secrets_file; */ NULL,
261 /* syslog_tag; */ "rsyncd",
262 /* temp_dir; */ NULL,
263 /* uid; */ NULL,
265 /* auth_users_EXP; */ False,
266 /* charset_EXP; */ False,
267 /* comment_EXP; */ False,
268 /* dont_compress_EXP; */ False,
269 /* early_exec_EXP; */ False,
270 /* exclude_EXP; */ False,
271 /* exclude_from_EXP; */ False,
272 /* filter_EXP; */ False,
273 /* gid_EXP; */ False,
274 /* hosts_allow_EXP; */ False,
275 /* hosts_deny_EXP; */ False,
276 /* include_EXP; */ False,
277 /* include_from_EXP; */ False,
278 /* incoming_chmod_EXP; */ False,
279 /* lock_file_EXP; */ False,
280 /* log_file_EXP; */ False,
281 /* log_format_EXP; */ False,
282 /* name_EXP; */ False,
283 /* outgoing_chmod_EXP; */ False,
284 /* path_EXP; */ False,
285 /* postxfer_exec_EXP; */ False,
286 /* prexfer_exec_EXP; */ False,
287 /* refuse_options_EXP; */ False,
288 /* secrets_file_EXP; */ False,
289 /* syslog_tag_EXP; */ False,
290 /* temp_dir_EXP; */ False,
291 /* uid_EXP; */ False,
293 /* max_connections; */ 0,
294 /* max_verbosity; */ 1,
295 /* syslog_facility; */ LOG_DAEMON,
296 /* timeout; */ 0,
298 /* fake_super; */ False,
299 /* forward_lookup; */ True,
300 /* ignore_errors; */ False,
301 /* ignore_nonreadable; */ False,
302 /* list; */ True,
303 /* munge_symlinks; */ (BOOL)-1,
304 /* numeric_ids; */ (BOOL)-1,
305 /* read_only; */ True,
306 /* reverse_lookup; */ True,
307 /* strict_modes; */ True,
308 /* transfer_logging; */ False,
309 /* use_chroot; */ True,
310 /* write_only; */ False,
314 /* The currently configured values for all the variables. */
315 static all_vars Vars;
317 /* Stack of "Vars" values used by the &include directive. */
318 static item_list Vars_stack = EMPTY_ITEM_LIST;
320 /* The array of section values that holds all the defined modules. */
321 static item_list section_list = EMPTY_ITEM_LIST;
323 static int iSectionIndex = -1;
324 static BOOL bInGlobalSection = True;
326 #define NUMPARAMETERS (sizeof (parm_table) / sizeof (struct parm_struct))
328 static struct enum_list enum_facilities[] = {
329 #ifdef LOG_AUTH
330 { LOG_AUTH, "auth" },
331 #endif
332 #ifdef LOG_AUTHPRIV
333 { LOG_AUTHPRIV, "authpriv" },
334 #endif
335 #ifdef LOG_CRON
336 { LOG_CRON, "cron" },
337 #endif
338 #ifdef LOG_DAEMON
339 { LOG_DAEMON, "daemon" },
340 #endif
341 #ifdef LOG_FTP
342 { LOG_FTP, "ftp" },
343 #endif
344 #ifdef LOG_KERN
345 { LOG_KERN, "kern" },
346 #endif
347 #ifdef LOG_LPR
348 { LOG_LPR, "lpr" },
349 #endif
350 #ifdef LOG_MAIL
351 { LOG_MAIL, "mail" },
352 #endif
353 #ifdef LOG_NEWS
354 { LOG_NEWS, "news" },
355 #endif
356 #ifdef LOG_AUTH
357 { LOG_AUTH, "security" },
358 #endif
359 #ifdef LOG_SYSLOG
360 { LOG_SYSLOG, "syslog" },
361 #endif
362 #ifdef LOG_USER
363 { LOG_USER, "user" },
364 #endif
365 #ifdef LOG_UUCP
366 { LOG_UUCP, "uucp" },
367 #endif
368 #ifdef LOG_LOCAL0
369 { LOG_LOCAL0, "local0" },
370 #endif
371 #ifdef LOG_LOCAL1
372 { LOG_LOCAL1, "local1" },
373 #endif
374 #ifdef LOG_LOCAL2
375 { LOG_LOCAL2, "local2" },
376 #endif
377 #ifdef LOG_LOCAL3
378 { LOG_LOCAL3, "local3" },
379 #endif
380 #ifdef LOG_LOCAL4
381 { LOG_LOCAL4, "local4" },
382 #endif
383 #ifdef LOG_LOCAL5
384 { LOG_LOCAL5, "local5" },
385 #endif
386 #ifdef LOG_LOCAL6
387 { LOG_LOCAL6, "local6" },
388 #endif
389 #ifdef LOG_LOCAL7
390 { LOG_LOCAL7, "local7" },
391 #endif
392 { -1, NULL }
395 static struct parm_struct parm_table[] =
397 {"address", P_STRING, P_GLOBAL,&Vars.g.bind_address, NULL,0},
398 {"daemon chroot", P_STRING, P_GLOBAL,&Vars.g.daemon_chroot, NULL,0},
399 {"daemon gid", P_STRING, P_GLOBAL,&Vars.g.daemon_gid, NULL,0},
400 {"daemon uid", P_STRING, P_GLOBAL,&Vars.g.daemon_uid, NULL,0},
401 {"listen backlog", P_INTEGER,P_GLOBAL,&Vars.g.listen_backlog, NULL,0},
402 {"motd file", P_STRING, P_GLOBAL,&Vars.g.motd_file, NULL,0},
403 {"pid file", P_STRING, P_GLOBAL,&Vars.g.pid_file, NULL,0},
404 {"port", P_INTEGER,P_GLOBAL,&Vars.g.rsync_port, NULL,0},
405 {"proxy protocol", P_BOOL, P_LOCAL, &Vars.g.proxy_protocol, NULL,0},
406 {"socket options", P_STRING, P_GLOBAL,&Vars.g.socket_options, NULL,0},
408 {"auth users", P_STRING, P_LOCAL, &Vars.l.auth_users, NULL,0},
409 {"charset", P_STRING, P_LOCAL, &Vars.l.charset, NULL,0},
410 {"comment", P_STRING, P_LOCAL, &Vars.l.comment, NULL,0},
411 {"dont compress", P_STRING, P_LOCAL, &Vars.l.dont_compress, NULL,0},
412 {"early exec", P_STRING, P_LOCAL, &Vars.l.early_exec, NULL,0},
413 {"exclude from", P_STRING, P_LOCAL, &Vars.l.exclude_from, NULL,0},
414 {"exclude", P_STRING, P_LOCAL, &Vars.l.exclude, NULL,0},
415 {"fake super", P_BOOL, P_LOCAL, &Vars.l.fake_super, NULL,0},
416 {"filter", P_STRING, P_LOCAL, &Vars.l.filter, NULL,0},
417 {"forward lookup", P_BOOL, P_LOCAL, &Vars.l.forward_lookup, NULL,0},
418 {"gid", P_STRING, P_LOCAL, &Vars.l.gid, NULL,0},
419 {"hosts allow", P_STRING, P_LOCAL, &Vars.l.hosts_allow, NULL,0},
420 {"hosts deny", P_STRING, P_LOCAL, &Vars.l.hosts_deny, NULL,0},
421 {"ignore errors", P_BOOL, P_LOCAL, &Vars.l.ignore_errors, NULL,0},
422 {"ignore nonreadable",P_BOOL, P_LOCAL, &Vars.l.ignore_nonreadable, NULL,0},
423 {"include from", P_STRING, P_LOCAL, &Vars.l.include_from, NULL,0},
424 {"include", P_STRING, P_LOCAL, &Vars.l.include, NULL,0},
425 {"incoming chmod", P_STRING, P_LOCAL, &Vars.l.incoming_chmod, NULL,0},
426 {"list", P_BOOL, P_LOCAL, &Vars.l.list, NULL,0},
427 {"lock file", P_STRING, P_LOCAL, &Vars.l.lock_file, NULL,0},
428 {"log file", P_STRING, P_LOCAL, &Vars.l.log_file, NULL,0},
429 {"log format", P_STRING, P_LOCAL, &Vars.l.log_format, NULL,0},
430 {"max connections", P_INTEGER,P_LOCAL, &Vars.l.max_connections, NULL,0},
431 {"max verbosity", P_INTEGER,P_LOCAL, &Vars.l.max_verbosity, NULL,0},
432 {"munge symlinks", P_BOOL, P_LOCAL, &Vars.l.munge_symlinks, NULL,0},
433 {"name", P_STRING, P_LOCAL, &Vars.l.name, NULL,0},
434 {"numeric ids", P_BOOL, P_LOCAL, &Vars.l.numeric_ids, NULL,0},
435 {"outgoing chmod", P_STRING, P_LOCAL, &Vars.l.outgoing_chmod, NULL,0},
436 {"path", P_PATH, P_LOCAL, &Vars.l.path, NULL,0},
437 #ifdef HAVE_PUTENV
438 {"post-xfer exec", P_STRING, P_LOCAL, &Vars.l.postxfer_exec, NULL,0},
439 {"pre-xfer exec", P_STRING, P_LOCAL, &Vars.l.prexfer_exec, NULL,0},
440 #endif
441 {"read only", P_BOOL, P_LOCAL, &Vars.l.read_only, NULL,0},
442 {"refuse options", P_STRING, P_LOCAL, &Vars.l.refuse_options, NULL,0},
443 {"reverse lookup", P_BOOL, P_LOCAL, &Vars.l.reverse_lookup, NULL,0},
444 {"secrets file", P_STRING, P_LOCAL, &Vars.l.secrets_file, NULL,0},
445 {"strict modes", P_BOOL, P_LOCAL, &Vars.l.strict_modes, NULL,0},
446 {"syslog facility", P_ENUM, P_LOCAL, &Vars.l.syslog_facility, enum_facilities,0},
447 {"syslog tag", P_STRING, P_LOCAL, &Vars.l.syslog_tag, NULL,0},
448 {"temp dir", P_PATH, P_LOCAL, &Vars.l.temp_dir, NULL,0},
449 {"timeout", P_INTEGER,P_LOCAL, &Vars.l.timeout, NULL,0},
450 {"transfer logging", P_BOOL, P_LOCAL, &Vars.l.transfer_logging, NULL,0},
451 {"uid", P_STRING, P_LOCAL, &Vars.l.uid, NULL,0},
452 {"use chroot", P_BOOL, P_LOCAL, &Vars.l.use_chroot, NULL,0},
453 {"write only", P_BOOL, P_LOCAL, &Vars.l.write_only, NULL,0},
454 {NULL, P_BOOL, P_NONE, NULL, NULL,0}
457 /* Initialise the Default all_vars structure. */
458 void reset_daemon_vars(void)
460 memcpy(&Vars, &Defaults, sizeof Vars);
463 /* Expand %VAR% references. Any unknown vars or unrecognized
464 * syntax leaves the raw chars unchanged. */
465 static char *expand_vars(char *str)
467 char *buf, *t, *f;
468 int bufsize;
470 if (!str || !strchr(str, '%'))
471 return str;
473 bufsize = strlen(str) + 2048;
474 if ((buf = new_array(char, bufsize+1)) == NULL) /* +1 for trailing '\0' */
475 out_of_memory("expand_vars");
477 for (t = buf, f = str; bufsize && *f; ) {
478 if (*f == '%' && *++f != '%') {
479 char *percent = strchr(f, '%');
480 if (percent) {
481 char *val;
482 *percent = '\0';
483 val = getenv(f);
484 *percent = '%';
485 if (val) {
486 int len = strlcpy(t, val, bufsize+1);
487 if (len > bufsize)
488 break;
489 bufsize -= len;
490 t += len;
491 f = percent + 1;
492 continue;
495 f--;
497 *t++ = *f++;
498 bufsize--;
500 *t = '\0';
502 if (*f) {
503 rprintf(FLOG, "Overflowed buf in expand_vars() trying to expand: %s\n", str);
504 exit_cleanup(RERR_MALLOC);
507 if (bufsize && (buf = realloc(buf, t - buf + 1)) == NULL)
508 out_of_memory("expand_vars");
510 return buf;
513 /* NOTE: use this function and all the FN_{GLOBAL,LOCAL} ones WITHOUT a trailing semicolon! */
514 #define RETURN_EXPANDED(val) {if (!val ## _EXP) {val = expand_vars(val); val ## _EXP = True;} return val ? val : "";}
516 /* In this section all the functions that are used to access the
517 * parameters from the rest of the program are defined. */
519 #define FN_GLOBAL_STRING(fn_name, val) \
520 char *fn_name(void) RETURN_EXPANDED(Vars.g.val)
521 #define FN_GLOBAL_BOOL(fn_name, val) \
522 BOOL fn_name(void) {return Vars.g.val;}
523 #define FN_GLOBAL_CHAR(fn_name, val) \
524 char fn_name(void) {return Vars.g.val;}
525 #define FN_GLOBAL_INTEGER(fn_name, val) \
526 int fn_name(void) {return Vars.g.val;}
528 #define FN_LOCAL_STRING(fn_name, val) \
529 char *fn_name(int i) {if (LP_SNUM_OK(i) && iSECTION(i).val) RETURN_EXPANDED(iSECTION(i).val) else RETURN_EXPANDED(Vars.l.val)}
530 #define FN_LOCAL_BOOL(fn_name, val) \
531 BOOL fn_name(int i) {return LP_SNUM_OK(i)? iSECTION(i).val : Vars.l.val;}
532 #define FN_LOCAL_CHAR(fn_name, val) \
533 char fn_name(int i) {return LP_SNUM_OK(i)? iSECTION(i).val : Vars.l.val;}
534 #define FN_LOCAL_INTEGER(fn_name, val) \
535 int fn_name(int i) {return LP_SNUM_OK(i)? iSECTION(i).val : Vars.l.val;}
537 FN_GLOBAL_STRING(lp_bind_address, bind_address)
538 FN_GLOBAL_STRING(lp_daemon_chroot, daemon_chroot)
539 FN_GLOBAL_STRING(lp_daemon_gid, daemon_gid)
540 FN_GLOBAL_STRING(lp_daemon_uid, daemon_uid)
541 FN_GLOBAL_STRING(lp_motd_file, motd_file)
542 FN_GLOBAL_STRING(lp_pid_file, pid_file)
543 FN_GLOBAL_STRING(lp_socket_options, socket_options)
545 FN_GLOBAL_INTEGER(lp_listen_backlog, listen_backlog)
546 FN_GLOBAL_INTEGER(lp_rsync_port, rsync_port)
548 FN_GLOBAL_BOOL(lp_proxy_protocol, proxy_protocol)
550 FN_LOCAL_STRING(lp_auth_users, auth_users)
551 FN_LOCAL_STRING(lp_charset, charset)
552 FN_LOCAL_STRING(lp_comment, comment)
553 FN_LOCAL_STRING(lp_dont_compress, dont_compress)
554 FN_LOCAL_STRING(lp_early_exec, early_exec)
555 FN_LOCAL_STRING(lp_exclude, exclude)
556 FN_LOCAL_STRING(lp_exclude_from, exclude_from)
557 FN_LOCAL_STRING(lp_filter, filter)
558 FN_LOCAL_STRING(lp_gid, gid)
559 FN_LOCAL_STRING(lp_hosts_allow, hosts_allow)
560 FN_LOCAL_STRING(lp_hosts_deny, hosts_deny)
561 FN_LOCAL_STRING(lp_include, include)
562 FN_LOCAL_STRING(lp_include_from, include_from)
563 FN_LOCAL_STRING(lp_incoming_chmod, incoming_chmod)
564 FN_LOCAL_STRING(lp_lock_file, lock_file)
565 FN_LOCAL_STRING(lp_log_file, log_file)
566 FN_LOCAL_STRING(lp_log_format, log_format)
567 FN_LOCAL_STRING(lp_name, name)
568 FN_LOCAL_STRING(lp_outgoing_chmod, outgoing_chmod)
569 FN_LOCAL_STRING(lp_path, path)
570 FN_LOCAL_STRING(lp_postxfer_exec, postxfer_exec)
571 FN_LOCAL_STRING(lp_prexfer_exec, prexfer_exec)
572 FN_LOCAL_STRING(lp_refuse_options, refuse_options)
573 FN_LOCAL_STRING(lp_secrets_file, secrets_file)
574 FN_LOCAL_STRING(lp_syslog_tag, syslog_tag)
575 FN_LOCAL_STRING(lp_temp_dir, temp_dir)
576 FN_LOCAL_STRING(lp_uid, uid)
578 FN_LOCAL_INTEGER(lp_max_connections, max_connections)
579 FN_LOCAL_INTEGER(lp_max_verbosity, max_verbosity)
580 FN_LOCAL_INTEGER(lp_syslog_facility, syslog_facility)
581 FN_LOCAL_INTEGER(lp_timeout, timeout)
583 FN_LOCAL_BOOL(lp_fake_super, fake_super)
584 FN_LOCAL_BOOL(lp_forward_lookup, forward_lookup)
585 FN_LOCAL_BOOL(lp_ignore_errors, ignore_errors)
586 FN_LOCAL_BOOL(lp_ignore_nonreadable, ignore_nonreadable)
587 FN_LOCAL_BOOL(lp_list, list)
588 FN_LOCAL_BOOL(lp_munge_symlinks, munge_symlinks)
589 FN_LOCAL_BOOL(lp_numeric_ids, numeric_ids)
590 FN_LOCAL_BOOL(lp_read_only, read_only)
591 FN_LOCAL_BOOL(lp_reverse_lookup, reverse_lookup)
592 FN_LOCAL_BOOL(lp_strict_modes, strict_modes)
593 FN_LOCAL_BOOL(lp_transfer_logging, transfer_logging)
594 FN_LOCAL_BOOL(lp_use_chroot, use_chroot)
595 FN_LOCAL_BOOL(lp_write_only, write_only)
597 /* Assign a copy of v to *s. Handles NULL strings. We don't worry
598 * about overwriting a malloc'd string because the long-running
599 * (port-listening) daemon only loads the config file once, and the
600 * per-job (forked or xinitd-ran) daemon only re-reads the file at
601 * the start, so any lost memory is inconsequential. */
602 static inline void string_set(char **s, const char *v)
604 if (!v)
605 *s = NULL;
606 else if (!(*s = strdup(v)))
607 out_of_memory("string_set");
610 /* Copy local_vars into a new section. No need to strdup since we don't free. */
611 static void copy_section(local_vars *psectionDest, local_vars *psectionSource)
613 memcpy(psectionDest, psectionSource, sizeof psectionDest[0]);
616 /* Initialise a section to the defaults. */
617 static void init_section(local_vars *psection)
619 memset(psection, 0, sizeof (local_vars));
620 copy_section(psection, &Vars.l);
623 /* Do a case-insensitive, whitespace-ignoring string compare. */
624 static int strwicmp(char *psz1, char *psz2)
626 /* if BOTH strings are NULL, return TRUE, if ONE is NULL return */
627 /* appropriate value. */
628 if (psz1 == psz2)
629 return 0;
631 if (psz1 == NULL)
632 return -1;
634 if (psz2 == NULL)
635 return 1;
637 /* sync the strings on first non-whitespace */
638 while (1) {
639 while (isSpace(psz1))
640 psz1++;
641 while (isSpace(psz2))
642 psz2++;
643 if (toUpper(psz1) != toUpper(psz2) || *psz1 == '\0' || *psz2 == '\0')
644 break;
645 psz1++;
646 psz2++;
648 return *psz1 - *psz2;
651 /* Find a section by name. Otherwise works like get_section. */
652 static int getsectionbyname(char *name)
654 int i;
656 for (i = section_list.count - 1; i >= 0; i--) {
657 if (strwicmp(iSECTION(i).name, name) == 0)
658 break;
661 return i;
664 /* Add a new section to the sections array w/the default values. */
665 static int add_a_section(char *name)
667 int i;
668 local_vars *s;
670 /* it might already exist */
671 if (name) {
672 i = getsectionbyname(name);
673 if (i >= 0)
674 return i;
677 i = section_list.count;
678 s = EXPAND_ITEM_LIST(&section_list, local_vars, 2);
680 init_section(s);
681 if (name)
682 string_set(&s->name, name);
684 return i;
687 /* Map a parameter's string representation to something we can use.
688 * Returns False if the parameter string is not recognised, else TRUE. */
689 static int map_parameter(char *parmname)
691 int iIndex;
693 if (*parmname == '-')
694 return -1;
696 for (iIndex = 0; parm_table[iIndex].label; iIndex++) {
697 if (strwicmp(parm_table[iIndex].label, parmname) == 0)
698 return iIndex;
701 rprintf(FLOG, "Unknown Parameter encountered: \"%s\"\n", parmname);
702 return -1;
705 /* Set a boolean variable from the text value stored in the passed string.
706 * Returns True in success, False if the passed string does not correctly
707 * represent a boolean. */
708 static BOOL set_boolean(BOOL *pb, char *parmvalue)
710 if (strwicmp(parmvalue, "yes") == 0
711 || strwicmp(parmvalue, "true") == 0
712 || strwicmp(parmvalue, "1") == 0)
713 *pb = True;
714 else if (strwicmp(parmvalue, "no") == 0
715 || strwicmp(parmvalue, "False") == 0
716 || strwicmp(parmvalue, "0") == 0)
717 *pb = False;
718 else {
719 rprintf(FLOG, "Badly formed boolean in configuration file: \"%s\".\n", parmvalue);
720 return False;
722 return True;
725 /* Process a parameter. */
726 static BOOL do_parameter(char *parmname, char *parmvalue)
728 int parmnum, i;
729 void *parm_ptr; /* where we are going to store the result */
730 void *def_ptr;
731 char *cp;
733 parmnum = map_parameter(parmname);
735 if (parmnum < 0) {
736 rprintf(FLOG, "IGNORING unknown parameter \"%s\"\n", parmname);
737 return True;
740 def_ptr = parm_table[parmnum].ptr;
742 if (bInGlobalSection)
743 parm_ptr = def_ptr;
744 else {
745 if (parm_table[parmnum].class == P_GLOBAL) {
746 rprintf(FLOG, "Global parameter %s found in module section!\n", parmname);
747 return True;
749 parm_ptr = SECTION_PTR(&iSECTION(iSectionIndex), def_ptr);
752 /* now switch on the type of variable it is */
753 switch (parm_table[parmnum].type) {
754 case P_PATH:
755 case P_STRING:
756 /* delay expansion of %VAR% strings */
757 break;
758 default:
759 /* expand any %VAR% strings now */
760 parmvalue = expand_vars(parmvalue);
761 break;
764 switch (parm_table[parmnum].type) {
765 case P_BOOL:
766 set_boolean(parm_ptr, parmvalue);
767 break;
769 case P_BOOLREV:
770 set_boolean(parm_ptr, parmvalue);
771 *(BOOL *)parm_ptr = ! *(BOOL *)parm_ptr;
772 break;
774 case P_INTEGER:
775 *(int *)parm_ptr = atoi(parmvalue);
776 break;
778 case P_CHAR:
779 *(char *)parm_ptr = *parmvalue;
780 break;
782 case P_OCTAL:
783 sscanf(parmvalue, "%o", (int *)parm_ptr);
784 break;
786 case P_PATH:
787 string_set(parm_ptr, parmvalue);
788 if ((cp = *(char**)parm_ptr) != NULL) {
789 int len = strlen(cp);
790 while (len > 1 && cp[len-1] == '/') len--;
791 cp[len] = '\0';
793 break;
795 case P_STRING:
796 string_set(parm_ptr, parmvalue);
797 break;
799 case P_ENUM:
800 for (i=0; parm_table[parmnum].enum_list[i].name; i++) {
801 if (strequal(parmvalue, parm_table[parmnum].enum_list[i].name)) {
802 *(int *)parm_ptr = parm_table[parmnum].enum_list[i].value;
803 break;
806 if (!parm_table[parmnum].enum_list[i].name) {
807 if (atoi(parmvalue) > 0)
808 *(int *)parm_ptr = atoi(parmvalue);
810 break;
813 return True;
816 /* Process a new section (rsync module).
817 * Returns True on success, False on failure. */
818 static BOOL do_section(char *sectionname)
820 BOOL isglobal;
822 if (*sectionname == ']') { /* A special push/pop/reset directive from params.c */
823 bInGlobalSection = 1;
824 if (strcmp(sectionname+1, "push") == 0) {
825 all_vars *vp = EXPAND_ITEM_LIST(&Vars_stack, all_vars, 2);
826 memcpy(vp, &Vars, sizeof Vars);
827 } else if (strcmp(sectionname+1, "pop") == 0
828 || strcmp(sectionname+1, "reset") == 0) {
829 all_vars *vp = ((all_vars*)Vars_stack.items) + Vars_stack.count - 1;
830 if (!Vars_stack.count)
831 return False;
832 memcpy(&Vars, vp, sizeof Vars);
833 if (sectionname[1] == 'p')
834 Vars_stack.count--;
835 } else
836 return False;
837 return True;
840 isglobal = strwicmp(sectionname, GLOBAL_NAME) == 0;
842 /* At the end of the global section, add any --dparam items. */
843 if (bInGlobalSection && !isglobal) {
844 if (!section_list.count)
845 set_dparams(0);
848 /* if we've just struck a global section, note the fact. */
849 bInGlobalSection = isglobal;
851 /* check for multiple global sections */
852 if (bInGlobalSection)
853 return True;
855 #if 0
856 /* If we have a current section, tidy it up before moving on. */
857 if (iSectionIndex >= 0) {
858 /* Add any tidy work as needed ... */
859 if (problem)
860 return False;
862 #endif
864 if (strchr(sectionname, '/') != NULL) {
865 rprintf(FLOG, "Warning: invalid section name in configuration file: %s\n", sectionname);
866 return False;
869 if ((iSectionIndex = add_a_section(sectionname)) < 0) {
870 rprintf(FLOG, "Failed to add a new module\n");
871 bInGlobalSection = True;
872 return False;
875 return True;
878 /* Load the modules from the config file. Return True on success,
879 * False on failure. */
880 int lp_load(char *pszFname, int globals_only)
882 bInGlobalSection = True;
884 reset_daemon_vars();
886 /* We get sections first, so have to start 'behind' to make up. */
887 iSectionIndex = -1;
888 return pm_process(pszFname, globals_only ? NULL : do_section, do_parameter);
891 BOOL set_dparams(int syntax_check_only)
893 char *equal, *val, **params = dparam_list.items;
894 unsigned j;
896 for (j = 0; j < dparam_list.count; j++) {
897 equal = strchr(params[j], '='); /* options.c verified this */
898 *equal = '\0';
899 if (syntax_check_only) {
900 if (map_parameter(params[j]) < 0) {
901 rprintf(FERROR, "Unknown parameter \"%s\"\n", params[j]);
902 *equal = '=';
903 return False;
905 } else {
906 for (val = equal+1; isSpace(val); val++) {}
907 do_parameter(params[j], val);
909 *equal = '=';
912 return True;
915 /* Return the max number of modules (sections). */
916 int lp_num_modules(void)
918 return section_list.count;
921 /* Return the number of the module with the given name, or -1 if it doesn't
922 * exist. Note that this is a DIFFERENT ANIMAL from the internal function
923 * getsectionbyname()! This works ONLY if all sections have been loaded,
924 * and does not copy the found section. */
925 int lp_number(char *name)
927 int i;
929 for (i = section_list.count - 1; i >= 0; i--) {
930 if (strcmp(lp_name(i), name) == 0)
931 break;
934 return i;