NetIdSMTP V1.0 © Copyright 1994 by Jason Gouger

All Rights Reserved

LEGAL INFORMATION
~~~~~~~~~~~~~~~~~
    I hereby grant permission for anyone to freely distribute this program as
long as this documentation file is distributed with it.  In no way should the
documentation or the program be modified, or sold for profit.  This program
cannot be included with any other packages unless the author is contacted and
the express written permission is given. I cannot be held responsible for 
damage that occurs as a result of the use/misuse of this program as I have 
made every effort to ensure NetIdSMTP operates properly.

    If you have any problems, suggestions, or would like to send a GIFTWARE
donation (suggestion: $15), my address is:

Jason Gouger
74 White Birch Lane
East Stroudsburg, PA 18301

jgouger@email.psu.edu (E-Mail)
1:268/114 (FidoNet)
The Amiga Enterprise 717-223-8269 (BBS)

REQUIREMENTS
~~~~~~~~~~~~
   network link (obviously).
   AmiTCP V2.1 or later.
   SMail or similar.

INTRODUCTION
~~~~~~~~~~~~
   My intention when writing this program, was to produce a piece of
software for sending a batch of mail files. With the option to convert
from headers to different addresses. This allows people without a
private network address to send E-Mail with the proper from line. Also
it creates a somewhat secure way of not allowing incorrect or invalid
from lines from being included with the mail. The program is not for
receiving mail, for that use AmiPOP.  This program uses the spooled 
mail file produced by SMail.  Or any mail file that is in a SMTP mail
format.

   If you use this program with SMail you should have the BSMTP spool
option ON and compression set to NONE.

INSTALLATION
~~~~~~~~~~~~
   You need to set the following variables in your ELM config file.
   The config file should be located/named one of the following:

      1) UULib:Config [UULib: Assignment]    (Highest Priority)
      2) S:UUConfig [S:Assignment]           (Lowest Priority)

   Whichever is found first WILL be used. This should be the config
   you use for SMail or similar.


   Config File Options:

      NetIdArgs - If you want arguments accepted from the command
                  line. (yes/no) This is a security feature so
                  the config can not be changed via the command line.
      NetIdFile - The fullpath and name of the NetId config file.
                  More information on this later.
      NetIdHost - SMTP Hostname for mail transfers.
      NetIdMail - SMTP Spooled mail file (created by SMail or similar).
      NetIdSend - SMail command with arguments. The ~t sequence will be
                  substituted with the TO address and the ~f will have
                  the mail file name substituted.

                  Example: UUCP:c/SMail -t ~t <~f
                  If the address was jgouger and the file was T:AAAA0001.

                  The following would be executed:
                    UUCP:c/SMail -t jgouger <T:AAAA0001

                  This command is used to return undeliverable mail.

   NetIdFile Config file:

      ID|SMTP From address|From: line address|Realname

      ID - Id used on the system to send mail. The following two formats
           will be converted to the id without the host information.

           1) jgouger@email.psu.edu would be converted to jgouger.
           2) email!email.psu.edu!jgouger would be converted to jgouger.

           Any format without the "@" or "!" symbols will NOT be
           converted.

      SMTP From address - This address is passed to the SMTP Mailer as
                          the sender of the mail.

      From: Line address - This address is substituted into the header
                           for all From: lines.


          Example: If the from argument was: jgouger@email.psu.edu

          Mail Header:

                   To: jgouger@email.psu.edu
                   From: john@amiga (John Doe)
                   Subject: Test msg
                   From: jane@amiga (Jane Doe)

          This header would be converted to:

                   To: jgouger@email.psu.edu
                   From: jgouger@email.psu.edu  <== Notice new address
                   Subject: Test msg               and other from line(s)
                                                   removed.

      Real Name - This name is tacked onto the From: line address.

          Example: If the real name argument was: Jason Gouger

                   The From: line from above example would be:

                     From: jgouger@email.psu.edu (Jason Gouger)

          Note: If you do NOT want a real name passed to the from line
                place an "*" in the argument slot.


   Misc Information:

      You MUST have an entry in the config file for every user permitted
      to send network mail. Otherwise the mail will be returned.

      If you run this program in conjuction with MultiUser, you should
      set the Uid bit so it is run by the root.  This will allow for
      the reading and deleting of the mail file. Also you should have
      the NetIdArgs option set for "no" so options can not be passed to
		the program. This will somewhat secure the program from being
      altered.

USAGE
~~~~~
   This program is fairly simple to run once you have everything configured.
   It will send and delete the mail file if no errors are detected. Simply
   type NetIdSMTP and it will run the program without user intervention.
   If a non fatal error is detected while sending, the message will be
   returned. Otherwise the mail program will exit.

   Template:

   MAILFILE,SMTPHOST,NETIDFILE

   If the NetIdArgs is set to "yes" command line options will OVERRIDE
   configured options. Otherwise they will be ignored.

   MAILFILE is the SMTP spooled mail file name.
   SMTPHOST is the SMTP server.
   NETIDFILE is the Network Id config file.

BUGS
~~~~
   None as of yet.

HISTORY
~~~~~~~
   1.0   First release of NetIdSMTP.