xref: /titanic_44/usr/src/man/man1m/mailwrapper.1m (revision 287247a826fa2ab8d01f6c8f276d405eb08420f8)
1*287247a8SAlexander Pyhalov.\"	$OpenBSD: mailwrapper.8,v 1.10 2009/02/07 16:58:23 martynas Exp $
2*287247a8SAlexander Pyhalov.\"	$NetBSD: mailwrapper.8,v 1.11 2002/02/08 01:38:50 ross Exp $
3*287247a8SAlexander Pyhalov.\" $FreeBSD: releng/9.1/usr.sbin/mailwrapper/mailwrapper.8 205938 2010-03-30 21:54:25Z delphij $
4*287247a8SAlexander Pyhalov.\"
5*287247a8SAlexander Pyhalov.\" Copyright (c) 1998
6*287247a8SAlexander Pyhalov.\" 	Perry E. Metzger.  All rights reserved.
7*287247a8SAlexander Pyhalov.\"
8*287247a8SAlexander Pyhalov.\" Redistribution and use in source and binary forms, with or without
9*287247a8SAlexander Pyhalov.\" modification, are permitted provided that the following conditions
10*287247a8SAlexander Pyhalov.\" are met:
11*287247a8SAlexander Pyhalov.\" 1. Redistributions of source code must retain the above copyright
12*287247a8SAlexander Pyhalov.\"    notice, this list of conditions and the following disclaimer.
13*287247a8SAlexander Pyhalov.\" 2. Redistributions in binary form must reproduce the above copyright
14*287247a8SAlexander Pyhalov.\"    notice, this list of conditions and the following disclaimer in the
15*287247a8SAlexander Pyhalov.\"    documentation and/or other materials provided with the distribution.
16*287247a8SAlexander Pyhalov.\" 3. All advertising materials mentioning features or use of this software
17*287247a8SAlexander Pyhalov.\"    must display the following acknowledgment:
18*287247a8SAlexander Pyhalov.\"	This product includes software developed for the NetBSD Project
19*287247a8SAlexander Pyhalov.\"	by Perry E. Metzger.
20*287247a8SAlexander Pyhalov.\" 4. The name of the author may not be used to endorse or promote products
21*287247a8SAlexander Pyhalov.\"    derived from this software without specific prior written permission.
22*287247a8SAlexander Pyhalov.\"
23*287247a8SAlexander Pyhalov.\" THIS SOFTWARE IS PROVIDED BY THE AUTHOR ``AS IS'' AND ANY EXPRESS OR
24*287247a8SAlexander Pyhalov.\" IMPLIED WARRANTIES, INCLUDING, BUT NOT LIMITED TO, THE IMPLIED WARRANTIES
25*287247a8SAlexander Pyhalov.\" OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE ARE DISCLAIMED.
26*287247a8SAlexander Pyhalov.\" IN NO EVENT SHALL THE AUTHOR BE LIABLE FOR ANY DIRECT, INDIRECT,
27*287247a8SAlexander Pyhalov.\" INCIDENTAL, SPECIAL, EXEMPLARY, OR CONSEQUENTIAL DAMAGES (INCLUDING, BUT
28*287247a8SAlexander Pyhalov.\" NOT LIMITED TO, PROCUREMENT OF SUBSTITUTE GOODS OR SERVICES; LOSS OF USE,
29*287247a8SAlexander Pyhalov.\" DATA, OR PROFITS; OR BUSINESS INTERRUPTION) HOWEVER CAUSED AND ON ANY
30*287247a8SAlexander Pyhalov.\" THEORY OF LIABILITY, WHETHER IN CONTRACT, STRICT LIABILITY, OR TORT
31*287247a8SAlexander Pyhalov.\" (INCLUDING NEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY OUT OF THE USE OF
32*287247a8SAlexander Pyhalov.\" THIS SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF SUCH DAMAGE.
33*287247a8SAlexander Pyhalov.\"
34*287247a8SAlexander Pyhalov.Dd August 7, 2006
35*287247a8SAlexander Pyhalov.Dt MAILWRAPPER 1M
36*287247a8SAlexander Pyhalov.Os
37*287247a8SAlexander Pyhalov.Sh NAME
38*287247a8SAlexander Pyhalov.Nm \fB/usr/lib/mailwrapper\fR
39*287247a8SAlexander Pyhalov.Nd invoke appropriate MTA software based on configuration file
40*287247a8SAlexander Pyhalov.Sh SYNOPSIS
41*287247a8SAlexander PyhalovSpecial.
42*287247a8SAlexander PyhalovSee below.
43*287247a8SAlexander Pyhalov.Sh DESCRIPTION
44*287247a8SAlexander PyhalovAt one time, the only Mail Transfer Agent (MTA) software easily available
45*287247a8SAlexander Pyhalovwas
46*287247a8SAlexander Pyhalov.Xr sendmail 1M .
47*287247a8SAlexander PyhalovAs a result of this, most Mail User Agents (MUAs) such as
48*287247a8SAlexander Pyhalov.Xr mail 1
49*287247a8SAlexander Pyhalovhad the path and calling conventions expected by
50*287247a8SAlexander Pyhalov.Xr sendmail 1M
51*287247a8SAlexander Pyhalovcompiled in.
52*287247a8SAlexander Pyhalov.Pp
53*287247a8SAlexander PyhalovTimes have changed, however.
54*287247a8SAlexander PyhalovOn a modern
55*287247a8SAlexander Pyhalov.Ux
56*287247a8SAlexander Pyhalovsystem, the administrator may wish to use one of several
57*287247a8SAlexander Pyhalovavailable MTAs.
58*287247a8SAlexander Pyhalov.Pp
59*287247a8SAlexander PyhalovIt would be difficult to modify all MUA software typically available
60*287247a8SAlexander Pyhalovon a system, so most of the authors of alternative MTAs have written
61*287247a8SAlexander Pyhalovtheir front end message submission programs so that they use the same
62*287247a8SAlexander Pyhalovcalling conventions as
63*287247a8SAlexander Pyhalov.Xr sendmail 1M
64*287247a8SAlexander Pyhalovand may be put into place instead of
65*287247a8SAlexander Pyhalov.Xr sendmail 1M
66*287247a8SAlexander Pyhalovin
67*287247a8SAlexander Pyhalov.Pa /usr/lib/sendmail .
68*287247a8SAlexander Pyhalov.Pp
69*287247a8SAlexander Pyhalov.Xr sendmail 1M
70*287247a8SAlexander Pyhalovalso typically has aliases named
71*287247a8SAlexander Pyhalov.Xr mailq 1
72*287247a8SAlexander Pyhalovand
73*287247a8SAlexander Pyhalov.Xr newaliases 1M
74*287247a8SAlexander Pyhalovlinked to it.
75*287247a8SAlexander PyhalovThe program knows to behave differently when its
76*287247a8SAlexander Pyhalov.Va argv[0]
77*287247a8SAlexander Pyhalovis
78*287247a8SAlexander Pyhalov.Dq mailq
79*287247a8SAlexander Pyhalovor
80*287247a8SAlexander Pyhalov.Dq newaliases
81*287247a8SAlexander Pyhalovand behaves appropriately.
82*287247a8SAlexander PyhalovTypically, replacement MTAs provide similar
83*287247a8SAlexander Pyhalovfunctionality, either through a program that also switches behavior
84*287247a8SAlexander Pyhalovbased on calling name, or through a set of programs that provide
85*287247a8SAlexander Pyhalovsimilar functionality.
86*287247a8SAlexander Pyhalov.Pp
87*287247a8SAlexander PyhalovAlthough having drop-in replacements for
88*287247a8SAlexander Pyhalov.Xr sendmail 1M
89*287247a8SAlexander Pyhalovhelps in installing alternative MTAs, it essentially makes the
90*287247a8SAlexander Pyhalovconfiguration of the system depend on hand installing new programs in
91*287247a8SAlexander Pyhalov.Pa /usr .
92*287247a8SAlexander PyhalovThis leads to configuration problems for many administrators, since
93*287247a8SAlexander Pyhalovthey may wish to install a new MTA without altering the system
94*287247a8SAlexander Pyhalovprovided
95*287247a8SAlexander Pyhalov.Pa /usr .
96*287247a8SAlexander Pyhalov(This may be, for example, to avoid having upgrade problems when a new
97*287247a8SAlexander Pyhalovversion of the system is installed over the old.)
98*287247a8SAlexander PyhalovThey may also have a shared
99*287247a8SAlexander Pyhalov.Pa /usr
100*287247a8SAlexander Pyhalovamong several
101*287247a8SAlexander Pyhalovmachines, and may wish to avoid placing implicit configuration
102*287247a8SAlexander Pyhalovinformation in a read-only
103*287247a8SAlexander Pyhalov.Pa /usr .
104*287247a8SAlexander Pyhalov.Pp
105*287247a8SAlexander PyhalovThe
106*287247a8SAlexander Pyhalov.Nm
107*287247a8SAlexander Pyhalovutility is designed to replace
108*287247a8SAlexander Pyhalov.Pa /usr/lib/sendmail
109*287247a8SAlexander Pyhalovand to invoke an appropriate MTA instead of
110*287247a8SAlexander Pyhalov.Xr sendmail 1M
111*287247a8SAlexander Pyhalovbased on configuration information placed in
112*287247a8SAlexander Pyhalov.Pa /etc/mailer.conf .
113*287247a8SAlexander PyhalovThis permits the administrator to configure which MTA is to be invoked on
114*287247a8SAlexander Pyhalovthe system at run time.
115*287247a8SAlexander Pyhalov.Pp
116*287247a8SAlexander PyhalovOther configuration files may need to be altered when replacing
117*287247a8SAlexander Pyhalov.Xr sendmail 1M .
118*287247a8SAlexander Pyhalov.Sh EXIT STATUS
119*287247a8SAlexander Pyhalov.Ex -std
120*287247a8SAlexander Pyhalov.Sh DIAGNOSTICS
121*287247a8SAlexander PyhalovThe
122*287247a8SAlexander Pyhalov.Nm
123*287247a8SAlexander Pyhalovwill print a diagnostic if its configuration file is missing or malformed,
124*287247a8SAlexander Pyhalovor does not contain a mapping for the name under which it was invoked.
125*287247a8SAlexander Pyhalov.Sh SEE ALSO
126*287247a8SAlexander Pyhalov.Xr mail 1 ,
127*287247a8SAlexander Pyhalov.Xr mailq 1 ,
128*287247a8SAlexander Pyhalov.Xr newaliases 1M ,
129*287247a8SAlexander Pyhalov.Xr mailer.conf 4 ,
130*287247a8SAlexander Pyhalov.Xr sendmail 1M
131