=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>