home *** CD-ROM | disk | FTP | other *** search
/ ftp.qualcomm.com / 2014.06.ftp.qualcomm.com.tar / ftp.qualcomm.com / eudora / servers / unix / popper / Release.Notes < prev   
Text File  |  2011-05-31  |  44KB  |  980 lines
  1. Release.Notes
  2.  
  3.    Last updated: 22 June 2008
  4.  
  5.    Copyright (c) 2011 QUALCOMM Incorporated.  All rights reserved.
  6.  
  7.  
  8. Features:
  9.  
  10.     These are features which have been added to the standard Berkeley
  11.     popper since the '91 release:
  12.  
  13.      1) Popper idle timeout (UIUC 1.831)
  14.      2) Bulletin board (2.0)
  15.      3) Statistics gathering (2.0)
  16.      4) xlst command (eXtended LiST) (2.0)
  17.      5) uidl command (Unique IDentifier List) (2.1.1)
  18.      6) Kerberos IV (2.1.2) and V (3.1)
  19.      7) Shadow passwords (2.1.1)
  20.      8) rpop (uses /etc/hosts.equiv and .rhosts.  Not recommended) (2.1.2)
  21.      9) Popper authorization file (2.1.2)
  22.     10) Sending mail via POP is now logged to mail debug (2.1.2)
  23.     11) MMDF handling (autodetect) (2.1.4)
  24.     12) 'Content-Length:' header processing (2.1.4)
  25.     13) APOP authentication (2.1.4-r4)
  26.     14) Large site support -- Server mode (2.2)
  27.     15) Database for bulletin tracking (2.2)
  28.     16) Kerberos enabling choice by a switch (2.2)
  29.     17) Configure Script to ease installation (2.4)
  30.     18) POP Extensions and Response Codes to server (CAPA) (3.0)
  31.     19) X-Mangle support for lightweight clients (3.0)
  32.     20) PAM support (3.0)
  33.     21) Timing reported in log (3.1)
  34.     22) DRAC support (3.1)
  35.     23) Server mode can be set on a per-user basis, using group
  36.         membership and/or user options file (3.1)
  37.     24) Run-time options can be read from a file (3.1)
  38.     25) Per-user run-time options file (3.1)
  39.     26) Stand-alone daemon mode (3.1)
  40.     27) TLS/SSL security (4.0)
  41.     28) Enhanced performance (4.0)
  42.     29) Most compile-time options now available at run-time (4.0)
  43.     30) Integrated poppassd into build (4.0)
  44.     31) Support Cyrus SASL libraries (4.1)
  45.     32) Initial Cygwin support (4.1)
  46.     33) Ability to execute arbitrary programs when users log in (4.1)
  47.     34) Initial Sieve support (4.1)
  48.     35) IPv6 support (4.1)
  49.  
  50.     This popper diverges from the POP standard in that the timeout can
  51.     be set to less than 10 minutes.  Practically, I have found that a
  52.     timeout of 30 seconds seems to be adequate for most circumstances.
  53.     It needs to be a little greater for 2400 baud ppp/slip connections.
  54.     The default value is 2 minutes (RFC 1939 says this must be at least
  55.     10 minutes).  This timer is used to cleanup an aborted connection.
  56.     A short timeout allows the user to reconnect without getting that 
  57.     pesky little error which states that the pop drop file is already 
  58.     locked.  Otherwise the admin will get a phone call, walk the user
  59.     through the connection, and (since by now the timer has expired) find
  60.     everything works.  Frustrating for both admin and user.  On the minus
  61.     side, if the client takes too long to respond, the connection will be
  62.     dropped prematurely.  The timeout choice is yours.
  63.  
  64.  
  65. Release Notes:
  66.  
  67. 4.1
  68.            Support Cyrus SASL libraries.
  69.            '--with-cyrus-sasl' added to ./configure.
  70.            'sasl-log-login', 'sasl-min-ssf', 'sasl-max-ssf', 
  71.         'sasl-no-plaintext', 'sasl-no-active', 'sasl-no-dictionary',
  72.         'sasl-forward-secrecy', and 'sasl-no-anonymous' run-time
  73.         options added.
  74.            Initial Cygwin support
  75.            Ability to execute arbitrary programs when users log in
  76.            'ext-postauth-cmd' run-time option added,
  77.            Initial Sieve support.
  78.             Support IPv6.
  79.             '--disable-ipv6' added to ./configure.
  80.             Entire configuration file is now processed and
  81.         all errors reported in one pass.
  82.             Cache file now used even if new arrived since last session,
  83.         unless new "conservative-cache" configuration option is set.
  84.  
  85. 4.0
  86.            Supports TLS/SSL security.
  87.            '-p' option now has value '4' to permit plain-text passwords
  88.         under TLS/SSL.
  89.            Now uses a cache file to retain spool index across sessions.
  90.         This dramatically speeds up session start when no new mail has
  91.         arrived.
  92.            
  93.            '-l' option added to specify TLS/SSL support.
  94.            Lots of TLS/SSL options added.  See the Administrator's Guide
  95.         for details.
  96.            '-v' option added to report current version and exit.
  97.            'make install' added.
  98.            Lots of compile-time options now available at run-time.  See
  99.         the Administrator's Guide for details.
  100.            Integrated poppassd into build.
  101.            Must explicitly 'set xtnd_xmit' to allow XTND XMIT.
  102.  
  103. 3.1
  104.            Can now set server mode and kerberos service name using
  105.         run-time options.
  106.            Can now specify plain-text password handling when APOP is
  107.         available using '-p 0|1|2|3' run-time option. 0 is default;
  108.         1 means clear text passwords are never permitted for any user;
  109.         2 means they are always permitted (even if an APOP entry exists),
  110.         which allows them to be used as a fallback when clients don't
  111.         support APOP); 3 means they are permitted on the local interface
  112.         (127.*.*.*) only.
  113.            Added '-D drac-host' run-time option to specify the drac host.
  114.         Only valid if compiled with --enable-drac.  The default is
  115.         localhost.
  116.            Added '-f config-file' run-time option.  Additional run-time
  117.         options are read from the specified file.  All current run-time
  118.         options can now be set this way.  See INSTALL file for option
  119.         names and syntax.
  120.            Added '-u' run-time option to read '.qpopper-options' file in
  121.         user's home directory.
  122.            Added Kerberos V support.
  123.            BULLDB access now uses usleep(3C) if available, resulting in
  124.         many more access attempts with a shorter maximum delay.
  125.            Added run-time options 'bulldb-nonfatal' (-B) and
  126.         'bulldb-max-retries' to allow fine control over BULLDB access
  127.         behavior.  'bulldb-nonfatal' allows a session to continue if
  128.         the bulletin database can't be locked.  'bulldb-max-retries'
  129.         sets the maximum number of attempts to lock the database.  This
  130.         value should only be changed if you know if your system has
  131.         usleep(3C) or not.  On systems with usleep(3C), this can be a
  132.         large value (the default is 75).  On systems without usleep(3C),
  133.         this should remain small (the default is 10).
  134.            Added new ./configure flags (see INSTALL for more details): 
  135.               --enable-timing to write log records with elapsed time for
  136.                    authentication, initialization, and cleanup.
  137.               --enable-old-uidl to generates UIDs using old (pre-3.x)
  138.                    style encoding.  This is only useful if you also set
  139.                    NO_STATUS and have existing users with old (pre-3.x)
  140.                    spool files and you want to keep the UIDs the same.
  141.               --disable-status to prevent Qpopper from writing 'Status'
  142.                    or 'X-UIDL' headers (sets NO_STATUS).  This forces
  143.                    UIDs for each message to be recalculated in each
  144.                    session.
  145.               --enable-keep-temp-drop to prevents Qpopper from deleting
  146.                    the temp drop files.
  147.               --disable-check-pw-max to prevent Qpopper from checking
  148.                    for expired passwords.
  149.               --disable-old-spool-loc to not check for old .user.pop
  150.                    files in old locations when HASH_SPOOL or HOMEDIRMAIL
  151.                    used.
  152.               --disable-check-hash-dir to not check for or create hash
  153.                    spool directories.  Use this if you pre-create the
  154.                    directories.
  155.               --enable-server-mode-group-include=group to set server
  156.                    mode for users in the specified group.
  157.               --enable-server-mode-group-exclude=group to set server
  158.                    mode OFF for users in the specified group.
  159.               --enable-secure-nis-plus for use with secure NIS+.
  160.               --disable-optimizations to turn off compiler optimizations.
  161.               --with-kerberos5 for Kerberos V support (using patch from
  162.                    Ken Hornstein).
  163.               --enable-any-kerberos-principal to accept any principal in
  164.                    the client request.
  165.               --enable-kuserok to use kuserok() to vet users.
  166.               --enable-ksockinst to use getsockinst() for Kerberos 
  167.                    instance.
  168.               --enable-standalone to create standalone POP daemon instead
  169.                    of being run out of inetd.  Can specify IP address
  170.                    and/or port number to bind to as parameter 1, e.g.,
  171.                    'popper 199.46.50.7:8110 -S' or 'popper 8110 -S -T600'.
  172.                    If not specified, IP address defaults to all available.
  173.                    The default port is 110 except when _DEBUG (not simply
  174.                    DEBUG) is defined, then it is 8765.
  175.               --enable-auth-file=path to permit access only to users listed
  176.                    in the specified file.  Format is one user per line.
  177.               --enable-nonauth-file=path to deny access to users listed in
  178.                    the specified file.  Format is one user per line.
  179.               --disable-update-abort to avoid the default behavior of going
  180.                     into update mode if the session aborts (the default
  181.                     behavior violates of RFC 1939, but was found to be
  182.                     needed when noisy dialup lines otherwise prevented users
  183.                     from ever deleting messages).
  184.                                             ([RCG])
  185.  
  186. 3.0
  187.            Both dot-locking and flock() now used on all platforms.  (On some
  188.         systems we emulate flock() using fcntl).
  189.            Added POP3 extensions(CAPA). The extensions added so far are 
  190.         X-MANGLE, LOGIN-DELAY and EXPIRE. 
  191.            X-MANGLE condenses Mime messages into a single part for ease of 
  192.         use by lightweight clients. The transformations supported through 
  193.         X-MANGLE are to and from text/plain, format=flowed, and text/html.
  194.            As a way to enable MIME-mangling with clients that do not 
  195.         support XMANGLE, add "-no-mime" to the user name.  For example, 
  196.         if the userid is"mary", enter it in the client as "mary-no-mime".
  197.            The optional LOGIN-DELAY and EXPIRE values are only announced
  198.         through the CAPA command.  The values to announce are passed as
  199.         command line switches.  Actual enforcement of minimum login delay 
  200.         and message expiration is up to the site by some other means. 
  201.         (For example, a simple script run from crontab could be used for
  202.         message expiration.)  Qpopper does support automatic deletion of
  203.         downloaded messages through the --enable-auto-delete configure
  204.         flag.  This can be used to effect EXPIRE 0 (no retention).
  205.            Added new run-time options: -R to disable reverse-lookups on client
  206.         IP addresses; -c to downcase user name.
  207.            A failure at some point in a transaction now releases all locks 
  208.         explicitly. Certain paths do not release locks where SysV .lock files
  209.         are created. 
  210.            Fixed bugs with Bulletin Services and Server mode.
  211.            DEBUGn macros for debug and trace messages.
  212.            Added new ./configure flags (see INSTALL for more details): 
  213.               --with-warnings for extra compiler warnings. 
  214.               --enable-shy to hide qpopper's version number in the
  215.                     banner and CAPA IMPLEMENTATION tag.
  216.               --enable-auto-delete to automatically mark for deletion
  217.                     all messages downloaded with RETR. 
  218.               --enable-hash-spool=1|2 to use hashed spool directories.
  219.               --enable-home-dir-mail=file to use a spool file in the
  220.                    user's home directory.
  221.               --enable-bulldb=path to enable bulletins and set the path
  222.                    for the bulletin directory.
  223.               --with-new-bulls=number to specify the maximum number 
  224.                    of bulletins for new users (default is 10).
  225.               --enable-popbulldir=path to specify an alternate location
  226.                     for users' popbull files.
  227.               --enable-log-login to log successful user logins.  This 
  228.                    can be used, for example, to validate subsequent 
  229.                    SMTP sessions from the same IP address within a 
  230.                    short time period, in the absence of SMTP AUTH 
  231.                    support by client and server. (Suggested by Andy 
  232.                    Harper et al).
  233.               --with-pam=service-name to authenticate using PAM (based 
  234.                     on patch contributed by German Poo).
  235.               --with-log-facility=name to specify the log facility.
  236.                     Default is LOG_LOCAL1 or LOG_MAIL, depending on the
  237.                     OS.
  238.               --enable-uw-kludge to check for and hide a UW IMAP status
  239.                     message.
  240.               --enable-group-bulls to show bulletins by groups (group
  241.                     name is second element in bulletin name).  Based on
  242.                     patch by Mikolaj Rydzewski.
  243.               --enable-timing to report timing information in the log.
  244.               --enable-drac to use DRAC.  Based on patches by Mike 
  245.                     McHenry, Forrest Aldrich, Steven Champeon, and others.
  246.            Added file popper/banner.h -- modify this file to add a custom 
  247.         banner and CAPA IMPLEMENTATION tag suffix.  Note that if you modify 
  248.         qpopper you should indicate this using banner.h.
  249.            Improved error messages and warnings: warning "Unable to get 
  250.         canonical name of client" now includes IP address of client; logging
  251.         added for I/O errors and discarded input (line too long); added errno
  252.         to POP EOF -ERR message; "Possible probe of account" warning now logged
  253.         as WARNING, not CRITICAL.
  254.  
  255.                                             ([LGL], [PY], [RCG])
  256. 2.4
  257.           Added configure script. Running configure script generates the Makefile
  258.         for the platform. 
  259.           Added timeout for the the xtnd xmit command. Now the information for 
  260.         xtnd xmit command is read from the same read statement as any other 
  261.         command. 
  262.                                             ([PY])
  263. 2.3
  264.         Fixed the bug with NOUPDATEONABORT. Now if the connection aborts with
  265.         the client the messages in temporary file are copied back to original
  266.         mail drop and the temporary file is deleted.
  267.  
  268.         Added the macro GDBM, if defined will make use of GNU's DBM library.
  269.  
  270.         Fixed the bug in pop_dropcopy.c, where the process changes the UID and
  271.         GID to that of the user's, but leaves the Supplementary group IDs.
  272.  
  273.         Strictly enforcing BINMAIL_IS_SETGID for IRIX.
  274.                                             ([PY])
  275.  
  276. 2.2
  277.     Added SERVER_MODE.  This feature should only be used on systems
  278.     that do not allow users to use access their mailspools directly.
  279.  
  280.     Added several mail spool access methods.  If your site is large
  281.     and you wish to improve mail spool file access you might want to use
  282.     these.  They require modification to the local mail delivery program.
  283.     One method hashes the username into one of 26 possible directories,
  284.     the other method creates a hierarchy off the name such as /m/ma/mark.
  285.  
  286.     Added date/time and PID to tracefile lines.
  287.  
  288.     Fixed bug in message size reporting.
  289.  
  290.     Added a flag to force RFC 1725 style update on aborts.
  291.  
  292.     Added a flag to not change Status headers.
  293.  
  294.     Change the way temporary file ownership/permissions verification
  295.     was done.
  296.  
  297.     Added a fix for nulls left at the beginning of mail spools.
  298.  
  299.     Change From separator recognition to a simpler (?) macro from Mark
  300.     Crispin's c-client.
  301. /usr/local/bin/bash: w!: command not found
  302.     home directories required.
  303.  
  304.     Added checking for valid shells to enable admins to lockout users. 
  305.  
  306.     Rewrote fgets to fix a problem on some operating systems.  If a
  307.     packet of "dele 1<cr><lf>dele 2<cr><lf>..." was sent, only the first
  308.     would be read by the popper.
  309.  
  310.     LARGESITE no longer available.  Now if you want verbose logging use
  311.     DEBUG and enable messages with -b at the command line
  312.  
  313.     When Kerberos support is compiled it, it must be activated with
  314.     the -k switch.  For those who insisted on one popper for both Kerberos
  315.     and non kerberos accessing.
  316.  
  317. 2.1.4-r4 - NOT Released
  318.     Changed how the popdrop file was being created and checked.  If
  319.     the file existed it was possible to create one owned by someone else
  320.     and snoop mail.
  321.  
  322.     Removed O_APPEND from the open call of the the popdrop.  Wasn't
  323.     needed.
  324.  
  325.     Leftover code in pop_pass for SCO caused some headaches.
  326.  
  327.     Pop_pass now checks both regular and extended crypt calls for
  328.     systems that support both.
  329.  
  330.     Added APOP option.  Several users sent in code but I used the
  331.     submission from Ian Donaldson (iand@labtam.oz.au).  This code is
  332.     derived from the MH code.  I added a -delete option to popauth so
  333.     that a user entry could be removed.  I also rewrote some of it to
  334.     allow for longer passwords.  The GNU getpass() routine was added
  335.     which is enabled by a compiler flag.  Getline was not available on
  336.     Solaris 2.3 so a flag NO_GETLINE was also added.  The password
  337.     database is now permuted so that greps don't find cleartext words.
  338.  
  339.     NOTE: This verion of the popauth database is not compatible with
  340.       earlier beta versions.
  341.  
  342.     UID bug fixed.  Only a "From:" header was searched for before
  343.     X-UIDL insertion.  Now "To:" is checked for with a fallback of
  344.     inserting UID before the Status header.
  345.  
  346.     Changed the location and method of creating UID so that it is
  347.     now the first header after the message separator.
  348.  
  349.     UIDs are now created by pushing headers through MD5.  This makes
  350.     UIDs RFC complient to be consistant between sessions even if the popper
  351.     aborts.
  352.  
  353.     Somewhere a bug was introduced which caused the copyback (update)
  354.     to fail if the filesystem filled or the user was overquota.  Fixed.
  355.  
  356.     Added support for NIS+.  Your mileage may vary.  Code provided by
  357.     Andy Smith (abs@maunsell.co.uk).
  358.  
  359.     Changed where CONTENT_LENGTH was defined, now it must be added to
  360.     the build line.
  361.  
  362.     Fixed problems with building Linux, BSDi 2.x, and FreeBSD systems.
  363.  
  364.     Fixed a bug in pop_msg and pop_log.  Va_end(ap) was run prematurely.
  365.  
  366.     RSET didn't reset status fields correctly.  Fixed.
  367.  
  368.     Fixed a problem with From line separator recognition.  A blank <addr>
  369.     would cause the separator to be missed.
  370.  
  371.     X.400 addresses failed to parse correctly if they had imbedded "
  372.     characters.  Fixed.
  373.  
  374. 2.1.4-r3
  375.     Fixed a bug in UID caching.  Some messages that appeared to have
  376.     valid from lines but no received lines caused the UIDL header to not
  377.     be initialized and the cached value was undefined.  The popper would
  378.     crash if debugging was turned on or the UIDL command was issued (since
  379.     2.1.4-r2). 
  380.  
  381.     Fixed sequence problem in UIDL caching.  The cache was one more
  382.     than the actual message sequence.  This caused messages to be retrieved
  383.     twice.
  384.  
  385.     Changed the way UIDL is cached and handled to facilitate moving
  386.     of the header for old UID enabled qpopper and reduce the number of
  387.     string compares.  UILD is not inserted before the From: header.  This
  388.     feature creates a time where if the popper/system crash, the cached
  389.     (newly created) UID information will be lost.  UIDL headers which
  390.     already exist will be retained.
  391.  
  392.     Changed the internal calculation of message size to facilitate the
  393.     Content-Length: header.  Implemented Content-length processing.
  394.  
  395.     Added a define for (off_t), (gid_t), (pid_t), (uid_t), and (gid_t)
  396.     types.  Some OS's are not compiling/running well without them and most
  397.     support the types.  The default is to use these defines.  Change popper.h
  398.     if your OS does not support these types.
  399.  
  400.     Move the set_auth_parameters() call ahead of the umask() system
  401.     call and add the parameters argc, and argv.
  402.  
  403.     Swapped order of seuid & setgid so that the setgid call was first.
  404.     Setgid would fail after setuid call.
  405.  
  406.     Fixed a bug in the last command.  Deleted messages were included
  407.     as the last message retrieved.
  408.  
  409.     Changed the check of the From line from a dynamic setting to a
  410.     compiler define.  This was done to fix a bug in the way bulletins
  411.     are validated.  An improper From header was accepted causing subsequent
  412.     runs of the popper to concatenate the previous message with the bulletin.
  413.  
  414.     Fixed MMDF handling.  I implemented it wrong the first time :-(
  415.  
  416.     Added __RES checks to pop_init.
  417.  
  418.     Added support for Sequent (PTX) (w/sockets).  This isn't working
  419.     very well yet.  Help requested.
  420.     
  421.     Added support for maildrops existing in users home directories
  422.     (needed for supporting PTX and MMDF maildrops).
  423.  
  424.     Changed strcpy to strncpy in pop_user.c.
  425.  
  426.     Fixed more compile problems with OSF/1, AIX, A/UX, BSDi 2.0, IRIX,
  427.     and a few other operating systems.
  428.  
  429.     Changed the process wait code in pop_xmit to use pidwait exclusively.
  430.     Seems to work on most systems.
  431.  
  432. 2.1.4-r2
  433.     Fixed numerous (more :-[) compilation problems.
  434.  
  435.     Added UIDL caching in the message structure.  Scanning the file
  436.     took much to long.
  437.  
  438.     SunOS 4.1.x does not use 'x' when C2 shadow passwords are enabled.
  439.     The check was removed and was reported to work at several sites.
  440.  
  441.     Fixed an unreported bug in grabbing info on leftover .user.pop
  442.     files.  It use to create one large message :-(
  443.                     (Mark Erikson 4/95)
  444.  
  445. 2.1.4-r1
  446.     Fixed numerous compilation problems with AIX, OSF/1, SCO, AUX.
  447.  
  448.     Updated the INSTALL doc.
  449.  
  450. 2.1.4-b3
  451.     Fixed an error in bulletins.  UID was not implemented corectly :-(
  452.  
  453. 2.1.4-b2
  454.     Fixed compilation errors for the SCO and OSF/1 ports.
  455.  
  456.     Added password expiration for Linux.  Now Linux, Solaris, and
  457.     UnixWare check for expired passwords.
  458.  
  459.     Changed OSF/1 ifdefs in popper.c.  If you have enhance security
  460.     then you will want to define OSF1 and AUTH.  AUTH enables shadow
  461.     password checking.  Defining OSF1 and AUTH will enable the call to
  462.     set_auth_parameters().  If you do not set AUTH, then standard password
  463.     checking is done.
  464.  
  465.     Fixed a bug where a corrupted mail spool can cause popper to
  466.     expand the file.  If there is more than one "From " line in the
  467.     header, the popper got confused.  Now, the second From is used as
  468.     the start of the message and the first part of the header is tossed.
  469.  
  470.     Fixed a bug in UID handling for bulletins.
  471.  
  472.     Rewrote password routines to be more consistant with each other.
  473.  
  474. 2.1.4-b1
  475.     Added changes for a Unixware port.
  476.  
  477.     Added changes for an OSF/1 port.
  478.  
  479.     Added changes for a Linux port.
  480.  
  481.     Fixed a file locking problem.  When transfering a mail spool file
  482.     to the temp file, a reopen was issued which removed the lock from the
  483.     original file.
  484.  
  485.     Zero length files are now dealt with more efficiently.
  486.  
  487.     Added a minimum bulletin count for new users.  The value will be
  488.     subtracted from the max bulletin value.  Pretty much guarenteed to
  489.     receive at least one message, more if bulletins are in strict sequence.
  490.  
  491.     Solaris2.x handling of expired passwords.  Fixed NIS handling (I
  492.     really thought it was done correctly.  Sigh).  If you would like other
  493.     OSs to handle the expiration fields, please send me your code fragments.
  494.     I don't have the appropriate systems to do the ports myself.
  495.  
  496.     Added NIS fixes for other OS's.
  497.  
  498.     Fixed gethostbyname bug where the static area was being overwritten.
  499.  
  500.     Added MMDF handling.  As far as I know, it only requires placing a
  501.     special string before and after each message.  The default character
  502.     string that this popper recognizes is ^A (<CTL>-A).  Popper.h needs to
  503.     be modified if your string is different.  If there is something else
  504.     that needs to be done in handling MMDF files please let me know.
  505.  
  506.     Fixed total mail drop size report.
  507.  
  508.     Modified X-UIDL header insertion so that it doesn't conflict with
  509.     other mailers.  The header is now inserted after the last Received:
  510.     header.  This will cause problems with earlier versions of qpopper
  511.     since it does not check for other X-UIDL headers.  Clients already
  512.     using qpopper and UID will have all email redelivered once.
  513.  
  514.     Modified popper so that if it receives a bad username/password
  515.     it exits after a 15sec timeout.
  516.  
  517. 2.1.3-r5
  518.     Forgot to put a Status header out during a retrieve.
  519.  
  520.     Added a fix to pop bulletin code to ensure a valid value exists
  521.     in the .pop_bull file when the filesystem fills up.
  522.                     (Ray Davison ray@sfu.ca)
  523.                     (Mark Erikson 12/94)
  524.  
  525. 2.1.3-r4
  526.     Fixed a problem with UID and Unix mailers.  The UIDL header was
  527.     being appended to the header (after the Status header).  Some mail
  528.     programs didn't like this and removed the UIDL header, which caused
  529.     Leave Mail On Server to break for Eudora 2.1.
  530.  
  531.     Fixed a bug in error handling of the temporary mail file.  If
  532.     new messages were appended to the temp file but an error occured
  533.     during addition of bulletins, the temp mail file was truncated back
  534.     to the original length before new messages were added causing messages
  535.     to get tossed.          (Ray Davison ray@sfu.ca)
  536.  
  537. 2.1.3-r3
  538.     Finally got the bugs out of left over .user.pop files and the
  539.     bulletins.
  540.  
  541.     Added the last command just because I was in there and it was
  542.     easy to do.
  543.                     (Mark Erikson 11/94)
  544.  
  545. 2.1.3-r2
  546.     Almost fixed retrival of .user.pop files.  Now it works much better.
  547.  
  548.     Fixed the random addition of messages getting appended to the
  549.     maildrop.
  550.                     (Mark Erikson 11/94)
  551.  
  552. 2.1.3-r1
  553.     Fixed another nasty bug.  If the user had a .user.pop file then
  554.     it got ignored and removed.  Since this popper cleans up after itself
  555.     so well, this condition rarely, if ever, occured.
  556.  
  557.     Fixed the bulletin board feature.  In combining the info gathering
  558.     pass with the mailbox copy pass, the info was never gathered on the
  559.     added bulletins.
  560.  
  561.     Fixed a bug where copying the pop drop back to the mail spool file
  562.     did not always detect errors.  Messages could be lost.
  563.  
  564.     Added a suggested fix for a problem with resetting resolver options?
  565.     Something about crypt using gethostbyname without fully qualified domain
  566.     names?  I've never heard of this problem but I put a conditional compile
  567.     in just in case.
  568.  
  569.     Fixed a typo in pop_passwd for running shadow passwords.
  570.  
  571.     Made /usr/mail the default spool directory for IRIX.
  572.  
  573.     Reported to AIX and Ultrix.  Still have to report to OSF1.
  574.                     (Mark Erikson 11/94)
  575.  
  576. 2.1.2-r4
  577.     Fixed a nasty bug where copying the .user.pop file back to the
  578.     maildrop could cause all the messages to be removed.
  579.                     (Mark Erikson 10/94)
  580.  
  581. 2.1.2-r3
  582.     Fixed a bug introduced in logging during init.  Caused code to
  583.     coredump on startup.
  584.                     (Mark Erikson 10/94)
  585.  
  586. 2.1.2-r2
  587.     Fixed a make problem for IRIX.  Required a -cckr option (what ever
  588.     that does).
  589.  
  590.     Added user information in addition to the system info already
  591.  
  592.     Fixed a bug in pop_parse.  It left cr/lf chars after the password
  593.     string.  Removed, now works for Sunos.
  594.  
  595.     Changed the service name for Kerberos from pop to rcmd.  This makes
  596.     administering srvtab files easier by not requiring them to be changed
  597.     in order to add the popper.  (requested by Paul Pomes p-pomes@uiuc.edu)
  598.                     (Mark Erikson 10/94)
  599.  
  600. 2.1.2-r1
  601.     Added Kerberos IV option to popper.  Add -DKERBEROS to your make.OS
  602.     file if you want to build a Kerberos only popper.  Mods supplied by
  603.     Christopher Davis ckd@loiosh.kei.com.
  604.  
  605.     Added rpop.  This feature uses the host.equiv and .rhosts files
  606.     to validate a user.  This opens up a security hole since it is quite
  607.     easy to pose as another user and PC.  I do not recommend using this
  608.     feature if you have security concerns.  Enabled by defining -DRPOP
  609.     in your make.OS file.  Mods supplied by spike@world.std.com.
  610.  
  611.     Fixed a bug that does not allow spaces in the middle or end of
  612.     a password.  Mods supplied by spike@world.std.com.
  613.     
  614.     Removed HPUX make flag.  Added a bug in 2.1.1 for HPUX, removed
  615.     the bug and simply compiled a sysv version.  Seems to work well.
  616.     
  617.     Added authfile validation.  This file contains a list of users
  618.     (one each line) which have access to popper.  Enabled by defining
  619.     AUTHFILE to an authorization file in your make.OS file
  620.     (eg: -DAUTHFILE=\"/etc/authfile\").  Mods supplied by 
  621.     spike@world.std.com.
  622.  
  623.     Implemented shadow passwords for SunOS4.x.  You must define
  624.     AUTH and SUNOS4 to use this feature.  You must also make sure you
  625.     have loaded C2 security.  Mods supplied by spike@world.std.com.
  626.  
  627.     Added mkstemp (supplied by Christopoer Davis ckd@loiosh.kei.com)
  628.     to create temporary files to get around a race condition which allowed
  629.     users to break root.  Bug pointed out by bugtraq mailing list.
  630.  
  631.     Added logging to mail debug of pop xtnd xmit.  This is to allow
  632.     easier tracking of messages sent via popper.  Before, a message just
  633.     showed up in the log but no account was made from where it came.
  634.  
  635.     Fixed a bug which allowed copying of the mail spool file to a
  636.     temporary location.  The copy did not check if there was an error
  637.     (ie: File system full) so the maildrop could be lost.  Pretty nasty.
  638.     Bug discoverd by Douglas Gatchell dgg@lanl.gov.
  639.                     (Mark Erikson 9/94)
  640. 2.1.1
  641.     Ported popper to OSF, IRIX, BSDi, SCO, Ultrix, AU/X, AIX, SunOS4,
  642.     Solaris2, HPUX, Pyramid, generic SVR4, and BSD OS's.  Created a Makefile
  643.     to help the sysadmins generate the correct popper with little fuss.
  644.  
  645.     Added SIGPIP signal.  When the socket was closed but the popper
  646.     continued to send data, it core dumped.  This signal catches this.
  647.  
  648.     Added reset of signals to the signal handler.  This fixes the
  649.     SVR4 bug and does not harm BSD systems.
  650.  
  651.     Modified the popper struct to fix a system dependant parameter
  652.     for hostname length.  Several revisions of this code exist.  This
  653.     problem caused interesting mailbox names to be referenced.
  654.  
  655.     Picked up a flock code which ifdefs to the correct values depending
  656.     on your OS.  Does the right thing for BSD and SYSV systems.  Unknown
  657.     author.
  658.  
  659.     Added uidl command.  This feature gives each message a unique
  660.     identifier to help facilitate sharing of mail between several clients.
  661.     In addition to adding this command the copying and information gathering
  662.     of the maildrop were merged into a single pass which improved performance
  663.     when maildrops get large.  (Mark Erikson 8/94)
  664.  
  665. 2.0
  666.     Properly clean up on abnormal termination and rewrite the mail
  667.     drop file. The QC3 mods to catch SIGHUP signals and time out reads
  668.     were not enough. You also have to catch SIGPIPE signals to avoid
  669.     being killed when the client connection is aborted while the server
  670.     is writing (e.g., if you cancel downloading a large message in Eudora,
  671.     a common operation).
  672.  
  673.     Fixed some bad log messages.
  674.  
  675.     Added a mod from Don Lewis <gdonl@gv.ssi1.com>. Under SunOS 4.1.3,
  676.     and possibly other systems, the check for null passwords doesn't work.
  677.     QC3 checked only for a null password pointer in the struct returned by
  678.     getpwnam. You also have to check for an empty string returned by
  679.     getpwnam.
  680.  
  681.     Added a -s command line option to generate statistics messages in
  682.     the log. One message is issued for each session:
  683.  
  684.     Stats: username aaa bbb ccc ddd
  685.  
  686.     where:
  687.  
  688.     aaa = number of messages deleted. 
  689.     bbb = number of bytes deleted. 
  690.     ccc = number of messages left on server. 
  691.     ddd = number of bytes left on server.
  692.  
  693.     Added a "POP bulletin" feature. This feature gives system
  694.     administrators a way to send important announcements to all POP users
  695.     without having to do sendmail mass mailings.
  696.  
  697.     The feature is enabled via the -b command line option. This option
  698.     is followed by the path of the bulletin directory.
  699.  
  700.     The bulletin directory contains one file per bulletin. Each file
  701.     contains a complete single mail message with header and body in
  702.     mailbox format. The first line of each such bulletin must be a "From "
  703.     line. The easiest way for sysadmins to create such bulletins is to
  704.     mail themselves a copy of the bulletin (using the account to which
  705.     they want replies to be sent), then use their mail program to save the
  706.     message to a file in the bulletin directory in mailbox format. The
  707.     bulletin directory must be world readable.
  708.  
  709.     The name of each bulletin file begins with the bulletin number,
  710.     and may optionally continue with any other characters. E.g., the file
  711.     name of bulletin number 23 might be:
  712.  
  713.         23.pophost_down_sunday
  714.  
  715.     Popper creates a file named ".popbull" in the home directory of
  716.     each user. This file contains a single line recording the highest
  717.     numbered bulletin received by the user.
  718.  
  719.     Bulletins are processed by popper in pop_dropcopy.c, immediately
  720.     after copying the mail drop to the temporary mail drop, but before
  721.     building the temporary mail drop index. All bulletins which this user
  722.     has not received previously are appended to the temporary mail drop
  723.     file.
  724.  
  725.     When bulletins are copied to the temporary mail drop file, all
  726.     "To" header lines are replaced by "To: username@myhost". Any "Status:"
  727.     header lines are deleted. Otherwise, the bulletins are copied as is.
  728.  
  729.     When a new user checks for mail the first time, popper creates
  730.     the .popbull file in the user's home directory and seeds it with the
  731.     current maximum bulletin number. Thus new users do not get old
  732.     bulletins.
  733.  
  734.     All errors are logged and cause the bulletins to not be copied.
  735.     E.g., if the bulletin directory cannot be located, or the .popbull
  736.     file doesn't contain a number, or a bulletin does not begin with a
  737.     "From " line, or a bulletin name does not begin with a number, etc.
  738.  
  739.     I use bulletin numbers instead of last mod date/times because I
  740.     want to make it possible for a sysadmin to, for example, fix a
  741.     spelling error in a bulletin without having to force all pop users
  742.     to receive a new copy of the bulletin.
  743.  
  744.     Changed the default timeout from 30 to 300 seconds (5 minutes).
  745.     This value should be reasonably "safe" for even slow dialup connections.
  746.  
  747.     Included a mod from Steve Dorner to implement a new "XTND XLST"
  748.     command.
  749.  
  750.     Updated the manpage.
  751.  
  752.     Changed the version number to just plain version 2.0.
  753.  
  754.     John Norstad of Northwestern University (j-norstad@nwu.edu) (6/94).
  755.  
  756. 1.831-2Q3
  757.     This version fixes a bug in the cleanup code.  If an error occurs
  758.     during the login phase then a core file is dumped.  Annoying but not
  759.     serious since the .user.pop file is unlocked and the popper deals with
  760.     this old file as a matter of course.
  761.                            (Mark Erikson 4/94)
  762.  
  763. 1.831-2Q2
  764.     Add HPUX file locking calls and a shorter timeout.  The timeout
  765.     was modified to be configureable at the command line.
  766.     
  767.     The timer starts after a command or message has been delivered and
  768.     the popper is expecing input from the client.  If the response takes
  769.     longer than the timeout then the popper closes down the socket and
  770.     cleans up the files.  A value of 120 seconds seems to be pretty
  771.     for even 1200baud slip links.  Your mileage may vary.
  772.                             (Mark Erikson 2/94)
  773.  
  774. 1.831-2Q1
  775.     Write out changes to the temporary pop log on an abort (SIGHUP).
  776.     NOTE: This diverts from the Popper RFC but it made our users life much
  777.     easier for dialup users.
  778.     
  779.     The next feature is only useful with Eudora's "Leave mail on
  780.     Server" switch set (or any other client that leaves mail on the
  781.     server).  Basically, if a user has read 5 out of 10 messages and
  782.     the session dies, the first 5 messages are marked as read.  If the
  783.     5th message is good but you only receive part of it then it will
  784.     be skipped (bad).  But if the message was bad and caused the mail
  785.     client to abort then you can continue to receive the rest of your
  786.     mail (good).  There is no switch to disable this feature.
  787.                             (Keith Pilotti 1/94)
  788.  
  789. 1.831uiuc2
  790.     Unlinking temporary drop file (safely). (Steve Dorner, 12/12/91)
  791.  
  792. 1.831uiuc1
  793.     Make sure user's shell is in /etc/shells. (Paul Pomes)
  794.     Timeout added. (Steve Dorner, 12/5/91)
  795.  
  796. 1.83    Make sure that everything we do as root is non-destructive.
  797.                 (Cliff Frost poptest@nettlesome.berkeley.edu)
  798.  
  799. 1.831beta
  800.     is no longer beta   30 July 91
  801.                 (Cliff Frost poptest@nettlesome.berkeley.edu)
  802.  
  803. 1.831beta.tar.Z 03 April 91
  804.     Changed mkstemp to mktemp for Ultrix.  Sigh.
  805.                 (Cliff Frost poptest@nettlesome.berkeley.edu)
  806.  
  807. 1.83beta.tar.Z  02 April 91
  808.     This version makes certain that while running as root we do nothing
  809.     at all destructive.
  810.                 (Cliff Frost poptest@nettlesome.berkeley.edu)
  811.  
  812. 1.82
  813.     Make the /usr/spool/mail/.userid.pop file owned by the user rather
  814.     than owned by root.
  815.                 (Cliff Frost poptest@nettlesome.berkeley.edu)
  816.  
  817. 1.82beta.tar.Z  27 March 91
  818.     This version fixes problems on Encore MultiMax and some Sun releases
  819.     which wouldn't allow a user to ftruncate() a file from an open
  820.     file descripter unless the user owns the file.  Now the user
  821.     owns the /usr/spool/mail/.userid.pop file.  Thanks to Ben Levy
  822.     of FTP Software and Henry Holtzman of Apple.
  823.                 (Cliff Frost poptest@nettlesome.berkeley.edu)
  824.  
  825. 1.81
  826.     There were two versions of 1.7 floating around, 1.7b4 and 1.7b5.
  827.     The difference is that 1.7b5 attempted to save disk space on 
  828.     /usr/spool/mail by deleting the users permanent maildrop after
  829.     making the temporary copy.  Unfortunately, if compiled with 
  830.     -DDEBUG, this version could easily wipe out a users' mail file.
  831.     This is now fixed.
  832.  
  833.     This version also fixes a security hole for systems that have
  834.     /usr/spool/mail writeable by all users.
  835.  
  836.     With this version we go to all new SCCS IDs for all files.  This
  837.     is unfortunate, and we hope it is not too much of a problem.
  838.  
  839.     Thanks to Steve Dorner of UIUC for pointing out the major problem.
  840.                 (Cliff Frost poptest@nettlesome.berkeley.edu)
  841.  
  842. 1.81beta.tar.Z  20 March 91
  843.     This version of popper is supposed to fix three problems reported
  844.     with various versions of popper (all called 1.7 or 1.7something).
  845.  
  846.     1)  Dropped network connections meant lost mail files.  Some 1.7
  847.         versions also risked corrupting mail files.
  848.  
  849.     2)  Some versions of 1.7 created temporary drop files with world
  850.         read and write permissions.
  851.  
  852.     3)  Some versions of 1.7 were not careful about opening the temporary
  853.         drop file.
  854.                 (Cliff Frost poptest@nettlesome.berkeley.edu)
  855.  
  856. 1.7     Extensive re-write of the maildrop processing code contributed by 
  857.         Viktor Dukhovni <viktor@math.princeton.edu> that greatly reduces the
  858.         possibility that the maildrop can be corrupted as the result of
  859.         simultaneous access by two or more processes.
  860.  
  861.         Added "pop_dropcopy" module to create a temporary maildrop from
  862.         the existing, standard maildrop as root before the setuid and 
  863.         setgid for the user is done.  This allows the temporary maildrop
  864.         to be created in a mail spool area that is not world read-writable.
  865.  
  866.         This version does *not* send the sendmail "From " delimiter line
  867.         in response to a TOP or RETR command.
  868.  
  869.         Encased all debugging code in #ifdef DEBUG constructs.  This code can
  870.         be included by specifying the DEGUG compiler flag.  Note:  You still
  871.         need to use the -d or -t option to obtain debugging output.
  872.                 (Cliff Frost poptest@nettlesome.berkeley.edu)
  873.  
  874. 1.6     Corrects a bug that causes the server to crash on SunOS
  875.         4.0 systems.
  876.  
  877.         Uses varargs and vsprintf (if available) in pop_log and
  878.         pop_msg.  This is enabled by the "HAVE_VSPRINTF"
  879.         compiler flag.
  880.  
  881.         For systems with BSD 4.3 bind, performs a cannonical
  882.         name lookup and searches the returned address(es) for
  883.         the client's address, logging a warning message if it
  884.         is not located.  This is enabled by the "BIND43"
  885.         comiler flag.
  886.  
  887.         Removed all the includes from popper.h and distributed
  888.         them throughout the porgrams files, as needed.
  889.  
  890.         Reformatted the source to convert tabs to spaces and
  891.         shorten lines for display on 80-column terminals.
  892.                 (Cliff Frost poptest@nettlesome.berkeley.edu)
  893.  
  894. 1.5     Creates the temporary maildrop with mode "600" and
  895.         immediately unlinks it.
  896.  
  897.         Uses client's IP address in lieu of a canonical name if
  898.         the latter cannot be obtained.
  899.  
  900.         Added "-t <file-name>" option.  The presence of this
  901.         option causes debugging output to be placed in the file
  902.         "file-name" using fprintf instead of the system log
  903.         file using syslog.
  904.  
  905.         Corrected maildrop parsing problem.
  906.                 (Cliff Frost poptest@nettlesome.berkeley.edu)
  907.  
  908. 1.4     Copies user's mail into a temporary maildrop on which
  909.         all subsequent activity is performed.
  910.  
  911.         Added "pop_log" function and replaced "syslog" calls
  912.         throughout the code with it.
  913.                 (Cliff Frost poptest@nettlesome.berkeley.edu)
  914.  
  915. 1.3     Corrected updating of Status: header line.
  916.  
  917.         Added strncasecmp for systems that do not have one.
  918.         Used strncasecmp in all appropriate places.  This is
  919.         enabled by the STRNCASECMP compiler flag.
  920.                 (Cliff Frost poptest@nettlesome.berkeley.edu)
  921.  
  922. 1.2     Support for version 4.2 syslogging added.  This is
  923.         enabled by the SYSLOG42 compiler flag.
  924.                 (Cliff Frost poptest@nettlesome.berkeley.edu)
  925.  
  926. 1.1     Several bugs fixed.
  927.                 (Cliff Frost poptest@nettlesome.berkeley.edu)
  928.  
  929. 1.0     Original version.
  930.                 (Cliff Frost poptest@nettlesome.berkeley.edu)
  931.  
  932.  
  933. Platform-specific Notes:
  934.  
  935. For MacOS, please see the file doc/mac.
  936.  
  937. For HP-UX 10.20, it may be necessary to add the following line
  938. to popper/popper.h:
  939.     #include <hpsecurity.h>
  940.  
  941.  
  942. Limitations
  943.  
  944. +   The POP server copies the user's entire maildrop to .user.pop and
  945.     then operates on that copy.  If the maildrop is particularly
  946.     large, or inadequate space is available in file system, then the
  947.     server will refuse to continue and terminate the connection.
  948.  
  949.  
  950. Credits
  951.  
  952.  
  953. Original Writers: Edward Moy, Austin Shelton
  954.  
  955. Contributions and Changes: 
  956.     Robert Campbell (U.C. Berkeley), Viktor Dukhovni (Princeton 
  957.     University), Austin Shelton (U.C. Berkeley), Steve Dorner (UIUC),
  958.     Paul Pomes (UIUC), Keith Pilotti, Mark Erikson, John Norstand, 
  959.     Laurence Lundblade, Praveen Yaramada, Randall Gellens (QUALCOMM).
  960.  
  961.     Many, many more whose contributions have enabled Qpopper to become
  962.     robust and helpful.  Some of these people are credited in the
  963.     doc/Changes file and/or in individual files.  Contributions are
  964.     always welcome.
  965.  
  966.  
  967. Footnotes
  968.  
  969. [1] Copyright (c) 1990 Regents of the University of California.
  970.     All rights reserved.  The Berkeley software License Agreement
  971.     specifies the terms and conditions for redistribution.  Unix is
  972.     a registered trademark of AT&T corporation.  HyperCard and
  973.     Macintosh are registered trademarks of Apple Corporation.
  974.  
  975. [2] M. Rose, Post Office Protocol - Version 3.  RFC  1081, NIC, 
  976.     November 1988.
  977.  
  978. [3] M. Rose, Post Office Protocol - Version 3 Extended Service 
  979.     Offerings.  RFC 1082, NIC, November 1988.
  980.