X-Git-Url: http://pileus.org/git/?a=blobdiff_plain;f=README;h=f64c7ab1b3d4038faddbf4b881abcee5a2ee7fea;hb=f78031293074cfd648a4f5453727a687d6886490;hp=0003b720f890fbf2b097284f281aad7eec87c1aa;hpb=d6a67a06f1ce5d683abd018087131507998c8a53;p=~andy%2Ffetchmail diff --git a/README b/README index 0003b720..f64c7ab1 100644 --- a/README +++ b/README @@ -1,35 +1,62 @@ - README for popclient +fetchmail README +================ -popclient is a full-featured, robust, well-documented POP2, POP3, APOP, -and IMAP client originally developed by Carl Harris and -now maintained by Eric S. Raymond . +Introduction +------------ -popclient was developed under Linux and should be readily portable to other -UNIX systems (it uses GNU autoconf). It has also been ported to QNX; to build -under QNX, see the header commets in the Makefile. +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). -You can find the latest version of popclient from Eric's home page +Fetchmail supports all standard mail-retrieval protocols in use on the +Internet: POP3 (including some variants such as APOP, KPOP), IMAP4rev1 +(also IMAP4, IMAP2bis), IMAP4, ETRN, and ODMR. On the output side, +fetchmail supports ESMTP/SMTP, LMTP, and invocation of a local delivery agent. - http://www.ccil.org/~esr +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. -Features of popclient include: +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.3's +default behaviour is more relaxed than dictated by the standard - add options +such as --sslcertck to tighten certificate checking. - * POP2, POP3, APOP, RPOP and IMAP support with auto-probing for a - server on the host if no protocol is specified. +Portability +----------- - * Easy configuration via command line or free-format .poprc file. +The fetchmail code was developed under Linux, but has also been tested under +Cygwin, FreeBSD, NetBSD, Solaris. It should be readily portable to other IEEE +Std 1003.1 (2001 or later) compliant operating systems. - * Daemon mode -- popmail can be run in background to poll - one or more hosts at a specified interval. +Further reading +--------------- - * Delivery via either file-append with mandatory locking or an - MDA you specify, or via SMTP to the client machine's port 25. +The INSTALL file describes how to configure and install fetchmail. - * From:, To:, Cc:, and Reply-To: headers are rewritten so that - usernames relative to the popclient host become fully-qualified - Internet addresses. This enables replies to work correctly. +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. -There is a man page at popclient.man. A sample rc file is at sample.poprc. -For a release history, see the file NEWS. - -- esr +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 sendmail). + +You can get the code from the fetchmail home page: + + http://www.fetchmail.info/ + + http://fetchmail.berlios.de/ + +Enjoy! + + -- esr, ma