NAME
Mail::Transport - base class for message transmission
CLASS HIERARCHY
Mail::Transport
is a Mail::Reporter
SYNOPSIS
my $message = Mail::Message->new(...);
$message->send;
$message->send(via => 'sendmail');
my $sender = Mail::Transport::SMTP->new(...);
$sender->send($message);
DESCRIPTION
Organize sending of Mail::Message
objects to the destinations as specified in the header. The Mail::Transport
module is capable to autodetect which of the following modules work on your system:
Mail::Transport::SMTP
In this case, Perl is handling mail transport on its own. Under construction.
Mail::Transport::Sendmail
Use sendmail to process and deliver the mail. This requires the
sendmail
program to be installed on your system.Mail::Transport::Mailx
Use the external
mail
,mailx
, orMail
programs to send the message. Usually, the result is poor, because some versions of these programs do not support MIME headers.
METHOD INDEX
The general methods for Mail::Transport
objects:
MR errors MR reportAll [LEVEL]
MR log [LEVEL [,STRINGS]] send MESSAGE, OPTIONS
new OPTIONS MR trace [LEVEL]
MR report [LEVEL] trySend MESSAGE, OPTIONS
The extra methods for extension writers:
MR AUTOLOAD MR inGlobalDestruction
MR DESTROY MR logPriority LEVEL
findBinary NAME MR logSettings
Prefixed methods are described in MR = Mail::Reporter.
METHODS
- new OPTIONS
-
OPTION DESCRIBED IN DEFAULT log Mail::Reporter 'WARNINGS' trace Mail::Reporter 'WARNINGS' via Mail::Transport 'smtp'
via => CLASS|NAME
Which CLASS (extending
Mail::Transport
) will transport the data. Some predefined NAMEs avoid long class names:mail
andmailx
are handled by theMail::Transport::Mailx
module,sendmail
belongs to::Sendmail
, andsmtp
is implemented in::SMTP
.
- send MESSAGE, OPTIONS
-
Transmit the MESSAGE. It returns true when the transmission was succesfully completed. Some extensions to
Mail::Transport
may offer OPTIONS, but at least the following are supported:OPTIONS DESCRIBED IN DEFAULT interval Mail::Transport 30 retry Mail::Transport undef
interval => SECONDS
Retry to send the message every so many SECONDS, until transmission is successful or the number of retries is reached. The number must be larger than 0.
retry => NUMBER|undef
The number of retries before the sending will fail. If
undef
, the number of retries is unlimited.
- trySend MESSAGE, OPTIONS
-
Try to send the message. This will return true if successful, and false in case some problems where detected. The
$?
contains the exit status of the command which was started.
METHODS for extension writers
- findBinary NAME
-
Look for a binary with the specified NAME in the directories which are defined to be safe. The name is first stripped of any path information to be sure that no tricks are being played. The full pathname is returned.
SEE ALSO
AUTHOR
Mark Overmeer (mailbox@overmeer.net). All rights reserved. This program is free software; you can redistribute it and/or modify it under the same terms as Perl itself.
VERSION
This code is beta, version 2.00_16.
Copyright (c) 2001 Mark Overmeer. All rights reserved. This program is free software; you can redistribute it and/or modify it under the same terms as Perl itself.