fetchmail  6.4.13-rc2
About: Fetchmail is a full-featured, remote-mail retrieval and forwarding utility. It supports POP2, POP3, RPOP, APOP, KPOP, all flavors of IMAP, ETRN, ODMR, and even IPv6 and IPSEC. Release candidate.
  Fossies Dox: fetchmail-6.4.13-rc2.tar.xz  ("unofficial" and yet experimental doxygen-generated source code documentation)  

fetchmail Documentation

Some Fossies usage hints in advance:

  1. To see the Doxygen generated documentation please click on one of the items in the steelblue colored "quick index" bar above or use the side panel at the left which displays a hierarchical tree-like index structure and is adjustable in width.
  2. If you want to search for something by keyword rather than browse for it you can use the client side search facility (using Javascript and DHTML) that provides live searching, i.e. the search results are presented and adapted as you type in the Search input field at the top right.
  3. Doxygen doesn't incorporate all member files but just a definable subset (basically the main project source code files that are written in a supported language). So to search and browse all member files you may visit the Fossies
  4. fetchmail-6.4.13-rc2.tar.xz contents page and use the Fossies standard member browsing features (also with source code highlighting and additionally with optional code folding).
README
fetchmail README
================

Introduction
------------

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 mutt(1), elm(1) or 
Mail(1).

Fetchmail supports all standard mail-retrieval protocols in use on the 
Internet: POP3 (including some variants such as RPOP, APOP, KPOP), IMAP4rev1 
(also IMAP4, IMAP2bis), POP2, IMAP4, ETRN, and ODMR. On the output side, 
fetchmail supports ESMTP/SMTP, LMTP, and invocation of a local delivery agent.

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 supports end-to-end encryption with OpenSSL, do read README.SSL for 
details on fetchmail's configuration and README.SSL-SERVER for server-side 
requirements.  NOTE! To be compatible with earlier releases, fetchmail 6.4
default behaviour is more relaxed than dictated by recommendations - while it
does away with SSLv2, only negotiates SSLv3 if forced to, it will by default
still negotiate TLS v1.0.

Portability
-----------

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 once upon a time.

The current maintainer does not have access to these systems, and assumes that
the system is at least Single-Unix-Specification V2 compatible, yet fetchmail
should be compilable by a C89 compiler. It currently ships with a copy of the
trio library for systems that lack snprintf(). A further requirement is that
either realpath() permits its 2nd argument to be NULL for auto-allocation,
or that otherwise PATH_MAX be defined.

Fetchmail should be able to be compiled with C89, C99, C11, C++98, C++03,
C++11, C++14 compilers, but not C++17 because the "register" keyword is
used in some parts of the code.

Future fetchmail releases will require modern language features such as
"long long" and others, so this release is the last to support C89.

Further reading
---------------

The INSTALL file describes how to configure and install fetchmail.

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.  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.

Status, source code
-------------------

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 a local mail transfer agent).

You can get the code from the fetchmail home page:

	https://www.fetchmail.info/
	https://fetchmail.sourceforge.io/

Enjoy!

							-- esr, ma