home *** CD-ROM | disk | FTP | other *** search
/ Usenet 1994 January / usenetsourcesnewsgroupsinfomagicjanuary1994.iso / sources / misc / volume2 / final-xenix-smail / X.README < prev   
Encoding:
Text File  |  1991-08-07  |  4.5 KB  |  127 lines
  1. X.README
  2.  
  3. This file describes how to use the enclosed smail 2.5 patches for SCO Xenix
  4. System V.  (They may work with non-SCO Xenix.)
  5.  
  6. To use these patches, you need either (1) Larry Wall's "patch" program, or
  7. (2) lots of patience while you apply these changes by hand.
  8.  
  9.  
  10. For users of my earlier smail patches:
  11.  
  12.     I posted some early smail patches in comp.unix.xenix and
  13.     alt.sources in December '87.  If you are using those patches, you
  14.     should get rid of them and USE THESE PATCHES INSTEAD.
  15.  
  16.     Why?
  17.  
  18.     1.  Cleaner mods (only important things have been changed).
  19.     2.  Better comments.
  20.     3.  Explicit support for Micnet/Xenix-Net.
  21.     4.  Support for /etc/systemid file (no need to relink your
  22.         kernel to change your machine name).
  23.  
  24.  
  25. Installation:
  26.  
  27.     1.  Find your original, untouched smail 2.5 sources.  Copy these
  28.         to a new directory.  (We'll call it "/usr/src/xsmail".)
  29.         If you don't have your original sources, some (or many!)
  30.         patches may fail, possibly introducing problems.
  31.  
  32.     2.  Unpack this sharchive and move the files in this sharchive into
  33.         /usr/src/xsmail.  This will overwrite the distributed Makefile,
  34.         so you may want to rename the original Makefile first.
  35.  
  36.     3.  Change to /usr/src/xsmail and run "patch <X.patches".  This
  37.         does the hard work of changing source files.
  38.  
  39.         This step will leave ".orig" files lying around.  You may
  40.         remove these at any time, but I'd leave them until installation
  41.         is complete just to be on the safe side.  If any patches fail
  42.         -- which should only occur if you're starting with modfied
  43.         sources -- the failed patches will be written to ".rej" files.
  44.  
  45.     4.  Examine defs.h and modify it as necessary for your machine(s).
  46.         Specifically, if you're running Micnet or Xenix-Net, you'll
  47.         probably want to uncomment "#define MICNET". (Or you can
  48.         include "-DMICNET" in the CFLAGS in the Makefile.)
  49.  
  50.     5.  Run "make" to make smail and execm, or if you prefer, run
  51.         "make all".
  52.  
  53.     6.  >As root<, run "./install_smail".
  54.  
  55.  
  56. The above steps should result in:
  57.  
  58.     /usr/bin/rmail moved to /usr/bin/rmail.x and never used again.
  59.  
  60.     Smail installed as /usr/bin/smail with a link to /usr/bin/rmail.
  61.  
  62.     /usr/lib/mail/execmail moved to /usr/lib/mail/execmail.x.  Smail
  63.     then uses execmail.x for delivering local mail. (If you compile
  64.     smail with MICNET defined, then execmail.x is used for delivering
  65.     _all_ mail, not just local mail.)
  66.  
  67.     The program execm.c installed as /usr/lib/mail/execmail.  This
  68.     "fake" execmail just parses its arguments and overlays itself with
  69.     smail, which does all the work. (The /bin/mail program uses
  70.     execmail, so we can't ignore it.  I would have just linked
  71.     /usr/bin/smail to /usr/lib/mail/execmail, but their arguments are
  72.     different.)
  73.  
  74.  
  75. Notes on aliasing:
  76.  
  77.     The normal Xenix aliasing mechanism is still intact. (You know,
  78.     /usr/lib/aliases, maliases, and faliases.) In addition, smail
  79.     aliases using the file /usr/lib/mail/saliases.  This file has a
  80.     format which is almost, but not quite, entirely unlike the Xenix
  81.     aliases file.  See the smail "aliases.c" for some hints.  The main
  82.     difference is that you can include a name in parentheses after the
  83.     alias:
  84.  
  85.         postmaster:     chip                    (mail administrator)
  86.         rick:           rick@uunet.uu.net       (Rick Adams)
  87.  
  88.     The nice thing about having two alias files is that smail's aliases
  89.     can be internet-style addresses ("user@domain"), and execmail's
  90.     aliases can be pipes ("|/usr/lib/news/uurec").  If you use Micnet,
  91.     the network utilities will stomp on the Xenix aliases file but
  92.     leave the saliases file untouched.
  93.  
  94.  
  95. Notes on the use of /bin/mail:
  96.  
  97.     If you want to use Internet-style addresses with /bin/mail, you
  98.     have to add the line "set execmail" to /usr/lib/mail/mailrc.
  99.     Otherwise, /bin/mail assumes that addresses without bangs must be
  100.     valid local users.  Of course, you can use the bang notation with
  101.     domains and /bin/mail will always be happy.
  102.  
  103.     If you do any significant amount of mail work, forget /bin/mail and
  104.     use Elm.  It's the best thing since System V.  :-)
  105.  
  106.  
  107. One final comment:
  108.  
  109.     I'd like to have some idea of how widely used these patches are.
  110.     So when you get it working -- or if you can't! -- drop me a line
  111.     and tell me about it. (My address is ateng!chip.  If you can't find
  112.     a valid path, try going through codas or uunet.)
  113.  
  114.  
  115. Obligatory quote:
  116.  
  117.     "INVESTIGATE your point of view, don't just dogmatize it!
  118.     Reflect on it and re-evaluate it.  You may want to change
  119.     your mind someday."
  120.                 -- Tim Reingold, from alt.flame
  121.  
  122. Signature:
  123.  
  124.     Chip Salzenberg <chip@ateng.UUCP>
  125.     A T Engineering, Tampa, FL
  126.     06 January 1988
  127.