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.

CONTROL FILES

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.

concurrencyremote
    Maximum number of simultaneous remote delivery attempts. Default: 20. If 0, remote deliveries will be put on hold.

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 envelope recipient addresses without @ signs. Default: me, if that is supplied; otherwise the literal name envnoathost, which is probably not what you want. Envelope recipient addresses without an @ sign are illegal. If qmail-send sees an illegal address, 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.

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.

usermap
    List of user nicknames, one per line. Each nickname has the form nick:user, without any extra spaces. If domain is listed in locals then qmail-send converts nick@domain to user@domain. It also converts nick-anything@domain to user-anything@domain. Note that this treatment does not apply to domains listed in virtualdomains.

virtualdomains
    List of virtual domains, one per line. Each virtual domain has the form domain:prepend, without any extra spaces. When qmail-send sees a recipient address at domain, say user@domain, it converts it to prepend-user@domain and treats it as local. 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
    Note that qmail-send handles virtualdomains after locals.

SEE ALSO
nice(1), addresses(5), envelopes(5), qmail-control(5), qmail-queue(8), qmail-clean(8), qmail-lspawn(8), qmail-rspawn(8)