Provided by: nullmailer_1.04-1_i386 bug

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)