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

DIAGNOSTICS

143       Error: Errors when closing sendmail mailer $program: $!
144           The was no problem starting the sendmail mail transfer agent, but
145           for some specific reason the message could not be handled
146           correctly.
147
148       Warning: Message has no destination
149           It was not possible to figure-out where the message is intended to
150           go to.
151
152       Error: Package $package does not implement $method.
153           Fatal error: the specific package (or one of its superclasses) does
154           not implement this method where it should. This message means that
155           some other related classes do implement this method however the
156           class at hand does not.  Probably you should investigate this and
157           probably inform the author of the package.
158
159       Warning: Resent group does not specify a destination
160           The message which is sent is the result of a bounce (for instance
161           created with Mail::Message::bounce()), and therefore starts with a
162           "Received" header field.  With the "bounce", the new destination(s)
163           of the message are given, which should be included as "Resent-To",
164           "Resent-Cc", and "Resent-Bcc".
165
166           The "To", "Cc", and "Bcc" header information is only used if no
167           "Received" was found.  That seems to be the best explanation of the
168           RFC.
169
170           As alternative, you may also specify the "to" option to some of the
171           senders (for instance Mail::Transport::SMTP::send(to) to overrule
172           any information found in the message itself about the destination.
173

LICENSE

179       Copyrights 2001-2011 by Mark Overmeer. For other contributors see
180       ChangeLog.
181
182       This program is free software; you can redistribute it and/or modify it
183       under the same terms as Perl itself.  See
184       http://www.perl.com/perl/misc/Artistic.html
185
186
187
188perl v5.12.3                      2011-01-26      Mail::Transport::Sendmail(3)