mvmf: mvmts man page

MVMTS(1)                    General Commands Manual                    MVMTS(1)

NAME
       mvmts - mvmf's Mail Transport Agent (MTA) sender

SYNOPSIS
       mvmts [-b bodycache] [-C startfile] [-d domaindir] [-i interface] [-v] [-V] [-x] host sender recip ...

DESCRIPTION
       mvmts implements a sender portion of a mail transport agent.

       Its  calling  sequence  is  based  on that of qmail-remote.  Without any
       other options or arguments it is (or can be) a drop-in  replacement  for
       qmail-remote, which doesn't itself take any command line options.  mvmts
       accepts  its  message  on stdin and attempts to send it to a remote host
       via SMTP.

       mvmts may include an interpreter for its built-in mfl language, which is
       a sort of mongrelization of C and Sieve.  mfl, which is described in an-
       other document, allows programmed control over what  happens  to  email,
       and includes a number of intrinsics related to processing email.

       Options which may be given are as follows:

       -b bodycache
              Says how many bytes of message body to cache in memory.  The num-
              ber  given  is  constrained  to lie between a minimum and maximum
              specified at compile time.  The actual limit is  somewhat  fuzzy:
              regardless  of  the  number specified and regardless of the total
              number already cached, there is also a minimum amount  that  will
              be cached in each MIME part.

       -C startfile
              The name of a startup file (if built with mfl).  The startup file
              is  simply mfl code, it is run in admin mode (with regards to the
              "admin" mfl control).  If this option is omitted,  a  default  is
              used  if  configured at compile time.  The startfile name must be
              found within the system-wide mfl include path, and should  there-
              fore not be a full path to the file.

              This  option will override any default startfile or one specified
              via an environment variable.

       -d domaindir
              identifies the directory to be used for sending-domain  profiles.
              This directory can contain a subdirectory for each sending domain
              for which special treatment can be configured. (It primarily per-
              tains to DKIM signing.)

       -i interface
              tells  how results from mvmts are to be reported. The choices are
              "qmail" for compatibility with invocation by qmail utilities such
              as qmail-send, and "human" for human-readable output. The default
              is "qmail."

       -v     prints mvmts's version number.  The version number has three dec-
              imal parts separated by periods: first a  major  version  number,
              next  a  minor version number, and finally a fix number.  The fix
              number is incremented whenever a new version contains only  fixes
              and  enhancements  to existing features.  The minor number is in-
              cremented whenever a new facility or technique is added, and  the
              major  number  is  incremented  when  enough new things have been
              added to consider it a major new edition of the program.  A major
              number of zero (0)  indicates  a  prerelease  version  (one  that
              doesn't  yet include all its initial release features or that may
              not yet be considered fully tested).

       -V     prints the version numbers, as  with  the  "-v"  flag,  and  also
              prints the controls that are set.

OTHER FEATURES
       In  addition to operating basically as described in the qmail-remote man
       page, mvmts can provide

       encryption
              when sending to an SMTP server that offers a STARTTLS capability,
              mvmts will negotiate and use an encrypted TLS session.

       DKIM signing
              If the sending domain (from the sender argument  on  the  command
              line)  has DKIM signing enabled, mvmts will attempt to add a DKIM
              signature per parameters specified for the sending  domain.   See
              discussion  elsewhere  about  mvmf  DKIM signing for more details
              about this configuration.

QMAIL COMPATIBILITY
       When compiled with qmail compatibility, which as of this writing is  the
       primary  practical way to use it, mvmts uses the following qmail control
       files.

       me, helohost, smtproutes
              An mvmf extension to the smtproutes format is that a target  "<>"
              may  be  used  which  will  match messages being sent as bounces,
              mainly if the sender is <> or mailer-daemon.

MORE TO COME
       This man page is a work in [slow] progress.

FILES

SEE ALSO
       mfl -- the mfl language description.
       http://www.mvmf.org/ -- the official web site.
       Other man pages, existing: mvmtr(1), or not: mvmf-dkim(7), mfl(7), or if
       installed : qmail-remote(8).

CREDITS TO
       M. Mallett  (mem@mvmf.org)    2024-2025

BUGS
       You tell me..

                                                                       MVMTS(1)