]>
Commit | Line | Data |
---|---|---|
86e4d161 | 1 | .\" |
e458e5f0 | 2 | .\" Copyright (c) 2008-2014, Simon Schubert <2@0x2c.org>. |
86e4d161 MS |
3 | .\" Copyright (c) 2008 |
4 | .\" The DragonFly Project. All rights reserved. | |
5 | .\" | |
6 | .\" Redistribution and use in source and binary forms, with or without | |
7 | .\" modification, are permitted provided that the following conditions | |
8 | .\" are met: | |
9 | .\" | |
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 | |
15 | .\" distribution. | |
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. | |
19 | .\" | |
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 | |
31 | .\" SUCH DAMAGE. | |
32 | .\" | |
e882bde8 | 33 | .Dd February 13, 2014 |
86e4d161 MS |
34 | .Dt DMA 8 |
35 | .Os | |
36 | .Sh NAME | |
37 | .Nm dma | |
38 | .Nd DragonFly Mail Agent | |
39 | .Sh SYNOPSIS | |
40 | .Nm | |
f734c0ae | 41 | .Op Fl DiOt |
30e2d711 SS |
42 | .Op Fl A Ns Ar mode |
43 | .Op Fl b Ns Ar mode | |
86e4d161 MS |
44 | .Op Fl f Ar sender |
45 | .Op Fl L Ar tag | |
30e2d711 | 46 | .Op Fl o Ns Ar option |
86e4d161 | 47 | .Op Fl r Ar sender |
30e2d711 | 48 | .Op Fl q Ns Op Ar arg |
86e4d161 MS |
49 | .Op Ar recipient ... |
50 | .Sh DESCRIPTION | |
51 | .Nm | |
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 | |
15386ecd | 56 | authentication. |
86e4d161 MS |
57 | .Pp |
58 | .Nm | |
59 | is not intended as a replacement for real, big MTAs like | |
60 | .Xr sendmail 8 | |
61 | or | |
0f215b8d | 62 | .Xr postfix 1 . |
86e4d161 MS |
63 | Consequently, |
64 | .Nm | |
65 | does not listen on port 25 for incoming connections. | |
66 | .Pp | |
67 | The options are as follows: | |
68 | .Bl -tag -width indent | |
30e2d711 SS |
69 | .It Fl A Ns Ar mode |
70 | .Fl \&Ac | |
86e4d161 | 71 | acts as a compatibility option for sendmail. |
30e2d711 | 72 | .It Fl b Ns Ar mode |
bca4c72a SS |
73 | .Bl -tag -width indent |
74 | .It Fl bp | |
75 | List all mails currently stored in the mail queue. | |
76 | .It Fl bq | |
77 | Queue the mail, but don't attempt to deliver it. | |
78 | See also the | |
79 | .Sq DEFER | |
80 | config file setting below. | |
81 | .El | |
82 | .Pp | |
83 | All other | |
84 | .Ar mode Ns | |
85 | s are are ignored. | |
86e4d161 MS |
86 | .It Fl D |
87 | Don't run in the background. | |
88 | Useful for debugging. | |
89 | .It Fl f Ar sender | |
fcadfbe3 | 90 | Set sender address (envelope-from) to |
86e4d161 | 91 | .Ar sender . |
fcadfbe3 SS |
92 | This overrides the value of the environment variable |
93 | .Ev EMAIL . | |
86e4d161 MS |
94 | .It Fl i |
95 | Ignore dots alone on lines by themselves in incoming messages. | |
96 | This should be set if you are reading data from a file. | |
97 | .It Fl L Ar tag | |
98 | Set the identifier used in syslog messages to the supplied | |
99 | .Ar tag . | |
100 | This is a compatibility option for sendmail. | |
9a0b96be MS |
101 | .It Fl O |
102 | This is a compatibility option for sendmail. | |
30e2d711 | 103 | .It Fl o Ns Ar option |
86e4d161 | 104 | Specifying |
30e2d711 | 105 | .Fl oi |
86e4d161 MS |
106 | is synonymous to |
107 | .Fl i . | |
108 | All other options are ignored. | |
30e2d711 | 109 | .It Fl q Ns Op Ar arg |
86e4d161 | 110 | Process saved messages in the queue. |
30e2d711 | 111 | The argument is optional and ignored. |
86e4d161 MS |
112 | .It Fl r Ar sender |
113 | Same as | |
114 | .Fl f . | |
f734c0ae SS |
115 | .It Fl t |
116 | Obtain recipient addresses from the message header. | |
30e2d711 SS |
117 | .Nm |
118 | will parse the | |
f734c0ae SS |
119 | .Li To: , |
120 | .Li Cc: , | |
121 | and | |
122 | .Li Bcc: | |
123 | headers. | |
124 | The | |
125 | .Li Bcc: | |
126 | header will be removed independent of whether | |
127 | .Fl t | |
128 | is specified or not. | |
86e4d161 MS |
129 | .El |
130 | .Sh CONFIGURATION | |
131 | .Nm | |
1bd6c537 | 132 | can be configured with two config files: |
86e4d161 MS |
133 | .Pp |
134 | .Bl -bullet -compact | |
135 | .It | |
136 | auth.conf | |
137 | .It | |
138 | dma.conf | |
86e4d161 MS |
139 | .El |
140 | .Pp | |
1bd6c537 | 141 | These two files are stored per default in |
86e4d161 | 142 | .Pa /etc/dma . |
86e4d161 MS |
143 | .Sh FILE FORMAT |
144 | Every file contains parameters of the form | |
145 | .Sq name value . | |
146 | Lines containing boolean values are set to | |
147 | .Sq NO | |
148 | if the line is commented and to | |
149 | .Sq YES | |
150 | if the line is uncommented. | |
151 | Empty lines or lines beginning with a | |
152 | .Sq # | |
153 | are ignored. | |
154 | Parameter names and their values are case sensitive. | |
155 | .Sh PARAMETERS | |
156 | .Ss auth.conf | |
157 | SMTP authentication can be configured in | |
158 | .Pa auth.conf . | |
159 | Each line has the format | |
160 | .Dq Li user|smarthost:password . | |
161 | .Ss dma.conf | |
162 | Most of the behaviour of | |
163 | .Nm | |
164 | can be configured in | |
165 | .Pa dma.conf . | |
86e4d161 MS |
166 | .Bl -tag -width 4n |
167 | .It Ic SMARTHOST Xo | |
168 | (string, default=empty) | |
169 | .Xc | |
170 | If you want to send outgoing mails via a smarthost, set this variable to | |
171 | your smarthosts address. | |
172 | .It Ic PORT Xo | |
173 | (numeric, default=25) | |
174 | .Xc | |
175 | Use this port to deliver remote emails. | |
176 | Only useful together with the | |
177 | .Sq SMARTHOST | |
178 | option, because | |
179 | .Nm | |
b53f68fc SW |
180 | will deliver all mails to this port, regardless of whether a smarthost is set |
181 | or not. | |
86e4d161 | 182 | .It Ic ALIASES Xo |
db93ed9b | 183 | (string, default=/etc/aliases) |
86e4d161 MS |
184 | .Xc |
185 | Path to the local aliases file. | |
186 | Just stick with the default. | |
a803c7a6 SS |
187 | The aliases file is of the format |
188 | .Dl nam: dest1 dest2 ... | |
189 | In this case, mails to | |
190 | .Li nam | |
191 | will instead be delivered to | |
192 | .Li dest1 | |
193 | and | |
194 | .Li dest2 , | |
195 | which in turn could be entries in | |
196 | .Pa /etc/aliases . | |
197 | The special name | |
198 | .Ql * | |
199 | can be used to create a catch-all alias, which gets used if no other | |
200 | matching alias is found. | |
201 | Use the catch-all alias only if you don't want any local mail to be | |
202 | delivered. | |
86e4d161 MS |
203 | .It Ic SPOOLDIR Xo |
204 | (string, default=/var/spool/dma) | |
205 | .Xc | |
206 | Path to | |
207 | .Nm Ap s | |
208 | spool directory. | |
209 | Just stick with the default. | |
86e4d161 | 210 | .It Ic AUTHPATH Xo |
a069120d | 211 | (string, default=not set) |
86e4d161 MS |
212 | .Xc |
213 | Path to the | |
214 | .Sq auth.conf | |
215 | file. | |
86e4d161 MS |
216 | .It Ic SECURETRANS Xo |
217 | (boolean, default=commented) | |
218 | .Xc | |
d28187a3 | 219 | Uncomment if you want TLS/SSL secured transfer. |
86e4d161 MS |
220 | .It Ic STARTTLS Xo |
221 | (boolean, default=commented) | |
222 | .Xc | |
d28187a3 | 223 | Uncomment if you want to use STARTTLS. |
86e4d161 MS |
224 | Only useful together with |
225 | .Sq SECURETRANS . | |
4dea15f5 PP |
226 | .It Ic OPPORTUNISTIC_TLS Xo |
227 | (boolean, default=commented) | |
228 | .Xc | |
229 | Uncomment if you want to allow the STARTTLS negotiation to fail. | |
230 | Most useful when | |
231 | .Nm | |
232 | is used without a smarthost, delivering remote messages directly to | |
233 | the outside mail exchangers; in opportunistic TLS mode, the connection will | |
234 | be encrypted if the remote server supports STARTTLS, but an unencrypted | |
235 | delivery will still be made if the negotiation fails. | |
236 | Only useful together with | |
237 | .Sq SECURETRANS | |
238 | and | |
239 | .Sq STARTTLS . | |
86e4d161 MS |
240 | .It Ic CERTFILE Xo |
241 | (string, default=empty) | |
242 | .Xc | |
243 | Path to your SSL certificate file. | |
dfce7456 MS |
244 | .It Ic SECURE Xo |
245 | (boolean, default=commented) | |
246 | .Xc | |
d28187a3 | 247 | Uncomment this entry and change it to |
dfce7456 MS |
248 | .Sq INSECURE |
249 | to use plain text SMTP login over an insecure connection. | |
250 | You have to rename this variable manually to prevent that you send your | |
5a2a19a6 | 251 | password accidentally over an insecure connection. |
86e4d161 MS |
252 | .It Ic DEFER Xo |
253 | (boolean, default=commented) | |
254 | .Xc | |
d28187a3 | 255 | Uncomment if you want that |
86e4d161 MS |
256 | .Nm |
257 | defers your mail. | |
258 | You have to flush your mail queue manually with the | |
259 | .Fl q | |
260 | option. | |
261 | This option is handy if you are behind a dialup line. | |
8ee63931 SS |
262 | .It Ic FULLBOUNCE Xo |
263 | (boolean, default=commented) | |
264 | .Xc | |
265 | Uncomment if you want the bounce message to include the complete original | |
266 | message, not just the headers. | |
ebe7ade7 SS |
267 | .It Ic MAILNAME Xo |
268 | (string, default=empty) | |
269 | .Xc | |
27905878 SS |
270 | The internet hostname |
271 | .Nm | |
272 | uses to identify the host. | |
273 | If not set or empty, the result of | |
dda8c366 | 274 | .Xr gethostname 3 |
27905878 SS |
275 | is used. |
276 | If | |
ebe7ade7 | 277 | .Sq MAILNAME |
27905878 SS |
278 | is an absolute path to a file, the first line of this file will be used |
279 | as the hostname. | |
5bc72de8 SS |
280 | .It Ic MASQUERADE Xo |
281 | (string, default=empty) | |
282 | .Xc | |
dda8c366 | 283 | Masquerade the envelope-from addresses with this address/hostname. |
5bc72de8 SS |
284 | Use this setting if mails are not accepted by destination mail servers |
285 | because your sender domain is invalid. | |
286 | This setting is overridden by the | |
287 | .Fl f | |
288 | flag and the | |
289 | .Ev EMAIL | |
290 | environment variable. | |
291 | .Pp | |
292 | If | |
293 | .Sq MASQUERADE | |
294 | does not contain a | |
295 | .Li @ | |
296 | sign, the string is interpreted as a host name. | |
297 | For example, setting | |
298 | .Sq MASQUERADE | |
299 | to | |
300 | .Ql john@ | |
301 | on host | |
302 | .Ql hamlet | |
303 | will send all mails as | |
304 | .Ql john@hamlet ; | |
305 | setting it to | |
306 | .Ql percolator | |
307 | will send all mails as | |
308 | .Ql Sm off Va username @percolator . | |
309 | .Sm on | |
e882bde8 BD |
310 | .It Ic NULLCLIENT Xo |
311 | .Xc | |
312 | Bypass aliases and local delivery, and instead forward all mails to | |
313 | the defined | |
314 | .Sq SMARTHOST . | |
315 | .Sq NULLCLIENT | |
316 | requires | |
317 | .Sq SMARTHOST | |
318 | to be set. | |
86e4d161 | 319 | .El |
fcadfbe3 SS |
320 | .Ss Environment variables |
321 | The behavior of | |
322 | .Nm | |
323 | can be influenced by some environment variables. | |
fcadfbe3 SS |
324 | .Bl -tag -width 4n |
325 | .It Ev EMAIL Xo | |
326 | .Xc | |
327 | Used to set the sender address (envelope-from). | |
328 | Use a plain address, in the form of | |
329 | .Li user@example.com . | |
330 | This value will be overridden when the | |
331 | .Fl f | |
332 | flag is used. | |
333 | .El | |
86e4d161 MS |
334 | .Sh SEE ALSO |
335 | .Xr mailaddr 7 , | |
336 | .Xr mailwrapper 8 , | |
337 | .Xr sendmail 8 | |
338 | .Rs | |
339 | .%A "J. B. Postel" | |
340 | .%T "Simple Mail Transfer Protocol" | |
341 | .%O RFC 821 | |
342 | .Re | |
343 | .Rs | |
344 | .%A "J. Myers" | |
345 | .%T "SMTP Service Extension for Authentication" | |
346 | .%O RFC 2554 | |
347 | .Re | |
348 | .Rs | |
349 | .%A "P. Hoffman" | |
350 | .%T "SMTP Service Extension for Secure SMTP over TLS" | |
351 | .%O RFC 2487 | |
352 | .Re | |
353 | .Sh HISTORY | |
354 | The | |
355 | .Nm | |
356 | utility first appeared in | |
357 | .Dx 1.11 . | |
358 | .Sh AUTHORS | |
aa405e27 | 359 | .An -nosplit |
86e4d161 MS |
360 | .Nm |
361 | was written by | |
aa405e27 | 362 | .An Matthias Schmidt Aq Mt matthias@dragonflybsd.org |
86e4d161 | 363 | and |
aa405e27 | 364 | .An Simon Schubert Aq Mt 2@0x2c.org . |