METHODS

See METHODS in Mail::Reporter

Constructors

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

executable

undef

hostname

'localhost'

interval

30

log

Mail::Reporter

'WARNINGS'

password

undef

port

undef

proxy

undef

retry

<false>

timeout

120

trace

Mail::Reporter

'WARNINGS'

username

undef

via

'sendmail'

executable => FILENAME
If you specify an executable, the module does not need to search the system directories to figure-out where the client lives. Using this decreases the flexible usage of your program: moving your program to other systems may involve changing the path to the executable, which otherwise would work auto-detect and unmodified.
hostname => HOSTNAME|ARRAY
The host on which the server runs. Some protocols accept an ARRAY of alternatives for this option.
interval => SECONDS
The time between tries to contact the remote server for sending or receiving a message in SECONDS. This number must be larger than 0.
log => LEVEL
password => STRING
Some protocols require a password to be given, usually in combination with a password.
port => INTEGER
The port number behind which the service is hiding on the remote server.
proxy => PATH
The name of the proxy software (the protocol handler). This must be the name (preferable the absolute path) of your mail delivery software.
retry => NUMBER|undef
The number of retries before the sending will fail. If undef, the number of retries is unlimited.
timeout => SECONDS
SECONDS till time-out while establishing the connection to a remote server.
trace => LEVEL
username => STRING
Some protocols require a user to login.
via => CLASS|NAME
Which CLASS (extending Mail::Transport) will transport the data. Some predefined NAMEs avoid long class names: mail and mailx are handled by the Mail::Transport::Mailx module, sendmail and postfix belong to Mail::Transport::Sendmail, and smtp is implemented in Mail::Transport::SMTP. The pop or pop3 protocol implementation can be found in Mail::Transport::POP3.
» Warning: Avoid program abuse: specify an absolute path for $exec.

Specifying explicit locations for executables of email transfer agents should only be done with absolute file names, to avoid various pontential security problems.

» Warning: Executable $exec does not exist.

The explicitly indicated mail transfer agent does not exists. The normal settings are used to find the correct location.

Server connection

$obj->findBinary( $name, [@directories] )

Look for a binary with the specified $name in the directories which are defined to be safe. The list of standard directories is followed by the optional @directories. The full pathname is returned.

You may specify new(proxy), which specifies the absolute name of the binary to be used.

$obj->remoteHost

Returns the hostname, port number, username and password to be used to establish the connection to the server for sending or receiving mail.

$obj->retry

Returns the retry interval, retry count, and timeout for the connection.

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.