home *** CD-ROM | disk | FTP | other *** search
/ Usenet 1994 January / usenetsourcesnewsgroupsinfomagicjanuary1994.iso / sources / unix / volume4 / uumail3 / part1 / README < prev    next >
Encoding:
Text File  |  1986-11-30  |  8.0 KB  |  179 lines
  1. This is an updated version of uumail (and uupath) that can 
  2. access a pathalias-generated database to facilitate routine mail.
  3.  
  4. These program can cope with DBM and standard line-oriented forms of 
  5. pathalias-generated databases.
  6.  
  7. This version of uumail can be used as uupath by linking uumail to
  8. uupath. Also, this version can handle domain addresses (user@host.domain).
  9. You can put as many addresses on a line as you like.
  10.  
  11. This version provides an alias and forwarding facility. For details on 
  12. aliasing see the file "Alias.Design". The forward facility is similiar to
  13. the one in sendmail. A user may forward his mail by adding a file called
  14. ".forward" in his home directory. This file conatains the address(es) to which
  15. mail is to be forwarded. These addresses are not reprocessed by the aliasing
  16. subroutine, but may be in domain format (if the -DOPATH flag is used when
  17. compiling and the /usr/lib/uucp/domains file is correctly configured).
  18.  
  19. There is also some experimental sections in this release that binary only
  20. sites might like to experiment with. See the file "Binary.Only" for details on
  21. this experiment.
  22.  
  23. There has been some confusion in the past on configuring uumail to work
  24. with sendmail. See the file "Sendmail" for information on this.
  25.  
  26.  *    IF YOU ARE USING A DBM DATABASE, READ THIS!
  27.  *    If the special sentinel value of @@@ is not present in the
  28.  *    database, then getpath will assumed that the database is being
  29.  *    rebuilt and will block for TIMEOUT (default = 180) seconds.  
  30.  *    If, after 5 such blocks, the sentinel is not present,
  31.  *    the error code EX_TEMPFAIL is returned.
  32.  *    The same is true if the dbm files cannot be initialized.
  33.  *    Please be sure to add the sentinal to the DBM database when
  34.  *    it is created.
  35.  *    To add the sentinel, use the "makedb" command.
  36.  *    makedb -a dbrootname < @@@
  37.  *    should append the sentinel to the database.
  38.  
  39. There are some compile flags to be aware of when making uumail.
  40. When defining these, place them on the OPTIONS line in the makefile.
  41. Here is a list of them.
  42.  
  43. DEBUG compiles in the debugging code.
  44. OPATH causes the opath subroutine to be used to resolve addresses.
  45. If you do not use this flag, you cannot use the user@host.domain style
  46. addresses with uumail.
  47. DBM causes uumail to use the DBM format patalias database. If you do not
  48. have the dbm libraries, do not use this flag.
  49. SYSIII will make adjustments for system that are derived from UNIX System
  50. III or System V.
  51. NOGRADE should be used if your uux does not understand the -g flag.
  52. NORETURN should be used if your uux does not understand the -a flag.
  53. LOG will enable logging of uumail traffic (be sure that the file
  54. you specify in uuconf.h is world writable or this option will not work).
  55. UGLYUUCP causes the From_ line produced by uumail to contain the
  56. "remote from hostname" string. This is usually necessary for reliable
  57. use of uumail especially on SYSV and V7 machines.
  58. GETHOSTNAME will cause the system call gethostname to be used. If you
  59. are a BSD site, define this.
  60. SYSTEMNAME will cause the systemname to be derived from the file
  61. /usr/lib/uucp/SYSTEMNAME. This should be defined if your machine
  62. is a Sperry 5000.
  63. SORTED will cause the non-DBM database to be searched fasted, BUT
  64. it assumes that this database is SORTED. If you do not sort your
  65. database, do not define this.
  66. NOALIAS will not compile in the Aliasing and Forward facilities.
  67. You probably want to define this if you are running sendmail or some
  68. other mailer that already does this.
  69. OPIMIZE will attempt to send mail by a "more optimal" path. This
  70. is experimental.
  71. RFC976 will cause uumail to behave as a CLASS 3 mailer as defined in 
  72. RFC976. Defining this flag may cause your mail to behave differently
  73. than it has in the past (particularly if you are a UUCP-only site). Please
  74. be sure to read the RFC carefully to understand the differences between
  75. the different class of mailers. See more on this below.
  76.  
  77. There are some other items that should be noted when configuring uumail.
  78. In the makefile, set UUMAIL equal to the location of the uumail program
  79. on your system FOLLOWING INSTALLATION! Set REALUUX equal to the location
  80. of the uux program. This will be /usr/bin/uux on most systems. Binary
  81. only site should check the "Binary.Only" file for more information on
  82. the use of this symbol. BINDIR should be set to the directory you want
  83. the address and uupath program to go, usually /usr/ucb, /usr/local, or
  84. /usr/lbin.
  85.  
  86. If you want to install this system, use "make install". If you want
  87. to have it do all the work for incoming mail, type "make mailer". You
  88. probably do not want to "make mailer" if you run sendmail.
  89.  
  90. A manual page for address, opath, uumail and uupath are included.
  91.  
  92.  
  93. RFC976 Compliance notes
  94.  
  95. Uumail is capable of satisfying Class 3 requirements as specified in
  96. RFC976. It can also be compiled to satisfy Class 2 and Class 1 requirements
  97. only. Here are the appropriate compile time flags for compliance with
  98. with the three classes; these are only the flags necessary to make 
  99. uumail perform in a particular class. Other flags may be needed to use
  100. the dbm-type database and other options. It should be noted that each
  101. higher numbered class is a superset of the lower numbered class,
  102. so if you are a class 3 you will automatically comply with Classes 1
  103. and 2. The following is excerpted from the RFC976 document.
  104.  
  105.  
  106.    Class 1   old-style UUCP ! routing only.  We assume that the host
  107.              understands local user names:
  108.  
  109.                   rmail user
  110.  
  111.              and bang paths
  112.  
  113.                   rmail host1!host2!user
  114.  
  115.              but we assume nothing more about the host.  If we have
  116.              no information about a host, we can treat it as class 1
  117.              with no problems, since we make no assumptions about
  118.              how it will handle hybrid addresses.
  119.  
  120. COMPILE FLAGS NEED FOR THIS CLASS: UGLYUUCP
  121.  
  122.  
  123.  
  124.    Class 2   Old style UUCP ! routing, and 4.2BSD style domain
  125.              parsing.  We assume the capabilities of class 1, plus
  126.              the ability to understand
  127.  
  128.                   rmail user@domain
  129.  
  130.              if the "domain" is one outside the UUCP zone which
  131.              the host knows about.  Class 2 hosts do not necessarily
  132.              understand domain!user or have routers.  Hosts in non-
  133.  
  134.              UUCP RFC-920 domains are considered class 2, even though
  135.              they may not understand host!user.
  136.  
  137. COMPILE FLAGS NEED FOR THIS CLASS: OPATH UGLYUUCP
  138.  
  139.    Class 3   All class 1 and 2 features are present.  In addition,
  140.              class 3 hosts must be able to route UUCP mail for hosts
  141.              that are not immediately adjacent and also understand
  142.              the syntax
  143.  
  144.                   rmail domain!user
  145.  
  146.              as described above.  All gateways into UUCP must be
  147.              class 3.
  148.  
  149. COMPILE FLAGS NEED FOR THIS CLASS: OPATH UGLYUUCP RFC976
  150.  
  151. One final note: Uumail does not use the Algorithm specified in RFC976
  152. to perform its work. That algorithm is likely to be a part of
  153. the Batch SMTP program referred to in the RFC.
  154.  
  155. Please forward comments and bug fixes to me at sob@rice.edu or 
  156. ihnp4!shell!soma!sob or seismo!drillsys!sob or sdcsvax!drillsys!sob.
  157.  
  158. Stan Barber
  159. Baylor College of Medicine
  160. Houston, Texas
  161.  
  162. P.S. My thanks to all those who reported bugs from the previous release.
  163. Please continue to send them in, and I will try to keep fixing them.
  164.  
  165.  
  166. ***************************************************************************
  167. This work in its current form is Copyright 1986 Stan Barber
  168. with the exception of opath, gethostname and the original getpath which
  169. as far as I know are in the Public Domain. This software may be distributed
  170. freely as long as no profit is made from such distribution and this notice
  171. is reproducted in whole.
  172. ***************************************************************************
  173. This software is provided on an "as is" basis with no guarantee of 
  174. usefulness or correctness of operation for any purpose, intended or
  175. otherwise. The author is in no way liable for this software's performance
  176. or any damage it may cause to any data of any kind anywhere.
  177. ***************************************************************************
  178.  
  179.