imapfilter/imapfilter/imapfilter.h

#ifndef IMAPFILTER_H
#define IMAPFILTER_H

#include <stdio.h>
#include <unistd.h>
#include <sys/stat.h>
#include <sys/types.h>
#include <dirent.h>

#ifndef DATA_H
#include "data.h"
#endif

/* Error codes returned by functions. */
#define ERROR_SIGNAL                    1
#define ERROR_TRIVIAL                   2
#define ERROR_FILE_OPEN                 3
#define ERROR_LOCKFILE                  4
#define ERROR_CONFIG_PARSE              5
#define ERROR_MEMORY_ALLOCATION         6
#define ERROR_SETUID                    7
#define ERROR_TERMIO                    8
#define ERROR_NETWORK                   9
#define ERROR_SSL                       10
#define ERROR_PASSPHRASE                11
#define ERROR_ENCRYPT                   12
#define ERROR_DECRYPT                   13
#define ERROR_FORK                      14
#define ERROR_UNDEFINED                 15

/* Flags that control the program's execution options. */
#define OPTION_DETAILS_QUIET            0x01
#define OPTION_DETAILS_NORMAL           0x02
#define OPTION_DETAILS_VERBOSE          0x04
#define OPTION_DETAILS_CLEAR            0xf8
#define OPTION_HEADERS                  0x08
#define OPTION_NAMESPACE                0x10
#define OPTION_EXPUNGE                  0x20
#define OPTION_PASSWORD_EDITOR          0x40
#define OPTION_DAEMON_MODE              0x80

/* Other flags. */
#define FLAG_TTY_MODIFIED               0x01
#define FLAG_BLANK_PASSWORD             0x02

/* Capabilities of mail server. */
#define CAPABILITY_NONE                 0x00
#define CAPABILITY_NAMESPACE            0x01

/* Flags for logger. */
#define LOG_WRITE                       0
#define LOG_SERVER                      1
#define LOG_USERNAME                    2
#define LOG_MAILBOX                     3
#define LOG_FILTER                      4
#define LOG_ACTION                      5
#define LOG_DESTINATION_MAILBOX         6

/* Buffer size of the IMAP command. */
#define SMALL_CMD                       64
#define MEDIUM_CMD                      512
#define BIG_CMD                         32768

/* Buffer size of server's response. */
#define RESPONSE_BUF                    (4096 + 1)
#define RESULT_BUF                      512

/* Response codes. */
#define RESPONSE_NONE                   -2
#define RESPONSE_BAD                    -1
#define RESPONSE_OK                     0
#define RESPONSE_NO                     1
#define RESPONSE_BYE                    2
#define RESPONSE_PREAUTH                3
#define RESPONSE_READONLY               4
#define RESPONSE_TRYCREATE              5

/* Buffer size of message's headers. */
#define HEADERS_BUF                     16384

/* Length of mailbox namespace prefix. */
#define NAMESPACE_PREFIX_LEN            64

/* Encryption and decryption buffers. */
#define ENCRYPTION_BUF                  1024
#define DECRYPTION_BUF                  4096

/* Maximum passwords the password editor can handle. */
#define EDITOR_PASSWORDS_MAX            64


#define min(A, B)                       ((A) < (B) ? (A) : (B))
#define plural(A)                       ((A) == 1 ? "" : "s")


/* Secure memory information. */
typedef struct secmem {
    void *buf;                  /* Allocated memory buffer. */
    size_t size;                /* Size of the buffer. */
    struct secmem *prev, *next; /* Previous/next node of doubly linked list. */
} secmem_t;


/* Namespace of IMAP mailboxes. */
typedef struct namesp {
    char prefix[NAMESPACE_PREFIX_LEN];
    char delim;
} namesp_t;


/*      file.c          */
int read_config(char *cfg);
int parse_config(FILE * fd);
void set_options(char *line, regmatch_t * match);

int read_passwords(void);
int parse_passwords(FILE * fd);
int store_passwords(account_t * accts[]);

int create_homedir(void);
int exists_file(char *fname);
int exists_dir(char *fname);
int create_file(char *fname, mode_t mode);
#ifdef CHECK_PERMISSIONS
int check_file_perms(char *fname, mode_t mode);
int check_dir_perms(char *dname, mode_t mode);
#endif

/*      imapfilter.c    */
void usage(void);

/*      imap.c          */
unsigned int send_command(int *sock, char *cmd);
#ifdef DEBUG
int imap_noop(int *sock);
#endif
int imap_capability(int *sock);
int imap_namespace(int *sock);
int imap_logout(int *sock);
int imap_login(int *sock, char *user, char *pass);
/* int imap_list(int *sock, char *refer, char *mbox); */
int imap_subscribe(int *sock, char *mbox);
int imap_examine(int *sock, char *mbox);
int imap_select(int *sock, char *mbox);
int imap_status(int *sock, char *mbox, char *items);
int imap_create(int *sock, char *mbox);
int imap_search(int *sock, char *search);
int imap_fetch(int *sock, char *mesg, char *items);
int imap_store(int *sock, char *mesg, char *flags);
int imap_copy(int *sock, char *mesg, char *mbox);
int imap_append(int *sock, char *mbox, unsigned int size);
int imap_close(int *sock);
int imap_expunge(int *sock);

/*      lock.c          */
void lockfile_create(void);
void lockfile_check(void);
pid_t lockfile_pid(void);
int lockfile_remove(void);
void kill_imapfilter(void);

/*      log.c           */
void info(const char *info,...);
void verbose(const char *info,...);
void error(const char *errmsg,...);
void fatal(unsigned int errnum, const char *fatal,...);
void catch_signals(void);
void signal_handler(int sig);
int open_logfile(void);
int create_logfile(void);
int close_logfile(void);
void log_info(int flag, void *ptr);
char *get_time(void);

/*      memory.c        */
void *xmalloc(size_t size);
void *xrealloc(void *ptr, size_t size);
void xfree(void *ptr);
char *xstrdup(const char *s);

void *smalloc(size_t size);
void *srealloc(void *ptr, size_t size);
void sfree(void *ptr);
char *sstrdup(const char *s);
void secmem_append(secmem_t * node);
secmem_t *secmem_find(void *ptr);
void secmem_remove(secmem_t * node);
void secmem_clear(void);
void secmem_lock(void);

void corefile_disable(void);

/*      misc.c          */
char *strcasestr(const char *haystack, const char *needle);
char *ultostr(unsigned long int num, int base);
char *xstrncpy(char *dest, const char *src, size_t size);

/*      passwd.c        */
void get_password(char *passwd, size_t pwlen);
#ifdef ENCRYPTED_PASSWORDS
int encrypt_passwords(FILE * fd, account_t * accts[]);
int decrypt_passwords(unsigned char **buf, FILE * fd);
void password_editor(void);
#endif

/*      request.c       */
int test(int *sock);
int check_capabilities(int *sock);
int check_namespace(int *sock, namesp_t * nsp);
int login(int *sock, char *user, char *pass);
int check_mailbox(int *sock, char *mbox, namesp_t * nsp);
int select_mailbox(int *sock, char *mbox, namesp_t * nsp);
int mailbox_status(int *sock, char *mbox, namesp_t * nsp);
int close_mailbox(int *sock);
int logout(int *sock);

int apply_filters(filter_t ** filters);
int match_filter(filter_t * filter, char **mesgs);

void empty_fifo(mask_t ** mfifo);
void queue_fifo(mask_t ** mfifo, mask_t * mask);
mask_t *dequeue_fifo(mask_t ** mfifo);

char *generate_filter_and(mask_t * mask, unsigned int masknum,
                           unsigned int masklen);
char *generate_filter_or(mask_t * mask, unsigned int masknum,
                          unsigned int masklen);

int apply_action(char *mesgs, unsigned int *type, account_t * raccount,
                  char *destmbox, char *args);
int action_delete(char *mesgs, char *args);
int action_copy(char *mesgs, char *destmbox, char *args);
int action_move(char *mesgs, char *destmbox, char *args);
int action_rcopy(char *mesgs, account_t * destacc, char *destmbox, char *args);
int action_rmove(char *mesgs, account_t * destacc, char *destmbox, char *args);
int action_list(char *mesgs, char *args);

unsigned int count_messages(char *mesgs);
char *convert_messages(char *mesgs);


/*      response.c      */
void receive_response(int *sock, char *buf);
int server_response(int *sock, unsigned int tag);
int greeting_response(int *sock);
int capability_response(int *sock, unsigned int tag);
int namespace_response(int *sock, unsigned int tag, namesp_t * nsp);
int status_response(int *sock, unsigned int tag, char *mbox);
int select_response(int *sock, unsigned int tag);
int search_response(int *sock, unsigned int tag, char **mesgs);
int fetch_response(int *sock, int reset, char *fetch, unsigned int tag);
int fetchsize_response(int *sock, unsigned int *size, unsigned int tag);
int append_response(int *sock, unsigned int tag);
int copy_response(int *sock, unsigned int tag);
int analyze_response(char *buf);
void init_vbuf(void);
void reset_vbuf(void);
void check_vbuf(size_t n);

/*      socket.c        */
int init_connection(int *sock, char *serv, unsigned short int port,
                     unsigned int protocol);
int ssl_init(int *sock, unsigned int protocol);
int close_connection(int *sock);
int socket_read(int *sock, char *buf);
int socket_write(int *sock, char *data);

/*      tty.c           */
int tty_store(void);
int tty_disable_echo(void);
int tty_restore(void);

#endif                          /* IMAPFILTER_H */
1	lefcha	1.9	#ifndef IMAPFILTER_H
2			#define IMAPFILTER_H
3
4			#include <stdio.h>
5	lefcha	1.25	#include <unistd.h>
6			#include <sys/stat.h>
7			#include <sys/types.h>
8	lefcha	1.29	#include <dirent.h>
9	lefcha	1.9
10			#ifndef DATA_H
11			#include "data.h"
12			#endif
13
14	lefcha	1.11	/* Error codes returned by functions. */
15	lefcha	1.22	#define ERROR_SIGNAL 1
16			#define ERROR_TRIVIAL 2
17			#define ERROR_FILE_OPEN 3
18	lefcha	1.32	#define ERROR_LOCKFILE 4
19	lefcha	1.29	#define ERROR_CONFIG_PARSE 5
20			#define ERROR_MEMORY_ALLOCATION 6
21			#define ERROR_SETUID 7
22			#define ERROR_TERMIO 8
23			#define ERROR_NETWORK 9
24			#define ERROR_SSL 10
25			#define ERROR_PASSPHRASE 11
26			#define ERROR_ENCRYPT 12
27			#define ERROR_DECRYPT 13
28	lefcha	1.30	#define ERROR_FORK 14
29			#define ERROR_UNDEFINED 15
30	lefcha	1.9
31	lefcha	1.30	/* Flags that control the program's execution options. */
32	lefcha	1.16	#define OPTION_DETAILS_QUIET 0x01
33	lefcha	1.9	#define OPTION_DETAILS_NORMAL 0x02
34			#define OPTION_DETAILS_VERBOSE 0x04
35			#define OPTION_DETAILS_CLEAR 0xf8
36	lefcha	1.14	#define OPTION_HEADERS 0x08
37	lefcha	1.25	#define OPTION_NAMESPACE 0x10
38	lefcha	1.34	#define OPTION_EXPUNGE 0x20
39			#define OPTION_PASSWORD_EDITOR 0x40
40			#define OPTION_DAEMON_MODE 0x80
41	lefcha	1.30
42			/* Other flags. */
43	lefcha	1.32	#define FLAG_TTY_MODIFIED 0x01
44			#define FLAG_BLANK_PASSWORD 0x02
45	lefcha	1.25
46			/* Capabilities of mail server. */
47			#define CAPABILITY_NONE 0x00
48			#define CAPABILITY_NAMESPACE 0x01
49	lefcha	1.9
50	lefcha	1.12	/* Flags for logger. */
51			#define LOG_WRITE 0
52			#define LOG_SERVER 1
53			#define LOG_USERNAME 2
54			#define LOG_MAILBOX 3
55			#define LOG_FILTER 4
56			#define LOG_ACTION 5
57			#define LOG_DESTINATION_MAILBOX 6
58
59	lefcha	1.17	/* Buffer size of the IMAP command. */
60	lefcha	1.9	#define SMALL_CMD 64
61	lefcha	1.32	#define MEDIUM_CMD 512
62			#define BIG_CMD 32768
63	lefcha	1.9
64			/* Buffer size of server's response. */
65	lefcha	1.21	#define RESPONSE_BUF (4096 + 1)
66	lefcha	1.20	#define RESULT_BUF 512
67	lefcha	1.9
68	lefcha	1.16	/* Response codes. */
69	lefcha	1.32	#define RESPONSE_NONE -2
70	lefcha	1.16	#define RESPONSE_BAD -1
71			#define RESPONSE_OK 0
72			#define RESPONSE_NO 1
73			#define RESPONSE_BYE 2
74	lefcha	1.20	#define RESPONSE_PREAUTH 3
75			#define RESPONSE_READONLY 4
76			#define RESPONSE_TRYCREATE 5
77	lefcha	1.16
78	lefcha	1.9	/* Buffer size of message's headers. */
79	lefcha	1.19	#define HEADERS_BUF 16384
80	lefcha	1.9
81	lefcha	1.25	/* Length of mailbox namespace prefix. */
82			#define NAMESPACE_PREFIX_LEN 64
83
84	lefcha	1.26	/* Encryption and decryption buffers. */
85			#define ENCRYPTION_BUF 1024
86			#define DECRYPTION_BUF 4096
87
88	lefcha	1.27	/* Maximum passwords the password editor can handle. */
89	lefcha	1.32	#define EDITOR_PASSWORDS_MAX 64
90	lefcha	1.27
91	lefcha	1.1
92			#define min(A, B) ((A) < (B) ? (A) : (B))
93	lefcha	1.15	#define plural(A) ((A) == 1 ? "" : "s")
94	lefcha	1.1
95
96	lefcha	1.27	/* Secure memory information. */
97			typedef struct secmem {
98			void buf; / Allocated memory buffer. */
99			size_t size; /* Size of the buffer. */
100			struct secmem prev, next; /* Previous/next node of doubly linked list. */
101			} secmem_t;
102
103
104	lefcha	1.32	/* Namespace of IMAP mailboxes. */
105			typedef struct namesp {
106			char prefix[NAMESPACE_PREFIX_LEN];
107			char delim;
108			} namesp_t;
109
110
111	lefcha	1.9	/* file.c */
112	lefcha	1.27	int read_config(char *cfg);
113			int parse_config(FILE * fd);
114			void set_options(char line, regmatch_t match);
115
116			int read_passwords(void);
117			int parse_passwords(FILE * fd);
118			int store_passwords(account_t * accts[]);
119
120	lefcha	1.25	int create_homedir(void);
121	lefcha	1.26	int exists_file(char *fname);
122			int exists_dir(char *fname);
123	lefcha	1.25	int create_file(char *fname, mode_t mode);
124	lefcha	1.9	#ifdef CHECK_PERMISSIONS
125	lefcha	1.25	int check_file_perms(char *fname, mode_t mode);
126			int check_dir_perms(char *dname, mode_t mode);
127	lefcha	1.9	#endif
128	lefcha	1.1
129	lefcha	1.9	/* imapfilter.c */
130			void usage(void);
131	lefcha	1.1
132	lefcha	1.9	/* imap.c */
133	lefcha	1.32	unsigned int send_command(int sock, char cmd);
134	lefcha	1.9	#ifdef DEBUG
135	lefcha	1.32	int imap_noop(int *sock);
136	lefcha	1.9	#endif
137	lefcha	1.32	int imap_capability(int *sock);
138			int imap_namespace(int *sock);
139			int imap_logout(int *sock);
140			int imap_login(int sock, char user, char *pass);
141			/* int imap_list(int sock, char refer, char mbox); /
142			int imap_subscribe(int sock, char mbox);
143			int imap_examine(int sock, char mbox);
144			int imap_select(int sock, char mbox);
145			int imap_status(int sock, char mbox, char *items);
146			int imap_create(int sock, char mbox);
147			int imap_search(int sock, char search);
148			int imap_fetch(int sock, char mesg, char *items);
149			int imap_store(int sock, char mesg, char *flags);
150			int imap_copy(int sock, char mesg, char *mbox);
151			int imap_append(int sock, char mbox, unsigned int size);
152			int imap_close(int *sock);
153	lefcha	1.34	int imap_expunge(int *sock);
154	lefcha	1.29
155			/* lock.c */
156			void lockfile_create(void);
157			void lockfile_check(void);
158	lefcha	1.30	pid_t lockfile_pid(void);
159	lefcha	1.29	int lockfile_remove(void);
160	lefcha	1.30	void kill_imapfilter(void);
161	lefcha	1.9
162			/* log.c */
163	lefcha	1.13	void info(const char *info,...);
164			void verbose(const char *info,...);
165			void error(const char *errmsg,...);
166			void fatal(unsigned int errnum, const char *fatal,...);
167	lefcha	1.22	void catch_signals(void);
168			void signal_handler(int sig);
169	lefcha	1.9	int open_logfile(void);
170			int create_logfile(void);
171			int close_logfile(void);
172	lefcha	1.12	void log_info(int flag, void *ptr);
173	lefcha	1.11	char *get_time(void);
174	lefcha	1.9
175	lefcha	1.13	/* memory.c */
176			void *xmalloc(size_t size);
177	lefcha	1.19	void xrealloc(void ptr, size_t size);
178	lefcha	1.26	void xfree(void *ptr);
179	lefcha	1.13	char xstrdup(const char s);
180
181	lefcha	1.27	void *smalloc(size_t size);
182			void srealloc(void ptr, size_t size);
183			void sfree(void *ptr);
184			char sstrdup(const char s);
185	lefcha	1.34	void secmem_append(secmem_t * node);
186	lefcha	1.27	secmem_t secmem_find(void ptr);
187	lefcha	1.34	void secmem_remove(secmem_t * node);
188	lefcha	1.27	void secmem_clear(void);
189	lefcha	1.30	void secmem_lock(void);
190	lefcha	1.27
191			void corefile_disable(void);
192
193	lefcha	1.16	/* misc.c */
194			char strcasestr(const char haystack, const char *needle);
195			char *ultostr(unsigned long int num, int base);
196	lefcha	1.24	char xstrncpy(char dest, const char *src, size_t size);
197	lefcha	1.16
198	lefcha	1.25	/* passwd.c */
199	lefcha	1.26	void get_password(char *passwd, size_t pwlen);
200			#ifdef ENCRYPTED_PASSWORDS
201	lefcha	1.34	int encrypt_passwords(FILE * fd, account_t * accts[]);
202			int decrypt_passwords(unsigned char *buf, FILE fd);
203	lefcha	1.26	void password_editor(void);
204			#endif
205	lefcha	1.25
206	lefcha	1.9	/* request.c */
207	lefcha	1.32	int test(int *sock);
208			int check_capabilities(int *sock);
209	lefcha	1.34	int check_namespace(int sock, namesp_t nsp);
210	lefcha	1.32	int login(int sock, char user, char *pass);
211	lefcha	1.34	int check_mailbox(int sock, char mbox, namesp_t * nsp);
212			int select_mailbox(int sock, char mbox, namesp_t * nsp);
213			int mailbox_status(int sock, char mbox, namesp_t * nsp);
214	lefcha	1.32	int close_mailbox(int *sock);
215			int logout(int *sock);
216	lefcha	1.9
217	lefcha	1.16	int apply_filters(filter_t ** filters);
218	lefcha	1.19	int match_filter(filter_t * filter, char **mesgs);
219	lefcha	1.9
220			void empty_fifo(mask_t ** mfifo);
221	lefcha	1.11	void queue_fifo(mask_t ** mfifo, mask_t * mask);
222			mask_t dequeue_fifo(mask_t * mfifo);
223	lefcha	1.9
224	lefcha	1.32	char generate_filter_and(mask_t mask, unsigned int masknum,
225	lefcha	1.34	unsigned int masklen);
226			char generate_filter_or(mask_t mask, unsigned int masknum,
227	lefcha	1.32	unsigned int masklen);
228	lefcha	1.9
229	lefcha	1.34	int apply_action(char mesgs, unsigned int type, account_t * raccount,
230			char destmbox, char args);
231	lefcha	1.9	int action_delete(char mesgs, char args);
232	lefcha	1.11	int action_copy(char mesgs, char destmbox, char *args);
233			int action_move(char mesgs, char destmbox, char *args);
234	lefcha	1.34	int action_rcopy(char mesgs, account_t destacc, char destmbox, char args);
235			int action_rmove(char mesgs, account_t destacc, char destmbox, char args);
236	lefcha	1.11	int action_list(char mesgs, char args);
237	lefcha	1.9
238	lefcha	1.32	unsigned int count_messages(char *mesgs);
239	lefcha	1.33	char convert_messages(char mesgs);
240	lefcha	1.32
241	lefcha	1.9
242	lefcha	1.11	/* response.c */
243	lefcha	1.32	void receive_response(int sock, char buf);
244			int server_response(int *sock, unsigned int tag);
245			int greeting_response(int *sock);
246			int capability_response(int *sock, unsigned int tag);
247	lefcha	1.34	int namespace_response(int sock, unsigned int tag, namesp_t nsp);
248	lefcha	1.32	int status_response(int sock, unsigned int tag, char mbox);
249			int select_response(int *sock, unsigned int tag);
250			int search_response(int sock, unsigned int tag, char *mesgs);
251			int fetch_response(int sock, int reset, char fetch, unsigned int tag);
252			int fetchsize_response(int sock, unsigned int size, unsigned int tag);
253			int append_response(int *sock, unsigned int tag);
254			int copy_response(int *sock, unsigned int tag);
255	lefcha	1.20	int analyze_response(char *buf);
256	lefcha	1.32	void init_vbuf(void);
257			void reset_vbuf(void);
258			void check_vbuf(size_t n);
259	lefcha	1.25
260			/* socket.c */
261	lefcha	1.32	int init_connection(int sock, char serv, unsigned short int port,
262	lefcha	1.34	unsigned int protocol);
263	lefcha	1.32	int ssl_init(int *sock, unsigned int protocol);
264			int close_connection(int *sock);
265			int socket_read(int sock, char buf);
266			int socket_write(int sock, char data);
267	lefcha	1.25
268			/* tty.c */
269			int tty_store(void);
270			int tty_disable_echo(void);
271			int tty_restore(void);
272	lefcha	1.11
273	lefcha	1.13	#endif /* IMAPFILTER_H */