home *** CD-ROM | disk | FTP | other *** search
/ Hacker Chronicles 2 / HACKER2.BIN / 482.SMTP.DOC < prev    next >
Text File  |  1987-08-26  |  5KB  |  99 lines
  1. Documentation for Installing SMTP Functionality for the KA9Q TCP/IP Package
  2. By Bdale Garbee, N3EUA - last revised 870826
  3.  
  4. As supplied, the SMTP server and client make assumptions about the
  5. disk space available to them.  In particular, the file handling portion of
  6. the client and server will need to be modified heavily if used on any 
  7. operating system other than PC-Dos or MS-Dos.  Sorry.
  8.  
  9. To achieve minimum functionality, you should:
  10.  
  11.     - create directories \spool\mail and \spool\mqueue on the default
  12.       disk used when running net.exe... the mail directory is used by
  13.       the server for storing incoming mail, the mqueue directory is 
  14.       where the client looks to find outbound messages that need to
  15.       be delivered.
  16.  
  17. There is one command in net.exe that relates to the SMTP client operation.
  18. It is 'smtp'.  Issuing this command will cause the client to attempt to
  19. deliver mail immediately.  Normally, the client will fire up 15mins after
  20. the end of the previous invocation to try and process outbound mail.  The
  21. smtp command is primarily a debugging tool, and should be used as such.
  22.  
  23. File Formats:
  24.  
  25. Incoming mail for users on the current host gets placed in 'mailbox' files
  26. in the \spool\mail directory.  The name of the file is based on the user
  27. name given by the sending SMTP agent.  These are simple text files, with
  28. new messages appended to the end.  If a mailbox file does not exist, the
  29. server will create it automagically.  Messages in the files are in RFC822
  30. format, with new messages appended to the end.  The first line of each
  31. message will always start with the token 'Received:', quotes not included.
  32. This line is added by the server to indicate the date and time the message
  33. was received, and the host it was received from.
  34.  
  35. Outgoing mail messages consist of two files each in the \spool\mqueue 
  36. directory.  The names of the two files will be of the form <integer>.WRK
  37. and <integer>.TXT, where integer is the sequence number of the message
  38. relative to this machine.  The file sequence.seq in the mqueue directory
  39. contains the current sequence number for reference by the mail user 
  40. interface.  The .TXT file contains the data portion of the SMTP transaction,
  41. in full RFC822 format.  The .WRK file consists of 3 lines, as follows:
  42.  
  43.     - the hostname of the destination system 
  44.  
  45.     - the full sender address, in user@host format.
  46.  
  47.     - the full destination address, in user@host format.
  48.  
  49. The mailer does not yet support multiple recipients; when it does, the .wrk
  50. file format will contain extra destination address lines, one for each
  51. additional recipient.
  52.  
  53. Bugs and Limitations:
  54.  
  55. The SMTP server does not allow forwarding.  In a perfect world, forwarding
  56. is a crock.  Since we do not live in a perfect world, some specialized
  57. forward capability will probably be added eventually... though we'd like
  58. to avoid it!  Better to just put a bsd4.X system on the air and let Sendmail
  59. handle the grody work!  :-)
  60.  
  61. The SMTP client only understands a single destination address in the TO
  62. line.  This is a legal minimal implementation of the standard, but will
  63. eventually change.  Note that the format of the .WRK file will change when
  64. this does, of necessity.
  65.  
  66. Error returns from the remote server are not properly handled. The mailer
  67. will keep trying to deliver the mail each time the smtp command is issued
  68. (or invoked automatically by the timer).  There is as yet no mechanism for
  69. "bouncing" mail back to the sender when it cannot be sent.
  70.  
  71. The smtp client (mail sender) code in net.exe now tries to connect to
  72. all destination hosts simultaneously. If there is a lot of mail in
  73. the outbound queue, this may cause problems. In particular, try using
  74. the FILES= parameter in the MS-DOS config.sys file to allow net.exe to
  75. have more than the default 8 files open at once.
  76.  
  77. For More Information:
  78.  
  79. For documentation on the mail user interface for PC compatibles, read the
  80. BM.DOC file.
  81.  
  82. The SMTP specification is RFC821.  The Format for text messages (including
  83. the headers) is in RFC822.  RFC819 discusses hostname naming conventions,
  84. particularly domain naming.
  85.  
  86. I can be contacted at the following address, and would greatly appreciate
  87. feedback on the SMTP support.  In particular, if anyone makes any changes
  88. to the code, please send me a copy for inclusion in the distribution...
  89.  
  90.     Bdale Garbee, N3EUA
  91.     1433 Territory Trail
  92.     Colorado Springs, CO  80919
  93.  
  94.     arpa: pitt!winfree!bdale@cadre.dsl.pittsburgh.edu
  95.           bellcore!winfree!bdale@flash.bellcore.com
  96.     uucp: {bellcore,crash,hpcsma,pitt,usafa,vixie}!winfree!bdale
  97.     fido: sysop 128/19, the HIP Shack
  98.     packet: n3eua@wb0blv Colorado Springs
  99.