home *** CD-ROM | disk | FTP | other *** search
/ Danny Amor's Online Library / Danny Amor's Online Library - Volume 1.iso / html / faqs / faq / linux / howto.mail < prev    next >
Encoding:
Text File  |  1995-07-25  |  25.8 KB  |  741 lines
  1. Subject: Linux Electronic Mail HOWTO
  2. Newsgroups: comp.os.linux.announce,comp.os.linux.admin,comp.answers,news.answers
  3. From: vince@victrola.wa.com (Vince Skahan)
  4. Date: Fri, 18 Nov 1994 17:10:44 GMT
  5.  
  6. Archive-name: linux/howto/mail
  7. Last-modified: 26 Oct 94
  8.  
  9.   The Linux Electronic Mail HOWTO
  10.   Vince Skahan, <vince@halcyon.com>
  11.   v1.17, 22 Oct 1994
  12.  
  13.   This document describes the setup and care+feeding of Electronic Mail
  14.   (e-mail) under Linux.  You need to read this if you plan to communi-
  15.   cate locally or to remote sites via electronic mail.  You probably do
  16.   *not* need to read this document if don't exchange electronic mail
  17.   with other users on your system or with other sites.
  18.  
  19.   1.  Introduction
  20.  
  21.   The intent of this document is to answer some of the questions and
  22.   comments that appear to meet the definition of 'frequently asked
  23.   questions' about e-mail software under Linux.
  24.  
  25.   This document and the corresponding UUCP and News 'HOWTO' documents
  26.   collectively supersede the UUCP-NEWS-MAIL-FAQ that has previously been
  27.   posted to comp.os.linux.announce.
  28.  
  29.  
  30.   1.1.  New versions of this document
  31.  
  32.  
  33.   New versions of this document will be periodically posted to
  34.   comp.os.linux.announce, comp.answers, and news.answers.  They will
  35.   also be added to the various anonymous ftp sites who archive such
  36.   information including sunsite.unc.edu:/pub/Linux/docs/HOWTO.
  37.  
  38.  
  39.   In addition, you should be generally able to find this document on the
  40.   Linux WorldWideWeb home page at http://sunsite.unc.edu/mdw/linux.html
  41.   and on my home page at http://www.halcyon.com/vince/welcome.html.
  42.  
  43.  
  44.   1.2.  Feedback
  45.  
  46.  
  47.   I am interested in any feedback, positive or negative, regarding the
  48.   content of this document via e-mail.  Definitely contact me if you
  49.   find errors or obvious omissions.
  50.  
  51.   I read, but do not necessarily respond to, all e-mail I receive.
  52.   Requests for enhancements will be considered and acted upon based on
  53.   that day's combination of available time, merit of the request, and
  54.   daily blood pressure :-)
  55.  
  56.   Flames will quietly go to /dev/null so don't bother.
  57.  
  58.   Feedback concerning the actual format of the document should go to the
  59.   HOWTO coordinator - Matt Welsh (mdw@sunsite.unc.edu).
  60.  
  61.  
  62.   1.3.  Copyright Information
  63.  
  64.  
  65.   The Mail-HOWTO is copyrighted (c)1994 Vince Skahan.
  66.  
  67.   A verbatim copy may be reproduced or distributed in any medium
  68.   physical or electronic without permission of the author.  Translations
  69.   are similarly permitted without express permission if it includes a
  70.   notice on who translated it.
  71.  
  72.   Short quotes may be used without prior consent by the author.
  73.   Derivative work and partial distributions of the Mail-HOWTO must be
  74.   accompanied with either a verbatim copy of this file or a pointer to
  75.   the verbatim copy.
  76.  
  77.   Commercial redistribution is allowed and encouraged; however, the
  78.   author would like to be notified of any such distributions.
  79.  
  80.   In short, we wish to promote dissemination of this information through
  81.   as many channels as possible. However, we do wish to retain copyright
  82.   on the HOWTO documents, and would like to be notified of any plans to
  83.   redistribute the HOWTOs.
  84.  
  85.   We further want that ALL information provided in the HOWTOS is
  86.   disseminated.  If you have questions, please contact Matt Welsh, the
  87.   Linux HOWTO coordinator, at mdw@sunsite.unc.edu.
  88.  
  89.  
  90.   1.4.  Standard Disclaimer
  91.  
  92.  
  93.   Of course, I disavow any potential liability for the contents of this
  94.   document.  Use of the concepts, examples, and/or other content of this
  95.   document is entirely at your own risk.
  96.  
  97.  
  98.   1.5.  Other sources of information
  99.  
  100.  
  101.  
  102.   1.5.1.  LINUX HOWTO Documents:
  103.  
  104.  
  105.   There is plenty of exceptional material provided in the other Linux
  106.   HOWTO documents and from the Linux DOC project.  In particular, you
  107.   might want to take a look at the following:
  108.  
  109.  
  110.   o  the Serial Communications HOWTO
  111.  
  112.   o  the Ethernet HOWTO
  113.  
  114.   o  the Linux Networking Administrators' Guide
  115.  
  116.  
  117.   1.5.2.  USENET:
  118.  
  119.  
  120.  
  121.              comp.mail.elm           the ELM mail system.
  122.              comp.mail.mh            The Rand Message Handling system.
  123.              comp.mail.mime          Multipurpose Internet Mail Extensions.
  124.              comp.mail.misc          General discussions about computer mail.
  125.              comp.mail.multi-media   Multimedia Mail.
  126.              comp.mail.mush          The Mail User's Shell (MUSH).
  127.              comp.mail.sendmail      the BSD sendmail agent.
  128.              comp.mail.smail         the smail mail agent.
  129.              comp.mail.uucp          Mail in the uucp environment.
  130.  
  131.  
  132.  
  133.  
  134.   1.5.3.  Books
  135.  
  136.  
  137.   The following is a non-inclusive set of books that will help...
  138.  
  139.  
  140.  
  141.   o  "Managing UUCP and USENET" from O'Reilly and Associates is in my
  142.      opinion the best book out there for figuring out the programs and
  143.      protocols involved in being a USENET site.
  144.  
  145.   o  "Unix Communications" from The Waite Group contains a nice
  146.      description of all the pieces (and more) and how they fit together.
  147.  
  148.  
  149.   o  "Sendmail" from O'Reilly and Associates looks to be the definitive
  150.      reference on sendmail-v8 and sendmail+IDA.  It's a "must have" for
  151.      anybody hoping to make sense out of sendmail without bleeding in
  152.      the process.
  153.  
  154.   o  "The Internet Complete Reference" from Osborne is a fine reference
  155.      book that explains the various services available on Internet and
  156.      is a great source for information on news, mail, and various other
  157.      Internet resources.
  158.  
  159.   o  "The Linux Networking Administrators' Guide" from Olaf Kirch of the
  160.      Linux DOC Project is available on the net and is also published by
  161.      (at least) O'Reilly and SSC.  It makes a fine one-stop shopping to
  162.      learn about everything you ever imagined you'd need to know about
  163.      Unix networking.
  164.  
  165.  
  166.   1.6.  Where *NOT* to look for help
  167.  
  168.  
  169.   There is nothing "special" about configuring and running mail under
  170.   Linux (any more).  Accordingly, you almost certainly do *NOT* want to
  171.   be posting generic mail-related questions to the comp.os.linux.*
  172.   newsgroups.
  173.  
  174.   Unless your posting is truly Linux-specific (ie, "please tell me what
  175.   routers are already compiled into the SLS1.03 version of smail3.1.28")
  176.   you should be asking your questions in one of the newsgroups or
  177.   mailing lists referenced above.
  178.  
  179.   Let me repeat that.
  180.  
  181.   There is virtually no reason to post anything mail-related in the
  182.   comp.os.linux hierarchy any more.  There are existing newsgroups in
  183.   the comp.mail.* hierarchy to handle *ALL* your questions.
  184.  
  185.   IF YOU POST TO COMP.OS.LINUX.* FOR NON-LINUX-SPECIFIC QUESTIONS, YOU
  186.   ARE LOOKING IN THE WRONG PLACE FOR HELP.  THE ELECTRONIC MAIL EXPERTS
  187.   HANG OUT IN THE PLACES INDICATED ABOVE AND GENERALLY DO NOT RUN LINUX.
  188.  
  189.   POSTING TO THE LINUX HIERARCHY FOR NON-LINUX-SPECIFIC QUESTIONS WASTES
  190.   YOUR TIME AND EVERYBODY ELSE'S...AND IT FREQUENTLY DELAYS YOU FROM
  191.   GETTING THE ANSWER TO YOUR QUESTION.
  192.  
  193.  
  194.   2.  Hardware Requirements
  195.  
  196.   There are no specific hardware requirements for mail under Linux.
  197.  
  198.   You'll need some sort of 'transport' software to connect to remote
  199.   systems, which means either tcp-ip or uucp.   This could mean that you
  200.   need a modem or ethernet card (depending on your setup).
  201.  
  202.  
  203.   3.  Getting the software
  204.  
  205.   In general, I grab my sources from ftp.uu.net and the other fine
  206.   archive sites on Internet.  In addition, Linux-specific binary ports
  207.   are found in the usual Linux distrbutions and on the usual Linux
  208.   anonymous ftp sites (sunsite.unc.edu and tsx-11.mit.edu in
  209.   particular).
  210.  
  211.   The newspak-2.4.tar.z distribution contains config files and readme
  212.   files related to building uucp, news, and mail software under Linux
  213.   from the various freely-available sources.  It can usually be found in
  214.   sunsite.unc.edu:/pub/Linux/system/Mail/news.  If you can't find it on
  215.   sunsite, please send me mail and I'll make sure you get a copy of it.
  216.  
  217.  
  218.   4.  Mail 'Transport Agents'
  219.  
  220.   This section contains information related to 'transport agents', which
  221.   means the underlying software that connects your local system to
  222.   remote systems.
  223.  
  224.  
  225.   4.1.  Smail v3.1
  226.  
  227.   Smail3.1 seems to be a de-facto standard transport agent for uucp-only
  228.   sites and for some smtp sites.  It compiles without patching from the
  229.   sources.  In addition, smail is provided in binary form in the SLS
  230.   distribution of Linux.
  231.  
  232.   The newspak distribution contains config files for smail3.1.28 under
  233.   Linux that you can use to start with.
  234.  
  235.   If you're building smail from sources, you need to have the following
  236.   in your os/linux file so that 'sed' gives you shell scripts that work
  237.   properly.
  238.  
  239.           CASE_NO_NEWLINES=true
  240.  
  241.  
  242.  
  243.   For a uucp-only system that has a MX-record and that wants a
  244.   domainized header (who goes through a smart-host for everything),
  245.   these are the entire config files you'll need:
  246.  
  247.  
  248.   o  replace 'subdomain.domain' with your domain name
  249.  
  250.   o  replace 'myhostname' with you un-domainized hostname
  251.  
  252.   o  replace 'my_uucp_neighbor' with the uucp name of your upstream site
  253.  
  254.  
  255.  
  256.  
  257.  
  258.  
  259.  
  260.  
  261.  
  262.  
  263.  
  264.  
  265.  
  266.  
  267.  
  268.  
  269.  
  270.  
  271.  
  272.  
  273.              #-------- /usr/local/lib/smail/config -----------------
  274.              #
  275.              # domains we belong to
  276.              visible_domain=subdomain.domain:uucp
  277.              #
  278.              # who we're known as (fully-qualified-site-name)
  279.              visible_name=myhostname.subdomain.domain
  280.              #
  281.              # who we go through
  282.              smart_path=my_uucp_neighbor
  283.              #
  284.              #---------- /usr/local/lib/smail/paths --------------
  285.              #
  286.              # we're a domainized site, make sure we accept mail to both names
  287.              myhostname        %s
  288.              myhostname.subdomain.domain      %s
  289.              #
  290.              #-------------------------------------------------------------------
  291.  
  292.  
  293.   To run smail as a smtp daemon, add the following to /etc/inetd.conf:
  294.  
  295.                   smtp stream tcp nowait  root  /usr/bin/smtpd smtpd
  296.  
  297.  
  298.   Outgoing mail gets sent automatically, when using elm. If your inter-
  299.   net link is down when you send mail, then the mail sits in
  300.   "/usr/spool/smail/input".  When the link next comes up, "runq" is run
  301.   which causes the mail to be sent.
  302.  
  303.  
  304.   4.2.  Sendmail+IDA
  305.  
  306.   I run a uucp-only site and use sendmail5.67b+IDA1.5 instead of
  307.   smail3.1.28 due to the incredible ease of use.  There is a binary
  308.   distribution in sunsite.unc.edu:pub/Linux/system/Mail/delivery.  To
  309.   install it:
  310.  
  311.  
  312.   o  you'll probably want to remove (or rename) all the files from smail
  313.      (see the /install/installed directory if you are SLS) to be safe.
  314.  
  315.   o  cd to / then "gunzip -c sendmail5.67b+IDA1.5.tpz | tar xvf -" If
  316.      you have a "modern" tar from a recent Slackware (for example) you
  317.      can probably just do a "tar -zxvf filename.tgz" and get the same
  318.      results.
  319.  
  320.   o  cd to /usr/local/lib/mail/CF and copy the sample.m4 local.m4 file
  321.      to "yourhostname.m4".  Edit out the distributed hostname, aliases,
  322.      and smarthost and put in the correct one for your site.  The
  323.      default file is for a uucp-only site who has domainized headers and
  324.      who talks to a smart host.  Then "make yourhostname.cf" and move
  325.      the resulting file to /etc/sendmail.cf
  326.  
  327.   o  if you are uucp-only, you do *NOT* need to create any of the tables
  328.      mentioned in the README.linux file.  You'll just have to touch the
  329.      files so that the Makefile works.  Just edit the .m4 file, make
  330.      sendmail.cf, and start testing it.
  331.  
  332.   o  if you're uucp-only and you talk to sites in addition to your
  333.      "smart-host", you'll need to add uucpxtable entries for each (or
  334.      mail to them will also go through the smart host) and run dbm
  335.      against the revised uucpxtable.
  336.  
  337.   o  if you use my sendmail5.67b+IDA1.5 distribution you should not use
  338.      a "freeze file".
  339.   o  If you run Rich Braun's original binary distribution of 5.67a,
  340.      you'll need to freeze the configuration if you change your .cf file
  341.      with "/usr/lib/sendmail -bz" to make the changes take effect.  You
  342.      should also update your version to at least 5.67b since there is a
  343.      nasty security hole in 5.67a and earlier.
  344.  
  345.   Another nice thing is that if you have mail.debug set and you run
  346.   syslogd, your incoming and outgoing mail messages will get logged.
  347.   See the /etc/syslog.conf file for details.
  348.  
  349.   The sources for sendmail+IDA may be found at vixen.cso.uiuc.edu.  They
  350.   require no patching to run under Linux if you're running something
  351.   like a kernel of 1.00.
  352.  
  353.   If you're running a current kernel of around 1.1.50, you get the fun
  354.   of reversing most of the Linux-specific patches that are now in the
  355.   vanilla sources.  It's extremely obvious where this needs to be done.
  356.   Just type make and when it blows up, go to that line in the sources
  357.   and comment out the Linux-specific code that's in there.
  358.  
  359.   If you're going to run sendmail+IDA, I strongly recommend you go to
  360.   the sendmail5.67b+IDA1.5 version since all required Linux-specific
  361.   patches are now in the vanilla sources and several security holes have
  362.   been plugged that WERE (!!!) in the older version you may have grabbed
  363.   or built before about December 1st, 1993.
  364.  
  365.   The May/June 1994 edition of Linux Journal has an extensive article on
  366.   the care and feeding of sendmail+IDA.  The new edition of the Linux
  367.   DOC Project Networking Administrator's Guide will have an even more
  368.   detailed and complete version.
  369.  
  370.  
  371.   4.2.1.  The sendmail.m4 file
  372.  
  373.   Sendmail+IDA requires you to set up a sendmail.m4 file rather than
  374.   editing the sendmail.cffile directly.  The nice thing about this is
  375.   that it is simple to set up mail configurations that are extremely
  376.   difficult (if not totally impossible for most people to set up
  377.   correctly) in smail or traditional sendmail.
  378.  
  379.   The sendmail.m4 file that corresponds to the above smail example looks
  380.   like the following:
  381.  
  382.  
  383.  
  384.  
  385.  
  386.  
  387.  
  388.  
  389.  
  390.  
  391.  
  392.  
  393.  
  394.  
  395.  
  396.  
  397.  
  398.  
  399.  
  400.  
  401.  
  402.  
  403.  
  404.  
  405.     dnl #------------------ SAMPLE SENDMAIL.M4 FILE ------------------
  406.     dnl #
  407.     dnl # (the string 'dnl' is the m4 equivalent of commenting out a line)
  408.     dnl #
  409.     dnl # you generally don't want to override LIBDIR from the compiled in paths
  410.     dnl #define(LIBDIR,/usr/local/lib/mail)dnl    # where all support files go
  411.     define(LOCAL_MAILER_DEF, mailers.linux)dnl    # mailer for local delivery
  412.     define(POSTMASTERBOUNCE)dnl                   # postmaster gets bounces
  413.     define(PSEUDODOMAINS, BITNET UUCP)dnl         # don't try DNS on these
  414.     dnl #
  415.     dnl #-------------------------------------------------------------
  416.     dnl #
  417.     dnl # names we're known by
  418.     define(PSEUDONYMS, myhostname.subdomain.domain myhostname.UUCP)
  419.     dnl #
  420.     dnl # our primary name
  421.     define(HOSTNAME, myhostname.subdomain.domain)
  422.     dnl #
  423.     dnl # our uucp name
  424.     define(UUCPNAME, myhostname)dnl
  425.     dnl #
  426.     dnl #-------------------------------------------------------------
  427.     dnl #
  428.     define(UUCPNODES, |uuname|sort|uniq)dnl       # our uucp neighbors
  429.     define(BANGIMPLIESUUCP)dnl                    # make certain that uucp
  430.     define(BANGONLYUUCP)dnl                       #  mail is treated correctly
  431.     define(RELAY_HOST, my_uucp_neighbor)dnl       # our smart relay host
  432.     define(RELAY_MAILER, UUCP-A)dnl               # we reach moria via uucp
  433.     dnl #
  434.     dnl #--------------------------------------------------------------------
  435.     dnl #
  436.     dnl # the various dbm lookup tables
  437.     dnl #
  438.     define(ALIASES, LIBDIR/aliases)dnl            # system aliases
  439.     define(DOMAINTABLE, LIBDIR/domaintable)dnl    # domainize hosts
  440.     define(PATHTABLE, LIBDIR/pathtable)dnl        # paths database
  441.     define(GENERICFROM, LIBDIR/generics)dnl       # generic from addresses
  442.     define(MAILERTABLE, LIBDIR/mailertable)dnl    # mailers per host or domain
  443.     define(UUCPXTABLE, LIBDIR/uucpxtable)dnl      # paths to hosts we feed
  444.     define(UUCPRELAYS, LIBDIR/uucprelays)dnl      # short-circuit paths
  445.     dnl #
  446.     dnl #--------------------------------------------------------------------
  447.     dnl #
  448.     dnl # include the 'real' code that makes it all work
  449.     dnl # (provided with the source code)
  450.     dnl #
  451.     include(Sendmail.mc)dnl                         # REQUIRED ENTRY !!!
  452.     dnl #
  453.     dnl #------------ END OF SAMPLE SENDMAIL.M4 FILE -------
  454.  
  455.  
  456.  
  457.  
  458.  
  459.   4.2.2.  Defining a local mailer
  460.  
  461.   Unlike most Unix distributions, Linux does not come with a local mail
  462.   delivery agent by default.  I recommend using the commonly available
  463.   deliver program, which is an optional package in a number of the usual
  464.   Linux distributions.  In order to do so, you need to define a
  465.   LOCAL_MAILER_DEF in the sendmail.m4 file that points to a file that
  466.   looks like:
  467.  
  468.  
  469.  
  470.  
  471.     # -- /usr/local/lib/mail/mailers.linux --
  472.     #     (local mailers for use on Linux )
  473.     Mlocal, P=/usr/bin/deliver, F=SlsmFDMP, S=10, R=25/10, A=deliver $u
  474.     Mprog,  P=/bin/sh,       F=lsDFMeuP,   S=10, R=10, A=sh -c $u
  475.  
  476.  
  477.  
  478.   There is a also built-in default for deliver in the Sendmail.mc file
  479.   that gets included into the sendmail.cf file.  To specify it, you
  480.   would not use the mailers.linux file but would instead define the
  481.   following in your sendmail.m4 file:
  482.  
  483.  
  484.      dnl --- (in sendmail.m4) ---
  485.      define(LOCAL_MAILER_DEF, DELIVER)dnl       # mailer for local delivery
  486.  
  487.  
  488.  
  489.   Unfortunately, Sendmail.mc assumes deliver is installed in /bin, which
  490.   is not the case with Slackware1.1.1 (which installs it in /usr/bin).
  491.   In that case you'd need to either fake it with a link or rebuild
  492.   deliver from sources so that it resides in /bin.
  493.  
  494.  
  495.   4.2.3.  The Sendmail+IDA dbm Tables
  496.  
  497.   Setting up special behavior for sites or domains is done through a
  498.   number of optional dbm tables rather than editing the sendmail.cf file
  499.   directly.  Refer to the July-1994 issue of Linux Journal, to the docs
  500.   in the sources, or to the sendmail chapter in the newest version of
  501.   the Linux DOC Project Networking Administration Guide which will be
  502.   available real-soon-now for more details.
  503.  
  504.  
  505.   o  mailertable   - defines special behavior for remote hosts or
  506.      domains.
  507.  
  508.   o  uucpxtable    - forces UUCP delivery of mail to hosts that are in
  509.      DNS format.
  510.  
  511.   o  pathtable     - defines UUCP bang-paths to remote hosts or domains.
  512.  
  513.   o  uucprelays    - short-circuits the pathalias path to well-known
  514.      remote hosts.
  515.  
  516.   o  genericfrom   - converts internal addresses into generic ones
  517.      visible to the outside world.
  518.  
  519.   o  xaliases      - converts generic addresses to/from valid internal
  520.      ones.
  521.  
  522.   o  decnetxtable  - converts RFC-822 addresses to DECnet-style
  523.      addresses.
  524.  
  525.  
  526.   4.2.4.  So Which Entries are Really Required?
  527.  
  528.   When not using any of the optional dbm tables, sendmail+IDA delivers
  529.   mail via the DEFAULT_MAILER (and possibly RELAY_HOST and RELAY_MAILER)
  530.   defined in the sendmail.m4 file used to generate sendmail.cf.  It is
  531.   easily possible to override this behavior through entries in the
  532.   domaintable or uucpxtable.
  533.  
  534.   A generic site that is on Internet and speaks Domain Name Service, or
  535.   one that is UUCP-only and forwards all mail via UUCP through a smart
  536.   RELAY_HOST, probably does not need any specific table entries at all.
  537.   Virtually all systems should set the DEFAULT_HOST and PSEUDONYMS
  538.   macros, which define the canonical site name and aliases it is known
  539.   by, and DEFAULT_MAILER.  If all you have is a relay host and relay
  540.   mailer, you don't need to set these defaults since it works
  541.   automagically.
  542.  
  543.   UUCP hosts will probably also need to set UUCPNAME to their official
  544.   UUCP name.  They will also probably set RELAY_MAILER, and RELAY_HOST
  545.   which enable smart-host routing through a mail relay.  The mail
  546.   transport to be used is defined in RELAY_MAILER and should usually be
  547.   UUCP-A for UUCP sites.
  548.  
  549.   If your site is SMTP-only and talks `Domain Name Service', you would
  550.   change the DEFAULT_MAILER to TCP-A and probably delete the
  551.   RELAY_MAILER and RELAY_HOST lines.
  552.  
  553.   If you're a SLIP site, you might want to take the easy way out and
  554.   just forward all outgoing mail to your service provider to do the
  555.   right thing with.  To do so, you'd want to define ISOLATED_DOMAINS and
  556.   VALIDATION_DOMAINS to be your domain, you'd also want to define
  557.   RELAY_HOST to be your service provider and RELAY_MAILER to be TCP. Of
  558.   course, you want to ask permission before you set any system up as
  559.   your general purpose relay.
  560.  
  561.  
  562.   4.3.  Sendmail 8.6
  563.  
  564.   Sendmail 8.6.x from Berkeley is the latest major revision after
  565.   sendmail5.  It has wonderful built-in support for building under
  566.   Linux.  Just "make linux" and you'll be all set.
  567.  
  568.  
  569.   4.4.  Other "transport agents"
  570.  
  571.   The following also are known to run under Linux.  Consult "archie" for
  572.   details regarding how to find them...
  573.  
  574.  
  575.   o  smail2.5 - very simple UUCP-based smail
  576.  
  577.  
  578.   4.5.  Local Delivery Agents
  579.  
  580.   Unlike most operating systems, Linux does not have mail "built-in".
  581.   You'll need a program to deliver the local mail.  One good program is
  582.   Rich Braun's "lmail" program, but I've switched to using the more
  583.   commonly available "deliver" program.
  584.  
  585.   Documentation for how to use either for local delivery is in the
  586.   sendmail5.67b+IDA1.5 binary release (on sunsite) mentioned above.
  587.  
  588.  
  589.   5.  Mail "User Agents"
  590.  
  591.   This section contains information related to "user agents", which
  592.   means the software the user sees and uses.  This software relies on
  593.   the "transport agents" mentioned above.
  594.  
  595.  
  596.   5.1.  Elm
  597.  
  598.   Elm compiles, installs, and runs flawlessly under Linux up to and
  599.   through Slackware 1.1.1 (gcc2.4.5, gcclib 4.4.4).  For more
  600.   information, see the elm sources and installation instructions.
  601.  
  602.  
  603.   The only thing to know is that Elm's Configure script incorrectly sets
  604.   the "ranlib" variable in config.sh.  The Elm Development Team has been
  605.   informed of this little problem, so please don't bother them with it
  606.   (again).
  607.  
  608.  
  609.   o  (from  Chip Rosenthal - chip@chinacat.unicom.com ) The easiest way
  610.      to deal with this is to create a file called config.over at the top
  611.      of you Elm source tree and include the line:
  612.  
  613.              ranlib='ranlib'
  614.  
  615.  
  616.  
  617.   o  Alternatively, you can just remember to correctly edit the line in
  618.      config.sh when Configure gives you the chance to do so.
  619.  
  620.   o  Elm and filter need to be mode 2755 (group mail) with
  621.      /usr/spool/mail mode 775 and group mail.
  622.  
  623.      If you use a binary distribution, you'll need to create a
  624.      /usr/local/lib/elm/elm.rc file to override the compiled-in hostname
  625.      and domain information:
  626.  
  627.  
  628.   o  replace "subdomain.domain" with your domain name replace
  629.  
  630.   o  "myhostname" with you un-domainized hostname replace
  631.  
  632.   o  "my_uucp_neighbor" with the uucp name of your upstream site
  633.  
  634.  
  635.              #---------- /usr/local/lib/elm/elm.rc ------------------
  636.              #
  637.              # this is the unqualified hostname
  638.              hostname = myhostname
  639.              #
  640.              # this is the local domain
  641.              hostdomain = subdomain.domain
  642.              #
  643.              # this is the fully qualified hostname
  644.              hostfullname = myhostname.subdomain.domain
  645.              #
  646.              #--------------------------------------------------------
  647.  
  648.  
  649.   One thing you want to be aware of is that if you have Elm compiled to
  650.   be MIME-able, you need metamail installed and in your path or Elm will
  651.   not be able to read MIME mail you've received.  Metamail is available
  652.   on thumper.bellcore.com and of course via "archie".
  653.  
  654.   We have heard reports that gcc and gcclib newer than v2.4.5 and v4.4.4
  655.   respectively are rather strict and fail to compile Elm.  Here's the
  656.   scoop as reported by  ccnp@unitrix.utr.ac.za (Neil Parker)  who
  657.   forwarded a posting by  longyear@netcom.com (Al Longyear).
  658.  
  659.  
  660.   o  ELM is using internal fields in the FILE structure in an effort to
  661.      bypass the standards. (The _flag, _IOERR, and _IOEOF are old fields
  662.      for the pre-POSIX runtime package. While POSIX doesn't say that you
  663.      can't define these fields, it does not say that you _must_. Linux
  664.      does not. It does say that programs should not be written to use
  665.      them, even if they are in the implementation.)
  666.  
  667.  
  668.  
  669.               where it does         if (fp->_flag & _IOERR) ...
  670.               change it to          if (ferror(fp)) ....
  671.  
  672.               where it does         if (fp->_flag & _IOEOF) ...
  673.               change it to          if (feof(fp)) ...
  674.  
  675.               These are the ANSI/POSIX definitions for the same function.
  676.  
  677.  
  678.  
  679.   o  While this item is not Linux-specific, it's a nagging bug
  680.      nevertheless.  We've heard that Elm sometimes fails with a message
  681.      that it's unable to malloc() some massive number of bytes.  This
  682.      has been identified as an Elm Bug.  The identified workaround is to
  683.      remove the post-processed global mail aliases (aliases.dir and
  684.      aliases.pag).
  685.  
  686.  
  687.   o  (from  scot@catzen.gun.de (Scot W. Stevenson) )
  688.  
  689.      The current metamail package requires csh for some of its scripts.
  690.      Failure to have csh (or tcsh) will cause most interesting errors...
  691.  
  692.  
  693.   5.2.  Mailx
  694.  
  695.   There is a fine binary implementation of mailx located on the various
  696.   Linux archive sites.  Make sure you grab version 5.3b or later since
  697.   there are security problems in v5.3a.  If you're into building from
  698.   sources, mailx v5.5 compiles without patching under Linux if you have
  699.   "pmake" installed.
  700.  
  701.   The only potential problem I'm aware of with the binary distribution
  702.   on sunsite is that it seems to be compiled in a way that requires
  703.   /usr/lib/smail rather than /usr/lib/sendmail as a transport agent.
  704.   You probably need a link if you run sendmail on your system.
  705.  
  706.   If anybody is still using it, I strongly recommend removing the old
  707.   "edmail" stuff from SLS1.00 and replacing it with mailx.
  708.  
  709.  
  710.   5.3.  Other user agents
  711.  
  712.   The following also are known to run under Linux.  Consult "archie" for
  713.   details regarding how to find them...
  714.  
  715.   o  Pine      - from the Univ. of Washington
  716.  
  717.   o  Metamail  - allows MIME support
  718.  
  719.   o  mh      - yet another way to handle mail
  720.  
  721.   o  deliver   - file/process mail based on rules
  722.  
  723.   o  procmail  - file/process mail based on rules
  724.  
  725.   o  Majordomo - manages e-mail lists
  726.  
  727.   o  Mserv     - provide files-by-mail
  728.  
  729.  
  730.   6.  Acknowledgements
  731.  
  732.   The following people have helped in the assembly of the information
  733.   (and experience) that helped make this document possible:
  734.  
  735.   Steve Robbins, Ian Kluft, Rich Braun, Ian Jackson, Syd Weinstein, Ralf
  736.   Sauther, Martin White, Matt Welsh, Ralph Sims, Phil Hughes, Chip
  737.   Rosenthal, Scot Stevenson, Neil Parker
  738.  
  739.   If I forgot anybody, my apologies...
  740.  
  741.