3 .\" The DragonFly Project. All rights reserved.
5 .\" Redistribution and use in source and binary forms, with or without
6 .\" modification, are permitted provided that the following conditions
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
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.
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
32 .\" $DragonFly: src/libexec/dma/dma.8,v 1.10 2008/09/06 14:17:56 swildner Exp $
39 .Nd DragonFly Mail Agent
53 is a small Mail Transport Agent (MTA), designed for home and office use.
54 It accepts mails from locally installed Mail User Agents (MUA) and
55 delivers the mails either locally or to a remote destination.
56 Remote delivery includes several features like TLS/SSL support and SMTP
60 is not intended as a replacement for real, big MTAs like
66 does not listen on port 25 for incoming connections.
68 The options are as follows:
69 .Bl -tag -width indent
72 acts as a compatibility option for sendmail.
76 will list all mails currently stored in the mail queue.
77 All other modes are are ignored.
79 Don't run in the background.
85 Ignore dots alone on lines by themselves in incoming messages.
86 This should be set if you are reading data from a file.
88 Set the identifier used in syslog messages to the supplied
90 This is a compatibility option for sendmail.
92 This is a compatibility option for sendmail.
98 All other options are ignored.
100 Process saved messages in the queue.
101 The argument is required for compatibility with sendmail, and ignored.
108 can be configured with three config files:
119 These three files are stored per default in
122 Every file contains parameters of the form
124 Lines containing boolean values are set to
126 if the line is commented and to
128 if the line is uncommented.
129 Empty lines or lines beginning with a
132 Parameter names and their values are case sensitive.
135 SMTP authentication can be configured in
137 Each line has the format
138 .Dq Li user|smarthost:password .
140 Most of the behaviour of
146 (string, default=empty)
148 If you want to send outgoing mails via a smarthost, set this variable to
149 your smarthosts address.
151 (numeric, default=25)
153 Use this port to deliver remote emails.
154 Only useful together with the
158 will deliver all mails to this port, regardless of whether a smarthost is set
161 (string, default=/etc/mail/aliases)
163 Path to the local aliases file.
164 Just stick with the default.
166 (string, default=/var/spool/dma)
171 Just stick with the default.
173 (string, default=/etc/dma/virtusertable)
179 (string, default=/etc/dma/auth.conf)
185 (boolean, default=commented)
187 Comment if you want virtual user support.
188 .It Ic SECURETRANS Xo
189 (boolean, default=commented)
191 Comment if you want TLS/SSL secured transfer.
193 (boolean, default=commented)
195 Comment if you want to use STARTTLS.
196 Only useful together with
199 (string, default=empty)
201 Path to your SSL certificate file.
203 (boolean, default=commented)
207 to use plain text SMTP login over an insecure connection.
208 You have to rename this variable manually to prevent that you send your
209 password accidentally over an insecure connection.
211 (boolean, default=commented)
213 Comment if you want that
216 You have to flush your mail queue manually with the
219 This option is handy if you are behind a dialup line.
221 (boolean, default=commented)
223 Uncomment if you want the bounce message to include the complete original
224 message, not just the headers.
226 (string, default=empty)
228 The name to be used when introducing this host, if different from
231 If specified, this option overrides
233 .It Ic MAILNAMEFILE Xo
234 (string, default=empty)
236 The name of the file to read the
243 file specifies a virtual user table.
244 Each line has the format
245 .Dq Li localuser:mail-address .
246 Some smarthosts do not accept mails from unresolvable email address
247 (e.g.\& user@localhost) so you have to rewrite your outgoing email
248 address to a valid address.
255 .%T "Simple Mail Transfer Protocol"
260 .%T "SMTP Service Extension for Authentication"
265 .%T "SMTP Service Extension for Secure SMTP over TLS"
271 utility first appeared in
276 .An Matthias Schmidt Aq matthias@dragonflybsd.org
278 .An Simon Schubert Aq corecode@dragonflybsd.org .