home *** CD-ROM | disk | FTP | other *** search
/ OS/2 Shareware BBS: 35 Internet / 35-Internet.zip / pop3s105.zip / POP3.DOC < prev    next >
Text File  |  1996-10-17  |  4KB  |  111 lines
  1. Pop3 documentation - October 10, 1996
  2.  
  3.  
  4. Pop3 is a complete Post Office Protocol Version 3 server which runs
  5. under OS/2 equipped with TCP/IP.  This implementation fully supports
  6. all aspects of rfc1522 including the 'APOP' (password encryption
  7. derived from the RSA Data Security, Inc. MD5 Message-Digest
  8. Algorithm), 'TOP', and 'UIDL' commands.  Some non-RFC behaviors are
  9. supported: 'XTND XMIT', 'LAST', and 'Status:' header.
  10.  
  11. Pop3 is a service used by mail agents to retrieve messages from a user
  12. mail box.  Usually the sendmail service is used to deliver messages 
  13. to the mailbox.  You may need to configure your sendmail daemon to
  14. get incoming mail delivered to seperate user mailboxes.
  15.  
  16.  
  17. UPGRADES:
  18. ---------
  19. Due to user requests, the following upgrades have been implemented.
  20.  
  21. 1) Duplicate users are detected in the MAILADDR file.
  22. 2) Lack of directory name is detected when loading MAILADDR file.
  23. 3) POP3LOAD utility to cause POP3 to reload configuration.
  24. 4) Improved exception handling to prevent entire server from faulting
  25.    due to problem in single thread.
  26. 5) User names can be made case-insensitive.  (Use -c on command line.)
  27. 6) Non-RFC standard LAST command.
  28. 7) Non-RFC standard Status header.
  29. 8) TOP returns headers plus top n lines of message instead of top n
  30.    lines.
  31. 9) Works with most recent so32dll.dll
  32.  
  33. How to Install
  34. --------------
  35.  
  36. To install Pop3 make sure your services file (found in the $ETC
  37. directory) has an entry similar to the following (pop3 and tcp MUST
  38. be in lower case):
  39.  
  40. pop3             110/tcp           #Post Office Protocol - Version 3
  41.  
  42. Once you run pop3 from a command shell the service becomes available.
  43. You may wish to a 'start pop3' to startup.cmd or create a program
  44. icon and add it to the startup folder.  You may also add 'start pop3'
  45. to the tcpexit.cmd file which is in X:\tcpip\bin.  This file is not
  46. used by most implementations and more than likely need to be created.
  47. The tcpexit.cmd file is CALLed by the tcpstart.cmd file.  You should
  48. not add the pop3 launch command to tcpstart.cmd since tcpstart.cmd is
  49. modified by the configuration notebooks.
  50.  
  51.    
  52. The authorized user file is set by the '-a' command line option.  By
  53. default the authorized user file is called MAILADDR.  pop3 will
  54. search for this file in the %ETC% directory unless a fully quailified
  55. path name is given.
  56.  
  57. Each line in the authorized user file contains three words. The first
  58. word is a user name, the second word a mail directory, the third word
  59. is optional and specifies the logon password.  Any blank lines are
  60. ignored.  All characters after an octothorp ('#') are ignored until
  61. the end of line is reached.  Two sample users and the default spool
  62. command follow:
  63.  
  64. mike    p:\net\pop3\mail\mike    mikesecretpassword
  65. chas    p:\net\pop3\mail\chas    chassecretpassword
  66. spool    p:\net\pop3\mail    "sendmail.exe -af %1 -t"
  67.  
  68. User names are case sensitive unless -c is specified on the command
  69. line.  Passwords are always case sensitive.
  70.  
  71. The special user name 'spool' is used to specify how pop3 will handle
  72. incoming 'XTND XMIT' requests.  The second word is the spool
  73. directory, the third word is the spool command executed after a
  74. message has been sent to pop3.  The '%1' is replaced with the name of
  75. the spool file.
  76.  
  77.  
  78. Pop3 can log accesses to the mail service.  The '-l' command line
  79. option will log all client/server conversation to the screen. The
  80. '-l<file>' option will log conversation to the specified file.
  81. Leaving out the filename will cause the log to be displayerd
  82. onscreen.  Take care with using logging; user passwords will be
  83. displayed although the messages sent or retrieved will not be. 
  84. Additionally, these logs do get quite large.
  85.  
  86.  
  87.  
  88. Pop3 is not shareware.  It is Copyrighted material and the author
  89. requests the following user licence fees:
  90.  
  91.    #Users  Fee    #Users  Fee
  92.        1   $20      512  $180
  93.        2   $40     1024  $200    
  94.        8   $60     2048  $220
  95.       16   $80     4196  $240
  96.       32  $100     8192  $260
  97.       64  $120    16384  $280
  98.      128  $140    32768  $300
  99.      256  $160    65536  $320
  100.  
  101. All fees should be sent to:
  102.  
  103.         Charles Honton
  104.         c/o Secant Technologies
  105.         23811 Chagrin Blvd.  #244
  106.         Beachwood, OH  44120
  107.  
  108. Comments and suggestions are appreciated.  
  109. Direct all inquiries to chas@secant.com
  110.  
  111.