METHODS

See METHODS in Mail::Reporter

Constructors

$class->new( %options )
Option Defined in Default

executable

Mail::Transport

undef

hostname

Mail::Transport

'localhost'

interval

Mail::Transport

30

log

Mail::Reporter

'WARNINGS'

password

Mail::Transport

undef

port

Mail::Transport

undef

proxy

Mail::Transport

undef

retry

Mail::Transport

<false>

timeout

Mail::Transport

120

trace

Mail::Reporter

'WARNINGS'

username

Mail::Transport

undef

via

Mail::Transport

'sendmail'

executable => FILENAME
hostname => HOSTNAME|ARRAY
interval => SECONDS
log => LEVEL
password => STRING
port => INTEGER
proxy => PATH
retry => NUMBER|undef
timeout => SECONDS
trace => LEVEL
username => STRING
via => CLASS|NAME

Sending mail

$obj->destinations( $message, [$address|ARRAY] )

Determine the destination for this message. If a valid $address is defined, this is used to overrule the addresses within the message. If the $address is undef it is ignored. It may also be an ARRAY of addresses.

If no $address is specified, the message is scanned for resent groups (see Mail::Message::Head::Complete::resentGroups()). The addresses found in the first (is latest added) group are used. If no resent groups are found, the normal To, Cc, and Bcc lines are taken.

» Warning: Message has no destination

It was not possible to figure-out where the message is intended to go to.

» Warning: Resent group does not specify a destination

The message which is sent is the result of a bounce (for instance created with Mail::Message::bounce()), and therefore starts with a Received header field. With the bounce, the new destination(s) of the message are given, which should be included as Resent-To, Resent-Cc, and Resent-Bcc.

The To, Cc, and Bcc header information is only used if no Received was found. That seems to be the best explanation of the RFC.

As alternative, you may also specify the to option to some of the senders (for instance Mail::Transport::SMTP::send(to) to overrule any information found in the message itself about the destination.

$obj->putContent( $message, $fh, %options )

Print the content of the $message to the $fh.

Option Default

body_only

<false>

undisclosed

<false>

body_only => BOOLEAN
Print only the body of the message, not the whole.
undisclosed => BOOLEAN
Do not print the Bcc and Resent-Bcc lines. Default false, which means that they are not printed.
$obj->send( $message, %options )

Transmit the $message, which may be anything what can be coerced into a Mail::Message, so including Mail::Internet and MIME::Entity messages. It returns true when the transmission was successfully completed.

Option Default

interval

new(interval)

retry

new(retry)

to

undef

interval => SECONDS
retry => INTEGER
to => STRING
Overrules the destination(s) of the message, which is by default taken from the (Resent-)To, (Resent-)Cc, and (Resent-)Bcc.
$obj->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.

» Error: Transporters of type $class cannot send.

The Mail::Transport object of the specified type can not send messages, but only receive message.

Server connection

$obj->findBinary( $name, [@directories] )
See findBinary in Mail::Transport.
$obj->remoteHost
See remoteHost in Mail::Transport.
$obj->retry
See retry in Mail::Transport.

Error handling

$obj->AUTOLOAD
See AUTOLOAD in Mail::Reporter.
$obj->addReport( $object )
See addReport in Mail::Reporter.
$obj->defaultTrace( [$level]|[$loglevel, $tracelevel]|[$level, $callback] )
$class->defaultTrace( [$level]|[$loglevel, $tracelevel]|[$level, $callback] )
See defaultTrace in Mail::Reporter.
$obj->errors
See errors in Mail::Reporter.
$obj->log( [$level, [$strings]] )
$class->log( [$level, [$strings]] )
See log in Mail::Reporter.
$obj->logPriority( $level )
$class->logPriority( $level )
See logPriority in Mail::Reporter.
$obj->logSettings
See logSettings in Mail::Reporter.
$obj->notImplemented
See notImplemented in Mail::Reporter.
$obj->report( [$level] )
See report in Mail::Reporter.
$obj->reportAll( [$level] )
See reportAll in Mail::Reporter.
$obj->trace( [$level] )
See trace in Mail::Reporter.
$obj->warnings
See warnings in Mail::Reporter.

Cleanup

$obj->DESTROY
See DESTROY in Mail::Reporter.