METHODS

See METHODS in Mail::Reporter

Constructors

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

executable

Mail::Transport

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'

executable => FILENAME
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 five values:

 (success, error code, error text, error location, quit success)

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

Option Default

from

< >

to

[]

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.