1.\" 2.\" Copyright (c) 2008 3.\" The DragonFly Project. All rights reserved. 4.\" 5.\" Redistribution and use in source and binary forms, with or without 6.\" modification, are permitted provided that the following conditions 7.\" are met: 8.\" 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 13.\" the documentation and/or other materials provided with the 14.\" distribution. 15.\" 3. Neither the name of The DragonFly Project nor the names of its 16.\" contributors may be used to endorse or promote products derived 17.\" from this software without specific, prior written permission. 18.\" 19.\" THIS SOFTWARE IS PROVIDED BY THE COPYRIGHT HOLDERS AND CONTRIBUTORS 20.\" ``AS IS'' AND ANY EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT 21.\" LIMITED TO, THE IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS 22.\" FOR A PARTICULAR PURPOSE ARE DISCLAIMED. IN NO EVENT SHALL THE 23.\" COPYRIGHT HOLDERS OR CONTRIBUTORS BE LIABLE FOR ANY DIRECT, INDIRECT, 24.\" INCIDENTAL, SPECIAL, EXEMPLARY OR CONSEQUENTIAL DAMAGES (INCLUDING, 25.\" BUT NOT LIMITED TO, PROCUREMENT OF SUBSTITUTE GOODS OR SERVICES; 26.\" LOSS OF USE, DATA, OR PROFITS; OR BUSINESS INTERRUPTION) HOWEVER CAUSED 27.\" AND ON ANY THEORY OF LIABILITY, WHETHER IN CONTRACT, STRICT LIABILITY, 28.\" OR TORT (INCLUDING NEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY OUT 29.\" OF THE USE OF THIS SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF 30.\" SUCH DAMAGE. 31.\" 32.\" $DragonFly: src/libexec/dma/dma.8,v 1.8 2008/05/02 02:05:04 swildner Exp $ 33.\" 34.Dd February 4, 2008 35.Dt DMA 8 36.Os 37.Sh NAME 38.Nm dma 39.Nd DragonFly Mail Agent 40.Sh SYNOPSIS 41.Nm 42.Op Fl DiOq 43.Op Fl A Ar mode 44.Op Fl b Ar mode 45.Op Fl f Ar sender 46.Op Fl L Ar tag 47.Op Fl o Ar option 48.Op Fl r Ar sender 49.Op Ar recipient ... 50.Sh DESCRIPTION 51.Nm 52is a small Mail Transport Agent (MTA), designed for home and office use. 53It accepts mails from locally installed Mail User Agents (MUA) and 54delivers the mails either locally or to a remote destination. 55Remote delivery includes several features like TLS/SSL support and SMTP 56authentication (AUTH LOGIN only). 57.Pp 58.Nm 59is not intended as a replacement for real, big MTAs like 60.Xr sendmail 8 61or 62.Xr postfix 1 . 63Consequently, 64.Nm 65does not listen on port 25 for incoming connections. 66.Pp 67The options are as follows: 68.Bl -tag -width indent 69.It Fl A Ar mode 70.Fl A Ns Ar c 71acts as a compatibility option for sendmail. 72.It Fl b Ar mode 73Specifying 74.Fl b Ns Ar p 75will list all mails currently stored in the mail queue. 76All other modes are are ignored. 77.It Fl D 78Don't run in the background. 79Useful for debugging. 80.It Fl f Ar sender 81Set sender address to 82.Ar sender . 83.It Fl i 84Ignore dots alone on lines by themselves in incoming messages. 85This should be set if you are reading data from a file. 86.It Fl L Ar tag 87Set the identifier used in syslog messages to the supplied 88.Ar tag . 89This is a compatibility option for sendmail. 90.It Fl O 91This is a compatibility option for sendmail. 92.It Fl o Ar option 93Specifying 94.Fl o Ns Ar i 95is synonymous to 96.Fl i . 97All other options are ignored. 98.It Fl q 99Process saved messages in the queue. 100.It Fl r Ar sender 101Same as 102.Fl f . 103.El 104.Sh CONFIGURATION 105.Nm 106can be configured with three config files: 107.Pp 108.Bl -bullet -compact 109.It 110auth.conf 111.It 112dma.conf 113.It 114virtusertable 115.El 116.Pp 117These three files are stored per default in 118.Pa /etc/dma . 119.Sh FILE FORMAT 120Every file contains parameters of the form 121.Sq name value . 122Lines containing boolean values are set to 123.Sq NO 124if the line is commented and to 125.Sq YES 126if the line is uncommented. 127Empty lines or lines beginning with a 128.Sq # 129are ignored. 130Parameter names and their values are case sensitive. 131.Sh PARAMETERS 132.Ss auth.conf 133SMTP authentication can be configured in 134.Pa auth.conf . 135Each line has the format 136.Dq Li user|smarthost:password . 137.Ss dma.conf 138Most of the behaviour of 139.Nm 140can be configured in 141.Pa dma.conf . 142.Bl -tag -width 4n 143.It Ic SMARTHOST Xo 144(string, default=empty) 145.Xc 146If you want to send outgoing mails via a smarthost, set this variable to 147your smarthosts address. 148.It Ic PORT Xo 149(numeric, default=25) 150.Xc 151Use this port to deliver remote emails. 152Only useful together with the 153.Sq SMARTHOST 154option, because 155.Nm 156will deliver all mails to this port, regardless if a smarthost is set or not. 157.It Ic ALIASES Xo 158(string, default=/etc/mail/aliases) 159.Xc 160Path to the local aliases file. 161Just stick with the default. 162.It Ic SPOOLDIR Xo 163(string, default=/var/spool/dma) 164.Xc 165Path to 166.Nm Ap s 167spool directory. 168Just stick with the default. 169.It Ic VIRTPATH Xo 170(string, default=/etc/dma/virtusertable) 171.Xc 172Path to the 173.Sq virtusertable 174file. 175.It Ic AUTHPATH Xo 176(string, default=/etc/dma/auth.conf) 177.Xc 178Path to the 179.Sq auth.conf 180file. 181.It Ic VIRTUAL Xo 182(boolean, default=commented) 183.Xc 184Comment if you want virtual user support. 185.It Ic SECURETRANS Xo 186(boolean, default=commented) 187.Xc 188Comment if you want TLS/SSL secured transfer. 189.It Ic STARTTLS Xo 190(boolean, default=commented) 191.Xc 192Comment if you want to use STARTTLS. 193Only useful together with 194.Sq SECURETRANS . 195.It Ic CERTFILE Xo 196(string, default=empty) 197.Xc 198Path to your SSL certificate file. 199.It Ic SECURE Xo 200(boolean, default=commented) 201.Xc 202Change this entry to 203.Sq INSECURE 204to use plain text SMTP login over an insecure connection. 205You have to rename this variable manually to prevent that you send your 206password accidentally over an insecure connection. 207.It Ic DEFER Xo 208(boolean, default=commented) 209.Xc 210Comment if you want that 211.Nm 212defers your mail. 213You have to flush your mail queue manually with the 214.Fl q 215option. 216This option is handy if you are behind a dialup line. 217.El 218.Ss virtusertable 219The 220.Pa virtusertable 221file specifies a virtual user table. 222Each line has the format 223.Dq Li localuser:mail-address . 224Some smarthosts do not accept mails from unresolvable email address 225(e.g. user@localhost) so you have to rewrite your outgoing email 226address to a valid address. 227.Sh SEE ALSO 228.Xr mailaddr 7 , 229.Xr mailwrapper 8 , 230.Xr sendmail 8 231.Rs 232.%A "J. B. Postel" 233.%T "Simple Mail Transfer Protocol" 234.%O RFC 821 235.Re 236.Rs 237.%A "J. Myers" 238.%T "SMTP Service Extension for Authentication" 239.%O RFC 2554 240.Re 241.Rs 242.%A "P. Hoffman" 243.%T "SMTP Service Extension for Secure SMTP over TLS" 244.%O RFC 2487 245.Re 246.Sh HISTORY 247The 248.Nm 249utility first appeared in 250.Dx 1.11 . 251.Sh AUTHORS 252.Nm 253was written by 254.An Matthias Schmidt Aq matthias@dragonflybsd.org 255and 256.An Simon Schubert Aq corecode@dragonflybsd.org . 257