xref: /netbsd/usr.sbin/mailwrapper/mailer.conf.5 (revision 2adb3a73)
1.\"	$NetBSD: mailer.conf.5,v 1.16 2014/03/18 18:20:47 riastradh 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 April 10, 2010
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/mailer.conf
42contains a series of lines of the form
43.Pp
44.Pa name
45.Pa program
46.Op Ar arguments ...
47.Pp
48The first word of each line is the
49.Pa 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.Pa name
62might be
63.Dq sendmail
64or
65.Dq newaliases
66etc.)
67.Pp
68The second word of each line is the name of the
69.Pa program
70to actually execute when the first name is invoked.
71.Pp
72The further
73.Ar arguments ,
74if any, are passed to the
75.Pa 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.Sq #
82mark in the first column of any line.
83.Pp
84The default mailer is
85.Xr postfix 1 ,
86which will also start by default (unless specifically disabled via an
87.Xr rc.conf 5
88setting) so that locally generated mail can be delivered, if the
89.Dq sendmail
90setting in
91.Pa /etc/mailer.conf
92is set to
93.Dq /usr/libexec/postfix/sendmail .
94.Sh FILES
95/etc/mailer.conf
96.Sh EXAMPLES
97This example shows how to set up
98.Nm
99to invoke the
100.Xr postfix 1
101program:
102.Bd -literal -offset indent
103sendmail        /usr/libexec/postfix/sendmail
104mailq           /usr/libexec/postfix/sendmail
105newaliases      /usr/libexec/postfix/sendmail
106.Ed
107.Pp
108This example shows the use of the mini-sendmail package from
109.Em pkgsrc
110in place of
111.Xr postfix 1 :
112.Bd -literal -offset indent
113# Send outgoing mail to a smart relay using mini-sendmail
114sendmail	/usr/pkg/sbin/mini-sendmail -srelayhost
115send-mail	/usr/pkg/sbin/mini-sendmail -srelayhost
116.Ed
117.Pp
118Note the use of additional arguments.
119.Sh SEE ALSO
120.Xr mail 1 ,
121.Xr mailq 1 ,
122.Xr newaliases 1 ,
123.Xr postfix 1 ,
124.Xr mailwrapper 8
125.Pp
126.Pa pkgsrc/mail/sendmail ,
127.Pa pkgsrc/mail/mini_sendmail
128.Sh HISTORY
129.Nm
130appeared in
131.Nx 1.4 .
132.Sh AUTHORS
133.An Perry E. Metzger Aq Mt perry@piermont.com
134.Sh BUGS
135The entire reason this program exists is a crock.
136Instead, a command
137for how to submit mail should be standardized, and all the
138.Dq behave differently if invoked with a different name
139behavior of things like
140.Xr mailq 1
141should go away.
142