qmail-local (8)
NAME
qmail-local - deliver or forward a mail messageSYNOPSIS
qmail-local [ -nN ] user homedir local dash ext domain sender defaultdeliveryDESCRIPTION
qmail-local reads a mail message and delivers it to user by the procedure described in dot-qmail(5).The message's envelope recipient is local@domain. qmail-local records local@domain in a new Delivered-To header field. If exactly the same Delivered-To: local@domain already appears in the header, qmail-local bounces the message, to prevent mail forwarding loops.
The message's envelope sender is sender. qmail-local records sender in a new Return-Path header field.
homedir is the user's home directory. It must be an absolute directory name.
dash and ext identify the .qmaildashext file used by qmail-local; see dot-qmail(5). Normally dash is either empty or a lone hyphen. If it is empty, qmail-local treats a nonexistent .qmailext the same way as an empty .qmailext: namely, following the delivery instructions in defaultdelivery.
The standard input for qmail-local must be a seekable file, so that qmail-local can read it more than once.
OPTIONS
- -n
- Instead of reading and delivering the message, print a description of the delivery instructions.
- -N
- (Default.) Read and deliver the message.
EXIT CODES
0 if the delivery is completely successful; nonzero if any delivery instruction failed. Exit code 111 indicates temporary failure.SEE ALSO
dot-qmail(5), envelopes(5), qmail-command(8), qmail-queue(8), qmail-send(8), qmail-lspawn(8)