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)