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