home *** CD-ROM | disk | FTP | other *** search
/ The Best of Windows 95.com 1996 September / WIN95_09962.iso / command / BLAT14.ZIP / README < prev   
Text File  |  1995-10-25  |  7KB  |  166 lines
  1. INDEX
  2.  
  3.  - description
  4.  - installation
  5.  - what's new in this version
  6.  - usage
  7.  - examples
  8.  - future improvements
  9.  - copyright
  10.  - authors
  11.  - contributors
  12.  
  13.  
  14. DESCRIPTION:
  15.  
  16. Blat is a Public Domain (generous aren't we?) Windows NT console utility that
  17. sends the contents of a file in an e-mail message using the SMTP protocol.
  18. Blat is useful for creating scripts where mail has to be sent automatically
  19. (CGI, backups, etc.) To use Blat you must have access to a SMTP server via
  20. TCP-IP. Blat uses the a DLL ("gensock" or "gwinsock") from WinVN, the public
  21. domain usenet newsreader for windows. Blat can store a default SMTP server
  22. address and a default "From:" field in the registry. The server's address can
  23. be overriden using the -server flag, and the "From:" address using the -f
  24. flag. Input from the console (stdin) can be used instead of a disk file (if
  25. the special filename '-' is specified). Blat can also "carbon copy" and
  26. "blind carbon copy" the message. Impersonation can be done with the -i flag
  27. which puts the value specified in the "From:" line, however when this is done
  28. the real senders address is stamped in the "Reply-To:" and "Sender:" lines.
  29. This feature can be useful when using the program to send messages from NT
  30. users that are not registered on the SMTP host.
  31.  
  32.  
  33. INSTALLATION:
  34.  
  35. If you are upgrading from version 1.3, simply copy Blat.exe over the old one.
  36.  
  37. If you are upgrading from version 1.2 then just copy the new Blat.exe over the
  38. old one and (optionally) substitue gensock.dll with gwinsock.dll. The new DLL
  39. is used if found on the path, if not Blat tries to load the old one (the new
  40. one is more efficient though).
  41.  
  42. If you are upgrading from Blat 1.1 or 1.0 (phew!) or you never used Blat before
  43. you must follow these steps:
  44.  
  45. 1) Copy the file "gwinsock.dll" to your "\WINNT\SYSTEM32" directory, or to any
  46.    other directory in your path. (Check if you already have it and only copy
  47.    the DLL if the date is more recent than the existing one)
  48.  
  49. 2) Copy the file "Blat.exe" to your "\WINNT\SYSTEM32" directory, or to any
  50.    other directory in your path.
  51.  
  52. 3) Run "Blat -install yourhost.site.blah.blah youruserid@site.blah.blah"
  53.  
  54. WHAT'S NEW IN THIS VERSION
  55.  
  56.  - The offset from UTC in the date field was broken. Fixed in this version.
  57.  
  58. WHAT'S NEW IN VERSION 1.3
  59.  
  60.  - new option for blind carbon copy (-b)
  61.  - new option to silence all console output (-q). This option stops printing
  62.    any errors or help (try doing 'blat -h -q'...)
  63.  - new option to receive input from the console rather than a file (using the
  64.    '-' filename).
  65.  - fixed the date format to use '+0000' format instead of the strings in
  66.    StandardTimeName or DaylightTimeName.
  67.  - included the more efficient gwinsock.dll instead of gensock.dll. (Note:
  68.    Blat can still use the old gensock.dll.)
  69.  - Blat does not need MSVCRT10.DLL or MSVCRT20.DLL anymore.
  70.  - Added a file_id.diz for the benefit of BBS sysops (we're so nice!)
  71.  
  72.  
  73. USAGE: 
  74.  
  75. Blat <filename> -t <recipient> [optional switches (see below)]
  76. Blat -install <server addr> <sender's addr> [-q]
  77. Blat -h [-q]
  78.  
  79. -install <server addr> <sender's addr>: set's default SMTP server and sender
  80.  
  81. <filename>    : file with the message body ('-' for console input, end with ^Z)
  82. -t <recipient>: recipient list (comma separated)
  83. -s <subj>     : subject line
  84. -f <sender>   : overrides the default sender address (must be known to server)
  85. -i <addr>     : a 'From:' address, not necessarily known to the SMTP server.
  86. -c <recipient>: carbon copy recipient list (comma separated)
  87. -b <recipient>: blind carbon copy recipient list (comma separated)
  88. -h            : displays this help.
  89. -q            : supresses *all* output.
  90. -server <addr>: overrides the default SMTP server to be used.
  91.  
  92. Note that if the '-i' option is used, <sender> is included in 'Reply-to:'
  93. and 'Sender:' fields in the header of the message.
  94.  
  95.  
  96. EXAMPLES:
  97.  
  98. Blat -install smtphost.bar.com foo@bar.com          // Sets host and userid
  99. Blat -install smtphost.bar.com foo                  // Sets host and userid
  100. Blat -install smtphost.bar.com                      // Sets host only
  101.  
  102. Blat myfile.txt -s "A file for pedro" -t foo@bar.com
  103. // Sends a file with subject line "A file for pedro"
  104.  
  105. Blat myfile.txt -s "A file for pedro" -t foo@bar.com -q
  106. // Sends a file with subject line "A file for pedro" and does not print
  107. // informative messages on the console
  108.  
  109. Blat myfile.txt -s "A file for mark" -t fee@fi.com -f foo@bar.com
  110. // -f option overrides the default sender
  111.  
  112. Blat myfile.txt -s "A file for pedro" -t foo@bar.com -i "devil@fire.hell"
  113. // -i replaces "From:" line address (but leaves Reply-To: and Sender: lines)
  114.  
  115. Blat myfile.txt -s "animals" -t fee@fi.com -c "moo@grass.edu,horse@meadow.hill"
  116. // -c mails carbon copies to users moo@grass.edu and horse@meadow.hill
  117.  
  118.       
  119. FUTURE IMPROVEMENTS (you can do it!)
  120.  
  121. 1) reorganize the code (fat chance!)
  122. 2) get rich (fat chance!)
  123. 3) go on holidays... (done: Sri Lanka, NZ, Portugal, France, Denmark)
  124. 4) go on holidays again... (any offers?)
  125.  
  126.  
  127. COPYRIGHT
  128.  
  129. License to use Blat
  130.  
  131. The authors of Blat have placed it in the public domain. This means you
  132. can use it free of charge for any purpose you like, with no conditions being
  133. placed on its use by us. The source code is also available free of charge and
  134. under the same conditions as the executables.
  135.  
  136. You have permission to modify, redistribute, hoard, or even sell Blat in its
  137. executable or source form. If you do sell Blat, though, we'd appreciate it if
  138. you'd provide your own support (and send us a free copy).  We cannot take any
  139. support load for Blat (we've got better things to do). 
  140.  
  141. Various bits of the source code are copyright by other people/organizations.
  142. Look in the source code for copyright ownership.
  143.  
  144. The authors of the package are not responsible for any damage or losses that
  145. the usage of Blat may cause. We are especially not responsible for the misuse
  146. of the SMTP (or other) mail system.
  147.  
  148.  
  149. AUTHORS
  150.  
  151. Mark Neal    (mjn@aber.ac.uk)
  152. Pedro Mendes (prm@aber.ac.uk)
  153.  
  154.  
  155. CONTRIBUTORS
  156.  
  157. We'd like to thank:
  158.  
  159. the WinVN team                       - wrote gensock.dll and the excellent WinVN
  160.                                        newsreader from which we copied most of
  161.                                        Blat's code (PD apps are nice!)
  162. Beverly Brown (beverly@datacube.com) - fixed the argument parsing
  163. Bob Beck (rbk@ibeam.intel.com)       - added console input (even though we did
  164.                                        not use his code in the end...)
  165.  
  166.