3 # Copyright 2002,2005 Greg Kroah-Hartman <greg@kroah.com>
4 # Copyright 2005 Ryan Anderson <ryan@michonline.com>
8 # Ported to support git "mbox" format files by Ryan Anderson <ryan@michonline.com>
10 # Sends a collection of emails to the given email addresses, disturbingly fast.
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:
15 # first line of the message is who to CC,
16 # and second line is the subject of the message.
21 use warnings
$ENV{GIT_PERL_FATAL_WARNINGS
} ?
qw(FATAL all) : ();
23 use Git
::LoadCPAN
::Error
qw(:try);
27 Getopt
::Long
::Configure qw
/ pass_through /;
31 my ($class, $reason) = @_;
32 return bless \
$reason, shift;
36 die "Cannot use readline on FakeTerm: $$self";
43 git send-email' [<options>] <file|directory>
44 git send-email' [<options>] <format-patch options>
45 git send-email --dump-aliases
48 --from <str> * Email From:
49 --[no-]to <str> * Email To:
50 --[no-]cc <str> * Email Cc:
51 --[no-]bcc <str> * Email Bcc:
52 --subject <str> * Email "Subject:"
53 --reply-to <str> * Email "Reply-To:"
54 --in-reply-to <str> * Email "In-Reply-To:"
55 --[no-]xmailer * Add "X-Mailer:" header (default).
56 --[no-]annotate * Review each patch that will be sent in an editor.
57 --compose * Open an editor for introduction.
58 --compose-encoding <str> * Encoding to assume for introduction.
59 --8bit-encoding <str> * Encoding to assume 8bit mails if undeclared
60 --transfer-encoding <str> * Transfer encoding to use (quoted-printable, 8bit, base64)
63 --envelope-sender <str> * Email envelope sender.
64 --sendmail-cmd <str> * Command to run to send email.
65 --smtp-server <str:int> * Outgoing SMTP server to use. The port
66 is optional. Default 'localhost'.
67 --smtp-server-option <str> * Outgoing SMTP server option to use.
68 --smtp-server-port <int> * Outgoing SMTP server port.
69 --smtp-user <str> * Username for SMTP-AUTH.
70 --smtp-pass <str> * Password for SMTP-AUTH; not necessary.
71 --smtp-encryption <str> * tls or ssl; anything else disables.
72 --smtp-ssl * Deprecated. Use '--smtp-encryption ssl'.
73 --smtp-ssl-cert-path <str> * Path to ca-certificates (either directory or file).
74 Pass an empty string to disable certificate
76 --smtp-domain <str> * The domain name sent to HELO/EHLO handshake
77 --smtp-auth <str> * Space-separated list of allowed AUTH mechanisms, or
78 "none" to disable authentication.
79 This setting forces to use one of the listed mechanisms.
80 --no-smtp-auth Disable SMTP authentication. Shorthand for
82 --smtp-debug <0|1> * Disable, enable Net::SMTP debug.
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
89 --identity <str> * Use the sendemail.<id> options.
90 --to-cmd <str> * Email To: via `<str> \$patch_path`.
91 --cc-cmd <str> * Email Cc: via `<str> \$patch_path`.
92 --header-cmd <str> * Add headers via `<str> \$patch_path`.
93 --no-header-cmd * Disable any header command in use.
94 --suppress-cc <str> * author, self, sob, cc, cccmd, body, bodycc, misc-by, all.
95 --[no-]cc-cover * Email Cc: addresses in the cover letter.
96 --[no-]to-cover * Email To: addresses in the cover letter.
97 --[no-]signed-off-by-cc * Send to Signed-off-by: addresses. Default on.
98 --[no-]suppress-from * Send to self. Default off.
99 --[no-]chain-reply-to * Chain In-Reply-To: fields. Default off.
100 --[no-]thread * Use In-Reply-To: field. Default on.
103 --confirm <str> * Confirm recipients before sending;
104 auto, cc, compose, always, or never.
105 --quiet * Output one line of info per email.
106 --dry-run * Don't actually send the emails.
107 --[no-]validate * Perform patch sanity checks. Default on.
108 --[no-]format-patch * understand any non optional arguments as
109 `git format-patch` ones.
110 --force * Send even if safety checks would prevent it.
113 --dump-aliases * Dump configured aliases and exit.
121 grep !$seen{$_}++, @_;
124 sub completion_helper
{
125 my ($original_opts) = @_;
126 my %not_for_completion = (
127 "git-completion-helper" => undef,
130 my @send_email_opts = ();
132 foreach my $key (keys %$original_opts) {
133 unless (exists $not_for_completion{$key}) {
136 if ($key =~ /[:=][si]$/) {
137 $key =~ s/[:=][si]$//;
138 push (@send_email_opts, "--$_=") foreach (split (/\|/, $key));
140 push (@send_email_opts, "--$_") foreach (split (/\|/, $key));
145 my @format_patch_opts = split(/ /, Git
::command
('format-patch', '--git-completion-helper'));
146 my @opts = (@send_email_opts, @format_patch_opts);
147 @opts = uniq
(grep !/^$/, @opts);
148 # There's an implicit '\n' here already, no need to add an explicit one.
153 # most mail servers generate the Date: header, but not all...
154 sub format_2822_time
{
156 my @localtm = localtime($time);
157 my @gmttm = gmtime($time);
158 my $localmin = $localtm[1] + $localtm[2] * 60;
159 my $gmtmin = $gmttm[1] + $gmttm[2] * 60;
160 if ($localtm[0] != $gmttm[0]) {
161 die __
("local zone differs from GMT by a non-minute interval\n");
163 if ((($gmttm[6] + 1) % 7) == $localtm[6]) {
165 } elsif ((($gmttm[6] - 1) % 7) == $localtm[6]) {
167 } elsif ($gmttm[6] != $localtm[6]) {
168 die __
("local time offset greater than or equal to 24 hours\n");
170 my $offset = $localmin - $gmtmin;
171 my $offhour = $offset / 60;
172 my $offmin = abs($offset % 60);
173 if (abs($offhour) >= 24) {
174 die __
("local time offset greater than or equal to 24 hours\n");
177 return sprintf("%s, %2d %s %d %02d:%02d:%02d %s%02d%02d",
178 qw(Sun Mon Tue Wed Thu Fri Sat)[$localtm[6]],
180 qw(Jan Feb Mar Apr May Jun
181 Jul Aug Sep Oct Nov Dec)[$localtm[4]],
186 ($offset >= 0) ?
'+' : '-',
196 # Regexes for RFC 2047 productions.
197 my $re_token = qr/[^][()<>@,;:\\"\/?
.= \000-\037\177-\377]+/;
198 my $re_encoded_text = qr/[^? \000-\037\177-\377]+/;
199 my $re_encoded_word = qr/=\?($re_token)\?($re_token)\?($re_encoded_text)\?=/;
201 # Variables we fill in automatically, or via prompting:
202 my (@to,@cc,@xh,$envelope_sender,
203 $initial_in_reply_to,$reply_to,$initial_subject,@files,
204 $author,$sender,$smtp_authpass,$annotate,$compose,$time);
205 # Things we either get from config, *or* are overridden on the
207 my ($no_cc, $no_to, $no_bcc, $no_identity, $no_header_cmd);
208 my (@config_to, @getopt_to);
209 my (@config_cc, @getopt_cc);
210 my (@config_bcc, @getopt_bcc);
213 #$initial_in_reply_to = ''; #<20050203173208.GA23964@foobar.com>';
215 my $repo = eval { Git
->repository() };
216 my @repo = $repo ?
($repo) : ();
218 # Behavior modification variables
219 my ($quiet, $dry_run) = (0, 0);
221 my $compose_filename;
223 my $dump_aliases = 0;
225 # Variables to prevent short format-patch options from being captured
226 # as abbreviated send-email options
229 # Handle interactive edition of files.
234 my ($args, $msg, $cmd_name) = @_;
236 my $signalled = $?
& 127;
237 my $exit_code = $?
>> 8;
238 return unless $signalled or $exit_code;
240 my @sprintf_args = ($cmd_name ?
$cmd_name : $args->[0], $exit_code);
242 # Quiet the 'redundant' warning category, except we
243 # need to support down to Perl 5.8, so we can't do a
244 # "no warnings 'redundant'", since that category was
245 # introduced in perl 5.22, and asking for it will die
248 return sprintf($msg, @sprintf_args);
250 return sprintf(__
("fatal: command '%s' died with exit code %d"),
255 my $msg = system_or_msg
(@_);
260 if (!defined($editor)) {
261 $editor = Git
::command_oneline
('var', 'GIT_EDITOR');
263 my $die_msg = __
("the editor exited uncleanly, aborting everything");
264 if (defined($multiedit) && !$multiedit) {
265 system_or_die
(['sh', '-c', $editor.' "$@"', $editor, $_], $die_msg) for @_;
267 system_or_die
(['sh', '-c', $editor.' "$@"', $editor, @_], $die_msg);
271 # Variables with corresponding config settings
272 my ($suppress_from, $signed_off_by_cc);
273 my ($cover_cc, $cover_to);
274 my ($to_cmd, $cc_cmd, $header_cmd);
275 my ($smtp_server, $smtp_server_port, @smtp_server_options);
276 my ($smtp_authuser, $smtp_encryption, $smtp_ssl_cert_path);
277 my ($batch_size, $relogin_delay);
278 my ($identity, $aliasfiletype, @alias_files, $smtp_domain, $smtp_auth);
281 my ($auto_8bit_encoding);
282 my ($compose_encoding);
284 # Variables with corresponding config settings & hardcoded defaults
285 my ($debug_net_smtp) = 0; # Net::SMTP, see send_message()
287 my $chain_reply_to = 0;
290 my $target_xfer_encoding = 'auto';
291 my $forbid_sendmail_variables = 1;
293 my %config_bool_settings = (
294 "thread" => \
$thread,
295 "chainreplyto" => \
$chain_reply_to,
296 "suppressfrom" => \
$suppress_from,
297 "signedoffbycc" => \
$signed_off_by_cc,
298 "cccover" => \
$cover_cc,
299 "tocover" => \
$cover_to,
300 "signedoffcc" => \
$signed_off_by_cc,
301 "validate" => \
$validate,
302 "multiedit" => \
$multiedit,
303 "annotate" => \
$annotate,
304 "xmailer" => \
$use_xmailer,
305 "forbidsendmailvariables" => \
$forbid_sendmail_variables,
308 my %config_settings = (
309 "smtpencryption" => \
$smtp_encryption,
310 "smtpserver" => \
$smtp_server,
311 "smtpserverport" => \
$smtp_server_port,
312 "smtpserveroption" => \
@smtp_server_options,
313 "smtpuser" => \
$smtp_authuser,
314 "smtppass" => \
$smtp_authpass,
315 "smtpdomain" => \
$smtp_domain,
316 "smtpauth" => \
$smtp_auth,
317 "smtpbatchsize" => \
$batch_size,
318 "smtprelogindelay" => \
$relogin_delay,
323 "headercmd" => \
$header_cmd,
324 "aliasfiletype" => \
$aliasfiletype,
325 "bcc" => \
@config_bcc,
326 "suppresscc" => \
@suppress_cc,
327 "envelopesender" => \
$envelope_sender,
328 "confirm" => \
$confirm,
330 "assume8bitencoding" => \
$auto_8bit_encoding,
331 "composeencoding" => \
$compose_encoding,
332 "transferencoding" => \
$target_xfer_encoding,
333 "sendmailcmd" => \
$sendmail_cmd,
336 my %config_path_settings = (
337 "aliasesfile" => \
@alias_files,
338 "smtpsslcertpath" => \
$smtp_ssl_cert_path,
341 # Handle Uncouth Termination
344 require Term
::ANSIColor
;
345 print Term
::ANSIColor
::color
("reset"), "\n";
347 # SMTP password masked
350 # tmp files from --compose
351 if (defined $compose_filename) {
352 if (-e
$compose_filename) {
353 printf __
("'%s' contains an intermediate version ".
354 "of the email you were composing.\n"),
357 if (-e
($compose_filename . ".final")) {
358 printf __
("'%s.final' contains the composed email.\n"),
366 $SIG{TERM
} = \
&signal_handler
;
367 $SIG{INT
} = \
&signal_handler
;
369 # Read our sendemail.* config
371 my ($known_keys, $configured, $prefix) = @_;
373 foreach my $setting (keys %config_bool_settings) {
374 my $target = $config_bool_settings{$setting};
375 my $key = "$prefix.$setting";
376 next unless exists $known_keys->{$key};
377 my $v = (@
{$known_keys->{$key}} == 1 &&
378 (defined $known_keys->{$key}->[0] &&
379 $known_keys->{$key}->[0] =~ /^(?:true|false)$/s))
380 ?
$known_keys->{$key}->[0] eq 'true'
381 : Git
::config_bool
(@repo, $key);
382 next unless defined $v;
383 next if $configured->{$setting}++;
387 foreach my $setting (keys %config_path_settings) {
388 my $target = $config_path_settings{$setting};
389 my $key = "$prefix.$setting";
390 next unless exists $known_keys->{$key};
391 if (ref($target) eq "ARRAY") {
392 my @values = Git
::config_path
(@repo, $key);
394 next if $configured->{$setting}++;
398 my $v = Git
::config_path
(@repo, "$prefix.$setting");
399 next unless defined $v;
400 next if $configured->{$setting}++;
405 foreach my $setting (keys %config_settings) {
406 my $target = $config_settings{$setting};
407 my $key = "$prefix.$setting";
408 next unless exists $known_keys->{$key};
409 if (ref($target) eq "ARRAY") {
410 my @values = @
{$known_keys->{$key}};
411 @values = grep { defined } @values;
412 next if $configured->{$setting}++;
416 my $v = $known_keys->{$key}->[-1];
417 next unless defined $v;
418 next if $configured->{$setting}++;
428 my $ret = Git
::command
(
435 # We must always return ($k, $v) here, since
436 # empty config values will be just "key\0",
437 # not "key\nvalue\0".
438 my ($k, $v) = split /\n/, $_, 2;
443 # If we have no keys we're OK, otherwise re-throw
444 die $@
if $@
->value != 1;
449 # Save ourselves a lot of work of shelling out to 'git config' (it
450 # parses 'bool' etc.) by only doing so for config keys that exist.
451 my %known_config_keys;
453 my @kv = config_regexp
("^sende?mail[.]");
454 while (my ($k, $v) = splice @kv, 0, 2) {
455 push @
{$known_config_keys{$k}} => $v;
459 # sendemail.identity yields to --identity. We must parse this
460 # special-case first before the rest of the config is read.
462 my $key = "sendemail.identity";
463 $identity = Git
::config
(@repo, $key) if exists $known_config_keys{$key};
465 my %identity_options = (
466 "identity=s" => \
$identity,
467 "no-identity" => \
$no_identity,
469 my $rc = GetOptions
(%identity_options);
471 undef $identity if $no_identity;
473 # Now we know enough to read the config
476 read_config
(\
%known_config_keys, \
%configured, "sendemail.$identity") if defined $identity;
477 read_config
(\
%known_config_keys, \
%configured, "sendemail");
480 # Begin by accumulating all the variables (defined above), that we will end up
481 # needing, first, from the command line:
484 my $git_completion_helper;
485 my %dump_aliases_options = (
487 "dump-aliases" => \
$dump_aliases,
489 $rc = GetOptions
(%dump_aliases_options);
491 die __
("--dump-aliases incompatible with other options\n")
492 if !$help and $dump_aliases and @ARGV;
494 "sender|from=s" => \
$sender,
495 "in-reply-to=s" => \
$initial_in_reply_to,
496 "reply-to=s" => \
$reply_to,
497 "subject=s" => \
$initial_subject,
498 "to=s" => \
@getopt_to,
499 "to-cmd=s" => \
$to_cmd,
501 "cc=s" => \
@getopt_cc,
503 "bcc=s" => \
@getopt_bcc,
504 "no-bcc" => \
$no_bcc,
505 "chain-reply-to!" => \
$chain_reply_to,
506 "no-chain-reply-to" => sub {$chain_reply_to = 0},
507 "sendmail-cmd=s" => \
$sendmail_cmd,
508 "smtp-server=s" => \
$smtp_server,
509 "smtp-server-option=s" => \
@smtp_server_options,
510 "smtp-server-port=s" => \
$smtp_server_port,
511 "smtp-user=s" => \
$smtp_authuser,
512 "smtp-pass:s" => \
$smtp_authpass,
513 "smtp-ssl" => sub { $smtp_encryption = 'ssl' },
514 "smtp-encryption=s" => \
$smtp_encryption,
515 "smtp-ssl-cert-path=s" => \
$smtp_ssl_cert_path,
516 "smtp-debug:i" => \
$debug_net_smtp,
517 "smtp-domain:s" => \
$smtp_domain,
518 "smtp-auth=s" => \
$smtp_auth,
519 "no-smtp-auth" => sub {$smtp_auth = 'none'},
520 "annotate!" => \
$annotate,
521 "no-annotate" => sub {$annotate = 0},
522 "compose" => \
$compose,
524 "cc-cmd=s" => \
$cc_cmd,
525 "header-cmd=s" => \
$header_cmd,
526 "no-header-cmd" => \
$no_header_cmd,
527 "suppress-from!" => \
$suppress_from,
528 "no-suppress-from" => sub {$suppress_from = 0},
529 "suppress-cc=s" => \
@suppress_cc,
530 "signed-off-cc|signed-off-by-cc!" => \
$signed_off_by_cc,
531 "no-signed-off-cc|no-signed-off-by-cc" => sub {$signed_off_by_cc = 0},
532 "cc-cover|cc-cover!" => \
$cover_cc,
533 "no-cc-cover" => sub {$cover_cc = 0},
534 "to-cover|to-cover!" => \
$cover_to,
535 "no-to-cover" => sub {$cover_to = 0},
536 "confirm=s" => \
$confirm,
537 "dry-run" => \
$dry_run,
538 "envelope-sender=s" => \
$envelope_sender,
539 "thread!" => \
$thread,
540 "no-thread" => sub {$thread = 0},
541 "validate!" => \
$validate,
542 "no-validate" => sub {$validate = 0},
543 "transfer-encoding=s" => \
$target_xfer_encoding,
544 "format-patch!" => \
$format_patch,
545 "no-format-patch" => sub {$format_patch = 0},
546 "8bit-encoding=s" => \
$auto_8bit_encoding,
547 "compose-encoding=s" => \
$compose_encoding,
549 "xmailer!" => \
$use_xmailer,
550 "no-xmailer" => sub {$use_xmailer = 0},
551 "batch-size=i" => \
$batch_size,
552 "relogin-delay=i" => \
$relogin_delay,
553 "git-completion-helper" => \
$git_completion_helper,
554 "v=s" => \
$reroll_count,
556 $rc = GetOptions
(%options);
558 # Munge any "either config or getopt, not both" variables
559 my @initial_to = @getopt_to ?
@getopt_to : ($no_to ?
() : @config_to);
560 my @initial_cc = @getopt_cc ?
@getopt_cc : ($no_cc ?
() : @config_cc);
561 my @initial_bcc = @getopt_bcc ?
@getopt_bcc : ($no_bcc ?
() : @config_bcc);
564 my %all_options = (%options, %dump_aliases_options, %identity_options);
565 completion_helper
(\
%all_options) if $git_completion_helper;
570 if ($forbid_sendmail_variables && grep { /^sendmail/s } keys %known_config_keys) {
571 die __
("fatal: found configuration options for 'sendmail'\n" .
572 "git-send-email is configured with the sendemail.* options - note the 'e'.\n" .
573 "Set sendemail.forbidSendmailVariables to false to disable this check.\n");
576 die __
("Cannot run git format-patch from outside a repository\n")
577 if $format_patch and not $repo;
579 die __
("`batch-size` and `relogin` must be specified together " .
580 "(via command-line or configuration option)\n")
581 if defined $relogin_delay and not defined $batch_size;
583 # 'default' encryption is none -- this only prevents a warning
584 $smtp_encryption = '' unless (defined $smtp_encryption);
586 # Set CC suppressions
589 foreach my $entry (@suppress_cc) {
590 # Please update $__git_send_email_suppresscc_options
591 # in git-completion.bash when you add new options.
592 die sprintf(__
("Unknown --suppress-cc field: '%s'\n"), $entry)
593 unless $entry =~ /^(?:all|cccmd|cc|author|self|sob|body|bodycc|misc-by)$/;
594 $suppress_cc{$entry} = 1;
598 if ($suppress_cc{'all'}) {
599 foreach my $entry (qw
(cccmd cc author self sob body bodycc misc
-by
)) {
600 $suppress_cc{$entry} = 1;
602 delete $suppress_cc{'all'};
605 # If explicit old-style ones are specified, they trump --suppress-cc.
606 $suppress_cc{'self'} = $suppress_from if defined $suppress_from;
607 $suppress_cc{'sob'} = !$signed_off_by_cc if defined $signed_off_by_cc;
609 if ($suppress_cc{'body'}) {
610 foreach my $entry (qw
(sob bodycc misc
-by
)) {
611 $suppress_cc{$entry} = 1;
613 delete $suppress_cc{'body'};
616 # Set confirm's default value
617 my $confirm_unconfigured = !defined $confirm;
618 if ($confirm_unconfigured) {
619 $confirm = scalar %suppress_cc ?
'compose' : 'auto';
621 # Please update $__git_send_email_confirm_options in
622 # git-completion.bash when you add new options.
623 die sprintf(__
("Unknown --confirm setting: '%s'\n"), $confirm)
624 unless $confirm =~ /^(?:auto|cc|compose|always|never)/;
626 # Debugging, print out the suppressions.
628 print "suppressions:\n";
629 foreach my $entry (keys %suppress_cc) {
630 printf " %-5s -> $suppress_cc{$entry}\n", $entry;
634 my ($repoauthor, $repocommitter);
637 my ($author, $committer);
640 return $cache{$what} if exists $cache{$what};
641 ($cache{$what}) = Git
::ident_person
(@repo, $what);
642 return $cache{$what};
644 $repoauthor = sub { $common->('author') };
645 $repocommitter = sub { $common->('committer') };
648 sub parse_address_line
{
649 require Git
::LoadCPAN
::Mail
::Address
;
650 return map { $_->format } Mail
::Address
->parse($_[0]);
654 require Text
::ParseWords
;
655 return Text
::ParseWords
::quotewords
('\s*,\s*', 1, @_);
660 sub parse_sendmail_alias
{
663 printf STDERR __
("warning: sendmail alias with quotes is not supported: %s\n"), $_;
664 } elsif (/:include:/) {
665 printf STDERR __
("warning: `:include:` not supported: %s\n"), $_;
667 printf STDERR __
("warning: `/file` or `|pipe` redirection not supported: %s\n"), $_;
668 } elsif (/^(\S+?)\s*:\s*(.+)$/) {
669 my ($alias, $addr) = ($1, $2);
670 $aliases{$alias} = [ split_addrs
($addr) ];
672 printf STDERR __
("warning: sendmail line is not recognized: %s\n"), $_;
676 sub parse_sendmail_aliases
{
681 next if /^\s*$/ || /^\s*#/;
682 $s .= $_, next if $s =~ s/\\$// || s/^\s+//;
683 parse_sendmail_alias
($s) if $s;
686 $s =~ s/\\$//; # silently tolerate stray '\' on last line
687 parse_sendmail_alias
($s) if $s;
691 # multiline formats can be supported in the future
692 mutt
=> sub { my $fh = shift; while (<$fh>) {
693 if (/^\s*alias\s+(?:-group\s+\S+\s+)*(\S+)\s+(.*)$/) {
694 my ($alias, $addr) = ($1, $2);
695 $addr =~ s/#.*$//; # mutt allows # comments
696 # commas delimit multiple addresses
697 my @addr = split_addrs
($addr);
699 # quotes may be escaped in the file,
700 # unescape them so we do not double-escape them later.
701 s/\\"/"/g foreach @addr;
702 $aliases{$alias} = \
@addr
704 mailrc
=> sub { my $fh = shift; while (<$fh>) {
705 if (/^alias\s+(\S+)\s+(.*?)\s*$/) {
706 require Text
::ParseWords
;
707 # spaces delimit multiple addresses
708 $aliases{$1} = [ Text
::ParseWords
::quotewords
('\s+', 0, $2) ];
710 pine
=> sub { my $fh = shift; my $f='\t[^\t]*';
711 for (my $x = ''; defined($x); $x = $_) {
713 $x .= $1 while(defined($_ = <$fh>) && /^ +(.*)$/);
714 $x =~ /^(\S+)$f\t\(?([^\t]+?)\)?(:?$f){0,2}$/ or next;
715 $aliases{$1} = [ split_addrs
($2) ];
717 elm
=> sub { my $fh = shift;
719 if (/^(\S+)\s+=\s+[^=]+=\s(\S+)/) {
720 my ($alias, $addr) = ($1, $2);
721 $aliases{$alias} = [ split_addrs
($addr) ];
724 sendmail
=> \
&parse_sendmail_aliases
,
725 gnus
=> sub { my $fh = shift; while (<$fh>) {
726 if (/\(define-mail-alias\s+"(\S+?)"\s+"(\S+?)"\)/) {
727 $aliases{$1} = [ $2 ];
729 # Please update _git_config() in git-completion.bash when you
733 if (@alias_files and $aliasfiletype and defined $parse_alias{$aliasfiletype}) {
734 foreach my $file (@alias_files) {
735 open my $fh, '<', $file or die "opening $file: $!\n";
736 $parse_alias{$aliasfiletype}->($fh);
742 print "$_\n" for (sort keys %aliases);
746 # is_format_patch_arg($f) returns 0 if $f names a patch, or 1 if
747 # $f is a revision list specification to be passed to format-patch.
748 sub is_format_patch_arg
{
752 $repo->command('rev-parse', '--verify', '--quiet', $f);
753 if (defined($format_patch)) {
754 return $format_patch;
756 die sprintf(__
(<<EOF), $f, $f);
757 File '%s' exists but it could also be the range of commits
758 to produce patches for. Please disambiguate by...
760 * Saying "./%s" if you mean a file; or
761 * Giving --format-patch option if you mean a range.
763 } catch Git
::Error
::Command with
{
764 # Not a valid revision. Treat it as a filename.
769 # Now that all the defaults are set, process the rest of the command line
770 # arguments and collect up the files that need to be processed.
772 while (defined(my $f = shift @ARGV)) {
774 push @rev_list_opts, "--", @ARGV;
776 } elsif (-d
$f and !is_format_patch_arg
($f)) {
778 or die sprintf(__
("Failed to opendir %s: %s"), $f, $!);
781 push @files, grep { -f
$_ } map { File
::Spec
->catfile($f, $_) }
784 } elsif ((-f
$f or -p
$f) and !is_format_patch_arg
($f)) {
787 push @rev_list_opts, $f;
791 if (@rev_list_opts) {
792 die __
("Cannot run git format-patch from outside a repository\n")
795 push @files, $repo->command('format-patch', '-o', File
::Temp
::tempdir
(CLEANUP
=> 1),
796 defined $reroll_count ?
('-v', $reroll_count) : (),
800 if (defined $sender) {
801 $sender =~ s/^\s+|\s+$//g;
802 ($sender) = expand_aliases
($sender);
804 $sender = $repoauthor->() || $repocommitter->() || '';
807 # $sender could be an already sanitized address
808 # (e.g. sendemail.from could be manually sanitized by user).
809 # But it's a no-op to run sanitize_address on an already sanitized address.
810 $sender = sanitize_address
($sender);
812 $time = time - scalar $#files;
814 @files = handle_backup_files
(@files);
818 print $_,"\n" for (@files);
821 print STDERR __
("\nNo patch files specified!\n\n");
825 sub get_patch_subject
{
827 open (my $fh, '<', $fn);
828 while (my $line = <$fh>) {
829 next unless ($line =~ /^Subject: (.*)$/);
834 die sprintf(__
("No subject line in %s?"), $fn);
838 # Note that this does not need to be secure, but we will make a small
839 # effort to have it be unique
841 $compose_filename = ($repo ?
842 File
::Temp
::tempfile
(".gitsendemail.msg.XXXXXX", DIR
=> $repo->repo_path()) :
843 File
::Temp
::tempfile
(".gitsendemail.msg.XXXXXX", DIR
=> "."))[1];
844 open my $c, ">", $compose_filename
845 or die sprintf(__
("Failed to open for writing %s: %s"), $compose_filename, $!);
848 my $tpl_sender = $sender || $repoauthor->() || $repocommitter->() || '';
849 my $tpl_subject = $initial_subject || '';
850 my $tpl_in_reply_to = $initial_in_reply_to || '';
851 my $tpl_reply_to = $reply_to || '';
853 print $c <<EOT1, Git::prefix_lines("GIT: ", __(<<EOT2)), <<EOT3;
854 From $tpl_sender # This line is ignored.
856 Lines beginning in "GIT:" will be removed.
857 Consider including an overall diffstat or table of contents
858 for the patch you are writing.
860 Clear the body content if you don't wish to send a summary.
863 Reply-To: $tpl_reply_to
864 Subject: $tpl_subject
865 In-Reply-To: $tpl_in_reply_to
869 print $c get_patch_subject($f);
874 do_edit($compose_filename, @files);
876 do_edit($compose_filename);
879 open $c, "<", $compose_filename
880 or die sprintf(__("Failed to open %s: %s"), $compose_filename, $!);
882 if (!defined $compose_encoding) {
883 $compose_encoding = "UTF-8";
887 while (my $line = <$c>) {
888 next if $line =~ m/^GIT:/;
889 parse_header_line($line, \%parsed_email);
891 $parsed_email{'body'} = filter_body($c);
896 open my $c2, ">", $compose_filename . ".final"
897 or die sprintf(__("Failed to open %s.final: %s"), $compose_filename, $!);
900 if ($parsed_email{'From'}) {
901 $sender = delete($parsed_email{'From'});
903 if ($parsed_email{'In-Reply-To'}) {
904 $initial_in_reply_to = delete($parsed_email{'In-Reply-To'});
906 if ($parsed_email{'Reply-To'}) {
907 $reply_to = delete($parsed_email{'Reply-To'});
909 if ($parsed_email{'Subject'}) {
910 $initial_subject = delete($parsed_email{'Subject'});
911 print $c2 "Subject: " .
912 quote_subject($initial_subject, $compose_encoding) .
916 if ($parsed_email{'MIME-Version'}) {
917 print $c2 "MIME-Version: $parsed_email{'MIME-Version'}\n",
918 "Content-Type: $parsed_email{'Content-Type'};\n",
919 "Content-Transfer-Encoding: $parsed_email{'Content-Transfer-Encoding'}\n";
920 delete($parsed_email{'MIME-Version'});
921 delete($parsed_email{'Content-Type'});
922 delete($parsed_email{'Content-Transfer-Encoding'});
923 } elsif (file_has_nonascii($compose_filename)) {
924 my $content_type = (delete($parsed_email{'Content-Type'}) or
925 "text/plain; charset=$compose_encoding");
926 print $c2 "MIME-Version: 1.0\n",
927 "Content-Type: $content_type\n",
928 "Content-Transfer-Encoding: 8bit\n";
930 # Preserve unknown headers
931 foreach my $key (keys %parsed_email) {
932 next if $key eq 'body';
933 print $c2 "$key: $parsed_email{$key}";
936 if ($parsed_email{'body'}) {
937 print $c2 "\n$parsed_email{'body'}\n";
938 delete($parsed_email{'body'});
940 print __("Summary email is empty, skipping it\n");
946 } elsif ($annotate) {
952 require Term::ReadLine;
953 $ENV{"GIT_SEND_EMAIL_NOTTY"}
954 ? Term::ReadLine->new('git-send-email', \*STDIN, \*STDOUT)
955 : Term::ReadLine->new('git-send-email');
958 $term = FakeTerm->new("$@: going non-interactive");
964 my ($prompt, %arg) = @_;
965 my $valid_re = $arg{valid_re};
966 my $default = $arg{default};
967 my $confirm_only = $arg{confirm_only};
971 return defined $default ? $default : undef
972 unless defined $term->IN and defined fileno($term->IN) and
973 defined $term->OUT and defined fileno($term->OUT);
975 $resp = $term->readline($prompt);
976 if (!defined $resp) { # EOF
978 return defined $default ? $default : undef;
980 if ($resp eq '' and defined $default) {
983 if (!defined $valid_re or $resp =~ /$valid_re/) {
987 my $yesno = $term->readline(
988 # TRANSLATORS: please keep [y/N] as is.
989 sprintf(__("Are you sure you want to use <%s> [y/N]? "), $resp));
990 if (defined $yesno && $yesno =~ /y/i) {
998 sub parse_header_line {
1000 my $parsed_line = shift;
1001 my $addr_pat = join "|", qw(To Cc Bcc);
1003 foreach (split(/\n/, $lines)) {
1004 if (/^($addr_pat):\s*(.+)$/i) {
1005 $parsed_line->{$1} = [ parse_address_line
($2) ];
1006 } elsif (/^([^:]*):\s*(.+)\s*$/i) {
1007 $parsed_line->{$1} = $2;
1015 while (my $body_line = <$c>) {
1016 if ($body_line !~ m/^GIT:/) {
1017 $body .= $body_line;
1024 my %broken_encoding;
1026 sub file_declares_8bit_cte
{
1028 open (my $fh, '<', $fn);
1029 while (my $line = <$fh>) {
1030 last if ($line =~ /^$/);
1031 return 1 if ($line =~ /^Content-Transfer-Encoding: .*8bit.*$/);
1037 foreach my $f (@files) {
1038 next unless (body_or_subject_has_nonascii
($f)
1039 && !file_declares_8bit_cte
($f));
1040 $broken_encoding{$f} = 1;
1043 if (!defined $auto_8bit_encoding && scalar %broken_encoding) {
1044 print __
("The following files are 8bit, but do not declare " .
1045 "a Content-Transfer-Encoding.\n");
1046 foreach my $f (sort keys %broken_encoding) {
1049 $auto_8bit_encoding = ask
(__
("Which 8bit encoding should I declare [UTF-8]? "),
1050 valid_re
=> qr/.{4}/, confirm_only
=> 1,
1051 default => "UTF-8");
1055 for my $f (@files) {
1056 if (get_patch_subject
($f) =~ /\Q*** SUBJECT HERE ***\E/) {
1057 die sprintf(__
("Refusing to send because the patch\n\t%s\n"
1058 . "has the template subject '*** SUBJECT HERE ***'. "
1059 . "Pass --force if you really want to send.\n"), $f);
1064 my $to_whom = __
("To whom should the emails be sent (if anyone)?");
1066 if (!@initial_to && !defined $to_cmd) {
1067 my $to = ask
("$to_whom ",
1069 valid_re
=> qr/\@.*\./, confirm_only
=> 1);
1070 push @initial_to, parse_address_line
($to) if defined $to; # sanitized/validated later
1074 sub expand_aliases
{
1075 return map { expand_one_alias
($_) } @_;
1078 my %EXPANDED_ALIASES;
1079 sub expand_one_alias
{
1081 if ($EXPANDED_ALIASES{$alias}) {
1082 die sprintf(__
("fatal: alias '%s' expands to itself\n"), $alias);
1084 local $EXPANDED_ALIASES{$alias} = 1;
1085 return $aliases{$alias} ? expand_aliases
(@
{$aliases{$alias}}) : $alias;
1088 @initial_to = process_address_list
(@initial_to);
1089 @initial_cc = process_address_list
(@initial_cc);
1090 @initial_bcc = process_address_list
(@initial_bcc);
1092 if ($thread && !defined $initial_in_reply_to && $prompting) {
1093 $initial_in_reply_to = ask
(
1094 __
("Message-ID to be used as In-Reply-To for the first email (if any)? "),
1096 valid_re
=> qr/\@.*\./, confirm_only
=> 1);
1098 if (defined $initial_in_reply_to) {
1099 $initial_in_reply_to =~ s/^\s*<?//;
1100 $initial_in_reply_to =~ s/>?\s*$//;
1101 $initial_in_reply_to = "<$initial_in_reply_to>" if $initial_in_reply_to ne '';
1104 if (defined $reply_to) {
1105 $reply_to =~ s/^\s+|\s+$//g;
1106 ($reply_to) = expand_aliases
($reply_to);
1107 $reply_to = sanitize_address
($reply_to);
1110 if (!defined $sendmail_cmd && !defined $smtp_server) {
1111 my @sendmail_paths = qw( /usr/sbin/sendmail /usr/lib/sendmail );
1112 push @sendmail_paths, map {"$_/sendmail"} split /:/, $ENV{PATH
};
1113 foreach (@sendmail_paths) {
1120 if (!defined $sendmail_cmd) {
1121 $smtp_server = 'localhost'; # could be 127.0.0.1, too... *shrug*
1125 if ($compose && $compose > 0) {
1126 @files = ($compose_filename . ".final", @files);
1129 # Variables we set as part of the loop over files
1130 our ($message_id, %mail, $subject, $in_reply_to, $references, $message,
1131 $needs_confirm, $message_num, $ask_default);
1133 sub extract_valid_address
{
1134 my $address = shift;
1135 my $local_part_regexp = qr/[^<>"\s@]+/;
1136 my $domain_regexp = qr/[^.<>"\s@]+(?:\.[^.<>"\s@]+)+/;
1138 # check for a local address:
1139 return $address if ($address =~ /^($local_part_regexp)$/);
1141 $address =~ s/^\s*<(.*)>\s*$/$1/;
1142 my $have_email_valid = eval { require Email
::Valid
; 1 };
1143 if ($have_email_valid) {
1144 return scalar Email
::Valid
->address($address);
1147 # less robust/correct than the monster regexp in Email::Valid,
1148 # but still does a 99% job, and one less dependency
1149 return $1 if $address =~ /($local_part_regexp\@$domain_regexp)/;
1153 sub extract_valid_address_or_die
{
1154 my $address = shift;
1155 $address = extract_valid_address
($address);
1156 die sprintf(__
("error: unable to extract a valid address from: %s\n"), $address)
1161 sub validate_address
{
1162 my $address = shift;
1163 while (!extract_valid_address
($address)) {
1164 printf STDERR __
("error: unable to extract a valid address from: %s\n"), $address;
1165 # TRANSLATORS: Make sure to include [q] [d] [e] in your
1166 # translation. The program will only accept English input
1168 $_ = ask
(__
("What to do with this address? ([q]uit|[d]rop|[e]dit): "),
1169 valid_re
=> qr/^(?:quit|q|drop|d|edit|e)/i,
1174 cleanup_compose_files
();
1177 $address = ask
("$to_whom ",
1179 valid_re
=> qr/\@.*\./, confirm_only
=> 1);
1184 sub validate_address_list
{
1185 return (grep { defined $_ }
1186 map { validate_address
($_) } @_);
1189 # Usually don't need to change anything below here.
1191 # we make a "fake" message id by taking the current number
1192 # of seconds since the beginning of Unix time and tacking on
1193 # a random number to the end, in case we are called quicker than
1194 # 1 second since the last time we were called.
1196 # We'll setup a template for the message id, using the "from" address:
1198 my ($message_id_stamp, $message_id_serial);
1199 sub make_message_id
{
1201 if (!defined $message_id_stamp) {
1203 $message_id_stamp = POSIX
::strftime
("%Y%m%d%H%M%S.$$", gmtime(time));
1204 $message_id_serial = 0;
1206 $message_id_serial++;
1207 $uniq = "$message_id_stamp-$message_id_serial";
1210 for ($sender, $repocommitter->(), $repoauthor->()) {
1211 $du_part = extract_valid_address
(sanitize_address
($_));
1212 last if (defined $du_part and $du_part ne '');
1214 if (not defined $du_part or $du_part eq '') {
1215 require Sys
::Hostname
;
1216 $du_part = 'user@' . Sys
::Hostname
::hostname
();
1218 my $message_id_template = "<%s-%s>";
1219 $message_id = sprintf($message_id_template, $uniq, $du_part);
1220 #print "new message id = $message_id\n"; # Was useful for debugging
1223 sub unquote_rfc2047
{
1226 my $sep = qr/[ \t]+/;
1227 s
{$re_encoded_word(?
:$sep$re_encoded_word)*}{
1228 my @words = split $sep, $&;
1230 m/$re_encoded_word/;
1234 if ($encoding eq 'q' || $encoding eq 'Q') {
1237 s/=([0-9A-F]{2})/chr(hex($1))/egi;
1239 # other encodings not supported yet
1244 return wantarray ?
($_, $charset) : $_;
1249 my $encoding = shift || 'UTF-8';
1250 s/([^-a-zA-Z0-9!*+\/])/sprintf
("=%02X", ord($1))/eg
;
1251 s/(.*)/=\?$encoding\?q\?$1\?=/;
1255 sub is_rfc2047_quoted
{
1258 $s =~ m/^(?:"[[:ascii:]]*"|$re_encoded_word)$/o;
1261 sub subject_needs_rfc2047_quoting
{
1264 return ($s =~ /[^[:ascii:]]/) || ($s =~ /=\?/);
1268 local $subject = shift;
1269 my $encoding = shift || 'UTF-8';
1271 if (subject_needs_rfc2047_quoting
($subject)) {
1272 return quote_rfc2047
($subject, $encoding);
1277 # use the simplest quoting being able to handle the recipient
1278 sub sanitize_address
{
1279 my ($recipient) = @_;
1281 # remove garbage after email address
1282 $recipient =~ s/(.*>).*$/$1/;
1284 my ($recipient_name, $recipient_addr) = ($recipient =~ /^(.*?)\s*(<.*)/);
1286 if (not $recipient_name) {
1290 # if recipient_name is already quoted, do nothing
1291 if (is_rfc2047_quoted
($recipient_name)) {
1295 # remove non-escaped quotes
1296 $recipient_name =~ s/(^|[^\\])"/$1/g;
1298 # rfc2047 is needed if a non-ascii char is included
1299 if ($recipient_name =~ /[^[:ascii:]]/) {
1300 $recipient_name = quote_rfc2047
($recipient_name);
1303 # double quotes are needed if specials or CTLs are included
1304 elsif ($recipient_name =~ /[][()<>@,;:\\".\000-\037\177]/) {
1305 $recipient_name =~ s/([\\\r])/\\$1/g;
1306 $recipient_name = qq["$recipient_name"];
1309 return "$recipient_name $recipient_addr";
1313 sub strip_garbage_one_address
{
1316 if ($addr =~ /^(("[^"]*"|[^"<]*)? *<[^>]*>).*/) {
1317 # "Foo Bar" <foobar@example.com> [possibly garbage here]
1318 # Foo Bar <foobar@example.com> [possibly garbage here]
1321 if ($addr =~ /^(<[^>]*>).*/) {
1322 # <foo@example.com> [possibly garbage here]
1323 # if garbage contains other addresses, they are ignored.
1326 if ($addr =~ /^([^"#,\s]*)/) {
1327 # address without quoting: remove anything after the address
1333 sub sanitize_address_list
{
1334 return (map { sanitize_address
($_) } @_);
1337 sub process_address_list
{
1338 my @addr_list = map { parse_address_line
($_) } @_;
1339 @addr_list = expand_aliases
(@addr_list);
1340 @addr_list = sanitize_address_list
(@addr_list);
1341 @addr_list = validate_address_list
(@addr_list);
1345 # Returns the local Fully Qualified Domain Name (FQDN) if available.
1347 # Tightly configured MTAa require that a caller sends a real DNS
1348 # domain name that corresponds the IP address in the HELO/EHLO
1349 # handshake. This is used to verify the connection and prevent
1350 # spammers from trying to hide their identity. If the DNS and IP don't
1351 # match, the receiving MTA may deny the connection.
1353 # Here is a deny example of Net::SMTP with the default "localhost.localdomain"
1355 # Net::SMTP=GLOB(0x267ec28)>>> EHLO localhost.localdomain
1356 # Net::SMTP=GLOB(0x267ec28)<<< 550 EHLO argument does not match calling host
1358 # This maildomain*() code is based on ideas in Perl library Test::Reporter
1359 # /usr/share/perl5/Test/Reporter/Mail/Util.pm ==> sub _maildomain ()
1363 return defined $domain && !($^O
eq 'darwin' && $domain =~ /\.local$/) && $domain =~ /\./;
1366 sub maildomain_net
{
1369 require Net
::Domain
;
1370 my $domain = Net
::Domain
::domainname
();
1371 $maildomain = $domain if valid_fqdn
($domain);
1376 sub maildomain_mta
{
1379 for my $host (qw(mailhost localhost)) {
1381 my $smtp = Net
::SMTP
->new($host);
1382 if (defined $smtp) {
1383 my $domain = $smtp->domain;
1386 $maildomain = $domain if valid_fqdn
($domain);
1388 last if $maildomain;
1396 return maildomain_net
() || maildomain_mta
() || 'localhost.localdomain';
1399 sub smtp_host_string
{
1400 if (defined $smtp_server_port) {
1401 return "$smtp_server:$smtp_server_port";
1403 return $smtp_server;
1407 # Returns 1 if authentication succeeded or was not necessary
1408 # (smtp_user was not specified), and 0 otherwise.
1410 sub smtp_auth_maybe
{
1411 if (!defined $smtp_authuser || $auth || (defined $smtp_auth && $smtp_auth eq "none")) {
1415 # Workaround AUTH PLAIN/LOGIN interaction defect
1416 # with Authen::SASL::Cyrus
1418 require Authen
::SASL
;
1419 Authen
::SASL
->import(qw(Perl));
1422 # Check mechanism naming as defined in:
1423 # https://tools.ietf.org/html/rfc4422#page-8
1424 if ($smtp_auth && $smtp_auth !~ /^(\b[A-Z0-9-_]{1,20}\s*)*$/) {
1425 die "invalid smtp auth: '${smtp_auth}'";
1428 # TODO: Authentication may fail not because credentials were
1429 # invalid but due to other reasons, in which we should not
1430 # reject credentials.
1431 $auth = Git
::credential
({
1432 'protocol' => 'smtp',
1433 'host' => smtp_host_string
(),
1434 'username' => $smtp_authuser,
1435 # if there's no password, "git credential fill" will
1436 # give us one, otherwise it'll just pass this one.
1437 'password' => $smtp_authpass
1442 my $sasl = Authen
::SASL
->new(
1443 mechanism
=> $smtp_auth,
1445 user
=> $cred->{'username'},
1446 pass
=> $cred->{'password'},
1447 authname
=> $cred->{'username'},
1451 return !!$smtp->auth($sasl);
1454 return !!$smtp->auth($cred->{'username'}, $cred->{'password'});
1460 sub ssl_verify_params
{
1462 require IO
::Socket
::SSL
;
1463 IO
::Socket
::SSL
->import(qw
/SSL_VERIFY_PEER SSL_VERIFY_NONE/);
1466 print STDERR
"Not using SSL_VERIFY_PEER due to out-of-date IO::Socket::SSL.\n";
1470 if (!defined $smtp_ssl_cert_path) {
1471 # use the OpenSSL defaults
1472 return (SSL_verify_mode
=> SSL_VERIFY_PEER
());
1475 if ($smtp_ssl_cert_path eq "") {
1476 return (SSL_verify_mode
=> SSL_VERIFY_NONE
());
1477 } elsif (-d
$smtp_ssl_cert_path) {
1478 return (SSL_verify_mode
=> SSL_VERIFY_PEER
(),
1479 SSL_ca_path
=> $smtp_ssl_cert_path);
1480 } elsif (-f
$smtp_ssl_cert_path) {
1481 return (SSL_verify_mode
=> SSL_VERIFY_PEER
(),
1482 SSL_ca_file
=> $smtp_ssl_cert_path);
1484 die sprintf(__
("CA path \"%s\" does not exist"), $smtp_ssl_cert_path);
1488 sub file_name_is_absolute
{
1491 # msys does not grok DOS drive-prefixes
1492 if ($^O
eq 'msys') {
1493 return ($path =~ m
#^/# || $path =~ m#^[a-zA-Z]\:#)
1496 require File
::Spec
::Functions
;
1497 return File
::Spec
::Functions
::file_name_is_absolute
($path);
1501 my @recipients = unique_email_list
(@to);
1502 @cc = (grep { my $cc = extract_valid_address_or_die
($_);
1503 not grep { $cc eq $_ || $_ =~ /<\Q${cc}\E>$/ } @recipients
1506 my $to = join (",\n\t", @recipients);
1507 @recipients = unique_email_list
(@recipients,@cc,@initial_bcc);
1508 @recipients = (map { extract_valid_address_or_die
($_) } @recipients);
1509 my $date = format_2822_time
($time++);
1510 my $gitversion = '@@GIT_VERSION@@';
1511 if ($gitversion =~ m/..GIT_VERSION../) {
1512 $gitversion = Git
::version
();
1515 my $cc = join(",\n\t", unique_email_list
(@cc));
1518 $ccline = "\nCc: $cc";
1520 make_message_id
() unless defined($message_id);
1522 my $header = "From: $sender
1526 Message-ID: $message_id
1529 $header .= "X-Mailer: git-send-email $gitversion\n";
1533 $header .= "In-Reply-To: $in_reply_to\n";
1534 $header .= "References: $references\n";
1537 $header .= "Reply-To: $reply_to\n";
1540 $header .= join("\n", @xh) . "\n";
1542 my $recipients_ref = \
@recipients;
1543 return ($recipients_ref, $to, $date, $gitversion, $cc, $ccline, $header);
1546 # Prepares the email, then asks the user what to do.
1548 # If the user chooses to send the email, it's sent and 1 is returned.
1549 # If the user chooses not to send the email, 0 is returned.
1550 # If the user decides they want to make further edits, -1 is returned and the
1551 # caller is expected to call send_message again after the edits are performed.
1553 # If an error occurs sending the email, this just dies.
1556 my ($recipients_ref, $to, $date, $gitversion, $cc, $ccline, $header) = gen_header
();
1557 my @recipients = @
$recipients_ref;
1559 my @sendmail_parameters = ('-i', @recipients);
1560 my $raw_from = $sender;
1561 if (defined $envelope_sender && $envelope_sender ne "auto") {
1562 $raw_from = $envelope_sender;
1564 $raw_from = extract_valid_address
($raw_from);
1565 unshift (@sendmail_parameters,
1566 '-f', $raw_from) if(defined $envelope_sender);
1568 if ($needs_confirm && !$dry_run) {
1569 print "\n$header\n";
1570 if ($needs_confirm eq "inform") {
1571 $confirm_unconfigured = 0; # squelch this message for the rest of this run
1572 $ask_default = "y"; # assume yes on EOF since user hasn't explicitly asked for confirmation
1574 The Cc list above has been expanded by additional
1575 addresses found in the patch commit message. By default
1576 send-email prompts before sending whenever this occurs.
1577 This behavior is controlled by the sendemail.confirm
1578 configuration setting.
1580 For additional information, run 'git send-email --help'.
1581 To retain the current behavior, but squelch this message,
1582 run 'git config --global sendemail.confirm auto'.
1586 # TRANSLATORS: Make sure to include [y] [n] [e] [q] [a] in your
1587 # translation. The program will only accept English input
1589 $_ = ask
(__
("Send this email? ([y]es|[n]o|[e]dit|[q]uit|[a]ll): "),
1590 valid_re
=> qr/^(?:yes|y|no|n|edit|e|quit|q|all|a)/i,
1591 default => $ask_default);
1592 die __
("Send this email reply required") unless defined $_;
1598 cleanup_compose_files
();
1605 unshift (@sendmail_parameters, @smtp_server_options);
1608 # We don't want to send the email.
1609 } elsif (defined $sendmail_cmd || file_name_is_absolute
($smtp_server)) {
1610 my $pid = open my $sm, '|-';
1611 defined $pid or die $!;
1613 if (defined $sendmail_cmd) {
1614 exec ("sh", "-c", "$sendmail_cmd \"\$@\"", "-", @sendmail_parameters)
1617 exec ($smtp_server, @sendmail_parameters)
1621 print $sm "$header\n$message";
1622 close $sm or die $!;
1625 if (!defined $smtp_server) {
1626 die __
("The required SMTP server is not properly defined.")
1630 my $use_net_smtp_ssl = version
->parse($Net::SMTP
::VERSION
) < version
->parse("2.34");
1631 $smtp_domain ||= maildomain
();
1633 if ($smtp_encryption eq 'ssl') {
1634 $smtp_server_port ||= 465; # ssmtp
1635 require IO
::Socket
::SSL
;
1637 # Suppress "variable accessed once" warning.
1640 $IO::Socket
::SSL
::DEBUG
= 1;
1643 # Net::SMTP::SSL->new() does not forward any SSL options
1644 IO
::Socket
::SSL
::set_client_defaults
(
1645 ssl_verify_params
());
1647 if ($use_net_smtp_ssl) {
1648 require Net
::SMTP
::SSL
;
1649 $smtp ||= Net
::SMTP
::SSL
->new($smtp_server,
1650 Hello
=> $smtp_domain,
1651 Port
=> $smtp_server_port,
1652 Debug
=> $debug_net_smtp);
1655 $smtp ||= Net
::SMTP
->new($smtp_server,
1656 Hello
=> $smtp_domain,
1657 Port
=> $smtp_server_port,
1658 Debug
=> $debug_net_smtp,
1663 $smtp_server_port ||= 25;
1664 $smtp ||= Net
::SMTP
->new($smtp_server,
1665 Hello
=> $smtp_domain,
1666 Debug
=> $debug_net_smtp,
1667 Port
=> $smtp_server_port);
1668 if ($smtp_encryption eq 'tls' && $smtp) {
1669 if ($use_net_smtp_ssl) {
1670 $smtp->command('STARTTLS');
1672 if ($smtp->code != 220) {
1673 die sprintf(__
("Server does not support STARTTLS! %s"), $smtp->message);
1675 require Net
::SMTP
::SSL
;
1676 $smtp = Net
::SMTP
::SSL
->start_SSL($smtp,
1677 ssl_verify_params
())
1678 or die sprintf(__
("STARTTLS failed! %s"), IO
::Socket
::SSL
::errstr
());
1681 $smtp->starttls(ssl_verify_params
())
1682 or die sprintf(__
("STARTTLS failed! %s"), IO
::Socket
::SSL
::errstr
());
1684 # Send EHLO again to receive fresh
1685 # supported commands
1686 $smtp->hello($smtp_domain);
1691 die __
("Unable to initialize SMTP properly. Check config and use --smtp-debug."),
1692 " VALUES: server=$smtp_server ",
1693 "encryption=$smtp_encryption ",
1694 "hello=$smtp_domain",
1695 defined $smtp_server_port ?
" port=$smtp_server_port" : "";
1698 smtp_auth_maybe
or die $smtp->message;
1700 $smtp->mail( $raw_from ) or die $smtp->message;
1701 $smtp->to( @recipients ) or die $smtp->message;
1702 $smtp->data or die $smtp->message;
1703 $smtp->datasend("$header\n") or die $smtp->message;
1704 my @lines = split /^/, $message;
1705 foreach my $line (@lines) {
1706 $smtp->datasend("$line") or die $smtp->message;
1708 $smtp->dataend() or die $smtp->message;
1709 $smtp->code =~ /250|200/ or die sprintf(__
("Failed to send %s\n"), $subject).$smtp->message;
1712 printf($dry_run ? __
("Dry-Sent %s\n") : __
("Sent %s\n"), $subject);
1714 print($dry_run ? __
("Dry-OK. Log says:\n") : __
("OK. Log says:\n"));
1715 if (!defined $sendmail_cmd && !file_name_is_absolute
($smtp_server)) {
1716 print "Server: $smtp_server\n";
1717 print "MAIL FROM:<$raw_from>\n";
1718 foreach my $entry (@recipients) {
1719 print "RCPT TO:<$entry>\n";
1723 if (defined $sendmail_cmd) {
1724 $sm = $sendmail_cmd;
1729 print "Sendmail: $sm ".join(' ',@sendmail_parameters)."\n";
1731 print $header, "\n";
1733 print __
("Result: "), $smtp->code, ' ',
1734 ($smtp->message =~ /\n([^\n]+\n)$/s), "\n";
1736 print __
("Result: OK\n");
1743 sub pre_process_file
{
1744 my ($t, $quiet) = @_;
1746 open my $fh, "<", $t or die sprintf(__
("can't open file %s"), $t);
1749 my $sauthor = undef;
1750 my $author_encoding;
1751 my $has_content_type;
1754 my $has_mime_version;
1758 my $input_format = undef;
1760 $subject = $initial_subject;
1764 # Retrieve and unfold header fields.
1765 my @header_lines = ();
1768 push(@header_lines, $_);
1770 @header = unfold_headers
(@header_lines);
1771 # Add computed headers, if applicable.
1772 unless ($no_header_cmd || ! $header_cmd) {
1773 push @header, invoke_header_cmd
($header_cmd, $t);
1775 # Now parse the header
1778 $input_format = 'mbox';
1782 if (!defined $input_format && /^[-A-Za-z]+:\s/) {
1783 $input_format = 'mbox';
1786 if (defined $input_format && $input_format eq 'mbox') {
1787 if (/^Subject:\s+(.*)$/i) {
1790 elsif (/^From:\s+(.*)$/i) {
1791 ($author, $author_encoding) = unquote_rfc2047
($1);
1792 $sauthor = sanitize_address
($author);
1793 next if $suppress_cc{'author'};
1794 next if $suppress_cc{'self'} and $sauthor eq $sender;
1795 printf(__
("(mbox) Adding cc: %s from line '%s'\n"),
1796 $1, $_) unless $quiet;
1799 elsif (/^To:\s+(.*)$/i) {
1800 foreach my $addr (parse_address_line
($1)) {
1801 printf(__
("(mbox) Adding to: %s from line '%s'\n"),
1802 $addr, $_) unless $quiet;
1806 elsif (/^Cc:\s+(.*)$/i) {
1807 foreach my $addr (parse_address_line
($1)) {
1808 my $qaddr = unquote_rfc2047
($addr);
1809 my $saddr = sanitize_address
($qaddr);
1810 if ($saddr eq $sender) {
1811 next if ($suppress_cc{'self'});
1813 next if ($suppress_cc{'cc'});
1815 printf(__
("(mbox) Adding cc: %s from line '%s'\n"),
1816 $addr, $_) unless $quiet;
1820 elsif (/^Content-type:/i) {
1821 $has_content_type = 1;
1822 if (/charset="?([^ "]+)/) {
1823 $body_encoding = $1;
1827 elsif (/^MIME-Version/i) {
1828 $has_mime_version = 1;
1831 elsif (/^Message-ID: (.*)/i) {
1834 elsif (/^Content-Transfer-Encoding: (.*)/i) {
1835 $xfer_encoding = $1 if not defined $xfer_encoding;
1837 elsif (/^In-Reply-To: (.*)/i) {
1838 if (!$initial_in_reply_to || $thread) {
1842 elsif (/^References: (.*)/i) {
1843 if (!$initial_in_reply_to || $thread) {
1847 elsif (!/^Date:\s/i && /^[-A-Za-z]+:\s+\S/) {
1851 # In the traditional
1852 # "send lots of email" format,
1855 # So let's support that, too.
1856 $input_format = 'lots';
1857 if (@cc == 0 && !$suppress_cc{'cc'}) {
1858 printf(__
("(non-mbox) Adding cc: %s from line '%s'\n"),
1859 $_, $_) unless $quiet;
1861 } elsif (!defined $subject) {
1866 # Now parse the message body
1869 if (/^([a-z][a-z-]*-by|Cc): (.*)/i) {
1871 my ($what, $c) = ($1, $2);
1872 # strip garbage for the address we'll use:
1873 $c = strip_garbage_one_address
($c);
1874 # sanitize a bit more to decide whether to suppress the address:
1875 my $sc = sanitize_address
($c);
1876 if ($sc eq $sender) {
1877 next if ($suppress_cc{'self'});
1879 if ($what =~ /^Signed-off-by$/i) {
1880 next if $suppress_cc{'sob'};
1881 } elsif ($what =~ /-by$/i) {
1882 next if $suppress_cc{'misc-by'};
1883 } elsif ($what =~ /Cc/i) {
1884 next if $suppress_cc{'bodycc'};
1887 if ($c !~ /.+@.+|<.+>/) {
1888 printf("(body) Ignoring %s from line '%s'\n",
1889 $what, $_) unless $quiet;
1893 printf(__
("(body) Adding cc: %s from line '%s'\n"),
1894 $c, $_) unless $quiet;
1899 push @to, recipients_cmd
("to-cmd", "to", $to_cmd, $t, $quiet)
1901 push @cc, recipients_cmd
("cc-cmd", "cc", $cc_cmd, $t, $quiet)
1902 if defined $cc_cmd && !$suppress_cc{'cccmd'};
1904 if ($broken_encoding{$t} && !$has_content_type) {
1905 $xfer_encoding = '8bit' if not defined $xfer_encoding;
1906 $has_content_type = 1;
1907 push @xh, "Content-Type: text/plain; charset=$auto_8bit_encoding";
1908 $body_encoding = $auto_8bit_encoding;
1911 if ($broken_encoding{$t} && !is_rfc2047_quoted
($subject)) {
1912 $subject = quote_subject
($subject, $auto_8bit_encoding);
1915 if (defined $sauthor and $sauthor ne $sender) {
1916 $message = "From: $author\n\n$message";
1917 if (defined $author_encoding) {
1918 if ($has_content_type) {
1919 if ($body_encoding eq $author_encoding) {
1920 # ok, we already have the right encoding
1923 # uh oh, we should re-encode
1927 $xfer_encoding = '8bit' if not defined $xfer_encoding;
1928 $has_content_type = 1;
1930 "Content-Type: text/plain; charset=$author_encoding";
1934 $xfer_encoding = '8bit' if not defined $xfer_encoding;
1935 ($message, $xfer_encoding) = apply_transfer_encoding
(
1936 $message, $xfer_encoding, $target_xfer_encoding);
1937 push @xh, "Content-Transfer-Encoding: $xfer_encoding";
1938 unshift @xh, 'MIME-Version: 1.0' unless $has_mime_version;
1941 $confirm eq "always" or
1942 ($confirm =~ /^(?:auto|cc)$/ && @cc) or
1943 ($confirm =~ /^(?:auto|compose)$/ && $compose && $message_num == 1));
1944 $needs_confirm = "inform" if ($needs_confirm && $confirm_unconfigured && @cc);
1946 @to = process_address_list
(@to);
1947 @cc = process_address_list
(@cc);
1949 @to = (@initial_to, @to);
1950 @cc = (@initial_cc, @cc);
1952 if ($message_num == 1) {
1953 if (defined $cover_cc and $cover_cc) {
1956 if (defined $cover_to and $cover_to) {
1962 # Prepares the email, prompts the user, and sends it out
1963 # Returns 0 if an edit was done and the function should be called again, or 1
1964 # on the email being successfully sent out.
1968 pre_process_file
($t, $quiet);
1970 my $message_was_sent = send_message
();
1971 if ($message_was_sent == -1) {
1976 # set up for the next message
1978 if ($message_was_sent &&
1979 ($chain_reply_to || !defined $in_reply_to || length($in_reply_to) == 0 ||
1980 $message_num == 1)) {
1981 $in_reply_to = $message_id;
1982 if (length $references > 0) {
1983 $references .= "\n $message_id";
1985 $references = "$message_id";
1988 } elsif (!defined $initial_in_reply_to) {
1989 # --thread and --in-reply-to manage the "In-Reply-To" header and by
1990 # extension the "References" header. If these commands are not used, reset
1991 # the header values to their defaults.
1992 $in_reply_to = undef;
1995 $message_id = undef;
1997 if (defined $batch_size && $num_sent == $batch_size) {
1999 $smtp->quit if defined $smtp;
2002 sleep($relogin_delay) if defined $relogin_delay;
2008 sub initialize_modified_loop_vars
{
2009 $in_reply_to = $initial_in_reply_to;
2010 $references = $initial_in_reply_to || '';
2015 # FIFOs can only be read once, exclude them from validation.
2016 my @real_files = ();
2017 foreach my $f (@files) {
2019 push(@real_files, $f);
2023 # Run the loop once again to avoid gaps in the counter due to FIFO
2024 # arguments provided by the user.
2026 my $num_files = scalar @real_files;
2027 $ENV{GIT_SENDEMAIL_FILE_TOTAL
} = "$num_files";
2028 initialize_modified_loop_vars
();
2029 foreach my $r (@real_files) {
2030 $ENV{GIT_SENDEMAIL_FILE_COUNTER
} = "$num";
2031 pre_process_file
($r, 1);
2032 validate_patch
($r, $target_xfer_encoding);
2035 delete $ENV{GIT_SENDEMAIL_FILE_COUNTER
};
2036 delete $ENV{GIT_SENDEMAIL_FILE_TOTAL
};
2039 initialize_modified_loop_vars
();
2040 foreach my $t (@files) {
2041 while (!process_file
($t)) {
2042 # user edited the file
2046 # Execute a command and return its output lines as an array. Blank
2047 # lines which do not appear at the end of the output are reported as
2050 my ($prefix, $cmd, $file) = @_;
2052 my $seen_blank_line = 0;
2053 open my $fh, "-|", "$cmd \Q$file\E"
2054 or die sprintf(__
("(%s) Could not execute '%s'"), $prefix, $cmd);
2055 while (my $line = <$fh>) {
2056 die sprintf(__
("(%s) Malformed output from '%s'"), $prefix, $cmd)
2057 if $seen_blank_line;
2058 if ($line =~ /^$/) {
2059 $seen_blank_line = $line =~ /^$/;
2065 or die sprintf(__
("(%s) failed to close pipe to '%s'"), $prefix, $cmd);
2069 # Process headers lines, unfolding multiline headers as defined by RFC
2071 sub unfold_headers
{
2075 if (/^\s+\S/ and @headers) {
2076 chomp($headers[$#headers]);
2078 $headers[$#headers] .= $_;
2086 # Invoke the provided CMD with FILE as an argument, which should
2087 # output RFC 2822 email headers. Fold multiline headers and return the
2088 # headers as an array.
2089 sub invoke_header_cmd
{
2090 my ($cmd, $file) = @_;
2091 my @lines = execute_cmd
("header-cmd", $header_cmd, $file);
2092 return unfold_headers
(@lines);
2095 # Execute a command (e.g. $to_cmd) to get a list of email addresses
2096 # and return a results array
2097 sub recipients_cmd
{
2098 my ($prefix, $what, $cmd, $file, $quiet) = @_;
2102 @lines = execute_cmd
($prefix, $cmd, $file);
2103 for my $address (@lines) {
2104 $address =~ s/^\s*//g;
2105 $address =~ s/\s*$//g;
2106 $address = sanitize_address
($address);
2107 next if ($address eq $sender and $suppress_cc{'self'});
2108 push @addresses, $address;
2109 printf(__
("(%s) Adding %s: %s from: '%s'\n"),
2110 $prefix, $what, $address, $cmd) unless $quiet;
2115 cleanup_compose_files
();
2117 sub cleanup_compose_files
{
2118 unlink($compose_filename, $compose_filename . ".final") if $compose;
2121 $smtp->quit if $smtp;
2123 sub apply_transfer_encoding
{
2124 my $message = shift;
2128 return ($message, $to) if ($from eq $to and $from ne '7bit');
2130 require MIME
::QuotedPrint
;
2131 require MIME
::Base64
;
2133 $message = MIME
::QuotedPrint
::decode
($message)
2134 if ($from eq 'quoted-printable');
2135 $message = MIME
::Base64
::decode
($message)
2136 if ($from eq 'base64');
2138 $to = ($message =~ /(?:.{999,}|\r)/) ?
'quoted-printable' : '8bit'
2141 die __
("cannot send message as 7bit")
2142 if ($to eq '7bit' and $message =~ /[^[:ascii:]]/);
2143 return ($message, $to)
2144 if ($to eq '7bit' or $to eq '8bit');
2145 return (MIME
::QuotedPrint
::encode
($message, "\n", 0), $to)
2146 if ($to eq 'quoted-printable');
2147 return (MIME
::Base64
::encode
($message, "\n"), $to)
2148 if ($to eq 'base64');
2149 die __
("invalid transfer encoding");
2152 sub unique_email_list
{
2156 foreach my $entry (@_) {
2157 my $clean = extract_valid_address_or_die
($entry);
2158 $seen{$clean} ||= 0;
2159 next if $seen{$clean}++;
2160 push @emails, $entry;
2165 sub validate_patch
{
2166 my ($fn, $xfer_encoding) = @_;
2169 my $hook_name = 'sendemail-validate';
2170 my $hooks_path = $repo->command_oneline('rev-parse', '--git-path', 'hooks');
2172 my $validate_hook = File
::Spec
->catfile($hooks_path, $hook_name);
2174 if (-x
$validate_hook) {
2176 my $target = Cwd
::abs_path
($fn);
2177 # The hook needs a correct cwd and GIT_DIR.
2178 my $cwd_save = Cwd
::getcwd
();
2179 chdir($repo->wc_path() or $repo->repo_path())
2180 or die("chdir: $!");
2181 local $ENV{"GIT_DIR"} = $repo->repo_path();
2183 my ($recipients_ref, $to, $date, $gitversion, $cc, $ccline, $header) = gen_header
();
2186 my ($header_filehandle, $header_filename) = File
::Temp
::tempfile
(
2187 TEMPLATE
=> ".gitsendemail.header.XXXXXX",
2188 DIR
=> $repo->repo_path(),
2191 print $header_filehandle $header;
2193 my @cmd = ("git", "hook", "run", "--ignore-missing",
2195 my @cmd_msg = (@cmd, "<patch>", "<header>");
2196 my @cmd_run = (@cmd, $target, $header_filename);
2197 $hook_error = system_or_msg
(\
@cmd_run, undef, "@cmd_msg");
2198 chdir($cwd_save) or die("chdir: $!");
2201 $hook_error = sprintf(
2202 __
("fatal: %s: rejected by %s hook\n%s\nwarning: no patches were sent\n"),
2203 $fn, $hook_name, $hook_error);
2208 # Any long lines will be automatically fixed if we use a suitable transfer
2210 unless ($xfer_encoding =~ /^(?:auto|quoted-printable|base64)$/) {
2211 open(my $fh, '<', $fn)
2212 or die sprintf(__
("unable to open %s: %s\n"), $fn, $!);
2213 while (my $line = <$fh>) {
2214 if (length($line) > 998) {
2215 die sprintf(__
("fatal: %s:%d is longer than 998 characters\n" .
2216 "warning: no patches were sent\n"), $fn, $.);
2224 my ($last, $lastlen, $file, $known_suffix) = @_;
2225 my ($suffix, $skip);
2228 if (defined $last &&
2229 ($lastlen < length($file)) &&
2230 (substr($file, 0, $lastlen) eq $last) &&
2231 ($suffix = substr($file, $lastlen)) !~ /^[a-z0-9]/i) {
2232 if (defined $known_suffix && $suffix eq $known_suffix) {
2233 printf(__
("Skipping %s with backup suffix '%s'.\n"), $file, $known_suffix);
2236 # TRANSLATORS: please keep "[y|N]" as is.
2237 my $answer = ask
(sprintf(__
("Do you really want to send %s? [y|N]: "), $file),
2238 valid_re
=> qr/^(?:y|n)/i,
2240 $skip = ($answer ne 'y');
2242 $known_suffix = $suffix;
2246 return ($skip, $known_suffix);
2249 sub handle_backup_files
{
2251 my ($last, $lastlen, $known_suffix, $skip, @result);
2252 for my $file (@file) {
2253 ($skip, $known_suffix) = handle_backup
($last, $lastlen,
2254 $file, $known_suffix);
2255 push @result, $file unless $skip;
2257 $lastlen = length($file);
2262 sub file_has_nonascii
{
2264 open(my $fh, '<', $fn)
2265 or die sprintf(__
("unable to open %s: %s\n"), $fn, $!);
2266 while (my $line = <$fh>) {
2267 return 1 if $line =~ /[^[:ascii:]]/;
2272 sub body_or_subject_has_nonascii
{
2274 open(my $fh, '<', $fn)
2275 or die sprintf(__
("unable to open %s: %s\n"), $fn, $!);
2276 while (my $line = <$fh>) {
2277 last if $line =~ /^$/;
2278 return 1 if $line =~ /^Subject.*[^[:ascii:]]/;
2280 while (my $line = <$fh>) {
2281 return 1 if $line =~ /[^[:ascii:]]/;