home *** CD-ROM | disk | FTP | other *** search
/ YPA: Your Privacy Assured / YPA.ISO / other_goodies / utilities / iu-14-as225.lha / INetUtils-1.4 / docs / SMTPd.man < prev    next >
Text File  |  1994-12-09  |  5KB  |  145 lines
  1. SMTPd                                      SMTPd
  2.  
  3.  
  4. NAME
  5.  
  6.     SMTPd - SMTP Daemon for AS-225r2 and AmiTCP
  7.  
  8.  
  9. SYNOPSIS
  10.  
  11.     SMTPd
  12.  
  13.  
  14. DESCRIPTION
  15.  
  16.     SMTPd is designed to be fully compatible with RFC-821 and process
  17.     most addresses accepted by RFC-822. It is an active daemon, in that
  18.     it listens to its port (normally 25), and is *not* initiated by
  19.     the INet daemon when an SMTP port open request occurs.
  20.  
  21.     SMTPd should *not* have an entry in inetd.conf.
  22.  
  23.     SMTPd accepts messages destined for the local host and delivers
  24.     them to the local mailbox. SMTPd will regularly (every two minutes)
  25.     retry previously failed mail which is present in the SMTP Spool
  26.     Directory (to avoid system thrashing, SMTPd will only allow one
  27.     retry to be active at a time).
  28.  
  29.     SMTPd requires one external program to be present for its operation,
  30.     SMTPpost. SMTPpost *must* be in the program search path for SMTPd
  31.     when SMTPd is initiated.
  32.  
  33.     SMTPd requires four environment variables to be assigned, or for
  34.     the variables to be defined in the configuration file (named
  35.     S:UUConfig or UULib:Config, in that order).
  36.  
  37.     The variables are:
  38.  
  39.             SMTPSpoolDir
  40.             SMTPMailDir
  41.             SMTPSmarterHost
  42.             SMTPRMail
  43.  
  44.     SMTPMailDir points to where MailBoxes/Folders are located. It may
  45.     be shared with UUCP MailBoxes and Folders (they are the same format).
  46.     For AmiTCP, SMTPMailDir defaults to "AmiTCP:Mail/". For AS225, the
  47.     default is "INet:Mail/".
  48.  
  49.     SMTPSpoolDir is the directory where SMTP spool files are to be
  50.     located. If SMTPpost cannot locate a destination host, it places
  51.     the articles in this directory, and retries sending the messages on
  52.     a regular basis. It *may not* be shared with UUSpool. The batch
  53.     files are a different format. For AmiTCP, SMTPSpoolDir defaults to
  54.     "AmiTCP:MailSpool/". For AS225, the default is "INet:MailSpool/".
  55.  
  56.     SMTPSmarterHost is the SMTP host where mail is sent if a named
  57.     destination host is not reachable. It is presumed to be an Internet
  58.     host which has better routing information than does the host
  59.     running this SMTPd.
  60.  
  61.     SMTPRMail defines the program that will deliver mail which was
  62.     destined for this host. Typically, it is a copy of SMTPpost, renamed
  63.     to RSMTP or SMTPpost with the -r argument.
  64.  
  65.     The environment variables may be defined as:
  66.  
  67.         Set SMTPMailDir      UUMail:
  68.         Set SMTPSpoolDir     UUStuff:SMTPSpoolDir/
  69.         Set SMTPSmarterHost  Mail.SmarterHost.COM
  70.         Set SMTPRMail         smtppost -r
  71.  
  72.  
  73. INSTALLATION
  74.  
  75.     Simply install the binaries for SMTPd and SMTPpost where-ever you
  76.     wish. Do note that SMTPpost *must* be in the path of SMTPd, whenever
  77.     SMTPd is started.
  78.  
  79.     Create the relevant directories for SMTPMailDir and SMTPSpoolDir.
  80.  
  81.     A sample script (StartSMTPd) for executing SMTPd is included in
  82.     the INetUtils archive.
  83.  
  84.  
  85. DIAGNOSTICS
  86.  
  87.     SMTPd always returns success, except when initialization fails.
  88.     If initialization fails, SMTPd returns a program value of thirty
  89.     (30).
  90.  
  91.     Various problem conditions, as well as success conditions, are
  92.     logged to the standard INetUtils logfile (INet:Logfile).
  93.  
  94.  
  95. NOTES
  96.  
  97.     SMTPd delivered messages have been tested with AmigaUUCP, GMail,
  98.     AmigaElm, Unix Elm and BBX.
  99.  
  100.     SMTPd is fully compatible with AmigaUUCP 1.16 and above. The
  101.     mailbox folders may be shared (that is, SMTPMailDir may point
  102.     to UUMail:). However, the spool directory may *not* be shared.
  103.     That is, SMTPSpoolDir must not be UUSpool.
  104.  
  105.     The environment variables (or configuration variable) SMTPRMail
  106.     must be specified to indicate a special program to be used to
  107.     deliver incoming mail (AmigaUUCP does this with RMAIL). If
  108.     specified, SMTPd will start the program as follows:
  109.  
  110.             SMTPRMAIL user@host <incoming-file-name
  111.  
  112.     where SMTPRMAIL is the name of the program specified in the
  113.     environment variable, user@host is the incoming address, and
  114.     incoming-file-name is the (SMTPd generated) filename containing
  115.     the incoming message.
  116.  
  117.     It is *highly recommended* that you do the following:
  118.  
  119.             SetEnv SMTPRMail SMTPpost >nil: -r
  120.  
  121.     for aliases to have any hopes of working properly, or that you
  122.     copy SMTPpost as RSMTP and:
  123.  
  124.             SetEnv SMTPRMail RSMTP >nil:
  125.  
  126.     SMTPd uses the HostAliases environment/configuration variable to
  127.     determine what alternate hostnames should be treated as the local
  128.     hostname. . For example, if your host is "x.y.z", but you also
  129.     need to accept mail to "zz.zz" as local to you, you should set
  130.     that in HostAliases.
  131.  
  132.     In general, put "localhost,[ip.address],ip.address" plus any others
  133.     into HostAliases.
  134.  
  135.     The comparison is *not* case sensitive.
  136.  
  137.     NOTE: the freeware version of SMTPd only uses the first two aliases
  138.           specified in HostAliases.
  139.  
  140. BUGS/TODO
  141.  
  142.     Lots yet on the TODO list.
  143.  
  144.     No bugs known.
  145.