smtpd.h revision 1.654
1/*	$OpenBSD: smtpd.h,v 1.654 2020/02/24 16:16:08 millert Exp $	*/
2
3/*
4 * Copyright (c) 2008 Gilles Chehade <gilles@poolp.org>
5 * Copyright (c) 2008 Pierre-Yves Ritschard <pyr@openbsd.org>
6 * Copyright (c) 2012 Eric Faurot <eric@openbsd.org>
7 *
8 * Permission to use, copy, modify, and distribute this software for any
9 * purpose with or without fee is hereby granted, provided that the above
10 * copyright notice and this permission notice appear in all copies.
11 *
12 * THE SOFTWARE IS PROVIDED "AS IS" AND THE AUTHOR DISCLAIMS ALL WARRANTIES
13 * WITH REGARD TO THIS SOFTWARE INCLUDING ALL IMPLIED WARRANTIES OF
14 * MERCHANTABILITY AND FITNESS. IN NO EVENT SHALL THE AUTHOR BE LIABLE FOR
15 * ANY SPECIAL, DIRECT, INDIRECT, OR CONSEQUENTIAL DAMAGES OR ANY DAMAGES
16 * WHATSOEVER RESULTING FROM LOSS OF USE, DATA OR PROFITS, WHETHER IN AN
17 * ACTION OF CONTRACT, NEGLIGENCE OR OTHER TORTIOUS ACTION, ARISING OUT OF
18 * OR IN CONNECTION WITH THE USE OR PERFORMANCE OF THIS SOFTWARE.
19 */
20
21#ifndef nitems
22#define nitems(_a) (sizeof((_a)) / sizeof((_a)[0]))
23#endif
24
25#include <netinet/in.h>
26#include <netdb.h>
27#include <event.h>
28
29#include "smtpd-defines.h"
30#include "smtpd-api.h"
31#include "ioev.h"
32
33#define CHECK_IMSG_DATA_SIZE(imsg, expected_sz) do {			\
34	if ((imsg)->hdr.len - IMSG_HEADER_SIZE != (expected_sz))	\
35		fatalx("smtpd: imsg %d: data size expected %zd got %zd",\
36	   	    (imsg)->hdr.type,					\
37	   	    (expected_sz), (imsg)->hdr.len - IMSG_HEADER_SIZE);	\
38} while (0)
39
40#define CONF_FILE		 "/etc/mail/smtpd.conf"
41#define MAILNAME_FILE		 "/etc/mail/mailname"
42#define CA_FILE			 "/etc/ssl/cert.pem"
43
44#define PROC_COUNT		 7
45
46#define MAX_HOPS_COUNT		 100
47#define	DEFAULT_MAX_BODY_SIZE	(35*1024*1024)
48
49#define	EXPAND_BUFFER		 1024
50
51#define SMTPD_QUEUE_EXPIRY	 (4 * 24 * 60 * 60)
52#define SMTPD_SOCKET		 "/var/run/smtpd.sock"
53#define	SMTPD_NAME		 "OpenSMTPD"
54#define	SMTPD_VERSION		 "6.6.2"
55#define SMTPD_SESSION_TIMEOUT	 300
56#define SMTPD_BACKLOG		 5
57
58#define	PATH_SMTPCTL		"/usr/sbin/smtpctl"
59
60#define PATH_OFFLINE		"/offline"
61#define PATH_PURGE		"/purge"
62#define PATH_TEMPORARY		"/temporary"
63
64#define	PATH_LIBEXEC		"/usr/local/libexec/smtpd"
65
66
67/*
68 * RFC 5322 defines these characters as valid, some of them are
69 * potentially dangerous and need to be escaped.
70 */
71#define	MAILADDR_ALLOWED       	"!#$%&'*/?^`{|}~+-=_"
72#define	MAILADDR_ESCAPE		"!#$%&'*?`{|}~"
73
74
75#define F_STARTTLS		0x01
76#define F_SMTPS			0x02
77#define F_SSL		       (F_STARTTLS | F_SMTPS)
78#define F_AUTH			0x08
79#define	F_STARTTLS_REQUIRE	0x20
80#define	F_AUTH_REQUIRE		0x40
81#define	F_MASK_SOURCE		0x100
82#define	F_TLS_VERIFY		0x200
83#define	F_EXT_DSN		0x400
84#define	F_RECEIVEDAUTH		0x800
85#define	F_MASQUERADE		0x1000
86#define	F_FILTERED		0x2000
87#define	F_PROXY			0x4000
88
89#define RELAY_TLS_OPPORTUNISTIC	0
90#define RELAY_TLS_STARTTLS	1
91#define RELAY_TLS_SMTPS		2
92#define RELAY_TLS_NO		3
93
94#define RELAY_AUTH		0x08
95#define RELAY_LMTP		0x80
96#define	RELAY_TLS_VERIFY	0x200
97
98#define MTA_EXT_DSN		0x400
99
100
101#define P_SENDMAIL	0
102#define P_NEWALIASES	1
103#define P_MAKEMAP	2
104
105#define	CERT_ERROR	-1
106#define	CERT_OK		 0
107#define	CERT_NOCA	 1
108#define	CERT_NOCERT	 2
109#define	CERT_INVALID	 3
110
111struct userinfo {
112	char username[SMTPD_VUSERNAME_SIZE];
113	char directory[PATH_MAX];
114	uid_t uid;
115	gid_t gid;
116};
117
118struct netaddr {
119	struct sockaddr_storage ss;
120	int bits;
121};
122
123struct relayhost {
124	uint16_t flags;
125	int tls;
126	char hostname[HOST_NAME_MAX+1];
127	uint16_t port;
128	char authlabel[PATH_MAX];
129};
130
131struct credentials {
132	char username[LINE_MAX];
133	char password[LINE_MAX];
134};
135
136struct destination {
137	char	name[HOST_NAME_MAX+1];
138};
139
140struct source {
141	struct sockaddr_storage	addr;
142};
143
144struct addrname {
145	struct sockaddr_storage	addr;
146	char			name[HOST_NAME_MAX+1];
147};
148
149union lookup {
150	struct expand		*expand;
151	struct credentials	 creds;
152	struct netaddr		 netaddr;
153	struct source		 source;
154	struct destination	 domain;
155	struct userinfo		 userinfo;
156	struct mailaddr		 mailaddr;
157	struct addrname		 addrname;
158	struct maddrmap		*maddrmap;
159	char			 relayhost[LINE_MAX];
160};
161
162/*
163 * Bump IMSG_VERSION whenever a change is made to enum imsg_type.
164 * This will ensure that we can never use a wrong version of smtpctl with smtpd.
165 */
166#define	IMSG_VERSION		16
167
168enum imsg_type {
169	IMSG_NONE,
170
171	IMSG_CTL_OK,
172	IMSG_CTL_FAIL,
173
174	IMSG_CTL_GET_DIGEST,
175	IMSG_CTL_GET_STATS,
176	IMSG_CTL_LIST_MESSAGES,
177	IMSG_CTL_LIST_ENVELOPES,
178	IMSG_CTL_MTA_SHOW_HOSTS,
179	IMSG_CTL_MTA_SHOW_RELAYS,
180	IMSG_CTL_MTA_SHOW_ROUTES,
181	IMSG_CTL_MTA_SHOW_HOSTSTATS,
182	IMSG_CTL_MTA_BLOCK,
183	IMSG_CTL_MTA_UNBLOCK,
184	IMSG_CTL_MTA_SHOW_BLOCK,
185	IMSG_CTL_PAUSE_EVP,
186	IMSG_CTL_PAUSE_MDA,
187	IMSG_CTL_PAUSE_MTA,
188	IMSG_CTL_PAUSE_SMTP,
189	IMSG_CTL_PROFILE,
190	IMSG_CTL_PROFILE_DISABLE,
191	IMSG_CTL_PROFILE_ENABLE,
192	IMSG_CTL_RESUME_EVP,
193	IMSG_CTL_RESUME_MDA,
194	IMSG_CTL_RESUME_MTA,
195	IMSG_CTL_RESUME_SMTP,
196	IMSG_CTL_RESUME_ROUTE,
197	IMSG_CTL_REMOVE,
198	IMSG_CTL_SCHEDULE,
199	IMSG_CTL_SHOW_STATUS,
200	IMSG_CTL_TRACE_DISABLE,
201	IMSG_CTL_TRACE_ENABLE,
202	IMSG_CTL_UPDATE_TABLE,
203	IMSG_CTL_VERBOSE,
204	IMSG_CTL_DISCOVER_EVPID,
205	IMSG_CTL_DISCOVER_MSGID,
206
207	IMSG_CTL_SMTP_SESSION,
208
209	IMSG_GETADDRINFO,
210	IMSG_GETADDRINFO_END,
211	IMSG_GETNAMEINFO,
212	IMSG_RES_QUERY,
213
214	IMSG_CERT_INIT,
215	IMSG_CERT_CERTIFICATE,
216	IMSG_CERT_VERIFY,
217
218	IMSG_SETUP_KEY,
219	IMSG_SETUP_PEER,
220	IMSG_SETUP_DONE,
221
222	IMSG_CONF_START,
223	IMSG_CONF_END,
224
225	IMSG_STAT_INCREMENT,
226	IMSG_STAT_DECREMENT,
227	IMSG_STAT_SET,
228
229	IMSG_LKA_AUTHENTICATE,
230	IMSG_LKA_OPEN_FORWARD,
231	IMSG_LKA_ENVELOPE_SUBMIT,
232	IMSG_LKA_ENVELOPE_COMMIT,
233
234	IMSG_QUEUE_DELIVER,
235	IMSG_QUEUE_DELIVERY_OK,
236	IMSG_QUEUE_DELIVERY_TEMPFAIL,
237	IMSG_QUEUE_DELIVERY_PERMFAIL,
238	IMSG_QUEUE_DELIVERY_LOOP,
239	IMSG_QUEUE_DISCOVER_EVPID,
240	IMSG_QUEUE_DISCOVER_MSGID,
241	IMSG_QUEUE_ENVELOPE_ACK,
242	IMSG_QUEUE_ENVELOPE_COMMIT,
243	IMSG_QUEUE_ENVELOPE_REMOVE,
244	IMSG_QUEUE_ENVELOPE_SCHEDULE,
245	IMSG_QUEUE_ENVELOPE_SUBMIT,
246	IMSG_QUEUE_HOLDQ_HOLD,
247	IMSG_QUEUE_HOLDQ_RELEASE,
248	IMSG_QUEUE_MESSAGE_COMMIT,
249	IMSG_QUEUE_MESSAGE_ROLLBACK,
250	IMSG_QUEUE_SMTP_SESSION,
251	IMSG_QUEUE_TRANSFER,
252
253	IMSG_MDA_DELIVERY_OK,
254	IMSG_MDA_DELIVERY_TEMPFAIL,
255	IMSG_MDA_DELIVERY_PERMFAIL,
256	IMSG_MDA_DELIVERY_LOOP,
257	IMSG_MDA_DELIVERY_HOLD,
258	IMSG_MDA_DONE,
259	IMSG_MDA_FORK,
260	IMSG_MDA_HOLDQ_RELEASE,
261	IMSG_MDA_LOOKUP_USERINFO,
262	IMSG_MDA_KILL,
263	IMSG_MDA_OPEN_MESSAGE,
264
265	IMSG_MTA_DELIVERY_OK,
266	IMSG_MTA_DELIVERY_TEMPFAIL,
267	IMSG_MTA_DELIVERY_PERMFAIL,
268	IMSG_MTA_DELIVERY_LOOP,
269	IMSG_MTA_DELIVERY_HOLD,
270	IMSG_MTA_DNS_HOST,
271	IMSG_MTA_DNS_HOST_END,
272	IMSG_MTA_DNS_MX,
273	IMSG_MTA_DNS_MX_PREFERENCE,
274	IMSG_MTA_HOLDQ_RELEASE,
275	IMSG_MTA_LOOKUP_CREDENTIALS,
276	IMSG_MTA_LOOKUP_SOURCE,
277	IMSG_MTA_LOOKUP_HELO,
278	IMSG_MTA_LOOKUP_SMARTHOST,
279	IMSG_MTA_OPEN_MESSAGE,
280	IMSG_MTA_SCHEDULE,
281
282	IMSG_SCHED_ENVELOPE_BOUNCE,
283	IMSG_SCHED_ENVELOPE_DELIVER,
284	IMSG_SCHED_ENVELOPE_EXPIRE,
285	IMSG_SCHED_ENVELOPE_INJECT,
286	IMSG_SCHED_ENVELOPE_REMOVE,
287	IMSG_SCHED_ENVELOPE_TRANSFER,
288
289	IMSG_SMTP_AUTHENTICATE,
290	IMSG_SMTP_MESSAGE_COMMIT,
291	IMSG_SMTP_MESSAGE_CREATE,
292	IMSG_SMTP_MESSAGE_ROLLBACK,
293	IMSG_SMTP_MESSAGE_OPEN,
294	IMSG_SMTP_CHECK_SENDER,
295	IMSG_SMTP_EXPAND_RCPT,
296	IMSG_SMTP_LOOKUP_HELO,
297
298	IMSG_SMTP_REQ_CONNECT,
299	IMSG_SMTP_REQ_HELO,
300	IMSG_SMTP_REQ_MAIL,
301	IMSG_SMTP_REQ_RCPT,
302	IMSG_SMTP_REQ_DATA,
303	IMSG_SMTP_REQ_EOM,
304	IMSG_SMTP_EVENT_RSET,
305	IMSG_SMTP_EVENT_COMMIT,
306	IMSG_SMTP_EVENT_ROLLBACK,
307	IMSG_SMTP_EVENT_DISCONNECT,
308
309	IMSG_LKA_PROCESSOR_FORK,
310	IMSG_LKA_PROCESSOR_ERRFD,
311
312	IMSG_REPORT_SMTP_LINK_CONNECT,
313	IMSG_REPORT_SMTP_LINK_DISCONNECT,
314	IMSG_REPORT_SMTP_LINK_GREETING,
315	IMSG_REPORT_SMTP_LINK_IDENTIFY,
316	IMSG_REPORT_SMTP_LINK_TLS,
317	IMSG_REPORT_SMTP_LINK_AUTH,
318	IMSG_REPORT_SMTP_TX_RESET,
319	IMSG_REPORT_SMTP_TX_BEGIN,
320	IMSG_REPORT_SMTP_TX_MAIL,
321	IMSG_REPORT_SMTP_TX_RCPT,
322	IMSG_REPORT_SMTP_TX_ENVELOPE,
323	IMSG_REPORT_SMTP_TX_DATA,
324	IMSG_REPORT_SMTP_TX_COMMIT,
325	IMSG_REPORT_SMTP_TX_ROLLBACK,
326	IMSG_REPORT_SMTP_PROTOCOL_CLIENT,
327	IMSG_REPORT_SMTP_PROTOCOL_SERVER,
328	IMSG_REPORT_SMTP_FILTER_RESPONSE,
329	IMSG_REPORT_SMTP_TIMEOUT,
330
331	IMSG_FILTER_SMTP_BEGIN,
332	IMSG_FILTER_SMTP_END,
333	IMSG_FILTER_SMTP_PROTOCOL,
334	IMSG_FILTER_SMTP_DATA_BEGIN,
335	IMSG_FILTER_SMTP_DATA_END,
336
337	IMSG_CA_RSA_PRIVENC,
338	IMSG_CA_RSA_PRIVDEC,
339	IMSG_CA_ECDSA_SIGN,
340};
341
342enum smtp_proc_type {
343	PROC_PARENT = 0,
344	PROC_LKA,
345	PROC_QUEUE,
346	PROC_CONTROL,
347	PROC_SCHEDULER,
348	PROC_PONY,
349	PROC_CA,
350	PROC_PROCESSOR,
351	PROC_CLIENT,
352};
353
354enum table_type {
355	T_NONE		= 0,
356	T_DYNAMIC	= 0x01,	/* table with external source	*/
357	T_LIST		= 0x02,	/* table holding a list		*/
358	T_HASH		= 0x04,	/* table holding a hash table	*/
359};
360
361struct table {
362	char				 t_name[LINE_MAX];
363	enum table_type			 t_type;
364	char				 t_config[PATH_MAX];
365
366	void				*t_handle;
367	struct table_backend		*t_backend;
368};
369
370struct table_backend {
371	const char *name;
372	const unsigned int	services;
373	int	(*config)(struct table *);
374	int	(*add)(struct table *, const char *, const char *);
375	void	(*dump)(struct table *);
376	int	(*open)(struct table *);
377	int	(*update)(struct table *);
378	void	(*close)(struct table *);
379	int	(*lookup)(struct table *, enum table_service, const char *, char **);
380	int	(*fetch)(struct table *, enum table_service, char **);
381};
382
383
384enum bounce_type {
385	B_FAILED,
386	B_DELAYED,
387	B_DELIVERED
388};
389
390enum dsn_ret {
391	DSN_RETFULL = 1,
392	DSN_RETHDRS
393};
394
395struct delivery_bounce {
396	enum bounce_type	type;
397	time_t			delay;
398	time_t			ttl;
399	enum dsn_ret		dsn_ret;
400        int			mta_without_dsn;
401};
402
403enum expand_type {
404	EXPAND_INVALID,
405	EXPAND_USERNAME,
406	EXPAND_FILENAME,
407	EXPAND_FILTER,
408	EXPAND_INCLUDE,
409	EXPAND_ADDRESS,
410	EXPAND_ERROR,
411};
412
413enum filter_phase {
414	FILTER_CONNECT,
415	FILTER_HELO,
416	FILTER_EHLO,
417	FILTER_STARTTLS,
418	FILTER_AUTH,
419	FILTER_MAIL_FROM,
420	FILTER_RCPT_TO,
421	FILTER_DATA,
422	FILTER_DATA_LINE,
423	FILTER_RSET,
424	FILTER_QUIT,
425	FILTER_NOOP,
426	FILTER_HELP,
427	FILTER_WIZ,
428	FILTER_COMMIT,
429	FILTER_PHASES_COUNT     /* must be last */
430};
431
432struct expandnode {
433	RB_ENTRY(expandnode)	entry;
434	TAILQ_ENTRY(expandnode)	tq_entry;
435	enum expand_type	type;
436	int			sameuser;
437	int			realuser;
438	int			forwarded;
439	struct rule	       *rule;
440	struct expandnode      *parent;
441	unsigned int		depth;
442	union {
443		/*
444		 * user field handles both expansion user and system user
445		 * so we MUST make it large enough to fit a mailaddr user
446		 */
447		char		user[SMTPD_MAXLOCALPARTSIZE];
448		char		buffer[EXPAND_BUFFER];
449		struct mailaddr	mailaddr;
450	}			u;
451	char		subaddress[SMTPD_SUBADDRESS_SIZE];
452};
453
454struct expand {
455	RB_HEAD(expandtree, expandnode)	 tree;
456	TAILQ_HEAD(xnodes, expandnode)	*queue;
457	size_t				 nb_nodes;
458	struct rule			*rule;
459	struct expandnode		*parent;
460};
461
462struct maddrnode {
463	TAILQ_ENTRY(maddrnode)		entries;
464	struct mailaddr			mailaddr;
465};
466
467struct maddrmap {
468	TAILQ_HEAD(xmaddr, maddrnode)	queue;
469};
470
471#define DSN_SUCCESS 0x01
472#define DSN_FAILURE 0x02
473#define DSN_DELAY   0x04
474#define DSN_NEVER   0x08
475
476#define	DSN_ENVID_LEN	100
477
478#define	SMTPD_ENVELOPE_VERSION		3
479struct envelope {
480	TAILQ_ENTRY(envelope)		entry;
481
482	char				dispatcher[HOST_NAME_MAX+1];
483
484	char				tag[SMTPD_TAG_SIZE];
485
486	uint32_t			version;
487	uint64_t			id;
488	enum envelope_flags		flags;
489
490	char				smtpname[HOST_NAME_MAX+1];
491	char				helo[HOST_NAME_MAX+1];
492	char				hostname[HOST_NAME_MAX+1];
493	char				username[SMTPD_MAXMAILADDRSIZE];
494	char				errorline[LINE_MAX];
495	struct sockaddr_storage		ss;
496
497	struct mailaddr			sender;
498	struct mailaddr			rcpt;
499	struct mailaddr			dest;
500
501	char				mda_user[SMTPD_VUSERNAME_SIZE];
502	char				mda_subaddress[SMTPD_SUBADDRESS_SIZE];
503	char				mda_exec[LINE_MAX];
504
505	enum delivery_type		type;
506	union {
507		struct delivery_bounce	bounce;
508	}				agent;
509
510	uint16_t			retry;
511	time_t				creation;
512	time_t				ttl;
513	time_t				lasttry;
514	time_t				nexttry;
515	time_t				lastbounce;
516
517	struct mailaddr			dsn_orcpt;
518	char				dsn_envid[DSN_ENVID_LEN+1];
519	uint8_t				dsn_notify;
520	enum dsn_ret			dsn_ret;
521
522	uint8_t				esc_class;
523	uint8_t				esc_code;
524};
525
526struct listener {
527	uint16_t       		 flags;
528	int			 fd;
529	struct sockaddr_storage	 ss;
530	in_port_t		 port;
531	struct timeval		 timeout;
532	struct event		 ev;
533	char			 filter_name[PATH_MAX];
534	char			 pki_name[PATH_MAX];
535	char			 ca_name[PATH_MAX];
536	char			 tag[SMTPD_TAG_SIZE];
537	char			 authtable[LINE_MAX];
538	char			 hostname[HOST_NAME_MAX+1];
539	char			 hostnametable[PATH_MAX];
540	char			 sendertable[PATH_MAX];
541
542	TAILQ_ENTRY(listener)	 entry;
543
544	int			 local;		/* there must be a better way */
545};
546
547struct smtpd {
548	char				sc_conffile[PATH_MAX];
549	size_t				sc_maxsize;
550
551#define SMTPD_OPT_VERBOSE		0x00000001
552#define SMTPD_OPT_NOACTION		0x00000002
553	uint32_t			sc_opts;
554
555#define SMTPD_EXITING			0x00000001 /* unused */
556#define SMTPD_MDA_PAUSED		0x00000002
557#define SMTPD_MTA_PAUSED		0x00000004
558#define SMTPD_SMTP_PAUSED		0x00000008
559#define SMTPD_MDA_BUSY			0x00000010
560#define SMTPD_MTA_BUSY			0x00000020
561#define SMTPD_BOUNCE_BUSY		0x00000040
562#define SMTPD_SMTP_DISABLED		0x00000080
563	uint32_t			sc_flags;
564
565#define QUEUE_COMPRESSION      		0x00000001
566#define QUEUE_ENCRYPTION      		0x00000002
567#define QUEUE_EVPCACHE			0x00000004
568	uint32_t			sc_queue_flags;
569	char			       *sc_queue_key;
570	size_t				sc_queue_evpcache_size;
571
572	size_t				sc_session_max_rcpt;
573	size_t				sc_session_max_mails;
574
575	struct dict		       *sc_mda_wrappers;
576	size_t				sc_mda_max_session;
577	size_t				sc_mda_max_user_session;
578	size_t				sc_mda_task_hiwat;
579	size_t				sc_mda_task_lowat;
580	size_t				sc_mda_task_release;
581
582	size_t				sc_mta_max_deferred;
583
584	size_t				sc_scheduler_max_inflight;
585	size_t				sc_scheduler_max_evp_batch_size;
586	size_t				sc_scheduler_max_msg_batch_size;
587	size_t				sc_scheduler_max_schedule;
588
589	struct dict		       *sc_filter_processes_dict;
590
591	int				sc_ttl;
592#define MAX_BOUNCE_WARN			4
593	time_t				sc_bounce_warn[MAX_BOUNCE_WARN];
594	char				sc_hostname[HOST_NAME_MAX+1];
595	struct stat_backend	       *sc_stat;
596	struct compress_backend	       *sc_comp;
597
598	time_t					 sc_uptime;
599
600	/* This is a listener for a local socket used by smtp_enqueue(). */
601	struct listener                         *sc_sock_listener;
602
603	TAILQ_HEAD(listenerlist, listener)	*sc_listeners;
604
605	TAILQ_HEAD(rulelist, rule)		*sc_rules;
606
607
608	struct dict				*sc_filters_dict;
609	struct dict				*sc_dispatchers;
610	struct dispatcher			*sc_dispatcher_bounce;
611
612	struct dict			       *sc_ca_dict;
613	struct dict			       *sc_pki_dict;
614	struct dict			       *sc_ssl_dict;
615
616	struct dict			       *sc_tables_dict;		/* keyed lookup	*/
617
618	struct dict			       *sc_limits_dict;
619
620	char				       *sc_tls_ciphers;
621
622	char				       *sc_subaddressing_delim;
623
624	char				       *sc_srs_key;
625	char				       *sc_srs_key_backup;
626	int				        sc_srs_ttl;
627};
628
629#define	TRACE_DEBUG	0x0001
630#define	TRACE_IMSG	0x0002
631#define	TRACE_IO	0x0004
632#define	TRACE_SMTP	0x0008
633#define	TRACE_FILTERS	0x0010
634#define	TRACE_MTA	0x0020
635#define	TRACE_BOUNCE	0x0040
636#define	TRACE_SCHEDULER	0x0080
637#define	TRACE_LOOKUP	0x0100
638#define	TRACE_STAT	0x0200
639#define	TRACE_RULES	0x0400
640#define	TRACE_MPROC	0x0800
641#define	TRACE_EXPAND	0x1000
642#define	TRACE_TABLES	0x2000
643#define	TRACE_QUEUE	0x4000
644
645#define PROFILE_TOSTAT	0x0001
646#define PROFILE_IMSG	0x0002
647#define PROFILE_QUEUE	0x0004
648
649struct forward_req {
650	uint64_t			id;
651	uint8_t				status;
652
653	char				user[SMTPD_VUSERNAME_SIZE];
654	uid_t				uid;
655	gid_t				gid;
656	char				directory[PATH_MAX];
657};
658
659struct deliver {
660	char			dispatcher[EXPAND_BUFFER];
661
662	struct mailaddr		sender;
663	struct mailaddr		rcpt;
664	struct mailaddr		dest;
665
666	char			mda_subaddress[SMTPD_SUBADDRESS_SIZE];
667	char			mda_exec[LINE_MAX];
668
669	struct userinfo		userinfo;
670};
671
672struct mta_host {
673	SPLAY_ENTRY(mta_host)	 entry;
674	struct sockaddr		*sa;
675	char			*ptrname;
676	int			 refcount;
677	size_t			 nconn;
678	time_t			 lastconn;
679	time_t			 lastptrquery;
680
681#define HOST_IGNORE	0x01
682	int			 flags;
683};
684
685struct mta_mx {
686	TAILQ_ENTRY(mta_mx)	 entry;
687	struct mta_host		*host;
688	char			*mxname;
689	int			 preference;
690};
691
692struct mta_domain {
693	SPLAY_ENTRY(mta_domain)	 entry;
694	char			*name;
695	int			 as_host;
696	TAILQ_HEAD(, mta_mx)	 mxs;
697	int			 mxstatus;
698	int			 refcount;
699	size_t			 nconn;
700	time_t			 lastconn;
701	time_t			 lastmxquery;
702};
703
704struct mta_source {
705	SPLAY_ENTRY(mta_source)	 entry;
706	struct sockaddr		*sa;
707	int			 refcount;
708	size_t			 nconn;
709	time_t			 lastconn;
710};
711
712struct mta_connector {
713	struct mta_source		*source;
714	struct mta_relay		*relay;
715
716#define CONNECTOR_ERROR_FAMILY		0x0001
717#define CONNECTOR_ERROR_SOURCE		0x0002
718#define CONNECTOR_ERROR_MX		0x0004
719#define CONNECTOR_ERROR_ROUTE_NET	0x0008
720#define CONNECTOR_ERROR_ROUTE_SMTP	0x0010
721#define CONNECTOR_ERROR_ROUTE		0x0018
722#define CONNECTOR_ERROR_BLOCKED		0x0020
723#define CONNECTOR_ERROR			0x00ff
724
725#define CONNECTOR_LIMIT_HOST		0x0100
726#define CONNECTOR_LIMIT_ROUTE		0x0200
727#define CONNECTOR_LIMIT_SOURCE		0x0400
728#define CONNECTOR_LIMIT_RELAY		0x0800
729#define CONNECTOR_LIMIT_CONN		0x1000
730#define CONNECTOR_LIMIT_DOMAIN		0x2000
731#define CONNECTOR_LIMIT			0xff00
732
733#define CONNECTOR_NEW			0x10000
734#define CONNECTOR_WAIT			0x20000
735	int				 flags;
736
737	int				 refcount;
738	size_t				 nconn;
739	time_t				 lastconn;
740};
741
742struct mta_route {
743	SPLAY_ENTRY(mta_route)	 entry;
744	uint64_t		 id;
745	struct mta_source	*src;
746	struct mta_host		*dst;
747#define ROUTE_NEW		0x01
748#define ROUTE_RUNQ		0x02
749#define ROUTE_KEEPALIVE		0x04
750#define ROUTE_DISABLED		0xf0
751#define ROUTE_DISABLED_NET	0x10
752#define ROUTE_DISABLED_SMTP	0x20
753	int			 flags;
754	int			 nerror;
755	int			 penalty;
756	int			 refcount;
757	size_t			 nconn;
758	time_t			 lastconn;
759	time_t			 lastdisc;
760	time_t			 lastpenalty;
761};
762
763struct mta_limits {
764	size_t	maxconn_per_host;
765	size_t	maxconn_per_route;
766	size_t	maxconn_per_source;
767	size_t	maxconn_per_connector;
768	size_t	maxconn_per_relay;
769	size_t	maxconn_per_domain;
770
771	time_t	conndelay_host;
772	time_t	conndelay_route;
773	time_t	conndelay_source;
774	time_t	conndelay_connector;
775	time_t	conndelay_relay;
776	time_t	conndelay_domain;
777
778	time_t	discdelay_route;
779
780	size_t	max_mail_per_session;
781	time_t	sessdelay_transaction;
782	time_t	sessdelay_keepalive;
783
784	size_t	max_failures_per_session;
785
786	int	family;
787
788	int	task_hiwat;
789	int	task_lowat;
790	int	task_release;
791};
792
793struct mta_relay {
794	SPLAY_ENTRY(mta_relay)	 entry;
795	uint64_t		 id;
796
797	struct dispatcher	*dispatcher;
798	struct mta_domain	*domain;
799	struct mta_limits	*limits;
800	int			 tls;
801	int			 flags;
802	char			*backupname;
803	int			 backuppref;
804	char			*sourcetable;
805	uint16_t		 port;
806	char			*pki_name;
807	char			*ca_name;
808	char			*authtable;
809	char			*authlabel;
810	char			*helotable;
811	char			*heloname;
812	char			*secret;
813	int			 srs;
814
815	int			 state;
816	size_t			 ntask;
817	TAILQ_HEAD(, mta_task)	 tasks;
818
819	struct tree		 connectors;
820	size_t			 sourceloop;
821	time_t			 lastsource;
822	time_t			 nextsource;
823
824	int			 fail;
825	char			*failstr;
826
827#define RELAY_WAIT_MX		0x01
828#define RELAY_WAIT_PREFERENCE	0x02
829#define RELAY_WAIT_SECRET	0x04
830#define RELAY_WAIT_LIMITS	0x08
831#define RELAY_WAIT_SOURCE	0x10
832#define RELAY_WAIT_CONNECTOR	0x20
833#define RELAY_WAIT_SMARTHOST	0x40
834#define RELAY_WAITMASK		0x7f
835	int			 status;
836
837	int			 refcount;
838	size_t			 nconn;
839	size_t			 nconn_ready;
840	time_t			 lastconn;
841};
842
843struct mta_envelope {
844	TAILQ_ENTRY(mta_envelope)	 entry;
845	uint64_t			 id;
846	uint64_t			 session;
847	time_t				 creation;
848	char				*smtpname;
849	char				*dest;
850	char				*rcpt;
851	struct mta_task			*task;
852	int				 delivery;
853
854	int				 ext;
855	char				*dsn_orcpt;
856	char				dsn_envid[DSN_ENVID_LEN+1];
857	uint8_t				dsn_notify;
858	enum dsn_ret			dsn_ret;
859
860	char				 status[LINE_MAX];
861};
862
863struct mta_task {
864	TAILQ_ENTRY(mta_task)		 entry;
865	struct mta_relay		*relay;
866	uint32_t			 msgid;
867	TAILQ_HEAD(, mta_envelope)	 envelopes;
868	char				*sender;
869};
870
871struct passwd;
872
873struct queue_backend {
874	int	(*init)(struct passwd *, int, const char *);
875};
876
877struct compress_backend {
878	size_t	(*compress_chunk)(void *, size_t, void *, size_t);
879	size_t	(*uncompress_chunk)(void *, size_t, void *, size_t);
880	int	(*compress_file)(FILE *, FILE *);
881	int	(*uncompress_file)(FILE *, FILE *);
882};
883
884/* auth structures */
885enum auth_type {
886	AUTH_BSD,
887	AUTH_PWD,
888};
889
890struct auth_backend {
891	int	(*authenticate)(char *, char *);
892};
893
894struct scheduler_backend {
895	int	(*init)(const char *);
896
897	int	(*insert)(struct scheduler_info *);
898	size_t	(*commit)(uint32_t);
899	size_t	(*rollback)(uint32_t);
900
901	int	(*update)(struct scheduler_info *);
902	int	(*delete)(uint64_t);
903	int	(*hold)(uint64_t, uint64_t);
904	int	(*release)(int, uint64_t, int);
905
906	int	(*batch)(int, int*, size_t*, uint64_t*, int*);
907
908	size_t	(*messages)(uint32_t, uint32_t *, size_t);
909	size_t	(*envelopes)(uint64_t, struct evpstate *, size_t);
910	int	(*schedule)(uint64_t);
911	int	(*remove)(uint64_t);
912	int	(*suspend)(uint64_t);
913	int	(*resume)(uint64_t);
914	int	(*query)(uint64_t);
915};
916
917enum stat_type {
918	STAT_COUNTER,
919	STAT_TIMESTAMP,
920	STAT_TIMEVAL,
921	STAT_TIMESPEC,
922};
923
924struct stat_value {
925	enum stat_type	type;
926	union stat_v {
927		size_t		counter;
928		time_t		timestamp;
929		struct timeval	tv;
930		struct timespec	ts;
931	} u;
932};
933
934#define	STAT_KEY_SIZE	1024
935struct stat_kv {
936	void	*iter;
937	char	key[STAT_KEY_SIZE];
938	struct stat_value	val;
939};
940
941struct stat_backend {
942	void	(*init)(void);
943	void	(*close)(void);
944	void	(*increment)(const char *, size_t);
945	void	(*decrement)(const char *, size_t);
946	void	(*set)(const char *, const struct stat_value *);
947	int	(*iter)(void **, char **, struct stat_value *);
948};
949
950struct stat_digest {
951	time_t			 startup;
952	time_t			 timestamp;
953
954	size_t			 clt_connect;
955	size_t			 clt_disconnect;
956
957	size_t			 evp_enqueued;
958	size_t			 evp_dequeued;
959
960	size_t			 evp_expired;
961	size_t			 evp_removed;
962	size_t			 evp_bounce;
963
964	size_t			 dlv_ok;
965	size_t			 dlv_permfail;
966	size_t			 dlv_tempfail;
967	size_t			 dlv_loop;
968};
969
970
971struct mproc {
972	pid_t		 pid;
973	char		*name;
974	int		 proc;
975	void		(*handler)(struct mproc *, struct imsg *);
976	struct imsgbuf	 imsgbuf;
977
978	char		*m_buf;
979	size_t		 m_alloc;
980	size_t		 m_pos;
981	uint32_t	 m_type;
982	uint32_t	 m_peerid;
983	pid_t		 m_pid;
984	int		 m_fd;
985
986	int		 enable;
987	short		 events;
988	struct event	 ev;
989	void		*data;
990};
991
992struct msg {
993	const uint8_t	*pos;
994	const uint8_t	*end;
995};
996
997extern enum smtp_proc_type	smtpd_process;
998
999extern int tracing;
1000extern int foreground_log;
1001extern int profiling;
1002
1003extern struct mproc *p_control;
1004extern struct mproc *p_parent;
1005extern struct mproc *p_lka;
1006extern struct mproc *p_queue;
1007extern struct mproc *p_scheduler;
1008extern struct mproc *p_pony;
1009extern struct mproc *p_ca;
1010
1011extern struct smtpd	*env;
1012extern void (*imsg_callback)(struct mproc *, struct imsg *);
1013
1014/* inter-process structures */
1015
1016struct bounce_req_msg {
1017	uint64_t		evpid;
1018	time_t			timestamp;
1019	struct delivery_bounce	bounce;
1020};
1021
1022enum dns_error {
1023	DNS_OK = 0,
1024	DNS_RETRY,
1025	DNS_EINVAL,
1026	DNS_ENONAME,
1027	DNS_ENOTFOUND,
1028};
1029
1030enum lka_resp_status {
1031	LKA_OK,
1032	LKA_TEMPFAIL,
1033	LKA_PERMFAIL
1034};
1035
1036enum filter_type {
1037	FILTER_TYPE_BUILTIN,
1038	FILTER_TYPE_PROC,
1039	FILTER_TYPE_CHAIN,
1040};
1041
1042enum filter_subsystem {
1043	FILTER_SUBSYSTEM_SMTP_IN	= 1<<0,
1044	FILTER_SUBSYSTEM_SMTP_OUT	= 1<<1,
1045};
1046
1047struct filter_proc {
1048	const char		       *command;
1049	const char		       *user;
1050	const char		       *group;
1051	const char		       *chroot;
1052	int				errfd;
1053	enum filter_subsystem		filter_subsystem;
1054};
1055
1056struct filter_config {
1057	char			       *name;
1058	enum filter_subsystem		filter_subsystem;
1059	enum filter_type		filter_type;
1060	enum filter_phase               phase;
1061	char                           *reject;
1062	char                           *disconnect;
1063	char                           *rewrite;
1064	char                           *report;
1065	uint8_t				junk;
1066  	uint8_t				bypass;
1067	char                           *proc;
1068
1069	const char		      **chain;
1070	size_t				chain_size;
1071	struct dict			chain_procs;
1072
1073	int8_t				not_fcrdns;
1074	int8_t				fcrdns;
1075
1076	int8_t				not_rdns;
1077	int8_t				rdns;
1078
1079	int8_t                          not_rdns_table;
1080	struct table                   *rdns_table;
1081
1082	int8_t                          not_rdns_regex;
1083	struct table                   *rdns_regex;
1084
1085	int8_t                          not_src_table;
1086	struct table                   *src_table;
1087
1088	int8_t                          not_src_regex;
1089	struct table                   *src_regex;
1090
1091	int8_t                          not_helo_table;
1092	struct table                   *helo_table;
1093
1094	int8_t                          not_helo_regex;
1095	struct table                   *helo_regex;
1096
1097  	int8_t                          not_auth;
1098	int8_t				auth;
1099
1100  	int8_t                          not_auth_table;
1101	struct table                   *auth_table;
1102
1103	int8_t                          not_auth_regex;
1104	struct table                   *auth_regex;
1105
1106	int8_t                          not_mail_from_table;
1107	struct table                   *mail_from_table;
1108
1109	int8_t                          not_mail_from_regex;
1110	struct table                   *mail_from_regex;
1111
1112	int8_t                          not_rcpt_to_table;
1113	struct table                   *rcpt_to_table;
1114
1115	int8_t                          not_rcpt_to_regex;
1116	struct table                   *rcpt_to_regex;
1117
1118};
1119
1120enum filter_status {
1121	FILTER_PROCEED,
1122	FILTER_REWRITE,
1123	FILTER_REJECT,
1124	FILTER_DISCONNECT,
1125	FILTER_JUNK,
1126};
1127
1128enum ca_resp_status {
1129	CA_OK,
1130	CA_FAIL
1131};
1132
1133enum mda_resp_status {
1134	MDA_OK,
1135	MDA_TEMPFAIL,
1136	MDA_PERMFAIL
1137};
1138
1139struct msg_walkinfo {
1140	struct event	 ev;
1141	uint32_t	 msgid;
1142	uint32_t	 peerid;
1143	size_t		 n_evp;
1144	void		*data;
1145	int		 done;
1146};
1147
1148
1149enum dispatcher_type {
1150	DISPATCHER_LOCAL,
1151	DISPATCHER_REMOTE,
1152	DISPATCHER_BOUNCE,
1153};
1154
1155struct dispatcher_local {
1156	uint8_t is_mbox;	/* only for MBOX */
1157
1158	uint8_t	expand_only;
1159	uint8_t	forward_only;
1160
1161	char	*mda_wrapper;
1162	char	*command;
1163
1164	char	*table_alias;
1165	char	*table_virtual;
1166	char	*table_userbase;
1167
1168	char	*user;
1169};
1170
1171struct dispatcher_remote {
1172	char	*helo;
1173	char	*helo_source;
1174
1175	char	*source;
1176
1177	char	*ca;
1178	char	*pki;
1179
1180	char	*mail_from;
1181
1182	char	*smarthost;
1183	int	 smarthost_domain;
1184
1185	char	*auth;
1186	int	 tls_required;
1187	int	 tls_noverify;
1188
1189	int	 backup;
1190	char	*backupmx;
1191
1192	char	*filtername;
1193
1194	int	 srs;
1195};
1196
1197struct dispatcher_bounce {
1198};
1199
1200struct dispatcher {
1201	enum dispatcher_type			type;
1202	union dispatcher_agent {
1203		struct dispatcher_local		local;
1204		struct dispatcher_remote  	remote;
1205		struct dispatcher_bounce  	bounce;
1206	} u;
1207
1208	time_t	ttl;
1209};
1210
1211struct rule {
1212	TAILQ_ENTRY(rule)	r_entry;
1213
1214	uint8_t	reject;
1215
1216	int8_t	flag_tag;
1217	int8_t	flag_from;
1218	int8_t	flag_for;
1219	int8_t	flag_from_rdns;
1220	int8_t	flag_from_socket;
1221
1222	int8_t	flag_tag_regex;
1223	int8_t	flag_from_regex;
1224	int8_t	flag_for_regex;
1225
1226	int8_t	flag_smtp_helo;
1227	int8_t	flag_smtp_starttls;
1228	int8_t	flag_smtp_auth;
1229	int8_t	flag_smtp_mail_from;
1230	int8_t	flag_smtp_rcpt_to;
1231
1232	int8_t	flag_smtp_helo_regex;
1233	int8_t	flag_smtp_starttls_regex;
1234	int8_t	flag_smtp_auth_regex;
1235	int8_t	flag_smtp_mail_from_regex;
1236	int8_t	flag_smtp_rcpt_to_regex;
1237
1238
1239	char	*table_tag;
1240	char	*table_from;
1241	char	*table_for;
1242
1243	char	*table_smtp_helo;
1244	char	*table_smtp_auth;
1245	char	*table_smtp_mail_from;
1246	char	*table_smtp_rcpt_to;
1247
1248	char	*dispatcher;
1249};
1250
1251
1252/* aliases.c */
1253int aliases_get(struct expand *, const char *);
1254int aliases_virtual_get(struct expand *, const struct mailaddr *);
1255int alias_parse(struct expandnode *, const char *);
1256
1257
1258/* auth.c */
1259struct auth_backend *auth_backend_lookup(enum auth_type);
1260
1261
1262/* bounce.c */
1263void bounce_add(uint64_t);
1264void bounce_fd(int);
1265
1266
1267/* ca.c */
1268int	 ca(void);
1269int	 ca_X509_verify(void *, void *, const char *, const char *, const char **);
1270void	 ca_imsg(struct mproc *, struct imsg *);
1271void	 ca_init(void);
1272void	 ca_engine_init(void);
1273
1274
1275/* cert.c */
1276int cert_init(const char *, int,
1277    void (*)(void *, int, const char *, const void *, size_t), void *);
1278int cert_verify(const void *, const char *, int, void (*)(void *, int), void *);
1279void cert_dispatch_request(struct mproc *, struct imsg *);
1280void cert_dispatch_result(struct mproc *, struct imsg *);
1281
1282
1283/* compress_backend.c */
1284struct compress_backend *compress_backend_lookup(const char *);
1285size_t	compress_chunk(void *, size_t, void *, size_t);
1286size_t	uncompress_chunk(void *, size_t, void *, size_t);
1287int	compress_file(FILE *, FILE *);
1288int	uncompress_file(FILE *, FILE *);
1289
1290/* config.c */
1291#define PURGE_LISTENERS		0x01
1292#define PURGE_TABLES		0x02
1293#define PURGE_RULES		0x04
1294#define PURGE_PKI		0x08
1295#define PURGE_PKI_KEYS		0x10
1296#define PURGE_DISPATCHERS	0x20
1297#define PURGE_EVERYTHING	0xff
1298struct smtpd *config_default(void);
1299void purge_config(uint8_t);
1300void config_process(enum smtp_proc_type);
1301void config_peer(enum smtp_proc_type);
1302
1303
1304/* control.c */
1305int control(void);
1306int control_create_socket(void);
1307
1308
1309/* crypto.c */
1310int	crypto_setup(const char *, size_t);
1311int	crypto_encrypt_file(FILE *, FILE *);
1312int	crypto_decrypt_file(FILE *, FILE *);
1313size_t	crypto_encrypt_buffer(const char *, size_t, char *, size_t);
1314size_t	crypto_decrypt_buffer(const char *, size_t, char *, size_t);
1315
1316
1317/* dns.c */
1318void dns_imsg(struct mproc *, struct imsg *);
1319
1320
1321/* enqueue.c */
1322int		 enqueue(int, char **, FILE *);
1323
1324
1325/* envelope.c */
1326void envelope_set_errormsg(struct envelope *, char *, ...);
1327void envelope_set_esc_class(struct envelope *, enum enhanced_status_class);
1328void envelope_set_esc_code(struct envelope *, enum enhanced_status_code);
1329int envelope_load_buffer(struct envelope *, const char *, size_t);
1330int envelope_dump_buffer(const struct envelope *, char *, size_t);
1331
1332
1333/* expand.c */
1334int expand_cmp(struct expandnode *, struct expandnode *);
1335void expand_insert(struct expand *, struct expandnode *);
1336struct expandnode *expand_lookup(struct expand *, struct expandnode *);
1337void expand_clear(struct expand *);
1338void expand_free(struct expand *);
1339int expand_line(struct expand *, const char *, int);
1340int expand_to_text(struct expand *, char *, size_t);
1341RB_PROTOTYPE(expandtree, expandnode, nodes, expand_cmp);
1342
1343
1344/* forward.c */
1345int forwards_get(int, struct expand *);
1346
1347
1348/* limit.c */
1349void limit_mta_set_defaults(struct mta_limits *);
1350int limit_mta_set(struct mta_limits *, const char*, int64_t);
1351
1352
1353/* lka.c */
1354int lka(void);
1355
1356
1357/* lka_proc.c */
1358int lka_proc_ready(void);
1359void lka_proc_forked(const char *, uint32_t, int);
1360void lka_proc_errfd(const char *, int);
1361struct io *lka_proc_get_io(const char *);
1362
1363
1364/* lka_report.c */
1365void lka_report_init(void);
1366void lka_report_register_hook(const char *, const char *);
1367void lka_report_smtp_link_connect(const char *, struct timeval *, uint64_t, const char *, int,
1368    const struct sockaddr_storage *, const struct sockaddr_storage *);
1369void lka_report_smtp_link_disconnect(const char *, struct timeval *, uint64_t);
1370void lka_report_smtp_link_greeting(const char *, uint64_t, struct timeval *,
1371    const char *);
1372void lka_report_smtp_link_identify(const char *, struct timeval *, uint64_t, const char *, const char *);
1373void lka_report_smtp_link_tls(const char *, struct timeval *, uint64_t, const char *);
1374void lka_report_smtp_link_auth(const char *, struct timeval *, uint64_t, const char *, const char *);
1375void lka_report_smtp_tx_reset(const char *, struct timeval *, uint64_t, uint32_t);
1376void lka_report_smtp_tx_begin(const char *, struct timeval *, uint64_t, uint32_t);
1377void lka_report_smtp_tx_mail(const char *, struct timeval *, uint64_t, uint32_t, const char *, int);
1378void lka_report_smtp_tx_rcpt(const char *, struct timeval *, uint64_t, uint32_t, const char *, int);
1379void lka_report_smtp_tx_envelope(const char *, struct timeval *, uint64_t, uint32_t, uint64_t);
1380void lka_report_smtp_tx_commit(const char *, struct timeval *, uint64_t, uint32_t, size_t);
1381void lka_report_smtp_tx_data(const char *, struct timeval *, uint64_t, uint32_t, int);
1382void lka_report_smtp_tx_rollback(const char *, struct timeval *, uint64_t, uint32_t);
1383void lka_report_smtp_protocol_client(const char *, struct timeval *, uint64_t, const char *);
1384void lka_report_smtp_protocol_server(const char *, struct timeval *, uint64_t, const char *);
1385void lka_report_smtp_filter_response(const char *, struct timeval *, uint64_t,
1386    int, int, const char *);
1387void lka_report_smtp_timeout(const char *, struct timeval *, uint64_t);
1388void lka_report_filter_report(uint64_t, const char *, int, const char *,
1389    struct timeval *, const char *);
1390void lka_report_proc(const char *, const char *);
1391
1392
1393/* lka_filter.c */
1394void lka_filter_init(void);
1395void lka_filter_register_hook(const char *, const char *);
1396void lka_filter_ready(void);
1397int lka_filter_proc_in_session(uint64_t, const char *);
1398void lka_filter_begin(uint64_t, const char *);
1399void lka_filter_end(uint64_t);
1400void lka_filter_protocol(uint64_t, enum filter_phase, const char *);
1401void lka_filter_data_begin(uint64_t);
1402void lka_filter_data_end(uint64_t);
1403int lka_filter_response(uint64_t, const char *, const char *);
1404
1405
1406/* lka_session.c */
1407void lka_session(uint64_t, struct envelope *);
1408void lka_session_forward_reply(struct forward_req *, int);
1409
1410
1411/* log.c */
1412void vlog(int, const char *, va_list);
1413void logit(int, const char *, ...) __attribute__((format (printf, 2, 3)));
1414
1415
1416/* mda.c */
1417void mda_postfork(void);
1418void mda_postprivdrop(void);
1419void mda_imsg(struct mproc *, struct imsg *);
1420
1421
1422/* mda_mbox.c */
1423void mda_mbox_init(struct deliver *);
1424void mda_mbox(struct deliver *);
1425
1426
1427/* mda_unpriv.c */
1428void mda_unpriv(struct dispatcher *, struct deliver *, const char *, const char *);
1429
1430
1431/* mda_variables.c */
1432ssize_t mda_expand_format(char *, size_t, const struct deliver *,
1433    const struct userinfo *, const char *);
1434
1435
1436/* makemap.c */
1437int makemap(int, int, char **);
1438
1439
1440/* mailaddr.c */
1441int mailaddr_line(struct maddrmap *, const char *);
1442void maddrmap_init(struct maddrmap *);
1443void maddrmap_insert(struct maddrmap *, struct maddrnode *);
1444void maddrmap_free(struct maddrmap *);
1445
1446
1447/* mproc.c */
1448int mproc_fork(struct mproc *, const char*, char **);
1449void mproc_init(struct mproc *, int);
1450void mproc_clear(struct mproc *);
1451void mproc_enable(struct mproc *);
1452void mproc_disable(struct mproc *);
1453void mproc_event_add(struct mproc *);
1454void m_compose(struct mproc *, uint32_t, uint32_t, pid_t, int, void *, size_t);
1455void m_composev(struct mproc *, uint32_t, uint32_t, pid_t, int,
1456    const struct iovec *, int);
1457void m_forward(struct mproc *, struct imsg *);
1458void m_create(struct mproc *, uint32_t, uint32_t, pid_t, int);
1459void m_add(struct mproc *, const void *, size_t);
1460void m_add_int(struct mproc *, int);
1461void m_add_u32(struct mproc *, uint32_t);
1462void m_add_size(struct mproc *, size_t);
1463void m_add_time(struct mproc *, time_t);
1464void m_add_timeval(struct mproc *, struct timeval *tv);
1465void m_add_string(struct mproc *, const char *);
1466void m_add_data(struct mproc *, const void *, size_t);
1467void m_add_evpid(struct mproc *, uint64_t);
1468void m_add_msgid(struct mproc *, uint32_t);
1469void m_add_id(struct mproc *, uint64_t);
1470void m_add_sockaddr(struct mproc *, const struct sockaddr *);
1471void m_add_mailaddr(struct mproc *, const struct mailaddr *);
1472void m_add_envelope(struct mproc *, const struct envelope *);
1473void m_add_params(struct mproc *, struct dict *);
1474void m_close(struct mproc *);
1475void m_flush(struct mproc *);
1476
1477void m_msg(struct msg *, struct imsg *);
1478int  m_is_eom(struct msg *);
1479void m_end(struct msg *);
1480void m_get_int(struct msg *, int *);
1481void m_get_size(struct msg *, size_t *);
1482void m_get_u32(struct msg *, uint32_t *);
1483void m_get_time(struct msg *, time_t *);
1484void m_get_timeval(struct msg *, struct timeval *);
1485void m_get_string(struct msg *, const char **);
1486void m_get_data(struct msg *, const void **, size_t *);
1487void m_get_evpid(struct msg *, uint64_t *);
1488void m_get_msgid(struct msg *, uint32_t *);
1489void m_get_id(struct msg *, uint64_t *);
1490void m_get_sockaddr(struct msg *, struct sockaddr *);
1491void m_get_mailaddr(struct msg *, struct mailaddr *);
1492void m_get_envelope(struct msg *, struct envelope *);
1493void m_get_params(struct msg *, struct dict *);
1494void m_clear_params(struct dict *);
1495
1496
1497/* mta.c */
1498void mta_postfork(void);
1499void mta_postprivdrop(void);
1500void mta_imsg(struct mproc *, struct imsg *);
1501void mta_route_ok(struct mta_relay *, struct mta_route *);
1502void mta_route_error(struct mta_relay *, struct mta_route *);
1503void mta_route_down(struct mta_relay *, struct mta_route *);
1504void mta_route_collect(struct mta_relay *, struct mta_route *);
1505void mta_source_error(struct mta_relay *, struct mta_route *, const char *);
1506void mta_delivery_log(struct mta_envelope *, const char *, const char *, int, const char *);
1507void mta_delivery_notify(struct mta_envelope *);
1508struct mta_task *mta_route_next_task(struct mta_relay *, struct mta_route *);
1509const char *mta_host_to_text(struct mta_host *);
1510const char *mta_relay_to_text(struct mta_relay *);
1511
1512
1513/* mta_session.c */
1514void mta_session(struct mta_relay *, struct mta_route *, const char *);
1515void mta_session_imsg(struct mproc *, struct imsg *);
1516
1517
1518/* parse.y */
1519int parse_config(struct smtpd *, const char *, int);
1520int cmdline_symset(char *);
1521
1522
1523/* queue.c */
1524int queue(void);
1525
1526
1527/* queue_backend.c */
1528uint32_t queue_generate_msgid(void);
1529uint64_t queue_generate_evpid(uint32_t);
1530int queue_init(const char *, int);
1531int queue_close(void);
1532int queue_message_create(uint32_t *);
1533int queue_message_delete(uint32_t);
1534int queue_message_commit(uint32_t);
1535int queue_message_fd_r(uint32_t);
1536int queue_message_fd_rw(uint32_t);
1537int queue_envelope_create(struct envelope *);
1538int queue_envelope_delete(uint64_t);
1539int queue_envelope_load(uint64_t, struct envelope *);
1540int queue_envelope_update(struct envelope *);
1541int queue_envelope_walk(struct envelope *);
1542int queue_message_walk(struct envelope *, uint32_t, int *, void **);
1543
1544
1545/* report_smtp.c */
1546void report_smtp_link_connect(const char *, uint64_t, const char *, int,
1547    const struct sockaddr_storage *, const struct sockaddr_storage *);
1548void report_smtp_link_disconnect(const char *, uint64_t);
1549void report_smtp_link_greeting(const char *, uint64_t, const char *);
1550void report_smtp_link_identify(const char *, uint64_t, const char *, const char *);
1551void report_smtp_link_tls(const char *, uint64_t, const char *);
1552void report_smtp_link_auth(const char *, uint64_t, const char *, const char *);
1553void report_smtp_tx_reset(const char *, uint64_t, uint32_t);
1554void report_smtp_tx_begin(const char *, uint64_t, uint32_t);
1555void report_smtp_tx_mail(const char *, uint64_t, uint32_t, const char *, int);
1556void report_smtp_tx_rcpt(const char *, uint64_t, uint32_t, const char *, int);
1557void report_smtp_tx_envelope(const char *, uint64_t, uint32_t, uint64_t);
1558void report_smtp_tx_data(const char *, uint64_t, uint32_t, int);
1559void report_smtp_tx_commit(const char *, uint64_t, uint32_t, size_t);
1560void report_smtp_tx_rollback(const char *, uint64_t, uint32_t);
1561void report_smtp_protocol_client(const char *, uint64_t, const char *);
1562void report_smtp_protocol_server(const char *, uint64_t, const char *);
1563void report_smtp_filter_response(const char *, uint64_t, int, int, const char *);
1564void report_smtp_timeout(const char *, uint64_t);
1565
1566
1567/* ruleset.c */
1568struct rule *ruleset_match(const struct envelope *);
1569
1570
1571/* scheduler.c */
1572int scheduler(void);
1573
1574
1575/* scheduler_bakend.c */
1576struct scheduler_backend *scheduler_backend_lookup(const char *);
1577void scheduler_info(struct scheduler_info *, struct envelope *);
1578
1579
1580/* pony.c */
1581int pony(void);
1582void pony_imsg(struct mproc *, struct imsg *);
1583
1584
1585/* resolver.c */
1586void resolver_getaddrinfo(const char *, const char *, const struct addrinfo *,
1587    void(*)(void *, int, struct addrinfo*), void *);
1588void resolver_getnameinfo(const struct sockaddr *, int,
1589    void(*)(void *, int, const char *, const char *), void *);
1590void resolver_res_query(const char *, int, int,
1591    void (*cb)(void *, int, int, int, const void *, int), void *);
1592void resolver_dispatch_request(struct mproc *, struct imsg *);
1593void resolver_dispatch_result(struct mproc *, struct imsg *);
1594
1595
1596/* smtp.c */
1597void smtp_postfork(void);
1598void smtp_postprivdrop(void);
1599void smtp_imsg(struct mproc *, struct imsg *);
1600void smtp_configure(void);
1601void smtp_collect(void);
1602
1603
1604/* smtp_session.c */
1605int smtp_session(struct listener *, int, const struct sockaddr_storage *,
1606    const char *, struct io *);
1607void smtp_session_imsg(struct mproc *, struct imsg *);
1608
1609
1610/* smtpf_session.c */
1611int smtpf_session(struct listener *, int, const struct sockaddr_storage *,
1612    const char *);
1613void smtpf_session_imsg(struct mproc *, struct imsg *);
1614
1615
1616/* smtpd.c */
1617void imsg_dispatch(struct mproc *, struct imsg *);
1618const char *proc_name(enum smtp_proc_type);
1619const char *proc_title(enum smtp_proc_type);
1620const char *imsg_to_str(int);
1621void log_imsg(int, int, struct imsg *);
1622int fork_proc_backend(const char *, const char *, const char *);
1623
1624
1625/* srs.c */
1626const char *srs_encode(const char *, const char *);
1627const char *srs_decode(const char *);
1628
1629
1630/* ssl_smtpd.c */
1631void   *ssl_mta_init(void *, char *, off_t, const char *);
1632void   *ssl_smtp_init(void *, int);
1633
1634
1635/* stat_backend.c */
1636struct stat_backend	*stat_backend_lookup(const char *);
1637void	stat_increment(const char *, size_t);
1638void	stat_decrement(const char *, size_t);
1639void	stat_set(const char *, const struct stat_value *);
1640struct stat_value *stat_counter(size_t);
1641struct stat_value *stat_timestamp(time_t);
1642struct stat_value *stat_timeval(struct timeval *);
1643struct stat_value *stat_timespec(struct timespec *);
1644
1645
1646/* table.c */
1647struct table *table_find(struct smtpd *, const char *);
1648struct table *table_create(struct smtpd *, const char *, const char *,
1649    const char *);
1650int	table_config(struct table *);
1651int	table_open(struct table *);
1652int	table_update(struct table *);
1653void	table_close(struct table *);
1654void	table_dump(struct table *);
1655int	table_check_use(struct table *, uint32_t, uint32_t);
1656int	table_check_type(struct table *, uint32_t);
1657int	table_check_service(struct table *, uint32_t);
1658int	table_match(struct table *, enum table_service, const char *);
1659int	table_lookup(struct table *, enum table_service, const char *,
1660    union lookup *);
1661int	table_fetch(struct table *, enum table_service, union lookup *);
1662void table_destroy(struct smtpd *, struct table *);
1663void table_add(struct table *, const char *, const char *);
1664int table_domain_match(const char *, const char *);
1665int table_netaddr_match(const char *, const char *);
1666int table_mailaddr_match(const char *, const char *);
1667int table_regex_match(const char *, const char *);
1668void	table_open_all(struct smtpd *);
1669void	table_dump_all(struct smtpd *);
1670void	table_close_all(struct smtpd *);
1671
1672
1673/* to.c */
1674int email_to_mailaddr(struct mailaddr *, char *);
1675int text_to_netaddr(struct netaddr *, const char *);
1676int text_to_mailaddr(struct mailaddr *, const char *);
1677int text_to_relayhost(struct relayhost *, const char *);
1678int text_to_userinfo(struct userinfo *, const char *);
1679int text_to_credentials(struct credentials *, const char *);
1680int text_to_expandnode(struct expandnode *, const char *);
1681uint64_t text_to_evpid(const char *);
1682uint32_t text_to_msgid(const char *);
1683const char *sa_to_text(const struct sockaddr *);
1684const char *ss_to_text(const struct sockaddr_storage *);
1685const char *time_to_text(time_t);
1686const char *duration_to_text(time_t);
1687const char *rule_to_text(struct rule *);
1688const char *sockaddr_to_text(struct sockaddr *);
1689const char *mailaddr_to_text(const struct mailaddr *);
1690const char *expandnode_to_text(struct expandnode *);
1691
1692
1693/* util.c */
1694typedef struct arglist arglist;
1695struct arglist {
1696	char	**list;
1697	uint	  num;
1698	uint	  nalloc;
1699};
1700void addargs(arglist *, char *, ...)
1701	__attribute__((format(printf, 2, 3)));
1702int bsnprintf(char *, size_t, const char *, ...)
1703	__attribute__((format (printf, 3, 4)));
1704int safe_fclose(FILE *);
1705int hostname_match(const char *, const char *);
1706int mailaddr_match(const struct mailaddr *, const struct mailaddr *);
1707int valid_localpart(const char *);
1708int valid_domainpart(const char *);
1709int valid_domainname(const char *);
1710int valid_smtp_response(const char *);
1711int secure_file(int, char *, char *, uid_t, int);
1712int  lowercase(char *, const char *, size_t);
1713void xlowercase(char *, const char *, size_t);
1714int  uppercase(char *, const char *, size_t);
1715uint64_t generate_uid(void);
1716int availdesc(void);
1717int ckdir(const char *, mode_t, uid_t, gid_t, int);
1718int rmtree(char *, int);
1719int mvpurge(char *, char *);
1720int mktmpfile(void);
1721const char *parse_smtp_response(char *, size_t, char **, int *);
1722int xasprintf(char **, const char *, ...)
1723    __attribute__((__format__ (printf, 2, 3)));
1724void *xmalloc(size_t);
1725void *xcalloc(size_t, size_t);
1726char *xstrdup(const char *);
1727void *xmemdup(const void *, size_t);
1728char *strip(char *);
1729int io_xprint(struct io *, const char *);
1730int io_xprintf(struct io *, const char *, ...)
1731    __attribute__((__format__ (printf, 2, 3)));
1732void log_envelope(const struct envelope *, const char *, const char *,
1733    const char *);
1734int session_socket_error(int);
1735int getmailname(char *, size_t);
1736int base64_encode(unsigned char const *, size_t, char *, size_t);
1737int base64_decode(char const *, unsigned char *, size_t);
1738int base64_encode_rfc3548(unsigned char const *, size_t,
1739		      char *, size_t);
1740
1741void log_trace_verbose(int);
1742void log_trace(int, const char *, ...)
1743    __attribute__((format (printf, 2, 3)));
1744
1745/* waitq.c */
1746int  waitq_wait(void *, void (*)(void *, void *, void *), void *);
1747void waitq_run(void *, void *);
1748
1749
1750/* runq.c */
1751struct runq;
1752
1753int runq_init(struct runq **, void (*)(struct runq *, void *));
1754int runq_schedule(struct runq *, time_t, void *);
1755int runq_schedule_at(struct runq *, time_t, void *);
1756int runq_cancel(struct runq *, void *);
1757int runq_pending(struct runq *, void *, time_t *);
1758