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
28       Extends "DESCRIPTION" in Mail::Transport::Send.
29

METHODS

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

DIAGNOSTICS

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

LICENSE

188       Copyrights 2001-2018 by [Mark Overmeer]. For other contributors see
189       ChangeLog.
190
191       This program is free software; you can redistribute it and/or modify it
192       under the same terms as Perl itself.  See http://dev.perl.org/licenses/
193
194
195
196perl v5.28.0                      2018-09-03      Mail::Transport::Sendmail(3)