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)