X-Git-Url: http://pileus.org/git/?a=blobdiff_plain;f=README;h=f64c7ab1b3d4038faddbf4b881abcee5a2ee7fea;hb=98cfcef26048bba06975e68a1aad05a8bac0d65d;hp=c2894ba9e7fd7fe4ec7f62ad8ece2c015eb7b305;hpb=d98d211d8b8832c01d8ccccb501fd419b8f430e1;p=~andy%2Ffetchmail diff --git a/README b/README index c2894ba9..f64c7ab1 100644 --- a/README +++ b/README @@ -1,159 +1,62 @@ -Popclient README +fetchmail README +================ - $Log: README,v $ - Revision 1.2 1996/06/26 19:08:55 esr - This is what I sent Harris. +Introduction +------------ - Revision 1.1 1996/06/26 15:27:06 esr - Initial revision +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). - Revision 1.3 1995/09/07 22:40:58 ceharris - Final 3.0b4 release +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. - Revision 1.2 1995/08/09 01:22:47 ceharris - Final preparation for 3.0b2 release. +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. - Revision 1.1 1995/08/07 21:09:19 ceharris - Final preparation for popclient 3.0b1 release +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. -This is a BETA release of popclient version 3. Little if any user support -is provided for this version of popclient. Consider this BETA version to -be a "developer/tester" release only. +Portability +----------- -Release History +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. -3.0b7: +Further reading +--------------- -Eric S. Raymond hacked on 3.0b6. Here are his change notes: +The INSTALL file describes how to configure and install fetchmail. -CONFIGURATION AND BUILDING +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. -* The autoconfigure script incorrectly assumed that all Linuxes use - /usr/bin/deliver. Under Linux it now checks for both /usr/bin/delivermail - and /bin/mail. +Status, source code +------------------- -* I added a distribution-maker production to Makefile.in. +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). -OPTIONS AND COMMAND LINE +You can get the code from the fetchmail home page: -* I have removed the -p command-line option. Given that there's a .poprc - facility there is no excuse for encouraging users to put plaintext passwords - in scripts which might be readable. + http://www.fetchmail.info/ -* Calling popclient with no arguments now causes it to query or operate - on every host in the .poprc file. + http://fetchmail.berlios.de/ -* I have made --version more useful by having it dump the computed - connection options for each server specified. +Enjoy! -* The user can now explicitly set an MDA (such as procmail) with the - new option -m or -mda. Various possible MDAs are listed on the man page. + -- esr, ma -POPRC FILE SYNTAX - -* The .poprc lexer now supports "-enclosed strings which may contain - whitespace. - -* I added a --yydebug option to enable .poprc parser debugging at runtime - if the parser was generated with --debug. It's not documented. - -* You may now have a `defaults' entry in .poprc which sets overrideable - values for other entries. See the man page for details. - -* It is now possible to set keep, flush and fetchall in your .poprc file. - -* Fixed incorrect numbering of source lines in .poprc parse error messages. - -* The configure.in specification no longer uses the obsolete AC_TRY_COMPILE - macro (it uses AC_TRY_LINK instead). - -MAILBOX LOCKING - -* I have added mandatory locking of mailbox files where supported. - This will cover Linux systems, in particular. - -* The default behavior is now to do lock-protected append on the user's - system mailbox rather than using delivermail or some other MDA. - (This is a performance hack.) - -* The autoconfigure script now looks for standard mail locations. The - default mail delivery agent is used only if it can't find a mail spool - directory in the standard places. - -FUNCTIONAL ENHANCEMENTS - -* When using POP3, message headers are edited so that replies won't foo up. - Anything that looks like a mail ID local to the POP host gets @ and the - pop servername attached to it before being appended to the user's - mailbox or passed to an MDA. - -* I have implemented daemon mode. - -DOCUMENTATION - -* All changes and feature additions have been tested in actual use and are - documented on the man page. - -* I have turned the comments in the sample.poprc into a new manual - section documenting the .poprc format. - -MISCELLANEOUS BUG FIXES - -* I fixed some de-initialization bugs in pop2.c and pop3.c that led to - fd leaks (these became painfully obvious when I tested daemon mode!). - -* I've fixed the flaky parser error messages. They turned out to be due - to a misdeclaration of yytext. - -There's only one feature I haven't been able to add successfully. I -want a --logfile option that redirects the daemon-mode output to a -given file, but the code (in daemon.c near 200) unaccountably doesn't -work (so I haven't documented it yet). - -3.0b5 -o "From " header fix in pop2.c and pop3.c -o Surpress "..." output when --stdout option specified in pop3.c - -3.0b4 -o alloca fix. -o various diagnostic/informational message fixes. - -3.0b3 -o Support for retrieving only new messages from maildrop when - using POP3. -o Support for retrieving only the first n lines of each message - when using POP3. -o APOP authentication support. -o Buffered socket input. - -3.0b2 - This is a "new features" release. -o support for .poprc file. -o GNU-style long options. -o fixed passwords appearing in 'ps' output -o support for multiple servers on one command line - -3.0b1 - This is mostly a test of the autoconfigure integration. -Among the functions performed by the new configure script, is -the ability to detect known system types, configures the mail -delivery agent (MDA) correctly. This should permanently solve -the problem of using something other than an MDA for mail -delivery (which continues to plague Linux slackware 1.2.9). -For this beta, please check the values of MDA_PATH and MDA_ARGS -carefully. They should match the values found in your -sendmail.cf file on the line which begins with "Mlocal". - - Other changes from popclient version 2.21: - -o no longer uses getpass() from the C library. The - internal getpassword() function allows the use of long - passwords. - -o integrated GNU getopt() for long options. Long option - names will appear in a future beta. - -o Several compiler warnings fixed. - -o Fixed problems related to missing include files in - Solaris port.