89 lines
2.1 KiB

# -*- mode: perl;-*-
=head1 NAME
kuvert_submit - MTA wrapper for mail submission to kuvert(1)
kuvert_submit [sendmail-options] [recipients...]
Kuvert_submit submits an email either directly to L<sendmail(8)> or
enqueues it for L<kuvert(1)> for further processing. kuvert_submit
should be called by your MUA instead of your usual MTA to enable
kuvert to intercept and process the outgoing mails. Please see your MUA's
documentation about how to override the MTA to be used.
Kuvert_submit transparently invokes C</usr/sbin/sendmail> directly
if it cannot find a ~/.kuvert configuration file, or if the -bv option
is given. Otherwise, it enqueues
the email in the queue directory specified in the configuration file.
If that fails or if the configuration file is invalid, kuvert_submit prints an
error message to STDERR and terminates with exit code 1.
On successful submission, kuvert_submit terminates with exit code 0.
Kuvert_submit also logs messages to syslog with the facility "mail".
=head1 OPTIONS
If it runs the MTA directly then kuvert_submit passes all options through
to /usr/sbin/sendmail. Otherwise, it ignores all options except
-f and -t (and -bv which triggers a direct sendmail pass-through).
=item -f <emailaddress>
Sets the envelope sender. Kuvert_submit passes this on to kuvert.
=item -t
Tells an MTA to use the recipients in the mail instead of any commandline
arguments. If -t is not given then kuvert_submit passes the recipients
from the commandline on to kuvert.
=head1 FILES
=item ~/.kuvert
The configuration file read by kuvert and kuvert_submit. If not present,
kuvert_submit calls /usr/sbin/sendmail directly.
=item ~/.kuvert_queue
The default queue directory.
=head1 SEE ALSO
=head1 AUTHOR
Alexander Zangerl <az@snafu.priv.at>
copyright 1999-2008 Alexander Zangerl <az@snafu.priv.at>
This program is free software; you can redistribute it and/or modify
it under the terms of the GNU General Public License version 2
as published by the Free Software Foundation.