Mail::Transport::Exim(3pm)

1Mail::Transport::Exim(3U)ser Contributed Perl DocumentatiMoanil::Transport::Exim(3)
2
3
4

NAME

6       Mail::Transport::Exim - transmit messages using external Exim program
7

INHERITANCE

9        Mail::Transport::Exim
10          is a Mail::Transport::Send
11          is a Mail::Transport
12          is a Mail::Reporter
13

SYNOPSIS

15        my $sender = Mail::Transport::Exim->new(...);
16        $sender->send($message);
17

DESCRIPTION

19       Implements mail transport using the external 'Exim' program.  When
20       instantiated, the mailer will look for the binary in specific system
21       directories, and the first version found is taken.
22

METHODS

24   Constructors
25       Mail::Transport::Exim->new(OPTIONS)
26           If you have Exim installed in a non-standard location, you will
27           need to specify the path, using new(proxy).
28
29            -Option    --Defined in     --Default
30             executable  Mail::Transport  undef
31             hostname    Mail::Transport  'localhost'
32             interval    Mail::Transport  30
33             log         Mail::Reporter   'WARNINGS'
34             password    Mail::Transport  undef
35             port        Mail::Transport  undef
36             proxy       Mail::Transport  undef
37             retry       Mail::Transport  <false>
38             timeout     Mail::Transport  120
39             trace       Mail::Reporter   'WARNINGS'
40             username    Mail::Transport  undef
41             via         Mail::Transport  'exim'
42
43           executable => FILENAME
44           hostname => HOSTNAME|ARRAY-OF-HOSTNAMES
45           interval => SECONDS
46           log => LEVEL
47           password => STRING
48           port => INTEGER
49           proxy => PATH
50           retry => NUMBER|undef
51           timeout => SECONDS
52           trace => LEVEL
53           username => STRING
54           via => CLASS|NAME
55
56   Sending mail
57       $obj->destinations(MESSAGE, [ADDRESS|ARRAY-OF-ADDRESSES])
58           See "Sending mail" in Mail::Transport::Send
59
60       $obj->putContent(MESSAGE, FILEHANDLE, OPTIONS)
61           See "Sending mail" in Mail::Transport::Send
62
63       $obj->send(MESSAGE, OPTIONS)
64           See "Sending mail" in Mail::Transport::Send
65
66       $obj->trySend(MESSAGE, OPTIONS)
67
68   Server connection
69       $obj->findBinary(NAME [, DIRECTORIES])
70           See "Server connection" in Mail::Transport
71
72       $obj->remoteHost
73           See "Server connection" in Mail::Transport
74
75       $obj->retry
76           See "Server connection" in Mail::Transport
77
78   Error handling
79       $obj->AUTOLOAD
80           See "Error handling" in Mail::Reporter
81
82       $obj->addReport(OBJECT)
83           See "Error handling" in Mail::Reporter
84
85       $obj->defaultTrace([LEVEL]|[LOGLEVEL, TRACELEVEL]|[LEVEL, CALLBACK])
86           Mail::Transport::Exim->defaultTrace([LEVEL]|[LOGLEVEL,
87           TRACELEVEL]|[LEVEL, CALLBACK])
88
89           See "Error handling" in Mail::Reporter
90
91       $obj->errors
92           See "Error handling" in Mail::Reporter
93
94       $obj->log([LEVEL [,STRINGS]])
95           Mail::Transport::Exim->log([LEVEL [,STRINGS]])
96
97           See "Error handling" in Mail::Reporter
98
99       $obj->logPriority(LEVEL)
100           Mail::Transport::Exim->logPriority(LEVEL)
101
102           See "Error handling" in Mail::Reporter
103
104       $obj->logSettings
105           See "Error handling" in Mail::Reporter
106
107       $obj->notImplemented
108           See "Error handling" in Mail::Reporter
109
110       $obj->report([LEVEL])
111           See "Error handling" in Mail::Reporter
112
113       $obj->reportAll([LEVEL])
114           See "Error handling" in Mail::Reporter
115
116       $obj->trace([LEVEL])
117           See "Error handling" in Mail::Reporter
118
119       $obj->warnings
120           See "Error handling" in Mail::Reporter
121
122   Cleanup
123       $obj->DESTROY
124           See "Cleanup" in Mail::Reporter
125
126       $obj->inGlobalDestruction
127           See "Cleanup" in Mail::Reporter
128

DIAGNOSTICS

130       Error: Errors when closing Exim mailer $program: $!
131           The Exim mail transfer agent did start, but was not able to handle
132           the message correctly.
133
134       Warning: Message has no destination
135           It was not possible to figure-out where the message is intended to
136           go to.
137
138       Error: Package $package does not implement $method.
139           Fatal error: the specific package (or one of its superclasses) does
140           not implement this method where it should. This message means that
141           some other related classes do implement this method however the
142           class at hand does not.  Probably you should investigate this and
143           probably inform the author of the package.
144
145       Warning: Resent group does not specify a destination
146           The message which is sent is the result of a bounce (for instance
147           created with Mail::Message::bounce()), and therefore starts with a
148           "Received" header field.  With the "bounce", the new destination(s)
149           of the message are given, which should be included as "Resent-To",
150           "Resent-Cc", and "Resent-Bcc".
151
152           The "To", "Cc", and "Bcc" header information is only used if no
153           "Received" was found.  That seems to be the best explanation of the
154           RFC.
155
156           As alternative, you may also specify the "to" option to some of the
157           senders (for instance Mail::Transport::SMTP::send(to) to overrule
158           any information found in the message itself about the destination.
159

LICENSE

165       Copyrights 2001-2011 by Mark Overmeer. For other contributors see
166       ChangeLog.
167
168       This program is free software; you can redistribute it and/or modify it
169       under the same terms as Perl itself.  See
170       http://www.perl.com/perl/misc/Artistic.html
171
172
173
174perl v5.12.3                      2011-01-26          Mail::Transport::Exim(3)