TLS: move from SUPPORT_TLS to DISABLE_TLS macro for the build
[exim.git] / src / src / exim.h
CommitLineData
059ec3d9
PH
1/*************************************************
2* Exim - an Internet mail transport agent *
3*************************************************/
4
f9ba5e22 5/* Copyright (c) University of Cambridge 1995 - 2018 */
059ec3d9
PH
6/* See the file NOTICE for conditions of use and distribution. */
7
8
9/* Source files for exim all #include this header, which drags in everything
10that is needed. They don't all need everything, of course, but it's far too
11messy to have each one importing its own list, and anyway, most of them need
12most of these includes. */
13
cb224393
JH
14#ifndef EXIM_H
15#define EXIM_H
16
059ec3d9
PH
17/* Assume most systems have statfs() unless os.h undefines this macro */
18
19#define HAVE_STATFS
20
0eb8eedd
NM
21/* Similarly, assume most systems have srandom() unless os.h undefines it.
22This call dates back at least as far as SUSv2. */
23
24#define HAVE_SRANDOM
25
b87a6e0e 26/* This is primarily for the Gnu C library; we define it before os.h so that
57eb9e91
PP
27os.h has a chance to hurriedly undef it, Just In Case. We need C99 for some
2864-bit math support, and defining _ISOC99_SOURCE breaks <resolv.h> and friends.
29*/
b87a6e0e 30
57eb9e91 31#define _GNU_SOURCE 1
b87a6e0e 32
059ec3d9
PH
33/* First of all include the os-specific header, which might set things that
34are needed by any of the other headers, including system headers. */
35
36#include "os.h"
37
38/* If it didn't define os_find_running_interfaces, use the common function. */
39
40#ifndef os_find_running_interfaces
c007c974 41# define os_find_running_interfaces os_common_find_running_interfaces
059ec3d9
PH
42#endif
43
44/* If it didn't define the base for "base 62" numbers, we really do use 62.
45This is the case for all real Unix and Unix-like OS. It's only Cygwin and
46Darwin, with their case-insensitive file systems, that can't use base 62 for
47making unique names. */
48
49#ifndef BASE_62
c007c974 50# define BASE_62 62
059ec3d9
PH
51#endif
52
53/* The maximum value of localhost_number depends on the base being used */
54
55#if BASE_62 == 62
c007c974 56# define LOCALHOST_MAX 16
059ec3d9 57#else
c007c974 58# define LOCALHOST_MAX 10
059ec3d9
PH
59#endif
60
4789da3a 61/* If not overridden by os.h, dynamic libraries have filenames ending .so */
e12f8c32
PP
62#ifndef DYNLIB_FN_EXT
63# define DYNLIB_FN_EXT "so"
64#endif
65
059ec3d9
PH
66/* ANSI C standard includes */
67
68#include <ctype.h>
69#include <locale.h>
870f6ba8 70#include <math.h>
059ec3d9
PH
71#include <signal.h>
72#include <stdarg.h>
73#include <stddef.h>
74#include <stdio.h>
75#include <stdlib.h>
76#include <string.h>
77#include <time.h>
78
79/* Unix includes */
80
81#include <errno.h>
1a46a8c5 82#if defined(__svr4__) && defined(__sparc) && ! defined(__EXTENSIONS__)
c007c974
JH
83# define __EXTENSIONS__ /* so that SunOS 5 gets NGROUPS_MAX */
84# include <limits.h>
85# undef __EXTENSIONS__
059ec3d9 86#else
c007c974 87# include <limits.h>
059ec3d9
PH
88#endif
89
17c76198
PP
90/* C99 integer types, figure out how to undo this if needed for older systems */
91
92#include <inttypes.h>
93
059ec3d9
PH
94/* Just in case some aged system doesn't define them... */
95
96#ifndef INT_MAX
c007c974 97# define INT_MAX 2147483647
059ec3d9
PH
98#endif
99
4362ff0d 100#ifndef INT_MIN
c007c974 101# define INT_MIN (-INT_MAX - 1)
4362ff0d
PH
102#endif
103
104#ifndef SHRT_MAX
c007c974 105# define SHRT_MAX 32767
4362ff0d
PH
106#endif
107
059ec3d9 108#ifndef UCHAR_MAX
c007c974 109# define UCHAR_MAX 255
059ec3d9
PH
110#endif
111
4328fd3c
JH
112
113/* To match int_eximarith_t. Define in OS/os.h-<your-system> to override. */
114#ifndef EXIM_ARITH_MAX
115# define EXIM_ARITH_MAX ((int_eximarith_t)9223372036854775807LL)
116#endif
117#ifndef EXIM_ARITH_MIN
118# define EXIM_ARITH_MIN (-EXIM_ARITH_MAX - 1)
119#endif
120
059ec3d9
PH
121/* Some systems have PATH_MAX and some have MAX_PATH_LEN. */
122
123#ifndef PATH_MAX
c007c974
JH
124# ifdef MAX_PATH_LEN
125# define PATH_MAX MAX_PATH_LEN
126# else
127# define PATH_MAX 1024
128# endif
059ec3d9
PH
129#endif
130
131#include <sys/types.h>
132#include <sys/file.h>
133#include <dirent.h>
134#include <netdb.h>
f452e07e 135#ifndef NO_POLL_H
c007c974 136# include <poll.h>
f452e07e 137#endif
059ec3d9
PH
138#include <pwd.h>
139#include <grp.h>
140#include <syslog.h>
141
142/* Not all systems have flock() available. Those that do must define LOCK_SH
143in sys/file.h. */
144
145#ifndef LOCK_SH
c007c974 146# define NO_FLOCK
059ec3d9
PH
147#endif
148
149#ifndef NO_SYSEXITS /* some OS don't have this */
c007c974 150# include <sysexits.h>
059ec3d9
PH
151#endif
152
36a3b041
PH
153/* A few OS don't have socklen_t; their os.h files define EXIM_SOCKLEN_T to
154be size_t or whatever. We used to use SOCKLEN_T, but then it was discovered
155that this is used by the AIX include files. */
059ec3d9 156
36a3b041 157#ifndef EXIM_SOCKLEN_T
c007c974 158# define EXIM_SOCKLEN_T socklen_t
059ec3d9
PH
159#endif
160
161/* Ensure that the sysexits we reference are defined */
162
163#ifndef EX_UNAVAILABLE
c007c974 164# define EX_UNAVAILABLE 69 /* service unavailable; used for execv fail */
059ec3d9
PH
165#endif
166#ifndef EX_CANTCREAT
c007c974 167# define EX_CANTCREAT 73 /* can't create file: treat as temporary */
059ec3d9
PH
168#endif
169#ifndef EX_TEMPFAIL
c007c974 170# define EX_TEMPFAIL 75 /* temp failure; user is invited to retry */
059ec3d9
PH
171#endif
172#ifndef EX_CONFIG
c007c974 173# define EX_CONFIG 78 /* configuration error */
059ec3d9
PH
174#endif
175
176/* This one is not in any sysexits file that I've come across */
177
178#define EX_EXECFAILED 127 /* execve() failed */
179
180
181#include <sys/time.h>
182#include <sys/param.h>
183
184#ifndef NO_SYS_RESOURCE_H /* QNX doesn't have this */
c007c974 185# include <sys/resource.h>
059ec3d9
PH
186#endif
187
188#include <sys/socket.h>
189
190/* If we are on an IPv6 system, the macro AF_INET6 will have been defined in
191the sys/socket.h header. It is helpful to have this defined on an IPv4 system
192so that it can appear in the code, even if it is never actually used when
193the code is run. It saves some #ifdef occurrences. */
194
195#ifndef AF_INET6
c007c974 196# define AF_INET6 24
059ec3d9
PH
197#endif
198
199#include <sys/ioctl.h>
200
201/* The new standard is statvfs; some OS have statfs. For statvfs the block
202counts must be multiplied by the "fragment size" f_frsize to get the actual
203size. In other cases the value seems to be f_bsize (which is sometimes the only
204block size), so we use a macro to get that instead.
205
206Also arrange to be able to cut it out altogether for way-out OS that don't have
207anything. I've indented a bit here to try to make the mess a bit more
208intelligible. Note that simply defining one name to be another when
209HAVE_SYS_STATVFS_H is not set will not work if the system has a statvfs macro
210or a macro with entries f_frsize and f_bsize. */
211
212#ifdef HAVE_STATFS
213 #ifdef HAVE_SYS_STATVFS_H
214 #include <sys/statvfs.h>
215 #define STATVFS statvfs
216 #define F_FRSIZE f_frsize
217 #else
218 #define STATVFS statfs
219 #define F_FRSIZE f_bsize
220 #ifdef HAVE_SYS_VFS_H
221 #include <sys/vfs.h>
222 #ifdef HAVE_SYS_STATFS_H
223 #include <sys/statfs.h>
224 #endif
225 #endif
226 #ifdef HAVE_SYS_MOUNT_H
227 #include <sys/mount.h>
228 #endif
229 #endif
230
231 /* Macros for the fields for the available space for non-superusers; define
232 these only if the OS header has not. Not all OS have f_favail; those that
233 are known to have it define F_FAVAIL as f_favail. The default is to use
234 f_free. */
235
236 #ifndef F_BAVAIL
c007c974 237 # define F_BAVAIL f_bavail
059ec3d9
PH
238 #endif
239
240 #ifndef F_FAVAIL
c007c974 241 # define F_FAVAIL f_ffree
059ec3d9
PH
242 #endif
243
244 /* All the systems I've been able to look at seem to have F_FILES */
245
246 #ifndef F_FILES
c007c974 247 # define F_FILES f_files
059ec3d9
PH
248 #endif
249
250#endif
251
252
1a46a8c5 253#ifndef SIOCGIFCONF /* HACK for SunOS 5 */
c007c974 254# include <sys/sockio.h>
059ec3d9
PH
255#endif
256
257#include <sys/stat.h>
258#include <sys/wait.h>
259#include <sys/utsname.h>
260#include <fcntl.h>
261
262/* There's a shambles in IRIX6 - it defines EX_OK in unistd.h which conflicts
415c8f3b
PH
263with the definition in sysexits.h. Exim does not actually use this macro, so we
264just undefine it. It would be nice to be able to re-instate the definition from
265sysexits.h if there is no definition in unistd.h, but I do not think there is a
266way to do this in C because macro definitions are not scanned for other macros
267at definition time. [The code here used to assume they were, until I was
268disabused of the notion. Luckily, since EX_OK is not used, it didn't matter.] */
059ec3d9
PH
269
270#ifdef EX_OK
c007c974 271# undef EX_OK
059ec3d9
PH
272#endif
273
274#include <unistd.h>
275
059ec3d9
PH
276#include <utime.h>
277#ifndef NO_NET_IF_H
c007c974 278# include <net/if.h>
059ec3d9
PH
279#endif
280#include <sys/un.h>
281#include <netinet/in.h>
282#include <netinet/tcp.h>
283#include <arpa/inet.h>
284#include <arpa/nameser.h>
285
286
059ec3d9
PH
287/* While IPv6 is still young the definitions of T_AAAA and T_A6 may not be
288included in arpa/nameser.h. Fudge them here. */
289
290#ifndef T_AAAA
291#define T_AAAA 28
292#endif
293
294#ifndef T_A6
295#define T_A6 38
296#endif
297
298/* Ancient systems (e.g. SunOS4) don't appear to have T_TXT defined in their
299header files. I don't suppose they have T_SRV either. */
300
301#ifndef T_TXT
c007c974 302# define T_TXT 16
059ec3d9
PH
303#endif
304
305#ifndef T_SRV
c007c974 306# define T_SRV 33
059ec3d9
PH
307#endif
308
eae0036b
PP
309/* Many systems do not have T_SPF. */
310
311#ifndef T_SPF
c007c974 312# define T_SPF 99
eae0036b
PP
313#endif
314
1e06383a
TL
315/* New TLSA record for DANE */
316#ifndef T_TLSA
c007c974 317# define T_TLSA 52
1e06383a
TL
318#endif
319#define MAX_TLSA_EXPANDED_SIZE 8192
320
ade42478
PH
321/* It seems that some versions of arpa/nameser.h don't define *any* of the
322T_xxx macros, which seem to be non-standard nowadays. Just to be on the safe
323side, put in definitions for all the ones that Exim uses. */
324
325#ifndef T_A
c007c974 326# define T_A 1
ade42478
PH
327#endif
328
329#ifndef T_CNAME
c007c974 330# define T_CNAME 5
ade42478
PH
331#endif
332
885ccd3e 333#ifndef T_SOA
c007c974 334# define T_SOA 6
885ccd3e
PH
335#endif
336
ade42478 337#ifndef T_MX
c007c974 338# define T_MX 15
ade42478
PH
339#endif
340
341#ifndef T_NS
c007c974 342# define T_NS 2
ade42478
PH
343#endif
344
345#ifndef T_PTR
c007c974 346# define T_PTR 12
ade42478
PH
347#endif
348
349
e5a9dba6
PH
350/* We define a few private types for special DNS lookups:
351
352 . T_ZNS gets the nameservers of the enclosing zone of a domain
353
354 . T_MXH gets the MX hostnames only (without their priorities)
355
356 . T_CSA gets the domain's Client SMTP Authorization SRV record
357
66be95e0
PP
358 . T_ADDRESSES looks up both AAAA (or A6) and A records
359
360If any of these names appear in the RRtype list at:
361 <http://www.iana.org/assignments/dns-parameters/dns-parameters.xhtml>
362then we should rename Exim's private type away from the conflict.
e5a9dba6 363*/
33397d19
PH
364
365#define T_ZNS (-1)
ea3bc19b 366#define T_MXH (-2)
e5a9dba6 367#define T_CSA (-3)
66be95e0 368#define T_ADDRESSES (-4)
33397d19 369
059ec3d9
PH
370/* The resolv.h header defines __P(x) on some Solaris 2.5.1 systems (without
371checking that it is already defined, in fact). This conflicts with other
372headers that behave likewise (see below), leading to compiler warnings. Arrange
373to undefine it if resolv.h defines it. */
374
375#if defined(__P)
c007c974 376# define __P_WAS_DEFINED_BEFORE_RESOLV
059ec3d9
PH
377#endif
378
379#include <resolv.h>
380
381#if defined(__P) && ! defined (__P_WAS_DEFINED_BEFORE_RESOLV)
c007c974 382# undef __P
059ec3d9
PH
383#endif
384
5bfb4cdf
PP
385/* If not defined by os.h, we do nothing special to push DNS resolver state
386back to be available by the classic resolver routines. Also, provide
387prototype for our get routine, unless defined away. */
388
389#ifndef os_put_dns_resolver_res
390# define os_put_dns_resolver_res(R) do {/**/} while(0)
391#endif
392#ifndef os_get_dns_resolver_res
393res_state os_get_dns_resolver_res(void);
394#endif
395
059ec3d9
PH
396/* These three are to support the IP option logging code. Linux is
397different to everyone else and there are also other systems which don't
398have netinet/ip_var.h, so there's a general macro to control its inclusion. */
399
400#include <netinet/in_systm.h>
401#include <netinet/ip.h>
402
403#ifndef NO_IP_VAR_H
c007c974 404# include <netinet/ip_var.h>
059ec3d9
PH
405#endif
406
407/* Linux (and some others) uses a different type for the 2nd argument of
408iconv(). It's os.h file defines ICONV_ARG2_TYPE. For the rest, define a default
409here. */
410
411#ifndef ICONV_ARG2_TYPE
9c19b270 412# define ICONV_ARG2_TYPE char **
059ec3d9
PH
413#endif
414
415/* One OS uses a different type for the 5th argument of getsockopt */
416
417#ifndef GETSOCKOPT_ARG5_TYPE
c007c974 418# define GETSOCKOPT_ARG5_TYPE socklen_t *
059ec3d9
PH
419#endif
420
421/* One operating system uses a different type for the 2nd argument of select().
422Its os.h file defines SELECT_ARG2_TYPE. For the rest, define a default here. */
423
424#ifndef SELECT_ARG2_TYPE
c007c974 425# define SELECT_ARG2_TYPE fd_set
059ec3d9
PH
426#endif
427
428/* One operating system uses a different type for the 4th argument of
429dn_expand(). Its os.h file defines DN_EXPAND_ARG4_TYPE. For the rest, define a
430default here. */
431
432#ifndef DN_EXPAND_ARG4_TYPE
c007c974 433# define DN_EXPAND_ARG4_TYPE char *
059ec3d9
PH
434#endif
435
436/* One operating system defines a different type for the yield of inet_addr().
437In Exim code, its value is always assigned to the s_addr members of address
438structures. Casting the yield to the type of s_addr should fix the problem,
439since the size of the data is correct. Just in case this ever has to be
440changed, use a macro for the type, and define it here so that it is possible to
441use different values for specific OS if ever necessary. */
442
443#ifndef S_ADDR_TYPE
c007c974 444# define S_ADDR_TYPE u_long
059ec3d9
PH
445#endif
446
447/* (At least) one operating system (Solaris) defines a different type for the
448second argument of pam_converse() - the difference is the absence of "const".
449Its os.h file defines PAM_CONVERSE_ARG2_TYPE. For the rest, define a default
450here. */
451
452#ifndef PAM_CONVERSE_ARG2_TYPE
c007c974 453# define PAM_CONVERSE_ARG2_TYPE const struct pam_message
059ec3d9
PH
454#endif
455
456/* One operating system (SunOS4) defines getc, ungetc, feof, and ferror as
457macros and not as functions. Exim needs them to be assignable functions. This
458flag gets set to cause this to be sorted out here. */
459
460#ifdef FUDGE_GETC_AND_FRIENDS
c007c974 461# undef getc
059ec3d9 462extern int getc(FILE *);
c007c974 463# undef ungetc
059ec3d9 464extern int ungetc(int, FILE *);
c007c974 465# undef feof
059ec3d9 466extern int feof(FILE *);
c007c974 467# undef ferror
059ec3d9
PH
468extern int ferror(FILE *);
469#endif
470
471/* The header from the PCRE regex package */
472
8eb9f5bd 473#include <pcre.h>
059ec3d9
PH
474
475/* Exim includes are in several files. Note that local_scan.h #includes
750af86e
PH
476config.h, mytypes.h, and store.h, so we don't need to mention them explicitly.
477*/
8523533c 478
059ec3d9
PH
479#include "local_scan.h"
480#include "macros.h"
059ec3d9
PH
481#include "dbstuff.h"
482#include "structs.h"
0ab63f3d 483#include "blob.h"
059ec3d9 484#include "globals.h"
5fb822fc 485#include "hash.h"
059ec3d9
PH
486#include "functions.h"
487#include "dbfunctions.h"
488#include "osfunctions.h"
489
8523533c 490#ifdef EXPERIMENTAL_BRIGHTMAIL
c007c974 491# include "bmi_spam.h"
8523533c 492#endif
7952eef9 493#ifdef SUPPORT_SPF
c007c974 494# include "spf.h"
8523533c
TK
495#endif
496#ifdef EXPERIMENTAL_SRS
c007c974 497# include "srs.h"
8523533c 498#endif
80a47a2c 499#ifndef DISABLE_DKIM
c007c974 500# include "dkim.h"
f7572e5a 501#endif
4840604e 502#ifdef EXPERIMENTAL_DMARC
c007c974
JH
503# include "dmarc.h"
504# include <opendmarc/dmarc.h>
4840604e 505#endif
8523533c 506
059ec3d9
PH
507/* The following stuff must follow the inclusion of config.h because it
508requires various things that are set therein. */
509
510#if HAVE_ICONV /* Not all OS have this */
c007c974 511# include <iconv.h>
059ec3d9
PH
512#endif
513
379120bf 514#if defined(USE_READLINE) || defined(EXPAND_DLFUNC) || defined (LOOKUP_MODULE_DIR)
c007c974 515# include <dlfcn.h>
059ec3d9
PH
516#endif
517
54fc8428 518#ifdef ENABLE_DISABLE_FSYNC
c007c974 519# define EXIMfsync(f) (disable_fsync? 0 : fsync(f))
54fc8428 520#else
c007c974 521# define EXIMfsync(f) fsync(f)
54fc8428
PH
522#endif
523
059ec3d9
PH
524/* Backward compatibility; LOOKUP_LSEARCH now includes all three */
525
526#if (!defined LOOKUP_LSEARCH) && (defined LOOKUP_WILDLSEARCH || defined LOOKUP_NWILDLSEARCH)
c007c974 527# define LOOKUP_LSEARCH yes
059ec3d9
PH
528#endif
529
530/* Define a union to hold either an IPv4 or an IPv6 sockaddr structure; this
52ba4661
PP
531simplifies some of the coding. We include the sockaddr to reduce type-punning
532issues in C99. */
059ec3d9
PH
533
534union sockaddr_46 {
535 struct sockaddr_in v4;
536 #if HAVE_IPV6
537 struct sockaddr_in6 v6;
538 #endif
52ba4661 539 struct sockaddr v0;
059ec3d9
PH
540};
541
01603eec
JH
542/* If DISABLE_TLS is defined, ensure that USE_GNUTLS is not defined
543so that if USE_GNUTLS *is* set, we can assume DISABLE_TLS is not set.
16be7f11 544Likewise, OSCP, AUTH_TLS and CERTNAMES cannot be supported. */
059ec3d9 545
01603eec 546#ifdef DISABLE_TLS
c007c974 547# undef USE_GNUTLS
16be7f11
JH
548# ifndef DISABLE_OCSP
549# define DISABLE_OCSP
550# endif
551# undef EXPERIMENTAL_CERTNAMES
552# undef AUTH_TLS
059ec3d9
PH
553#endif
554
555/* If SPOOL_DIRECTORY, LOG_FILE_PATH or PID_FILE_PATH have not been defined,
556set them to the null string. */
557
558#ifndef SPOOL_DIRECTORY
559 #define SPOOL_DIRECTORY ""
560#endif
561#ifndef LOG_FILE_PATH
562 #define LOG_FILE_PATH ""
563#endif
564#ifndef PID_FILE_PATH
565 #define PID_FILE_PATH ""
566#endif
567
568/* The EDQUOT error code isn't universally available, though it is widespread.
569There is a particular shambles in SunOS5, where it did not exist originally,
570but got installed with a particular patch for Solaris 2.4. There is a
571configuration variable for specifying what the system's "over quota" error is,
572which will end up in config.h if supplied in OS/Makefile-xxx. If it is not set,
573default to EDQUOT if it exists, otherwise ENOSPC. */
574
575#ifndef ERRNO_QUOTA
c007c974
JH
576# ifdef EDQUOT
577# define ERRNO_QUOTA EDQUOT
578# else
579# define ERRNO_QUOTA ENOSPC
580# endif
059ec3d9
PH
581#endif
582
afe12dd0 583/* DANE w/o DNSSEC is useless */
c0635b6d 584#if defined(SUPPORT_DANE) && defined(DISABLE_DNSSEC)
fd5a6ffb 585# error DANE support requires DNSSEC support
afe12dd0
HSHR
586#endif
587
e72cfa5b
JH
588/* Some platforms (FreeBSD, OpenBSD, Solaris) do not seem to define this */
589
590#ifndef POLLRDHUP
591# define POLLRDHUP (POLLIN | POLLHUP)
592#endif
593
157d73b5
JH
594/* Some platforms (Darwin) have to define a larger limit on groups membership */
595
596#ifndef EXIM_GROUPLIST_SIZE
597# define EXIM_GROUPLIST_SIZE NGROUPS_MAX
598#endif
599
cb224393 600#endif
059ec3d9 601/* End of exim.h */