home *** CD-ROM | disk | FTP | other *** search
/ Gold Fish 2 / goldfish_vol2_cd1.bin / files / comm / net / inetutils-amitcp / man / smtpd.man < prev    next >
Text File  |  1994-03-14  |  5KB  |  147 lines
  1. SMTPd                                      SMTPd
  2.  
  3.  
  4. NAME
  5.  
  6.     SMTPd - SMTP Daemon for AS-225 release 2 and AmiTCP 2.2+
  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 accepts messages destined for the local host and delivers
  22.     them to the local mailbox. SMTPd will regularly (every two minutes)
  23.     retry previously failed mail which is present in the SMTP Spool
  24.     Directory (to avoid system thrashing, SMTPd will only allow one
  25.     retry to be active at a time).
  26.  
  27.     SMTPd requires one external program to be present for its operation,
  28.     SMTPpost. SMTPpost *must* be in the program search path for SMTPd
  29.     when SMTPd is initiated.
  30.  
  31.     SMTPd requires three environment variables to be assigned, or for
  32.     the variables to be defined in the configuration file (named
  33.     S:UUConfig or UULib:Config, in that order).
  34.  
  35.     The variables are:
  36.  
  37.             SMTPSpoolDir
  38.             SMTPMailDir
  39.             SMTPSmarterHost
  40.  
  41.     SMTPMailDir points to where MailBoxes/Folders are located. It may
  42.     be shared with UUCP MailBoxes and Folders (they are the same format).
  43.  
  44.     SMTPSpoolDir is the directory where SMTP spool files are to be
  45.     located. If SMTPpost cannot locate a destination host, it places
  46.     the articles in this directory, and retries sending the messages on
  47.     a regular basis. It *may not* be shared with UUSpool. The batch
  48.     files are a different format.
  49.  
  50.     SMTPSmarterHost is the SMTP host where mail is sent if a named
  51.     destination host is not reachable. It is presumed to be an Internet
  52.     host which has better routing information than does the host
  53.     running this SMTPd.
  54.  
  55.     The environment variables may be defined as:
  56.  
  57.         Set SMTPMailDir      UUMail:
  58.         Set SMTPSpoolDir     UUStuff:SMTPSpoolDir/
  59.         Set SMTPSmarterHost  Mail.SmarterHost.COM
  60.  
  61.  
  62. INSTALLATION
  63.  
  64.     Simply install the binaries for SMTPd and SMTPpost where-ever you
  65.     wish. Do note that SMTPpost *must* be in the path of SMTPd, whenever
  66.     SMTPd is started.
  67.  
  68.     A sample script (StartSMTPd) for executing SMTPd is included in
  69.     the INetUtils archive.
  70.  
  71.  
  72. DIAGNOSTICS
  73.  
  74.     SMTPd always returns success, except when initialization fails.
  75.     If initialization fails, SMTPd returns a program value of thirty
  76.     (30).
  77.  
  78.     Various problem conditions, as well as success conditions, are
  79.     logged to the standard INetUtils logfile (INet:Logfile).
  80.  
  81.  
  82. NOTES
  83.  
  84.     SMTPd delivered messages have been tested with AmigaUUCP, GMail,
  85.     AmigaElm, Unix Elm and BBX.
  86.  
  87.     SMTPd is fully compatible with AmigaUUCP 1.16 and above. The
  88.     mailbox folders may be shared (that is, SMTPMailDir may point
  89.     to UUMail:).
  90.  
  91.     The environment variables (or configuration variable) SMTPRMail
  92.     may be specified to indicate a special program to be used to
  93.     deliver incoming mail (AmigaUUCP does this with RMAIL). If
  94.     specified, SMTPd will start the program as follows:
  95.  
  96.             SMTPRMAIL user@host <incoming-file-name
  97.  
  98.     where SMTPRMAIL is the name of the program specified in the
  99.     environment variable, user@host is the incoming address, and
  100.     incoming-file-name is the (SMTPd generated) filename containing
  101.     the incoming message.
  102.  
  103.     It is *highly recommended* that you do the following:
  104.  
  105.             SetEnv SMTPRMail SMTPpost >nil: -r
  106.  
  107.     for aliases to have any hopes of working properly.
  108.  
  109.     If SMTPd does the filing itself, a command indicated by the
  110.     MAILREADYCMD environment variable will be executed. The format
  111.     of the command is:
  112.  
  113.         MAILREADYCMD -x T:MailRdy
  114.  
  115.     SMTPd will also send a signal to a program who has a message port
  116.     named "T:MailRdy" made public.
  117.  
  118.     By default, SMTPd scans the SMTPSpoolDir every 2 minutes (120
  119.     seconds). SMTPd will *not* try to send a file until it is at
  120.     least twice that amount of time old (4 minutes). It will try to
  121.     resend files in the spool at 4 minute intervals. You may adjust
  122.     the scan time by using the SMTPDelay configuration variable. It
  123.     is settable in seconds. For example:
  124.  
  125.             SetEnv SMTPDelay 30
  126.  
  127.     will cause SMTPd to scan the spool every 30 seconds, and retry
  128.     files at one minute intervals.
  129.  
  130.     The configuration variable SMTPRoute controls how SMTPd tries to
  131.     send mail. It may be set to either of "SMTP" or "SMARTERHOST".
  132.     When set to SmarterHost, all email is routed to the SmarterHost
  133.     specified (as described above). When set to SMTP, then SMTPd will
  134.     try to send to the host specified first, then to he SmarterHost.
  135.  
  136.  
  137. BUGS/TODO
  138.  
  139.     Lots yet on the TODO list.
  140.  
  141.     No bugs known.
  142.  
  143.         WARNING WILL ROBINSON! One AmiTCP beta tester reported data
  144.         loss. I cannot reproduce it. BE CAREFUL.
  145.  
  146.         You have been warned.
  147.