home *** CD-ROM | disk | FTP | other *** search
/ OS/2 Shareware BBS: 35 Internet / 35-Internet.zip / ipop3d10.zip / pop3d.txt < prev    next >
Text File  |  1999-06-01  |  4KB  |  133 lines
  1. Pop3d is a mailbox server based on the Internet Standard
  2. STD 53, Post Office Protocol Version 3. The
  3. server requires user and password verification before a
  4. maildrop can be opened. The server can retrieve and delete
  5. messages from the maildrop on a per-message basis.
  6. Pop3d currently supports the following POP3 commands; the
  7. commands are case independent.
  8.  
  9. Command              Description
  10. USER            specify user for maildrop access
  11. PASS            specify password for maildrop access
  12. APOP            specify user and hashed password for maildrop access
  13. STAT            give message count and size of maildrop
  14. LIST            list size of individual messages
  15. RETR            retrieve a message
  16. DELE            delete a message
  17. NOOP            do nothing, return a positive response
  18. LAST            give highest message number accessed
  19. RSET            unmark messages marked for deletion
  20. TOP            retrieve part of a message
  21. UIDL            retrieve the unique ID for a message
  22. QUIT            terminate session
  23. The remaining optional commands specified in STD 53 (RPOP) is 
  24. not implemented.
  25.  
  26. The server runs in "inetd" mode by default or with the -i option
  27. and it expects to be started by some server process such as inetd.
  28. If the -b option is given, it is run as a standalone server in the
  29. background (and should NOT be listed in inetd.lst or inetd.conf).  
  30. Pop3d listens for TCP requests on port 110 or on "portno" if the
  31. -p portno option is given.
  32. The -h option prints usage and command line options.
  33.  
  34. ----------------
  35.  
  36. Installation.
  37.  
  38. You must decide to run pop3d from inetd or standalone.
  39.  
  40. FOR INETD INSTALLATIONS:
  41. - Add an entry for pop3d in the file %ETC%\inetd.lst
  42.   (or %ETC%\inetd.cnf for ported version of inetd).
  43.   It should look like this:
  44.  
  45.   pop3 tcp d:\tcpip\bin\pop3d.exe -d
  46.   or   
  47.   pop3 stream tcp nowait root d:\tcpip\bin\pop3d -d %s
  48.  
  49. FOR STANDALONE INSTALLATIONS:
  50. - Be sure that inetd isn't listening for pop3 connections already.
  51. - Then start the daemon running now by hand:
  52.   d:\tcpip\bin\pop3d.exe -b
  53. - Added the daemon to a startup script.
  54.   Use the same command as given above:  d:\tcpip\bin\pop3d.exe -b
  55.  
  56. Note: in standalone installation pop3d spawns the separate child
  57. process for each connection.
  58.  
  59. ----------------
  60.  
  61. Command line options:
  62.  
  63.   -h       Help message.
  64.   -d       Debug logging mode (to the %ETC%\pop3d.log file)
  65.   -s       Enable logging to syslog.
  66.   -i       Inetd mode (default).
  67.   -b       Background daemon mode.
  68.   -p port  Listening port number.
  69.  
  70. ----------------
  71.  
  72. User/password/mailbox configuration.
  73.  
  74. Two methods are currently supported for USER/PASS verification.
  75.  
  76. 1. If the MAILBOX environment variable is defined, the
  77. name for mailbox directory for user USERNAME constructs
  78. as %MAILBOX%\username. The encrypted passwords for users placed in
  79. UNIX-like %ETC%\passwd file:
  80.  
  81. #User:Password
  82. username:2c0RlCFZHDMEA
  83. postmaster:465Kf4fXaTr9s
  84. unknown:5a5SZFHFTF2mE
  85.  
  86. The name of this file may be redefined by setting the 
  87. PASSWORDS environment variable, for example
  88.  
  89. SET PASSWORDS=d:\tcpip\pop3d\passwd
  90.  
  91. Use admin.exe utility to create/change this file.
  92.  
  93. 2. All information contains in old-style %ETC%\mailaddr file:
  94.  
  95. #User           Directory       Password
  96. username    d:\mail\username    secret
  97. postmaster  d:\mail\postmaster  big_secret
  98. unknown     d:\mail\bad_mail    very_bad
  99.  
  100. The passwords are not enrypted.
  101.  
  102.  
  103.    For APOP verification the MAILBOX environment variable must be
  104. defined and unencrypted passwords must be placed in %ETC%\apop.cnf:
  105.  
  106. #User:Password
  107. username:secret
  108. postmaster:big_secret
  109. unknown:very_bad
  110.  
  111. ----------------
  112.  
  113. Mail delivering.
  114.  
  115. mailrcv.exe is the mail delivering program for OS/2 sendmail.
  116. It's necessary to edit local mailer section in the file 
  117. %ETC%\sendmail.cf:
  118.  
  119. Mlocal, P=d:\tcpip\pop3d\mailrcv.exe, F=lsmDFP,  S=10, R=20, A=__path__ $u
  120.  
  121. where __path__ is the name of MAILBOX directory (when ended by '\'
  122. character) or the full name of %ETC%\mailaddr file. Examples:
  123.  
  124. Mlocal, P=d:\tcpip\pop3d\mailrcv.exe, F=lsDFP,  S=10, R=20, A=d:\mail\ $u
  125. or
  126. Mlocal, P=d:\tcpip\pop3d\mailrcv.exe, F=lsDFP,  S=10, R=20, A=d:\mptn\etc\mailaddr $u
  127.  
  128. An editor that prevents TAB characters from expanding have to be used
  129. (for example E).
  130. "unknown" is the reserved user name for delivering all messages,
  131. addressed to unknown users.
  132.  
  133.