share/man/man5/mailer.conf.5

   1 .\"     $NetBSD: mailer.conf.5,v 1.2 1999/05/29 18:18:30 christos Exp $
   2 .\"     $FreeBSD: src/share/man/man5/mailer.conf.5,v 1.1.1.1.2.5 2001/08/17 13:08:47 ru Exp $
   3 .\"
   4 .\" Copyright (c) 1998
   5 .\"     Perry E. Metzger.  All rights reserved.
   6 .\"
   7 .\" Redistribution and use in source and binary forms, with or without
   8 .\" modification, are permitted provided that the following conditions
   9 .\" are met:
  10 .\" 1. Redistributions of source code must retain the above copyright
  11 .\"    notice, this list of conditions and the following disclaimer.
  12 .\" 2. Redistributions in binary form must reproduce the above copyright
  13 .\"    notice, this list of conditions and the following disclaimer in the
  14 .\"    documentation and/or other materials provided with the distribution.
  15 .\" 3. All advertising materials mentioning features or use of this software
  16 .\"    must display the following acknowledgment:
  17 .\"     This product includes software developed for the NetBSD Project
  18 .\"     by Perry E. Metzger.
  19 .\" 4. The name of the author may not be used to endorse or promote products
  20 .\"    derived from this software without specific prior written permission.
  21 .\"
  22 .\" THIS SOFTWARE IS PROVIDED BY THE AUTHOR ``AS IS'' AND ANY EXPRESS OR
  23 .\" IMPLIED WARRANTIES, INCLUDING, BUT NOT LIMITED TO, THE IMPLIED WARRANTIES
  24 .\" OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE ARE DISCLAIMED.
  25 .\" IN NO EVENT SHALL THE AUTHOR BE LIABLE FOR ANY DIRECT, INDIRECT,
  26 .\" INCIDENTAL, SPECIAL, EXEMPLARY, OR CONSEQUENTIAL DAMAGES (INCLUDING, BUT
  27 .\" NOT LIMITED TO, PROCUREMENT OF SUBSTITUTE GOODS OR SERVICES; LOSS OF USE,
  28 .\" DATA, OR PROFITS; OR BUSINESS INTERRUPTION) HOWEVER CAUSED AND ON ANY
  29 .\" THEORY OF LIABILITY, WHETHER IN CONTRACT, STRICT LIABILITY, OR TORT
  30 .\" (INCLUDING NEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY OUT OF THE USE OF
  31 .\" THIS SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF SUCH DAMAGE.
  32 .\"
  33 .Dd March 29, 2015
  34 .Dt MAILER.CONF 5
  35 .Os
  36 .Sh NAME
  37 .Nm mailer.conf
  38 .Nd configuration file for
  39 .Xr mailwrapper 8
  40 .Sh DESCRIPTION
  41 The file
  42 .Pa /etc/mail/mailer.conf
  43 contains a series of pairs. The first member of each pair is the name
  44 of a program invoking
  45 .Xr mailwrapper 8
  46 which is typically a symbolic link to
  47 .Pa /usr/sbin/sendmail .
  48 (On a typical system,
  49 .Xr newaliases 1
  50 and
  51 .Xr mailq 1
  52 would be set up this way.)
  53 The second member of each pair is the name of the program to
  54 actually execute when the first name is invoked. The file may also
  55 contain comments, denoted by a # mark in the first column of any line.
  56 .Sh FILES
  57 /etc/mail/mailer.conf
  58 .Sh EXAMPLES
  59 The following is an example of how to set up an
  60 .Nm
  61 for traditional sendmail invocation behavior (installed from DPorts)
  62 .Bd -literal
  63 # Use sendmail as Mail Transfer Agent
  64 sendmail        /usr/local/sbin/sendmail
  65 mailq           /usr/local/bin/mailq
  66 newaliases      /usr/local/bin/newaliases
  67 hoststat        /usr/local/bin/hoststat
  68 purgestat       /usr/local/bin/purgestat
  69 .Ed
  70 .Pp
  71 This example shows how to invoke a sendmail-workalike like Postfix
  72 installed from DPorts to replace
  73 .Xr dma 8
  74 .Bd -literal
  75 # Use postfix as Mail Transfer Agent
  76 sendmail        /usr/local/sbin/sendmail
  77 mailq           /usr/local/bin/mailq
  78 newaliases      /usr/local/bin/newaliases
  79 hoststat        /usr/bin/true
  80 purgestat       /usr/bin/true
  81 .Ed
  82 .Pp
  83 This example shows how to invoke a sendmail-workalike like OpenSMTPd
  84 installed from DPorts to replace
  85 .Xr dma 8
  86 .Bd -literal
  87 # Use opensmtpd as Mail Transfer Agent
  88 sendmail        /usr/local/sbin/smtpctl
  89 mailq           /usr/local/sbin/smtpctl
  90 newaliases      /usr/local/sbin/smtpctl
  91 hoststat        /usr/bin/true
  92 purgestat       /usr/bin/true
  93 .Ed
  94 .Pp
  95 These are the default contents of the file
  96 .Bd -literal
  97 # Use dma as Mail Transfer Agent
  98 sendmail        /usr/libexec/dma
  99 mailq           /usr/libexec/dma
 100 newaliases      /usr/libexec/dma
 101 hoststat        /usr/libexec/dma
 102 purgestat       /usr/libexec/dma
 103 .Ed
 104 .Sh SEE ALSO
 105 .Xr mail 1 ,
 106 .Xr mailwrapper 8
 107 .Sh HISTORY
 108 .Nm
 109 appeared in
 110 .Nx 1.4 .
 111 .Sh AUTHORS
 112 .An Perry E. Metzger Aq Mt perry@piermont.com
 113 should go away.