path: root/qmail-local.8
diff options
Diffstat (limited to 'qmail-local.8')
1 files changed, 99 insertions, 0 deletions
diff --git a/qmail-local.8 b/qmail-local.8
new file mode 100644
index 0000000..c047697
--- /dev/null
+++ b/qmail-local.8
@@ -0,0 +1,99 @@
+.TH qmail-local 8
+qmail-local \- deliver or forward a mail message
+.B qmail-local
+.B \-nN
+.I user
+.I homedir
+.I local
+.I dash
+.I ext
+.I domain
+.I sender
+.I defaultdelivery
+.B qmail-local
+reads a mail message
+and delivers it to
+.I user
+by the procedure described in
+.BR dot-qmail(5) .
+The message's envelope recipient is
+.IR local@domain .
+.B qmail-local
+.I local@domain
+in a new
+.B Delivered-To
+header field.
+If exactly the same
+.B Delivered-To: \fIlocal@domain
+already appears in the header,
+.B qmail-local
+bounces the message,
+to prevent mail forwarding loops.
+The message's envelope sender is
+.IR sender .
+.B qmail-local
+.I sender
+in a new
+.B Return-Path
+header field.
+.I homedir
+is the user's home directory.
+It must be an absolute directory name.
+.I dash
+.I ext
+identify the
+.B .qmail\fIdashext
+file used by
+.BR qmail-local ;
+.BR dot-qmail(5) .
+.I dash
+is either empty or a lone hyphen.
+If it is empty,
+.B qmail-local
+treats a nonexistent
+.B .qmail\fIext
+the same way as an empty
+.BR .qmail\fIext :
+namely, following the delivery instructions in
+.IR defaultdelivery .
+The standard input for
+.B qmail-local
+must be a seekable file,
+so that
+.B qmail-local
+can read it more than once.
+.B \-n
+Instead of reading and delivering the message,
+print a description of the delivery instructions.
+.B \-N
+(Default.) Read and deliver the message.
+0 if the delivery is completely successful;
+nonzero if any delivery instruction failed.
+Exit code 111
+indicates temporary failure.