1 /* $Cambridge: exim/src/src/readconf.c,v 1.31 2007/07/04 11:03:46 ph10 Exp $ */
3 /*************************************************
4 * Exim - an Internet mail transport agent *
5 *************************************************/
7 /* Copyright (c) University of Cambridge 1995 - 2007 */
8 /* See the file NOTICE for conditions of use and distribution. */
10 /* Functions for reading the configuration file, and for displaying
11 overall configuration values. Thanks to Brian Candler for the original
12 implementation of the conditional .ifdef etc. */
16 #define CSTATE_STACK_SIZE 10
19 /* Structure for chain (stack) of .included files */
21 typedef struct config_file_item {
22 struct config_file_item *next;
28 /* Structure of table of conditional words and their state transitions */
30 typedef struct cond_item {
38 /* Structure of table of syslog facility names and values */
40 typedef struct syslog_fac_item {
46 /* Static variables */
48 static config_file_item *config_file_stack = NULL; /* For includes */
50 static uschar *syslog_facility_str = NULL;
51 static uschar next_section[24];
52 static uschar time_buffer[24];
54 /* State variables for conditional loading (.ifdef / .else / .endif) */
56 static int cstate = 0;
57 static int cstate_stack_ptr = -1;
58 static int cstate_stack[CSTATE_STACK_SIZE];
60 /* Table of state transitions for handling conditional inclusions. There are
61 four possible state transitions:
65 .elifdef true (or .else)
68 .endif just causes the previous cstate to be popped off the stack */
70 static int next_cstate[3][4] =
72 /* State 0: reading from file, or reading until next .else or .endif */
74 /* State 1: condition failed, skipping until next .else or .endif */
76 /* State 2: skipping until .endif */
80 /* Table of conditionals and the states to set. For each name, there are four
81 values: the length of the name (to save computing it each time), the state to
82 set if a macro was found in the line, the state to set if a macro was not found
83 in the line, and a stack manipulation setting which is:
85 -1 pull state value off the stack
86 0 don't alter the stack
87 +1 push value onto stack, before setting new state
90 static cond_item cond_list[] = {
91 { US"ifdef", 5, 0, 1, 1 },
92 { US"ifndef", 6, 1, 0, 1 },
93 { US"elifdef", 7, 2, 3, 0 },
94 { US"elifndef", 8, 3, 2, 0 },
95 { US"else", 4, 2, 2, 0 },
96 { US"endif", 5, 0, 0, -1 }
99 static int cond_list_size = sizeof(cond_list)/sizeof(cond_item);
101 /* Table of syslog facility names and their values */
103 static syslog_fac_item syslog_list[] = {
104 { US"mail", LOG_MAIL },
105 { US"user", LOG_USER },
106 { US"news", LOG_NEWS },
107 { US"uucp", LOG_UUCP },
108 { US"local0", LOG_LOCAL0 },
109 { US"local1", LOG_LOCAL1 },
110 { US"local2", LOG_LOCAL2 },
111 { US"local3", LOG_LOCAL3 },
112 { US"local4", LOG_LOCAL4 },
113 { US"local5", LOG_LOCAL5 },
114 { US"local6", LOG_LOCAL6 },
115 { US"local7", LOG_LOCAL7 },
116 { US"daemon", LOG_DAEMON }
119 static int syslog_list_size = sizeof(syslog_list)/sizeof(syslog_fac_item);
124 /*************************************************
125 * Main configuration options *
126 *************************************************/
128 /* The list of options that can be set in the main configuration file. This
129 must be in alphabetic order because it is searched by binary chop. */
131 static optionlist optionlist_config[] = {
132 { "*set_exim_group", opt_bool|opt_hidden, &exim_gid_set },
133 { "*set_exim_user", opt_bool|opt_hidden, &exim_uid_set },
134 { "*set_system_filter_group", opt_bool|opt_hidden, &system_filter_gid_set },
135 { "*set_system_filter_user", opt_bool|opt_hidden, &system_filter_uid_set },
136 { "accept_8bitmime", opt_bool, &accept_8bitmime },
137 { "acl_not_smtp", opt_stringptr, &acl_not_smtp },
138 #ifdef WITH_CONTENT_SCAN
139 { "acl_not_smtp_mime", opt_stringptr, &acl_not_smtp_mime },
141 { "acl_not_smtp_start", opt_stringptr, &acl_not_smtp_start },
142 { "acl_smtp_auth", opt_stringptr, &acl_smtp_auth },
143 { "acl_smtp_connect", opt_stringptr, &acl_smtp_connect },
144 { "acl_smtp_data", opt_stringptr, &acl_smtp_data },
145 { "acl_smtp_etrn", opt_stringptr, &acl_smtp_etrn },
146 { "acl_smtp_expn", opt_stringptr, &acl_smtp_expn },
147 { "acl_smtp_helo", opt_stringptr, &acl_smtp_helo },
148 { "acl_smtp_mail", opt_stringptr, &acl_smtp_mail },
149 { "acl_smtp_mailauth", opt_stringptr, &acl_smtp_mailauth },
150 #ifdef WITH_CONTENT_SCAN
151 { "acl_smtp_mime", opt_stringptr, &acl_smtp_mime },
153 { "acl_smtp_predata", opt_stringptr, &acl_smtp_predata },
154 { "acl_smtp_quit", opt_stringptr, &acl_smtp_quit },
155 { "acl_smtp_rcpt", opt_stringptr, &acl_smtp_rcpt },
157 { "acl_smtp_starttls", opt_stringptr, &acl_smtp_starttls },
159 { "acl_smtp_vrfy", opt_stringptr, &acl_smtp_vrfy },
160 { "admin_groups", opt_gidlist, &admin_groups },
161 { "allow_domain_literals", opt_bool, &allow_domain_literals },
162 { "allow_mx_to_ip", opt_bool, &allow_mx_to_ip },
163 { "allow_utf8_domains", opt_bool, &allow_utf8_domains },
164 { "auth_advertise_hosts", opt_stringptr, &auth_advertise_hosts },
165 { "auto_thaw", opt_time, &auto_thaw },
166 #ifdef WITH_CONTENT_SCAN
167 { "av_scanner", opt_stringptr, &av_scanner },
169 { "bi_command", opt_stringptr, &bi_command },
170 #ifdef EXPERIMENTAL_BRIGHTMAIL
171 { "bmi_config_file", opt_stringptr, &bmi_config_file },
173 { "bounce_message_file", opt_stringptr, &bounce_message_file },
174 { "bounce_message_text", opt_stringptr, &bounce_message_text },
175 { "bounce_return_body", opt_bool, &bounce_return_body },
176 { "bounce_return_message", opt_bool, &bounce_return_message },
177 { "bounce_return_size_limit", opt_mkint, &bounce_return_size_limit },
178 { "bounce_sender_authentication",opt_stringptr,&bounce_sender_authentication },
179 { "callout_domain_negative_expire", opt_time, &callout_cache_domain_negative_expire },
180 { "callout_domain_positive_expire", opt_time, &callout_cache_domain_positive_expire },
181 { "callout_negative_expire", opt_time, &callout_cache_negative_expire },
182 { "callout_positive_expire", opt_time, &callout_cache_positive_expire },
183 { "callout_random_local_part",opt_stringptr, &callout_random_local_part },
184 { "check_log_inodes", opt_int, &check_log_inodes },
185 { "check_log_space", opt_Kint, &check_log_space },
186 { "check_rfc2047_length", opt_bool, &check_rfc2047_length },
187 { "check_spool_inodes", opt_int, &check_spool_inodes },
188 { "check_spool_space", opt_Kint, &check_spool_space },
189 { "daemon_smtp_port", opt_stringptr|opt_hidden, &daemon_smtp_port },
190 { "daemon_smtp_ports", opt_stringptr, &daemon_smtp_port },
191 { "daemon_startup_retries", opt_int, &daemon_startup_retries },
192 { "daemon_startup_sleep", opt_time, &daemon_startup_sleep },
193 { "delay_warning", opt_timelist, &delay_warning },
194 { "delay_warning_condition", opt_stringptr, &delay_warning_condition },
195 { "deliver_drop_privilege", opt_bool, &deliver_drop_privilege },
196 { "deliver_queue_load_max", opt_fixed, &deliver_queue_load_max },
197 { "delivery_date_remove", opt_bool, &delivery_date_remove },
198 #ifdef ENABLE_DISABLE_FSYNC
199 { "disable_fsync", opt_bool, &disable_fsync },
201 { "disable_ipv6", opt_bool, &disable_ipv6 },
202 { "dns_again_means_nonexist", opt_stringptr, &dns_again_means_nonexist },
203 { "dns_check_names_pattern", opt_stringptr, &check_dns_names_pattern },
204 { "dns_csa_search_limit", opt_int, &dns_csa_search_limit },
205 { "dns_csa_use_reverse", opt_bool, &dns_csa_use_reverse },
206 { "dns_ipv4_lookup", opt_stringptr, &dns_ipv4_lookup },
207 { "dns_retrans", opt_time, &dns_retrans },
208 { "dns_retry", opt_int, &dns_retry },
209 /* This option is now a no-op, retained for compability */
210 { "drop_cr", opt_bool, &drop_cr },
211 /*********************************************************/
212 { "dsn_from", opt_stringptr, &dsn_from },
213 { "envelope_to_remove", opt_bool, &envelope_to_remove },
214 { "errors_copy", opt_stringptr, &errors_copy },
215 { "errors_reply_to", opt_stringptr, &errors_reply_to },
216 { "exim_group", opt_gid, &exim_gid },
217 { "exim_path", opt_stringptr, &exim_path },
218 { "exim_user", opt_uid, &exim_uid },
219 { "extra_local_interfaces", opt_stringptr, &extra_local_interfaces },
220 { "extract_addresses_remove_arguments", opt_bool, &extract_addresses_remove_arguments },
221 { "finduser_retries", opt_int, &finduser_retries },
222 { "freeze_tell", opt_stringptr, &freeze_tell },
223 { "gecos_name", opt_stringptr, &gecos_name },
224 { "gecos_pattern", opt_stringptr, &gecos_pattern },
226 { "gnutls_require_kx", opt_stringptr, &gnutls_require_kx },
227 { "gnutls_require_mac", opt_stringptr, &gnutls_require_mac },
228 { "gnutls_require_protocols", opt_stringptr, &gnutls_require_proto },
230 { "header_line_maxsize", opt_int, &header_line_maxsize },
231 { "header_maxsize", opt_int, &header_maxsize },
232 { "headers_charset", opt_stringptr, &headers_charset },
233 { "helo_accept_junk_hosts", opt_stringptr, &helo_accept_junk_hosts },
234 { "helo_allow_chars", opt_stringptr, &helo_allow_chars },
235 { "helo_lookup_domains", opt_stringptr, &helo_lookup_domains },
236 { "helo_try_verify_hosts", opt_stringptr, &helo_try_verify_hosts },
237 { "helo_verify_hosts", opt_stringptr, &helo_verify_hosts },
238 { "hold_domains", opt_stringptr, &hold_domains },
239 { "host_lookup", opt_stringptr, &host_lookup },
240 { "host_lookup_order", opt_stringptr, &host_lookup_order },
241 { "host_reject_connection", opt_stringptr, &host_reject_connection },
242 { "hosts_connection_nolog", opt_stringptr, &hosts_connection_nolog },
243 { "hosts_treat_as_local", opt_stringptr, &hosts_treat_as_local },
245 { "ibase_servers", opt_stringptr, &ibase_servers },
247 { "ignore_bounce_errors_after", opt_time, &ignore_bounce_errors_after },
248 { "ignore_fromline_hosts", opt_stringptr, &ignore_fromline_hosts },
249 { "ignore_fromline_local", opt_bool, &ignore_fromline_local },
250 { "keep_malformed", opt_time, &keep_malformed },
252 { "ldap_default_servers", opt_stringptr, &eldap_default_servers },
253 { "ldap_version", opt_int, &eldap_version },
255 { "local_from_check", opt_bool, &local_from_check },
256 { "local_from_prefix", opt_stringptr, &local_from_prefix },
257 { "local_from_suffix", opt_stringptr, &local_from_suffix },
258 { "local_interfaces", opt_stringptr, &local_interfaces },
259 { "local_scan_timeout", opt_time, &local_scan_timeout },
260 { "local_sender_retain", opt_bool, &local_sender_retain },
261 { "localhost_number", opt_stringptr, &host_number_string },
262 { "log_file_path", opt_stringptr, &log_file_path },
263 { "log_selector", opt_stringptr, &log_selector_string },
264 { "log_timezone", opt_bool, &log_timezone },
265 { "lookup_open_max", opt_int, &lookup_open_max },
266 { "max_username_length", opt_int, &max_username_length },
267 { "message_body_visible", opt_mkint, &message_body_visible },
268 { "message_id_header_domain", opt_stringptr, &message_id_domain },
269 { "message_id_header_text", opt_stringptr, &message_id_text },
270 { "message_logs", opt_bool, &message_logs },
271 { "message_size_limit", opt_stringptr, &message_size_limit },
272 #ifdef SUPPORT_MOVE_FROZEN_MESSAGES
273 { "move_frozen_messages", opt_bool, &move_frozen_messages },
275 { "mua_wrapper", opt_bool, &mua_wrapper },
277 { "mysql_servers", opt_stringptr, &mysql_servers },
279 { "never_users", opt_uidlist, &never_users },
281 { "oracle_servers", opt_stringptr, &oracle_servers },
283 { "percent_hack_domains", opt_stringptr, &percent_hack_domains },
285 { "perl_at_start", opt_bool, &opt_perl_at_start },
286 { "perl_startup", opt_stringptr, &opt_perl_startup },
289 { "pgsql_servers", opt_stringptr, &pgsql_servers },
291 { "pid_file_path", opt_stringptr, &pid_file_path },
292 { "pipelining_advertise_hosts", opt_stringptr, &pipelining_advertise_hosts },
293 { "preserve_message_logs", opt_bool, &preserve_message_logs },
294 { "primary_hostname", opt_stringptr, &primary_hostname },
295 { "print_topbitchars", opt_bool, &print_topbitchars },
296 { "process_log_path", opt_stringptr, &process_log_path },
297 { "prod_requires_admin", opt_bool, &prod_requires_admin },
298 { "qualify_domain", opt_stringptr, &qualify_domain_sender },
299 { "qualify_recipient", opt_stringptr, &qualify_domain_recipient },
300 { "queue_domains", opt_stringptr, &queue_domains },
301 { "queue_list_requires_admin",opt_bool, &queue_list_requires_admin },
302 { "queue_only", opt_bool, &queue_only },
303 { "queue_only_file", opt_stringptr, &queue_only_file },
304 { "queue_only_load", opt_fixed, &queue_only_load },
305 { "queue_only_load_latch", opt_bool, &queue_only_load_latch },
306 { "queue_only_override", opt_bool, &queue_only_override },
307 { "queue_run_in_order", opt_bool, &queue_run_in_order },
308 { "queue_run_max", opt_int, &queue_run_max },
309 { "queue_smtp_domains", opt_stringptr, &queue_smtp_domains },
310 { "receive_timeout", opt_time, &receive_timeout },
311 { "received_header_text", opt_stringptr, &received_header_text },
312 { "received_headers_max", opt_int, &received_headers_max },
313 { "recipient_unqualified_hosts", opt_stringptr, &recipient_unqualified_hosts },
314 { "recipients_max", opt_int, &recipients_max },
315 { "recipients_max_reject", opt_bool, &recipients_max_reject },
316 { "remote_max_parallel", opt_int, &remote_max_parallel },
317 { "remote_sort_domains", opt_stringptr, &remote_sort_domains },
318 { "retry_data_expire", opt_time, &retry_data_expire },
319 { "retry_interval_max", opt_time, &retry_interval_max },
320 { "return_path_remove", opt_bool, &return_path_remove },
321 { "return_size_limit", opt_mkint|opt_hidden, &bounce_return_size_limit },
322 { "rfc1413_hosts", opt_stringptr, &rfc1413_hosts },
323 { "rfc1413_query_timeout", opt_time, &rfc1413_query_timeout },
324 { "sender_unqualified_hosts", opt_stringptr, &sender_unqualified_hosts },
325 { "smtp_accept_keepalive", opt_bool, &smtp_accept_keepalive },
326 { "smtp_accept_max", opt_int, &smtp_accept_max },
327 { "smtp_accept_max_nonmail", opt_int, &smtp_accept_max_nonmail },
328 { "smtp_accept_max_nonmail_hosts", opt_stringptr, &smtp_accept_max_nonmail_hosts },
329 { "smtp_accept_max_per_connection", opt_int, &smtp_accept_max_per_connection },
330 { "smtp_accept_max_per_host", opt_stringptr, &smtp_accept_max_per_host },
331 { "smtp_accept_queue", opt_int, &smtp_accept_queue },
332 { "smtp_accept_queue_per_connection", opt_int, &smtp_accept_queue_per_connection },
333 { "smtp_accept_reserve", opt_int, &smtp_accept_reserve },
334 { "smtp_active_hostname", opt_stringptr, &raw_active_hostname },
335 { "smtp_banner", opt_stringptr, &smtp_banner },
336 { "smtp_check_spool_space", opt_bool, &smtp_check_spool_space },
337 { "smtp_connect_backlog", opt_int, &smtp_connect_backlog },
338 { "smtp_enforce_sync", opt_bool, &smtp_enforce_sync },
339 { "smtp_etrn_command", opt_stringptr, &smtp_etrn_command },
340 { "smtp_etrn_serialize", opt_bool, &smtp_etrn_serialize },
341 { "smtp_load_reserve", opt_fixed, &smtp_load_reserve },
342 { "smtp_max_synprot_errors", opt_int, &smtp_max_synprot_errors },
343 { "smtp_max_unknown_commands",opt_int, &smtp_max_unknown_commands },
344 { "smtp_ratelimit_hosts", opt_stringptr, &smtp_ratelimit_hosts },
345 { "smtp_ratelimit_mail", opt_stringptr, &smtp_ratelimit_mail },
346 { "smtp_ratelimit_rcpt", opt_stringptr, &smtp_ratelimit_rcpt },
347 { "smtp_receive_timeout", opt_time, &smtp_receive_timeout },
348 { "smtp_reserve_hosts", opt_stringptr, &smtp_reserve_hosts },
349 { "smtp_return_error_details",opt_bool, &smtp_return_error_details },
350 #ifdef WITH_CONTENT_SCAN
351 { "spamd_address", opt_stringptr, &spamd_address },
353 { "split_spool_directory", opt_bool, &split_spool_directory },
354 { "spool_directory", opt_stringptr, &spool_directory },
356 { "sqlite_lock_timeout", opt_int, &sqlite_lock_timeout },
358 #ifdef EXPERIMENTAL_SRS
359 { "srs_config", opt_stringptr, &srs_config },
360 { "srs_hashlength", opt_int, &srs_hashlength },
361 { "srs_hashmin", opt_int, &srs_hashmin },
362 { "srs_maxage", opt_int, &srs_maxage },
363 { "srs_secrets", opt_stringptr, &srs_secrets },
364 { "srs_usehash", opt_bool, &srs_usehash },
365 { "srs_usetimestamp", opt_bool, &srs_usetimestamp },
367 { "strict_acl_vars", opt_bool, &strict_acl_vars },
368 { "strip_excess_angle_brackets", opt_bool, &strip_excess_angle_brackets },
369 { "strip_trailing_dot", opt_bool, &strip_trailing_dot },
370 { "syslog_duplication", opt_bool, &syslog_duplication },
371 { "syslog_facility", opt_stringptr, &syslog_facility_str },
372 { "syslog_processname", opt_stringptr, &syslog_processname },
373 { "syslog_timestamp", opt_bool, &syslog_timestamp },
374 { "system_filter", opt_stringptr, &system_filter },
375 { "system_filter_directory_transport", opt_stringptr,&system_filter_directory_transport },
376 { "system_filter_file_transport",opt_stringptr,&system_filter_file_transport },
377 { "system_filter_group", opt_gid, &system_filter_gid },
378 { "system_filter_pipe_transport",opt_stringptr,&system_filter_pipe_transport },
379 { "system_filter_reply_transport",opt_stringptr,&system_filter_reply_transport },
380 { "system_filter_user", opt_uid, &system_filter_uid },
381 { "tcp_nodelay", opt_bool, &tcp_nodelay },
382 { "timeout_frozen_after", opt_time, &timeout_frozen_after },
383 { "timezone", opt_stringptr, &timezone_string },
385 { "tls_advertise_hosts", opt_stringptr, &tls_advertise_hosts },
386 { "tls_certificate", opt_stringptr, &tls_certificate },
387 { "tls_crl", opt_stringptr, &tls_crl },
388 { "tls_dhparam", opt_stringptr, &tls_dhparam },
389 { "tls_on_connect_ports", opt_stringptr, &tls_on_connect_ports },
390 { "tls_privatekey", opt_stringptr, &tls_privatekey },
391 { "tls_remember_esmtp", opt_bool, &tls_remember_esmtp },
392 { "tls_require_ciphers", opt_stringptr, &tls_require_ciphers },
393 { "tls_try_verify_hosts", opt_stringptr, &tls_try_verify_hosts },
394 { "tls_verify_certificates", opt_stringptr, &tls_verify_certificates },
395 { "tls_verify_hosts", opt_stringptr, &tls_verify_hosts },
397 { "trusted_groups", opt_gidlist, &trusted_groups },
398 { "trusted_users", opt_uidlist, &trusted_users },
399 { "unknown_login", opt_stringptr, &unknown_login },
400 { "unknown_username", opt_stringptr, &unknown_username },
401 { "untrusted_set_sender", opt_stringptr, &untrusted_set_sender },
402 { "uucp_from_pattern", opt_stringptr, &uucp_from_pattern },
403 { "uucp_from_sender", opt_stringptr, &uucp_from_sender },
404 { "warn_message_file", opt_stringptr, &warn_message_file },
405 { "write_rejectlog", opt_bool, &write_rejectlog }
408 static int optionlist_config_size =
409 sizeof(optionlist_config)/sizeof(optionlist);
413 /*************************************************
414 * Find the name of an option *
415 *************************************************/
417 /* This function is to aid debugging. Various functions take arguments that are
418 pointer variables in the options table or in option tables for various drivers.
419 For debugging output, it is useful to be able to find the name of the option
420 which is currently being processed. This function finds it, if it exists, by
421 searching the table(s).
423 Arguments: a value that is presumed to be in the table above
424 Returns: the option name, or an empty string
428 readconf_find_option(void *p)
432 transport_instance *t;
434 for (i = 0; i < optionlist_config_size; i++)
435 if (p == optionlist_config[i].value) return US optionlist_config[i].name;
437 for (r = routers; r != NULL; r = r->next)
439 router_info *ri = r->info;
440 for (i = 0; i < ri->options_count[0]; i++)
442 if ((ri->options[i].type & opt_mask) != opt_stringptr) continue;
443 if (p == (char *)(r->options_block) + (long int)(ri->options[i].value))
444 return US ri->options[i].name;
448 for (t = transports; t != NULL; t = t->next)
450 transport_info *ti = t->info;
451 for (i = 0; i < ti->options_count[0]; i++)
453 if ((ti->options[i].type & opt_mask) != opt_stringptr) continue;
454 if (p == (char *)(t->options_block) + (long int)(ti->options[i].value))
455 return US ti->options[i].name;
465 /*************************************************
466 * Deal with an assignment to a macro *
467 *************************************************/
469 /* This function is called when a line that starts with an upper case letter is
470 encountered. The argument "line" should contain a complete logical line, and
471 start with the first letter of the macro name. The macro name and the
472 replacement text are extracted and stored. Redefinition of existing,
473 non-command line, macros is permitted using '==' instead of '='.
476 s points to the start of the logical line
482 read_macro_assignment(uschar *s)
488 macro_item *mlast = NULL;
490 while (isalnum(*s) || *s == '_')
492 if (namelen >= sizeof(name) - 1)
493 log_write(0, LOG_PANIC_DIE|LOG_CONFIG_IN,
494 "macro name too long (maximum is %d characters)", sizeof(name) - 1);
495 name[namelen++] = *s++;
499 while (isspace(*s)) s++;
501 log_write(0, LOG_PANIC_DIE|LOG_CONFIG_IN, "malformed macro definition");
508 while (isspace(*s)) s++;
510 /* If an existing macro of the same name was defined on the command line, we
511 just skip this definition. It's an error to attempt to redefine a macro without
512 redef set to TRUE, or to redefine a macro when it hasn't been defined earlier.
513 It is also an error to define a macro whose name begins with the name of a
514 previously defined macro. Note: it is documented that the other way round
517 for (m = macros; m != NULL; m = m->next)
519 int len = Ustrlen(m->name);
521 if (Ustrcmp(m->name, name) == 0)
523 if (!m->command_line && !redef)
524 log_write(0, LOG_CONFIG|LOG_PANIC_DIE, "macro \"%s\" is already "
525 "defined (use \"==\" if you want to redefine it", name);
529 if (len < namelen && Ustrstr(name, m->name) != NULL)
530 log_write(0, LOG_CONFIG|LOG_PANIC_DIE, "\"%s\" cannot be defined as "
531 "a macro because previously defined macro \"%s\" is a substring",
534 /* We cannot have this test, because it is documented that a substring
535 macro is permitted (there is even an example).
537 * if (len > namelen && Ustrstr(m->name, name) != NULL)
538 * log_write(0, LOG_CONFIG|LOG_PANIC_DIE, "\"%s\" cannot be defined as "
539 * "a macro because it is a substring of previously defined macro \"%s\"",
546 /* Check for an overriding command-line definition. */
548 if (m != NULL && m->command_line) return;
550 /* Redefinition must refer to an existing macro. */
555 log_write(0, LOG_CONFIG|LOG_PANIC_DIE, "can't redefine an undefined macro "
559 /* We have a new definition. The macro_item structure includes a final vector
560 called "name" which is one byte long. Thus, adding "namelen" gives us enough
561 room to store the "name" string. */
565 m = store_get(sizeof(macro_item) + namelen);
566 if (macros == NULL) macros = m; else mlast->next = m;
567 Ustrncpy(m->name, name, namelen);
568 m->name[namelen] = 0;
570 m->command_line = FALSE;
573 /* Set the value of the new or redefined macro */
575 m->replacement = string_copy(s);
582 /*************************************************
583 * Read configuration line *
584 *************************************************/
586 /* A logical line of text is read from the configuration file into the big
587 buffer, taking account of macros, .includes, and continuations. The size of
588 big_buffer is increased if necessary. The count of configuration lines is
589 maintained. Physical input lines starting with # (ignoring leading white space,
590 and after macro replacement) and empty logical lines are always ignored.
591 Leading and trailing spaces are removed.
593 If we hit a line of the form "begin xxxx", the xxxx is placed in the
594 next_section vector, and the function returns NULL, indicating the end of a
595 configuration section. On end-of-file, NULL is returned with next_section
600 Returns: a pointer to the first non-blank in the line,
601 or NULL if eof or end of section is reached
605 get_config_line(void)
607 int startoffset = 0; /* To first non-blank char in logical line */
608 int len = 0; /* Of logical line so far */
614 /* Loop for handling continuation lines, skipping comments, and dealing with
619 if (Ufgets(big_buffer+len, big_buffer_size-len, config_file) == NULL)
621 if (config_file_stack != NULL) /* EOF inside .include */
623 (void)fclose(config_file);
624 config_file = config_file_stack->file;
625 config_filename = config_file_stack->filename;
626 config_lineno = config_file_stack->lineno;
627 config_file_stack = config_file_stack->next;
631 /* EOF at top level */
633 if (cstate_stack_ptr >= 0)
634 log_write(0, LOG_PANIC_DIE|LOG_CONFIG_IN,
635 "Unexpected end of configuration file: .endif missing");
637 if (len != 0) break; /* EOF after continuation */
638 next_section[0] = 0; /* EOF at start of logical line */
643 newlen = len + Ustrlen(big_buffer + len);
645 /* Handle pathologically long physical lines - yes, it did happen - by
646 extending big_buffer at this point. The code also copes with very long
649 while (newlen == big_buffer_size - 1 && big_buffer[newlen - 1] != '\n')
652 big_buffer_size += BIG_BUFFER_SIZE;
653 newbuffer = store_malloc(big_buffer_size);
655 /* This use of strcpy is OK because we know that the string in the old
656 buffer is shorter than the new buffer. */
658 Ustrcpy(newbuffer, big_buffer);
659 store_free(big_buffer);
660 big_buffer = newbuffer;
661 if (Ufgets(big_buffer+newlen, big_buffer_size-newlen, config_file) == NULL)
663 newlen += Ustrlen(big_buffer + newlen);
666 /* Find the true start of the physical line - leading spaces are always
669 ss = big_buffer + len;
670 while (isspace(*ss)) ss++;
672 /* Process the physical line for macros. If this is the start of the logical
673 line, skip over initial text at the start of the line if it starts with an
674 upper case character followed by a sequence of name characters and an equals
675 sign, because that is the definition of a new macro, and we don't do
676 replacement therein. */
679 if (len == 0 && isupper(*s))
681 while (isalnum(*s) || *s == '_') s++;
682 while (isspace(*s)) s++;
683 if (*s != '=') s = ss; /* Not a macro definition */
686 /* For each defined macro, scan the line (from after XXX= if present),
687 replacing all occurrences of the macro. */
690 for (m = macros; m != NULL; m = m->next)
695 while ((p = Ustrstr(t, m->name)) != NULL)
698 int namelen = Ustrlen(m->name);
699 int replen = Ustrlen(m->replacement);
701 /* Expand the buffer if necessary */
703 while (newlen - namelen + replen + 1 > big_buffer_size)
705 int newsize = big_buffer_size + BIG_BUFFER_SIZE;
706 uschar *newbuffer = store_malloc(newsize);
707 memcpy(newbuffer, big_buffer, newlen + 1);
708 p = newbuffer + (p - big_buffer);
709 s = newbuffer + (s - big_buffer);
710 ss = newbuffer + (ss - big_buffer);
711 t = newbuffer + (t - big_buffer);
712 big_buffer_size = newsize;
713 store_free(big_buffer);
714 big_buffer = newbuffer;
717 /* Shuffle the remaining characters up or down in the buffer before
718 copying in the replacement text. Don't rescan the replacement for this
722 moveby = replen - namelen;
725 memmove(p + replen, pp, (big_buffer + newlen) - pp + 1);
728 Ustrncpy(p, m->replacement, replen);
734 /* An empty macro replacement at the start of a line could mean that ss no
735 longer points to the first non-blank character. */
737 while (isspace(*ss)) ss++;
739 /* Check for comment lines - these are physical lines. */
741 if (*ss == '#') continue;
743 /* Handle conditionals, which are also applied to physical lines. Conditions
744 are of the form ".ifdef ANYTEXT" and are treated as true if any macro
745 expansion occured on the rest of the line. A preliminary test for the leading
746 '.' saves effort on most lines. */
752 /* Search the list of conditional directives */
754 for (i = 0; i < cond_list_size; i++)
757 cond_item *c = cond_list+i;
758 if (Ustrncmp(ss+1, c->name, c->namelen) != 0) continue;
760 /* The following character must be white space or end of string */
762 n = ss[1 + c->namelen];
763 if (n != ' ' && n != 't' && n != '\n' && n != 0) break;
765 /* .ifdef and .ifndef push the current state onto the stack, then set
766 a new one from the table. Stack overflow is an error */
770 if (cstate_stack_ptr >= CSTATE_STACK_SIZE - 1)
771 log_write(0, LOG_PANIC_DIE|LOG_CONFIG_IN,
772 ".%s nested too deeply", c->name);
773 cstate_stack[++cstate_stack_ptr] = cstate;
774 cstate = next_cstate[cstate][macro_found? c->action1 : c->action2];
777 /* For any of the others, stack underflow is an error. The next state
778 comes either from the stack (.endif) or from the table. */
782 if (cstate_stack_ptr < 0)
783 log_write(0, LOG_PANIC_DIE|LOG_CONFIG_IN,
784 ".%s without matching .ifdef", c->name);
785 cstate = (c->pushpop < 0)? cstate_stack[cstate_stack_ptr--] :
786 next_cstate[cstate][macro_found? c->action1 : c->action2];
789 /* Having dealt with a directive, break the loop */
794 /* If we have handled a conditional directive, continue with the next
795 physical line. Otherwise, fall through. */
797 if (i < cond_list_size) continue;
800 /* If the conditional state is not 0 (actively using these lines), ignore
803 if (cstate != 0) continue; /* Conditional skip */
805 /* Handle .include lines - these are also physical lines. */
807 if (Ustrncmp(ss, ".include", 8) == 0 &&
809 (Ustrncmp(ss+8, "_if_exists", 10) == 0 && isspace(ss[18]))))
812 int include_if_exists = isspace(ss[8])? 0 : 10;
813 config_file_item *save;
816 ss += 9 + include_if_exists;
817 while (isspace(*ss)) ss++;
818 t = ss + Ustrlen(ss);
819 while (t > ss && isspace(t[-1])) t--;
820 if (*ss == '\"' && t[-1] == '\"')
828 log_write(0, LOG_PANIC_DIE|LOG_CONFIG_IN, ".include specifies a non-"
829 "absolute path \"%s\"", ss);
831 if (include_if_exists != 0 && (Ustat(ss, &statbuf) != 0)) continue;
833 save = store_get(sizeof(config_file_item));
834 save->next = config_file_stack;
835 config_file_stack = save;
836 save->file = config_file;
837 save->filename = config_filename;
838 save->lineno = config_lineno;
840 config_file = Ufopen(ss, "rb");
841 if (config_file == NULL)
842 log_write(0, LOG_PANIC_DIE|LOG_CONFIG_IN, "failed to open included "
843 "configuration file %s", ss);
844 config_filename = string_copy(ss);
849 /* If this is the start of the logical line, remember where the non-blank
850 data starts. Otherwise shuffle down continuation lines to remove leading
854 startoffset = ss - big_buffer;
857 s = big_buffer + len;
860 memmove(s, ss, (newlen - len) - (ss - s) + 1);
865 /* Accept the new addition to the line. Remove trailing white space. */
868 while (len > 0 && isspace(big_buffer[len-1])) len--;
871 /* We are done if the line does not end in backslash and contains some data.
872 Empty logical lines are ignored. For continuations, remove the backslash and
873 go round the loop to read the continuation line. */
877 if (big_buffer[len-1] != '\\') break; /* End of logical line */
878 big_buffer[--len] = 0; /* Remove backslash */
880 } /* Loop for reading multiple physical lines */
882 /* We now have a logical line. Test for the end of a configuration section (or,
883 more accurately, for the start of the next section). Place the name of the next
884 section in next_section, and return NULL. If the name given is longer than
885 next_section, truncate it. It will be unrecognized later, because all the known
886 section names do fit. Leave space for pluralizing. */
888 s = big_buffer + startoffset; /* First non-space character */
889 if (strncmpic(s, US"begin ", 6) == 0)
892 while (isspace(*s)) s++;
893 if (big_buffer + len - s > sizeof(next_section) - 2)
894 s[sizeof(next_section) - 2] = 0;
895 Ustrcpy(next_section, s);
899 /* Return the first non-blank character. */
906 /*************************************************
908 *************************************************/
910 /* The yield is the pointer to the next uschar. Names longer than the
911 output space are silently truncated. This function is also used from acl.c when
915 name where to put the name
919 Returns: new input pointer
923 readconf_readname(uschar *name, int len, uschar *s)
926 while (isspace(*s)) s++;
929 while (isalnum(*s) || *s == '_')
931 if (p < len-1) name[p++] = *s;
936 while (isspace(*s)) s++;
943 /*************************************************
944 * Read a time value *
945 *************************************************/
947 /* This function is also called from outside, to read argument
948 time values. The format of a time value is:
950 [<n>w][<n>d][<n>h][<n>m][<n>s]
952 as long as at least one is present. If a format error is encountered,
953 return a negative value. The value must be terminated by the given
958 terminator required terminating character
959 return_msec if TRUE, allow fractional seconds and return milliseconds
961 Returns: the time value, or -1 on syntax error
962 value is seconds if return_msec is FALSE
963 value is milliseconds if return_msec is TRUE
967 readconf_readtime(uschar *s, int terminator, BOOL return_msec)
975 if (!isdigit(*s)) return -1;
976 (void)sscanf(CS s, "%d%n", &value, &count);
981 case 'w': value *= 7;
982 case 'd': value *= 24;
983 case 'h': value *= 60;
984 case 'm': value *= 60;
989 if (!return_msec) return -1;
990 (void)sscanf(CS s, "%lf%n", &fraction, &count);
992 if (*s++ != 's') return -1;
993 yield += (int)(fraction * 1000.0);
999 if (return_msec) value *= 1000;
1001 if (*s == terminator) return yield;
1003 /* Control never reaches here. */
1008 /*************************************************
1009 * Read a fixed point value *
1010 *************************************************/
1012 /* The value is returned *1000
1016 terminator required terminator
1018 Returns: the value, or -1 on error
1022 readconf_readfixed(uschar *s, int terminator)
1026 if (!isdigit(*s)) return -1;
1027 (void)sscanf(CS s, "%d%n", &value, &count);
1029 yield = value * 1000;
1033 while (isdigit((*(++s))))
1035 yield += (*s - '0') * m;
1040 return (*s == terminator)? yield : (-1);
1045 /*************************************************
1046 * Find option in list *
1047 *************************************************/
1049 /* The lists are always in order, so binary chop can be used.
1052 name the option name to search for
1053 ol the first entry in the option list
1054 last one more than the offset of the last entry in the option list
1056 Returns: pointer to an option entry, or NULL if not found
1060 find_option(uschar *name, optionlist *ol, int last)
1063 while (last > first)
1065 int middle = (first + last)/2;
1066 int c = Ustrcmp(name, ol[middle].name);
1067 if (c == 0) return ol + middle;
1068 else if (c > 0) first = middle + 1;
1076 /*************************************************
1077 * Find a set flag in option list *
1078 *************************************************/
1080 /* Because some versions of Unix make no restrictions on the values of uids and
1081 gids (even negative ones), we cannot represent "unset" by a special value.
1082 There is therefore a separate boolean variable for each one indicating whether
1083 a value is set or not. This function returns a pointer to the boolean, given
1084 the original option name. It is a major disaster if the flag cannot be found.
1087 name the name of the uid or gid option
1088 oltop points to the start of the relevant option list
1089 last one more than the offset of the last item in the option list
1090 data_block NULL when reading main options => data values in the option
1091 list are absolute addresses; otherwise they are byte offsets
1092 in data_block (used for driver options)
1094 Returns: a pointer to the boolean flag.
1098 get_set_flag(uschar *name, optionlist *oltop, int last, void *data_block)
1102 sprintf(CS name2, "*set_%.50s", name);
1103 ol = find_option(name2, oltop, last);
1104 if (ol == NULL) log_write(0, LOG_MAIN|LOG_PANIC_DIE,
1105 "Exim internal error: missing set flag for %s", name);
1106 return (data_block == NULL)? (BOOL *)(ol->value) :
1107 (BOOL *)((uschar *)data_block + (long int)(ol->value));
1113 /*************************************************
1114 * Output extra characters message and die *
1115 *************************************************/
1117 /* Called when an option line has junk on the end. Sometimes this is because
1118 the sysadmin thinks comments are permitted.
1121 s points to the extra characters
1122 t1..t3 strings to insert in the log message
1124 Returns: doesn't return; dies
1128 extra_chars_error(uschar *s, uschar *t1, uschar *t2, uschar *t3)
1130 uschar *comment = US"";
1131 if (*s == '#') comment = US" (# is comment only at line start)";
1132 log_write(0, LOG_PANIC_DIE|LOG_CONFIG_IN,
1133 "extra characters follow %s%s%s%s", t1, t2, t3, comment);
1138 /*************************************************
1139 * Read rewrite information *
1140 *************************************************/
1142 /* Each line of rewrite information contains:
1144 . A complete address in the form user@domain, possibly with
1145 leading * for each part; or alternatively, a regex.
1147 . A replacement string (which will be expanded).
1149 . An optional sequence of one-letter flags, indicating which
1150 headers etc. to apply this rule to.
1152 All this is decoded and placed into a control block. The OR of the flags is
1153 maintained in a common word.
1156 p points to the string that makes up the rule
1157 existflags points to the overall flag word
1158 isglobal TRUE if reading global rewrite rules
1160 Returns: the control block for the parsed rule.
1163 static rewrite_rule *
1164 readconf_one_rewrite(uschar *p, int *existflags, BOOL isglobal)
1166 rewrite_rule *next = store_get(sizeof(rewrite_rule));
1169 next->key = string_dequote(&p);
1171 while (isspace(*p)) p++;
1173 log_write(0, LOG_PANIC_DIE|LOG_CONFIG_IN,
1174 "missing rewrite replacement string");
1177 next->replacement = string_dequote(&p);
1179 while (*p != 0) switch (*p++)
1181 case ' ': case '\t': break;
1183 case 'q': next->flags |= rewrite_quit; break;
1184 case 'w': next->flags |= rewrite_whole; break;
1186 case 'h': next->flags |= rewrite_all_headers; break;
1187 case 's': next->flags |= rewrite_sender; break;
1188 case 'f': next->flags |= rewrite_from; break;
1189 case 't': next->flags |= rewrite_to; break;
1190 case 'c': next->flags |= rewrite_cc; break;
1191 case 'b': next->flags |= rewrite_bcc; break;
1192 case 'r': next->flags |= rewrite_replyto; break;
1194 case 'E': next->flags |= rewrite_all_envelope; break;
1195 case 'F': next->flags |= rewrite_envfrom; break;
1196 case 'T': next->flags |= rewrite_envto; break;
1198 case 'Q': next->flags |= rewrite_qualify; break;
1199 case 'R': next->flags |= rewrite_repeat; break;
1202 next->flags |= rewrite_smtp;
1203 if (next->key[0] != '^' && Ustrncmp(next->key, "\\N^", 3) != 0)
1204 log_write(0, LOG_PANIC_DIE|LOG_CONFIG_IN,
1205 "rewrite rule has the S flag but is not a regular expression");
1209 log_write(0, LOG_PANIC_DIE|LOG_CONFIG_IN,
1210 "unknown rewrite flag character '%c' "
1211 "(could be missing quotes round replacement item)", p[-1]);
1215 /* If no action flags are set, set all the "normal" rewrites. */
1217 if ((next->flags & (rewrite_all | rewrite_smtp)) == 0)
1218 next->flags |= isglobal? rewrite_all : rewrite_all_headers;
1220 /* Remember which exist, for optimization, and return the rule */
1222 *existflags |= next->flags;
1229 /*************************************************
1230 * Read global rewrite information *
1231 *************************************************/
1233 /* Each line is a single rewrite rule; it is parsed into a control block
1234 by readconf_one_rewrite(), and its flags are ORed into the global flag
1235 word rewrite_existflags. */
1238 readconf_rewrites(void)
1240 rewrite_rule **chain = &global_rewrite_rules;
1243 while ((p = get_config_line()) != NULL)
1245 rewrite_rule *next = readconf_one_rewrite(p, &rewrite_existflags, TRUE);
1247 chain = &(next->next);
1253 /*************************************************
1255 *************************************************/
1257 /* Strings are read into the normal store pool. As long we aren't too
1258 near the end of the current block, the string will just use what is necessary
1259 on the top of the stacking pool, because string_cat() uses the extension
1263 s the rest of the input line
1264 name the option name (for errors)
1266 Returns: pointer to the string
1270 read_string(uschar *s, uschar *name)
1275 if (*s != '\"') return string_copy(s);
1278 yield = string_dequote(&s);
1280 if (s == ss+1 || s[-1] != '\"')
1281 log_write(0, LOG_PANIC_DIE|LOG_CONFIG_IN,
1282 "missing quote at end of string value for %s", name);
1284 if (*s != 0) extra_chars_error(s, US"string value for ", name, US"");
1290 /*************************************************
1291 * Handle option line *
1292 *************************************************/
1294 /* This function is called from several places to process a line containing the
1295 setting of an option. The first argument is the line to be decoded; it has been
1296 checked not to be empty and not to start with '#'. Trailing newlines and white
1297 space have been removed. The second argument is a pointer to the list of
1298 variable names that are to be recognized, together with their types and
1299 locations, and the third argument gives the number of entries in the list.
1301 The fourth argument is a pointer to a data block. If it is NULL, then the data
1302 values in the options list are absolute addresses. Otherwise, they are byte
1303 offsets in the data block.
1305 String option data may continue onto several lines; this function reads further
1306 data from config_file if necessary.
1308 The yield of this function is normally zero. If a string continues onto
1309 multiple lines, then the data value is permitted to be followed by a comma
1310 or a semicolon (for use in drivers) and the yield is that character.
1313 buffer contains the configuration line to be handled
1314 oltop points to the start of the relevant option list
1315 last one more than the offset of the last item in the option list
1316 data_block NULL when reading main options => data values in the option
1317 list are absolute addresses; otherwise they are byte offsets
1318 in data_block when they have opt_public set; otherwise
1319 they are byte offsets in data_block->options_block.
1320 unknown_txt format string to use in panic message for unknown option;
1321 must contain %s for option name
1322 if given as NULL, don't panic on unknown option
1324 Returns: TRUE if an option was read successfully,
1325 FALSE false for an unknown option if unknown_txt == NULL,
1326 otherwise panic and die on an unknown option
1330 readconf_handle_option(uschar *buffer, optionlist *oltop, int last,
1331 void *data_block, uschar *unknown_txt)
1335 int n, count, type, value;
1339 BOOL boolvalue = TRUE;
1340 BOOL freesptr = TRUE;
1341 optionlist *ol, *ol2;
1345 uschar *inttype = US"";
1351 /* There may be leading spaces; thereafter, we expect an option name starting
1354 while (isspace(*s)) s++;
1356 log_write(0, LOG_PANIC_DIE|LOG_CONFIG_IN, "option setting expected: %s", s);
1358 /* Read the name of the option, and skip any subsequent white space. If
1359 it turns out that what we read was "hide", set the flag indicating that
1360 this is a secure option, and loop to read the next word. */
1362 for (n = 0; n < 2; n++)
1364 while (isalnum(*s) || *s == '_')
1366 if (ptr < sizeof(name)-1) name[ptr++] = *s;
1370 while (isspace(*s)) s++;
1371 if (Ustrcmp(name, "hide") != 0) break;
1372 issecure = opt_secure;
1376 /* Deal with "no_" or "not_" here for booleans */
1378 if (Ustrncmp(name, "no_", 3) == 0)
1384 if (Ustrncmp(name, "not_", 4) == 0)
1390 /* Search the list for the given name. A non-existent name, or an option that
1391 is set twice, is a disaster. */
1393 ol = find_option(name + offset, oltop, last);
1397 if (unknown_txt == NULL) return FALSE;
1398 log_write(0, LOG_PANIC_DIE|LOG_CONFIG_IN, CS unknown_txt, name);
1401 if ((ol->type & opt_set) != 0)
1403 uschar *mname = name;
1404 if (Ustrncmp(mname, "no_", 3) == 0) mname += 3;
1405 log_write(0, LOG_PANIC_DIE|LOG_CONFIG_IN,
1406 "\"%s\" option set for the second time", mname);
1409 ol->type |= opt_set | issecure;
1410 type = ol->type & opt_mask;
1412 /* Types with data values must be followed by '='; the "no[t]_" prefix
1413 applies only to boolean values. */
1415 if (type < opt_bool || type > opt_bool_last)
1418 log_write(0, LOG_PANIC_DIE|LOG_CONFIG_IN,
1419 "negation prefix applied to a non-boolean option");
1421 log_write(0, LOG_PANIC_DIE|LOG_CONFIG_IN,
1422 "unexpected end of line (data missing) after %s", name);
1424 log_write(0, LOG_PANIC_DIE|LOG_CONFIG_IN, "missing \"=\" after %s", name);
1427 /* If a boolean wasn't preceded by "no[t]_" it can be followed by = and
1428 true/false/yes/no, or, in the case of opt_expanded_bool, a general string that
1429 ultimately expands to one of those values. */
1431 else if (*s != 0 && (offset != 0 || *s != '='))
1432 extra_chars_error(s, US"boolean option ", name, US"");
1434 /* Skip white space after = */
1436 if (*s == '=') while (isspace((*(++s))));
1438 /* If there is a data block and the opt_public flag is not set, change
1439 the data block pointer to the private options block. */
1441 if (data_block != NULL && (ol->type & opt_public) == 0)
1442 data_block = (void *)(((driver_instance *)data_block)->options_block);
1444 /* Now get the data according to the type. */
1448 /* If a string value is not enclosed in quotes, it consists of
1449 the rest of the current line, verbatim. Otherwise, string escapes
1452 A transport is specified as a string, which is then looked up in the
1453 list of transports. A search type is specified as one of a number of
1456 A set or rewrite rules for a driver is specified as a string, which is
1457 then parsed into a suitable chain of control blocks.
1459 Uids and gids are specified as strings which are then looked up in the
1460 passwd file. Lists of uids and gids are similarly specified as colon-
1461 separated strings. */
1466 case opt_expand_uid:
1467 case opt_expand_gid:
1472 reset_point = sptr = read_string(s, name);
1474 /* Having read a string, we now have several different ways of using it,
1475 depending on the data type, so do another switch. If keeping the actual
1476 string is not required (because it is interpreted), freesptr is set TRUE,
1477 and at the end we reset the pool. */
1481 /* If this was a string, set the variable to point to the new string,
1482 and set the flag so its store isn't reclaimed. If it was a list of rewrite
1483 rules, we still keep the string (for printing), and parse the rules into a
1484 control block and flags word. */
1488 if (data_block == NULL)
1489 *((uschar **)(ol->value)) = sptr;
1491 *((uschar **)((uschar *)data_block + (long int)(ol->value))) = sptr;
1493 if (type == opt_rewrite)
1498 rewrite_rule **chain;
1501 sprintf(CS name2, "*%.50s_rules", name);
1502 ol2 = find_option(name2, oltop, last);
1503 sprintf(CS name2, "*%.50s_flags", name);
1504 ol3 = find_option(name2, oltop, last);
1506 if (ol2 == NULL || ol3 == NULL)
1507 log_write(0, LOG_PANIC_DIE|LOG_CONFIG_IN,
1508 "rewrite rules not available for driver");
1510 if (data_block == NULL)
1512 chain = (rewrite_rule **)(ol2->value);
1513 flagptr = (int *)(ol3->value);
1517 chain = (rewrite_rule **)((uschar *)data_block + (long int)(ol2->value));
1518 flagptr = (int *)((uschar *)data_block + (long int)(ol3->value));
1521 while ((p = string_nextinlist(&sptr, &sep, big_buffer, BIG_BUFFER_SIZE))
1524 rewrite_rule *next = readconf_one_rewrite(p, flagptr, FALSE);
1526 chain = &(next->next);
1529 if ((*flagptr & (rewrite_all_envelope | rewrite_smtp)) != 0)
1530 log_write(0, LOG_PANIC_DIE|LOG_CONFIG_IN, "rewrite rule specifies a "
1531 "non-header rewrite - not allowed at transport time -");
1535 /* If it was an expanded uid, see if there is any expansion to be
1536 done by checking for the presence of a $ character. If there is, save it
1537 in the corresponding *expand_user option field. Otherwise, fall through
1538 to treat it as a fixed uid. Ensure mutual exclusivity of the two kinds
1541 case opt_expand_uid:
1542 sprintf(CS name2, "*expand_%.50s", name);
1543 ol2 = find_option(name2, oltop, last);
1546 uschar *ss = (Ustrchr(sptr, '$') != NULL)? sptr : NULL;
1548 if (data_block == NULL)
1549 *((uschar **)(ol2->value)) = ss;
1551 *((uschar **)((uschar *)data_block + (long int)(ol2->value))) = ss;
1555 *(get_set_flag(name, oltop, last, data_block)) = FALSE;
1561 /* Look up a fixed uid, and also make use of the corresponding gid
1562 if a passwd entry is returned and the gid has not been set. */
1565 if (!route_finduser(sptr, &pw, &uid))
1566 log_write(0, LOG_PANIC_DIE|LOG_CONFIG_IN, "user %s was not found", sptr);
1567 if (data_block == NULL)
1568 *((uid_t *)(ol->value)) = uid;
1570 *((uid_t *)((uschar *)data_block + (long int)(ol->value))) = uid;
1572 /* Set the flag indicating a fixed value is set */
1574 *(get_set_flag(name, oltop, last, data_block)) = TRUE;
1576 /* Handle matching gid if we have a passwd entry: done by finding the
1577 same name with terminating "user" changed to "group"; if not found,
1578 ignore. Also ignore if the value is already set. */
1580 if (pw == NULL) break;
1581 Ustrcpy(name+Ustrlen(name)-4, "group");
1582 ol2 = find_option(name, oltop, last);
1583 if (ol2 != NULL && ((ol2->type & opt_mask) == opt_gid ||
1584 (ol2->type & opt_mask) == opt_expand_gid))
1586 BOOL *set_flag = get_set_flag(name, oltop, last, data_block);
1589 if (data_block == NULL)
1590 *((gid_t *)(ol2->value)) = pw->pw_gid;
1592 *((gid_t *)((uschar *)data_block + (long int)(ol2->value))) = pw->pw_gid;
1598 /* If it was an expanded gid, see if there is any expansion to be
1599 done by checking for the presence of a $ character. If there is, save it
1600 in the corresponding *expand_user option field. Otherwise, fall through
1601 to treat it as a fixed gid. Ensure mutual exclusivity of the two kinds
1604 case opt_expand_gid:
1605 sprintf(CS name2, "*expand_%.50s", name);
1606 ol2 = find_option(name2, oltop, last);
1609 uschar *ss = (Ustrchr(sptr, '$') != NULL)? sptr : NULL;
1611 if (data_block == NULL)
1612 *((uschar **)(ol2->value)) = ss;
1614 *((uschar **)((uschar *)data_block + (long int)(ol2->value))) = ss;
1618 *(get_set_flag(name, oltop, last, data_block)) = FALSE;
1624 /* Handle freestanding gid */
1627 if (!route_findgroup(sptr, &gid))
1628 log_write(0, LOG_PANIC_DIE|LOG_CONFIG_IN, "group %s was not found", sptr);
1629 if (data_block == NULL)
1630 *((gid_t *)(ol->value)) = gid;
1632 *((gid_t *)((uschar *)data_block + (long int)(ol->value))) = gid;
1633 *(get_set_flag(name, oltop, last, data_block)) = TRUE;
1636 /* If it was a uid list, look up each individual entry, and build
1637 a vector of uids, with a count in the first element. Put the vector
1638 in malloc store so we can free the string. (We are reading into
1639 permanent store already.) */
1647 uschar *op = expand_string (sptr);
1650 log_write(0, LOG_PANIC_DIE|LOG_CONFIG_IN, "failed to expand %s: %s",
1651 name, expand_string_message);
1654 if (*p != 0) count++;
1655 while (*p != 0) if (*p++ == ':' && *p != 0) count++;
1656 list = store_malloc(count*sizeof(uid_t));
1657 list[ptr++] = (uid_t)(count - 1);
1659 if (data_block == NULL)
1660 *((uid_t **)(ol->value)) = list;
1662 *((uid_t **)((uschar *)data_block + (long int)(ol->value))) = list;
1668 (void)string_nextinlist(&p, &sep, big_buffer, BIG_BUFFER_SIZE);
1669 if (!route_finduser(big_buffer, NULL, &uid))
1670 log_write(0, LOG_PANIC_DIE|LOG_CONFIG_IN, "user %s was not found",
1677 /* If it was a gid list, look up each individual entry, and build
1678 a vector of gids, with a count in the first element. Put the vector
1679 in malloc store so we can free the string. (We are reading into permanent
1688 uschar *op = expand_string (sptr);
1691 log_write(0, LOG_PANIC_DIE|LOG_CONFIG_IN, "failed to expand %s: %s",
1692 name, expand_string_message);
1695 if (*p != 0) count++;
1696 while (*p != 0) if (*p++ == ':' && *p != 0) count++;
1697 list = store_malloc(count*sizeof(gid_t));
1698 list[ptr++] = (gid_t)(count - 1);
1700 if (data_block == NULL)
1701 *((gid_t **)(ol->value)) = list;
1703 *((gid_t **)((uschar *)data_block + (long int)(ol->value))) = list;
1709 (void)string_nextinlist(&p, &sep, big_buffer, BIG_BUFFER_SIZE);
1710 if (!route_findgroup(big_buffer, &gid))
1711 log_write(0, LOG_PANIC_DIE|LOG_CONFIG_IN, "group %s was not found",
1719 /* Release store if the value of the string doesn't need to be kept. */
1721 if (freesptr) store_reset(reset_point);
1724 /* Expanded boolean: if no characters follow, or if there are no dollar
1725 characters, this is a fixed-valued boolean, and we fall through. Otherwise,
1726 save the string for later expansion in the alternate place. */
1728 case opt_expand_bool:
1729 if (*s != 0 && Ustrchr(s, '$') != 0)
1731 sprintf(CS name2, "*expand_%.50s", name);
1732 ol2 = find_option(name2, oltop, last);
1735 reset_point = sptr = read_string(s, name);
1736 if (data_block == NULL)
1737 *((uschar **)(ol2->value)) = sptr;
1739 *((uschar **)((uschar *)data_block + (long int)(ol2->value))) = sptr;
1746 /* Boolean: if no characters follow, the value is boolvalue. Otherwise
1747 look for yes/not/true/false. Some booleans are stored in a single bit in
1748 a single int. There's a special fudge for verify settings; without a suffix
1749 they set both xx_sender and xx_recipient. The table points to the sender
1750 value; search subsequently for the recipient. There's another special case:
1751 opt_bool_set also notes when a boolean has been set. */
1755 case opt_bool_verify:
1759 s = readconf_readname(name2, 64, s);
1760 if (strcmpic(name2, US"true") == 0 || strcmpic(name2, US"yes") == 0)
1762 else if (strcmpic(name2, US"false") == 0 || strcmpic(name2, US"no") == 0)
1764 else log_write(0, LOG_PANIC_DIE|LOG_CONFIG_IN,
1765 "\"%s\" is not a valid value for the \"%s\" option", name2, name);
1766 if (*s != 0) extra_chars_error(s, string_sprintf("\"%s\" ", name2),
1767 US"for boolean option ", name);
1770 /* Handle single-bit type. */
1772 if (type == opt_bit)
1774 int bit = 1 << ((ol->type >> 16) & 31);
1775 int *ptr = (data_block == NULL)?
1776 (int *)(ol->value) :
1777 (int *)((uschar *)data_block + (long int)ol->value);
1778 if (boolvalue) *ptr |= bit; else *ptr &= ~bit;
1782 /* Handle full BOOL types */
1784 if (data_block == NULL)
1785 *((BOOL *)(ol->value)) = boolvalue;
1787 *((BOOL *)((uschar *)data_block + (long int)(ol->value))) = boolvalue;
1791 if (type == opt_bool_verify)
1793 sprintf(CS name2, "%.50s_recipient", name + offset);
1794 ol2 = find_option(name2, oltop, last);
1797 if (data_block == NULL)
1798 *((BOOL *)(ol2->value)) = boolvalue;
1800 *((BOOL *)((uschar *)data_block + (long int)(ol2->value))) = boolvalue;
1804 /* Note that opt_bool_set type is set, if there is somewhere to do so */
1806 else if (type == opt_bool_set)
1808 sprintf(CS name2, "*set_%.50s", name + offset);
1809 ol2 = find_option(name2, oltop, last);
1812 if (data_block == NULL)
1813 *((BOOL *)(ol2->value)) = TRUE;
1815 *((BOOL *)((uschar *)data_block + (long int)(ol2->value))) = TRUE;
1824 inttype = US"octal ";
1826 /* Integer: a simple(ish) case; allow octal and hex formats, and
1827 suffixes K and M. The different types affect output, not input. */
1836 lvalue = strtol(CS s, CSS &endptr, intbase);
1839 log_write(0, LOG_PANIC_DIE|LOG_CONFIG_IN, "%sinteger expected for %s",
1842 if (errno != ERANGE)
1844 if (tolower(*endptr) == 'k')
1846 if (lvalue > INT_MAX/1024 || lvalue < INT_MIN/1024) errno = ERANGE;
1847 else lvalue *= 1024;
1850 else if (tolower(*endptr) == 'm')
1852 if (lvalue > INT_MAX/(1024*1024) || lvalue < INT_MIN/(1024*1024))
1854 else lvalue *= 1024*1024;
1859 if (errno == ERANGE || lvalue > INT_MAX || lvalue < INT_MIN)
1860 log_write(0, LOG_PANIC_DIE|LOG_CONFIG_IN,
1861 "absolute value of integer \"%s\" is too large (overflow)", s);
1863 while (isspace(*endptr)) endptr++;
1865 extra_chars_error(endptr, inttype, US"integer value for ", name);
1867 value = (int)lvalue;
1870 if (data_block == NULL)
1871 *((int *)(ol->value)) = value;
1873 *((int *)((uschar *)data_block + (long int)(ol->value))) = value;
1876 /* Integer held in K: again, allow octal and hex formats, and suffixes K and
1883 value = strtol(CS s, CSS &endptr, intbase);
1886 log_write(0, LOG_PANIC_DIE|LOG_CONFIG_IN, "%sinteger expected for %s",
1889 if (errno != ERANGE)
1891 if (tolower(*endptr) == 'm')
1893 if (value > INT_MAX/1024 || value < INT_MIN/1024) errno = ERANGE;
1897 else if (tolower(*endptr) == 'k')
1903 value = (value + 512)/1024;
1907 if (errno == ERANGE) log_write(0, LOG_PANIC_DIE|LOG_CONFIG_IN,
1908 "absolute value of integer \"%s\" is too large (overflow)", s);
1910 while (isspace(*endptr)) endptr++;
1912 extra_chars_error(endptr, inttype, US"integer value for ", name);
1915 if (data_block == NULL)
1916 *((int *)(ol->value)) = value;
1918 *((int *)((uschar *)data_block + (long int)(ol->value))) = value;
1921 /* Fixed-point number: held to 3 decimal places. */
1924 if (sscanf(CS s, "%d%n", &value, &count) != 1)
1925 log_write(0, LOG_PANIC_DIE|LOG_CONFIG_IN,
1926 "fixed-point number expected for %s", name);
1928 if (value < 0) log_write(0, LOG_PANIC_DIE|LOG_CONFIG_IN,
1929 "integer \"%s\" is too large (overflow)", s);
1933 if (value < 0) log_write(0, LOG_PANIC_DIE|LOG_CONFIG_IN,
1934 "integer \"%s\" is too large (overflow)", s);
1936 if (s[count] == '.')
1939 while (isdigit(s[++count]))
1941 value += (s[count] - '0') * d;
1946 while (isspace(s[count])) count++;
1949 extra_chars_error(s+count, US"fixed-point value for ", name, US"");
1951 if (data_block == NULL)
1952 *((int *)(ol->value)) = value;
1954 *((int *)((uschar *)data_block + (long int)(ol->value))) = value;
1957 /* There's a special routine to read time values. */
1960 value = readconf_readtime(s, 0, FALSE);
1962 log_write(0, LOG_PANIC_DIE|LOG_CONFIG_IN, "invalid time value for %s",
1964 if (data_block == NULL)
1965 *((int *)(ol->value)) = value;
1967 *((int *)((uschar *)data_block + (long int)(ol->value))) = value;
1970 /* A time list is a list of colon-separated times, with the first
1971 element holding the size of the list and the second the number of
1977 int *list = (data_block == NULL)?
1978 (int *)(ol->value) :
1979 (int *)((uschar *)data_block + (long int)(ol->value));
1981 if (*s != 0) for (count = 1; count <= list[0] - 2; count++)
1984 uschar *snext = Ustrchr(s, ':');
1988 while (ss > s && isspace(ss[-1])) ss--;
1991 value = readconf_readtime(s, terminator, FALSE);
1993 log_write(0, LOG_PANIC_DIE|LOG_CONFIG_IN, "invalid time value for %s",
1995 if (count > 1 && value <= list[count])
1996 log_write(0, LOG_PANIC_DIE|LOG_CONFIG_IN,
1997 "time value out of order for %s", name);
1998 list[count+1] = value;
1999 if (snext == NULL) break;
2001 while (isspace(*s)) s++;
2004 if (count > list[0] - 2)
2005 log_write(0, LOG_PANIC_DIE|LOG_CONFIG_IN, "too many time values for %s",
2007 if (count > 0 && list[2] == 0) count = 0;
2019 /*************************************************
2020 * Print a time value *
2021 *************************************************/
2024 Argument: a time value in seconds
2025 Returns: pointer to a fixed buffer containing the time as a string,
2026 in readconf_readtime() format
2030 readconf_printtime(int t)
2033 uschar *p = time_buffer;
2050 if (w > 0) { sprintf(CS p, "%dw", w); while (*p) p++; }
2051 if (d > 0) { sprintf(CS p, "%dd", d); while (*p) p++; }
2052 if (h > 0) { sprintf(CS p, "%dh", h); while (*p) p++; }
2053 if (m > 0) { sprintf(CS p, "%dm", m); while (*p) p++; }
2054 if (s > 0 || p == time_buffer) sprintf(CS p, "%ds", s);
2061 /*************************************************
2062 * Print an individual option value *
2063 *************************************************/
2065 /* This is used by the -bP option, so prints to the standard output.
2066 The entire options list is passed in as an argument, because some options come
2067 in pairs - typically uid/gid settings, which can either be explicit numerical
2068 values, or strings to be expanded later. If the numerical value is unset,
2069 search for "*expand_<name>" to see if there is a string equivalent.
2072 ol option entry, or NULL for an unknown option
2074 options_block NULL for main configuration options; otherwise points to
2075 a driver block; if the option doesn't have opt_public
2076 set, then options_block->options_block is where the item
2078 oltop points to the option list in which ol exists
2079 last one more than the offset of the last entry in optop
2085 print_ol(optionlist *ol, uschar *name, void *options_block,
2086 optionlist *oltop, int last)
2099 printf("%s is not a known option\n", name);
2103 /* Non-admin callers cannot see options that have been flagged secure by the
2106 if (!admin_user && (ol->type & opt_secure) != 0)
2108 printf("%s = <value not displayable>\n", name);
2112 /* Else show the value of the option */
2115 if (options_block != NULL)
2117 if ((ol->type & opt_public) == 0)
2118 options_block = (void *)(((driver_instance *)options_block)->options_block);
2119 value = (void *)((uschar *)options_block + (long int)value);
2122 switch(ol->type & opt_mask)
2125 case opt_rewrite: /* Show the text value */
2126 s = *((uschar **)value);
2127 printf("%s = %s\n", name, (s == NULL)? US"" : string_printing2(s, FALSE));
2131 printf("%s = %d\n", name, *((int *)value));
2136 int x = *((int *)value);
2137 if (x != 0 && (x & 1023) == 0)
2141 if ((x & 1023) == 0)
2146 printf("%s = %d%c\n", name, x, c);
2148 else printf("%s = %d\n", name, x);
2154 int x = *((int *)value);
2155 if (x == 0) printf("%s = 0\n", name);
2156 else if ((x & 1023) == 0) printf("%s = %dM\n", name, x >> 10);
2157 else printf("%s = %dK\n", name, x);
2162 printf("%s = %#o\n", name, *((int *)value));
2165 /* Can be negative only when "unset", in which case integer */
2169 int x = *((int *)value);
2172 if (x < 0) printf("%s =\n", name); else
2174 printf("%s = %d.", name, x/1000);
2187 /* If the numerical value is unset, try for the string value */
2189 case opt_expand_uid:
2190 if (! *get_set_flag(name, oltop, last, options_block))
2192 sprintf(CS name2, "*expand_%.50s", name);
2193 ol2 = find_option(name2, oltop, last);
2196 void *value2 = ol2->value;
2197 if (options_block != NULL)
2198 value2 = (void *)((uschar *)options_block + (long int)value2);
2199 s = *((uschar **)value2);
2200 printf("%s = %s\n", name, (s == NULL)? US"" : string_printing(s));
2205 /* Else fall through */
2208 if (! *get_set_flag(name, oltop, last, options_block))
2209 printf("%s =\n", name);
2212 pw = getpwuid(*((uid_t *)value));
2214 printf("%s = %ld\n", name, (long int)(*((uid_t *)value)));
2215 else printf("%s = %s\n", name, pw->pw_name);
2219 /* If the numerical value is unset, try for the string value */
2221 case opt_expand_gid:
2222 if (! *get_set_flag(name, oltop, last, options_block))
2224 sprintf(CS name2, "*expand_%.50s", name);
2225 ol2 = find_option(name2, oltop, last);
2226 if (ol2 != NULL && (ol2->type & opt_mask) == opt_stringptr)
2228 void *value2 = ol2->value;
2229 if (options_block != NULL)
2230 value2 = (void *)((uschar *)options_block + (long int)value2);
2231 s = *((uschar **)value2);
2232 printf("%s = %s\n", name, (s == NULL)? US"" : string_printing(s));
2237 /* Else fall through */
2240 if (! *get_set_flag(name, oltop, last, options_block))
2241 printf("%s =\n", name);
2244 gr = getgrgid(*((int *)value));
2246 printf("%s = %ld\n", name, (long int)(*((int *)value)));
2247 else printf("%s = %s\n", name, gr->gr_name);
2252 uidlist = *((uid_t **)value);
2253 printf("%s =", name);
2254 if (uidlist != NULL)
2258 for (i = 1; i <= (int)(uidlist[0]); i++)
2260 uschar *name = NULL;
2261 pw = getpwuid(uidlist[i]);
2262 if (pw != NULL) name = US pw->pw_name;
2263 if (name != NULL) printf("%c%s", sep, name);
2264 else printf("%c%ld", sep, (long int)(uidlist[i]));
2272 gidlist = *((gid_t **)value);
2273 printf("%s =", name);
2274 if (gidlist != NULL)
2278 for (i = 1; i <= (int)(gidlist[0]); i++)
2280 uschar *name = NULL;
2281 gr = getgrgid(gidlist[i]);
2282 if (gr != NULL) name = US gr->gr_name;
2283 if (name != NULL) printf("%c%s", sep, name);
2284 else printf("%c%ld", sep, (long int)(gidlist[i]));
2292 printf("%s = %s\n", name, readconf_printtime(*((int *)value)));
2298 int *list = (int *)value;
2299 printf("%s = ", name);
2300 for (i = 0; i < list[1]; i++)
2301 printf("%s%s", (i == 0)? "" : ":", readconf_printtime(list[i+2]));
2307 printf("%s%s\n", ((*((int *)value)) & (1 << ((ol->type >> 16) & 31)))?
2311 case opt_expand_bool:
2312 sprintf(CS name2, "*expand_%.50s", name);
2313 ol2 = find_option(name2, oltop, last);
2314 if (ol2 != NULL && ol2->value != NULL)
2316 void *value2 = ol2->value;
2317 if (options_block != NULL)
2318 value2 = (void *)((uschar *)options_block + (long int)value2);
2319 s = *((uschar **)value2);
2322 printf("%s = %s\n", name, string_printing(s));
2325 /* s == NULL => string not set; fall through */
2331 case opt_bool_verify:
2333 printf("%s%s\n", (*((BOOL *)value))? "" : "no_", name);
2340 /*************************************************
2341 * Print value from main configuration *
2342 *************************************************/
2344 /* This function, called as a result of encountering the -bP option,
2345 causes the value of any main configuration variable to be output if the
2346 second argument is NULL. There are some special values:
2348 all print all main configuration options
2349 configure_file print the name of the configuration file
2350 routers print the routers' configurations
2351 transports print the transports' configuration
2352 authenticators print the authenticators' configuration
2353 router_list print a list of router names
2354 transport_list print a list of transport names
2355 authenticator_list print a list of authentication mechanism names
2356 +name print a named list item
2357 local_scan print the local_scan options
2359 If the second argument is not NULL, it must be one of "router", "transport", or
2360 "authenticator" in which case the first argument identifies the driver whose
2361 options are to be printed.
2364 name option name if type == NULL; else driver name
2365 type NULL or driver type name, as described above
2371 readconf_print(uschar *name, uschar *type)
2373 BOOL names_only = FALSE;
2375 optionlist *ol2 = NULL;
2376 driver_instance *d = NULL;
2386 static uschar *types[] = { US"address", US"domain", US"host",
2388 static tree_node **anchors[] = { &addresslist_anchor, &domainlist_anchor,
2389 &hostlist_anchor, &localpartlist_anchor };
2391 for (i = 0; i < 4; i++)
2393 t = tree_search(*(anchors[i]), name+1);
2397 printf("%slist %s = %s\n", types[i], name+1,
2398 ((namedlist_block *)(t->data.ptr))->string);
2403 printf("no address, domain, host, or local part list called \"%s\" "
2404 "exists\n", name+1);
2409 if (Ustrcmp(name, "configure_file") == 0)
2411 printf("%s\n", CS config_main_filename);
2415 if (Ustrcmp(name, "all") == 0)
2417 for (ol = optionlist_config;
2418 ol < optionlist_config + optionlist_config_size; ol++)
2420 if ((ol->type & opt_hidden) == 0)
2421 print_ol(ol, US ol->name, NULL, optionlist_config, optionlist_config_size);
2426 if (Ustrcmp(name, "local_scan") == 0)
2428 #ifndef LOCAL_SCAN_HAS_OPTIONS
2429 printf("local_scan() options are not supported\n");
2431 for (ol = local_scan_options;
2432 ol < local_scan_options + local_scan_options_count; ol++)
2434 print_ol(ol, US ol->name, NULL, local_scan_options,
2435 local_scan_options_count);
2441 if (Ustrcmp(name, "routers") == 0)
2446 else if (Ustrcmp(name, "transports") == 0)
2448 type = US"transport";
2452 else if (Ustrcmp(name, "authenticators") == 0)
2454 type = US"authenticator";
2458 else if (Ustrcmp(name, "authenticator_list") == 0)
2460 type = US"authenticator";
2465 else if (Ustrcmp(name, "router_list") == 0)
2471 else if (Ustrcmp(name, "transport_list") == 0)
2473 type = US"transport";
2479 print_ol(find_option(name, optionlist_config, optionlist_config_size),
2480 name, NULL, optionlist_config, optionlist_config_size);
2485 /* Handle the options for a router or transport. Skip options that are flagged
2486 as hidden. Some of these are options with names starting with '*', used for
2487 internal alternative representations of other options (which the printing
2488 function will sort out). Others are synonyms kept for backward compatibility.
2491 if (Ustrcmp(type, "router") == 0)
2493 d = (driver_instance *)routers;
2494 ol2 = optionlist_routers;
2495 size = optionlist_routers_size;
2497 else if (Ustrcmp(type, "transport") == 0)
2499 d = (driver_instance *)transports;
2500 ol2 = optionlist_transports;
2501 size = optionlist_transports_size;
2503 else if (Ustrcmp(type, "authenticator") == 0)
2505 d = (driver_instance *)auths;
2506 ol2 = optionlist_auths;
2507 size = optionlist_auths_size;
2512 for (; d != NULL; d = d->next) printf("%s\n", CS d->name);
2516 /* Either search for a given driver, or print all of them */
2518 for (; d != NULL; d = d->next)
2521 printf("\n%s %s:\n", d->name, type);
2522 else if (Ustrcmp(d->name, name) != 0) continue;
2524 for (ol = ol2; ol < ol2 + size; ol++)
2526 if ((ol->type & opt_hidden) == 0)
2527 print_ol(ol, US ol->name, d, ol2, size);
2530 for (ol = d->info->options;
2531 ol < d->info->options + *(d->info->options_count); ol++)
2533 if ((ol->type & opt_hidden) == 0)
2534 print_ol(ol, US ol->name, d, d->info->options, *(d->info->options_count));
2536 if (name != NULL) return;
2538 if (name != NULL) printf("%s %s not found\n", type, name);
2543 /*************************************************
2544 * Read a named list item *
2545 *************************************************/
2547 /* This function reads a name and a list (i.e. string). The name is used to
2548 save the list in a tree, sorted by its name. Each entry also has a number,
2549 which can be used for caching tests, but if the string contains any expansion
2550 items other than $key, the number is set negative to inhibit caching. This
2551 mechanism is used for domain, host, and address lists that are referenced by
2555 anchorp points to the tree anchor
2556 numberp points to the current number for this tree
2557 max the maximum number permitted
2558 s the text of the option line, starting immediately after the name
2560 tname the name of the list type, for messages
2566 read_named_list(tree_node **anchorp, int *numberp, int max, uschar *s,
2569 BOOL forcecache = FALSE;
2572 namedlist_block *nb = store_get(sizeof(namedlist_block));
2574 if (Ustrncmp(s, "_cache", 6) == 0)
2581 log_write(0, LOG_PANIC_DIE|LOG_CONFIG_IN, "unrecognized configuration line");
2583 if (*numberp >= max)
2584 log_write(0, LOG_PANIC_DIE|LOG_CONFIG_IN, "too many named %ss (max is %d)\n",
2587 while (isspace(*s)) s++;
2589 while (isalnum(*s) || *s == '_') s++;
2590 t = store_get(sizeof(tree_node) + s-ss);
2591 Ustrncpy(t->name, ss, s-ss);
2593 while (isspace(*s)) s++;
2595 if (!tree_insertnode(anchorp, t))
2596 log_write(0, LOG_PANIC_DIE|LOG_CONFIG_IN,
2597 "duplicate name \"%s\" for a named %s", t->name, tname);
2600 nb->number = *numberp;
2603 if (*s++ != '=') log_write(0, LOG_PANIC_DIE|LOG_CONFIG_IN,
2604 "missing '=' after \"%s\"", t->name);
2605 while (isspace(*s)) s++;
2606 nb->string = read_string(s, t->name);
2607 nb->cache_data = NULL;
2609 /* Check the string for any expansions; if any are found, mark this list
2610 uncacheable unless the user has explicited forced caching. */
2612 if (!forcecache && Ustrchr(nb->string, '$') != NULL) nb->number = -1;
2618 /*************************************************
2619 * Unpick data for a rate limit *
2620 *************************************************/
2622 /* This function is called to unpick smtp_ratelimit_{mail,rcpt} into four
2626 s string, in the form t,b,f,l
2627 where t is the threshold (integer)
2628 b is the initial delay (time)
2629 f is the multiplicative factor (fixed point)
2630 k is the maximum time (time)
2631 threshold where to store threshold
2632 base where to store base in milliseconds
2633 factor where to store factor in milliseconds
2634 limit where to store limit
2636 Returns: nothing (panics on error)
2640 unpick_ratelimit(uschar *s, int *threshold, int *base, double *factor,
2643 uschar bstring[16], lstring[16];
2645 if (sscanf(CS s, "%d, %15[0123456789smhdw.], %lf, %15s", threshold, bstring,
2646 factor, lstring) == 4)
2648 *base = readconf_readtime(bstring, 0, TRUE);
2649 *limit = readconf_readtime(lstring, 0, TRUE);
2650 if (*base >= 0 && *limit >= 0) return;
2652 log_write(0, LOG_MAIN|LOG_PANIC_DIE, "malformed ratelimit data: %s", s);
2658 /*************************************************
2659 * Read main configuration options *
2660 *************************************************/
2662 /* This function is the first to be called for configuration reading. It
2663 opens the configuration file and reads general configuration settings until
2664 it reaches the end of the configuration section. The file is then left open so
2665 that the remaining configuration data can subsequently be read if needed for
2668 The configuration file must be owned either by root or exim, and be writeable
2669 only by root or uid/gid exim. The values for Exim's uid and gid can be changed
2670 in the config file, so the test is done on the compiled in values. A slight
2671 anomaly, to be carefully documented.
2673 The name of the configuration file is taken from a list that is included in the
2674 binary of Exim. It can be altered from the command line, but if that is done,
2675 root privilege is immediately withdrawn unless the caller is root or exim.
2676 The first file on the list that exists is used.
2678 For use on multiple systems that share file systems, first look for a
2679 configuration file whose name has the current node name on the end. If that is
2680 not found, try the generic name. For really contorted configurations, that run
2681 multiple Exims with different uid settings, first try adding the effective uid
2682 before the node name. These complications are going to waste resources on most
2683 systems. Therefore they are available only when requested by compile-time
2690 struct stat statbuf;
2691 uschar *s, *filename;
2692 uschar *list = config_main_filelist;
2694 /* Loop through the possible file names */
2696 while((filename = string_nextinlist(&list, &sep, big_buffer, big_buffer_size))
2699 /* Cut out all the fancy processing unless specifically wanted */
2701 #if defined(CONFIGURE_FILE_USE_NODE) || defined(CONFIGURE_FILE_USE_EUID)
2702 uschar *suffix = filename + Ustrlen(filename);
2704 /* Try for the node-specific file if a node name exists */
2706 #ifdef CONFIGURE_FILE_USE_NODE
2708 if (uname(&uts) >= 0)
2710 #ifdef CONFIGURE_FILE_USE_EUID
2711 sprintf(CS suffix, ".%ld.%.256s", (long int)original_euid, uts.nodename);
2712 config_file = Ufopen(filename, "rb");
2713 if (config_file == NULL)
2714 #endif /* CONFIGURE_FILE_USE_EUID */
2716 sprintf(CS suffix, ".%.256s", uts.nodename);
2717 config_file = Ufopen(filename, "rb");
2720 #endif /* CONFIGURE_FILE_USE_NODE */
2722 /* Otherwise, try the generic name, possibly with the euid added */
2724 #ifdef CONFIGURE_FILE_USE_EUID
2725 if (config_file == NULL)
2727 sprintf(CS suffix, ".%ld", (long int)original_euid);
2728 config_file = Ufopen(filename, "rb");
2730 #endif /* CONFIGURE_FILE_USE_EUID */
2732 /* Finally, try the unadorned name */
2734 if (config_file == NULL)
2737 config_file = Ufopen(filename, "rb");
2739 #else /* if neither defined */
2741 /* This is the common case when the fancy processing is not included. */
2743 config_file = Ufopen(filename, "rb");
2746 /* If the file does not exist, continue to try any others. For any other
2747 error, break out (and die). */
2749 if (config_file != NULL || errno != ENOENT) break;
2752 /* On success, save the name for verification; config_filename is used when
2753 logging configuration errors (it changes for .included files) whereas
2754 config_main_filename is the name shown by -bP. Failure to open a configuration
2755 file is a serious disaster. */
2757 if (config_file != NULL)
2759 config_filename = config_main_filename = string_copy(filename);
2763 if (filename == NULL)
2764 log_write(0, LOG_MAIN|LOG_PANIC_DIE, "non-existent configuration file(s): "
2765 "%s", config_main_filelist);
2767 log_write(0, LOG_MAIN|LOG_PANIC_DIE, "%s", string_open_failed(errno,
2768 "configuration file %s", filename));
2771 /* Check the status of the file we have opened, unless it was specified on
2772 the command line, in which case privilege was given away at the start. */
2774 if (!config_changed)
2776 if (fstat(fileno(config_file), &statbuf) != 0)
2777 log_write(0, LOG_MAIN|LOG_PANIC_DIE, "failed to stat configuration file %s",
2780 if ((statbuf.st_uid != root_uid && /* owner not root */
2781 statbuf.st_uid != exim_uid /* owner not exim */
2782 #ifdef CONFIGURE_OWNER
2783 && statbuf.st_uid != config_uid /* owner not the special one */
2786 (statbuf.st_gid != exim_gid /* group not exim & */
2787 #ifdef CONFIGURE_GROUP
2788 && statbuf.st_gid != config_gid /* group not the special one */
2790 && (statbuf.st_mode & 020) != 0) || /* group writeable */
2792 ((statbuf.st_mode & 2) != 0)) /* world writeable */
2794 log_write(0, LOG_MAIN|LOG_PANIC_DIE, "Exim configuration file %s has the "
2795 "wrong owner, group, or mode", big_buffer);
2798 /* Process the main configuration settings. They all begin with a lower case
2799 letter. If we see something starting with an upper case letter, it is taken as
2800 a macro definition. */
2802 while ((s = get_config_line()) != NULL)
2804 if (isupper(s[0])) read_macro_assignment(s);
2806 else if (Ustrncmp(s, "domainlist", 10) == 0)
2807 read_named_list(&domainlist_anchor, &domainlist_count,
2808 MAX_NAMED_LIST, s+10, US"domain list");
2810 else if (Ustrncmp(s, "hostlist", 8) == 0)
2811 read_named_list(&hostlist_anchor, &hostlist_count,
2812 MAX_NAMED_LIST, s+8, US"host list");
2814 else if (Ustrncmp(s, US"addresslist", 11) == 0)
2815 read_named_list(&addresslist_anchor, &addresslist_count,
2816 MAX_NAMED_LIST, s+11, US"address list");
2818 else if (Ustrncmp(s, US"localpartlist", 13) == 0)
2819 read_named_list(&localpartlist_anchor, &localpartlist_count,
2820 MAX_NAMED_LIST, s+13, US"local part list");
2823 (void) readconf_handle_option(s, optionlist_config, optionlist_config_size,
2824 NULL, US"main option \"%s\" unknown");
2828 /* If local_sender_retain is set, local_from_check must be unset. */
2830 if (local_sender_retain && local_from_check)
2831 log_write(0, LOG_MAIN|LOG_PANIC_DIE, "both local_from_check and "
2832 "local_sender_retain are set; this combination is not allowed");
2834 /* If the timezone string is empty, set it to NULL, implying no TZ variable
2837 if (timezone_string != NULL && *timezone_string == 0) timezone_string = NULL;
2839 /* The max retry interval must not be greater than 24 hours. */
2841 if (retry_interval_max > 24*60*60) retry_interval_max = 24*60*60;
2843 /* remote_max_parallel must be > 0 */
2845 if (remote_max_parallel <= 0) remote_max_parallel = 1;
2847 /* Save the configured setting of freeze_tell, so we can re-instate it at the
2848 start of a new SMTP message. */
2850 freeze_tell_config = freeze_tell;
2852 /* The primary host name may be required for expansion of spool_directory
2853 and log_file_path, so make sure it is set asap. It is obtained from uname(),
2854 but if that yields an unqualified value, make a FQDN by using gethostbyname to
2855 canonize it. Some people like upper case letters in their host names, so we
2856 don't force the case. */
2858 if (primary_hostname == NULL)
2862 if (uname(&uts) < 0)
2863 log_write(0, LOG_MAIN|LOG_PANIC_DIE, "uname() failed to yield host name");
2864 hostname = US uts.nodename;
2866 if (Ustrchr(hostname, '.') == NULL)
2869 struct hostent *hostdata;
2872 if (!disable_ipv6 && (dns_ipv4_lookup == NULL ||
2873 match_isinlist(hostname, &dns_ipv4_lookup, 0, NULL, NULL, MCL_DOMAIN,
2883 #if HAVE_GETIPNODEBYNAME
2885 hostdata = getipnodebyname(CS hostname, af, 0, &error_num);
2887 hostdata = gethostbyname2(CS hostname, af);
2890 hostdata = gethostbyname(CS hostname);
2893 if (hostdata != NULL)
2895 hostname = US hostdata->h_name;
2899 if (af == AF_INET) break;
2904 primary_hostname = string_copy(hostname);
2907 /* Set up default value for smtp_active_hostname */
2909 smtp_active_hostname = primary_hostname;
2911 /* If spool_directory wasn't set in the build-time configuration, it must have
2912 got set above. Of course, writing to the log may not work if log_file_path is
2913 not set, but it will at least get to syslog or somewhere, with any luck. */
2915 if (*spool_directory == 0)
2916 log_write(0, LOG_MAIN|LOG_PANIC_DIE, "spool_directory undefined: cannot "
2919 /* Expand the spool directory name; it may, for example, contain the primary
2920 host name. Same comment about failure. */
2922 s = expand_string(spool_directory);
2924 log_write(0, LOG_MAIN|LOG_PANIC_DIE, "failed to expand spool_directory "
2925 "\"%s\": %s", spool_directory, expand_string_message);
2926 spool_directory = s;
2928 /* Expand log_file_path, which must contain "%s" in any component that isn't
2929 the null string or "syslog". It is also allowed to contain one instance of %D.
2930 However, it must NOT contain % followed by anything else. */
2932 if (*log_file_path != 0)
2935 int sep = ':'; /* Fixed for log file path */
2936 s = expand_string(log_file_path);
2938 log_write(0, LOG_MAIN|LOG_PANIC_DIE, "failed to expand log_file_path "
2939 "\"%s\": %s", log_file_path, expand_string_message);
2942 while ((sss = string_nextinlist(&ss,&sep,big_buffer,big_buffer_size)) != NULL)
2945 if (sss[0] == 0 || Ustrcmp(sss, "syslog") == 0) continue;
2946 t = Ustrstr(sss, "%s");
2948 log_write(0, LOG_MAIN|LOG_PANIC_DIE, "log_file_path \"%s\" does not "
2949 "contain \"%%s\"", sss);
2951 t = Ustrchr(sss, '%');
2954 if (t[1] != 'D' || Ustrchr(t+2, '%') != NULL)
2955 log_write(0, LOG_MAIN|LOG_PANIC_DIE, "log_file_path \"%s\" contains "
2956 "unexpected \"%%\" character", s);
2963 /* Interpret syslog_facility into an integer argument for 'ident' param to
2964 openlog(). Default is LOG_MAIL set in globals.c. Allow the user to omit the
2967 if (syslog_facility_str != NULL)
2970 uschar *s = syslog_facility_str;
2972 if ((Ustrlen(syslog_facility_str) >= 4) &&
2973 (strncmpic(syslog_facility_str, US"log_", 4) == 0))
2976 for (i = 0; i < syslog_list_size; i++)
2978 if (strcmpic(s, syslog_list[i].name) == 0)
2980 syslog_facility = syslog_list[i].value;
2985 if (i >= syslog_list_size)
2987 log_write(0, LOG_PANIC_DIE|LOG_CONFIG,
2988 "failed to interpret syslog_facility \"%s\"", syslog_facility_str);
2992 /* Expand pid_file_path */
2994 if (*pid_file_path != 0)
2996 s = expand_string(pid_file_path);
2998 log_write(0, LOG_MAIN|LOG_PANIC_DIE, "failed to expand pid_file_path "
2999 "\"%s\": %s", pid_file_path, expand_string_message);
3003 /* Compile the regex for matching a UUCP-style "From_" line in an incoming
3006 regex_From = regex_must_compile(uucp_from_pattern, FALSE, TRUE);
3008 /* Unpick the SMTP rate limiting options, if set */
3010 if (smtp_ratelimit_mail != NULL)
3012 unpick_ratelimit(smtp_ratelimit_mail, &smtp_rlm_threshold,
3013 &smtp_rlm_base, &smtp_rlm_factor, &smtp_rlm_limit);
3016 if (smtp_ratelimit_rcpt != NULL)
3018 unpick_ratelimit(smtp_ratelimit_rcpt, &smtp_rlr_threshold,
3019 &smtp_rlr_base, &smtp_rlr_factor, &smtp_rlr_limit);
3022 /* The qualify domains default to the primary host name */
3024 if (qualify_domain_sender == NULL)
3025 qualify_domain_sender = primary_hostname;
3026 if (qualify_domain_recipient == NULL)
3027 qualify_domain_recipient = qualify_domain_sender;
3029 /* Setting system_filter_user in the configuration sets the gid as well if a
3030 name is given, but a numerical value does not. */
3032 if (system_filter_uid_set && !system_filter_gid_set)
3034 struct passwd *pw = getpwuid(system_filter_uid);
3036 log_write(0, LOG_MAIN|LOG_PANIC_DIE, "Failed to look up uid %ld",
3037 (long int)system_filter_uid);
3038 system_filter_gid = pw->pw_gid;
3039 system_filter_gid_set = TRUE;
3042 /* If the errors_reply_to field is set, check that it is syntactically valid
3043 and ensure it contains a domain. */
3045 if (errors_reply_to != NULL)
3048 int start, end, domain;
3049 uschar *recipient = parse_extract_address(errors_reply_to, &errmess,
3050 &start, &end, &domain, FALSE);
3052 if (recipient == NULL)
3053 log_write(0, LOG_PANIC_DIE|LOG_CONFIG,
3054 "error in errors_reply_to (%s): %s", errors_reply_to, errmess);
3057 log_write(0, LOG_PANIC_DIE|LOG_CONFIG,
3058 "errors_reply_to (%s) does not contain a domain", errors_reply_to);
3061 /* If smtp_accept_queue or smtp_accept_max_per_host is set, then
3062 smtp_accept_max must also be set. */
3064 if (smtp_accept_max == 0 &&
3065 (smtp_accept_queue > 0 || smtp_accept_max_per_host != NULL))
3066 log_write(0, LOG_PANIC_DIE|LOG_CONFIG,
3067 "smtp_accept_max must be set if smtp_accept_queue or "
3068 "smtp_accept_max_per_host is set");
3070 /* Set up the host number if anything is specified. It is an expanded string
3071 so that it can be computed from the host name, for example. We do this last
3072 so as to ensure that everything else is set up before the expansion. */
3074 if (host_number_string != NULL)
3077 uschar *s = expand_string(host_number_string);
3078 long int n = Ustrtol(s, &end, 0);
3079 while (isspace(*end)) end++;
3081 log_write(0, LOG_PANIC_DIE|LOG_CONFIG,
3082 "localhost_number value is not a number: %s", s);
3083 if (n > LOCALHOST_MAX)
3084 log_write(0, LOG_PANIC_DIE|LOG_CONFIG,
3085 "localhost_number is greater than the maximum allowed value (%d)",
3091 /* If tls_verify_hosts is set, tls_verify_certificates must also be set */
3093 if ((tls_verify_hosts != NULL || tls_try_verify_hosts != NULL) &&
3094 tls_verify_certificates == NULL)
3095 log_write(0, LOG_PANIC_DIE|LOG_CONFIG,
3096 "tls_%sverify_hosts is set, but tls_verify_certificates is not set",
3097 (tls_verify_hosts != NULL)? "" : "try_");
3103 /*************************************************
3104 * Initialize one driver *
3105 *************************************************/
3107 /* This is called once the driver's generic options, if any, have been read.
3108 We can now find the driver, set up defaults for the private options, and
3109 unset any "set" bits in the private options table (which might have been
3110 set by another incarnation of the same driver).
3113 d pointer to driver instance block, with generic
3115 drivers_available vector of available drivers
3116 size_of_info size of each block in drivers_available
3117 class class of driver, for error message
3119 Returns: pointer to the driver info block
3122 static driver_info *
3123 init_driver(driver_instance *d, driver_info *drivers_available,
3124 int size_of_info, uschar *class)
3128 for (dd = drivers_available; dd->driver_name[0] != 0;
3129 dd = (driver_info *)(((uschar *)dd) + size_of_info))
3131 if (Ustrcmp(d->driver_name, dd->driver_name) == 0)
3134 int len = dd->options_len;
3136 d->options_block = store_get(len);
3137 memcpy(d->options_block, dd->options_block, len);
3138 for (i = 0; i < *(dd->options_count); i++)
3139 dd->options[i].type &= ~opt_set;
3144 log_write(0, LOG_PANIC_DIE|LOG_CONFIG_IN,
3145 "%s %s: cannot find %s driver \"%s\"", class, d->name, class, d->driver_name);
3147 return NULL; /* never obeyed */
3153 /*************************************************
3154 * Initialize driver list *
3155 *************************************************/
3157 /* This function is called for routers, transports, and authentication
3158 mechanisms. It reads the data from the current point in the configuration file
3159 up to the end of the section, and sets up a chain of instance blocks according
3160 to the file's contents. The file will already have been opened by a call to
3161 readconf_main, and must be left open for subsequent reading of further data.
3163 Any errors cause a panic crash. Note that the blocks with names driver_info and
3164 driver_instance must map the first portions of all the _info and _instance
3165 blocks for this shared code to work.
3168 class "router", "transport", or "authenticator"
3169 anchor &routers, &transports, &auths
3170 drivers_available available drivers
3171 size_of_info size of each info block
3172 instance_default points to default data for an instance
3173 instance_size size of instance block
3174 driver_optionlist generic option list
3175 driver_optionlist_count count of generic option list
3181 readconf_driver_init(
3183 driver_instance **anchor,
3184 driver_info *drivers_available,
3186 void *instance_default,
3188 optionlist *driver_optionlist,
3189 int driver_optionlist_count)
3191 driver_instance **p = anchor;
3192 driver_instance *d = NULL;
3195 while ((buffer = get_config_line()) != NULL)
3200 /* Read the first name on the line and test for the start of a new driver. A
3201 macro definition indicates the end of the previous driver. If this isn't the
3202 start of a new driver, the line will be re-read. */
3204 s = readconf_readname(name, sizeof(name), buffer);
3206 /* Handle macro definition, first finishing off the initialization of the
3207 previous driver, if any. */
3209 if (isupper(*name) && *s == '=')
3213 if (d->driver_name == NULL)
3214 log_write(0, LOG_PANIC_DIE|LOG_CONFIG,
3215 "no driver defined for %s \"%s\"", class, d->name);
3219 read_macro_assignment(buffer);
3223 /* If the line starts with a name terminated by a colon, we are at the
3224 start of the definition of a new driver. The rest of the line must be
3231 /* Finish off initializing the previous driver. */
3235 if (d->driver_name == NULL)
3236 log_write(0, LOG_PANIC_DIE|LOG_CONFIG,
3237 "no driver defined for %s \"%s\"", class, d->name);
3241 /* Check that we haven't already got a driver of this name */
3243 for (d = *anchor; d != NULL; d = d->next)
3244 if (Ustrcmp(name, d->name) == 0)
3245 log_write(0, LOG_PANIC_DIE|LOG_CONFIG,
3246 "there are two %ss called \"%s\"", class, name);
3248 /* Set up a new driver instance data block on the chain, with
3249 its default values installed. */
3251 d = store_get(instance_size);
3252 memcpy(d, instance_default, instance_size);
3255 d->name = string_copy(name);
3257 /* Clear out the "set" bits in the generic options */
3259 for (i = 0; i < driver_optionlist_count; i++)
3260 driver_optionlist[i].type &= ~opt_set;
3262 /* Check nothing more on this line, then do the next loop iteration. */
3264 while (isspace(*s)) s++;
3265 if (*s != 0) extra_chars_error(s, US"driver name ", name, US"");
3269 /* Not the start of a new driver. Give an error if we have not set up a
3270 current driver yet. */
3272 if (d == NULL) log_write(0, LOG_PANIC_DIE|LOG_CONFIG_IN,
3273 "%s name missing", class);
3275 /* First look to see if this is a generic option; if it is "driver",
3276 initialize the driver. If is it not a generic option, we can look for a
3277 private option provided that the driver has been previously set up. */
3279 if (readconf_handle_option(buffer, driver_optionlist,
3280 driver_optionlist_count, d, NULL))
3282 if (d->info == NULL && d->driver_name != NULL)
3283 init_driver(d, drivers_available, size_of_info, class);
3286 /* Handle private options - pass the generic block because some may
3287 live therein. A flag with each option indicates if it is in the public
3290 else if (d->info != NULL)
3292 readconf_handle_option(buffer, d->info->options,
3293 *(d->info->options_count), d, US"option \"%s\" unknown");
3296 /* The option is not generic and the driver name has not yet been given. */
3298 else log_write(0, LOG_PANIC_DIE|LOG_CONFIG_IN, "option \"%s\" unknown "
3299 "(\"driver\" must be specified before any private options)", name);
3302 /* Run the initialization function for the final driver. */
3306 if (d->driver_name == NULL)
3307 log_write(0, LOG_PANIC_DIE|LOG_CONFIG,
3308 "no driver defined for %s \"%s\"", class, d->name);
3315 /*************************************************
3316 * Check driver dependency *
3317 *************************************************/
3319 /* This function is passed a driver instance and a string. It checks whether
3320 any of the string options for the driver contains the given string as an
3324 d points to a driver instance block
3325 s the string to search for
3327 Returns: TRUE if a dependency is found
3331 readconf_depends(driver_instance *d, uschar *s)
3333 int count = *(d->info->options_count);
3337 for (ol = d->info->options; ol < d->info->options + count; ol++)
3339 void *options_block;
3341 int type = ol->type & opt_mask;
3342 if (type != opt_stringptr) continue;
3343 options_block = ((ol->type & opt_public) == 0)? d->options_block : (void *)d;
3344 value = *(uschar **)((uschar *)options_block + (long int)(ol->value));
3345 if (value != NULL && (ss = Ustrstr(value, s)) != NULL)
3347 if (ss <= value || (ss[-1] != '$' && ss[-1] != '{') ||
3348 isalnum(ss[Ustrlen(s)])) continue;
3349 DEBUG(D_transport) debug_printf("driver %s: \"%s\" option depends on %s\n",
3350 d->name, ol->name, s);
3355 DEBUG(D_transport) debug_printf("driver %s does not depend on %s\n", d->name, s);
3362 /*************************************************
3363 * Decode an error type for retries *
3364 *************************************************/
3366 /* This function is global because it is also called from the main
3367 program when testing retry information. It decodes strings such as "quota_7d"
3368 into numerical error codes.
3371 pp points to start of text
3372 p points past end of text
3373 basic_errno points to an int to receive the main error number
3374 more_errno points to an int to receive the secondary error data
3376 Returns: NULL if decoded correctly; else points to error text
3380 readconf_retry_error(uschar *pp, uschar *p, int *basic_errno, int *more_errno)
3384 while (q < p && *q != '_') q++;
3387 if (len == 5 && strncmpic(pp, US"quota", len) == 0)
3389 *basic_errno = ERRNO_EXIMQUOTA;
3390 if (q != p && (*more_errno = readconf_readtime(q+1, *p, FALSE)) < 0)
3391 return US"bad time value";
3394 else if (len == 7 && strncmpic(pp, US"refused", len) == 0)
3396 *basic_errno = ECONNREFUSED;
3399 if (strncmpic(q+1, US"MX", p-q-1) == 0) *more_errno = 'M';
3400 else if (strncmpic(q+1, US"A", p-q-1) == 0) *more_errno = 'A';
3401 else return US"A or MX expected after \"refused\"";
3405 else if (len == 7 && strncmpic(pp, US"timeout", len) == 0)
3407 *basic_errno = ETIMEDOUT;
3411 int xlen = p - q - 1;
3414 static uschar *extras[] =
3415 { US"A", US"MX", US"connect", US"connect_A", US"connect_MX" };
3416 static int values[] =
3417 { 'A', 'M', RTEF_CTOUT, RTEF_CTOUT|'A', RTEF_CTOUT|'M' };
3419 for (i = 0; i < sizeof(extras)/sizeof(uschar *); i++)
3421 if (strncmpic(x, extras[i], xlen) == 0)
3423 *more_errno = values[i];
3428 if (i >= sizeof(extras)/sizeof(uschar *))
3430 if (strncmpic(x, US"DNS", xlen) == 0)
3432 log_write(0, LOG_MAIN|LOG_PANIC, "\"timeout_dns\" is no longer "
3433 "available in retry rules (it has never worked) - treated as "
3436 else return US"\"A\", \"MX\", or \"connect\" expected after \"timeout\"";
3441 else if (strncmpic(pp, US"mail_4", 6) == 0 ||
3442 strncmpic(pp, US"rcpt_4", 6) == 0 ||
3443 strncmpic(pp, US"data_4", 6) == 0)
3446 int x = 255; /* means "any 4xx code" */
3447 if (p != pp + 8) bad = TRUE; else
3449 int a = pp[6], b = pp[7];
3453 if (isdigit(b)) x += b - '0';
3454 else if (b == 'x') x += 100;
3457 else if (a != 'x' || b != 'x') bad = TRUE;
3461 return string_sprintf("%.4s_4 must be followed by xx, dx, or dd, where "
3462 "x is literal and d is any digit", pp);
3464 *basic_errno = (*pp == 'm')? ERRNO_MAIL4XX :
3465 (*pp == 'r')? ERRNO_RCPT4XX : ERRNO_DATA4XX;
3466 *more_errno = x << 8;
3469 else if (len == 4 && strncmpic(pp, US"auth", len) == 0 &&
3470 strncmpic(q+1, US"failed", p-q-1) == 0)
3471 *basic_errno = ERRNO_AUTHFAIL;
3473 else if (strncmpic(pp, US"lost_connection", p - pp) == 0)
3474 *basic_errno = ERRNO_SMTPCLOSED;
3476 else if (strncmpic(pp, US"tls_required", p - pp) == 0)
3477 *basic_errno = ERRNO_TLSREQUIRED;
3479 else if (len != 1 || Ustrncmp(pp, "*", 1) != 0)
3480 return string_sprintf("unknown or malformed retry error \"%.*s\"", p-pp, pp);
3488 /*************************************************
3489 * Read retry information *
3490 *************************************************/
3492 /* Each line of retry information contains:
3494 . A domain name pattern or an address pattern;
3496 . An error name, possibly with additional data, or *;
3498 . An optional sequence of retry items, each consisting of an identifying
3499 letter, a cutoff time, and optional parameters.
3501 All this is decoded and placed into a control block. */
3504 /* Subroutine to read an argument, preceded by a comma and terminated
3505 by comma, semicolon, whitespace, or newline. The types are: 0 = time value,
3506 1 = fixed point number (returned *1000).
3509 paddr pointer to pointer to current character; updated
3510 type 0 => read a time; 1 => read a fixed point number
3512 Returns: time in seconds or fixed point number * 1000
3516 retry_arg(uschar **paddr, int type)
3521 if (*p++ != ',') log_write(0, LOG_PANIC_DIE|LOG_CONFIG_IN, "comma expected");
3523 while (isspace(*p)) p++;
3525 while (isalnum(*p) || (type == 1 && *p == '.')) p++;
3527 if (*p != 0 && !isspace(*p) && *p != ',' && *p != ';')
3528 log_write(0, LOG_PANIC_DIE|LOG_CONFIG_IN, "comma or semicolon expected");
3534 return readconf_readtime(pp, *p, FALSE);
3536 return readconf_readfixed(pp, *p);
3538 return 0; /* Keep picky compilers happy */
3541 /* The function proper */
3544 readconf_retries(void)
3546 retry_config **chain = &retries;
3550 while ((p = get_config_line()) != NULL)
3552 retry_rule **rchain;
3555 next = store_get(sizeof(retry_config));
3558 chain = &(next->next);
3559 next->basic_errno = next->more_errno = 0;
3560 next->senders = NULL;
3562 rchain = &(next->rules);
3564 next->pattern = string_dequote(&p);
3565 while (isspace(*p)) p++;
3567 while (mac_isgraph(*p)) p++;
3568 if (p - pp <= 0) log_write(0, LOG_PANIC_DIE|LOG_CONFIG_IN,
3569 "missing error type");
3571 /* Test error names for things we understand. */
3573 if ((error = readconf_retry_error(pp, p, &(next->basic_errno),
3574 &(next->more_errno))) != NULL)
3575 log_write(0, LOG_PANIC_DIE|LOG_CONFIG_IN, "%s", error);
3577 /* There may be an optional address list of senders to be used as another
3578 constraint on the rule. This was added later, so the syntax is a bit of a
3579 fudge. Anything that is not a retry rule starting "F," or "G," is treated as
3582 while (isspace(*p)) p++;
3583 if (Ustrncmp(p, "senders", 7) == 0)
3586 while (isspace(*p)) p++;
3587 if (*p++ != '=') log_write(0, LOG_PANIC_DIE|LOG_CONFIG_IN,
3588 "\"=\" expected after \"senders\" in retry rule");
3589 while (isspace(*p)) p++;
3590 next->senders = string_dequote(&p);
3593 /* Now the retry rules. Keep the maximum timeout encountered. */
3595 while (isspace(*p)) p++;
3599 retry_rule *rule = store_get(sizeof(retry_rule));
3601 rchain = &(rule->next);
3603 rule->rule = toupper(*p++);
3604 rule->timeout = retry_arg(&p, 0);
3605 if (rule->timeout > retry_maximum_timeout)
3606 retry_maximum_timeout = rule->timeout;
3610 case 'F': /* Fixed interval */
3611 rule->p1 = retry_arg(&p, 0);
3614 case 'G': /* Geometrically increasing intervals */
3615 case 'H': /* Ditto, but with randomness */
3616 rule->p1 = retry_arg(&p, 0);
3617 rule->p2 = retry_arg(&p, 1);
3621 log_write(0, LOG_PANIC_DIE|LOG_CONFIG_IN, "unknown retry rule letter");
3625 if (rule->timeout <= 0 || rule->p1 <= 0 ||
3626 (rule->rule != 'F' && rule->p2 < 1000))
3627 log_write(0, LOG_PANIC_DIE|LOG_CONFIG_IN,
3628 "bad parameters for retry rule");
3630 while (isspace(*p)) p++;
3634 while (isspace(*p)) p++;
3637 log_write(0, LOG_PANIC_DIE|LOG_CONFIG_IN, "semicolon expected");
3644 /*************************************************
3645 * Initialize authenticators *
3646 *************************************************/
3648 /* Read the authenticators section of the configuration file.
3657 auth_instance *au, *bu;
3658 readconf_driver_init(US"authenticator",
3659 (driver_instance **)(&auths), /* chain anchor */
3660 (driver_info *)auths_available, /* available drivers */
3661 sizeof(auth_info), /* size of info block */
3662 &auth_defaults, /* default values for generic options */
3663 sizeof(auth_instance), /* size of instance block */
3664 optionlist_auths, /* generic options */
3665 optionlist_auths_size);
3667 for (au = auths; au != NULL; au = au->next)
3669 if (au->public_name == NULL)
3670 log_write(0, LOG_PANIC_DIE|LOG_CONFIG, "no public name specified for "
3671 "the %s authenticator", au->name);
3672 for (bu = au->next; bu != NULL; bu = bu->next)
3674 if (strcmpic(au->public_name, bu->public_name) == 0)
3676 if ((au->client && bu->client) || (au->server && bu->server))
3677 log_write(0, LOG_PANIC_DIE|LOG_CONFIG, "two %s authenticators "
3678 "(%s and %s) have the same public name (%s)",
3679 (au->client)? US"client" : US"server", au->name, bu->name,
3689 /*************************************************
3690 * Read ACL information *
3691 *************************************************/
3693 /* If this run of Exim is not doing something that involves receiving a
3694 message, we can just skip over the ACL information. No need to parse it.
3696 First, we have a function for acl_read() to call back to get the next line. We
3697 need to remember the line we passed, because at the end it will contain the
3698 name of the next ACL. */
3700 static uschar *acl_line;
3705 acl_line = get_config_line();
3710 /* Now the main function:
3713 skip TRUE when this Exim process is doing something that will
3714 not need the ACL data
3720 readconf_acl(BOOL skip)
3724 /* Not receiving messages, don't need to parse the ACL data */
3728 DEBUG(D_acl) debug_printf("skipping ACL configuration - not needed\n");
3729 while ((p = get_config_line()) != NULL);
3733 /* Read each ACL and add it into the tree. Macro (re)definitions are allowed
3736 acl_line = get_config_line();
3738 while(acl_line != NULL)
3744 p = readconf_readname(name, sizeof(name), acl_line);
3745 if (isupper(*name) && *p == '=')
3747 read_macro_assignment(acl_line);
3748 acl_line = get_config_line();
3752 if (*p != ':' || name[0] == 0)
3753 log_write(0, LOG_PANIC_DIE|LOG_CONFIG_IN, "missing or malformed ACL name");
3755 node = store_get(sizeof(tree_node) + Ustrlen(name));
3756 Ustrcpy(node->name, name);
3757 if (!tree_insertnode(&acl_anchor, node))
3758 log_write(0, LOG_PANIC_DIE|LOG_CONFIG_IN,
3759 "there are two ACLs called \"%s\"", name);
3761 node->data.ptr = acl_read(acl_callback, &error);
3763 if (node->data.ptr == NULL && error != NULL)
3764 log_write(0, LOG_PANIC_DIE|LOG_CONFIG_IN, "error in ACL: %s", error);
3770 /*************************************************
3771 * Read configuration for local_scan() *
3772 *************************************************/
3774 /* This function is called after "begin local_scan" is encountered in the
3775 configuration file. If the local_scan() function allows for configuration
3776 options, we can process them. Otherwise, we expire in a panic.
3783 local_scan_init(void)
3785 #ifndef LOCAL_SCAN_HAS_OPTIONS
3786 log_write(0, LOG_PANIC_DIE|LOG_CONFIG_IN, "local_scan() options not supported: "
3787 "(LOCAL_SCAN_HAS_OPTIONS not defined in Local/Makefile)");
3791 while ((p = get_config_line()) != NULL)
3793 (void) readconf_handle_option(p, local_scan_options, local_scan_options_count,
3794 NULL, US"local_scan option \"%s\" unknown");
3801 /*************************************************
3802 * Read rest of configuration (after main) *
3803 *************************************************/
3805 /* This function reads the rest of the runtime configuration, after the main
3806 configuration. It is called only when actually needed. Each subsequent section
3807 of the configuration starts with a line of the form
3811 where the name is "routers", "transports", etc. A section is terminated by
3812 hitting the next "begin" line, and the next name is left in next_section.
3813 Because it may confuse people as to whether the names are singular or plural,
3814 we add "s" if it's missing. There is always enough room in next_section for
3815 this. This function is basically just a switch.
3818 skip_acl TRUE if ACL information is not needed
3823 static uschar *section_list[] = {
3833 readconf_rest(BOOL skip_acl)
3837 while(next_section[0] != 0)
3841 int last = sizeof(section_list) / sizeof(uschar *);
3843 int n = Ustrlen(next_section);
3845 if (tolower(next_section[n-1]) != 's') Ustrcpy(next_section+n, "s");
3849 int c = strcmpic(next_section, section_list[mid]);
3851 if (c > 0) first = mid + 1; else last = mid;
3853 log_write(0, LOG_PANIC_DIE|LOG_CONFIG_IN,
3854 "\"%.*s\" is not a known configuration section name", n, next_section);
3855 mid = (last + first)/2;
3859 if (((had ^= bit) & bit) == 0)
3860 log_write(0, LOG_PANIC_DIE|LOG_CONFIG_IN,
3861 "\"%.*s\" section is repeated in the configuration file", n,
3866 case 0: readconf_acl(skip_acl); break;
3867 case 1: auths_init(); break;
3868 case 2: local_scan_init(); break;
3869 case 3: readconf_retries(); break;
3870 case 4: readconf_rewrites(); break;
3871 case 5: route_init(); break;
3872 case 6: transport_init(); break;
3876 (void)fclose(config_file);
3879 /* End of readconf.c */