]>
Commit | Line | Data |
---|---|---|
3328aced | 1 | #!/usr/bin/perl |
83b24437 | 2 | # |
f3d9f354 RA |
3 | # Copyright 2002,2005 Greg Kroah-Hartman <greg@kroah.com> |
4 | # Copyright 2005 Ryan Anderson <ryan@michonline.com> | |
83b24437 RA |
5 | # |
6 | # GPL v2 (See COPYING) | |
5825e5b2 | 7 | # |
83b24437 RA |
8 | # Ported to support git "mbox" format files by Ryan Anderson <ryan@michonline.com> |
9 | # | |
f3d9f354 | 10 | # Sends a collection of emails to the given email addresses, disturbingly fast. |
5825e5b2 | 11 | # |
f3d9f354 RA |
12 | # Supports two formats: |
13 | # 1. mbox format files (ignoring most headers and MIME formatting - this is designed for sending patches) | |
14 | # 2. The original format support by Greg's script: | |
5825e5b2 | 15 | # first line of the message is who to CC, |
f3d9f354 | 16 | # and second line is the subject of the message. |
5825e5b2 | 17 | # |
83b24437 | 18 | |
d48b2841 | 19 | use 5.008; |
83b24437 RA |
20 | use strict; |
21 | use warnings; | |
f916ab0c | 22 | use POSIX qw/strftime/; |
83b24437 | 23 | use Term::ReadLine; |
83b24437 | 24 | use Getopt::Long; |
0e73b3ee | 25 | use Text::ParseWords; |
412876dc | 26 | use Term::ANSIColor; |
eed6ca7c | 27 | use File::Temp qw/ tempdir tempfile /; |
89bf1bac | 28 | use File::Spec::Functions qw(catfile); |
5df9fcf6 | 29 | use Error qw(:try); |
3cb8caf7 | 30 | use Git; |
a4dde4c4 | 31 | use Git::I18N; |
83b24437 | 32 | |
5df9fcf6 PH |
33 | Getopt::Long::Configure qw/ pass_through /; |
34 | ||
280242d1 JH |
35 | package FakeTerm; |
36 | sub new { | |
37 | my ($class, $reason) = @_; | |
38 | return bless \$reason, shift; | |
39 | } | |
40 | sub readline { | |
41 | my $self = shift; | |
42 | die "Cannot use readline on FakeTerm: $$self"; | |
43 | } | |
44 | package main; | |
45 | ||
1b0baf14 MC |
46 | |
47 | sub usage { | |
48 | print <<EOT; | |
5df9fcf6 | 49 | git send-email [options] <file | directory | rev-list options > |
17b7a832 | 50 | git send-email --dump-aliases |
4ed62b03 MW |
51 | |
52 | Composing: | |
53 | --from <str> * Email From: | |
f434c083 SB |
54 | --[no-]to <str> * Email To: |
55 | --[no-]cc <str> * Email Cc: | |
56 | --[no-]bcc <str> * Email Bcc: | |
4ed62b03 MW |
57 | --subject <str> * Email "Subject:" |
58 | --in-reply-to <str> * Email "In-Reply-To:" | |
ac1596a6 | 59 | --[no-]xmailer * Add "X-Mailer:" header (default). |
402596aa | 60 | --[no-]annotate * Review each patch that will be sent in an editor. |
4ed62b03 | 61 | --compose * Open an editor for introduction. |
62e00690 | 62 | --compose-encoding <str> * Encoding to assume for introduction. |
3cae7e5b | 63 | --8bit-encoding <str> * Encoding to assume 8bit mails if undeclared |
8d814084 | 64 | --transfer-encoding <str> * Transfer encoding to use (quoted-printable, 8bit, base64) |
4ed62b03 MW |
65 | |
66 | Sending: | |
67 | --envelope-sender <str> * Email envelope sender. | |
68 | --smtp-server <str:int> * Outgoing SMTP server to use. The port | |
69 | is optional. Default 'localhost'. | |
052fbea2 | 70 | --smtp-server-option <str> * Outgoing SMTP server option to use. |
4ed62b03 MW |
71 | --smtp-server-port <int> * Outgoing SMTP server port. |
72 | --smtp-user <str> * Username for SMTP-AUTH. | |
73 | --smtp-pass <str> * Password for SMTP-AUTH; not necessary. | |
74 | --smtp-encryption <str> * tls or ssl; anything else disables. | |
75 | --smtp-ssl * Deprecated. Use '--smtp-encryption ssl'. | |
35035bbf RR |
76 | --smtp-ssl-cert-path <str> * Path to ca-certificates (either directory or file). |
77 | Pass an empty string to disable certificate | |
78 | verification. | |
134550fe | 79 | --smtp-domain <str> * The domain name sent to HELO/EHLO handshake |
0f2e68b5 JV |
80 | --smtp-auth <str> * Space-separated list of allowed AUTH mechanisms. |
81 | This setting forces to use one of the listed mechanisms. | |
f60812ef | 82 | --smtp-debug <0|1> * Disable, enable Net::SMTP debug. |
4ed62b03 | 83 | |
5453b83b | 84 | --batch-size <int> * send max <int> message per connection. |
85 | --relogin-delay <int> * delay <int> seconds between two successive login. | |
86 | This option can only be used with --batch-size | |
87 | ||
4ed62b03 MW |
88 | Automating: |
89 | --identity <str> * Use the sendemail.<id> options. | |
6e74e075 | 90 | --to-cmd <str> * Email To: via `<str> \$patch_path` |
4ed62b03 | 91 | --cc-cmd <str> * Email Cc: via `<str> \$patch_path` |
3531e270 | 92 | --suppress-cc <str> * author, self, sob, cc, cccmd, body, bodycc, all. |
f515c904 MT |
93 | --[no-]cc-cover * Email Cc: addresses in the cover letter. |
94 | --[no-]to-cover * Email To: addresses in the cover letter. | |
3531e270 | 95 | --[no-]signed-off-by-cc * Send to Signed-off-by: addresses. Default on. |
4ed62b03 | 96 | --[no-]suppress-from * Send to self. Default off. |
41fe87fa | 97 | --[no-]chain-reply-to * Chain In-Reply-To: fields. Default off. |
4ed62b03 MW |
98 | --[no-]thread * Use In-Reply-To: field. Default on. |
99 | ||
100 | Administering: | |
c1f2aa45 JS |
101 | --confirm <str> * Confirm recipients before sending; |
102 | auto, cc, compose, always, or never. | |
4ed62b03 MW |
103 | --quiet * Output one line of info per email. |
104 | --dry-run * Don't actually send the emails. | |
105 | --[no-]validate * Perform patch sanity checks. Default on. | |
5df9fcf6 PH |
106 | --[no-]format-patch * understand any non optional arguments as |
107 | `git format-patch` ones. | |
a03bc5b6 | 108 | --force * Send even if safety checks would prevent it. |
c764a0c2 | 109 | |
17b7a832 JK |
110 | Information: |
111 | --dump-aliases * Dump configured aliases and exit. | |
112 | ||
1b0baf14 MC |
113 | EOT |
114 | exit(1); | |
115 | } | |
116 | ||
4bc87a28 | 117 | # most mail servers generate the Date: header, but not all... |
6bdca890 JN |
118 | sub format_2822_time { |
119 | my ($time) = @_; | |
120 | my @localtm = localtime($time); | |
121 | my @gmttm = gmtime($time); | |
122 | my $localmin = $localtm[1] + $localtm[2] * 60; | |
123 | my $gmtmin = $gmttm[1] + $gmttm[2] * 60; | |
124 | if ($localtm[0] != $gmttm[0]) { | |
46493105 | 125 | die __("local zone differs from GMT by a non-minute interval\n"); |
6bdca890 JN |
126 | } |
127 | if ((($gmttm[6] + 1) % 7) == $localtm[6]) { | |
128 | $localmin += 1440; | |
129 | } elsif ((($gmttm[6] - 1) % 7) == $localtm[6]) { | |
130 | $localmin -= 1440; | |
131 | } elsif ($gmttm[6] != $localtm[6]) { | |
46493105 | 132 | die __("local time offset greater than or equal to 24 hours\n"); |
6bdca890 JN |
133 | } |
134 | my $offset = $localmin - $gmtmin; | |
135 | my $offhour = $offset / 60; | |
136 | my $offmin = abs($offset % 60); | |
137 | if (abs($offhour) >= 24) { | |
46493105 | 138 | die __("local time offset greater than or equal to 24 hours\n"); |
6bdca890 JN |
139 | } |
140 | ||
141 | return sprintf("%s, %2d %s %d %02d:%02d:%02d %s%02d%02d", | |
142 | qw(Sun Mon Tue Wed Thu Fri Sat)[$localtm[6]], | |
143 | $localtm[3], | |
144 | qw(Jan Feb Mar Apr May Jun | |
145 | Jul Aug Sep Oct Nov Dec)[$localtm[4]], | |
146 | $localtm[5]+1900, | |
147 | $localtm[2], | |
148 | $localtm[1], | |
149 | $localtm[0], | |
150 | ($offset >= 0) ? '+' : '-', | |
151 | abs($offhour), | |
152 | $offmin, | |
153 | ); | |
154 | } | |
4bc87a28 | 155 | |
567ffeb7 | 156 | my $have_email_valid = eval { require Email::Valid; 1 }; |
5012699d | 157 | my $have_mail_address = eval { require Mail::Address; 1 }; |
4bc87a28 | 158 | my $smtp; |
5f5b6118 | 159 | my $auth; |
5453b83b | 160 | my $num_sent = 0; |
4bc87a28 | 161 | |
11f70a7e РД |
162 | # Regexes for RFC 2047 productions. |
163 | my $re_token = qr/[^][()<>@,;:\\"\/?.= \000-\037\177-\377]+/; | |
164 | my $re_encoded_text = qr/[^? \000-\037\177-\377]+/; | |
165 | my $re_encoded_word = qr/=\?($re_token)\?($re_token)\?($re_encoded_text)\?=/; | |
166 | ||
83b24437 | 167 | # Variables we fill in automatically, or via prompting: |
3c3bb51c | 168 | my (@to,$no_to,@initial_to,@cc,$no_cc,@initial_cc,@bcclist,$no_bcc,@xh, |
8fd5bb7f | 169 | $initial_reply_to,$initial_subject,@files, |
ac1596a6 | 170 | $author,$sender,$smtp_authpass,$annotate,$use_xmailer,$compose,$time); |
83b24437 | 171 | |
f073a592 | 172 | my $envelope_sender; |
78488b2c | 173 | |
9133261f | 174 | # Example reply to: |
83b24437 | 175 | #$initial_reply_to = ''; #<20050203173208.GA23964@foobar.com>'; |
83b24437 | 176 | |
ad79c024 FL |
177 | my $repo = eval { Git->repository() }; |
178 | my @repo = $repo ? ($repo) : (); | |
280242d1 | 179 | my $term = eval { |
0fb7fc75 JS |
180 | $ENV{"GIT_SEND_EMAIL_NOTTY"} |
181 | ? new Term::ReadLine 'git-send-email', \*STDIN, \*STDOUT | |
182 | : new Term::ReadLine 'git-send-email'; | |
280242d1 JH |
183 | }; |
184 | if ($@) { | |
185 | $term = new FakeTerm "$@: going non-interactive"; | |
186 | } | |
83b24437 | 187 | |
5483c71d AR |
188 | # Behavior modification variables |
189 | my ($quiet, $dry_run) = (0, 0); | |
5df9fcf6 | 190 | my $format_patch; |
afe756c9 | 191 | my $compose_filename; |
a03bc5b6 | 192 | my $force = 0; |
17b7a832 | 193 | my $dump_aliases = 0; |
5483c71d | 194 | |
8fd5bb7f PH |
195 | # Handle interactive edition of files. |
196 | my $multiedit; | |
0ce142c9 | 197 | my $editor; |
b4479f07 | 198 | |
8fd5bb7f | 199 | sub do_edit { |
0ce142c9 MG |
200 | if (!defined($editor)) { |
201 | $editor = Git::command_oneline('var', 'GIT_EDITOR'); | |
202 | } | |
8fd5bb7f | 203 | if (defined($multiedit) && !$multiedit) { |
beece9da PH |
204 | map { |
205 | system('sh', '-c', $editor.' "$@"', $editor, $_); | |
206 | if (($? & 127) || ($? >> 8)) { | |
46493105 | 207 | die(__("the editor exited uncleanly, aborting everything")); |
beece9da PH |
208 | } |
209 | } @_; | |
8fd5bb7f PH |
210 | } else { |
211 | system('sh', '-c', $editor.' "$@"', $editor, @_); | |
beece9da | 212 | if (($? & 127) || ($? >> 8)) { |
46493105 | 213 | die(__("the editor exited uncleanly, aborting everything")); |
beece9da | 214 | } |
8fd5bb7f PH |
215 | } |
216 | } | |
5483c71d AR |
217 | |
218 | # Variables with corresponding config settings | |
6e74e075 | 219 | my ($thread, $chain_reply_to, $suppress_from, $signed_off_by_cc); |
f515c904 | 220 | my ($cover_cc, $cover_to); |
6e74e075 | 221 | my ($to_cmd, $cc_cmd); |
052fbea2 | 222 | my ($smtp_server, $smtp_server_port, @smtp_server_options); |
35035bbf | 223 | my ($smtp_authuser, $smtp_encryption, $smtp_ssl_cert_path); |
5453b83b | 224 | my ($batch_size, $relogin_delay); |
0f2e68b5 | 225 | my ($identity, $aliasfiletype, @alias_files, $smtp_domain, $smtp_auth); |
c1f2aa45 | 226 | my ($validate, $confirm); |
65648283 | 227 | my (@suppress_cc); |
3cae7e5b | 228 | my ($auto_8bit_encoding); |
62e00690 | 229 | my ($compose_encoding); |
8d814084 | 230 | my ($target_xfer_encoding); |
5483c71d | 231 | |
f60812ef JA |
232 | my ($debug_net_smtp) = 0; # Net::SMTP, see send_message() |
233 | ||
34cc60ce | 234 | my %config_bool_settings = ( |
5483c71d | 235 | "thread" => [\$thread, 1], |
b99d22f2 | 236 | "chainreplyto" => [\$chain_reply_to, 0], |
65648283 | 237 | "suppressfrom" => [\$suppress_from, undef], |
ddc3d4fe | 238 | "signedoffbycc" => [\$signed_off_by_cc, undef], |
f515c904 MT |
239 | "cccover" => [\$cover_cc, undef], |
240 | "tocover" => [\$cover_to, undef], | |
ddc3d4fe | 241 | "signedoffcc" => [\$signed_off_by_cc, undef], # Deprecated |
dbf5e1e9 | 242 | "validate" => [\$validate, 1], |
402596aa | 243 | "multiedit" => [\$multiedit, undef], |
ac1596a6 LH |
244 | "annotate" => [\$annotate, undef], |
245 | "xmailer" => [\$use_xmailer, 1] | |
e46f7a0e AR |
246 | ); |
247 | ||
34cc60ce DS |
248 | my %config_settings = ( |
249 | "smtpserver" => \$smtp_server, | |
44b2476a | 250 | "smtpserverport" => \$smtp_server_port, |
052fbea2 | 251 | "smtpserveroption" => \@smtp_server_options, |
34cc60ce DS |
252 | "smtpuser" => \$smtp_authuser, |
253 | "smtppass" => \$smtp_authpass, | |
e1e9115d | 254 | "smtpdomain" => \$smtp_domain, |
0f2e68b5 | 255 | "smtpauth" => \$smtp_auth, |
5453b83b | 256 | "smtpbatchsize" => \$batch_size, |
257 | "smtprelogindelay" => \$relogin_delay, | |
3c3bb51c | 258 | "to" => \@initial_to, |
6e74e075 | 259 | "tocmd" => \$to_cmd, |
5f8b9fcd | 260 | "cc" => \@initial_cc, |
34cc60ce DS |
261 | "cccmd" => \$cc_cmd, |
262 | "aliasfiletype" => \$aliasfiletype, | |
263 | "bcc" => \@bcclist, | |
65648283 | 264 | "suppresscc" => \@suppress_cc, |
9f7820ae | 265 | "envelopesender" => \$envelope_sender, |
c1f2aa45 | 266 | "confirm" => \$confirm, |
09caa24f | 267 | "from" => \$sender, |
3cae7e5b | 268 | "assume8bitencoding" => \$auto_8bit_encoding, |
62e00690 | 269 | "composeencoding" => \$compose_encoding, |
8d814084 | 270 | "transferencoding" => \$target_xfer_encoding, |
34cc60ce | 271 | ); |
4a62d3f5 | 272 | |
cec5dae8 CS |
273 | my %config_path_settings = ( |
274 | "aliasesfile" => \@alias_files, | |
6e07a3b5 | 275 | "smtpsslcertpath" => \$smtp_ssl_cert_path, |
cec5dae8 CS |
276 | ); |
277 | ||
87429976 MW |
278 | # Handle Uncouth Termination |
279 | sub signal_handler { | |
280 | ||
281 | # Make text normal | |
282 | print color("reset"), "\n"; | |
283 | ||
284 | # SMTP password masked | |
285 | system "stty echo"; | |
286 | ||
287 | # tmp files from --compose | |
afe756c9 JS |
288 | if (defined $compose_filename) { |
289 | if (-e $compose_filename) { | |
3c5cd20c VA |
290 | printf __("'%s' contains an intermediate version ". |
291 | "of the email you were composing.\n"), | |
292 | $compose_filename; | |
afe756c9 JS |
293 | } |
294 | if (-e ($compose_filename . ".final")) { | |
3c5cd20c VA |
295 | printf __("'%s.final' contains the composed email.\n"), |
296 | $compose_filename; | |
afe756c9 | 297 | } |
87429976 MW |
298 | } |
299 | ||
300 | exit; | |
301 | }; | |
302 | ||
303 | $SIG{TERM} = \&signal_handler; | |
304 | $SIG{INT} = \&signal_handler; | |
305 | ||
83b24437 RA |
306 | # Begin by accumulating all the variables (defined above), that we will end up |
307 | # needing, first, from the command line: | |
308 | ||
c5978246 CB |
309 | my $help; |
310 | my $rc = GetOptions("h" => \$help, | |
17b7a832 JK |
311 | "dump-aliases" => \$dump_aliases); |
312 | usage() unless $rc; | |
46493105 | 313 | die __("--dump-aliases incompatible with other options\n") |
17b7a832 JK |
314 | if !$help and $dump_aliases and @ARGV; |
315 | $rc = GetOptions( | |
c5978246 | 316 | "sender|from=s" => \$sender, |
83b24437 RA |
317 | "in-reply-to=s" => \$initial_reply_to, |
318 | "subject=s" => \$initial_subject, | |
3c3bb51c | 319 | "to=s" => \@initial_to, |
6e74e075 | 320 | "to-cmd=s" => \$to_cmd, |
f434c083 | 321 | "no-to" => \$no_to, |
da140f8b | 322 | "cc=s" => \@initial_cc, |
f434c083 | 323 | "no-cc" => \$no_cc, |
58063245 | 324 | "bcc=s" => \@bcclist, |
f434c083 | 325 | "no-bcc" => \$no_bcc, |
78488b2c | 326 | "chain-reply-to!" => \$chain_reply_to, |
f4714943 | 327 | "no-chain-reply-to" => sub {$chain_reply_to = 0}, |
3342d850 | 328 | "smtp-server=s" => \$smtp_server, |
052fbea2 | 329 | "smtp-server-option=s" => \@smtp_server_options, |
44b2476a | 330 | "smtp-server-port=s" => \$smtp_server_port, |
34cc60ce | 331 | "smtp-user=s" => \$smtp_authuser, |
2363d746 | 332 | "smtp-pass:s" => \$smtp_authpass, |
f6bebd12 TR |
333 | "smtp-ssl" => sub { $smtp_encryption = 'ssl' }, |
334 | "smtp-encryption=s" => \$smtp_encryption, | |
979e652a | 335 | "smtp-ssl-cert-path=s" => \$smtp_ssl_cert_path, |
f60812ef | 336 | "smtp-debug:i" => \$debug_net_smtp, |
69cf7bfd | 337 | "smtp-domain:s" => \$smtp_domain, |
0f2e68b5 | 338 | "smtp-auth=s" => \$smtp_auth, |
34cc60ce | 339 | "identity=s" => \$identity, |
402596aa | 340 | "annotate!" => \$annotate, |
f4714943 | 341 | "no-annotate" => sub {$annotate = 0}, |
1f038a0c | 342 | "compose" => \$compose, |
30d08b34 | 343 | "quiet" => \$quiet, |
324a8bd0 | 344 | "cc-cmd=s" => \$cc_cmd, |
5483c71d | 345 | "suppress-from!" => \$suppress_from, |
f4714943 | 346 | "no-suppress-from" => sub {$suppress_from = 0}, |
65648283 | 347 | "suppress-cc=s" => \@suppress_cc, |
ddc3d4fe | 348 | "signed-off-cc|signed-off-by-cc!" => \$signed_off_by_cc, |
f4714943 | 349 | "no-signed-off-cc|no-signed-off-by-cc" => sub {$signed_off_by_cc = 0}, |
f515c904 | 350 | "cc-cover|cc-cover!" => \$cover_cc, |
f4714943 | 351 | "no-cc-cover" => sub {$cover_cc = 0}, |
f515c904 | 352 | "to-cover|to-cover!" => \$cover_to, |
f4714943 | 353 | "no-to-cover" => sub {$cover_to = 0}, |
c1f2aa45 | 354 | "confirm=s" => \$confirm, |
6130259c | 355 | "dry-run" => \$dry_run, |
f073a592 | 356 | "envelope-sender=s" => \$envelope_sender, |
5483c71d | 357 | "thread!" => \$thread, |
f4714943 | 358 | "no-thread" => sub {$thread = 0}, |
dbf5e1e9 | 359 | "validate!" => \$validate, |
f4714943 | 360 | "no-validate" => sub {$validate = 0}, |
8d814084 | 361 | "transfer-encoding=s" => \$target_xfer_encoding, |
5df9fcf6 | 362 | "format-patch!" => \$format_patch, |
f4714943 | 363 | "no-format-patch" => sub {$format_patch = 0}, |
3cae7e5b | 364 | "8bit-encoding=s" => \$auto_8bit_encoding, |
62e00690 | 365 | "compose-encoding=s" => \$compose_encoding, |
a03bc5b6 | 366 | "force" => \$force, |
ac1596a6 | 367 | "xmailer!" => \$use_xmailer, |
f4714943 | 368 | "no-xmailer" => sub {$use_xmailer = 0}, |
5453b83b | 369 | "batch-size=i" => \$batch_size, |
370 | "relogin-delay=i" => \$relogin_delay, | |
83b24437 RA |
371 | ); |
372 | ||
c5978246 | 373 | usage() if $help; |
1b0baf14 MC |
374 | unless ($rc) { |
375 | usage(); | |
376 | } | |
377 | ||
46493105 | 378 | die __("Cannot run git format-patch from outside a repository\n") |
eed6ca7c JS |
379 | if $format_patch and not $repo; |
380 | ||
34cc60ce DS |
381 | # Now, let's fill any that aren't set in with defaults: |
382 | ||
383 | sub read_config { | |
384 | my ($prefix) = @_; | |
385 | ||
386 | foreach my $setting (keys %config_bool_settings) { | |
387 | my $target = $config_bool_settings{$setting}->[0]; | |
ad79c024 | 388 | $$target = Git::config_bool(@repo, "$prefix.$setting") unless (defined $$target); |
34cc60ce DS |
389 | } |
390 | ||
cec5dae8 | 391 | foreach my $setting (keys %config_path_settings) { |
463b0ea2 CS |
392 | my $target = $config_path_settings{$setting}; |
393 | if (ref($target) eq "ARRAY") { | |
394 | unless (@$target) { | |
395 | my @values = Git::config_path(@repo, "$prefix.$setting"); | |
396 | @$target = @values if (@values && defined $values[0]); | |
397 | } | |
398 | } | |
399 | else { | |
400 | $$target = Git::config_path(@repo, "$prefix.$setting") unless (defined $$target); | |
401 | } | |
cec5dae8 CS |
402 | } |
403 | ||
34cc60ce DS |
404 | foreach my $setting (keys %config_settings) { |
405 | my $target = $config_settings{$setting}; | |
f434c083 SB |
406 | next if $setting eq "to" and defined $no_to; |
407 | next if $setting eq "cc" and defined $no_cc; | |
408 | next if $setting eq "bcc" and defined $no_bcc; | |
34cc60ce DS |
409 | if (ref($target) eq "ARRAY") { |
410 | unless (@$target) { | |
ad79c024 | 411 | my @values = Git::config(@repo, "$prefix.$setting"); |
34cc60ce DS |
412 | @$target = @values if (@values && defined $values[0]); |
413 | } | |
414 | } | |
415 | else { | |
ad79c024 | 416 | $$target = Git::config(@repo, "$prefix.$setting") unless (defined $$target); |
34cc60ce DS |
417 | } |
418 | } | |
f6bebd12 TR |
419 | |
420 | if (!defined $smtp_encryption) { | |
421 | my $enc = Git::config(@repo, "$prefix.smtpencryption"); | |
422 | if (defined $enc) { | |
423 | $smtp_encryption = $enc; | |
424 | } elsif (Git::config_bool(@repo, "$prefix.smtpssl")) { | |
425 | $smtp_encryption = 'ssl'; | |
426 | } | |
427 | } | |
34cc60ce DS |
428 | } |
429 | ||
430 | # read configuration from [sendemail "$identity"], fall back on [sendemail] | |
ad79c024 | 431 | $identity = Git::config(@repo, "sendemail.identity") unless (defined $identity); |
34cc60ce DS |
432 | read_config("sendemail.$identity") if (defined $identity); |
433 | read_config("sendemail"); | |
434 | ||
435 | # fall back on builtin bool defaults | |
436 | foreach my $setting (values %config_bool_settings) { | |
437 | ${$setting->[0]} = $setting->[1] unless (defined (${$setting->[0]})); | |
438 | } | |
439 | ||
fa835cd5 TR |
440 | # 'default' encryption is none -- this only prevents a warning |
441 | $smtp_encryption = '' unless (defined $smtp_encryption); | |
442 | ||
65648283 DB |
443 | # Set CC suppressions |
444 | my(%suppress_cc); | |
445 | if (@suppress_cc) { | |
446 | foreach my $entry (@suppress_cc) { | |
3c5cd20c | 447 | die sprintf(__("Unknown --suppress-cc field: '%s'\n"), $entry) |
e9bf741b | 448 | unless $entry =~ /^(?:all|cccmd|cc|author|self|sob|body|bodycc)$/; |
65648283 DB |
449 | $suppress_cc{$entry} = 1; |
450 | } | |
451 | } | |
452 | ||
453 | if ($suppress_cc{'all'}) { | |
cb8a9bd5 | 454 | foreach my $entry (qw (cccmd cc author self sob body bodycc)) { |
65648283 DB |
455 | $suppress_cc{$entry} = 1; |
456 | } | |
457 | delete $suppress_cc{'all'}; | |
458 | } | |
459 | ||
460 | # If explicit old-style ones are specified, they trump --suppress-cc. | |
461 | $suppress_cc{'self'} = $suppress_from if defined $suppress_from; | |
ddc3d4fe | 462 | $suppress_cc{'sob'} = !$signed_off_by_cc if defined $signed_off_by_cc; |
65648283 | 463 | |
3531e270 JS |
464 | if ($suppress_cc{'body'}) { |
465 | foreach my $entry (qw (sob bodycc)) { | |
466 | $suppress_cc{$entry} = 1; | |
467 | } | |
468 | delete $suppress_cc{'body'}; | |
469 | } | |
470 | ||
c1f2aa45 JS |
471 | # Set confirm's default value |
472 | my $confirm_unconfigured = !defined $confirm; | |
473 | if ($confirm_unconfigured) { | |
474 | $confirm = scalar %suppress_cc ? 'compose' : 'auto'; | |
475 | }; | |
3c5cd20c | 476 | die sprintf(__("Unknown --confirm setting: '%s'\n"), $confirm) |
c1f2aa45 JS |
477 | unless $confirm =~ /^(?:auto|cc|compose|always|never)/; |
478 | ||
65648283 DB |
479 | # Debugging, print out the suppressions. |
480 | if (0) { | |
481 | print "suppressions:\n"; | |
482 | foreach my $entry (keys %suppress_cc) { | |
483 | printf " %-5s -> $suppress_cc{$entry}\n", $entry; | |
484 | } | |
485 | } | |
486 | ||
ad79c024 FL |
487 | my ($repoauthor, $repocommitter); |
488 | ($repoauthor) = Git::ident_person(@repo, 'author'); | |
489 | ($repocommitter) = Git::ident_person(@repo, 'committer'); | |
34cc60ce | 490 | |
5012699d JS |
491 | sub parse_address_line { |
492 | if ($have_mail_address) { | |
493 | return map { $_->format } Mail::Address->parse($_[0]); | |
494 | } else { | |
8d314d7a | 495 | return Git::parse_mailboxes($_[0]); |
5012699d JS |
496 | } |
497 | } | |
498 | ||
0e73b3ee | 499 | sub split_addrs { |
2f0e7cbb | 500 | return quotewords('\s*,\s*', 1, @_); |
0e73b3ee WF |
501 | } |
502 | ||
994d6c66 | 503 | my %aliases; |
09f1157b ES |
504 | |
505 | sub parse_sendmail_alias { | |
506 | local $_ = shift; | |
507 | if (/"/) { | |
3c5cd20c | 508 | printf STDERR __("warning: sendmail alias with quotes is not supported: %s\n"), $_; |
86b89848 | 509 | } elsif (/:include:/) { |
3c5cd20c | 510 | printf STDERR __("warning: `:include:` not supported: %s\n"), $_; |
86b89848 | 511 | } elsif (/[\/|]/) { |
3c5cd20c | 512 | printf STDERR __("warning: `/file` or `|pipe` redirection not supported: %s\n"), $_; |
09f1157b ES |
513 | } elsif (/^(\S+?)\s*:\s*(.+)$/) { |
514 | my ($alias, $addr) = ($1, $2); | |
515 | $aliases{$alias} = [ split_addrs($addr) ]; | |
516 | } else { | |
3c5cd20c | 517 | printf STDERR __("warning: sendmail line is not recognized: %s\n"), $_; |
09f1157b ES |
518 | } |
519 | } | |
520 | ||
521 | sub parse_sendmail_aliases { | |
522 | my $fh = shift; | |
2532dd06 | 523 | my $s = ''; |
09f1157b | 524 | while (<$fh>) { |
2532dd06 | 525 | chomp; |
020be85f | 526 | next if /^\s*$/ || /^\s*#/; |
2532dd06 ES |
527 | $s .= $_, next if $s =~ s/\\$// || s/^\s+//; |
528 | parse_sendmail_alias($s) if $s; | |
529 | $s = $_; | |
09f1157b | 530 | } |
2532dd06 ES |
531 | $s =~ s/\\$//; # silently tolerate stray '\' on last line |
532 | parse_sendmail_alias($s) if $s; | |
09f1157b ES |
533 | } |
534 | ||
994d6c66 EW |
535 | my %parse_alias = ( |
536 | # multiline formats can be supported in the future | |
537 | mutt => sub { my $fh = shift; while (<$fh>) { | |
ffc01f9b | 538 | if (/^\s*alias\s+(?:-group\s+\S+\s+)*(\S+)\s+(.*)$/) { |
994d6c66 EW |
539 | my ($alias, $addr) = ($1, $2); |
540 | $addr =~ s/#.*$//; # mutt allows # comments | |
2c510f21 EW |
541 | # commas delimit multiple addresses |
542 | my @addr = split_addrs($addr); | |
543 | ||
544 | # quotes may be escaped in the file, | |
545 | # unescape them so we do not double-escape them later. | |
546 | s/\\"/"/g foreach @addr; | |
547 | $aliases{$alias} = \@addr | |
994d6c66 EW |
548 | }}}, |
549 | mailrc => sub { my $fh = shift; while (<$fh>) { | |
a277d1ef | 550 | if (/^alias\s+(\S+)\s+(.*?)\s*$/) { |
994d6c66 | 551 | # spaces delimit multiple addresses |
fe87c921 | 552 | $aliases{$1} = [ quotewords('\s+', 0, $2) ]; |
994d6c66 | 553 | }}}, |
73c427eb TP |
554 | pine => sub { my $fh = shift; my $f='\t[^\t]*'; |
555 | for (my $x = ''; defined($x); $x = $_) { | |
556 | chomp $x; | |
557 | $x .= $1 while(defined($_ = <$fh>) && /^ +(.*)$/); | |
558 | $x =~ /^(\S+)$f\t\(?([^\t]+?)\)?(:?$f){0,2}$/ or next; | |
0e73b3ee | 559 | $aliases{$1} = [ split_addrs($2) ]; |
73c427eb | 560 | }}, |
7613ea35 BP |
561 | elm => sub { my $fh = shift; |
562 | while (<$fh>) { | |
563 | if (/^(\S+)\s+=\s+[^=]+=\s(\S+)/) { | |
564 | my ($alias, $addr) = ($1, $2); | |
565 | $aliases{$alias} = [ split_addrs($addr) ]; | |
566 | } | |
567 | } }, | |
09f1157b | 568 | sendmail => \&parse_sendmail_aliases, |
994d6c66 EW |
569 | gnus => sub { my $fh = shift; while (<$fh>) { |
570 | if (/\(define-mail-alias\s+"(\S+?)"\s+"(\S+?)"\)/) { | |
571 | $aliases{$1} = [ $2 ]; | |
572 | }}} | |
573 | ); | |
574 | ||
3cb8caf7 | 575 | if (@alias_files and $aliasfiletype and defined $parse_alias{$aliasfiletype}) { |
994d6c66 EW |
576 | foreach my $file (@alias_files) { |
577 | open my $fh, '<', $file or die "opening $file: $!\n"; | |
578 | $parse_alias{$aliasfiletype}->($fh); | |
579 | close $fh; | |
580 | } | |
581 | } | |
582 | ||
17b7a832 JK |
583 | if ($dump_aliases) { |
584 | print "$_\n" for (sort keys %aliases); | |
585 | exit(0); | |
586 | } | |
587 | ||
9b397039 RR |
588 | # is_format_patch_arg($f) returns 0 if $f names a patch, or 1 if |
589 | # $f is a revision list specification to be passed to format-patch. | |
590 | sub is_format_patch_arg { | |
eed6ca7c | 591 | return unless $repo; |
5df9fcf6 PH |
592 | my $f = shift; |
593 | try { | |
594 | $repo->command('rev-parse', '--verify', '--quiet', $f); | |
595 | if (defined($format_patch)) { | |
5df9fcf6 PH |
596 | return $format_patch; |
597 | } | |
3c5cd20c VA |
598 | die sprintf(__ <<EOF, $f, $f); |
599 | File '%s' exists but it could also be the range of commits | |
5df9fcf6 PH |
600 | to produce patches for. Please disambiguate by... |
601 | ||
3c5cd20c | 602 | * Saying "./%s" if you mean a file; or |
5df9fcf6 PH |
603 | * Giving --format-patch option if you mean a range. |
604 | EOF | |
605 | } catch Git::Error::Command with { | |
9b397039 | 606 | # Not a valid revision. Treat it as a filename. |
5df9fcf6 PH |
607 | return 0; |
608 | } | |
609 | } | |
610 | ||
aa54892f JK |
611 | # Now that all the defaults are set, process the rest of the command line |
612 | # arguments and collect up the files that need to be processed. | |
5df9fcf6 | 613 | my @rev_list_opts; |
69f4ce55 | 614 | while (defined(my $f = shift @ARGV)) { |
5df9fcf6 PH |
615 | if ($f eq "--") { |
616 | push @rev_list_opts, "--", @ARGV; | |
617 | @ARGV = (); | |
9b397039 | 618 | } elsif (-d $f and !is_format_patch_arg($f)) { |
c6038169 | 619 | opendir my $dh, $f |
3c5cd20c | 620 | or die sprintf(__("Failed to opendir %s: %s"), $f, $!); |
aa54892f | 621 | |
89bf1bac | 622 | push @files, grep { -f $_ } map { catfile($f, $_) } |
c6038169 ÆAB |
623 | sort readdir $dh; |
624 | closedir $dh; | |
9b397039 | 625 | } elsif ((-f $f or -p $f) and !is_format_patch_arg($f)) { |
aa54892f | 626 | push @files, $f; |
aa54892f | 627 | } else { |
5df9fcf6 | 628 | push @rev_list_opts, $f; |
aa54892f JK |
629 | } |
630 | } | |
631 | ||
5df9fcf6 | 632 | if (@rev_list_opts) { |
46493105 | 633 | die __("Cannot run git format-patch from outside a repository\n") |
eed6ca7c | 634 | unless $repo; |
5df9fcf6 PH |
635 | push @files, $repo->command('format-patch', '-o', tempdir(CLEANUP => 1), @rev_list_opts); |
636 | } | |
637 | ||
531220ba JH |
638 | @files = handle_backup_files(@files); |
639 | ||
dbf5e1e9 | 640 | if ($validate) { |
c764a0c2 | 641 | foreach my $f (@files) { |
300913bd KB |
642 | unless (-p $f) { |
643 | my $error = validate_patch($f); | |
3c5cd20c VA |
644 | $error and die sprintf(__("fatal: %s: %s\nwarning: no patches were sent\n"), |
645 | $f, $error); | |
300913bd | 646 | } |
c764a0c2 | 647 | } |
747bbff9 JK |
648 | } |
649 | ||
aa54892f JK |
650 | if (@files) { |
651 | unless ($quiet) { | |
652 | print $_,"\n" for (@files); | |
653 | } | |
654 | } else { | |
46493105 | 655 | print STDERR __("\nNo patch files specified!\n\n"); |
aa54892f JK |
656 | usage(); |
657 | } | |
658 | ||
acf071b0 | 659 | sub get_patch_subject { |
beece9da PH |
660 | my $fn = shift; |
661 | open (my $fh, '<', $fn); | |
662 | while (my $line = <$fh>) { | |
663 | next unless ($line =~ /^Subject: (.*)$/); | |
664 | close $fh; | |
665 | return "GIT: $1\n"; | |
666 | } | |
667 | close $fh; | |
3c5cd20c | 668 | die sprintf(__("No subject line in %s?"), $fn); |
beece9da PH |
669 | } |
670 | ||
671 | if ($compose) { | |
672 | # Note that this does not need to be secure, but we will make a small | |
673 | # effort to have it be unique | |
afe756c9 JS |
674 | $compose_filename = ($repo ? |
675 | tempfile(".gitsendemail.msg.XXXXXX", DIR => $repo->repo_path()) : | |
676 | tempfile(".gitsendemail.msg.XXXXXX", DIR => "."))[1]; | |
fe0f944f | 677 | open my $c, ">", $compose_filename |
3c5cd20c | 678 | or die sprintf(__("Failed to open for writing %s: %s"), $compose_filename, $!); |
beece9da PH |
679 | |
680 | ||
681 | my $tpl_sender = $sender || $repoauthor || $repocommitter || ''; | |
682 | my $tpl_subject = $initial_subject || ''; | |
683 | my $tpl_reply_to = $initial_reply_to || ''; | |
684 | ||
70aedfb3 | 685 | print $c <<EOT1, Git::prefix_lines("GIT: ", __ <<EOT2), <<EOT3; |
beece9da | 686 | From $tpl_sender # This line is ignored. |
70aedfb3 VA |
687 | EOT1 |
688 | Lines beginning in "GIT:" will be removed. | |
689 | Consider including an overall diffstat or table of contents | |
690 | for the patch you are writing. | |
691 | ||
692 | Clear the body content if you don't wish to send a summary. | |
693 | EOT2 | |
beece9da PH |
694 | From: $tpl_sender |
695 | Subject: $tpl_subject | |
696 | In-Reply-To: $tpl_reply_to | |
697 | ||
70aedfb3 | 698 | EOT3 |
beece9da | 699 | for my $f (@files) { |
fe0f944f | 700 | print $c get_patch_subject($f); |
beece9da | 701 | } |
fe0f944f | 702 | close $c; |
beece9da | 703 | |
beece9da PH |
704 | if ($annotate) { |
705 | do_edit($compose_filename, @files); | |
706 | } else { | |
707 | do_edit($compose_filename); | |
708 | } | |
709 | ||
fe0f944f | 710 | open my $c2, ">", $compose_filename . ".final" |
3c5cd20c | 711 | or die sprintf(__("Failed to open %s.final: %s"), $compose_filename, $!); |
beece9da | 712 | |
fe0f944f | 713 | open $c, "<", $compose_filename |
3c5cd20c | 714 | or die sprintf(__("Failed to open %s: %s"), $compose_filename, $!); |
beece9da PH |
715 | |
716 | my $need_8bit_cte = file_has_nonascii($compose_filename); | |
717 | my $in_body = 0; | |
718 | my $summary_empty = 1; | |
4a47a4dd KM |
719 | if (!defined $compose_encoding) { |
720 | $compose_encoding = "UTF-8"; | |
721 | } | |
fe0f944f | 722 | while(<$c>) { |
40e6e8a0 | 723 | next if m/^GIT:/; |
beece9da PH |
724 | if ($in_body) { |
725 | $summary_empty = 0 unless (/^\n$/); | |
726 | } elsif (/^\n$/) { | |
727 | $in_body = 1; | |
728 | if ($need_8bit_cte) { | |
fe0f944f | 729 | print $c2 "MIME-Version: 1.0\n", |
beece9da | 730 | "Content-Type: text/plain; ", |
62e00690 | 731 | "charset=$compose_encoding\n", |
beece9da PH |
732 | "Content-Transfer-Encoding: 8bit\n"; |
733 | } | |
734 | } elsif (/^MIME-Version:/i) { | |
735 | $need_8bit_cte = 0; | |
736 | } elsif (/^Subject:\s*(.+)\s*$/i) { | |
737 | $initial_subject = $1; | |
738 | my $subject = $initial_subject; | |
739 | $_ = "Subject: " . | |
ce547800 | 740 | quote_subject($subject, $compose_encoding) . |
beece9da PH |
741 | "\n"; |
742 | } elsif (/^In-Reply-To:\s*(.+)\s*$/i) { | |
743 | $initial_reply_to = $1; | |
744 | next; | |
745 | } elsif (/^From:\s*(.+)\s*$/i) { | |
746 | $sender = $1; | |
747 | next; | |
748 | } elsif (/^(?:To|Cc|Bcc):/i) { | |
46493105 | 749 | print __("To/Cc/Bcc fields are not interpreted yet, they have been ignored\n"); |
beece9da PH |
750 | next; |
751 | } | |
fe0f944f | 752 | print $c2 $_; |
beece9da | 753 | } |
fe0f944f ÆAB |
754 | close $c; |
755 | close $c2; | |
beece9da PH |
756 | |
757 | if ($summary_empty) { | |
46493105 | 758 | print __("Summary email is empty, skipping it\n"); |
beece9da PH |
759 | $compose = -1; |
760 | } | |
761 | } elsif ($annotate) { | |
762 | do_edit(@files); | |
763 | } | |
764 | ||
6e182518 JS |
765 | sub ask { |
766 | my ($prompt, %arg) = @_; | |
0da43a68 | 767 | my $valid_re = $arg{valid_re}; |
6e182518 | 768 | my $default = $arg{default}; |
51bbccfd | 769 | my $confirm_only = $arg{confirm_only}; |
6e182518 JS |
770 | my $resp; |
771 | my $i = 0; | |
5906f54e JS |
772 | return defined $default ? $default : undef |
773 | unless defined $term->IN and defined fileno($term->IN) and | |
774 | defined $term->OUT and defined fileno($term->OUT); | |
6e182518 JS |
775 | while ($i++ < 10) { |
776 | $resp = $term->readline($prompt); | |
777 | if (!defined $resp) { # EOF | |
778 | print "\n"; | |
779 | return defined $default ? $default : undef; | |
780 | } | |
781 | if ($resp eq '' and defined $default) { | |
782 | return $default; | |
783 | } | |
0da43a68 | 784 | if (!defined $valid_re or $resp =~ /$valid_re/) { |
6e182518 JS |
785 | return $resp; |
786 | } | |
51bbccfd | 787 | if ($confirm_only) { |
3c5cd20c VA |
788 | my $yesno = $term->readline( |
789 | # TRANSLATORS: please keep [y/N] as is. | |
790 | sprintf(__("Are you sure you want to use <%s> [y/N]? "), $resp)); | |
51bbccfd JH |
791 | if (defined $yesno && $yesno =~ /y/i) { |
792 | return $resp; | |
793 | } | |
794 | } | |
6e182518 | 795 | } |
622bc930 | 796 | return; |
6e182518 JS |
797 | } |
798 | ||
3cae7e5b TR |
799 | my %broken_encoding; |
800 | ||
1d50bfd9 | 801 | sub file_declares_8bit_cte { |
3cae7e5b TR |
802 | my $fn = shift; |
803 | open (my $fh, '<', $fn); | |
804 | while (my $line = <$fh>) { | |
805 | last if ($line =~ /^$/); | |
806 | return 1 if ($line =~ /^Content-Transfer-Encoding: .*8bit.*$/); | |
807 | } | |
808 | close $fh; | |
809 | return 0; | |
810 | } | |
811 | ||
812 | foreach my $f (@files) { | |
813 | next unless (body_or_subject_has_nonascii($f) | |
814 | && !file_declares_8bit_cte($f)); | |
815 | $broken_encoding{$f} = 1; | |
816 | } | |
817 | ||
818 | if (!defined $auto_8bit_encoding && scalar %broken_encoding) { | |
a4dde4c4 VA |
819 | print __("The following files are 8bit, but do not declare " . |
820 | "a Content-Transfer-Encoding.\n"); | |
3cae7e5b TR |
821 | foreach my $f (sort keys %broken_encoding) { |
822 | print " $f\n"; | |
823 | } | |
a4dde4c4 | 824 | $auto_8bit_encoding = ask(__("Which 8bit encoding should I declare [UTF-8]? "), |
852a15d7 | 825 | valid_re => qr/.{4}/, confirm_only => 1, |
3cae7e5b TR |
826 | default => "UTF-8"); |
827 | } | |
828 | ||
a03bc5b6 TR |
829 | if (!$force) { |
830 | for my $f (@files) { | |
0d290a46 | 831 | if (get_patch_subject($f) =~ /\Q*** SUBJECT HERE ***\E/) { |
3c5cd20c | 832 | die sprintf(__("Refusing to send because the patch\n\t%s\n" |
a03bc5b6 | 833 | . "has the template subject '*** SUBJECT HERE ***'. " |
3c5cd20c | 834 | . "Pass --force if you really want to send.\n"), $f); |
a03bc5b6 TR |
835 | } |
836 | } | |
837 | } | |
838 | ||
c46e27aa | 839 | if (defined $sender) { |
fa5b1aa9 | 840 | $sender =~ s/^\s+|\s+$//g; |
c46e27aa RL |
841 | ($sender) = expand_aliases($sender); |
842 | } else { | |
ad79c024 | 843 | $sender = $repoauthor || $repocommitter || ''; |
83b24437 RA |
844 | } |
845 | ||
da18759e MT |
846 | # $sender could be an already sanitized address |
847 | # (e.g. sendemail.from could be manually sanitized by user). | |
848 | # But it's a no-op to run sanitize_address on an already sanitized address. | |
849 | $sender = sanitize_address($sender); | |
850 | ||
a4dde4c4 | 851 | my $to_whom = __("To whom should the emails be sent (if anyone)?"); |
8cac13dc | 852 | my $prompting = 0; |
8796ff7f | 853 | if (!@initial_to && !defined $to_cmd) { |
0d6b21e7 | 854 | my $to = ask("$to_whom ", |
61837493 | 855 | default => "", |
51bbccfd | 856 | valid_re => qr/\@.*\./, confirm_only => 1); |
3c3bb51c | 857 | push @initial_to, parse_address_line($to) if defined $to; # sanitized/validated later |
1f038a0c | 858 | $prompting++; |
83b24437 RA |
859 | } |
860 | ||
994d6c66 | 861 | sub expand_aliases { |
302e04ea JK |
862 | return map { expand_one_alias($_) } @_; |
863 | } | |
864 | ||
865 | my %EXPANDED_ALIASES; | |
866 | sub expand_one_alias { | |
867 | my $alias = shift; | |
868 | if ($EXPANDED_ALIASES{$alias}) { | |
3c5cd20c | 869 | die sprintf(__("fatal: alias '%s' expands to itself\n"), $alias); |
302e04ea JK |
870 | } |
871 | local $EXPANDED_ALIASES{$alias} = 1; | |
872 | return $aliases{$alias} ? expand_aliases(@{$aliases{$alias}}) : $alias; | |
994d6c66 EW |
873 | } |
874 | ||
b5e112d8 RL |
875 | @initial_to = process_address_list(@initial_to); |
876 | @initial_cc = process_address_list(@initial_cc); | |
877 | @bcclist = process_address_list(@bcclist); | |
994d6c66 | 878 | |
5483c71d | 879 | if ($thread && !defined $initial_reply_to && $prompting) { |
6e182518 | 880 | $initial_reply_to = ask( |
a4dde4c4 | 881 | __("Message-ID to be used as In-Reply-To for the first email (if any)? "), |
61837493 | 882 | default => "", |
51bbccfd | 883 | valid_re => qr/\@.*\./, confirm_only => 1); |
83b24437 | 884 | } |
1ca3d6ed | 885 | if (defined $initial_reply_to) { |
0fb7fc75 JS |
886 | $initial_reply_to =~ s/^\s*<?//; |
887 | $initial_reply_to =~ s/>?\s*$//; | |
888 | $initial_reply_to = "<$initial_reply_to>" if $initial_reply_to ne ''; | |
ace9c2a9 | 889 | } |
ace72086 | 890 | |
34cc60ce | 891 | if (!defined $smtp_server) { |
aca7ad76 EW |
892 | foreach (qw( /usr/sbin/sendmail /usr/lib/sendmail )) { |
893 | if (-x $_) { | |
894 | $smtp_server = $_; | |
895 | last; | |
896 | } | |
897 | } | |
898 | $smtp_server ||= 'localhost'; # could be 127.0.0.1, too... *shrug* | |
3342d850 RA |
899 | } |
900 | ||
c1f2aa45 JS |
901 | if ($compose && $compose > 0) { |
902 | @files = ($compose_filename . ".final", @files); | |
1f038a0c RA |
903 | } |
904 | ||
83b24437 | 905 | # Variables we set as part of the loop over files |
c1f2aa45 | 906 | our ($message_id, %mail, $subject, $reply_to, $references, $message, |
dc1460aa | 907 | $needs_confirm, $message_num, $ask_default); |
83b24437 | 908 | |
567ffeb7 EW |
909 | sub extract_valid_address { |
910 | my $address = shift; | |
35b6ab95 ÆAB |
911 | my $local_part_regexp = qr/[^<>"\s@]+/; |
912 | my $domain_regexp = qr/[^.<>"\s@]+(?:\.[^.<>"\s@]+)+/; | |
db3106b2 EW |
913 | |
914 | # check for a local address: | |
ad9c18f5 | 915 | return $address if ($address =~ /^($local_part_regexp)$/); |
db3106b2 | 916 | |
155197e6 | 917 | $address =~ s/^\s*<(.*)>\s*$/$1/; |
567ffeb7 | 918 | if ($have_email_valid) { |
ad9c18f5 | 919 | return scalar Email::Valid->address($address); |
567ffeb7 | 920 | } |
95c0d4b6 KM |
921 | |
922 | # less robust/correct than the monster regexp in Email::Valid, | |
923 | # but still does a 99% job, and one less dependency | |
924 | return $1 if $address =~ /($local_part_regexp\@$domain_regexp)/; | |
622bc930 | 925 | return; |
567ffeb7 | 926 | } |
83b24437 | 927 | |
e4312255 KM |
928 | sub extract_valid_address_or_die { |
929 | my $address = shift; | |
930 | $address = extract_valid_address($address); | |
3c5cd20c | 931 | die sprintf(__("error: unable to extract a valid address from: %s\n"), $address) |
e4312255 KM |
932 | if !$address; |
933 | return $address; | |
934 | } | |
935 | ||
936 | sub validate_address { | |
937 | my $address = shift; | |
d0e98107 | 938 | while (!extract_valid_address($address)) { |
3c5cd20c | 939 | printf STDERR __("error: unable to extract a valid address from: %s\n"), $address; |
a4dde4c4 VA |
940 | # TRANSLATORS: Make sure to include [q] [d] [e] in your |
941 | # translation. The program will only accept English input | |
942 | # at this point. | |
943 | $_ = ask(__("What to do with this address? ([q]uit|[d]rop|[e]dit): "), | |
d0e98107 | 944 | valid_re => qr/^(?:quit|q|drop|d|edit|e)/i, |
5c80afed KM |
945 | default => 'q'); |
946 | if (/^d/i) { | |
947 | return undef; | |
948 | } elsif (/^q/i) { | |
949 | cleanup_compose_files(); | |
950 | exit(0); | |
951 | } | |
0d6b21e7 | 952 | $address = ask("$to_whom ", |
d0e98107 KM |
953 | default => "", |
954 | valid_re => qr/\@.*\./, confirm_only => 1); | |
e4312255 KM |
955 | } |
956 | return $address; | |
957 | } | |
958 | ||
959 | sub validate_address_list { | |
960 | return (grep { defined $_ } | |
961 | map { validate_address($_) } @_); | |
567ffeb7 | 962 | } |
83b24437 RA |
963 | |
964 | # Usually don't need to change anything below here. | |
965 | ||
966 | # we make a "fake" message id by taking the current number | |
967 | # of seconds since the beginning of Unix time and tacking on | |
968 | # a random number to the end, in case we are called quicker than | |
969 | # 1 second since the last time we were called. | |
8037d1a3 RA |
970 | |
971 | # We'll setup a template for the message id, using the "from" address: | |
8037d1a3 | 972 | |
be510cfe | 973 | my ($message_id_stamp, $message_id_serial); |
68ce9330 | 974 | sub make_message_id { |
be510cfe JH |
975 | my $uniq; |
976 | if (!defined $message_id_stamp) { | |
f916ab0c | 977 | $message_id_stamp = strftime("%Y%m%d%H%M%S.$$", gmtime(time)); |
be510cfe JH |
978 | $message_id_serial = 0; |
979 | } | |
980 | $message_id_serial++; | |
981 | $uniq = "$message_id_stamp-$message_id_serial"; | |
982 | ||
aeb59328 | 983 | my $du_part; |
94638f89 UKK |
984 | for ($sender, $repocommitter, $repoauthor) { |
985 | $du_part = extract_valid_address(sanitize_address($_)); | |
986 | last if (defined $du_part and $du_part ne ''); | |
aeb59328 | 987 | } |
94638f89 | 988 | if (not defined $du_part or $du_part eq '') { |
529dd386 | 989 | require Sys::Hostname; |
aeb59328 JH |
990 | $du_part = 'user@' . Sys::Hostname::hostname(); |
991 | } | |
f916ab0c | 992 | my $message_id_template = "<%s-%s>"; |
be510cfe | 993 | $message_id = sprintf($message_id_template, $uniq, $du_part); |
8037d1a3 | 994 | #print "new message id = $message_id\n"; # Was useful for debugging |
83b24437 RA |
995 | } |
996 | ||
997 | ||
998 | ||
a5370b16 | 999 | $time = time - scalar $#files; |
83b24437 | 1000 | |
374c5905 JR |
1001 | sub unquote_rfc2047 { |
1002 | local ($_) = @_; | |
11f70a7e | 1003 | my $charset; |
ab47e2a5 РД |
1004 | my $sep = qr/[ \t]+/; |
1005 | s{$re_encoded_word(?:$sep$re_encoded_word)*}{ | |
1006 | my @words = split $sep, $&; | |
1007 | foreach (@words) { | |
1008 | m/$re_encoded_word/; | |
1009 | $charset = $1; | |
1010 | my $encoding = $2; | |
1011 | my $text = $3; | |
1012 | if ($encoding eq 'q' || $encoding eq 'Q') { | |
1013 | $_ = $text; | |
1014 | s/_/ /g; | |
1015 | s/=([0-9A-F]{2})/chr(hex($1))/egi; | |
1016 | } else { | |
1017 | # other encodings not supported yet | |
1018 | } | |
11f70a7e | 1019 | } |
ab47e2a5 | 1020 | join '', @words; |
b622d4d1 | 1021 | }eg; |
11f70a7e | 1022 | return wantarray ? ($_, $charset) : $_; |
374c5905 JR |
1023 | } |
1024 | ||
d54eaaa2 JK |
1025 | sub quote_rfc2047 { |
1026 | local $_ = shift; | |
d1fff6fc | 1027 | my $encoding = shift || 'UTF-8'; |
d54eaaa2 JK |
1028 | s/([^-a-zA-Z0-9!*+\/])/sprintf("=%02X", ord($1))/eg; |
1029 | s/(.*)/=\?$encoding\?q\?$1\?=/; | |
1030 | return $_; | |
1031 | } | |
1032 | ||
a3a8262b BC |
1033 | sub is_rfc2047_quoted { |
1034 | my $s = shift; | |
a3a8262b | 1035 | length($s) <= 75 && |
11f70a7e | 1036 | $s =~ m/^(?:"[[:ascii:]]*"|$re_encoded_word)$/o; |
a3a8262b BC |
1037 | } |
1038 | ||
ce547800 KM |
1039 | sub subject_needs_rfc2047_quoting { |
1040 | my $s = shift; | |
1041 | ||
ce1459f7 | 1042 | return ($s =~ /[^[:ascii:]]/) || ($s =~ /=\?/); |
ce547800 KM |
1043 | } |
1044 | ||
1045 | sub quote_subject { | |
1046 | local $subject = shift; | |
1047 | my $encoding = shift || 'UTF-8'; | |
1048 | ||
1049 | if (subject_needs_rfc2047_quoting($subject)) { | |
1050 | return quote_rfc2047($subject, $encoding); | |
1051 | } | |
1052 | return $subject; | |
1053 | } | |
1054 | ||
5b56aaa2 | 1055 | # use the simplest quoting being able to handle the recipient |
68ce9330 | 1056 | sub sanitize_address { |
732263d4 | 1057 | my ($recipient) = @_; |
831a488b KM |
1058 | |
1059 | # remove garbage after email address | |
1060 | $recipient =~ s/(.*>).*$/$1/; | |
1061 | ||
5b56aaa2 UKK |
1062 | my ($recipient_name, $recipient_addr) = ($recipient =~ /^(.*?)\s*(<.*)/); |
1063 | ||
1064 | if (not $recipient_name) { | |
ff483897 | 1065 | return $recipient; |
5b56aaa2 UKK |
1066 | } |
1067 | ||
1068 | # if recipient_name is already quoted, do nothing | |
a3a8262b | 1069 | if (is_rfc2047_quoted($recipient_name)) { |
5b56aaa2 UKK |
1070 | return $recipient; |
1071 | } | |
1072 | ||
1fe9703f RL |
1073 | # remove non-escaped quotes |
1074 | $recipient_name =~ s/(^|[^\\])"/$1/g; | |
1075 | ||
5b56aaa2 UKK |
1076 | # rfc2047 is needed if a non-ascii char is included |
1077 | if ($recipient_name =~ /[^[:ascii:]]/) { | |
d54eaaa2 | 1078 | $recipient_name = quote_rfc2047($recipient_name); |
732263d4 | 1079 | } |
5b56aaa2 UKK |
1080 | |
1081 | # double quotes are needed if specials or CTLs are included | |
1082 | elsif ($recipient_name =~ /[][()<>@,;:\\".\000-\037\177]/) { | |
1fe9703f | 1083 | $recipient_name =~ s/([\\\r])/\\$1/g; |
d5c7d69d | 1084 | $recipient_name = qq["$recipient_name"]; |
5b56aaa2 UKK |
1085 | } |
1086 | ||
1087 | return "$recipient_name $recipient_addr"; | |
1088 | ||
732263d4 RJ |
1089 | } |
1090 | ||
e4312255 KM |
1091 | sub sanitize_address_list { |
1092 | return (map { sanitize_address($_) } @_); | |
1093 | } | |
1094 | ||
b5e112d8 | 1095 | sub process_address_list { |
b1c8a11c RL |
1096 | my @addr_list = map { parse_address_line($_) } @_; |
1097 | @addr_list = expand_aliases(@addr_list); | |
b5e112d8 RL |
1098 | @addr_list = sanitize_address_list(@addr_list); |
1099 | @addr_list = validate_address_list(@addr_list); | |
1100 | return @addr_list; | |
1101 | } | |
1102 | ||
134550fe JA |
1103 | # Returns the local Fully Qualified Domain Name (FQDN) if available. |
1104 | # | |
1105 | # Tightly configured MTAa require that a caller sends a real DNS | |
1106 | # domain name that corresponds the IP address in the HELO/EHLO | |
1107 | # handshake. This is used to verify the connection and prevent | |
1108 | # spammers from trying to hide their identity. If the DNS and IP don't | |
1109 | # match, the receiveing MTA may deny the connection. | |
1110 | # | |
1111 | # Here is a deny example of Net::SMTP with the default "localhost.localdomain" | |
1112 | # | |
1113 | # Net::SMTP=GLOB(0x267ec28)>>> EHLO localhost.localdomain | |
1114 | # Net::SMTP=GLOB(0x267ec28)<<< 550 EHLO argument does not match calling host | |
1115 | # | |
1116 | # This maildomain*() code is based on ideas in Perl library Test::Reporter | |
1117 | # /usr/share/perl5/Test/Reporter/Mail/Util.pm ==> sub _maildomain () | |
1118 | ||
59a86303 BG |
1119 | sub valid_fqdn { |
1120 | my $domain = shift; | |
61ef5e9b | 1121 | return defined $domain && !($^O eq 'darwin' && $domain =~ /\.local$/) && $domain =~ /\./; |
59a86303 BG |
1122 | } |
1123 | ||
68ce9330 | 1124 | sub maildomain_net { |
134550fe JA |
1125 | my $maildomain; |
1126 | ||
1127 | if (eval { require Net::Domain; 1 }) { | |
1128 | my $domain = Net::Domain::domainname(); | |
59a86303 | 1129 | $maildomain = $domain if valid_fqdn($domain); |
134550fe JA |
1130 | } |
1131 | ||
1132 | return $maildomain; | |
1133 | } | |
1134 | ||
68ce9330 | 1135 | sub maildomain_mta { |
134550fe JA |
1136 | my $maildomain; |
1137 | ||
1138 | if (eval { require Net::SMTP; 1 }) { | |
1139 | for my $host (qw(mailhost localhost)) { | |
1140 | my $smtp = Net::SMTP->new($host); | |
1141 | if (defined $smtp) { | |
1142 | my $domain = $smtp->domain; | |
1143 | $smtp->quit; | |
1144 | ||
59a86303 | 1145 | $maildomain = $domain if valid_fqdn($domain); |
134550fe JA |
1146 | |
1147 | last if $maildomain; | |
1148 | } | |
1149 | } | |
1150 | } | |
1151 | ||
1152 | return $maildomain; | |
1153 | } | |
1154 | ||
68ce9330 | 1155 | sub maildomain { |
69cf7bfd | 1156 | return maildomain_net() || maildomain_mta() || 'localhost.localdomain'; |
134550fe JA |
1157 | } |
1158 | ||
4d31a44a MN |
1159 | sub smtp_host_string { |
1160 | if (defined $smtp_server_port) { | |
1161 | return "$smtp_server:$smtp_server_port"; | |
1162 | } else { | |
1163 | return $smtp_server; | |
1164 | } | |
1165 | } | |
1166 | ||
1167 | # Returns 1 if authentication succeeded or was not necessary | |
1168 | # (smtp_user was not specified), and 0 otherwise. | |
1169 | ||
1170 | sub smtp_auth_maybe { | |
1171 | if (!defined $smtp_authuser || $auth) { | |
1172 | return 1; | |
1173 | } | |
1174 | ||
1175 | # Workaround AUTH PLAIN/LOGIN interaction defect | |
1176 | # with Authen::SASL::Cyrus | |
1177 | eval { | |
1178 | require Authen::SASL; | |
1179 | Authen::SASL->import(qw(Perl)); | |
1180 | }; | |
1181 | ||
0f2e68b5 JV |
1182 | # Check mechanism naming as defined in: |
1183 | # https://tools.ietf.org/html/rfc4422#page-8 | |
904f6e7c | 1184 | if ($smtp_auth && $smtp_auth !~ /^(\b[A-Z0-9-_]{1,20}\s*)*$/) { |
0f2e68b5 JV |
1185 | die "invalid smtp auth: '${smtp_auth}'"; |
1186 | } | |
1187 | ||
4d31a44a MN |
1188 | # TODO: Authentication may fail not because credentials were |
1189 | # invalid but due to other reasons, in which we should not | |
1190 | # reject credentials. | |
1191 | $auth = Git::credential({ | |
1192 | 'protocol' => 'smtp', | |
1193 | 'host' => smtp_host_string(), | |
1194 | 'username' => $smtp_authuser, | |
1195 | # if there's no password, "git credential fill" will | |
1196 | # give us one, otherwise it'll just pass this one. | |
1197 | 'password' => $smtp_authpass | |
1198 | }, sub { | |
1199 | my $cred = shift; | |
0f2e68b5 JV |
1200 | |
1201 | if ($smtp_auth) { | |
1202 | my $sasl = Authen::SASL->new( | |
1203 | mechanism => $smtp_auth, | |
1204 | callback => { | |
1205 | user => $cred->{'username'}, | |
1206 | pass => $cred->{'password'}, | |
1207 | authname => $cred->{'username'}, | |
1208 | } | |
1209 | ); | |
1210 | ||
1211 | return !!$smtp->auth($sasl); | |
1212 | } | |
1213 | ||
4d31a44a MN |
1214 | return !!$smtp->auth($cred->{'username'}, $cred->{'password'}); |
1215 | }); | |
1216 | ||
1217 | return $auth; | |
1218 | } | |
1219 | ||
35035bbf RR |
1220 | sub ssl_verify_params { |
1221 | eval { | |
1222 | require IO::Socket::SSL; | |
1223 | IO::Socket::SSL->import(qw/SSL_VERIFY_PEER SSL_VERIFY_NONE/); | |
1224 | }; | |
1225 | if ($@) { | |
1226 | print STDERR "Not using SSL_VERIFY_PEER due to out-of-date IO::Socket::SSL.\n"; | |
1227 | return; | |
1228 | } | |
1229 | ||
1230 | if (!defined $smtp_ssl_cert_path) { | |
01645b74 RK |
1231 | # use the OpenSSL defaults |
1232 | return (SSL_verify_mode => SSL_VERIFY_PEER()); | |
35035bbf RR |
1233 | } |
1234 | ||
1235 | if ($smtp_ssl_cert_path eq "") { | |
1236 | return (SSL_verify_mode => SSL_VERIFY_NONE()); | |
1237 | } elsif (-d $smtp_ssl_cert_path) { | |
1238 | return (SSL_verify_mode => SSL_VERIFY_PEER(), | |
1239 | SSL_ca_path => $smtp_ssl_cert_path); | |
1240 | } elsif (-f $smtp_ssl_cert_path) { | |
1241 | return (SSL_verify_mode => SSL_VERIFY_PEER(), | |
1242 | SSL_ca_file => $smtp_ssl_cert_path); | |
1243 | } else { | |
3c5cd20c | 1244 | die sprintf(__("CA path \"%s\" does not exist"), $smtp_ssl_cert_path); |
35035bbf RR |
1245 | } |
1246 | } | |
1247 | ||
cb005c1f EFL |
1248 | sub file_name_is_absolute { |
1249 | my ($path) = @_; | |
1250 | ||
1251 | # msys does not grok DOS drive-prefixes | |
1252 | if ($^O eq 'msys') { | |
f24ecf59 | 1253 | return ($path =~ m#^/# || $path =~ m#^[a-zA-Z]\:#) |
cb005c1f EFL |
1254 | } |
1255 | ||
1256 | require File::Spec::Functions; | |
1257 | return File::Spec::Functions::file_name_is_absolute($path); | |
1258 | } | |
1259 | ||
15da1084 | 1260 | # Returns 1 if the message was sent, and 0 otherwise. |
a1b5b371 | 1261 | # In actuality, the whole program dies when there |
15da1084 MW |
1262 | # is an error sending a message. |
1263 | ||
68ce9330 | 1264 | sub send_message { |
4bc87a28 | 1265 | my @recipients = unique_email_list(@to); |
e4312255 | 1266 | @cc = (grep { my $cc = extract_valid_address_or_die($_); |
83acaaec | 1267 | not grep { $cc eq $_ || $_ =~ /<\Q${cc}\E>$/ } @recipients |
7ac17529 | 1268 | } |
7ac17529 | 1269 | @cc); |
4bc87a28 | 1270 | my $to = join (",\n\t", @recipients); |
58063245 | 1271 | @recipients = unique_email_list(@recipients,@cc,@bcclist); |
e4312255 | 1272 | @recipients = (map { extract_valid_address_or_die($_) } @recipients); |
6bdca890 | 1273 | my $date = format_2822_time($time++); |
e923effb ML |
1274 | my $gitversion = '@@GIT_VERSION@@'; |
1275 | if ($gitversion =~ m/..GIT_VERSION../) { | |
3cb8caf7 | 1276 | $gitversion = Git::version(); |
e923effb | 1277 | } |
4bc87a28 | 1278 | |
02461e0e | 1279 | my $cc = join(",\n\t", unique_email_list(@cc)); |
f06a6a49 JH |
1280 | my $ccline = ""; |
1281 | if ($cc ne '') { | |
1282 | $ccline = "\nCc: $cc"; | |
1283 | } | |
4f3d3703 | 1284 | make_message_id() unless defined($message_id); |
aeb59328 | 1285 | |
da18759e | 1286 | my $header = "From: $sender |
f06a6a49 | 1287 | To: $to${ccline} |
4bc87a28 | 1288 | Subject: $subject |
4bc87a28 EW |
1289 | Date: $date |
1290 | Message-Id: $message_id | |
4bc87a28 | 1291 | "; |
ac1596a6 LH |
1292 | if ($use_xmailer) { |
1293 | $header .= "X-Mailer: git-send-email $gitversion\n"; | |
1294 | } | |
3e0c4ffd | 1295 | if ($reply_to) { |
7ccf7927 RA |
1296 | |
1297 | $header .= "In-Reply-To: $reply_to\n"; | |
1298 | $header .= "References: $references\n"; | |
1299 | } | |
ce91c2f6 JH |
1300 | if (@xh) { |
1301 | $header .= join("\n", @xh) . "\n"; | |
1302 | } | |
4bc87a28 | 1303 | |
c38f0247 | 1304 | my @sendmail_parameters = ('-i', @recipients); |
da18759e | 1305 | my $raw_from = $sender; |
c89e3241 FC |
1306 | if (defined $envelope_sender && $envelope_sender ne "auto") { |
1307 | $raw_from = $envelope_sender; | |
1308 | } | |
f073a592 RJ |
1309 | $raw_from = extract_valid_address($raw_from); |
1310 | unshift (@sendmail_parameters, | |
1311 | '-f', $raw_from) if(defined $envelope_sender); | |
8e3d436b | 1312 | |
c1f2aa45 JS |
1313 | if ($needs_confirm && !$dry_run) { |
1314 | print "\n$header\n"; | |
1315 | if ($needs_confirm eq "inform") { | |
1316 | $confirm_unconfigured = 0; # squelch this message for the rest of this run | |
6e182518 | 1317 | $ask_default = "y"; # assume yes on EOF since user hasn't explicitly asked for confirmation |
a4dde4c4 VA |
1318 | print __ <<EOF ; |
1319 | The Cc list above has been expanded by additional | |
1320 | addresses found in the patch commit message. By default | |
1321 | send-email prompts before sending whenever this occurs. | |
1322 | This behavior is controlled by the sendemail.confirm | |
1323 | configuration setting. | |
1324 | ||
1325 | For additional information, run 'git send-email --help'. | |
1326 | To retain the current behavior, but squelch this message, | |
1327 | run 'git config --global sendemail.confirm auto'. | |
1328 | ||
1329 | EOF | |
c1f2aa45 | 1330 | } |
a4dde4c4 VA |
1331 | # TRANSLATORS: Make sure to include [y] [n] [q] [a] in your |
1332 | # translation. The program will only accept English input | |
1333 | # at this point. | |
1334 | $_ = ask(__("Send this email? ([y]es|[n]o|[q]uit|[a]ll): "), | |
6e182518 JS |
1335 | valid_re => qr/^(?:yes|y|no|n|quit|q|all|a)/i, |
1336 | default => $ask_default); | |
46493105 | 1337 | die __("Send this email reply required") unless defined $_; |
c1f2aa45 | 1338 | if (/^n/i) { |
15da1084 | 1339 | return 0; |
c1f2aa45 JS |
1340 | } elsif (/^q/i) { |
1341 | cleanup_compose_files(); | |
1342 | exit(0); | |
1343 | } elsif (/^a/i) { | |
1344 | $confirm = 'never'; | |
1345 | } | |
1346 | } | |
1347 | ||
052fbea2 PO |
1348 | unshift (@sendmail_parameters, @smtp_server_options); |
1349 | ||
6130259c MW |
1350 | if ($dry_run) { |
1351 | # We don't want to send the email. | |
cb005c1f | 1352 | } elsif (file_name_is_absolute($smtp_server)) { |
aca7ad76 EW |
1353 | my $pid = open my $sm, '|-'; |
1354 | defined $pid or die $!; | |
1355 | if (!$pid) { | |
8e3d436b | 1356 | exec($smtp_server, @sendmail_parameters) or die $!; |
aca7ad76 EW |
1357 | } |
1358 | print $sm "$header\n$message"; | |
5e2c2ab1 | 1359 | close $sm or die $!; |
aca7ad76 | 1360 | } else { |
44b2476a JH |
1361 | |
1362 | if (!defined $smtp_server) { | |
46493105 | 1363 | die __("The required SMTP server is not properly defined.") |
44b2476a JH |
1364 | } |
1365 | ||
f6bebd12 | 1366 | if ($smtp_encryption eq 'ssl') { |
44b2476a | 1367 | $smtp_server_port ||= 465; # ssmtp |
34cc60ce | 1368 | require Net::SMTP::SSL; |
69cf7bfd | 1369 | $smtp_domain ||= maildomain(); |
5508f3ed | 1370 | require IO::Socket::SSL; |
9d605249 JK |
1371 | |
1372 | # Suppress "variable accessed once" warning. | |
1373 | { | |
1374 | no warnings 'once'; | |
1375 | $IO::Socket::SSL::DEBUG = 1; | |
1376 | } | |
1377 | ||
5508f3ed TR |
1378 | # Net::SMTP::SSL->new() does not forward any SSL options |
1379 | IO::Socket::SSL::set_client_defaults( | |
1380 | ssl_verify_params()); | |
134550fe | 1381 | $smtp ||= Net::SMTP::SSL->new($smtp_server, |
69cf7bfd | 1382 | Hello => $smtp_domain, |
35035bbf | 1383 | Port => $smtp_server_port, |
5508f3ed | 1384 | Debug => $debug_net_smtp); |
34cc60ce DS |
1385 | } |
1386 | else { | |
1387 | require Net::SMTP; | |
69cf7bfd | 1388 | $smtp_domain ||= maildomain(); |
1a741bf7 | 1389 | $smtp_server_port ||= 25; |
1390 | $smtp ||= Net::SMTP->new($smtp_server, | |
69cf7bfd | 1391 | Hello => $smtp_domain, |
1a741bf7 | 1392 | Debug => $debug_net_smtp, |
1393 | Port => $smtp_server_port); | |
fb3650ed | 1394 | if ($smtp_encryption eq 'tls' && $smtp) { |
f6bebd12 TR |
1395 | require Net::SMTP::SSL; |
1396 | $smtp->command('STARTTLS'); | |
1397 | $smtp->response(); | |
1398 | if ($smtp->code == 220) { | |
35035bbf RR |
1399 | $smtp = Net::SMTP::SSL->start_SSL($smtp, |
1400 | ssl_verify_params()) | |
6cb0c883 | 1401 | or die "STARTTLS failed! ".IO::Socket::SSL::errstr(); |
6cbf8b00 | 1402 | $smtp_encryption = ''; |
9d1ccf5e RS |
1403 | # Send EHLO again to receive fresh |
1404 | # supported commands | |
155b940f | 1405 | $smtp->hello($smtp_domain); |
f6bebd12 | 1406 | } else { |
3c5cd20c | 1407 | die sprintf(__("Server does not support STARTTLS! %s"), $smtp->message); |
f6bebd12 TR |
1408 | } |
1409 | } | |
44b2476a JH |
1410 | } |
1411 | ||
1412 | if (!$smtp) { | |
3c5cd20c VA |
1413 | die __("Unable to initialize SMTP properly. Check config and use --smtp-debug."), |
1414 | " VALUES: server=$smtp_server ", | |
e5afb3a6 | 1415 | "encryption=$smtp_encryption ", |
69cf7bfd | 1416 | "hello=$smtp_domain", |
a1dd7e16 | 1417 | defined $smtp_server_port ? " port=$smtp_server_port" : ""; |
44b2476a JH |
1418 | } |
1419 | ||
4d31a44a | 1420 | smtp_auth_maybe or die $smtp->message; |
2363d746 | 1421 | |
2b69bfc2 | 1422 | $smtp->mail( $raw_from ) or die $smtp->message; |
aca7ad76 EW |
1423 | $smtp->to( @recipients ) or die $smtp->message; |
1424 | $smtp->data or die $smtp->message; | |
f60c483d SA |
1425 | $smtp->datasend("$header\n") or die $smtp->message; |
1426 | my @lines = split /^/, $message; | |
1427 | foreach my $line (@lines) { | |
1428 | $smtp->datasend("$line") or die $smtp->message; | |
1429 | } | |
aca7ad76 | 1430 | $smtp->dataend() or die $smtp->message; |
3c5cd20c | 1431 | $smtp->code =~ /250|200/ or die sprintf(__("Failed to send %s\n"), $subject).$smtp->message; |
aca7ad76 | 1432 | } |
2718435b | 1433 | if ($quiet) { |
3c5cd20c | 1434 | printf($dry_run ? __("Dry-Sent %s\n") : __("Sent %s\n"), $subject); |
2718435b | 1435 | } else { |
a4dde4c4 | 1436 | print($dry_run ? __("Dry-OK. Log says:\n") : __("OK. Log says:\n")); |
cb005c1f | 1437 | if (!file_name_is_absolute($smtp_server)) { |
aca7ad76 | 1438 | print "Server: $smtp_server\n"; |
2b69bfc2 | 1439 | print "MAIL FROM:<$raw_from>\n"; |
02461e0e JP |
1440 | foreach my $entry (@recipients) { |
1441 | print "RCPT TO:<$entry>\n"; | |
1442 | } | |
aca7ad76 | 1443 | } else { |
8e3d436b | 1444 | print "Sendmail: $smtp_server ".join(' ',@sendmail_parameters)."\n"; |
aca7ad76 | 1445 | } |
b7f30e0a | 1446 | print $header, "\n"; |
aca7ad76 | 1447 | if ($smtp) { |
46493105 | 1448 | print __("Result: "), $smtp->code, ' ', |
aca7ad76 EW |
1449 | ($smtp->message =~ /\n([^\n]+\n)$/s), "\n"; |
1450 | } else { | |
46493105 | 1451 | print __("Result: OK\n"); |
aca7ad76 | 1452 | } |
30d08b34 | 1453 | } |
15da1084 MW |
1454 | |
1455 | return 1; | |
83b24437 RA |
1456 | } |
1457 | ||
83b24437 | 1458 | $reply_to = $initial_reply_to; |
2186d566 | 1459 | $references = $initial_reply_to || ''; |
83b24437 | 1460 | $subject = $initial_subject; |
c1f2aa45 | 1461 | $message_num = 0; |
83b24437 RA |
1462 | |
1463 | foreach my $t (@files) { | |
3c5cd20c | 1464 | open my $fh, "<", $t or die sprintf(__("can't open file %s"), $t); |
83b24437 | 1465 | |
94638f89 | 1466 | my $author = undef; |
4cb46bdd | 1467 | my $sauthor = undef; |
8291db6f JK |
1468 | my $author_encoding; |
1469 | my $has_content_type; | |
1470 | my $body_encoding; | |
bb29456c PB |
1471 | my $xfer_encoding; |
1472 | my $has_mime_version; | |
3c3bb51c | 1473 | @to = (); |
c1f2aa45 | 1474 | @cc = (); |
ce91c2f6 | 1475 | @xh = (); |
e6b0964a | 1476 | my $input_format = undef; |
5012699d | 1477 | my @header = (); |
83b24437 | 1478 | $message = ""; |
c1f2aa45 | 1479 | $message_num++; |
5012699d | 1480 | # First unfold multiline header fields |
f9237e61 | 1481 | while(<$fh>) { |
5012699d JS |
1482 | last if /^\s*$/; |
1483 | if (/^\s+\S/ and @header) { | |
1484 | chomp($header[$#header]); | |
1485 | s/^\s+/ /; | |
1486 | $header[$#header] .= $_; | |
1487 | } else { | |
1488 | push(@header, $_); | |
1489 | } | |
1490 | } | |
1491 | # Now parse the header | |
1492 | foreach(@header) { | |
1493 | if (/^From /) { | |
1494 | $input_format = 'mbox'; | |
1495 | next; | |
1496 | } | |
1497 | chomp; | |
1498 | if (!defined $input_format && /^[-A-Za-z]+:\s/) { | |
1499 | $input_format = 'mbox'; | |
1500 | } | |
1501 | ||
1502 | if (defined $input_format && $input_format eq 'mbox') { | |
6310071a | 1503 | if (/^Subject:\s+(.*)$/i) { |
5012699d | 1504 | $subject = $1; |
e6b0964a | 1505 | } |
6310071a | 1506 | elsif (/^From:\s+(.*)$/i) { |
5012699d | 1507 | ($author, $author_encoding) = unquote_rfc2047($1); |
4cb46bdd | 1508 | $sauthor = sanitize_address($author); |
5012699d | 1509 | next if $suppress_cc{'author'}; |
da18759e | 1510 | next if $suppress_cc{'self'} and $sauthor eq $sender; |
a4dde4c4 | 1511 | printf(__("(mbox) Adding cc: %s from line '%s'\n"), |
5012699d JS |
1512 | $1, $_) unless $quiet; |
1513 | push @cc, $1; | |
e6b0964a | 1514 | } |
6310071a | 1515 | elsif (/^To:\s+(.*)$/i) { |
21802cd3 | 1516 | foreach my $addr (parse_address_line($1)) { |
a4dde4c4 | 1517 | printf(__("(mbox) Adding to: %s from line '%s'\n"), |
21802cd3 | 1518 | $addr, $_) unless $quiet; |
e4312255 | 1519 | push @to, $addr; |
21802cd3 SB |
1520 | } |
1521 | } | |
6310071a | 1522 | elsif (/^Cc:\s+(.*)$/i) { |
5012699d | 1523 | foreach my $addr (parse_address_line($1)) { |
da18759e MT |
1524 | my $qaddr = unquote_rfc2047($addr); |
1525 | my $saddr = sanitize_address($qaddr); | |
1526 | if ($saddr eq $sender) { | |
65648283 | 1527 | next if ($suppress_cc{'self'}); |
65648283 DB |
1528 | } else { |
1529 | next if ($suppress_cc{'cc'}); | |
8a8e6235 | 1530 | } |
a4dde4c4 | 1531 | printf(__("(mbox) Adding cc: %s from line '%s'\n"), |
5012699d JS |
1532 | $addr, $_) unless $quiet; |
1533 | push @cc, $addr; | |
83b24437 | 1534 | } |
5012699d JS |
1535 | } |
1536 | elsif (/^Content-type:/i) { | |
1537 | $has_content_type = 1; | |
1538 | if (/charset="?([^ "]+)/) { | |
1539 | $body_encoding = $1; | |
83b24437 | 1540 | } |
5012699d | 1541 | push @xh, $_; |
83b24437 | 1542 | } |
bb29456c PB |
1543 | elsif (/^MIME-Version/i) { |
1544 | $has_mime_version = 1; | |
1545 | push @xh, $_; | |
1546 | } | |
5012699d JS |
1547 | elsif (/^Message-Id: (.*)/i) { |
1548 | $message_id = $1; | |
83b24437 | 1549 | } |
bb29456c PB |
1550 | elsif (/^Content-Transfer-Encoding: (.*)/i) { |
1551 | $xfer_encoding = $1 if not defined $xfer_encoding; | |
1552 | } | |
6310071a | 1553 | elsif (!/^Date:\s/i && /^[-A-Za-z]+:\s+\S/) { |
5012699d JS |
1554 | push @xh, $_; |
1555 | } | |
1556 | ||
83b24437 | 1557 | } else { |
5012699d JS |
1558 | # In the traditional |
1559 | # "send lots of email" format, | |
1560 | # line 1 = cc | |
1561 | # line 2 = subject | |
1562 | # So let's support that, too. | |
1563 | $input_format = 'lots'; | |
1564 | if (@cc == 0 && !$suppress_cc{'cc'}) { | |
a4dde4c4 | 1565 | printf(__("(non-mbox) Adding cc: %s from line '%s'\n"), |
5012699d JS |
1566 | $_, $_) unless $quiet; |
1567 | push @cc, $_; | |
1568 | } elsif (!defined $subject) { | |
1569 | $subject = $_; | |
83b24437 RA |
1570 | } |
1571 | } | |
1572 | } | |
5012699d | 1573 | # Now parse the message body |
f9237e61 | 1574 | while(<$fh>) { |
5012699d | 1575 | $message .= $_; |
9d334396 | 1576 | if (/^(Signed-off-by|Cc): ([^>]*>?)/i) { |
5012699d | 1577 | chomp; |
3531e270 | 1578 | my ($what, $c) = ($1, $2); |
5012699d | 1579 | chomp $c; |
da18759e MT |
1580 | my $sc = sanitize_address($c); |
1581 | if ($sc eq $sender) { | |
3531e270 JS |
1582 | next if ($suppress_cc{'self'}); |
1583 | } else { | |
1584 | next if $suppress_cc{'sob'} and $what =~ /Signed-off-by/i; | |
1585 | next if $suppress_cc{'bodycc'} and $what =~ /Cc/i; | |
1586 | } | |
5012699d | 1587 | push @cc, $c; |
a4dde4c4 | 1588 | printf(__("(body) Adding cc: %s from line '%s'\n"), |
5012699d JS |
1589 | $c, $_) unless $quiet; |
1590 | } | |
1591 | } | |
f9237e61 | 1592 | close $fh; |
324a8bd0 | 1593 | |
6e74e075 JP |
1594 | push @to, recipients_cmd("to-cmd", "to", $to_cmd, $t) |
1595 | if defined $to_cmd; | |
1596 | push @cc, recipients_cmd("cc-cmd", "cc", $cc_cmd, $t) | |
1597 | if defined $cc_cmd && !$suppress_cc{'cccmd'}; | |
324a8bd0 | 1598 | |
3cae7e5b | 1599 | if ($broken_encoding{$t} && !$has_content_type) { |
bb29456c | 1600 | $xfer_encoding = '8bit' if not defined $xfer_encoding; |
3cae7e5b | 1601 | $has_content_type = 1; |
bb29456c | 1602 | push @xh, "Content-Type: text/plain; charset=$auto_8bit_encoding"; |
3cae7e5b TR |
1603 | $body_encoding = $auto_8bit_encoding; |
1604 | } | |
1605 | ||
ce547800 KM |
1606 | if ($broken_encoding{$t} && !is_rfc2047_quoted($subject)) { |
1607 | $subject = quote_subject($subject, $auto_8bit_encoding); | |
3cae7e5b TR |
1608 | } |
1609 | ||
4cb46bdd | 1610 | if (defined $sauthor and $sauthor ne $sender) { |
94638f89 | 1611 | $message = "From: $author\n\n$message"; |
8291db6f JK |
1612 | if (defined $author_encoding) { |
1613 | if ($has_content_type) { | |
1614 | if ($body_encoding eq $author_encoding) { | |
1615 | # ok, we already have the right encoding | |
1616 | } | |
1617 | else { | |
1618 | # uh oh, we should re-encode | |
1619 | } | |
1620 | } | |
1621 | else { | |
bb29456c | 1622 | $xfer_encoding = '8bit' if not defined $xfer_encoding; |
3cae7e5b | 1623 | $has_content_type = 1; |
8291db6f | 1624 | push @xh, |
bb29456c | 1625 | "Content-Type: text/plain; charset=$author_encoding"; |
8291db6f JK |
1626 | } |
1627 | } | |
8a8e6235 | 1628 | } |
8d814084 PB |
1629 | if (defined $target_xfer_encoding) { |
1630 | $xfer_encoding = '8bit' if not defined $xfer_encoding; | |
1631 | $message = apply_transfer_encoding( | |
1632 | $message, $xfer_encoding, $target_xfer_encoding); | |
1633 | $xfer_encoding = $target_xfer_encoding; | |
1634 | } | |
bb29456c PB |
1635 | if (defined $xfer_encoding) { |
1636 | push @xh, "Content-Transfer-Encoding: $xfer_encoding"; | |
1637 | } | |
1638 | if (defined $xfer_encoding or $has_content_type) { | |
1639 | unshift @xh, 'MIME-Version: 1.0' unless $has_mime_version; | |
1640 | } | |
83b24437 | 1641 | |
c1f2aa45 JS |
1642 | $needs_confirm = ( |
1643 | $confirm eq "always" or | |
1644 | ($confirm =~ /^(?:auto|cc)$/ && @cc) or | |
1645 | ($confirm =~ /^(?:auto|compose)$/ && $compose && $message_num == 1)); | |
1646 | $needs_confirm = "inform" if ($needs_confirm && $confirm_unconfigured && @cc); | |
1647 | ||
b5e112d8 RL |
1648 | @to = process_address_list(@to); |
1649 | @cc = process_address_list(@cc); | |
e4312255 | 1650 | |
3c3bb51c | 1651 | @to = (@initial_to, @to); |
c1f2aa45 JS |
1652 | @cc = (@initial_cc, @cc); |
1653 | ||
f515c904 MT |
1654 | if ($message_num == 1) { |
1655 | if (defined $cover_cc and $cover_cc) { | |
1656 | @initial_cc = @cc; | |
1657 | } | |
1658 | if (defined $cover_to and $cover_to) { | |
1659 | @initial_to = @to; | |
1660 | } | |
1661 | } | |
1662 | ||
15da1084 | 1663 | my $message_was_sent = send_message(); |
83b24437 RA |
1664 | |
1665 | # set up for the next message | |
95a877a3 | 1666 | if ($thread && $message_was_sent && |
b99d22f2 | 1667 | ($chain_reply_to || !defined $reply_to || length($reply_to) == 0 || |
db54c8e7 | 1668 | $message_num == 1)) { |
78488b2c | 1669 | $reply_to = $message_id; |
7ccf7927 | 1670 | if (length $references > 0) { |
a925b89c | 1671 | $references .= "\n $message_id"; |
7ccf7927 RA |
1672 | } else { |
1673 | $references = "$message_id"; | |
1674 | } | |
78488b2c | 1675 | } |
4f3d3703 | 1676 | $message_id = undef; |
5453b83b | 1677 | $num_sent++; |
1678 | if (defined $batch_size && $num_sent == $batch_size) { | |
1679 | $num_sent = 0; | |
1680 | $smtp->quit if defined $smtp; | |
1681 | undef $smtp; | |
1682 | undef $auth; | |
1683 | sleep($relogin_delay) if defined $relogin_delay; | |
1684 | } | |
83b24437 | 1685 | } |
e205735d | 1686 | |
6e74e075 JP |
1687 | # Execute a command (e.g. $to_cmd) to get a list of email addresses |
1688 | # and return a results array | |
1689 | sub recipients_cmd { | |
1690 | my ($prefix, $what, $cmd, $file) = @_; | |
1691 | ||
6e74e075 | 1692 | my @addresses = (); |
a47eab03 | 1693 | open my $fh, "-|", "$cmd \Q$file\E" |
3c5cd20c | 1694 | or die sprintf(__("(%s) Could not execute '%s'"), $prefix, $cmd); |
7ebee441 | 1695 | while (my $address = <$fh>) { |
6e74e075 JP |
1696 | $address =~ s/^\s*//g; |
1697 | $address =~ s/\s*$//g; | |
1698 | $address = sanitize_address($address); | |
da18759e | 1699 | next if ($address eq $sender and $suppress_cc{'self'}); |
6e74e075 | 1700 | push @addresses, $address; |
3c5cd20c VA |
1701 | printf(__("(%s) Adding %s: %s from: '%s'\n"), |
1702 | $prefix, $what, $address, $cmd) unless $quiet; | |
6e74e075 | 1703 | } |
7ebee441 | 1704 | close $fh |
3c5cd20c | 1705 | or die sprintf(__("(%s) failed to close pipe to '%s'"), $prefix, $cmd); |
6e74e075 JP |
1706 | return @addresses; |
1707 | } | |
1708 | ||
c1f2aa45 | 1709 | cleanup_compose_files(); |
1f038a0c | 1710 | |
4bf597ee | 1711 | sub cleanup_compose_files { |
c1f2aa45 | 1712 | unlink($compose_filename, $compose_filename . ".final") if $compose; |
1f038a0c RA |
1713 | } |
1714 | ||
4bc87a28 | 1715 | $smtp->quit if $smtp; |
e205735d | 1716 | |
8d814084 PB |
1717 | sub apply_transfer_encoding { |
1718 | my $message = shift; | |
1719 | my $from = shift; | |
1720 | my $to = shift; | |
1721 | ||
1722 | return $message if ($from eq $to and $from ne '7bit'); | |
1723 | ||
1724 | require MIME::QuotedPrint; | |
1725 | require MIME::Base64; | |
1726 | ||
1727 | $message = MIME::QuotedPrint::decode($message) | |
1728 | if ($from eq 'quoted-printable'); | |
1729 | $message = MIME::Base64::decode($message) | |
1730 | if ($from eq 'base64'); | |
1731 | ||
46493105 | 1732 | die __("cannot send message as 7bit") |
8d814084 PB |
1733 | if ($to eq '7bit' and $message =~ /[^[:ascii:]]/); |
1734 | return $message | |
1735 | if ($to eq '7bit' or $to eq '8bit'); | |
1736 | return MIME::QuotedPrint::encode($message, "\n", 0) | |
1737 | if ($to eq 'quoted-printable'); | |
1738 | return MIME::Base64::encode($message, "\n") | |
1739 | if ($to eq 'base64'); | |
46493105 | 1740 | die __("invalid transfer encoding"); |
8d814084 PB |
1741 | } |
1742 | ||
c438ea2a | 1743 | sub unique_email_list { |
e205735d RA |
1744 | my %seen; |
1745 | my @emails; | |
1746 | ||
1747 | foreach my $entry (@_) { | |
e4312255 KM |
1748 | my $clean = extract_valid_address_or_die($entry); |
1749 | $seen{$clean} ||= 0; | |
1750 | next if $seen{$clean}++; | |
1751 | push @emails, $entry; | |
e205735d RA |
1752 | } |
1753 | return @emails; | |
1754 | } | |
747bbff9 JK |
1755 | |
1756 | sub validate_patch { | |
1757 | my $fn = shift; | |
1758 | open(my $fh, '<', $fn) | |
3c5cd20c | 1759 | or die sprintf(__("unable to open %s: %s\n"), $fn, $!); |
747bbff9 JK |
1760 | while (my $line = <$fh>) { |
1761 | if (length($line) > 998) { | |
3c5cd20c | 1762 | return sprintf(__("%s: patch contains a line longer than 998 characters"), $.); |
747bbff9 JK |
1763 | } |
1764 | } | |
622bc930 | 1765 | return; |
747bbff9 | 1766 | } |
0706bd19 | 1767 | |
531220ba JH |
1768 | sub handle_backup { |
1769 | my ($last, $lastlen, $file, $known_suffix) = @_; | |
1770 | my ($suffix, $skip); | |
1771 | ||
1772 | $skip = 0; | |
1773 | if (defined $last && | |
1774 | ($lastlen < length($file)) && | |
1775 | (substr($file, 0, $lastlen) eq $last) && | |
1776 | ($suffix = substr($file, $lastlen)) !~ /^[a-z0-9]/i) { | |
1777 | if (defined $known_suffix && $suffix eq $known_suffix) { | |
3c5cd20c | 1778 | printf(__("Skipping %s with backup suffix '%s'.\n"), $file, $known_suffix); |
531220ba JH |
1779 | $skip = 1; |
1780 | } else { | |
3c5cd20c VA |
1781 | # TRANSLATORS: please keep "[y|N]" as is. |
1782 | my $answer = ask(sprintf(__("Do you really want to send %s? [y|N]: "), $file), | |
531220ba JH |
1783 | valid_re => qr/^(?:y|n)/i, |
1784 | default => 'n'); | |
1785 | $skip = ($answer ne 'y'); | |
1786 | if ($skip) { | |
1787 | $known_suffix = $suffix; | |
1788 | } | |
1789 | } | |
1790 | } | |
1791 | return ($skip, $known_suffix); | |
1792 | } | |
1793 | ||
1794 | sub handle_backup_files { | |
1795 | my @file = @_; | |
1796 | my ($last, $lastlen, $known_suffix, $skip, @result); | |
1797 | for my $file (@file) { | |
1798 | ($skip, $known_suffix) = handle_backup($last, $lastlen, | |
1799 | $file, $known_suffix); | |
1800 | push @result, $file unless $skip; | |
1801 | $last = $file; | |
1802 | $lastlen = length($file); | |
1803 | } | |
1804 | return @result; | |
1805 | } | |
1806 | ||
0706bd19 JK |
1807 | sub file_has_nonascii { |
1808 | my $fn = shift; | |
1809 | open(my $fh, '<', $fn) | |
3c5cd20c | 1810 | or die sprintf(__("unable to open %s: %s\n"), $fn, $!); |
0706bd19 JK |
1811 | while (my $line = <$fh>) { |
1812 | return 1 if $line =~ /[^[:ascii:]]/; | |
1813 | } | |
1814 | return 0; | |
1815 | } | |
3cae7e5b TR |
1816 | |
1817 | sub body_or_subject_has_nonascii { | |
1818 | my $fn = shift; | |
1819 | open(my $fh, '<', $fn) | |
3c5cd20c | 1820 | or die sprintf(__("unable to open %s: %s\n"), $fn, $!); |
3cae7e5b TR |
1821 | while (my $line = <$fh>) { |
1822 | last if $line =~ /^$/; | |
1823 | return 1 if $line =~ /^Subject.*[^[:ascii:]]/; | |
1824 | } | |
1825 | while (my $line = <$fh>) { | |
1826 | return 1 if $line =~ /[^[:ascii:]]/; | |
1827 | } | |
1828 | return 0; | |
1829 | } |