home *** CD-ROM | disk | FTP | other *** search
/ OS/2 Shareware BBS: 35 Internet / 35-Internet.zip / smtpd20.zip / readme.txt < prev    next >
Text File  |  2001-08-05  |  5KB  |  144 lines
  1. SMTPD - a simple SMTP daemon for OS/2
  2. -------------------------------------
  3.  
  4. This is a very simple and basic SMTP server daemon, which will accept
  5. connections on the usual SMTP port (25) and collect mail for onward
  6. transmission.  It is not sophisticated, but it is small and fast.
  7.  
  8. All companion programs are available from the same place:
  9.  
  10.      http://www.tavi.co.uk/os2pages/mail.html
  11.  
  12. Installation
  13. ------------
  14.  
  15. Copy the SMTPD.EXE file to any suitable directory which is named in the
  16. system PATH. Copy the NETLIB.DLL file to any directory on the LIBPATH.
  17.  
  18. Configuration
  19. -------------
  20.  
  21. First, ensure that you have a line in CONFIG.SYS of the form:
  22.  
  23.      SET TZ=....
  24.  
  25. This defines your time zone setting, names, and daylight saving rules.
  26. If you don't have one, you need to add it; the actual value can be quite
  27. complex.  For the United Kingdom, the line is:
  28.  
  29.      SET TZ=GMT0BST,3,-1,0,7200,10,-1,0,7200,3600
  30.  
  31. For other areas, download the TZCALC utility from the same place as this
  32. program.  This will work out the correct setting for you.  It will be
  33. necessary to reboot in order to pick up this setting, but wait until you
  34. have completed the rest of these instructions.
  35.  
  36. Now edit CONFIG.SYS, adding a new line of the form:
  37.  
  38.      SET SMTP=directoryname
  39.  
  40. where 'directoryname' is the name of a directory (which must exist)
  41. where outgoing mail is to be stored.  No other files should be kept in
  42. this directory.  It will be necessary to reboot in order to pick up this
  43. setting, but wait until you have completed the rest of these
  44. instructions.
  45.  
  46. Locate the directory described by the ETC environment variable.  If you
  47. are not sure, type the command:
  48.  
  49.      SET ETC
  50.  
  51. at a command prompt.  In this directory, create a configuration file,
  52. which must be named MAIL.CNF.  A sample is provided, as SAMPLE.CNF.
  53. The TRUSTED_HOST line may be included as many times as necessary; if you
  54. are not worried about blocking SMTP calls from anywhere, just use the
  55. line:
  56.  
  57.      TRUSTED_HOST    0.0.0.0    0.0.0.0
  58.  
  59. If, however, you don't want to become a spam conduit, specify the IP
  60. addresses from which you are prepared to accept mail.  You can have
  61. multiple TRUSTED_HOST lines, each specifying a single IP address, or you
  62. can specify a whole group by using the mask effectively.  The check is
  63. done by comparing a calling IP address with the one given as the first
  64. value after TRUSTED_ADDRESS; however, before the comparison, both values
  65. are masked with the second address.  So, for example, if your local
  66. network was 192.168.55.0, you could use the line:
  67.  
  68.      TRUSTED_HOST 192.168.55.0 255.255.255.0
  69.  
  70. which would accept calls from anywhere on that network (192.168.55.11,
  71. 192.168.55.77, etc...).  All TRUSTED_HOST lines are checked on an
  72. incoming call, and if any one of them provides a match, the call is
  73. accepted.
  74.  
  75. Lastly, edit the file INETD.LST, also found in the ETC directory.  Add a
  76. line like this:
  77.  
  78.      smtp tcp smtpd
  79.  
  80. You can do this via the TCP/IP configuration notebook if you prefer.  If
  81. INETD is not already running, edit the file TCPSTART.CMD (normally found
  82. in \TCPIP\BIN) to un-comment the line that starts INETD; again, use the
  83. TCP/IP configuration notebook if you prefer.  Reboot to activate INETD,
  84. and also to pick up the SMTP environment setting (and the TZ one if you
  85. added it).  INETD will now accept incoming SMTP calls and start SMTPD as
  86. necessary.
  87.  
  88. Logfile
  89. -------
  90.  
  91. SMTPD maintains a logfile called SMTPD.LOG in the ETC directory.  This
  92. will grow without bound if not pruned regularly! But it is occasionally
  93. useful....
  94.  
  95. The spool directory
  96. -------------------
  97.  
  98. Incoming mail is stored in the spool directory specified by the SMTP
  99. environment variable. Don't store anything else in this directory.
  100.  
  101. Files have a special (but simple) format; the message is stored "as is",
  102. but preceded by lines specifying sender and recipient(s).  This format
  103. is understood by the SMTP client program (available separately).
  104.  
  105. Routing
  106. -------
  107.  
  108. No special routing of mail is done; it is all placed in the spool
  109. directory.  If any more functionality is required, use another program,
  110. such as sendmail (which is roughly ten times the size).
  111.  
  112. Feedback
  113. --------
  114.  
  115. SMTPD was written by me, Bob Eager. I can be contacted at the address below.
  116.  
  117. Please let me know if you actually use this program.  Suggestions for
  118. improvements are welcomed.
  119.  
  120. History
  121. -------
  122.  
  123. 1.0     Initial version.
  124. 1.1     First release version.
  125. 1.2     Fix drive/directory problem for spool area.
  126. 1.3     Further fix for drive/directory problems.
  127. 1.4     Use new thread-safe logging module.
  128.         Use OS/2 type definitions.
  129. 1.5     New, simplified network interface module.
  130.         Grouped initialisation code together.
  131. 1.6     Diagnostics for occasional logfile open failures.
  132. 1.7     Added option security logging.
  133. 1.8     Added configuration file, and blocking of non-trusted clients.
  134. 1.9     Corrected handling of part line comments in config file.
  135. 2.0     Changed name of configuration file to MAIL.CNF.
  136.         Added BLDLEVEL string.
  137.         Additional error checking in logging module.
  138.  
  139.  
  140. Bob Eager
  141. rde@tavi.co.uk
  142. September 2000
  143.  
  144.