1 /* vi: set sw=4 ts=4: */
3 * popmaildir: a simple yet powerful POP3 client
4 * Delivers contents of remote mailboxes to local Maildir
6 * Inspired by original utility by Nikola Vladov
8 * Copyright (C) 2008 by Vladimir Dronnikov <dronnikov@gmail.com>
10 * Licensed under GPLv2, see file LICENSE in this source tree.
12 //config:config POPMAILDIR
13 //config: bool "popmaildir (11 kb)"
16 //config: Simple yet powerful POP3 mail popper. Delivers content
17 //config: of remote mailboxes to local Maildir.
19 //config:config FEATURE_POPMAILDIR_DELIVERY
20 //config: bool "Allow message filters and custom delivery program"
22 //config: depends on POPMAILDIR
24 //config: Allow to use a custom program to filter the content
25 //config: of the message before actual delivery (-F "prog [args...]").
26 //config: Allow to use a custom program for message actual delivery
27 //config: (-M "prog [args...]").
29 //applet:IF_POPMAILDIR(APPLET(popmaildir, BB_DIR_USR_SBIN, BB_SUID_DROP))
31 //kbuild:lib-$(CONFIG_POPMAILDIR) += popmaildir.o mail.o
33 //usage:#define popmaildir_trivial_usage
34 //usage: "[OPTIONS] MAILDIR [CONN_HELPER ARGS]"
35 //usage:#define popmaildir_full_usage "\n\n"
36 //usage: "Fetch content of remote mailbox to local maildir\n"
37 /* //usage: "\n -b Binary mode. Ignored" */
38 /* //usage: "\n -d Debug. Ignored" */
39 /* //usage: "\n -m Show used memory. Ignored" */
40 /* //usage: "\n -V Show version. Ignored" */
41 /* //usage: "\n -c Use tcpclient. Ignored" */
42 /* //usage: "\n -a Use APOP protocol. Implied. If server supports APOP -> use it" */
43 //usage: "\n -s Skip authorization"
44 //usage: "\n -T Get messages with TOP instead of RETR"
45 //usage: "\n -k Keep retrieved messages on the server"
46 //usage: "\n -t SEC Network timeout"
47 //usage: IF_FEATURE_POPMAILDIR_DELIVERY(
48 //usage: "\n -F 'PROG ARGS' Filter program (may be repeated)"
49 //usage: "\n -M 'PROG ARGS' Delivery program"
52 //usage: "\nFetch from plain POP3 server:"
53 //usage: "\npopmaildir -k DIR nc pop3.server.com 110 <user_and_pass.txt"
54 //usage: "\nFetch from SSLed POP3 server and delete fetched emails:"
55 //usage: "\npopmaildir DIR -- openssl s_client -quiet -connect pop3.server.com:995 <user_and_pass.txt"
56 /* //usage: "\n -R BYTES Remove old messages on the server >= BYTES. Ignored" */
57 /* //usage: "\n -Z N1-N2 Remove messages from N1 to N2 (dangerous). Ignored" */
58 /* //usage: "\n -L BYTES Don't retrieve new messages >= BYTES. Ignored" */
59 /* //usage: "\n -H LINES Type first LINES of a message. Ignored" */
61 //usage:#define popmaildir_example_usage
62 //usage: "$ popmaildir -k ~/Maildir -- nc pop.drvv.ru 110 [<password_file]\n"
63 //usage: "$ popmaildir ~/Maildir -- openssl s_client -quiet -connect pop.gmail.com:995 [<password_file]\n"
68 static void pop3_checkr(const char *fmt
, const char *param
, char **ret
)
70 char *msg
= send_mail_command(fmt
, param
);
71 //FIXME: limit max len!!!
72 char *answer
= xmalloc_fgetline(stdin
);
73 if (answer
&& '+' == answer
[0]) {
79 memmove(answer
, answer
+ 4, strlen(answer
) - 4);
85 bb_error_msg_and_die("%s failed, reply was: %s", msg
, answer
);
88 static void pop3_check(const char *fmt
, const char *param
)
90 pop3_checkr(fmt
, param
, NULL
);
93 int popmaildir_main(int argc
, char **argv
) MAIN_EXTERNALLY_VISIBLE
;
94 int popmaildir_main(int argc UNUSED_PARAM
, char **argv
)
102 #if ENABLE_FEATURE_POPMAILDIR_DELIVERY
103 const char *delivery
;
105 unsigned opt_nlines
= 0;
108 OPT_b
= 1 << 0, // -b binary mode. Ignored
109 OPT_d
= 1 << 1, // -d,-dd,-ddd debug. Ignored
110 OPT_m
= 1 << 2, // -m show used memory. Ignored
111 OPT_V
= 1 << 3, // -V version. Ignored
112 OPT_c
= 1 << 4, // -c use tcpclient. Ignored
113 OPT_a
= 1 << 5, // -a use APOP protocol
114 OPT_s
= 1 << 6, // -s skip authorization
115 OPT_T
= 1 << 7, // -T get messages with TOP instead with RETR
116 OPT_k
= 1 << 8, // -k keep retrieved messages on the server
117 OPT_t
= 1 << 9, // -t90 set timeout to 90 sec
118 OPT_R
= 1 << 10, // -R20000 remove old messages on the server >= 20000 bytes (requires -k). Ignored
119 OPT_Z
= 1 << 11, // -Z11-23 remove messages from 11 to 23 (dangerous). Ignored
120 OPT_L
= 1 << 12, // -L50000 not retrieve new messages >= 50000 bytes. Ignored
121 OPT_H
= 1 << 13, // -H30 type first 30 lines of a message; (-L12000 -H30). Ignored
122 OPT_M
= 1 << 14, // -M\"program arg1 arg2 ...\"; deliver by program. Treated like -F
123 OPT_F
= 1 << 15, // -F\"program arg1 arg2 ...\"; filter by program. Treated like -M
126 // init global variables
130 opts
= getopt32(argv
, "^"
131 "bdmVcasTkt:+" "R:+Z:L:+H:+" IF_FEATURE_POPMAILDIR_DELIVERY("M:F:")
133 &G
.timeout
, NULL
, NULL
, NULL
, &opt_nlines
134 IF_FEATURE_POPMAILDIR_DELIVERY(, &delivery
, &delivery
) // we treat -M and -F the same
141 get_cred_or_die(STDIN_FILENO
);
146 // launch connect helper, if any
148 launch_helper((const char **)argv
);
150 // get server greeting
151 pop3_checkr(NULL
, NULL
, &buf
);
153 // authenticate (if no -s given)
154 if (!(opts
& OPT_s
)) {
155 // server supports APOP and we want it?
156 if ('<' == buf
[0] && (opts
& OPT_a
)) {
157 union { // save a bit of stack
159 char hex
[16 * 2 + 1];
161 uint32_t res
[MD5_OUTSIZE
/ 4];
163 char *s
= strchr(buf
, '>');
166 // get md5 sum of "<stamp>password" string
168 md5_hash(&md5
.ctx
, buf
, strlen(buf
));
169 md5_hash(&md5
.ctx
, G
.pass
, strlen(G
.pass
));
170 md5_end(&md5
.ctx
, res
);
171 *bin2hex(md5
.hex
, (char*)res
, 16) = '\0';
173 s
= xasprintf("%s %s", G
.user
, md5
.hex
);
174 pop3_check("APOP %s", s
);
177 // server ignores APOP -> use simple text authentication
180 pop3_check("USER %s", G
.user
);
182 pop3_check("PASS %s", G
.pass
);
186 // get mailbox statistics
187 pop3_checkr("STAT", NULL
, &buf
);
189 // prepare message filename suffix
190 hostname
= safe_gethostname();
193 // get messages counter
194 // NOTE: we don't use xatou(buf) since buf is "nmsg nbytes"
195 // we only need nmsg and atoi is just exactly what we need
196 // if atoi fails to convert buf into number it returns 0
197 // in this case the following loop simply will not be executed
201 // loop through messages
202 retr
= (opts
& OPT_T
) ? xasprintf("TOP %%u %u", opt_nlines
) : "RETR %u";
203 for (; nmsg
; nmsg
--) {
209 #if ENABLE_FEATURE_POPMAILDIR_DELIVERY
212 // generate unique filename
213 filename
= xasprintf("tmp/%llu.%u.%s",
214 monotonic_us(), (unsigned)pid
, hostname
);
216 // retrieve message in ./tmp/ unless filter is specified
217 pop3_check(retr
, (const char *)(ptrdiff_t)nmsg
);
219 #if ENABLE_FEATURE_POPMAILDIR_DELIVERY
220 // delivery helper ordered? -> setup pipe
221 if (opts
& (OPT_F
|OPT_M
)) {
222 // helper will have $FILENAME set to filename
223 xsetenv("FILENAME", filename
);
224 fp
= popen(delivery
, "w");
225 unsetenv("FILENAME");
227 bb_simple_perror_msg("delivery helper");
232 // create and open file filename
233 fp
= xfopen_for_write(filename
);
235 // copy stdin to fp (either filename or delivery helper)
236 while ((answer
= xmalloc_fgets_str(stdin
, "\r\n")) != NULL
) {
238 if ('.' == answer
[0]) {
239 if ('.' == answer
[1])
241 else if ('\r' == answer
[1] && '\n' == answer
[2] && '\0' == answer
[3])
244 //*strchrnul(s, '\r') = '\n';
249 #if ENABLE_FEATURE_POPMAILDIR_DELIVERY
250 // analyse delivery status
251 if (opts
& (OPT_F
|OPT_M
)) {
253 if (99 == rc
) // 99 means bail out
255 // if (rc) // !0 means skip to the next message
257 // // 0 means continue
264 // delete message from server
266 pop3_check("DELE %u", (const char*)(ptrdiff_t)nmsg
);
268 // atomically move message to ./new/
269 target
= xstrdup(filename
);
270 memcpy(target
, "new", 3);
271 // ... or just stop receiving on failure
272 if (rename_or_warn(filename
, target
))
276 #if ENABLE_FEATURE_POPMAILDIR_DELIVERY
283 pop3_check("QUIT", NULL
);
285 if (ENABLE_FEATURE_CLEAN_UP
) {