Provided by: qmail_1.06-4_i386 bug

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)