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
37 .Nd DragonFly Mail Agent
51 is a small Mail Transport Agent (MTA), designed for home and office use.
52 It accepts mails from locally installed Mail User Agents (MUA) and
53 delivers the mails either locally or to a remote destination.
54 Remote delivery includes several features like TLS/SSL support and SMTP
58 is not intended as a replacement for real, big MTAs like
62 does not listen on port 25 for incoming connections.
64 The options are as follows:
65 .Bl -tag -width indent
68 acts as a compatibility option for sendmail.
70 .Bl -tag -width indent
72 List all mails currently stored in the mail queue.
74 Queue the mail, but don't attempt to deliver it.
77 config file setting below.
84 Don't run in the background.
87 Set sender address (envelope-from) to
89 This overrides the value of the environment variable
92 Ignore dots alone on lines by themselves in incoming messages.
93 This should be set if you are reading data from a file.
95 Set the identifier used in syslog messages to the supplied
97 This is a compatibility option for sendmail.
99 This is a compatibility option for sendmail.
100 .It Fl o Ns Ar option
105 All other options are ignored.
106 .It Fl q Ns Op Ar arg
107 Process saved messages in the queue.
108 The argument is optional and ignored.
113 Obtain recipient addresses from the message header.
123 header will be removed independent of whether
129 can be configured with two config files:
138 These two files are stored per default in
141 Every file contains parameters of the form
143 Lines containing boolean values are set to
145 if the line is commented and to
147 if the line is uncommented.
148 Empty lines or lines beginning with a
151 Parameter names and their values are case sensitive.
154 SMTP authentication can be configured in
156 Each line has the format
157 .Dq Li user|smarthost:password .
159 Most of the behaviour of
165 (string, default=empty)
167 If you want to send outgoing mails via a smarthost, set this variable to
168 your smarthosts address.
170 (numeric, default=25)
172 Use this port to deliver remote emails.
173 Only useful together with the
177 will deliver all mails to this port, regardless of whether a smarthost is set
180 (string, default=/etc/aliases)
182 Path to the local aliases file.
183 Just stick with the default.
184 The aliases file is of the format
185 .Dl nam: dest1 dest2 ...
186 In this case, mails to
188 will instead be delivered to
192 which in turn could be entries in
196 can be used to create a catch-all alias, which gets used if no other
197 matching alias is found.
198 Use the catch-all alias only if you don't want any local mail to be
201 (string, default=/var/spool/dma)
206 Just stick with the default.
208 (string, default=not set)
213 .It Ic SECURETRANS Xo
214 (boolean, default=commented)
216 Uncomment if you want TLS/SSL secured transfer.
218 (boolean, default=commented)
220 Uncomment if you want to use STARTTLS.
221 Only useful together with
223 .It Ic OPPORTUNISTIC_TLS Xo
224 (boolean, default=commented)
226 Uncomment if you want to allow the STARTTLS negotiation to fail.
229 is used without a smarthost, delivering remote messages directly to
230 the outside mail exchangers; in opportunistic TLS mode, the connection will
231 be encrypted if the remote server supports STARTTLS, but an unencrypted
232 delivery will still be made if the negotiation fails.
233 Only useful together with
238 (string, default=empty)
240 Path to your SSL certificate file.
242 (boolean, default=commented)
244 Uncomment this entry and change it to
246 to use plain text SMTP login over an insecure connection.
247 You have to rename this variable manually to prevent that you send your
248 password accidentally over an insecure connection.
250 (boolean, default=commented)
252 Uncomment if you want that
255 You have to flush your mail queue manually with the
258 This option is handy if you are behind a dialup line.
260 (boolean, default=commented)
262 Uncomment if you want the bounce message to include the complete original
263 message, not just the headers.
265 (string, default=empty)
267 The internet hostname
269 uses to identify the host.
270 If not set or empty, the result of
275 is an absolute path to a file, the first line of this file will be used
278 (string, default=empty)
280 Masquerade the envelope-from addresses with this address/hostname.
281 Use this setting if mails are not accepted by destination mail servers
282 because your sender domain is invalid.
283 This setting is overridden by the
287 environment variable.
293 sign, the string is interpreted as a host name.
300 will send all mails as
304 will send all mails as
305 .Ql Sm off Va username @percolator .
308 .Ss Environment variables
311 can be influenced by some environment variables.
315 Used to set the sender address (envelope-from).
316 Use a plain address, in the form of
317 .Li user@example.com .
318 This value will be overridden when the
328 .%T "Simple Mail Transfer Protocol"
333 .%T "SMTP Service Extension for Authentication"
338 .%T "SMTP Service Extension for Secure SMTP over TLS"
344 utility first appeared in
349 .An Matthias Schmidt Aq matthias@dragonflybsd.org
351 .An Simon Schubert Aq corecode@dragonflybsd.org .