METHODS

See METHODS in Mail::Reporter

Constructors

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

esmtp_options

{}

executable

Mail::Transport

undef

from

undef

helo

<from Net::Config>

hostname

Mail::Transport

<from Net::Config>

interval

Mail::Transport

30

log

Mail::Reporter

'WARNINGS'

password

undef

port

Mail::Transport

25

proxy

Mail::Transport

<from Net::Config>

retry

Mail::Transport

<false>

smtp_debug

<false>

timeout

120

trace

Mail::Reporter

'WARNINGS'

username

undef

via

Mail::Transport

'smtp'

esmtp_options => HASH
[2.116] ESMTP options to pass to Net::SMTP. See the manual Net::SMTP documentation for full details. Options can also be passed at send time. For example: < { XVERP = 1 } >>
executable => FILENAME
from => ADDRESS
Allows a default sender address to be specified globally. See trySend() for full details.
helo => HOST
The fully qualified name of the sender's host (your system) which is used for the greeting message to the receiver. If not specified, Net::Config or else Net::Domain are questioned to find it. When even these do not supply a valid name, the name of the domain in the From line of the message is assumed.
hostname => HOSTNAME|ARRAY
interval => SECONDS
log => LEVEL
password => STRING
The password to be used with the new(username) to log in to the remote server.
port => INTEGER
proxy => PATH
retry => NUMBER|undef
smtp_debug => BOOLEAN
Simulate transmission: the SMTP protocol output will be sent to your screen.
timeout => SECONDS
The number of seconds to wait for a valid response from the server before failing.
trace => LEVEL
username => STRING
Use SASL authentication to contact the remote SMTP server (RFC2554). This username in combination with new(password) is passed as arguments to Net::SMTP method auth. Other forms of authentication are not supported by Net::SMTP. The username can also be specified as an Authen::SASL object.
via => CLASS|NAME

Sending mail

$obj->destinations( $message, [$address|ARRAY] )
See destinations in Mail::Transport::Send.
$obj->putContent( $message, $fh, %options )
See putContent in Mail::Transport::Send.
$obj->send( $message, %options )
See send in Mail::Transport::Send.
$obj->trySend( $message, %options )

Try to send the $message once. This may fail, in which case this method will return false. In list context, the reason for failure can be caught: in list context trySend will return a list of six values:

 (success, rc, rc-text, error location, quit success, accept)

Success and quit success are booleans. The error code and -text are protocol specific codes and texts. The location tells where the problem occurred.

[3.003] the 'accept' returns the message of the manual dataend() instruction. Some servers may provide useful information in there, like an internal message registration id. For example, postfix may return "2.0.0 Ok: queued as 303EA380EE". You can only use this parameter when running local delivery (which is a smart choice anyway)

Option Default

esmtp_options

{}

from

< >

to

[]

esmtp_options => HASH
Additional or overridden EMSTP options. See new(esmtp_options)
from => ADDRESS
Your own identification. This may be fake. If not specified, it is taken from Mail::Message::sender(), which means the content of the Sender field of the message or the first address of the From field. This defaults to "< >", which represents "no address".
to => ADDRESS|[ADDRESSES]
Alternative destinations. If not specified, the To, Cc and Bcc fields of the header are used. An address is a string or a Mail::Address object.
» Notice: No addresses found to send the message to, no connection made

Server connection

$obj->contactAnyServer

Creates the connection to the SMTP server. When more than one hostname was specified, the first which accepts a connection is taken. An IO::Socket::INET object is returned.

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

Try to establish a connection to deliver SMTP to the specified $host. The %options are passed to the new method of Net::SMTP.

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.