1 .TH qmail-send 8

     2 .SH NAME

     3 qmail-send \- deliver mail messages from the queue

     4 .SH SYNOPSIS

     5 .B qmail-send

     6 .SH DESCRIPTION

     7 .B qmail-send

     8 handles messages placed into the outgoing queue by

     9 .BR qmail-queue .

    10 It uses

    11 .B qmail-lspawn

    12 to deliver messages to local recipients and

    13 .B qmail-rspawn

    14 to deliver messages to remote recipients.

    15 If a message is temporarily undeliverable to one or more addresses,

    16 .B qmail-send

    17 leaves it in the queue and tries the addresses again later.

    18 

    19 .B qmail-send

    20 prints a readable record of its activities to descriptor 0.

    21 It writes commands to

    22 .BR qmail-lspawn ,

    23 .BR qmail-rspawn ,

    24 and

    25 .B qmail-clean

    26 on descriptors 1, 3, and 5,

    27 and reads responses from descriptors 2, 4, and 6.

    28 .B qmail-send

    29 is responsible for avoiding deadlock.

    30 

    31 If

    32 .B qmail-send

    33 receives a TERM signal,

    34 it will exit cleanly, after waiting

    35 (possibly more than a minute)

    36 for current delivery attempts to finish.

    37 

    38 If

    39 .B qmail-send

    40 receives an ALRM signal,

    41 it will reschedule every message in the queue for immediate delivery.

    42 .SH "CONTROL FILES"

    43 .B WARNING:

    44 .B qmail-send

    45 reads its control files only when it starts.

    46 If you change the control files,

    47 you must stop and restart

    48 .BR qmail-send .

    49 Exception:

    50 If

    51 .B qmail-send

    52 receives a HUP signal,

    53 it will reread

    54 .I locals

    55 and

    56 .IR virtualdomains .

    57 .TP 5

    58 .I bouncefrom

    59 Bounce username.

    60 Default:

    61 .BR MAILER-DAEMON .

    62 .TP 5

    63 .I bouncehost

    64 Bounce host.

    65 Default:

    66 .IR me ,

    67 if that is supplied;

    68 otherwise the literal name

    69 .BR bouncehost ,

    70 which is probably not what you want.

    71 If a message is permanently undeliverable,

    72 .B qmail-send

    73 sends a

    74 .B single-bounce

    75 notice back to the message's envelope sender.

    76 The notice is

    77 .B From: \fIbouncefrom\fB@\fIbouncehost\fR,

    78 although its envelope sender is empty.

    79 .TP 5

    80 .I concurrencylocal

    81 Maximum number of simultaneous local delivery attempts.

    82 Default: 10.

    83 If 0, local deliveries will be put on hold.

    84 .I concurrencylocal

    85 is limited at compile time to

    86 SPAWN.

    87 .TP 5

    88 .I concurrencyremote

    89 Maximum number of simultaneous remote delivery attempts.

    90 Default: 20.

    91 If 0, remote deliveries will be put on hold.

    92 .I concurrencyremote

    93 is limited at compile time to

    94 SPAWN.

    95 .TP 5

    96 .I doublebouncehost

    97 Double-bounce host.

    98 Default:

    99 .IR me ,

   100 if that is supplied;

   101 otherwise the literal name

   102 .BR doublebouncehost ,

   103 which is probably not what you want.

   104 .TP 5

   105 .I doublebounceto

   106 User to receive double-bounces.

   107 Default:

   108 .BR postmaster .

   109 If a single-bounce notice is permanently undeliverable,

   110 .B qmail-send

   111 sends a

   112 .B double-bounce

   113 notice to

   114 .IR doublebounceto\fB@\fIdoublebouncehost .

   115 (If that bounces,

   116 .B qmail-send

   117 gives up.)

   118 .TP 5

   119 .I envnoathost

   120 Presumed domain name for addresses without @ signs.

   121 Default:

   122 .IR me ,

   123 if that is supplied;

   124 otherwise the literal name

   125 .BR envnoathost ,

   126 which is probably not what you want.

   127 If

   128 .B qmail-send

   129 sees an envelope recipient address without an @ sign,

   130 it appends

   131 .B @\fIenvnoathost\fR.

   132 .TP 5

   133 .I locals

   134 List of domain names that the current host

   135 receives mail for,

   136 one per line.

   137 Default:

   138 .IR me ,

   139 if that is supplied;

   140 otherwise

   141 .B qmail-send

   142 refuses to run.

   143 An address 

   144 .I user@domain

   145 is considered local if

   146 .I domain

   147 is listed in

   148 .IR locals .

   149 .TP 5

   150 .I percenthack

   151 List of domain names where the percent hack is applied.

   152 If

   153 .I domain

   154 is listed in

   155 .IR percenthack ,

   156 any address of the form

   157 .I user%fqdn@domain

   158 is rewritten as

   159 .IR user@fqdn .

   160 .I user

   161 may contain %,

   162 so the percent hack may be applied repeatedly.

   163 .B qmail-send

   164 handles

   165 .I percenthack

   166 before

   167 .IR locals .

   168 .TP 5

   169 .I queuelifetime

   170 Number of seconds

   171 a message can stay in the queue.

   172 Default: 604800 (one week).

   173 After this time expires,

   174 .B qmail-send

   175 will try the message once more,

   176 but it will treat any temporary delivery failures as

   177 permanent failures.

   178 .TP 5

   179 .I virtualdomains

   180 List of virtual users or domains, one per line.

   181 A virtual user has the form

   182 .IR user\fB@\fIdomain\fB:\fIprepend ,

   183 without any extra spaces.

   184 When

   185 .B qmail-send

   186 sees the recipient address

   187 .IR user\fB@\fIdomain ,

   188 it converts it to

   189 .I prepend\fB-\fIuser\fB@\fIdomain

   190 and treats it as local.

   191 

   192 A virtual domain has the form

   193 .IR domain\fB:\fIprepend .

   194 It applies to any recipient address at

   195 .IR domain .

   196 For example, if

   197 

   198 .EX

   199      nowhere.mil:joeBREAKfoo

   200 .EE

   201 

   202 is in

   203 .IR virtualdomains ,

   204 and a message arrives for

   205 .BR info@nowhere.mil ,

   206 .B qmail-send

   207 will rewrite the recipient address as

   208 .B joeBREAKfoo-info@nowhere.mil

   209 and deliver the message locally.

   210 

   211 .I virtualdomains

   212 may contain wildcards:

   213 

   214 .EX

   215      .fax:uucpBREAKfax

   216      :aliasBREAKcatchall

   217      .nowhere.mil:joeBREAKfoo-host

   218 .EE

   219 

   220 .I virtualdomains

   221 may also contain exceptions:

   222 an empty

   223 .I prepend

   224 means that

   225 .I domain

   226 is not a virtual domain.

   227 

   228 .B qmail-send

   229 handles

   230 .I virtualdomains

   231 after

   232 .IR locals :

   233 if a domain is listed in

   234 .IR locals ,

   235 .I virtualdomains

   236 does not apply.

   237 .SH "SEE ALSO"

   238 nice(1),

   239 addresses(5),

   240 envelopes(5),

   241 qmail-control(5),

   242 qmail-log(5),

   243 qmail-queue(8),

   244 qmail-clean(8),

   245 qmail-lspawn(8),

   246 qmail-rspawn(8)