smtpd.h revision 1.466
1/*	$OpenBSD: smtpd.h,v 1.466 2014/07/09 09:53:37 eric 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 "smtpd-defines.h"
26#include "smtpd-api.h"
27#include "ioev.h"
28#include "iobuf.h"
29
30#define CONF_FILE		 "/etc/mail/smtpd.conf"
31#define MAILNAME_FILE		 "/etc/mail/mailname"
32#define CA_FILE			 "/etc/ssl/cert.pem"
33
34#define PROC_COUNT		 7
35
36#define MAX_HOPS_COUNT		 100
37#define	DEFAULT_MAX_BODY_SIZE	(35*1024*1024)
38#define MAX_TAG_SIZE		 32
39#define	MAX_FILTER_NAME		 32
40#define	MAX_FILTER_ARGS		 255
41
42#define	EXPAND_BUFFER		 1024
43
44#define SMTPD_QUEUE_EXPIRY	 (4 * 24 * 60 * 60)
45#define SMTPD_SOCKET		 "/var/run/smtpd.sock"
46#ifndef SMTPD_NAME
47#define	SMTPD_NAME		 "OpenSMTPD"
48#endif
49#define	SMTPD_VERSION		 "5.4.3"
50#define SMTPD_SESSION_TIMEOUT	 300
51#define SMTPD_BACKLOG		 5
52
53#define	PATH_SMTPCTL		"/usr/sbin/smtpctl"
54
55#define PATH_OFFLINE		"/offline"
56#define PATH_PURGE		"/purge"
57#define PATH_TEMPORARY		"/temporary"
58
59#define	PATH_LIBEXEC		"/usr/libexec/smtpd"
60
61
62/*
63 * RFC 5322 defines these characters as valid, some of them are
64 * potentially dangerous and need to be escaped.
65 */
66#define	MAILADDR_ALLOWED       	"!#$%&'*/?^`{|}~+-=_"
67#define	MAILADDR_ESCAPE		"!#$%&'*/?^`{|}~"
68
69
70#define F_STARTTLS		0x01
71#define F_SMTPS			0x02
72#define	F_TLS_OPTIONAL		0x04
73#define F_SSL		       (F_STARTTLS | F_SMTPS)
74#define F_AUTH			0x08
75#define	F_BACKUP		0x10	/* XXX - MUST BE SYNC-ED WITH RELAY_BACKUP */
76#define	F_STARTTLS_REQUIRE	0x20
77#define	F_AUTH_REQUIRE		0x40
78#define	F_LMTP			0x80
79#define	F_MASK_SOURCE		0x100
80#define	F_TLS_VERIFY		0x200
81
82/* must match F_* for mta */
83#define RELAY_STARTTLS		0x01
84#define RELAY_SMTPS		0x02
85#define	RELAY_TLS_OPTIONAL     	0x04
86#define RELAY_SSL		(RELAY_STARTTLS | RELAY_SMTPS)
87#define RELAY_AUTH		0x08
88#define RELAY_BACKUP		0x10	/* XXX - MUST BE SYNC-ED WITH F_BACKUP */
89#define RELAY_MX		0x20
90#define RELAY_LMTP		0x80
91#define	RELAY_TLS_VERIFY	0x200
92
93#define MTA_EXT_DSN		0x400
94
95struct userinfo {
96	char username[SMTPD_MAXLOGNAME];
97	char directory[SMTPD_MAXPATHLEN];
98	uid_t uid;
99	gid_t gid;
100};
101
102struct netaddr {
103	struct sockaddr_storage ss;
104	int bits;
105};
106
107struct relayhost {
108	uint16_t flags;
109	char hostname[SMTPD_MAXHOSTNAMELEN];
110	uint16_t port;
111	char pki_name[SMTPD_MAXPATHLEN];
112	char authtable[SMTPD_MAXPATHLEN];
113	char authlabel[SMTPD_MAXPATHLEN];
114	char sourcetable[SMTPD_MAXPATHLEN];
115	char heloname[SMTPD_MAXHOSTNAMELEN];
116	char helotable[SMTPD_MAXPATHLEN];
117};
118
119struct credentials {
120	char username[SMTPD_MAXLINESIZE];
121	char password[SMTPD_MAXLINESIZE];
122};
123
124struct destination {
125	char	name[SMTPD_MAXHOSTNAMELEN];
126};
127
128struct source {
129	struct sockaddr_storage	addr;
130};
131
132struct addrname {
133	struct sockaddr_storage	addr;
134	char			name[SMTPD_MAXHOSTNAMELEN];
135};
136
137union lookup {
138	struct expand		*expand;
139	struct credentials	 creds;
140	struct netaddr		 netaddr;
141	struct source		 source;
142	struct destination	 domain;
143	struct userinfo		 userinfo;
144	struct mailaddr		 mailaddr;
145	struct addrname		 addrname;
146};
147
148/*
149 * Bump IMSG_VERSION whenever a change is made to enum imsg_type.
150 * This will ensure that we can never use a wrong version of smtpctl with smtpd.
151 */
152#define	IMSG_VERSION		10
153
154enum imsg_type {
155	IMSG_NONE,
156
157	IMSG_CTL_OK,
158	IMSG_CTL_FAIL,
159
160	IMSG_CTL_GET_DIGEST,
161	IMSG_CTL_GET_STATS,
162	IMSG_CTL_LIST_MESSAGES,
163	IMSG_CTL_LIST_ENVELOPES,
164	IMSG_CTL_MTA_SHOW_HOSTS,
165	IMSG_CTL_MTA_SHOW_RELAYS,
166	IMSG_CTL_MTA_SHOW_ROUTES,
167	IMSG_CTL_MTA_SHOW_HOSTSTATS,
168	IMSG_CTL_MTA_BLOCK,
169	IMSG_CTL_MTA_UNBLOCK,
170	IMSG_CTL_MTA_SHOW_BLOCK,
171	IMSG_CTL_PAUSE_EVP,
172	IMSG_CTL_PAUSE_MDA,
173	IMSG_CTL_PAUSE_MTA,
174	IMSG_CTL_PAUSE_SMTP,
175	IMSG_CTL_PROFILE,
176	IMSG_CTL_PROFILE_DISABLE,
177	IMSG_CTL_PROFILE_ENABLE,
178	IMSG_CTL_RESUME_EVP,
179	IMSG_CTL_RESUME_MDA,
180	IMSG_CTL_RESUME_MTA,
181	IMSG_CTL_RESUME_SMTP,
182	IMSG_CTL_RESUME_ROUTE,
183	IMSG_CTL_REMOVE,
184	IMSG_CTL_SCHEDULE,
185	IMSG_CTL_SHOW_STATUS,
186	IMSG_CTL_SHUTDOWN,
187	IMSG_CTL_TRACE_DISABLE,
188	IMSG_CTL_TRACE_ENABLE,
189	IMSG_CTL_UPDATE_TABLE,
190	IMSG_CTL_VERBOSE,
191
192	IMSG_CTL_SMTP_SESSION,
193
194	IMSG_CONF_START,
195	IMSG_CONF_END,
196
197	IMSG_STAT_INCREMENT,
198	IMSG_STAT_DECREMENT,
199	IMSG_STAT_SET,
200
201	IMSG_LKA_AUTHENTICATE,
202	IMSG_LKA_OPEN_FORWARD,
203	IMSG_LKA_ENVELOPE_SUBMIT,
204	IMSG_LKA_ENVELOPE_COMMIT,
205
206	IMSG_QUEUE_DELIVER,
207	IMSG_QUEUE_DELIVERY_OK,
208	IMSG_QUEUE_DELIVERY_TEMPFAIL,
209	IMSG_QUEUE_DELIVERY_PERMFAIL,
210	IMSG_QUEUE_DELIVERY_LOOP,
211	IMSG_QUEUE_ENVELOPE_COMMIT,
212	IMSG_QUEUE_ENVELOPE_REMOVE,
213	IMSG_QUEUE_ENVELOPE_SCHEDULE,
214	IMSG_QUEUE_ENVELOPE_SUBMIT,
215	IMSG_QUEUE_HOLDQ_HOLD,
216	IMSG_QUEUE_HOLDQ_RELEASE,
217	IMSG_QUEUE_MESSAGE_COMMIT,
218	IMSG_QUEUE_MESSAGE_ROLLBACK,
219	IMSG_QUEUE_SMTP_SESSION,
220	IMSG_QUEUE_TRANSFER,
221
222	IMSG_MDA_DELIVERY_OK,
223	IMSG_MDA_DELIVERY_TEMPFAIL,
224	IMSG_MDA_DELIVERY_PERMFAIL,
225	IMSG_MDA_DELIVERY_LOOP,
226	IMSG_MDA_DELIVERY_HOLD,
227	IMSG_MDA_DONE,
228	IMSG_MDA_FORK,
229	IMSG_MDA_HOLDQ_RELEASE,
230	IMSG_MDA_LOOKUP_USERINFO,
231	IMSG_MDA_KILL,
232	IMSG_MDA_OPEN_MESSAGE,
233
234	IMSG_MFA_SMTP_RESPONSE,
235
236	IMSG_MTA_DELIVERY_OK,
237	IMSG_MTA_DELIVERY_TEMPFAIL,
238	IMSG_MTA_DELIVERY_PERMFAIL,
239	IMSG_MTA_DELIVERY_LOOP,
240	IMSG_MTA_DELIVERY_HOLD,
241	IMSG_MTA_DNS_HOST,
242	IMSG_MTA_DNS_HOST_END,
243	IMSG_MTA_DNS_PTR,
244	IMSG_MTA_DNS_MX,
245	IMSG_MTA_DNS_MX_PREFERENCE,
246	IMSG_MTA_HOLDQ_RELEASE,
247	IMSG_MTA_LOOKUP_CREDENTIALS,
248	IMSG_MTA_LOOKUP_SOURCE,
249	IMSG_MTA_LOOKUP_HELO,
250	IMSG_MTA_OPEN_MESSAGE,
251	IMSG_MTA_SCHEDULE,
252	IMSG_MTA_SSL_INIT,
253	IMSG_MTA_SSL_VERIFY_CERT,
254	IMSG_MTA_SSL_VERIFY_CHAIN,
255	IMSG_MTA_SSL_VERIFY,
256
257	IMSG_SCHED_ENVELOPE_BOUNCE,
258	IMSG_SCHED_ENVELOPE_DELIVER,
259	IMSG_SCHED_ENVELOPE_EXPIRE,
260	IMSG_SCHED_ENVELOPE_INJECT,
261	IMSG_SCHED_ENVELOPE_REMOVE,
262	IMSG_SCHED_ENVELOPE_TRANSFER,
263
264	IMSG_SMTP_AUTHENTICATE,
265	IMSG_SMTP_DNS_PTR,
266	IMSG_SMTP_MESSAGE_COMMIT,
267	IMSG_SMTP_MESSAGE_CREATE,
268	IMSG_SMTP_MESSAGE_ROLLBACK,
269	IMSG_SMTP_MESSAGE_OPEN,
270	IMSG_SMTP_EXPAND_RCPT,
271	IMSG_SMTP_LOOKUP_HELO,
272	IMSG_SMTP_SSL_INIT,
273	IMSG_SMTP_SSL_VERIFY_CERT,
274	IMSG_SMTP_SSL_VERIFY_CHAIN,
275	IMSG_SMTP_SSL_VERIFY,
276
277	IMSG_SMTP_REQ_CONNECT,
278	IMSG_SMTP_REQ_HELO,
279	IMSG_SMTP_REQ_MAIL,
280	IMSG_SMTP_REQ_RCPT,
281	IMSG_SMTP_REQ_DATA,
282	IMSG_SMTP_REQ_EOM,
283	IMSG_SMTP_EVENT_RSET,
284	IMSG_SMTP_EVENT_COMMIT,
285	IMSG_SMTP_EVENT_ROLLBACK,
286	IMSG_SMTP_EVENT_DISCONNECT,
287
288	IMSG_CA_PRIVENC,
289	IMSG_CA_PRIVDEC
290};
291
292enum blockmodes {
293	BM_NORMAL,
294	BM_NONBLOCK
295};
296
297enum smtp_proc_type {
298	PROC_PARENT = 0,
299	PROC_LKA,
300	PROC_QUEUE,
301	PROC_CONTROL,
302	PROC_SCHEDULER,
303	PROC_PONY,
304	PROC_CA,
305
306	PROC_FILTER,
307	PROC_CLIENT,
308};
309
310enum table_type {
311	T_NONE		= 0,
312	T_DYNAMIC	= 0x01,	/* table with external source	*/
313	T_LIST		= 0x02,	/* table holding a list		*/
314	T_HASH		= 0x04,	/* table holding a hash table	*/
315};
316
317struct table {
318	char				 t_name[SMTPD_MAXLINESIZE];
319	enum table_type			 t_type;
320	char				 t_config[SMTPD_MAXPATHLEN];
321
322	struct dict			 t_dict;
323
324	void				*t_handle;
325	struct table_backend		*t_backend;
326	void				*t_iter;
327};
328
329struct table_backend {
330	const unsigned int	services;
331	int	(*config)(struct table *);
332	void   *(*open)(struct table *);
333	int	(*update)(struct table *);
334	void	(*close)(void *);
335	int	(*lookup)(void *, struct dict *, const char *, enum table_service, union lookup *);
336	int	(*fetch)(void *, struct dict *, enum table_service, union lookup *);
337};
338
339
340enum dest_type {
341	DEST_DOM,
342	DEST_VDOM
343};
344
345enum action_type {
346	A_NONE,
347	A_RELAY,
348	A_RELAYVIA,
349	A_MAILDIR,
350	A_MBOX,
351	A_FILENAME,
352	A_MDA,
353	A_LMTP
354};
355
356enum decision {
357	R_REJECT,
358	R_ACCEPT
359};
360
361struct rule {
362	TAILQ_ENTRY(rule)		r_entry;
363	enum decision			r_decision;
364	uint8_t				r_nottag;
365	char				r_tag[MAX_TAG_SIZE];
366
367	uint8_t				r_notsources;
368	struct table		       *r_sources;
369
370	uint8_t				r_notsenders;
371	struct table		       *r_senders;
372
373	uint8_t				r_notrecipients;
374	struct table		       *r_recipients;
375
376	uint8_t				r_notdestination;
377	enum dest_type			r_desttype;
378	struct table		       *r_destination;
379
380	enum action_type		r_action;
381	union rule_dest {
382		char			buffer[EXPAND_BUFFER];
383		struct relayhost	relayhost;
384	}				r_value;
385
386	struct mailaddr		       *r_as;
387	struct table		       *r_mapping;
388	struct table		       *r_userbase;
389	time_t				r_qexpire;
390	uint8_t				r_forwardonly;
391};
392
393struct delivery_mda {
394	enum action_type	method;
395	char			usertable[SMTPD_MAXPATHLEN];
396	char			username[SMTPD_MAXLOGNAME];
397	char			buffer[EXPAND_BUFFER];
398};
399
400struct delivery_mta {
401	struct relayhost	relay;
402};
403
404enum bounce_type {
405	B_ERROR,
406	B_WARNING,
407	B_DSN
408};
409
410enum dsn_ret {
411	DSN_RETFULL = 1,
412	DSN_RETHDRS
413};
414
415struct delivery_bounce {
416	enum bounce_type	type;
417	time_t			delay;
418	time_t			expire;
419	enum dsn_ret		dsn_ret;
420        int			mta_without_dsn;
421};
422
423enum expand_type {
424	EXPAND_INVALID,
425	EXPAND_USERNAME,
426	EXPAND_FILENAME,
427	EXPAND_FILTER,
428	EXPAND_INCLUDE,
429	EXPAND_ADDRESS,
430	EXPAND_ERROR
431};
432
433struct expandnode {
434	RB_ENTRY(expandnode)	entry;
435	TAILQ_ENTRY(expandnode)	tq_entry;
436	enum expand_type	type;
437	int			sameuser;
438	int			alias;
439	struct rule	       *rule;
440	struct expandnode      *parent;
441	unsigned int		depth;
442	struct table   	       *mapping;
443	struct table   	       *userbase;
444	union {
445		/*
446		 * user field handles both expansion user and system user
447		 * so we MUST make it large enough to fit a mailaddr user
448		 */
449		char		user[SMTPD_MAXLOCALPARTSIZE];
450		char		buffer[EXPAND_BUFFER];
451		struct mailaddr	mailaddr;
452	}			u;
453};
454
455struct expand {
456	RB_HEAD(expandtree, expandnode)	 tree;
457	TAILQ_HEAD(xnodes, expandnode)	*queue;
458	int				 alias;
459	size_t				 nb_nodes;
460	struct rule			*rule;
461	struct expandnode		*parent;
462};
463
464#define DSN_SUCCESS 0x01
465#define DSN_FAILURE 0x02
466#define DSN_DELAY   0x04
467#define DSN_NEVER   0x08
468
469#define	DSN_ENVID_LEN	100
470
471#define	SMTPD_ENVELOPE_VERSION		2
472struct envelope {
473	TAILQ_ENTRY(envelope)		entry;
474
475	char				tag[MAX_TAG_SIZE];
476
477	uint32_t			version;
478	uint64_t			id;
479	enum envelope_flags		flags;
480
481	char				smtpname[SMTPD_MAXHOSTNAMELEN];
482	char				helo[SMTPD_MAXHOSTNAMELEN];
483	char				hostname[SMTPD_MAXHOSTNAMELEN];
484	char				errorline[SMTPD_MAXLINESIZE];
485	struct sockaddr_storage		ss;
486
487	struct mailaddr			sender;
488	struct mailaddr			rcpt;
489	struct mailaddr			dest;
490
491	enum delivery_type		type;
492	union {
493		struct delivery_mda	mda;
494		struct delivery_mta	mta;
495		struct delivery_bounce	bounce;
496	}				agent;
497
498	uint16_t			retry;
499	time_t				creation;
500	time_t				expire;
501	time_t				lasttry;
502	time_t				nexttry;
503	time_t				lastbounce;
504
505	struct mailaddr			dsn_orcpt;
506	char				dsn_envid[DSN_ENVID_LEN+1];
507	uint8_t				dsn_notify;
508	enum dsn_ret			dsn_ret;
509
510	uint8_t				esc_class;
511	uint8_t				esc_code;
512};
513
514struct listener {
515	uint16_t       		 flags;
516	int			 fd;
517	struct sockaddr_storage	 ss;
518	in_port_t		 port;
519	struct timeval		 timeout;
520	struct event		 ev;
521	char			 pki_name[SMTPD_MAXPATHLEN];
522	char			 tag[MAX_TAG_SIZE];
523	char			 filter[SMTPD_MAXPATHLEN];
524	char			 authtable[SMTPD_MAXLINESIZE];
525	char			 hostname[SMTPD_MAXHOSTNAMELEN];
526	char			 hostnametable[SMTPD_MAXPATHLEN];
527	TAILQ_ENTRY(listener)	 entry;
528};
529
530struct smtpd {
531	char				sc_conffile[SMTPD_MAXPATHLEN];
532	size_t				sc_maxsize;
533
534#define SMTPD_OPT_VERBOSE		0x00000001
535#define SMTPD_OPT_NOACTION		0x00000002
536	uint32_t			sc_opts;
537
538#define SMTPD_EXITING			0x00000001
539#define SMTPD_MDA_PAUSED		0x00000002
540#define SMTPD_MTA_PAUSED		0x00000004
541#define SMTPD_SMTP_PAUSED		0x00000008
542#define SMTPD_MDA_BUSY			0x00000010
543#define SMTPD_MTA_BUSY			0x00000020
544#define SMTPD_BOUNCE_BUSY		0x00000040
545#define SMTPD_SMTP_DISABLED		0x00000080
546	uint32_t			sc_flags;
547
548#define QUEUE_COMPRESSION      		0x00000001
549#define QUEUE_ENCRYPTION      		0x00000002
550#define QUEUE_EVPCACHE			0x00000004
551	uint32_t			sc_queue_flags;
552	char			       *sc_queue_key;
553	size_t				sc_queue_evpcache_size;
554
555	size_t				sc_mda_max_session;
556	size_t				sc_mda_max_user_session;
557	size_t				sc_mda_task_hiwat;
558	size_t				sc_mda_task_lowat;
559	size_t				sc_mda_task_release;
560
561	size_t				sc_mta_max_deferred;
562
563	size_t				sc_scheduler_max_inflight;
564	size_t				sc_scheduler_max_evp_batch_size;
565	size_t				sc_scheduler_max_msg_batch_size;
566	size_t				sc_scheduler_max_schedule;
567
568	int				sc_qexpire;
569#define MAX_BOUNCE_WARN			4
570	time_t				sc_bounce_warn[MAX_BOUNCE_WARN];
571	char				sc_hostname[SMTPD_MAXHOSTNAMELEN];
572	struct stat_backend	       *sc_stat;
573	struct compress_backend	       *sc_comp;
574
575	time_t					 sc_uptime;
576
577	TAILQ_HEAD(listenerlist, listener)	*sc_listeners;
578
579	TAILQ_HEAD(rulelist, rule)		*sc_rules;
580
581	struct dict			       *sc_pki_dict;
582	struct dict			       *sc_ssl_dict;
583
584	struct dict			       *sc_tables_dict;		/* keyed lookup	*/
585
586	struct dict			       *sc_limits_dict;
587
588	struct dict				sc_filters;
589	uint32_t				filtermask;
590};
591
592#define	TRACE_DEBUG	0x0001
593#define	TRACE_IMSG	0x0002
594#define	TRACE_IO	0x0004
595#define	TRACE_SMTP	0x0008
596#define	TRACE_FILTERS	0x0010
597#define	TRACE_MTA	0x0020
598#define	TRACE_BOUNCE	0x0040
599#define	TRACE_SCHEDULER	0x0080
600#define	TRACE_LOOKUP	0x0100
601#define	TRACE_STAT	0x0200
602#define	TRACE_RULES	0x0400
603#define	TRACE_MPROC	0x0800
604#define	TRACE_EXPAND	0x1000
605#define	TRACE_TABLES	0x2000
606#define	TRACE_QUEUE	0x4000
607
608#define PROFILE_TOSTAT	0x0001
609#define PROFILE_IMSG	0x0002
610#define PROFILE_QUEUE	0x0004
611#define PROFILE_BUFFERS	0x0008
612
613struct forward_req {
614	uint64_t			id;
615	uint8_t				status;
616
617	char				user[SMTPD_MAXLOGNAME];
618	uid_t				uid;
619	gid_t				gid;
620	char				directory[SMTPD_MAXPATHLEN];
621};
622
623struct deliver {
624	char			to[SMTPD_MAXPATHLEN];
625	char			from[SMTPD_MAXPATHLEN];
626	char			dest[SMTPD_MAXLINESIZE];
627	char			user[SMTPD_MAXLOGNAME];
628	short			mode;
629
630	struct userinfo		userinfo;
631};
632
633#define MAX_FILTER_PER_CHAIN	16
634struct filter_conf {
635	int		 chain;
636	int		 done;
637	int		 argc;
638	char		*name;
639	char		*argv[MAX_FILTER_ARGS + 1];
640	char		*path;
641};
642
643struct mta_host {
644	SPLAY_ENTRY(mta_host)	 entry;
645	struct sockaddr		*sa;
646	char			*ptrname;
647	int			 refcount;
648	size_t			 nconn;
649	time_t			 lastconn;
650	time_t			 lastptrquery;
651
652#define HOST_IGNORE	0x01
653	int			 flags;
654};
655
656struct mta_mx {
657	TAILQ_ENTRY(mta_mx)	 entry;
658	struct mta_host		*host;
659	int			 preference;
660};
661
662struct mta_domain {
663	SPLAY_ENTRY(mta_domain)	 entry;
664	char			*name;
665	int			 flags;
666	TAILQ_HEAD(, mta_mx)	 mxs;
667	int			 mxstatus;
668	int			 refcount;
669	size_t			 nconn;
670	time_t			 lastconn;
671	time_t			 lastmxquery;
672};
673
674struct mta_source {
675	SPLAY_ENTRY(mta_source)	 entry;
676	struct sockaddr		*sa;
677	int			 refcount;
678	size_t			 nconn;
679	time_t			 lastconn;
680};
681
682struct mta_connector {
683	struct mta_source		*source;
684	struct mta_relay		*relay;
685
686#define CONNECTOR_ERROR_FAMILY		0x0001
687#define CONNECTOR_ERROR_SOURCE		0x0002
688#define CONNECTOR_ERROR_MX		0x0004
689#define CONNECTOR_ERROR_ROUTE_NET	0x0008
690#define CONNECTOR_ERROR_ROUTE_SMTP	0x0010
691#define CONNECTOR_ERROR_ROUTE		0x0018
692#define CONNECTOR_ERROR_BLOCKED		0x0020
693#define CONNECTOR_ERROR			0x00ff
694
695#define CONNECTOR_LIMIT_HOST		0x0100
696#define CONNECTOR_LIMIT_ROUTE		0x0200
697#define CONNECTOR_LIMIT_SOURCE		0x0400
698#define CONNECTOR_LIMIT_RELAY		0x0800
699#define CONNECTOR_LIMIT_CONN		0x1000
700#define CONNECTOR_LIMIT_DOMAIN		0x2000
701#define CONNECTOR_LIMIT			0xff00
702
703#define CONNECTOR_NEW			0x10000
704#define CONNECTOR_WAIT			0x20000
705	int				 flags;
706
707	int				 refcount;
708	size_t				 nconn;
709	time_t				 lastconn;
710};
711
712struct mta_route {
713	SPLAY_ENTRY(mta_route)	 entry;
714	uint64_t		 id;
715	struct mta_source	*src;
716	struct mta_host		*dst;
717#define ROUTE_NEW		0x01
718#define ROUTE_RUNQ		0x02
719#define ROUTE_KEEPALIVE		0x04
720#define ROUTE_DISABLED		0xf0
721#define ROUTE_DISABLED_NET	0x10
722#define ROUTE_DISABLED_SMTP	0x20
723	int			 flags;
724	int			 nerror;
725	int			 penalty;
726	int			 refcount;
727	size_t			 nconn;
728	time_t			 lastconn;
729	time_t			 lastdisc;
730	time_t			 lastpenalty;
731};
732
733struct mta_limits {
734	size_t	maxconn_per_host;
735	size_t	maxconn_per_route;
736	size_t	maxconn_per_source;
737	size_t	maxconn_per_connector;
738	size_t	maxconn_per_relay;
739	size_t	maxconn_per_domain;
740
741	time_t	conndelay_host;
742	time_t	conndelay_route;
743	time_t	conndelay_source;
744	time_t	conndelay_connector;
745	time_t	conndelay_relay;
746	time_t	conndelay_domain;
747
748	time_t	discdelay_route;
749
750	size_t	max_mail_per_session;
751	time_t	sessdelay_transaction;
752	time_t	sessdelay_keepalive;
753
754	size_t	max_failures_per_session;
755
756	int	family;
757
758	int	task_hiwat;
759	int	task_lowat;
760	int	task_release;
761};
762
763struct mta_relay {
764	SPLAY_ENTRY(mta_relay)	 entry;
765	uint64_t		 id;
766
767	struct mta_domain	*domain;
768	struct mta_limits	*limits;
769	int			 flags;
770	char			*backupname;
771	int			 backuppref;
772	char			*sourcetable;
773	uint16_t		 port;
774	char			*pki_name;
775	char			*authtable;
776	char			*authlabel;
777	char			*helotable;
778	char			*heloname;
779	char			*secret;
780
781	int			 state;
782	size_t			 ntask;
783	TAILQ_HEAD(, mta_task)	 tasks;
784
785	struct tree		 connectors;
786	size_t			 sourceloop;
787	time_t			 lastsource;
788	time_t			 nextsource;
789
790	int			 fail;
791	char			*failstr;
792
793#define RELAY_WAIT_MX		0x01
794#define RELAY_WAIT_PREFERENCE	0x02
795#define RELAY_WAIT_SECRET	0x04
796#define RELAY_WAIT_LIMITS	0x08
797#define RELAY_WAIT_SOURCE	0x10
798#define RELAY_WAIT_CONNECTOR	0x20
799#define RELAY_WAITMASK		0x3f
800	int			 status;
801
802	int			 refcount;
803	size_t			 nconn;
804	size_t			 nconn_ready;
805	time_t			 lastconn;
806};
807
808struct mta_envelope {
809	TAILQ_ENTRY(mta_envelope)	 entry;
810	uint64_t			 id;
811	uint64_t			 session;
812	time_t				 creation;
813	char				*dest;
814	char				*rcpt;
815	struct mta_task			*task;
816	int				 delivery;
817
818	int				 ext;
819	char				*dsn_orcpt;
820	char				dsn_envid[DSN_ENVID_LEN+1];
821	uint8_t				dsn_notify;
822	enum dsn_ret			dsn_ret;
823
824	char				 status[SMTPD_MAXLINESIZE];
825};
826
827struct mta_task {
828	TAILQ_ENTRY(mta_task)		 entry;
829	struct mta_relay		*relay;
830	uint32_t			 msgid;
831	TAILQ_HEAD(, mta_envelope)	 envelopes;
832	char				*sender;
833};
834
835struct passwd;
836
837struct queue_backend {
838	int	(*init)(struct passwd *, int, const char *);
839};
840
841struct compress_backend {
842	size_t	(*compress_chunk)(void *, size_t, void *, size_t);
843	size_t	(*uncompress_chunk)(void *, size_t, void *, size_t);
844	int	(*compress_file)(FILE *, FILE *);
845	int	(*uncompress_file)(FILE *, FILE *);
846};
847
848/* auth structures */
849enum auth_type {
850	AUTH_BSD,
851	AUTH_PWD,
852};
853
854struct auth_backend {
855	int	(*authenticate)(char *, char *);
856};
857
858
859/* delivery_backend */
860struct delivery_backend {
861	int	allow_root;
862	void	(*open)(struct deliver *);
863};
864
865struct scheduler_backend {
866	int	(*init)(void);
867
868	int	(*insert)(struct scheduler_info *);
869	size_t	(*commit)(uint32_t);
870	size_t	(*rollback)(uint32_t);
871
872	int	(*update)(struct scheduler_info *);
873	int	(*delete)(uint64_t);
874	int	(*hold)(uint64_t, uint64_t);
875	int	(*release)(int, uint64_t, int);
876
877	int	(*batch)(int, struct scheduler_batch *);
878
879	size_t	(*messages)(uint32_t, uint32_t *, size_t);
880	size_t	(*envelopes)(uint64_t, struct evpstate *, size_t);
881	int	(*schedule)(uint64_t);
882	int	(*remove)(uint64_t);
883	int	(*suspend)(uint64_t);
884	int	(*resume)(uint64_t);
885};
886
887enum stat_type {
888	STAT_COUNTER,
889	STAT_TIMESTAMP,
890	STAT_TIMEVAL,
891	STAT_TIMESPEC,
892};
893
894struct stat_value {
895	enum stat_type	type;
896	union stat_v {
897		size_t		counter;
898		time_t		timestamp;
899		struct timeval	tv;
900		struct timespec	ts;
901	} u;
902};
903
904#define	STAT_KEY_SIZE	1024
905struct stat_kv {
906	void	*iter;
907	char	key[STAT_KEY_SIZE];
908	struct stat_value	val;
909};
910
911struct stat_backend {
912	void	(*init)(void);
913	void	(*close)(void);
914	void	(*increment)(const char *, size_t);
915	void	(*decrement)(const char *, size_t);
916	void	(*set)(const char *, const struct stat_value *);
917	int	(*iter)(void **, char **, struct stat_value *);
918};
919
920struct stat_digest {
921	time_t			 startup;
922	time_t			 timestamp;
923
924	size_t			 clt_connect;
925	size_t			 clt_disconnect;
926
927	size_t			 evp_enqueued;
928	size_t			 evp_dequeued;
929
930	size_t			 evp_expired;
931	size_t			 evp_removed;
932	size_t			 evp_bounce;
933
934	size_t			 dlv_ok;
935	size_t			 dlv_permfail;
936	size_t			 dlv_tempfail;
937	size_t			 dlv_loop;
938};
939
940
941struct mproc {
942	pid_t		 pid;
943	char		*name;
944	int		 proc;
945	void		(*handler)(struct mproc *, struct imsg *);
946	struct imsgbuf	 imsgbuf;
947
948	char		*m_buf;
949	size_t		 m_alloc;
950	size_t		 m_pos;
951	uint32_t	 m_type;
952	uint32_t	 m_peerid;
953	pid_t		 m_pid;
954	int		 m_fd;
955
956	int		 enable;
957	short		 events;
958	struct event	 ev;
959	void		*data;
960
961	off_t		 msg_in;
962	off_t		 msg_out;
963	off_t		 bytes_in;
964	off_t		 bytes_out;
965	size_t		 bytes_queued;
966	size_t		 bytes_queued_max;
967};
968
969struct msg {
970	const uint8_t	*pos;
971	const uint8_t	*end;
972};
973
974extern enum smtp_proc_type	smtpd_process;
975
976extern int verbose;
977extern int profiling;
978
979extern struct mproc *p_control;
980extern struct mproc *p_parent;
981extern struct mproc *p_lka;
982extern struct mproc *p_queue;
983extern struct mproc *p_scheduler;
984extern struct mproc *p_pony;
985extern struct mproc *p_ca;
986
987extern struct smtpd	*env;
988extern void (*imsg_callback)(struct mproc *, struct imsg *);
989
990struct imsgproc {
991	pid_t			pid;
992	struct event		ev;
993	struct imsgbuf	       *ibuf;
994	char		       *path;
995	char		       *name;
996	void		      (*cb)(struct imsg *, void *);
997	void		       *cb_arg;
998};
999
1000/* inter-process structures */
1001
1002struct bounce_req_msg {
1003	uint64_t		evpid;
1004	time_t			timestamp;
1005	struct delivery_bounce	bounce;
1006};
1007
1008enum dns_error {
1009	DNS_OK = 0,
1010	DNS_RETRY,
1011	DNS_EINVAL,
1012	DNS_ENONAME,
1013	DNS_ENOTFOUND,
1014};
1015
1016enum lka_resp_status {
1017	LKA_OK,
1018	LKA_TEMPFAIL,
1019	LKA_PERMFAIL
1020};
1021
1022enum ca_resp_status {
1023	CA_OK,
1024	CA_FAIL
1025};
1026
1027struct ca_cert_req_msg {
1028	uint64_t		reqid;
1029	char			name[SMTPD_MAXHOSTNAMELEN];
1030};
1031
1032struct ca_cert_resp_msg {
1033	uint64_t		reqid;
1034	enum ca_resp_status	status;
1035	char		       *cert;
1036	off_t			cert_len;
1037};
1038
1039struct ca_vrfy_req_msg {
1040	uint64_t		reqid;
1041	char			pkiname[SMTPD_MAXHOSTNAMELEN];
1042	unsigned char  	       *cert;
1043	off_t			cert_len;
1044	size_t			n_chain;
1045	size_t			chain_offset;
1046	unsigned char	      **chain_cert;
1047	off_t		       *chain_cert_len;
1048};
1049
1050struct ca_vrfy_resp_msg {
1051	uint64_t		reqid;
1052	enum ca_resp_status	status;
1053};
1054
1055
1056/* aliases.c */
1057int aliases_get(struct expand *, const char *);
1058int aliases_virtual_check(struct table *, const struct mailaddr *);
1059int aliases_virtual_get(struct expand *, const struct mailaddr *);
1060int alias_parse(struct expandnode *, const char *);
1061
1062
1063/* auth.c */
1064struct auth_backend *auth_backend_lookup(enum auth_type);
1065
1066
1067/* bounce.c */
1068void bounce_add(uint64_t);
1069void bounce_fd(int);
1070
1071
1072/* ca.c */
1073pid_t	 ca(void);
1074int	 ca_X509_verify(void *, void *, const char *, const char *, const char **);
1075void	 ca_imsg(struct mproc *, struct imsg *);
1076void	 ca_init(void);
1077void	 ca_engine_init(void);
1078
1079/* compress_backend.c */
1080struct compress_backend *compress_backend_lookup(const char *);
1081size_t	compress_chunk(void *, size_t, void *, size_t);
1082size_t	uncompress_chunk(void *, size_t, void *, size_t);
1083int	compress_file(FILE *, FILE *);
1084int	uncompress_file(FILE *, FILE *);
1085
1086/* config.c */
1087#define PURGE_LISTENERS		0x01
1088#define PURGE_TABLES		0x02
1089#define PURGE_RULES		0x04
1090#define PURGE_PKI		0x08
1091#define PURGE_PKI_KEYS		0x10
1092#define PURGE_EVERYTHING	0x0f
1093void purge_config(uint8_t);
1094void init_pipes(void);
1095void config_process(enum smtp_proc_type);
1096void config_peer(enum smtp_proc_type);
1097void config_done(void);
1098
1099
1100/* control.c */
1101pid_t control(void);
1102int control_create_socket(void);
1103
1104
1105/* crypto.c */
1106int	crypto_setup(const char *, size_t);
1107int	crypto_encrypt_file(FILE *, FILE *);
1108int	crypto_decrypt_file(FILE *, FILE *);
1109size_t	crypto_encrypt_buffer(const char *, size_t, char *, size_t);
1110size_t	crypto_decrypt_buffer(const char *, size_t, char *, size_t);
1111
1112
1113/* delivery.c */
1114struct delivery_backend *delivery_backend_lookup(enum action_type);
1115
1116
1117/* dns.c */
1118void dns_imsg(struct mproc *, struct imsg *);
1119
1120
1121/* enqueue.c */
1122int		 enqueue(int, char **);
1123
1124
1125/* envelope.c */
1126void envelope_set_errormsg(struct envelope *, char *, ...);
1127void envelope_set_esc_class(struct envelope *, enum enhanced_status_class);
1128void envelope_set_esc_code(struct envelope *, enum enhanced_status_code);
1129int envelope_load_buffer(struct envelope *, const char *, size_t);
1130int envelope_dump_buffer(const struct envelope *, char *, size_t);
1131
1132
1133/* expand.c */
1134int expand_cmp(struct expandnode *, struct expandnode *);
1135void expand_insert(struct expand *, struct expandnode *);
1136struct expandnode *expand_lookup(struct expand *, struct expandnode *);
1137void expand_clear(struct expand *);
1138void expand_free(struct expand *);
1139int expand_line(struct expand *, const char *, int);
1140int expand_to_text(struct expand *, char *, size_t);
1141RB_PROTOTYPE(expandtree, expandnode, nodes, expand_cmp);
1142
1143
1144/* forward.c */
1145int forwards_get(int, struct expand *);
1146
1147
1148/* imsgproc.c */
1149void imsgproc_init(void);
1150struct imsgproc *imsgproc_fork(const char *, const char *,
1151    void (*)(struct imsg *, void *), void *);
1152void imsgproc_set_read(struct imsgproc *);
1153void imsgproc_set_write(struct imsgproc *);
1154void imsgproc_set_read_write(struct imsgproc *);
1155void imsgproc_reset_callback(struct imsgproc *, void (*)(struct imsg *, void *), void *);
1156
1157/* limit.c */
1158void limit_mta_set_defaults(struct mta_limits *);
1159int limit_mta_set(struct mta_limits *, const char*, int64_t);
1160
1161/* lka.c */
1162pid_t lka(void);
1163
1164
1165/* lka_session.c */
1166void lka_session(uint64_t, struct envelope *);
1167void lka_session_forward_reply(struct forward_req *, int);
1168
1169
1170/* log.c */
1171void vlog(int, const char *, va_list);
1172
1173
1174/* mda.c */
1175void mda_postfork(void);
1176void mda_postprivdrop(void);
1177void mda_imsg(struct mproc *, struct imsg *);
1178
1179
1180/* mproc.c */
1181int mproc_fork(struct mproc *, const char*, char **);
1182void mproc_init(struct mproc *, int);
1183void mproc_clear(struct mproc *);
1184void mproc_enable(struct mproc *);
1185void mproc_disable(struct mproc *);
1186void mproc_event_add(struct mproc *);
1187void m_compose(struct mproc *, uint32_t, uint32_t, pid_t, int, void *, size_t);
1188void m_composev(struct mproc *, uint32_t, uint32_t, pid_t, int,
1189    const struct iovec *, int);
1190void m_forward(struct mproc *, struct imsg *);
1191void m_create(struct mproc *, uint32_t, uint32_t, pid_t, int);
1192void m_add(struct mproc *, const void *, size_t);
1193void m_add_int(struct mproc *, int);
1194void m_add_u32(struct mproc *, uint32_t);
1195void m_add_size(struct mproc *, size_t);
1196void m_add_time(struct mproc *, time_t);
1197void m_add_string(struct mproc *, const char *);
1198void m_add_data(struct mproc *, const void *, size_t);
1199void m_add_evpid(struct mproc *, uint64_t);
1200void m_add_msgid(struct mproc *, uint32_t);
1201void m_add_id(struct mproc *, uint64_t);
1202void m_add_sockaddr(struct mproc *, const struct sockaddr *);
1203void m_add_mailaddr(struct mproc *, const struct mailaddr *);
1204void m_add_envelope(struct mproc *, const struct envelope *);
1205void m_add_params(struct mproc *, struct dict *);
1206void m_close(struct mproc *);
1207void m_flush(struct mproc *);
1208
1209void m_msg(struct msg *, struct imsg *);
1210int  m_is_eom(struct msg *);
1211void m_end(struct msg *);
1212void m_get_int(struct msg *, int *);
1213void m_get_size(struct msg *, size_t *);
1214void m_get_u32(struct msg *, uint32_t *);
1215void m_get_time(struct msg *, time_t *);
1216void m_get_string(struct msg *, const char **);
1217void m_get_data(struct msg *, const void **, size_t *);
1218void m_get_evpid(struct msg *, uint64_t *);
1219void m_get_msgid(struct msg *, uint32_t *);
1220void m_get_id(struct msg *, uint64_t *);
1221void m_get_sockaddr(struct msg *, struct sockaddr *);
1222void m_get_mailaddr(struct msg *, struct mailaddr *);
1223void m_get_envelope(struct msg *, struct envelope *);
1224void m_get_params(struct msg *, struct dict *);
1225void m_clear_params(struct dict *);
1226
1227
1228/* mta.c */
1229void mta_postfork(void);
1230void mta_postprivdrop(void);
1231void mta_imsg(struct mproc *, struct imsg *);
1232void mta_route_ok(struct mta_relay *, struct mta_route *);
1233void mta_route_error(struct mta_relay *, struct mta_route *);
1234void mta_route_down(struct mta_relay *, struct mta_route *);
1235void mta_route_collect(struct mta_relay *, struct mta_route *);
1236void mta_source_error(struct mta_relay *, struct mta_route *, const char *);
1237void mta_delivery_log(struct mta_envelope *, const char *, const char *, int, const char *);
1238void mta_delivery_notify(struct mta_envelope *);
1239struct mta_task *mta_route_next_task(struct mta_relay *, struct mta_route *);
1240const char *mta_host_to_text(struct mta_host *);
1241const char *mta_relay_to_text(struct mta_relay *);
1242
1243/* mta_session.c */
1244void mta_session(struct mta_relay *, struct mta_route *);
1245void mta_session_imsg(struct mproc *, struct imsg *);
1246
1247
1248/* parse.y */
1249int parse_config(struct smtpd *, const char *, int);
1250int cmdline_symset(char *);
1251
1252
1253/* queue.c */
1254pid_t queue(void);
1255void queue_flow_control(void);
1256
1257
1258/* queue_backend.c */
1259uint32_t queue_generate_msgid(void);
1260uint64_t queue_generate_evpid(uint32_t);
1261int queue_init(const char *, int);
1262int queue_close(void);
1263int queue_message_create(uint32_t *);
1264int queue_message_delete(uint32_t);
1265int queue_message_commit(uint32_t);
1266int queue_message_fd_r(uint32_t);
1267int queue_message_fd_rw(uint32_t);
1268int queue_message_corrupt(uint32_t);
1269int queue_envelope_create(struct envelope *);
1270int queue_envelope_delete(uint64_t);
1271int queue_envelope_load(uint64_t, struct envelope *);
1272int queue_envelope_update(struct envelope *);
1273int queue_envelope_walk(struct envelope *);
1274
1275
1276/* ruleset.c */
1277struct rule *ruleset_match(const struct envelope *);
1278
1279
1280/* scheduler.c */
1281pid_t scheduler(void);
1282
1283
1284/* scheduler_bakend.c */
1285struct scheduler_backend *scheduler_backend_lookup(const char *);
1286void scheduler_info(struct scheduler_info *, struct envelope *);
1287time_t scheduler_compute_schedule(struct scheduler_info *);
1288
1289
1290/* pony.c */
1291pid_t pony(void);
1292void pony_imsg(struct mproc *, struct imsg *);
1293
1294
1295/* smtp.c */
1296void smtp_postfork(void);
1297void smtp_postprivdrop(void);
1298void smtp_imsg(struct mproc *, struct imsg *);
1299void smtp_configure(void);
1300void smtp_collect(void);
1301
1302
1303/* smtp_session.c */
1304int smtp_session(struct listener *, int, const struct sockaddr_storage *,
1305    const char *);
1306void smtp_session_imsg(struct mproc *, struct imsg *);
1307
1308
1309/* smtpd.c */
1310void imsg_dispatch(struct mproc *, struct imsg *);
1311void post_fork(int);
1312const char *proc_name(enum smtp_proc_type);
1313const char *proc_title(enum smtp_proc_type);
1314const char *imsg_to_str(int);
1315void log_imsg(int, int, struct imsg *);
1316int fork_proc_backend(const char *, const char *, const char *);
1317
1318
1319/* ssl_smtpd.c */
1320void   *ssl_mta_init(void *, char *, off_t);
1321void   *ssl_smtp_init(void *, void *, void *);
1322
1323
1324/* stat_backend.c */
1325struct stat_backend	*stat_backend_lookup(const char *);
1326void	stat_increment(const char *, size_t);
1327void	stat_decrement(const char *, size_t);
1328void	stat_set(const char *, const struct stat_value *);
1329struct stat_value *stat_counter(size_t);
1330struct stat_value *stat_timestamp(time_t);
1331struct stat_value *stat_timeval(struct timeval *);
1332struct stat_value *stat_timespec(struct timespec *);
1333
1334
1335/* table.c */
1336struct table *table_find(const char *, const char *);
1337struct table *table_create(const char *, const char *, const char *,
1338    const char *);
1339int	table_config(struct table *);
1340int	table_open(struct table *);
1341int	table_update(struct table *);
1342void	table_close(struct table *);
1343int	table_check_use(struct table *, uint32_t, uint32_t);
1344int	table_check_type(struct table *, uint32_t);
1345int	table_check_service(struct table *, uint32_t);
1346int	table_lookup(struct table *, struct dict *, const char *, enum table_service,
1347    union lookup *);
1348int	table_fetch(struct table *, struct dict *, enum table_service, union lookup *);
1349void table_destroy(struct table *);
1350void table_add(struct table *, const char *, const char *);
1351int table_domain_match(const char *, const char *);
1352int table_netaddr_match(const char *, const char *);
1353int table_mailaddr_match(const char *, const char *);
1354void	table_open_all(void);
1355void	table_dump_all(void);
1356void	table_close_all(void);
1357int table_parse_lookup(enum table_service, const char *, const char *,
1358    union lookup *);
1359
1360
1361/* to.c */
1362int email_to_mailaddr(struct mailaddr *, char *);
1363int text_to_netaddr(struct netaddr *, const char *);
1364int text_to_mailaddr(struct mailaddr *, const char *);
1365int text_to_relayhost(struct relayhost *, const char *);
1366int text_to_userinfo(struct userinfo *, const char *);
1367int text_to_credentials(struct credentials *, const char *);
1368int text_to_expandnode(struct expandnode *, const char *);
1369uint64_t text_to_evpid(const char *);
1370uint32_t text_to_msgid(const char *);
1371const char *sa_to_text(const struct sockaddr *);
1372const char *ss_to_text(const struct sockaddr_storage *);
1373const char *time_to_text(time_t);
1374const char *duration_to_text(time_t);
1375const char *relayhost_to_text(const struct relayhost *);
1376const char *rule_to_text(struct rule *);
1377const char *sockaddr_to_text(struct sockaddr *);
1378const char *mailaddr_to_text(const struct mailaddr *);
1379const char *expandnode_to_text(struct expandnode *);
1380
1381/* util.c */
1382typedef struct arglist arglist;
1383struct arglist {
1384	char	**list;
1385	uint	  num;
1386	uint	  nalloc;
1387};
1388void addargs(arglist *, char *, ...)
1389	__attribute__((format(printf, 2, 3)));
1390int bsnprintf(char *, size_t, const char *, ...)
1391	__attribute__((format (printf, 3, 4)));
1392int mkdirs(char *, mode_t);
1393int safe_fclose(FILE *);
1394int hostname_match(const char *, const char *);
1395int valid_localpart(const char *);
1396int valid_domainpart(const char *);
1397int secure_file(int, char *, char *, uid_t, int);
1398int  lowercase(char *, const char *, size_t);
1399void xlowercase(char *, const char *, size_t);
1400int  uppercase(char *, const char *, size_t);
1401uint64_t generate_uid(void);
1402int availdesc(void);
1403int ckdir(const char *, mode_t, uid_t, gid_t, int);
1404int rmtree(char *, int);
1405int mvpurge(char *, char *);
1406int mktmpfile(void);
1407const char *parse_smtp_response(char *, size_t, char **, int *);
1408void *xmalloc(size_t, const char *);
1409void *xcalloc(size_t, size_t, const char *);
1410char *xstrdup(const char *, const char *);
1411void *xmemdup(const void *, size_t, const char *);
1412char *strip(char *);
1413void iobuf_xinit(struct iobuf *, size_t, size_t, const char *);
1414void iobuf_xfqueue(struct iobuf *, const char *, const char *, ...);
1415void log_envelope(const struct envelope *, const char *, const char *,
1416    const char *);
1417void session_socket_blockmode(int, enum blockmodes);
1418void session_socket_no_linger(int);
1419int session_socket_error(int);
1420int getmailname(char *, size_t);
1421int base64_encode(unsigned char const *, size_t, char *, size_t);
1422int base64_decode(char const *, unsigned char *, size_t);
1423
1424
1425/* waitq.c */
1426int  waitq_wait(void *, void (*)(void *, void *, void *), void *);
1427void waitq_run(void *, void *);
1428
1429/* runq.c */
1430struct runq;
1431
1432int runq_init(struct runq **, void (*)(struct runq *, void *));
1433int runq_schedule(struct runq *, time_t, void (*)(struct runq *, void *), void *);
1434int runq_delay(struct runq *, unsigned int, void (*)(struct runq *, void *), void *);
1435int runq_cancel(struct runq *, void (*)(struct runq *, void *), void *);
1436int runq_pending(struct runq *, void (*)(struct runq *, void *), void *, time_t *);
1437int runq_next(struct runq *, void (**)(struct runq *, void *), void **, time_t *);
1438