xref: /freebsd/share/man/man5/mailer.conf.5 (revision 315ee00f)
1.\"	$NetBSD: mailer.conf.5,v 1.2 1999/05/29 18:18:30 christos Exp $
2.\"
3.\" Copyright (c) 1998
4.\" 	Perry E. Metzger.  All rights reserved.
5.\"
6.\" Redistribution and use in source and binary forms, with or without
7.\" modification, are permitted provided that the following conditions
8.\" are met:
9.\" 1. Redistributions of source code must retain the above copyright
10.\"    notice, this list of conditions and the following disclaimer.
11.\" 2. Redistributions in binary form must reproduce the above copyright
12.\"    notice, this list of conditions and the following disclaimer in the
13.\"    documentation and/or other materials provided with the distribution.
14.\" 3. All advertising materials mentioning features or use of this software
15.\"    must display the following acknowledgment:
16.\"	This product includes software developed for the NetBSD Project
17.\"	by Perry E. Metzger.
18.\" 4. The name of the author may not be used to endorse or promote products
19.\"    derived from this software without specific prior written permission.
20.\"
21.\" THIS SOFTWARE IS PROVIDED BY THE AUTHOR ``AS IS'' AND ANY EXPRESS OR
22.\" IMPLIED WARRANTIES, INCLUDING, BUT NOT LIMITED TO, THE IMPLIED WARRANTIES
23.\" OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE ARE DISCLAIMED.
24.\" IN NO EVENT SHALL THE AUTHOR BE LIABLE FOR ANY DIRECT, INDIRECT,
25.\" INCIDENTAL, SPECIAL, EXEMPLARY, OR CONSEQUENTIAL DAMAGES (INCLUDING, BUT
26.\" NOT LIMITED TO, PROCUREMENT OF SUBSTITUTE GOODS OR SERVICES; LOSS OF USE,
27.\" DATA, OR PROFITS; OR BUSINESS INTERRUPTION) HOWEVER CAUSED AND ON ANY
28.\" THEORY OF LIABILITY, WHETHER IN CONTRACT, STRICT LIABILITY, OR TORT
29.\" (INCLUDING NEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY OUT OF THE USE OF
30.\" THIS SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF SUCH DAMAGE.
31.\"
32.Dd December 26, 2017
33.Dt MAILER.CONF 5
34.Os
35.Sh NAME
36.Nm mailer.conf
37.Nd configuration file for
38.Xr mailwrapper 8
39.Sh DESCRIPTION
40The file
41.Pa /etc/mail/mailer.conf
42contains a series of lines of the form
43.Pp
44.Ar name
45.Ar program
46.Op Ar arguments ...
47.Pp
48The first word of each line is the
49.Ar name
50of a program invoking
51.Xr mailwrapper 8 .
52(For example, on a typical system
53.Pa /usr/sbin/sendmail
54would be a symbolic link to
55.Xr mailwrapper 8 ,
56as would
57.Xr newaliases 1
58and
59.Xr mailq 1 .
60Thus,
61.Ar name
62might be
63.Dq Li sendmail
64or
65.Dq Li newaliases
66etc.)
67.Pp
68The second word of each line is the name of the
69.Ar program
70to actually execute when the first name is invoked.
71.Pp
72The further
73.Ar arguments ,
74if any, are passed to the
75.Ar program ,
76followed by the arguments
77.Xr mailwrapper 8
78was called with.
79.Pp
80The file may also contain comment lines, denoted by a
81.Ql #
82mark in the first column of any line.
83.Sh FILES
84.Bl -tag -width Pa
85.It Pa /etc/mail/mailer.conf
86.El
87.Sh EXAMPLES
88This example shows how to set up
89.Nm
90to invoke the traditional
91.Xr sendmail 8
92program:
93.Bd -literal -offset indent
94# Execute the "real" sendmail program located in
95# /usr/libexec/sendmail/sendmail
96sendmail	/usr/libexec/sendmail/sendmail
97mailq		/usr/libexec/sendmail/sendmail
98newaliases	/usr/libexec/sendmail/sendmail
99.Ed
100.Pp
101Using
102.Nm Postfix
103(from ports)
104to replace
105.Xr sendmail 8 :
106.Bd -literal -offset indent
107# Emulate sendmail using postfix
108sendmail	/usr/local/sbin/sendmail
109mailq		/usr/local/sbin/sendmail
110newaliases	/usr/local/sbin/sendmail
111.Ed
112.Pp
113Using
114.Nm Exim
115(from ports)
116to replace
117.Xr sendmail 8 :
118.Bd -literal -offset indent
119# Emulate sendmail using exim
120sendmail	/usr/local/sbin/exim
121mailq		/usr/local/sbin/exim -bp
122newaliases	/usr/bin/true
123rmail		/usr/local/sbin/exim -i -oee
124.Ed
125.Pp
126Using
127.Nm mini_sendmail
128(from ports)
129to replace
130.Xr sendmail 8 :
131.Bd -literal -offset indent
132# Send outgoing mail to a smart relay using mini_sendmail
133sendmail	/usr/local/bin/mini_sendmail -srelayhost
134.Ed
135.Pp
136Using
137.Xr dma 8
138to replace
139.Xr sendmail 8 :
140.Bd -literal -offset indent
141# Execute dma instead of sendmail
142sendmail	/usr/libexec/dma
143mailq		/usr/libexec/dma
144newaliases	/usr/libexec/dma
145rmail		/usr/libexec/dma
146.Ed
147.Sh SEE ALSO
148.Xr mail 1 ,
149.Xr mailq 1 ,
150.Xr newaliases 1 ,
151.Xr dma 8 ,
152.Xr mailwrapper 8 ,
153.Xr sendmail 8
154.Pp
155.Xr postfix 1 Pq Pa ports/mail/postfix ,
156.Xr dma 8 Pq Pa ports/mail/dma ,
157.Xr exim 8 Pq Pa ports/mail/exim ,
158.Xr mini_sendmail 8 Pq Pa ports/mail/mini_sendmail
159.Sh HISTORY
160.Nm
161appeared in
162.Nx 1.4 .
163.Sh AUTHORS
164.An Perry E. Metzger Aq Mt perry@piermont.com
165.Sh BUGS
166The entire reason this program exists is a crock.
167Instead, a command
168for how to submit mail should be standardized, and all the "behave
169differently if invoked with a different name" behavior of things like
170.Xr mailq 1
171should go away.
172