NAME

       nullmailer-send - Send queued messages

SYNOPSIS

       nullmailer-send [--daemon] [--syslog]

DESCRIPTION

       This  program  is  responsible  for  coordinating  the  transmission of messages that have been queued by
       nullmailer-queue.  It uses a variety of protocol modules to deliver the messages from the queue to remote
       "smart" servers.

       When the program starts, the queue is scanned to build  a  list  of  messages  to  send.   The  queue  is
       rescanned  when  either  the  trigger  is  pulled, or after pausetime seconds have elapsed after the last
       failed delivery.  When there are no messages in the  queue,  nullmailer  does  no  rescanning  until  the
       trigger  is  pulled.   Pulling  the  trigger  consists of opening up the trigger named pipe and writing a
       single byte to it, which causes this program to be awakened (if it's not already processing  the  queue).
       This  procedure  is  done by nullmailer-queue to ensure that messages are delivered immediately.  You can
       start delivery by hand from the command line like this:

           echo 1 > trigger

       Delivery of messages consists of reading the list of remote  servers  and  then  trying  to  deliver  the
       messages  to  these  servers  as  follows.   For  each  remote in the list, the named protocol handler is
       executed once for each message remaining in the queue.  If the protocol handler succeeds, the message  is
       removed  from  the  queue  and  processing  continues  with the next message.  If it fails, the remote is
       skipped and processing of the remaing messages continues with the next remote.  When all the remotes have
       been tried, nullmailer-send sleeps for a number of seconds specified by pausetime before retrying sending
       the contents of the queue.

OPTIONS

       -d, --daemon
              Fork into the background, implies --syslog.

       -s, --syslog
              Use syslog for error and log messages.  With --daemon, syslog will be  used  exclusively,  without
              --daemon, syslog will be used additionally.

CONTROL FILES

       All the control files are reread each time the queue is run.

       helohost
              Sets  the  environment  variable  $HELOHOST  which  is used by the SMTP protocol module to set the
              parameter given to the HELO command.  Defaults to the value of the me configuration file.

       maxpause
              The maximum number of seconds to pause between successive queue runs (defaults to 86400).

       pausetime
              The minimum number of seconds to pause between successive queue runs when there  are  messages  in
              the  queue  (defaults  to  60).   Each  time  this timeout is reached, the timeout is doubled to a
              maximum of maxpause.  After new messages are injected, the timeout is reset.  If this is set to 0,
              nullmailer-send will exit immediately after going through the queue once (one-shot mode).

       remotes
              This file contains a list of remote servers to which to send each message.  Each line of this file
              contains a remote host name or address followed by an optional protocol string, separated by white
              space.  The protocol name defaults to smtp, and may be followed by command-line arguments for that
              module.  For example, to connect to port 2525 on your SMTP smart host, which  also  requires  SMTP
              authentication, use:

                  smarthost.dom smtp --port=2525 --user=user --pass=pass

              If your smarthost requires LOGIN authentication instead of the default PLAIN method, use:

                  smarthost.dom smtp --port=2525 --auth-login --user=user --pass=pass

              Blank  lines and lines starting with a pound are ignored. When called with the --help option, each
              protocol module will list its available command-line arguments:

                  /usr/local/libexec/nullmailer/smtp --help

       sendtimeout
              The number of seconds to wait for a remote module listed  above  to  complete  sending  a  message
              before  killing it and trying again (defaults to 3600).  If this is set to 0, nullmailer-send will
              wait forever for messages to complete sending.

FILES

       /var/spool/nullmailer/queue
              The message queue.

       /var/spool/nullmailer/trigger
              A trigger file to cause immediate delivery.

       /etc/nullmailer
              The configuration directory.

       /usr/lib/nullmailer
              The protocol program directory.

SEE ALSO

       nullmailer-queue(8), nullmailer-inject(1), mailq(1), nullmailer-smtp(8), nullmailer-qmqp(8),

                                                                                              nullmailer-send(8)