diff options
| -rw-r--r-- | README | 172 | ||||
| -rw-r--r-- | sample.rcfile | 51 |
2 files changed, 28 insertions, 195 deletions
@@ -1,166 +1,26 @@ -Popclient README + README for popclient 3.0 - $Log: README,v $ - Revision 1.3 1996/06/27 19:22:31 esr - Sent to ceharris. +popclient is a full-featured, robust, well-documented POP2, POP3 and +APOP client originally developed by Carl Harris <ceharris@mal.com> and +now maintained by Eric S. Raymond <esr@thyrsus.com>. - Revision 1.2 1996/06/26 19:08:55 esr - This is what I sent Harris. +You can find the latest version of popclient from Eric's home page - Revision 1.1 1996/06/26 15:27:06 esr - Initial revision + http://www.ccil.org/~esr - Revision 1.3 1995/09/07 22:40:58 ceharris - Final 3.0b4 release +Features of POP include: - Revision 1.2 1995/08/09 01:22:47 ceharris - Final preparation for 3.0b2 release. + * POP2, POP3 and APOP support - Revision 1.1 1995/08/07 21:09:19 ceharris - Final preparation for popclient 3.0b1 release + * Easy configuration via command line or free-format .poprc file. -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. + * Daemon mode -- popmail can be run in background to poll + one or more hosts at a specified interval. -Release History + * Delivery via either file-append with mandatory locking or an + MDA you specify. -3.0b7: +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 -Eric S. Raymond <esr@thyrsus.com> hacked on 3.0b6. Here are his change notes: - -CONFIGURATION AND BUILDING - -* 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. - -* I added a distribution-maker production to Makefile.in. - -OPTIONS AND COMMAND LINE - -* 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. - -* Calling popclient with no arguments now causes it to query or operate - on every host in the .poprc file. - -* I have made --version more useful by having it dump the computed - connection options for each server specified. - -* 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. - -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. - -* I have added a lock check to ensure that there is only one popclient - running per user, and a --quit option to kill the currently running - one. - -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. diff --git a/sample.rcfile b/sample.rcfile index a6973156..99c13172 100644 --- a/sample.rcfile +++ b/sample.rcfile @@ -1,47 +1,16 @@ # .poprc sample # -# $Log: sample.rcfile,v $ -# Revision 1.2 1996/06/26 19:09:01 esr -# This is what I sent Harris. -# -# Revision 1.1 1996/06/25 16:50:31 esr -# Initial revision -# -# Revision 1.2 1995/08/10 00:32:46 ceharris -# Preparation for 3.0b3 beta release: -# - added code for --kill/--keep, --limit, --protocol, --flush -# options; --pop2 and --pop3 options now obsoleted by --protocol. -# - added support for APOP authentication, including --with-APOP -# argument for configure. -# - provisional and broken support for RPOP -# - added buffering to SockGets and SockRead functions. -# - fixed problem of command-line options not being correctly -# carried into the merged options record. -# -# Revision 1.1 1995/08/09 01:33:04 ceharris -# Version 3.0 beta 2 release. -# Added -# - .poprc functionality -# - GNU long options -# - multiple servers on the command line. -# Fixed -# - Passwords showing up in ps output. -# -# # This file (or one of your own creation, rather) should be located # in your home directory with the name .poprc. Permissions on this # file may be no greater than -rw-------, or popclient will refuse to # use it. # -# I'd like to point out here that I do not, repeat DO NOT, endorse -# the use of plaintext passwords in the .poprc file. I include the -# password option because SO MANY people asked me about having such -# an option. I don't use it myself. And I recommend that you don't -# use it. +# To see what effect your ~/.poprc file has, do # -# I'd also like to point out that the syntax of this file is still -# under development (during the 3.0 beta series of releases). If you -# would like to suggest revisions, please do. +# popclient --version +# +# This will display the popclient version number and an explanation +# in English of what the currently set options and defaults mean. # # Comments begin with a '#' and extend through the end of the line. # Blank lines between server entries are ignored. @@ -72,13 +41,17 @@ # rpop (or RPOP) # # Basic format is -server SERVERNAME protocol PROTOCOL username NAME password PASSWORD -# Example +# server SERVERNAME protocol PROTOCOL username NAME password PASSWORD +# Example: +# server pop.provider.net protocol pop3 username jsmith password secret1 -# Or, using some abbreviations + +# Or, using some abbreviations: +# server pop.provider.net proto pop3 user jsmith password secret1 # Multiple servers may be listed +# server pop.provider.net proto pop3 user jsmith password secret1 server other.provider.net proto pop2 user John.Smith password My^Hat |