home *** CD-ROM | disk | FTP | other *** search
/ OS/2 Shareware BBS: 35 Internet / 35-Internet.zip / smtp15.zip / readme.txt < prev    next >
Text File  |  2001-08-05  |  4KB  |  126 lines
  1. SMTP - a simple SMTP client for OS/2
  2. ------------------------------------
  3.  
  4. This is a very simple and basic SMTP client, which will take mail
  5. messages (stored one per file) and send them to an SMTP server.  It is
  6. designed to work only with my SMTP server, available separately.  It is
  7. not sophisticated, but it is small and fast.
  8.  
  9. All companion programs are available from the same place:
  10.  
  11.      http://www.tavi.co.uk/os2pages/mail.html
  12.  
  13. Installation
  14. ------------
  15.  
  16. Copy the SMTP.EXE file to any suitable directory which is named in the
  17. system PATH (actually, this isn't strictly necessary but it can make
  18. life easier).  Copy the NETLIB.DLL file to any directory on the LIBPATH.
  19.  
  20. Configuration
  21. -------------
  22.  
  23. First, ensure that you have a line in CONFIG.SYS of the form:
  24.  
  25.      SET TZ=....
  26.  
  27. This defines your time zone setting, names, and daylight saving rules.
  28. If you don't have one, you need to add it; the actual value can be quite
  29. complex.  For the United Kingdom, the line is:
  30.  
  31.      SET TZ=GMT0BST,3,-1,0,7200,10,-1,0,7200,3600
  32.  
  33. For other areas, download the TZCALC utility from the same place as this
  34. program.  This will work out the correct setting for you.  It will be
  35. necessary to reboot in order to pick up this setting, but wait until you
  36. have completed the rest of these instructions.
  37.  
  38. Now edit CONFIG.SYS, adding a new line of the form:
  39.  
  40.      SET SMTP=directoryname
  41.  
  42. where 'directoryname' is the name of a directory (which must exist)
  43. where outgoing mail is to be stored.
  44.  
  45. This step is not strictly necessary, as it is possible to specify this
  46. when the program is started, but it will be necessary anyway for the
  47. SMTP daemon.  No other files should be kept in this directory, as ALL
  48. files are treated as potential mail!
  49.  
  50. It will be necessary to reboot in order to pick up this setting (and the TZ
  51. one if you needed to add it), but wait until you have completed the rest
  52. of these instructions.
  53.  
  54. Locate the directory described by the ETC environment variable.  If you
  55. are not sure, type the command:
  56.  
  57.      SET ETC
  58.  
  59. at a command prompt.  You need take no action, but note that this is
  60. where the logfile (see below) is stored.
  61.  
  62. Logfile
  63. -------
  64.  
  65. SMTP maintains a logfile called SMTP.LOG in the ETC directory.  This
  66. will grow without bound if not pruned regularly! But it is occasionally
  67. useful....
  68.  
  69. The spool directory
  70. -------------------
  71.  
  72. Outgoing mail is taken from the spool directory specified by the SMTP
  73. environment variable.
  74.  
  75. Files must have a special (but simple) format; the message needs to be
  76. stored "as is", but preceded by lines specifying sender and recipient(s).
  77. This format is generated by the SMTPD server program (available
  78. separately).
  79.  
  80. Using the program
  81. -----------------
  82.  
  83. To connect to an SMTP server and send all pending messages in the spool
  84. directory, simply run the program. The following command line flags
  85. are recognised:
  86.  
  87.         -h      Display a brief help message
  88.         -s      Specify the name of the SMTP server
  89.         -v      Turn on verbose mode (extra advisory messages)
  90.         -d      Specify the name of the spool directory
  91.  
  92. For example, to send all mail to the server abc.xyz.net, with verbose mode on:
  93.  
  94.         smtp -v -sabc.xyz.net
  95.  
  96. That's all!
  97.  
  98. Feedback
  99. --------
  100.  
  101. SMTP was written by me, Bob Eager. I can be contacted at rde@tavi.co.uk.
  102.  
  103. Please let me know if you actually use this program.  Suggestions for
  104. improvements are welcomed.
  105.  
  106. History
  107. -------
  108.  
  109. 1.0     Initial version.
  110. 1.1     Use new thread-safe logging module.
  111.         Use OS/2 type definitions.
  112.         Added -v option to display progress of mail transmission.
  113. 1.2     New, simplified network interface module.
  114. 1.3     Does not make connection at all if there are no messages
  115.         to send.
  116. 1.4     Corrected failure to dot-stuff on sending.
  117. 1.5     Modified to use NETLIB DLL.
  118. 2.0     Added BLDLEVEL string.
  119.         Diagnostics for occasional logfile open failures.
  120.         Additional error checking in logging module.
  121.         Grouped initialisation code together to improve paging performance.
  122.  
  123.  
  124. Bob Eager
  125. September 2000
  126.