1287247a8SAlexander Pyhalov.\" $OpenBSD: mailwrapper.8,v 1.10 2009/02/07 16:58:23 martynas Exp $ 2287247a8SAlexander Pyhalov.\" $NetBSD: mailwrapper.8,v 1.11 2002/02/08 01:38:50 ross Exp $ 3287247a8SAlexander Pyhalov.\" $FreeBSD: releng/9.1/usr.sbin/mailwrapper/mailwrapper.8 205938 2010-03-30 21:54:25Z delphij $ 4287247a8SAlexander Pyhalov.\" 5287247a8SAlexander Pyhalov.\" Copyright (c) 1998 6287247a8SAlexander Pyhalov.\" Perry E. Metzger. All rights reserved. 7287247a8SAlexander Pyhalov.\" 8287247a8SAlexander Pyhalov.\" Redistribution and use in source and binary forms, with or without 9287247a8SAlexander Pyhalov.\" modification, are permitted provided that the following conditions 10287247a8SAlexander Pyhalov.\" are met: 11287247a8SAlexander Pyhalov.\" 1. Redistributions of source code must retain the above copyright 12287247a8SAlexander Pyhalov.\" notice, this list of conditions and the following disclaimer. 13287247a8SAlexander Pyhalov.\" 2. Redistributions in binary form must reproduce the above copyright 14287247a8SAlexander Pyhalov.\" notice, this list of conditions and the following disclaimer in the 15287247a8SAlexander Pyhalov.\" documentation and/or other materials provided with the distribution. 16287247a8SAlexander Pyhalov.\" 3. All advertising materials mentioning features or use of this software 17287247a8SAlexander Pyhalov.\" must display the following acknowledgment: 18287247a8SAlexander Pyhalov.\" This product includes software developed for the NetBSD Project 19287247a8SAlexander Pyhalov.\" by Perry E. Metzger. 20287247a8SAlexander Pyhalov.\" 4. The name of the author may not be used to endorse or promote products 21287247a8SAlexander Pyhalov.\" derived from this software without specific prior written permission. 22287247a8SAlexander Pyhalov.\" 23287247a8SAlexander Pyhalov.\" THIS SOFTWARE IS PROVIDED BY THE AUTHOR ``AS IS'' AND ANY EXPRESS OR 24287247a8SAlexander Pyhalov.\" IMPLIED WARRANTIES, INCLUDING, BUT NOT LIMITED TO, THE IMPLIED WARRANTIES 25287247a8SAlexander Pyhalov.\" OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE ARE DISCLAIMED. 26287247a8SAlexander Pyhalov.\" IN NO EVENT SHALL THE AUTHOR BE LIABLE FOR ANY DIRECT, INDIRECT, 27287247a8SAlexander Pyhalov.\" INCIDENTAL, SPECIAL, EXEMPLARY, OR CONSEQUENTIAL DAMAGES (INCLUDING, BUT 28287247a8SAlexander Pyhalov.\" NOT LIMITED TO, PROCUREMENT OF SUBSTITUTE GOODS OR SERVICES; LOSS OF USE, 29287247a8SAlexander Pyhalov.\" DATA, OR PROFITS; OR BUSINESS INTERRUPTION) HOWEVER CAUSED AND ON ANY 30287247a8SAlexander Pyhalov.\" THEORY OF LIABILITY, WHETHER IN CONTRACT, STRICT LIABILITY, OR TORT 31287247a8SAlexander Pyhalov.\" (INCLUDING NEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY OUT OF THE USE OF 32287247a8SAlexander Pyhalov.\" THIS SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF SUCH DAMAGE. 33287247a8SAlexander Pyhalov.\" 34287247a8SAlexander Pyhalov.Dd August 7, 2006 35*bbf21555SRichard Lowe.Dt MAILWRAPPER 8 36287247a8SAlexander Pyhalov.Os 37287247a8SAlexander Pyhalov.Sh NAME 38287247a8SAlexander Pyhalov.Nm \fB/usr/lib/mailwrapper\fR 39287247a8SAlexander Pyhalov.Nd invoke appropriate MTA software based on configuration file 40287247a8SAlexander Pyhalov.Sh SYNOPSIS 41287247a8SAlexander PyhalovSpecial. 42287247a8SAlexander PyhalovSee below. 43287247a8SAlexander Pyhalov.Sh DESCRIPTION 44287247a8SAlexander PyhalovAt one time, the only Mail Transfer Agent (MTA) software easily available 45287247a8SAlexander Pyhalovwas 46*bbf21555SRichard Lowe.Xr sendmail 8 . 47287247a8SAlexander PyhalovAs a result of this, most Mail User Agents (MUAs) such as 48287247a8SAlexander Pyhalov.Xr mail 1 49287247a8SAlexander Pyhalovhad the path and calling conventions expected by 50*bbf21555SRichard Lowe.Xr sendmail 8 51287247a8SAlexander Pyhalovcompiled in. 52287247a8SAlexander Pyhalov.Pp 53287247a8SAlexander PyhalovTimes have changed, however. 54287247a8SAlexander PyhalovOn a modern 55287247a8SAlexander Pyhalov.Ux 56287247a8SAlexander Pyhalovsystem, the administrator may wish to use one of several 57287247a8SAlexander Pyhalovavailable MTAs. 58287247a8SAlexander Pyhalov.Pp 59287247a8SAlexander PyhalovIt would be difficult to modify all MUA software typically available 60287247a8SAlexander Pyhalovon a system, so most of the authors of alternative MTAs have written 61287247a8SAlexander Pyhalovtheir front end message submission programs so that they use the same 62287247a8SAlexander Pyhalovcalling conventions as 63*bbf21555SRichard Lowe.Xr sendmail 8 64287247a8SAlexander Pyhalovand may be put into place instead of 65*bbf21555SRichard Lowe.Xr sendmail 8 66287247a8SAlexander Pyhalovin 67287247a8SAlexander Pyhalov.Pa /usr/lib/sendmail . 68287247a8SAlexander Pyhalov.Pp 69*bbf21555SRichard Lowe.Xr sendmail 8 70287247a8SAlexander Pyhalovalso typically has aliases named 71287247a8SAlexander Pyhalov.Xr mailq 1 72287247a8SAlexander Pyhalovand 73*bbf21555SRichard Lowe.Xr newaliases 8 74287247a8SAlexander Pyhalovlinked to it. 75287247a8SAlexander PyhalovThe program knows to behave differently when its 76287247a8SAlexander Pyhalov.Va argv[0] 77287247a8SAlexander Pyhalovis 78287247a8SAlexander Pyhalov.Dq mailq 79287247a8SAlexander Pyhalovor 80287247a8SAlexander Pyhalov.Dq newaliases 81287247a8SAlexander Pyhalovand behaves appropriately. 82287247a8SAlexander PyhalovTypically, replacement MTAs provide similar 83287247a8SAlexander Pyhalovfunctionality, either through a program that also switches behavior 84287247a8SAlexander Pyhalovbased on calling name, or through a set of programs that provide 85287247a8SAlexander Pyhalovsimilar functionality. 86287247a8SAlexander Pyhalov.Pp 87287247a8SAlexander PyhalovAlthough having drop-in replacements for 88*bbf21555SRichard Lowe.Xr sendmail 8 89287247a8SAlexander Pyhalovhelps in installing alternative MTAs, it essentially makes the 90287247a8SAlexander Pyhalovconfiguration of the system depend on hand installing new programs in 91287247a8SAlexander Pyhalov.Pa /usr . 92287247a8SAlexander PyhalovThis leads to configuration problems for many administrators, since 93287247a8SAlexander Pyhalovthey may wish to install a new MTA without altering the system 94287247a8SAlexander Pyhalovprovided 95287247a8SAlexander Pyhalov.Pa /usr . 96287247a8SAlexander Pyhalov(This may be, for example, to avoid having upgrade problems when a new 97287247a8SAlexander Pyhalovversion of the system is installed over the old.) 98287247a8SAlexander PyhalovThey may also have a shared 99287247a8SAlexander Pyhalov.Pa /usr 100287247a8SAlexander Pyhalovamong several 101287247a8SAlexander Pyhalovmachines, and may wish to avoid placing implicit configuration 102287247a8SAlexander Pyhalovinformation in a read-only 103287247a8SAlexander Pyhalov.Pa /usr . 104287247a8SAlexander Pyhalov.Pp 105287247a8SAlexander PyhalovThe 106287247a8SAlexander Pyhalov.Nm 107287247a8SAlexander Pyhalovutility is designed to replace 108287247a8SAlexander Pyhalov.Pa /usr/lib/sendmail 109287247a8SAlexander Pyhalovand to invoke an appropriate MTA instead of 110*bbf21555SRichard Lowe.Xr sendmail 8 111287247a8SAlexander Pyhalovbased on configuration information placed in 112287247a8SAlexander Pyhalov.Pa /etc/mailer.conf . 113287247a8SAlexander PyhalovThis permits the administrator to configure which MTA is to be invoked on 114287247a8SAlexander Pyhalovthe system at run time. 115287247a8SAlexander Pyhalov.Pp 116287247a8SAlexander PyhalovOther configuration files may need to be altered when replacing 117*bbf21555SRichard Lowe.Xr sendmail 8 . 118287247a8SAlexander Pyhalov.Sh EXIT STATUS 119287247a8SAlexander Pyhalov.Ex -std 120287247a8SAlexander Pyhalov.Sh DIAGNOSTICS 121287247a8SAlexander PyhalovThe 122287247a8SAlexander Pyhalov.Nm 123287247a8SAlexander Pyhalovwill print a diagnostic if its configuration file is missing or malformed, 124287247a8SAlexander Pyhalovor does not contain a mapping for the name under which it was invoked. 125287247a8SAlexander Pyhalov.Sh SEE ALSO 126287247a8SAlexander Pyhalov.Xr mail 1 , 127287247a8SAlexander Pyhalov.Xr mailq 1 , 128*bbf21555SRichard Lowe.Xr mailer.conf 5 , 129*bbf21555SRichard Lowe.Xr newaliases 8 , 130*bbf21555SRichard Lowe.Xr sendmail 8 131