.TH qmail-local 8.SH NAMEqmail-local \- deliver or forward a mail message.SH SYNOPSIS.B qmail-local[.B \-nN].I user.I homedir.I local.I dash.I ext.I domain.I sender.I defaultdelivery.SH DESCRIPTION.B qmail-localreads a mail messageand delivers it to.I userby the procedure described in.BR dot-qmail(5) .The message's envelope recipient is.IR local@domain ..B qmail-localrecords.I local@domainin a new.B Delivered-Toheader field.If exactly the same.B Delivered-To: \fIlocal@domainalready appears in the header,.B qmail-localbounces the message,to prevent mail forwarding loops.The message's envelope sender is.IR sender ..B qmail-localrecords.I senderin a new.B Return-Pathheader field..I homediris the user's home directory.It must be an absolute directory name..I dashand.I extidentify the.B .qmail\fIdashextfile used by.BR qmail-local ;see.BR dot-qmail(5) .Normally.I dashis either empty or a lone hyphen.If it is empty,.B qmail-localtreats a nonexistent.B .qmail\fIextthe same way as an empty.BR .qmail\fIext :namely, following the delivery instructions in.IR defaultdelivery .The standard input for.B qmail-localmust be a seekable file,so that.B qmail-localcan read it more than once..SH "OPTIONS".TP.B \-nInstead of reading and delivering the message,print a description of the delivery instructions..TP.B \-N(Default.) Read and deliver the message..SH "EXIT CODES"0 if the delivery is completely successful;nonzero if any delivery instruction failed.Exit code 111indicates temporary failure..SH "SEE ALSO"dot-qmail(5),envelopes(5),qmail-command(8),qmail-queue(8),qmail-send(8),qmail-lspawn(8)