xref: /freebsd/contrib/sendmail/libmilter/libmilter.h (revision a7ec597c92be37562e4f76e105eeb7a3ba64d81a)
106f25ae9SGregory Neil Shapiro /*
2d9986b26SGregory Neil Shapiro  * Copyright (c) 1999-2003 Sendmail, Inc. and its suppliers.
306f25ae9SGregory Neil Shapiro  *	All rights reserved.
406f25ae9SGregory Neil Shapiro  *
506f25ae9SGregory Neil Shapiro  * By using this file, you agree to the terms and conditions set
606f25ae9SGregory Neil Shapiro  * forth in the LICENSE file which can be found at the top level of
706f25ae9SGregory Neil Shapiro  * the sendmail distribution.
806f25ae9SGregory Neil Shapiro  */
906f25ae9SGregory Neil Shapiro 
1006f25ae9SGregory Neil Shapiro /*
1106f25ae9SGregory Neil Shapiro **  LIBMILTER.H -- include file for mail filter library functions
1206f25ae9SGregory Neil Shapiro */
1306f25ae9SGregory Neil Shapiro 
1406f25ae9SGregory Neil Shapiro #ifndef _LIBMILTER_H
1506f25ae9SGregory Neil Shapiro # define _LIBMILTER_H	1
1640266059SGregory Neil Shapiro 
1740266059SGregory Neil Shapiro #include <sm/gen.h>
1840266059SGregory Neil Shapiro 
1906f25ae9SGregory Neil Shapiro #ifdef _DEFINE
2006f25ae9SGregory Neil Shapiro # define EXTERN
2106f25ae9SGregory Neil Shapiro # define INIT(x)	= x
22a7ec597cSGregory Neil Shapiro SM_IDSTR(MilterlId, "@(#)$Id: libmilter.h,v 8.33.2.12 2003/09/08 21:39:55 yuri Exp $")
2306f25ae9SGregory Neil Shapiro #else /* _DEFINE */
2406f25ae9SGregory Neil Shapiro # define EXTERN extern
2506f25ae9SGregory Neil Shapiro # define INIT(x)
2606f25ae9SGregory Neil Shapiro #endif /* _DEFINE */
2706f25ae9SGregory Neil Shapiro 
2806f25ae9SGregory Neil Shapiro 
2906f25ae9SGregory Neil Shapiro #define NOT_SENDMAIL	1
3006f25ae9SGregory Neil Shapiro #define _SOCK_ADDR	union bigsockaddr
3106f25ae9SGregory Neil Shapiro #include "sendmail.h"
3206f25ae9SGregory Neil Shapiro 
3306f25ae9SGregory Neil Shapiro #include "libmilter/milter.h"
3406f25ae9SGregory Neil Shapiro 
3506f25ae9SGregory Neil Shapiro # define ValidSocket(sd)	((sd) >= 0)
3640266059SGregory Neil Shapiro # define INVALID_SOCKET		(-1)
3740266059SGregory Neil Shapiro # define closesocket		close
3840266059SGregory Neil Shapiro # define MI_SOCK_READ(s, b, l)	read(s, b, l)
3940266059SGregory Neil Shapiro # define MI_SOCK_READ_FAIL(x)	((x) < 0)
4040266059SGregory Neil Shapiro # define MI_SOCK_WRITE(s, b, l)	write(s, b, l)
4106f25ae9SGregory Neil Shapiro 
4206f25ae9SGregory Neil Shapiro # define thread_create(ptid,wr,arg) pthread_create(ptid, NULL, wr, arg)
4306f25ae9SGregory Neil Shapiro # define sthread_get_id()	pthread_self()
4406f25ae9SGregory Neil Shapiro 
45193538b7SGregory Neil Shapiro typedef pthread_mutex_t smutex_t;
46193538b7SGregory Neil Shapiro # define smutex_init(mp)	(pthread_mutex_init(mp, NULL) == 0)
47193538b7SGregory Neil Shapiro # define smutex_destroy(mp)	(pthread_mutex_destroy(mp) == 0)
48193538b7SGregory Neil Shapiro # define smutex_lock(mp)	(pthread_mutex_lock(mp) == 0)
49193538b7SGregory Neil Shapiro # define smutex_unlock(mp)	(pthread_mutex_unlock(mp) == 0)
50193538b7SGregory Neil Shapiro # define smutex_trylock(mp)	(pthread_mutex_trylock(mp) == 0)
51193538b7SGregory Neil Shapiro 
52d9986b26SGregory Neil Shapiro #if _FFR_USE_POLL
53d9986b26SGregory Neil Shapiro 
54d9986b26SGregory Neil Shapiro # include <poll.h>
55d9986b26SGregory Neil Shapiro # define MI_POLLSELECT  "poll"
56d9986b26SGregory Neil Shapiro 
57d9986b26SGregory Neil Shapiro # define MI_POLL_RD_FLAGS (POLLIN | POLLPRI)
58d9986b26SGregory Neil Shapiro # define MI_POLL_WR_FLAGS (POLLOUT)
59d9986b26SGregory Neil Shapiro # define MI_MS(timeout)	(((timeout)->tv_sec * 1000) + (timeout)->tv_usec)
60d9986b26SGregory Neil Shapiro 
61d9986b26SGregory Neil Shapiro # define FD_RD_VAR(rds, excs) struct pollfd rds
62d9986b26SGregory Neil Shapiro # define FD_WR_VAR(wrs) struct pollfd wrs
63d9986b26SGregory Neil Shapiro 
64d9986b26SGregory Neil Shapiro # define FD_RD_INIT(sd, rds, excs)			\
65d9986b26SGregory Neil Shapiro 		(rds).fd = (sd);			\
66d9986b26SGregory Neil Shapiro 		(rds).events = MI_POLL_RD_FLAGS;	\
67d9986b26SGregory Neil Shapiro 		(rds).revents = 0
68d9986b26SGregory Neil Shapiro 
69d9986b26SGregory Neil Shapiro # define FD_WR_INIT(sd, wrs)				\
70d9986b26SGregory Neil Shapiro 		(wrs).fd = (sd);			\
71d9986b26SGregory Neil Shapiro 		(wrs).events = MI_POLL_WR_FLAGS;	\
72d9986b26SGregory Neil Shapiro 		(wrs).revents = 0
73d9986b26SGregory Neil Shapiro 
74d9986b26SGregory Neil Shapiro # define FD_IS_RD_EXC(sd, rds, excs)	\
75d9986b26SGregory Neil Shapiro 		(((rds).revents & (POLLERR | POLLHUP | POLLNVAL)) != 0)
76d9986b26SGregory Neil Shapiro 
77d9986b26SGregory Neil Shapiro # define FD_IS_WR_RDY(sd, wrs)		\
78d9986b26SGregory Neil Shapiro 		(((wrs).revents & MI_POLL_WR_FLAGS) != 0)
79d9986b26SGregory Neil Shapiro 
80d9986b26SGregory Neil Shapiro # define FD_IS_RD_RDY(sd, rds, excs)			\
81d9986b26SGregory Neil Shapiro 		(((rds).revents & MI_POLL_RD_FLAGS) != 0)
82d9986b26SGregory Neil Shapiro 
83d9986b26SGregory Neil Shapiro # define FD_WR_READY(sd, excs, timeout)	\
84d9986b26SGregory Neil Shapiro 		poll(&(wrs), 1, MI_MS(timeout))
85d9986b26SGregory Neil Shapiro 
86d9986b26SGregory Neil Shapiro # define FD_RD_READY(sd, rds, excs, timeout)	\
87d9986b26SGregory Neil Shapiro 		poll(&(rds), 1, MI_MS(timeout))
88d9986b26SGregory Neil Shapiro 
89d9986b26SGregory Neil Shapiro #else /* _FFR_USE_POLL */
90d9986b26SGregory Neil Shapiro 
91d9986b26SGregory Neil Shapiro # include <sm/fdset.h>
92d9986b26SGregory Neil Shapiro # define MI_POLLSELECT  "select"
93d9986b26SGregory Neil Shapiro 
94d9986b26SGregory Neil Shapiro # define FD_RD_VAR(rds, excs) fd_set rds, excs
95d9986b26SGregory Neil Shapiro # define FD_WR_VAR(wrs) fd_set wrs
96d9986b26SGregory Neil Shapiro 
97d9986b26SGregory Neil Shapiro # define FD_RD_INIT(sd, rds, excs)			\
98d9986b26SGregory Neil Shapiro 		FD_ZERO(&(rds));			\
99d9986b26SGregory Neil Shapiro 		FD_SET((unsigned int) (sd), &(rds));	\
100d9986b26SGregory Neil Shapiro 		FD_ZERO(&(excs));			\
101d9986b26SGregory Neil Shapiro 		FD_SET((unsigned int) (sd), &(excs))
102d9986b26SGregory Neil Shapiro 
103d9986b26SGregory Neil Shapiro # define FD_WR_INIT(sd, wrs)			\
104d9986b26SGregory Neil Shapiro 		FD_ZERO(&(wrs));			\
105d9986b26SGregory Neil Shapiro 		FD_SET((unsigned int) (sd), &(wrs));	\
106d9986b26SGregory Neil Shapiro 
107d9986b26SGregory Neil Shapiro # define FD_IS_RD_EXC(sd, rds, excs) FD_ISSET(sd, &(excs))
108d9986b26SGregory Neil Shapiro # define FD_IS_WR_RDY(sd, wrs) FD_ISSET((sd), &(wrs))
109d9986b26SGregory Neil Shapiro # define FD_IS_RD_RDY(sd, rds, excs) FD_ISSET((sd), &(rds))
110d9986b26SGregory Neil Shapiro 
111d9986b26SGregory Neil Shapiro # define FD_WR_READY(sd, wrs, timeout)	\
112d9986b26SGregory Neil Shapiro 		select((sd) + 1, NULL, &(wrs), NULL, (timeout))
113d9986b26SGregory Neil Shapiro # define FD_RD_READY(sd, rds, excs, timeout)	\
114d9986b26SGregory Neil Shapiro 		select((sd) + 1, &(rds), NULL, &(excs), (timeout))
115d9986b26SGregory Neil Shapiro 
116d9986b26SGregory Neil Shapiro #endif /* _FFR_USE_POLL */
117d9986b26SGregory Neil Shapiro 
11806f25ae9SGregory Neil Shapiro #include <sys/time.h>
11906f25ae9SGregory Neil Shapiro 
12006f25ae9SGregory Neil Shapiro /* version info */
12106f25ae9SGregory Neil Shapiro #define MILTER_PRODUCT_NAME	"libmilter"
12206f25ae9SGregory Neil Shapiro #define MILTER_VERSION		100
12306f25ae9SGregory Neil Shapiro 
12406f25ae9SGregory Neil Shapiro /* some defaults */
1258774250cSGregory Neil Shapiro #define MI_TIMEOUT	7210		/* default timeout for read/write */
12606f25ae9SGregory Neil Shapiro #define MI_CHK_TIME	5		/* checking whether to terminate */
12706f25ae9SGregory Neil Shapiro 
12840266059SGregory Neil Shapiro #ifndef MI_SOMAXCONN
12942e5d165SGregory Neil Shapiro # if SOMAXCONN > 20
13042e5d165SGregory Neil Shapiro #  define MI_SOMAXCONN	SOMAXCONN
13142e5d165SGregory Neil Shapiro # else /* SOMAXCONN */
13242e5d165SGregory Neil Shapiro #  define MI_SOMAXCONN	20
13342e5d165SGregory Neil Shapiro # endif /* SOMAXCONN */
13440266059SGregory Neil Shapiro #endif /* ! MI_SOMAXCONN */
13542e5d165SGregory Neil Shapiro 
13606f25ae9SGregory Neil Shapiro /* maximum number of repeated failures in mi_listener() */
13706f25ae9SGregory Neil Shapiro #define MAX_FAILS_M	16	/* malloc() */
13806f25ae9SGregory Neil Shapiro #define MAX_FAILS_T	16	/* thread creation */
1398774250cSGregory Neil Shapiro #define MAX_FAILS_A	16	/* accept() */
14040266059SGregory Neil Shapiro #define MAX_FAILS_S	16	/* select() */
14106f25ae9SGregory Neil Shapiro 
14206f25ae9SGregory Neil Shapiro /* internal "commands", i.e., error codes */
14306f25ae9SGregory Neil Shapiro #define SMFIC_TIMEOUT	((char) 1)	/* timeout */
14406f25ae9SGregory Neil Shapiro #define SMFIC_SELECT	((char) 2)	/* select error */
14506f25ae9SGregory Neil Shapiro #define SMFIC_MALLOC	((char) 3)	/* malloc error */
14606f25ae9SGregory Neil Shapiro #define SMFIC_RECVERR	((char) 4)	/* recv() error */
14706f25ae9SGregory Neil Shapiro #define SMFIC_EOF	((char) 5)	/* eof */
14806f25ae9SGregory Neil Shapiro #define SMFIC_UNKNERR	((char) 6)	/* unknown error */
14906f25ae9SGregory Neil Shapiro #define SMFIC_TOOBIG	((char) 7)	/* body chunk too big */
15006f25ae9SGregory Neil Shapiro #define SMFIC_VALIDCMD	' '		/* first valid command */
15106f25ae9SGregory Neil Shapiro 
15206f25ae9SGregory Neil Shapiro /* hack */
15306f25ae9SGregory Neil Shapiro #define smi_log		syslog
154a7ec597cSGregory Neil Shapiro #define sm_dprintf	(void) printf
15506f25ae9SGregory Neil Shapiro #define milter_ret	int
15606f25ae9SGregory Neil Shapiro #define SMI_LOG_ERR	LOG_ERR
15706f25ae9SGregory Neil Shapiro #define SMI_LOG_FATAL	LOG_ERR
15806f25ae9SGregory Neil Shapiro #define SMI_LOG_WARN	LOG_WARNING
15906f25ae9SGregory Neil Shapiro #define SMI_LOG_INFO	LOG_INFO
16006f25ae9SGregory Neil Shapiro #define SMI_LOG_DEBUG	LOG_DEBUG
16106f25ae9SGregory Neil Shapiro 
16206f25ae9SGregory Neil Shapiro /* stop? */
16306f25ae9SGregory Neil Shapiro #define MILTER_CONT	0
16406f25ae9SGregory Neil Shapiro #define MILTER_STOP	1
16506f25ae9SGregory Neil Shapiro #define MILTER_ABRT	2
16606f25ae9SGregory Neil Shapiro 
16706f25ae9SGregory Neil Shapiro /* functions */
16806f25ae9SGregory Neil Shapiro extern int	mi_handle_session __P((SMFICTX_PTR));
16906f25ae9SGregory Neil Shapiro extern int	mi_engine __P((SMFICTX_PTR));
17042e5d165SGregory Neil Shapiro extern int	mi_listener __P((char *, int, smfiDesc_ptr, time_t, int));
17106f25ae9SGregory Neil Shapiro extern void	mi_clr_macros __P((SMFICTX_PTR, int));
17206f25ae9SGregory Neil Shapiro extern int	mi_stop __P((void));
17306f25ae9SGregory Neil Shapiro extern int	mi_control_startup __P((char *));
17406f25ae9SGregory Neil Shapiro extern void	mi_stop_milters __P((int));
17506f25ae9SGregory Neil Shapiro extern void	mi_clean_signals __P((void));
17606f25ae9SGregory Neil Shapiro extern struct hostent *mi_gethostbyname __P((char *, int));
17740266059SGregory Neil Shapiro extern int	mi_inet_pton __P((int, const char *, void *));
17842e5d165SGregory Neil Shapiro extern void	mi_closener __P((void));
17994c01205SGregory Neil Shapiro extern int	mi_opensocket __P((char *, int, int, smfiDesc_ptr));
18006f25ae9SGregory Neil Shapiro 
18106f25ae9SGregory Neil Shapiro /* communication functions */
18206f25ae9SGregory Neil Shapiro extern char	*mi_rd_cmd __P((socket_t, struct timeval *, char *, size_t *, char *));
18306f25ae9SGregory Neil Shapiro extern int	mi_wr_cmd __P((socket_t, struct timeval *, int, char *, size_t));
18406f25ae9SGregory Neil Shapiro extern bool	mi_sendok __P((SMFICTX_PTR, int));
18506f25ae9SGregory Neil Shapiro 
18640266059SGregory Neil Shapiro 
18706f25ae9SGregory Neil Shapiro #endif /* ! _LIBMILTER_H */
188