rearrange and update the fAQ
authorEric Allman <eric@ucbvax.Berkeley.EDU>
Sat, 10 Dec 1994 00:03:19 +0000 (16:03 -0800)
committerEric Allman <eric@ucbvax.Berkeley.EDU>
Sat, 10 Dec 1994 00:03:19 +0000 (16:03 -0800)
SCCS-vsn: usr.sbin/sendmail/FAQ 8.9

usr/src/usr.sbin/sendmail/FAQ

index a2a076c..8b9feb6 100644 (file)
@@ -1,13 +1,16 @@
                            Sendmail Version 8
                        Frequently Asked Questions
                            Sendmail Version 8
                        Frequently Asked Questions
-                        Version 8.8 of %G%
+                        Version 8.9 of %G%
 
 
 This FAQ is specific to Version 8 of sendmail.  Other questions,
 particularly regarding compilation and configuration, are answered
 in src/READ_ME and cf/README (found in the V8 sendmail distribution).
 
 
 
 This FAQ is specific to Version 8 of sendmail.  Other questions,
 particularly regarding compilation and configuration, are answered
 in src/READ_ME and cf/README (found in the V8 sendmail distribution).
 
-----------------------------------------------------------------------
+======================================================================
+GENERAL QUESTIONS
+======================================================================
+
   * What do you wish everyone would do before sending you mail?
 
        Read this FAQ completely.  Read src/READ_ME and cf/README
   * What do you wish everyone would do before sending you mail?
 
        Read this FAQ completely.  Read src/READ_ME and cf/README
@@ -29,6 +32,30 @@ in src/READ_ME and cf/README (found in the V8 sendmail distribution).
        was released, when everything on the 4.4 tape was set to be
        version 8.1.  Version 7.x never existed.
 ----------------------------------------------------------------------
        was released, when everything on the 4.4 tape was set to be
        version 8.1.  Version 7.x never existed.
 ----------------------------------------------------------------------
+  * What books are available describing sendmail?
+
+       There is one book available devoted to sendmail:
+
+           Costales, Allman, and Rickert, _Sendmail_.  O'Reilly &
+               Associates.
+
+       Several books have sendmail chapters, for example:
+
+           Nemeth, Snyder, and Seebass, _Unix System Administration
+               Handbook_.  Prentice-Hall.
+           Carl-Mitchell and Quarterman, _Practical Internetworking with
+               TCP/IP and UNIX_.  Addison-Wesley.
+           Hunt, _TCP/IP Network Administration_.  O'Reilly & Associates.
+
+       Another book about sendmail is due out "soon":
+
+           Avolio & Vixie, _Sendmail Theory and Practice_.  Digital
+               Press (release date unknown).
+
+======================================================================
+COMPILING AND INSTALLING SENDMAIL 8
+======================================================================
+
   * Version 8 requires a new version of "make".  Where can I get this?
 
        Actually, Version 8 does not require a new version of "make".
   * Version 8 requires a new version of "make".  Where can I get this?
 
        Actually, Version 8 does not require a new version of "make".
@@ -68,27 +95,11 @@ in src/READ_ME and cf/README (found in the V8 sendmail distribution).
        (see above).
 
        This macro set is also available with newer versions of groff.
        (see above).
 
        This macro set is also available with newer versions of groff.
-----------------------------------------------------------------------
-  * What books are available describing sendmail?
 
 
-       There is one book available devoted to sendmail:
+======================================================================
+CONFIGURATION QUESTIONS
+======================================================================
 
 
-           Costales, Allman, and Rickert, _Sendmail_.  O'Reilly &
-               Associates.
-
-       Several books have sendmail chapters, for example:
-
-           Nemeth, Snyder, and Seebass, _Unix System Administration
-               Handbook_.  Prentice-Hall.
-           Carl-Mitchell and Quarterman, _Practical Internetworking with
-               TCP/IP and UNIX_.  Addison-Wesley.
-           Hunt, _TCP/IP Network Administration_.  O'Reilly & Associates.
-
-       Another book about sendmail is due out "soon":
-
-           Avolio & Vixie, _Sendmail Theory and Practice_.  Digital
-               Press (release date unknown).
-----------------------------------------------------------------------
   * How do I make all my addresses appear to be from a single host?
 
        Using the V8 configuration macros, use:
   * How do I make all my addresses appear to be from a single host?
 
        Using the V8 configuration macros, use:
@@ -169,6 +180,126 @@ in src/READ_ME and cf/README (found in the V8 sendmail distribution).
 
        Finger services should be as fuzzy as possible (within
        reason, of course).  Mail services should be unique.
 
        Finger services should be as fuzzy as possible (within
        reason, of course).  Mail services should be unique.
+----------------------------------------------------------------------
+  * Should I use a wildcard MX for my domain?
+
+       If at all possible, no.
+
+       Wildcard MX records have lots of semantic "gotcha"s.  For
+       example, they will match a host "unknown.your.domain" -- if
+       you don't explicitly test for unknown hosts in your domain,
+       you will get "config error: mail loops back to myself"
+       errors.
+----------------------------------------------------------------------
+  * How can I get sendmail to deliver local mail to $HOME/.mail
+    instead of into /usr/spool/mail (or /usr/mail)?
+
+       This is a local mailer issue, not a sendmail issue.  Either
+       modify your local mailer (source code will be required) or
+       change the program called in the "local" mailer configuration
+       description to be a new program that does this local delivery.
+       I understand that "procmail" works well, although I haven't
+       used it myself.
+
+       You might be interested in reading the paper ``HLFSD: Delivering
+       Email to your $HOME'' available in the Proceedings of the
+       USENIX System Administration (LISA VII) Conference (November
+       1993).  This is also available via public FTP from
+       ftp.cs.columbia.edu:/pub/hlfsd/{README.hlfsd,hlfsd.ps}.
+----------------------------------------------------------------------
+  * I'm trying to to get my mail to go into queue only mode, and it
+    delivers the mail interactively anyway.  (Or, I'm trying to use
+    the "don't deliver to expensive mailer" flag, and it doesn't
+    delivers the mail interactively anyway.)  I can see it does it:
+    here's the output of "sendmail -v foo@somehost" (or Mail -v or
+    equivalent).
+
+       The -v flag to sendmail (which is implied by the -v flag to
+       Mail and other programs in that family) tells sendmail to
+       watch the transaction.  Since you have explicitly asked to
+       see what's going on, it assumes that you do not want to to
+       auto-queue, and turns that feature off.  Remove the -v flag
+       and use a "tail -f" of the log instead to see what's going on.
+
+       If you are trying to use the "don't deliver to expensive mailer"
+       flag (mailer flag "e"), be sure you also turn on global option
+       "c" -- otherwise it ignores the mailer flag.
+----------------------------------------------------------------------
+  * There are four UUCP mailers listed in the configuration files.
+    Which one should I use?
+
+       The choice is partly a matter of local preferences and what is
+       running at the other end of your UUCP connection.  Unlike good
+       protocols that define what will go over the wire, UUCP uses
+       the policy that you should do what is right for the other end;
+       if they change, you have to change.  This makes it hard to
+       do the right thing, and discourages people from updating their
+       software.  In general, if you can avoid UUCP, please do.
+
+       If you can't avoid it, you'll have to find the version that is
+       closest to what the other end accepts.  Following is a summary
+       of the UUCP mailers available.
+
+       uucp-old (obsolete name: "uucp")
+         This is the oldest, the worst (but the closest to UUCP) way of
+         sending messages accros UUCP connections.  It does bangify
+         everything and prepends $U (your UUCP name) to the sender's
+         address (which can already be a bang path itself).  It can
+         only send to one address at a time, so it spends a lot of
+         time copying duplicates of messages.  Avoid this if at all
+         possible.
+
+       uucp-new (obsolete name: "suucp")
+         The same as above, except that it assumes that in one rmail
+         command you can specify several recipients.  It still has a
+         lot of other problems.
+
+       uucp-dom
+         This UUCP mailer keeps everything as domain addresses.
+         Basically, it uses the SMTP mailer rewriting rules.
+
+         Unfortunately, a lot of UUCP mailer transport agents require
+         bangified addresses in the envelope, although you can use
+         domain-based addresses in the message header.  (The envelope
+         shows up as the From_ line on UNIX mail.)  So....
+
+       uucp-uudom
+         This is a cross between uucp-new (for the envelope addresses)
+         and uucp-dom (for the header addresses).  It bangifies the
+         envelope sender (From_ line in messages) without adding the
+         local hostname, unless there is no host name on the address
+         at all (e.g., "wolf") or the host component is a UUCP host name
+         instead of a domain name ("somehost!wolf" instead of
+         "some.dom.ain!wolf").
+
+       Examples:
+
+       We are on host grasp.insa-lyon.fr (UUCP host name "grasp").  The
+       following summarizes the sender rewriting for various mailers.
+
+       Mailer          sender          rewriting in the envelope
+       ------          ------          -------------------------
+       uucp-{old,new}  wolf            grasp!wolf
+       uucp-dom        wolf            wolf@grasp.insa-lyon.fr
+       uucp-uudom      wolf            grasp.insa-lyon.fr!wolf
+
+       uucp-{old,new}  wolf@fr.net     grasp!fr.net!wolf
+       uucp-dom        wolf@fr.net     wolf@fr.net
+       uucp-uudom      wolf@fr.net     fr.net!wolf
+
+       uucp-{old,new}  somehost!wolf   grasp!somehost!wolf
+       uucp-dom        somehost!wolf   somehost!wolf@grasp.insa-lyon.fr
+       uucp-uudom      somehost!wolf   grasp.insa-lyon.fr!somehost!wolf
+
+======================================================================
+RESOLVING PROBLEMS
+======================================================================
+
+  * When I compile, I get "undefined symbol inet_aton" messages.
+
+       You've probably replaced your resolver with the version from
+       BIND 4.9.3.  You need to cmpile with -l44bsd in order to get
+       the additional routines.
 ----------------------------------------------------------------------
   * I'm getting "Local configuration error" messages, such as:
 
 ----------------------------------------------------------------------
   * I'm getting "Local configuration error" messages, such as:
 
@@ -192,10 +323,6 @@ in src/READ_ME and cf/README (found in the V8 sendmail distribution).
                sh -c "`tail -1 /etc/sendmail.pid`"
 
        NOTA BENE:  kill -1 does not work!
                sh -c "`tail -1 /etc/sendmail.pid`"
 
        NOTA BENE:  kill -1 does not work!
-----------------------------------------------------------------------
-  * OK, I did that, and the problem still occurs.
-
-       You probably forgot to to resta
 ----------------------------------------------------------------------
   * When I use sendmail V8 with a Sun config file I get lines like:
 
 ----------------------------------------------------------------------
   * When I use sendmail V8 with a Sun config file I get lines like:
 
@@ -213,16 +340,6 @@ in src/READ_ME and cf/README (found in the V8 sendmail distribution).
        Config Files to Sendmail Version 8", in the contrib directory
        (file "converting.sun.configs") on the sendmail distribution
        for a full discussion of how to do this.
        Config Files to Sendmail Version 8", in the contrib directory
        (file "converting.sun.configs") on the sendmail distribution
        for a full discussion of how to do this.
-----------------------------------------------------------------------
-  * Should I use a wildcard MX for my domain?
-
-       If at all possible, no.
-
-       Wildcard MX records have lots of semantic "gotcha"s.  For
-       example, they will match a host "unknown.your.domain" -- if
-       you don't explicitly test for unknown hosts in your domain,
-       you will get "config error: mail loops back to myself"
-       errors.
 ----------------------------------------------------------------------
   * I'm connected to the network via a SLIP link.  Sometimes my sendmail
     process hangs (although it looks like part of the message has been
 ----------------------------------------------------------------------
   * I'm connected to the network via a SLIP link.  Sometimes my sendmail
     process hangs (although it looks like part of the message has been
@@ -275,22 +392,6 @@ in src/READ_ME and cf/README (found in the V8 sendmail distribution).
        You need OSTYPE(systype) in your .mc file -- otherwise the
        configurations use a default that probably disagrees with
        your local mail system.  See cf/README for details.
        You need OSTYPE(systype) in your .mc file -- otherwise the
        configurations use a default that probably disagrees with
        your local mail system.  See cf/README for details.
-----------------------------------------------------------------------
-  * How can I get sendmail to deliver local mail to $HOME/.mail
-    instead of into /usr/spool/mail (or /usr/mail)?
-
-       This is a local mailer issue, not a sendmail issue.  Either
-       modify your local mailer (source code will be required) or
-       change the program called in the "local" mailer configuration
-       description to be a new program that does this local delivery.
-       I understand that "procmail" works well, although I haven't
-       used it myself.
-
-       You might be interested in reading the paper ``HLFSD: Delivering
-       Email to your $HOME'' available in the Proceedings of the
-       USENIX System Administration (LISA VII) Conference (November
-       1993).  This is also available via public FTP from
-       ftp.cs.columbia.edu:/pub/hlfsd/{README.hlfsd,hlfsd.ps}.
 ----------------------------------------------------------------------
   * Under V8, the "From " header gets mysteriously munged when I send
     to an alias.
 ----------------------------------------------------------------------
   * Under V8, the "From " header gets mysteriously munged when I send
     to an alias.
@@ -310,94 +411,31 @@ in src/READ_ME and cf/README (found in the V8 sendmail distribution).
 
        This will make message sent to "list" come out as being
        "From list-request" instead of "From eric".
 
        This will make message sent to "list" come out as being
        "From list-request" instead of "From eric".
-----------------------------------------------------------------------
-  * There are four UUCP mailers listed in the configuration files.
-    Which one should I use?
-
-       The choice is partly a matter of local preferences and what is
-       running at the other end of your UUCP connection.  Unlike good
-       protocols that define what will go over the wire, UUCP uses
-       the policy that you should do what is right for the other end;
-       if they change, you have to change.  This makes it hard to
-       do the right thing, and discourages people from updating their
-       software.  In general, if you can avoid UUCP, please do.
-
-       If you can't avoid it, you'll have to find the version that is
-       closest to what the other end accepts.  Following is a summary
-       of the UUCP mailers available.
-
-       uucp-old (obsolete name: "uucp")
-         This is the oldest, the worst (but the closest to UUCP) way of
-         sending messages accros UUCP connections.  It does bangify
-         everything and prepends $U (your UUCP name) to the sender's
-         address (which can already be a bang path itself).  It can
-         only send to one address at a time, so it spends a lot of
-         time copying duplicates of messages.  Avoid this if at all
-         possible.
-
-       uucp-new (obsolete name: "suucp")
-         The same as above, except that it assumes that in one rmail
-         command you can specify several recipients.  It still has a
-         lot of other problems.
-
-       uucp-dom
-         This UUCP mailer keeps everything as domain addresses.
-         Basically, it uses the SMTP mailer rewriting rules.
-
-         Unfortunately, a lot of UUCP mailer transport agents require
-         bangified addresses in the envelope, although you can use
-         domain-based addresses in the message header.  (The envelope
-         shows up as the From_ line on UNIX mail.)  So....
-
-       uucp-uudom
-         This is a cross between uucp-new (for the envelope addresses)
-         and uucp-dom (for the header addresses).  It bangifies the
-         envelope sender (From_ line in messages) without adding the
-         local hostname, unless there is no host name on the address
-         at all (e.g., "wolf") or the host component is a UUCP host name
-         instead of a domain name ("somehost!wolf" instead of
-         "some.dom.ain!wolf").
-
-       Examples:
-
-       We are on host grasp.insa-lyon.fr (UUCP host name "grasp").  The
-       following summarizes the sender rewriting for various mailers.
-
-       Mailer          sender          rewriting in the envelope
-       ------          ------          -------------------------
-       uucp-{old,new}  wolf            grasp!wolf
-       uucp-dom        wolf            wolf@grasp.insa-lyon.fr
-       uucp-uudom      wolf            grasp.insa-lyon.fr!wolf
-
-       uucp-{old,new}  wolf@fr.net     grasp!fr.net!wolf
-       uucp-dom        wolf@fr.net     wolf@fr.net
-       uucp-uudom      wolf@fr.net     fr.net!wolf
-
-       uucp-{old,new}  somehost!wolf   grasp!somehost!wolf
-       uucp-dom        somehost!wolf   somehost!wolf@grasp.insa-lyon.fr
-       uucp-uudom      somehost!wolf   grasp.insa-lyon.fr!somehost!wolf
-----------------------------------------------------------------------
-  * I'm trying to to get my mail to go into queue only mode, and it
-    delivers the mail interactively anyway.  (Or, I'm trying to use
-    the "don't deliver to expensive mailer" flag, and it doesn't
-    delivers the mail interactively anyway.)  I can see it does it:
-    here's the output of "sendmail -v foo@somehost" (or Mail -v or
-    equivalent).
-
-       The -v flag to sendmail (which is implied by the -v flag to
-       Mail and other programs in that family) tells sendmail to
-       watch the transaction.  Since you have explicitly asked to
-       see what's going on, it assumes that you do not want to to
-       auto-queue, and turns that feature off.  Remove the -v flag
-       and use a "tail -f" of the log instead to see what's going on.
-
-       If you are trying to use the "don't deliver to expensive mailer"
-       flag (mailer flag "e"), be sure you also turn on global option
-       "c" -- otherwise it ignores the mailer flag.
 ----------------------------------------------------------------------
   * I want to run Sendmail version 8 on my DEC system, but you don't
     have MAIL11V3 support in sendmail.  How do I handle this?
 
        Get Paul Vixie's reimplementation of the mail11 protocol
        from gatekeeper.dec.com in /pub/DEC/gwtools.
 ----------------------------------------------------------------------
   * I want to run Sendmail version 8 on my DEC system, but you don't
     have MAIL11V3 support in sendmail.  How do I handle this?
 
        Get Paul Vixie's reimplementation of the mail11 protocol
        from gatekeeper.dec.com in /pub/DEC/gwtools.
+----------------------------------------------------------------------
+  * Messages seem to disappear from my queue unsent.  When I look in
+    the queue directory I see that they have been renamed from qf*
+    to Qf*, and sendmail doesn't see these.
+
+       If you look closely you should find that the Qf files are
+       owned by users other than root.  Since sendmail runs as root
+       it refuses to believe information in non-root-owned qf files,
+       and it renames them to Qf to get them out of the way and
+       make it easy for you to find.  The usual cause of this is
+       twofold:  first, you have the queue directory world writable
+       (which is probably a mistake -- this opens up other security
+       problems) and someone is calling sendmail with an "unsafe"
+       flag, usually a -o flag that sets an option that could
+       compromise security.  When sendmail sees this it gives up
+       setuid root permissions.
+
+       The usual solution is to not use the problematic flags.
+       If you must use them, you have to write a special queue
+       directory and have them processed by the same uid that
+       submitted the job in the first place.
 ----------------------------------------------------------------------
 ----------------------------------------------------------------------