aboutsummaryrefslogtreecommitdiffstats
path: root/README
blob: 9f31303e9827b3fa66b652e03f1db8dbc3b7ed1b (plain)
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
			 fetchmail README

Fetchmail is a free, full-featured, robust, well-documented remote
mail retrieval and forwarding utility intended to be used over
on-demand TCP/IP links (such as SLIP or PPP connections).  It
retrieves mail from remote mail servers and forwards it to your local
(client) machine's delivery system, so it can then be be read by
normal mail user agents such as elm(1) or Mail(1).

Fetchmail supports all standard mail-retrieval protocols in use on the
Internet: POP2, POP3, RPOP, APOP, KPOP, IMAP2bis, IMAP4, IMAP4rev1
ESMTP ETRN, and ODMR.  Fetchmail also fully supports authentication
via GSSAPI, Kerberos 4 and 5, RFC1938 one-time passwords, Compuserve's
POP3 with RPA, Microsoft's NTLM, Demon Internet's SDPS, or CRAM-MD5
authentication a la RFC2195.  Fetchmail also supports end-to-end
encryption with OpenSSL.

The fetchmail code was developed under Linux, but has also been
extensively tested under the BSD variants, AIX, HP-UX versions 9 and
10, SunOS, Solaris, NEXTSTEP, OSF 3.2, IRIX, and Rhapsody.

It should be readily portable to other Unix variants (it uses GNU
autoconf).  It has been ported to LynxOS and BeOS and will build there
without special action.  It has also been ported to QNX; to build
under QNX, see the header comments in the Makefile.  It is reported to
build and run under AmigaOS.

See the distribution files FEATURES for a full list of features, NEWS
for detailed information on recent changes, NOTES for design notes, and
TODO for a list of things that still need doing.

The fetchmail code appears to be stable and free of bugs affecting
normal operation (that is, retrieving from POP3 or IMAP in single-drop
mode and forwarding via SMTP to sendmail).  It will probably undergo
substantial change only if and when support for a new retrieval
protocol or authentication mode is added.

If you want to hack on this code, a list of known bugs and to-do items
can be found in the file todo.html.

You can get the code from the fetchmail home page:

	http://www.catb.org/~esr/fetchmail

Enjoy!

							-- esr
68346 /etc/init.d/fetchmail try-restart doesn't work FDBK 3 #294547 fetchmail: has to be manually restarted after a while NOTE: appears to be regular network problem? but might also be a FD leak (check lsof?) FDBK 3 #314509 fetchmail: lost mail, or only calculation error? Perhaps the server cannot count. NOTE: need to review if this causes buffer overrun problems. FDBK 3 #223933 fetchmail: should ignore mails that are stuck on a server FDBK 4 #276044 /etc/default/fetchmail lying around looking important Probably debian-specific INVA 3 #155827 fetchmail: transposes Delivered-To header no evidence this is a fetchmail bug. INVA 3 #224564 fetchmail: passes from address [envelope!] with spaces to MTA reporter has single quotes in the MDA option. INVA 3 #222510 --configdump doesn't work while daemon is running INVA 3 #213805 --configdump doesn't work while daemon is running problem is Debian-specific INVA 3 #317093 fetchmail: does not delete downloaded messages before finishing downloading everything Probably a misunderstanding of POP3 protocol INVA 4 #250253 Error message "Query status=24" is meaningless (insufficient information, not reproducible) ---------------------------------------------------------------------------