2 .\" Copyright (c) 2008-2014, Simon Schubert <2@0x2c.org>.
4 .\" The DragonFly Project. All rights reserved.
6 .\" Redistribution and use in source and binary forms, with or without
7 .\" modification, are permitted provided that the following conditions
10 .\" 1. Redistributions of source code must retain the above copyright
11 .\" notice, this list of conditions and the following disclaimer.
12 .\" 2. Redistributions in binary form must reproduce the above copyright
13 .\" notice, this list of conditions and the following disclaimer in
14 .\" the documentation and/or other materials provided with the
16 .\" 3. Neither the name of The DragonFly Project nor the names of its
17 .\" contributors may be used to endorse or promote products derived
18 .\" from this software without specific, prior written permission.
20 .\" THIS SOFTWARE IS PROVIDED BY THE COPYRIGHT HOLDERS AND CONTRIBUTORS
21 .\" ``AS IS'' AND ANY EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT
22 .\" LIMITED TO, THE IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS
23 .\" FOR A PARTICULAR PURPOSE ARE DISCLAIMED. IN NO EVENT SHALL THE
24 .\" COPYRIGHT HOLDERS OR CONTRIBUTORS BE LIABLE FOR ANY DIRECT, INDIRECT,
25 .\" INCIDENTAL, SPECIAL, EXEMPLARY OR CONSEQUENTIAL DAMAGES (INCLUDING,
26 .\" BUT NOT LIMITED TO, PROCUREMENT OF SUBSTITUTE GOODS OR SERVICES;
27 .\" LOSS OF USE, DATA, OR PROFITS; OR BUSINESS INTERRUPTION) HOWEVER CAUSED
28 .\" AND ON ANY THEORY OF LIABILITY, WHETHER IN CONTRACT, STRICT LIABILITY,
29 .\" OR TORT (INCLUDING NEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY OUT
30 .\" OF THE USE OF THIS SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF
38 .Nd DragonFly Mail Agent
52 is a small Mail Transport Agent (MTA), designed for home and office use.
53 It accepts mails from locally installed Mail User Agents (MUA) and
54 delivers the mails either locally or to a remote destination.
55 Remote delivery includes several features like TLS/SSL support and SMTP
59 is not intended as a replacement for real, big MTAs like
65 does not listen on port 25 for incoming connections.
67 The options are as follows:
68 .Bl -tag -width indent
71 acts as a compatibility option for sendmail.
73 .Bl -tag -width indent
75 List all mails currently stored in the mail queue.
77 Queue the mail, but don't attempt to deliver it.
80 config file setting below.
87 Don't run in the background.
90 Set sender address (envelope-from) to
92 This overrides the value of the
94 environment variable, but is overridden by the
98 Ignore dots alone on lines by themselves in incoming messages.
99 This should be set if you are reading data from a file.
101 Set the identifier used in syslog messages to the supplied
103 This is a compatibility option for sendmail.
105 This is a compatibility option for sendmail.
106 .It Fl o Ns Ar option
111 All other options are ignored.
112 .It Fl q Ns Op Ar arg
113 Process saved messages in the queue.
114 The argument is optional and ignored.
119 Obtain recipient addresses from the message header.
129 header will be removed independent of whether
135 can be configured with two config files:
144 These two files are stored per default in
147 Every file contains parameters of the form
149 Lines containing boolean values are set to
151 if the line is commented and to
153 if the line is uncommented.
154 Empty lines or lines beginning with a
157 Parameter names and their values are case sensitive.
160 SMTP authentication can be configured in
162 Each line has the format
163 .Dq Li user|smarthost:password .
166 uses the recipient MTA hostname and finds the first entry in the auth.conf
167 file that matches the smarthost value or the hostname of the recipient
169 It then uses the user and password to authenticate with the smarthost.
171 Note, that the only authentication method supported is CRAM-MD5.
172 The receiving MTA must be configured to accept CRAM-MD5 authentication.
174 Most of the behaviour of
180 (string, default=empty)
182 If you want to send outgoing mails via a smarthost, set this variable to
183 your smarthosts address.
185 (numeric, default=25)
187 Use this port to deliver remote emails.
188 Only useful together with the
192 will deliver all mails to this port, regardless of whether a smarthost is set
195 (string, default=/etc/aliases)
197 Path to the local aliases file.
198 Just stick with the default.
199 The aliases file is of the format
200 .Dl nam: dest1 dest2 ...
201 In this case, mails to
203 will instead be delivered to
207 which in turn could be entries in
211 can be used to create a catch-all alias, which gets used if no other
212 matching alias is found.
213 Use the catch-all alias only if you don't want any local mail to be
216 (string, default=/var/spool/dma)
221 Just stick with the default.
223 (string, default=not set)
228 .It Ic SECURETRANSFER Xo
229 (boolean, default=commented)
231 Uncomment if you want TLS/SSL secured transfer.
233 (boolean, default=commented)
235 Uncomment if you want to use STARTTLS.
236 Only useful together with
238 .It Ic FINGERPRINT Xo
239 (string, default=empty)
241 Pin the server certificate by specifying its SHA256 fingerprint.
242 Only makes sense if you use a smarthost.
243 .It Ic OPPORTUNISTIC_TLS Xo
244 (boolean, default=commented)
246 Uncomment if you want to allow the STARTTLS negotiation to fail.
249 is used without a smarthost, delivering remote messages directly to
250 the outside mail exchangers; in opportunistic TLS mode, the connection will
251 be encrypted if the remote server supports STARTTLS, but an unencrypted
252 delivery will still be made if the negotiation fails.
253 Only useful together with
258 (string, default=empty)
260 Path to your SSL certificate file.
262 (boolean, default=commented)
264 Uncomment this entry and change it to
266 to use plain text SMTP login over an insecure connection.
267 You have to rename this variable manually to prevent that you send your
268 password accidentally over an insecure connection.
270 (boolean, default=commented)
272 Uncomment if you want that
275 You have to flush your mail queue manually with the
278 This option is handy if you are behind a dialup line.
280 (boolean, default=commented)
282 Uncomment if you want the bounce message to include the complete original
283 message, not just the headers.
285 (string, default=empty)
287 The internet hostname
289 uses to identify the host.
290 If not set or empty, the result of
295 is an absolute path to a file, the first line of this file will be used
298 (string, default=empty)
300 Masquerade the envelope-from addresses with this address/hostname.
301 Use this setting if mails are not accepted by destination mail servers
302 because your sender domain is invalid.
303 This setting overrides the
307 environment variable.
313 sign, the string is interpreted as a host name.
320 will send all mails as
324 will send all mails as
327 .Va username @percolator
331 (boolean, default=commented)
333 Bypass aliases and local delivery, and instead forward all mails to
341 .Ss Environment variables
344 can be influenced by some environment variables.
348 Used to set the sender address (envelope-from).
349 Use a plain address, in the form of
350 .Li user@example.com .
351 This value will be overridden when the
353 config file setting or the
363 .%T "Simple Mail Transfer Protocol"
368 .%T "SMTP Service Extension for Authentication"
373 .%T "SMTP Service Extension for Secure SMTP over TLS"
379 utility first appeared in
385 .An Matthias Schmidt Aq Mt matthias@dragonflybsd.org
387 .An Simon Schubert Aq Mt 2@0x2c.org .
390 does not currently support the