home *** CD-ROM | disk | FTP | other *** search
/ Borland Programmer's Resource / Borland_Programmers_Resource_CD_1995.iso / ntcode / blat01 / readme < prev   
Encoding:
Text File  |  1995-05-19  |  3.9 KB  |  103 lines
  1.  
  2. DESCRIPTION:
  3.  
  4. Blat is a Public Domain (generous aren't we?) Windows NT console utility which
  5. will e-mail a file to a user via SMTP. The program requires the "gensock" DLL
  6. (borrowed from WinVN). A Registry entry is generated when the program is used
  7. with the -SMTP flag. This stores the address of the SMTP server, and the 
  8. address of the _default_ sender (this may be overridden with the -f flag).
  9. Impersonation can be done with the -i flag which puts the value specified in
  10. place of the senders address in the "From:" line of the header, however if this
  11. is done the real senders address is stamped in the "Reply-To:" and "Sender:"
  12. lines. This can be useful when using the program to send message from NT users
  13. that are not registered on the SMTP host.
  14.  
  15.  
  16. SYNTAX: 
  17.  
  18. Blat <filename> [-s <subject>] -t <recipient> -f <address> -c <carboncopy> [-i <address>]
  19. Blat -SMTP <server address>
  20. Blat -SMTP <server address> <senders address>
  21. Blat -h
  22.  
  23. -SMTP <server address>: address of SMTP server,
  24. -SMTP <server address> <senders address>: address of SMTP host, default sender
  25.  
  26. <filename>: the file with the message body,
  27. -s <subject>: the (optional) subject line,
  28. -t <recipient>: the recipient's address(es),
  29. -t <recipient>: address(es) for carbon copies,
  30. -f <sender>: the sender's address (must be known to the SMTP server),
  31. -i <address>: a 'From:' address, not necessarily known to the SMTP server,
  32. -h: this help.
  33.  
  34. INSTALLATION:
  35.  
  36. To set up Blat you need to:
  37.  
  38. 1) Copy the file "gensock.dll" to your "\WINNT\SYSTEM32" directory, or to any
  39.    other directory in your path. (Check if you already have it, if so only copy
  40.    the DLL if the date is more recent than the existing one)
  41.  
  42. 2) Copy the file "Blat.exe" to your "\WINNT\SYSTEM32" directory, or to any
  43.    other directory in your path.
  44.  
  45. 3) Run "Blat -SMTP yourhost.site.blah.blah youruserid@site.blah.blah"
  46.  
  47.  
  48. EXAMPLES:
  49.  
  50. Blat -SMTP smtphost.bar.com foo@bar.com          // Sets host and userid
  51. Blat -SMTP smtphost.bar.com foo                  // Sets host and userid
  52. Blat -SMTP smtphost.bar.com                      // Sets host only
  53.  
  54. Blat myfile.txt -s "A file for pedro" -t foo@bar.com
  55. // Sends a file with subject line "A file for pedro"
  56.  
  57. Blat myfile.txt -s "A file for mark" -t fee@fi.com -f foo@bar.com
  58. // -f option overrides the default sender
  59.  
  60. Blat myfile.txt -s "A file for pedro" -t foo@bar.com -i "devil@fire.hell"
  61. // -i replaces "From:" line address (but leaves Reply-To: and Sender: lines)
  62.  
  63. Blat myfile.txt -s "animals" -t fee@fi.com -c "moo@grass.edu,horse@meadow.hill"
  64. // -c mails carbon copies to users moo@grass.edu and horse@meadow.hill
  65.  
  66.         
  67. FUTURE IMPROVEMENTS (you can do it!)
  68.  
  69. 1) reorganize the code
  70. 2) include a Bcc: field
  71. 3) default subject line being the name of the file with the message body.
  72. 4) ability to specify SMTP server on the command line (wouldn't need registry)
  73. 5) get rich
  74. 6) go on holidays...
  75.  
  76.  
  77. COPYRIGHT
  78.  
  79. License to use Blat
  80.  
  81. The authors of Blat have placed it in the public domain. This means you
  82. can use it free of charge for any purpose you like, with no conditions being
  83. placed on its use by us. The source code is also available free of charge and
  84. under the same conditions as the executables.
  85.  
  86. You have permission to modify, redistribute, hoard, or even sell Blat in its
  87. executable or source form. If you do sell Blat, though, we'd appreciate it if
  88. you'd provide your own support (and send us a free copy).  We cannot take any
  89. support load for Blat (we've got better things to do). 
  90.  
  91. Various bits of the source code are copyright by other people/organizations.
  92. Look in the source code for copyright ownership.
  93.  
  94. The authors of the package are not responsible for any damage or losses that
  95. the usage of Blat may cause. We are especially not responsible for the misuse
  96. of the SMTP (or other) mail system.
  97.  
  98.  
  99. AUTHORS
  100.  
  101. Mark Neal    (mjn@aber.ac.uk)
  102. Pedro Mendes (prm@aber.ac.uk)
  103.