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       WARNING: When you do bulk email sending with local delivery via
29       Postfix, you can probably better use the SMTP backend to connect to
30       postfix.  The "sendmail" command delivers to "maildrop".  From
31       "maildrop", the "pickupd" will only sequentially insert messages into
32       "cleanup".  That process can take considerable elapse time.  Directly
33       inserting via "smtpd" will parallellize the cleanup process.
34
35       Extends "DESCRIPTION" in Mail::Transport::Send.
36

METHODS

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

DIAGNOSTICS

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

LICENSE

195       Copyrights 2001-2020 by [Mark Overmeer]. For other contributors see
196       ChangeLog.
197
198       This program is free software; you can redistribute it and/or modify it
199       under the same terms as Perl itself.  See http://dev.perl.org/licenses/
200
201
202
203perl v5.36.0                      2023-01-20      Mail::Transport::Sendmail(3)