qmail-send(8)
NAME
qmail-send - deliver mail messages from the queue
SYNOPSIS
qmail-send
DESCRIPTION
qmail-send handles messages placed into the outgoing queue by qmail-
queue. It uses qmail-lspawn to deliver messages to local recipients
and qmail-rspawn to deliver messages to remote recipients. If a
message is temporarily undeliverable to one or more addresses, qmail-
send leaves it in the queue and tries the addresses again later.
qmail-send prints a readable record of its activities to descriptor 0.
It writes commands to qmail-lspawn, qmail-rspawn, and qmail-clean on
descriptors 1, 3, and 5, and reads responses from descriptors 2, 4, and
6. qmail-send is responsible for avoiding deadlock.
If qmail-send receives a TERM signal, it will exit cleanly, after
waiting (possibly more than a minute) for current delivery attempts to
finish.
If qmail-send receives an ALRM signal, it will reschedule every message
in the queue for immediate delivery.
CONTROL FILES
WARNING: qmail-send reads its control files only when it starts. If
you change the control files, you must stop and restart qmail-send.
Exception: If qmail-send receives a HUP signal, it will reread locals
and virtualdomains.
bouncefrom
Bounce username. Default: MAILER-DAEMON.
bouncehost
Bounce host. Default: me, if that is supplied; otherwise the
literal name bouncehost, which is probably not what you want. If
a message is permanently undeliverable, qmail-send sends a single-
bounce notice back to the message's envelope sender. The notice
is From: bouncefrom@bouncehost, although its envelope sender is
empty.
concurrencylocal
Maximum number of simultaneous local delivery attempts. Default:
10. If 0, local deliveries will be put on hold. concurrencylocal
is limited at compile time to 120.
concurrencyremote
Maximum number of simultaneous remote delivery attempts. Default:
20. If 0, remote deliveries will be put on hold.
concurrencyremote is limited at compile time to 120.
doublebouncehost
Double-bounce host. Default: me, if that is supplied; otherwise
the literal name doublebouncehost, which is probably not what you
want.
doublebounceto
User to receive double-bounces. Default: postmaster. If a
single-bounce notice is permanently undeliverable, qmail-send
sends a double-bounce notice to doublebounceto@doublebouncehost.
(If that bounces, qmail-send gives up.)
envnoathost
Presumed domain name for addresses without @ signs. Default: me,
if that is supplied; otherwise the literal name envnoathost, which
is probably not what you want. If qmail-send sees an envelope
recipient address without an @ sign, it appends @envnoathost.
locals
List of domain names that the current host receives mail for, one
per line. Default: me, if that is supplied; otherwise qmail-send
refuses to run. An address user@domain is considered local if
domain is listed in locals.
percenthack
List of domain names where the percent hack is applied. If domain
is listed in percenthack, any address of the form user%fqdn@domain
is rewritten as user@fqdn. user may contain %, so the percent
hack may be applied repeatedly. qmail-send handles percenthack
before locals.
queuelifetime
Number of seconds a message can stay in the queue. Default:
604800 (one week). After this time expires, qmail-send will try
the message once more, but it will treat any temporary delivery
failures as permanent failures.
virtualdomains
List of virtual users or domains, one per line. A virtual user
has the form user@domain:prepend, without any extra spaces. When
qmail-send sees the recipient address user@domain, it converts it
to prepend-user@domain and treats it as local.
A virtual domain has the form domain:prepend. It applies to any
recipient address at domain. For example, if
nowhere.mil:joe-foo
is in virtualdomains, and a message arrives for info@nowhere.mil,
qmail-send will rewrite the recipient address as joe-foo-
info@nowhere.mil and deliver the message locally.
virtualdomains may contain wildcards:
.fax:uucp-fax
:alias-catchall
.nowhere.mil:joe-foo-host
virtualdomains may also contain exceptions: an empty prepend means
that domain is not a virtual domain.
qmail-send handles virtualdomains after locals: if a domain is
listed in locals, virtualdomains does not apply.
SEE ALSO
nice(1), addresses(5), envelopes(5), qmail-control(5), qmail-log(5),
qmail-queue(8), qmail-clean(8), qmail-lspawn(8), qmail-rspawn(8)
qmail-send(8)
Free and Open Source Software