Mail::Transport::Sendmail(3pm)

1Mail::Transport::SendmaUisle(r3)Contributed Perl DocumenMtaaitli:o:nTransport::Sendmail(3)
2
3
4

NAME

6       Mail::Transport::Sendmail - transmit messages using external Sendmail
7       program
8

INHERITANCE

10        Mail::Transport::Sendmail
11          is a Mail::Transport::Send
12          is a Mail::Transport
13          is a Mail::Reporter
14

SYNOPSIS

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

DESCRIPTION

20       Implements mail transport using the external 'Sendmail' program.  When
21       instantiated, the mailer will look for the binary in specific system
22       directories, and the first version found is taken.
23
24       Some people use Postfix as MTA.  Postfix can be installed as replace‐
25       ment for Sendmail: is provides a program with the same name and
26       options.  So, this module supports postfix as well.
27

METHODS

29       Constructors
30
31       Mail::Transport::Sendmail->new(OPTIONS)
32
33        Option          --Defined in     --Default
34        executable        Mail::Transport  undef
35        hostname          Mail::Transport  'localhost'
36        interval          Mail::Transport  30
37        log               Mail::Reporter   'WARNINGS'
38        password          Mail::Transport  undef
39        port              Mail::Transport  undef
40        proxy             Mail::Transport  undef
41        retry             Mail::Transport  <false>
42        sendmail_options                   []
43        timeout           Mail::Transport  120
44        trace             Mail::Reporter   'WARNINGS'
45        username          Mail::Transport  undef
46        via               Mail::Transport  'sendmail'
47
48           . executable FILENAME
49
50           . hostname HOSTNAME⎪ARRAY-OF-HOSTNAMES
51
52           . interval SECONDS
53
54           . log LEVEL
55
56           . password STRING
57
58           . port INTEGER
59
60           . proxy PATH
61
62           . retry NUMBER⎪undef
63
64           . sendmail_options ARRAY
65
66               Add to the command-line of the started sendmail MTU a list of
67               separate words.  So say " [ '-f', $file ] " and not " [ "-f
68               $file" ] ", because the latter will be taken by sendmail as one
69               word only.
70
71           . timeout SECONDS
72
73           . trace LEVEL
74
75           . username STRING
76
77           . via CLASS⎪NAME
78
79       Sending mail
80
81       $obj->destinations(MESSAGE, [ADDRESS⎪ARRAY-OF-ADDRESSES])
82
83           See "Sending mail" in Mail::Transport::Send
84
85       $obj->putContent(MESSAGE, FILEHANDLE, OPTIONS)
86
87           See "Sending mail" in Mail::Transport::Send
88
89       $obj->send(MESSAGE, OPTIONS)
90
91           See "Sending mail" in Mail::Transport::Send
92
93       $obj->trySend(MESSAGE, OPTIONS)
94
95        Option          --Default
96        sendmail_options  undef
97
98           . sendmail_options ARRAY
99
100       Server connection
101
102       $obj->findBinary(NAME [, DIRECTORIES])
103
104           See "Server connection" in Mail::Transport
105
106       $obj->remoteHost
107
108           See "Server connection" in Mail::Transport
109
110       $obj->retry
111
112           See "Server connection" in Mail::Transport
113
114       Error handling
115
116       $obj->AUTOLOAD
117
118           See "Error handling" in Mail::Reporter
119
120       $obj->addReport(OBJECT)
121
122           See "Error handling" in Mail::Reporter
123
124       $obj->defaultTrace([LEVEL]⎪[LOGLEVEL, TRACELEVEL]⎪[LEVEL, CALLBACK])
125
126       Mail::Transport::Sendmail->defaultTrace([LEVEL]⎪[LOGLEVEL,
127       TRACELEVEL]⎪[LEVEL, CALLBACK])
128
129           See "Error handling" in Mail::Reporter
130
131       $obj->errors
132
133           See "Error handling" in Mail::Reporter
134
135       $obj->log([LEVEL [,STRINGS]])
136
137       Mail::Transport::Sendmail->log([LEVEL [,STRINGS]])
138
139           See "Error handling" in Mail::Reporter
140
141       $obj->logPriority(LEVEL)
142
143       Mail::Transport::Sendmail->logPriority(LEVEL)
144
145           See "Error handling" in Mail::Reporter
146
147       $obj->logSettings
148
149           See "Error handling" in Mail::Reporter
150
151       $obj->notImplemented
152
153           See "Error handling" in Mail::Reporter
154
155       $obj->report([LEVEL])
156
157           See "Error handling" in Mail::Reporter
158
159       $obj->reportAll([LEVEL])
160
161           See "Error handling" in Mail::Reporter
162
163       $obj->trace([LEVEL])
164
165           See "Error handling" in Mail::Reporter
166
167       $obj->warnings
168
169           See "Error handling" in Mail::Reporter
170
171       Cleanup
172
173       $obj->DESTROY
174
175           See "Cleanup" in Mail::Reporter
176
177       $obj->inGlobalDestruction
178
179           See "Cleanup" in Mail::Reporter
180

DIAGNOSTICS

182       Error: Errors when closing sendmail mailer $program: $!
183
184       The was no problem starting the sendmail mail transfer agent, but for
185       some specific reason the message could not be handled correctly.
186
187       Warning: Message has no destination
188
189       It was not possible to figure-out where the message is intended to go
190       to.
191
192       Error: Package $package does not implement $method.
193
194       Fatal error: the specific package (or one of its superclasses) does not
195       implement this method where it should. This message means that some
196       other related classes do implement this method however the class at
197       hand does not.  Probably you should investigate this and probably
198       inform the author of the package.
199
200       Warning: Resent group does not specify a destination
201
202       The message which is sent is the result of a bounce (for instance cre‐
203       ated with Mail::Message::bounce()), and therefore starts with a
204       "Received" header field.  With the "bounce", the new destination(s) of
205       the message are given, which should be included as "Resent-To",
206       "Resent-Cc", and "Resent-Bcc".
207
208       The "To", "Cc", and "Bcc" header information is only used if no
209       "Received" was found.  That seems to be the best explanation of the
210       RFC.
211
212       As alternative, you may also specify the "to" option to some of the
213       senders (for instance Mail::Transport::SMTP::send(to) to overrule any
214       information found in the message itself about the destination.
215

LICENSE

221       Copyrights 2001-2007 by Mark Overmeer.For other contributors see
222       ChangeLog.
223
224       This program is free software; you can redistribute it and/or modify it
225       under the same terms as Perl itself.  See
226       http://www.perl.com/perl/misc/Artistic.html
227
228
229
230perl v5.8.8                       2007-03-25      Mail::Transport::Sendmail(3)