diff -r 000000000000 -r 6f7a81934006 commands/vdeliver.pod
--- /dev/null	Thu Jan 01 00:00:00 1970 +0000
+++ b/commands/vdeliver.pod	Wed Jan 16 22:39:43 2008 +0100
@@ -0,0 +1,90 @@
+=head1 NAME
+
+vdeliver - VMailMgr delivery agent
+
+=head1 SYNOPSIS
+
+B<vdeliver>
+[B<-D>]
+[B<-F>]
+[B<-R>]
+[B<-d>]
+[B<-f>]
+[B<--quiet>]
+[B<-r>]
+
+
+=head1 DESCRIPTION
+
+vdeliver is the unified e-mail message delivery agent for virtual
+domains managed by vmailmgr.
+It is run from the F<.qmail-default> file, and automatically handles
+delivery to any user within a virtual domain.
+
+
+=head1 OPTIONS
+
+=over 8
+
+=item B<-D>
+
+Add the C<Return-Path:> line to the top of the message. (default)
+
+=item B<-F>
+
+Add a "C<From >" mailbox line.
+
+=item B<-R>
+
+Add a "C<Return-Path:>" line (default).
+
+=item B<-d>
+
+Do not add the C<Delivered-To:> line to the top of the message.
+
+=item B<-f>
+
+Do not add the C<From> mailbox line to the top of the message. Note that this line is never added when the message is being re-injected into the mail stream. (default)
+
+=item B<--quiet>
+
+Suppress all status messages.
+
+=item B<-r>
+
+Do not add the C<Return-Path:> line to the top of the message.
+
+=back
+
+=head1 RETURN VALUE
+
+
+Returns 0 if delivery was successful,
+100 if a fatal error occurred,
+or 111 if a temporary error occurred.
+
+
+
+=head1 ENVIRONMENT
+
+
+F<vdeliver> expects to be run by F<qmail-local> as it requires several
+of the environment variables that it sets.
+See the I<qmail-command>(8) manual page for full details on these
+variables.
+In particular, it requires C<DTLINE>, C<EXT>, C<HOST>, C<RPLINE>,
+C<SENDER>, C<UFLINE>, and C<USER>.
+
+
+
+=head1 SEE ALSO
+
+
+checkvpw(1), I<qmail-command>(8)
+
+
+
+=head1 AUTHORS
+
+Bruce Guenter <bruceg@em.ca>
+