Skip site navigation (1)Skip section navigation (2)

FreeBSD Manual Pages

  
 
  

home | help
DMA(8)			    System Manager's Manual			DMA(8)

NAME
       dma -- DragonFly	Mail Agent

SYNOPSIS
       dma   [-DiOt]   [-Amode]	 [-bmode]  [-f	sender]	 [-L  tag]  [-ooption]
	   [-r sender] [-q[arg]] [recipient ...]

DESCRIPTION
       dma is a	small Mail Transport Agent (MTA), designed for home and	office
       use.  It	accepts	mails from locally installed Mail  User	 Agents	 (MUA)
       and  delivers the mails either locally or to a remote destination.  Re-
       mote delivery includes several features like TLS/SSL support  and  SMTP
       authentication.

       dma  is	not  intended  as  a  replacement  for	real,  big  MTAs  like
       sendmail(8) or postfix(1).  Consequently, dma does not listen  on  port
       25 for incoming connections.

       The options are as follows:

       -Amode  -Ac acts	as a compatibility option for sendmail.

       -bmode

	       -bp     List all	mails currently	stored in the mail queue.

	       -bq     Queue  the mail,	but do not attempt to deliver it.  See
		       also the	`DEFER'	config file setting below.

	       All other modes are ignored.

       -D      Do not run in the background.  Useful for debugging.

       -f sender
	       Set sender address (envelope-from) to sender.   This  overrides
	       the  value of the EMAIL environment variable, but is overridden
	       by the `MASQUERADE' config file setting.

       -i      Ignore dots alone on lines by themselves	in incoming  messages.
	       This should be set if you are reading data from a file.

       -L tag  Set the identifier used in syslog messages to the supplied tag.
	       This is a compatibility option for sendmail.

       -O      This is a compatibility option for sendmail.

       -ooption
	       Specifying  -oi is synonymous to	-i.  All other options are ig-
	       nored.

       -q[arg]
	       Process saved messages in the queue.  The argument is  optional
	       and ignored.

       -r sender
	       Same as -f.

       -t      Obtain  recipient  addresses from the message header.  dma will
	       parse the To:, Cc:, and Bcc: headers.  The Bcc: header will  be
	       removed independent of whether -t is specified or not.

CONFIGURATION
       dma can be configured with two config files:

          auth.conf
          dma.conf

       These two files are stored per default in /etc/dma.

FILE FORMAT
       Every  file  contains  parameters of the	form `name value'.  Lines con-
       taining boolean values are set to `NO' if the line is commented and  to
       `YES'  if the line is uncommented.  Empty lines or lines	beginning with
       a `#' are ignored.  Parameter names and their values  are  case	sensi-
       tive.

PARAMETERS
   auth.conf
       SMTP  authentication can	be configured in auth.conf.  Each line has the
       format "user|smarthost:password".

   dma.conf
       Most of the behaviour of	dma can	be configured in dma.conf.

       SMARTHOST (string, default=empty)
	     If	you want to send outgoing mails	 via  a	 smarthost,  set  this
	     variable to your smarthosts address.

       PORT (numeric, default=25)
	     Use  this	port  to  deliver remote emails.  Only useful together
	     with the `SMARTHOST' option, because dma will deliver  all	 mails
	     to	this port, regardless of whether a smarthost is	set or not.

       ALIASES (string,	default=/etc/aliases)
	     Path  to  the  local  aliases file.  Just stick with the default.
	     The aliases file is of the	format
		   nam:	dest1 dest2 ...
	     In	this case, mails to nam	will instead be	delivered to dest1 and
	     dest2, which in turn could	be entries in /etc/aliases.  The  spe-
	     cial name `*' can be used to create a catch-all alias, which gets
	     used  if  no  other  matching  alias is found.  Use the catch-all
	     alias only	if you do not want any local mail to be	delivered.

       SPOOLDIR	(string, default=/var/spool/dma)
	     Path to dma's spool directory.  Just stick	with the default.

       AUTHPATH	(string, default=not set)
	     Path to the `auth.conf' file.

       SECURETRANSFER (boolean,	default=commented)
	     Uncomment if you want TLS/SSL secured transfer.

       STARTTLS	(boolean, default=commented)
	     Uncomment if you want to use STARTTLS.  Only useful together with
	     `SECURETRANSFER'.

       FINGERPRINT (string, default=empty)
	     Pin the server certificate	by specifying its SHA256  fingerprint.
	     Only makes	sense if you use a smarthost.

       OPPORTUNISTIC_TLS (boolean, default=commented)
	     Uncomment	if you want to allow the STARTTLS negotiation to fail.
	     Most useful when dma is used without a smarthost, delivering  re-
	     mote  messages directly to	the outside mail exchangers; in	oppor-
	     tunistic TLS mode,	the connection will be encrypted if the	remote
	     server supports STARTTLS, but an unencrypted delivery will	 still
	     be	 made  if  the	negotiation  fails.  Only useful together with
	     `SECURETRANSFER' and `STARTTLS'.

       CERTFILE	(string, default=empty)
	     Path to your SSL certificate file.

       SECURE (boolean,	default=commented)
	     Uncomment this entry and change it	to  `INSECURE'	to  use	 plain
	     text  SMTP	login over an insecure connection.  You	have to	rename
	     this variable manually to prevent that you	send your password ac-
	     cidentally	over an	insecure connection.

       DEFER (boolean, default=commented)
	     Uncomment if you want that	dma defers your	 mail.	 You  have  to
	     flush  your  mail queue manually with the -q option.  This	option
	     is	handy if you are behind	a dialup line.

       FULLBOUNCE (boolean, default=commented)
	     Uncomment if you want the bounce message to include the  complete
	     original message, not just	the headers.

       MAILNAME	(string, default=empty)
	     The  internet hostname dma	uses to	identify the host.  If not set
	     or	empty, the result of gethostname(3) is used.  If `MAILNAME' is
	     an	absolute path to a file, the first line	of this	file  will  be
	     used as the hostname.

       MASQUERADE (string, default=empty)
	     Masquerade	 the  envelope-from  addresses with this address/host-
	     name.  Use	this setting if	mails are not accepted by  destination
	     mail servers because your sender domain is	invalid.  This setting
	     overrides the -f flag and the EMAIL environment variable.

	     If	 `MASQUERADE'  does not	contain	a @ sign, the string is	inter-
	     preted as a host name.   For  example,  setting  `MASQUERADE'  to
	     `john@'  on  host	`hamlet' will send all mails as	`john@hamlet';
	     setting   it   to	 `percolator'	will   send   all   mails   as
	     `username@percolator'.

       NULLCLIENT (boolean, default=commented)
	     Bypass  aliases and local delivery, and instead forward all mails
	     to	the defined `SMARTHOST'.  `NULLCLIENT' requires	`SMARTHOST' to
	     be	set.

   Environment variables
       The behavior of dma can be influenced by	some environment variables.

       EMAIL
	     Used to set the sender address (envelope-from).  Use a plain  ad-
	     dress, in the form	of user@example.com.  This value will be over-
	     ridden  when  the `MASQUERADE' config file	setting	or the -f flag
	     is	used.

SEE ALSO
       mailaddr(7), mailwrapper(8), sendmail(8)

       J. B. Postel, Simple Mail Transfer Protocol, RFC	821.

       J. Myers, SMTP Service Extension	for Authentication, RFC	2554.

       P. Hoffman, SMTP	Service	Extension for Secure SMTP over TLS, RFC	2487.

HISTORY
       The dma utility first appeared in DragonFly 1.11.

AUTHORS
       dma was written by  Matthias  Schmidt  <matthias@dragonflybsd.org>  and
       Simon Schubert <2@0x2c.org>.

FreeBSD	14.3			 May 20, 2017				DMA(8)

Want to link to this manual page? Use this URL:
<https://man.freebsd.org/cgi/man.cgi?query=dma&manpath=FreeBSD+14.3-RELEASE+and+Ports>

home | help