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.

       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.

       pausetime
              The  number  of  seconds  to  pause  between  successive  queue runs when there are
              messages in the queue (defaults to 60).  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.

       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-send(8)