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 --suppress-cc <str> * author, self, sob, cc, cccmd, body, bodycc, misc-by, all.
93 --[no-]cc-cover * Email Cc: addresses in the cover letter.
94 --[no-]to-cover * Email To: addresses in the cover letter.
95 --[no-]signed-off-by-cc * Send to Signed-off-by: addresses. Default on.
96 --[no-]suppress-from * Send to self. Default off.
97 --[no-]chain-reply-to * Chain In-Reply-To: fields. Default off.
98 --[no-]thread * Use In-Reply-To: field. Default on.
101 --confirm <str> * Confirm recipients before sending;
102 auto, cc, compose, always, or never.
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.
106 --[no-]format-patch * understand any non optional arguments as
107 `git format-patch` ones.
108 --force * Send even if safety checks would prevent it.
111 --dump-aliases * Dump configured aliases and exit.
119 grep !$seen{$_}++, @_;
122 sub completion_helper
{
123 my ($original_opts) = @_;
124 my %not_for_completion = (
125 "git-completion-helper" => undef,
128 my @send_email_opts = ();
130 foreach my $key (keys %$original_opts) {
131 unless (exists $not_for_completion{$key}) {
134 if ($key =~ /[:=][si]$/) {
135 $key =~ s/[:=][si]$//;
136 push (@send_email_opts, "--$_=") foreach (split (/\|/, $key));
138 push (@send_email_opts, "--$_") foreach (split (/\|/, $key));
143 my @format_patch_opts = split(/ /, Git
::command
('format-patch', '--git-completion-helper'));
144 my @opts = (@send_email_opts, @format_patch_opts);
145 @opts = uniq
(grep !/^$/, @opts);
146 # There's an implicit '\n' here already, no need to add an explicit one.
151 # most mail servers generate the Date: header, but not all...
152 sub format_2822_time
{
154 my @localtm = localtime($time);
155 my @gmttm = gmtime($time);
156 my $localmin = $localtm[1] + $localtm[2] * 60;
157 my $gmtmin = $gmttm[1] + $gmttm[2] * 60;
158 if ($localtm[0] != $gmttm[0]) {
159 die __
("local zone differs from GMT by a non-minute interval\n");
161 if ((($gmttm[6] + 1) % 7) == $localtm[6]) {
163 } elsif ((($gmttm[6] - 1) % 7) == $localtm[6]) {
165 } elsif ($gmttm[6] != $localtm[6]) {
166 die __
("local time offset greater than or equal to 24 hours\n");
168 my $offset = $localmin - $gmtmin;
169 my $offhour = $offset / 60;
170 my $offmin = abs($offset % 60);
171 if (abs($offhour) >= 24) {
172 die __
("local time offset greater than or equal to 24 hours\n");
175 return sprintf("%s, %2d %s %d %02d:%02d:%02d %s%02d%02d",
176 qw(Sun Mon Tue Wed Thu Fri Sat)[$localtm[6]],
178 qw(Jan Feb Mar Apr May Jun
179 Jul Aug Sep Oct Nov Dec)[$localtm[4]],
184 ($offset >= 0) ?
'+' : '-',
194 # Regexes for RFC 2047 productions.
195 my $re_token = qr/[^][()<>@,;:\\"\/?
.= \000-\037\177-\377]+/;
196 my $re_encoded_text = qr/[^? \000-\037\177-\377]+/;
197 my $re_encoded_word = qr/=\?($re_token)\?($re_token)\?($re_encoded_text)\?=/;
199 # Variables we fill in automatically, or via prompting:
200 my (@to,@cc,@xh,$envelope_sender,
201 $initial_in_reply_to,$reply_to,$initial_subject,@files,
202 $author,$sender,$smtp_authpass,$annotate,$compose,$time);
203 # Things we either get from config, *or* are overridden on the
205 my ($no_cc, $no_to, $no_bcc, $no_identity);
206 my (@config_to, @getopt_to);
207 my (@config_cc, @getopt_cc);
208 my (@config_bcc, @getopt_bcc);
211 #$initial_in_reply_to = ''; #<20050203173208.GA23964@foobar.com>';
213 my $repo = eval { Git
->repository() };
214 my @repo = $repo ?
($repo) : ();
216 # Behavior modification variables
217 my ($quiet, $dry_run) = (0, 0);
219 my $compose_filename;
221 my $dump_aliases = 0;
223 # Variables to prevent short format-patch options from being captured
224 # as abbreviated send-email options
227 # Handle interactive edition of files.
232 my ($args, $msg, $cmd_name) = @_;
234 my $signalled = $?
& 127;
235 my $exit_code = $?
>> 8;
236 return unless $signalled or $exit_code;
238 my @sprintf_args = ($cmd_name ?
$cmd_name : $args->[0], $exit_code);
240 # Quiet the 'redundant' warning category, except we
241 # need to support down to Perl 5.8, so we can't do a
242 # "no warnings 'redundant'", since that category was
243 # introduced in perl 5.22, and asking for it will die
246 return sprintf($msg, @sprintf_args);
248 return sprintf(__
("fatal: command '%s' died with exit code %d"),
253 my $msg = system_or_msg
(@_);
258 if (!defined($editor)) {
259 $editor = Git
::command_oneline
('var', 'GIT_EDITOR');
261 my $die_msg = __
("the editor exited uncleanly, aborting everything");
262 if (defined($multiedit) && !$multiedit) {
263 system_or_die
(['sh', '-c', $editor.' "$@"', $editor, $_], $die_msg) for @_;
265 system_or_die
(['sh', '-c', $editor.' "$@"', $editor, @_], $die_msg);
269 # Variables with corresponding config settings
270 my ($suppress_from, $signed_off_by_cc);
271 my ($cover_cc, $cover_to);
272 my ($to_cmd, $cc_cmd);
273 my ($smtp_server, $smtp_server_port, @smtp_server_options);
274 my ($smtp_authuser, $smtp_encryption, $smtp_ssl_cert_path);
275 my ($batch_size, $relogin_delay);
276 my ($identity, $aliasfiletype, @alias_files, $smtp_domain, $smtp_auth);
279 my ($auto_8bit_encoding);
280 my ($compose_encoding);
282 # Variables with corresponding config settings & hardcoded defaults
283 my ($debug_net_smtp) = 0; # Net::SMTP, see send_message()
285 my $chain_reply_to = 0;
288 my $target_xfer_encoding = 'auto';
289 my $forbid_sendmail_variables = 1;
291 my %config_bool_settings = (
292 "thread" => \
$thread,
293 "chainreplyto" => \
$chain_reply_to,
294 "suppressfrom" => \
$suppress_from,
295 "signedoffbycc" => \
$signed_off_by_cc,
296 "cccover" => \
$cover_cc,
297 "tocover" => \
$cover_to,
298 "signedoffcc" => \
$signed_off_by_cc,
299 "validate" => \
$validate,
300 "multiedit" => \
$multiedit,
301 "annotate" => \
$annotate,
302 "xmailer" => \
$use_xmailer,
303 "forbidsendmailvariables" => \
$forbid_sendmail_variables,
306 my %config_settings = (
307 "smtpencryption" => \
$smtp_encryption,
308 "smtpserver" => \
$smtp_server,
309 "smtpserverport" => \
$smtp_server_port,
310 "smtpserveroption" => \
@smtp_server_options,
311 "smtpuser" => \
$smtp_authuser,
312 "smtppass" => \
$smtp_authpass,
313 "smtpdomain" => \
$smtp_domain,
314 "smtpauth" => \
$smtp_auth,
315 "smtpbatchsize" => \
$batch_size,
316 "smtprelogindelay" => \
$relogin_delay,
321 "aliasfiletype" => \
$aliasfiletype,
322 "bcc" => \
@config_bcc,
323 "suppresscc" => \
@suppress_cc,
324 "envelopesender" => \
$envelope_sender,
325 "confirm" => \
$confirm,
327 "assume8bitencoding" => \
$auto_8bit_encoding,
328 "composeencoding" => \
$compose_encoding,
329 "transferencoding" => \
$target_xfer_encoding,
330 "sendmailcmd" => \
$sendmail_cmd,
333 my %config_path_settings = (
334 "aliasesfile" => \
@alias_files,
335 "smtpsslcertpath" => \
$smtp_ssl_cert_path,
338 # Handle Uncouth Termination
341 require Term
::ANSIColor
;
342 print Term
::ANSIColor
::color
("reset"), "\n";
344 # SMTP password masked
347 # tmp files from --compose
348 if (defined $compose_filename) {
349 if (-e
$compose_filename) {
350 printf __
("'%s' contains an intermediate version ".
351 "of the email you were composing.\n"),
354 if (-e
($compose_filename . ".final")) {
355 printf __
("'%s.final' contains the composed email.\n"),
363 $SIG{TERM
} = \
&signal_handler
;
364 $SIG{INT
} = \
&signal_handler
;
366 # Read our sendemail.* config
368 my ($known_keys, $configured, $prefix) = @_;
370 foreach my $setting (keys %config_bool_settings) {
371 my $target = $config_bool_settings{$setting};
372 my $key = "$prefix.$setting";
373 next unless exists $known_keys->{$key};
374 my $v = (@
{$known_keys->{$key}} == 1 &&
375 (defined $known_keys->{$key}->[0] &&
376 $known_keys->{$key}->[0] =~ /^(?:true|false)$/s))
377 ?
$known_keys->{$key}->[0] eq 'true'
378 : Git
::config_bool
(@repo, $key);
379 next unless defined $v;
380 next if $configured->{$setting}++;
384 foreach my $setting (keys %config_path_settings) {
385 my $target = $config_path_settings{$setting};
386 my $key = "$prefix.$setting";
387 next unless exists $known_keys->{$key};
388 if (ref($target) eq "ARRAY") {
389 my @values = Git
::config_path
(@repo, $key);
391 next if $configured->{$setting}++;
395 my $v = Git
::config_path
(@repo, "$prefix.$setting");
396 next unless defined $v;
397 next if $configured->{$setting}++;
402 foreach my $setting (keys %config_settings) {
403 my $target = $config_settings{$setting};
404 my $key = "$prefix.$setting";
405 next unless exists $known_keys->{$key};
406 if (ref($target) eq "ARRAY") {
407 my @values = @
{$known_keys->{$key}};
408 @values = grep { defined } @values;
409 next if $configured->{$setting}++;
413 my $v = $known_keys->{$key}->[-1];
414 next unless defined $v;
415 next if $configured->{$setting}++;
425 my $ret = Git
::command
(
432 # We must always return ($k, $v) here, since
433 # empty config values will be just "key\0",
434 # not "key\nvalue\0".
435 my ($k, $v) = split /\n/, $_, 2;
440 # If we have no keys we're OK, otherwise re-throw
441 die $@
if $@
->value != 1;
446 # Save ourselves a lot of work of shelling out to 'git config' (it
447 # parses 'bool' etc.) by only doing so for config keys that exist.
448 my %known_config_keys;
450 my @kv = config_regexp
("^sende?mail[.]");
451 while (my ($k, $v) = splice @kv, 0, 2) {
452 push @
{$known_config_keys{$k}} => $v;
456 # sendemail.identity yields to --identity. We must parse this
457 # special-case first before the rest of the config is read.
459 my $key = "sendemail.identity";
460 $identity = Git
::config
(@repo, $key) if exists $known_config_keys{$key};
462 my %identity_options = (
463 "identity=s" => \
$identity,
464 "no-identity" => \
$no_identity,
466 my $rc = GetOptions
(%identity_options);
468 undef $identity if $no_identity;
470 # Now we know enough to read the config
473 read_config
(\
%known_config_keys, \
%configured, "sendemail.$identity") if defined $identity;
474 read_config
(\
%known_config_keys, \
%configured, "sendemail");
477 # Begin by accumulating all the variables (defined above), that we will end up
478 # needing, first, from the command line:
481 my $git_completion_helper;
482 my %dump_aliases_options = (
484 "dump-aliases" => \
$dump_aliases,
486 $rc = GetOptions
(%dump_aliases_options);
488 die __
("--dump-aliases incompatible with other options\n")
489 if !$help and $dump_aliases and @ARGV;
491 "sender|from=s" => \
$sender,
492 "in-reply-to=s" => \
$initial_in_reply_to,
493 "reply-to=s" => \
$reply_to,
494 "subject=s" => \
$initial_subject,
495 "to=s" => \
@getopt_to,
496 "to-cmd=s" => \
$to_cmd,
498 "cc=s" => \
@getopt_cc,
500 "bcc=s" => \
@getopt_bcc,
501 "no-bcc" => \
$no_bcc,
502 "chain-reply-to!" => \
$chain_reply_to,
503 "no-chain-reply-to" => sub {$chain_reply_to = 0},
504 "sendmail-cmd=s" => \
$sendmail_cmd,
505 "smtp-server=s" => \
$smtp_server,
506 "smtp-server-option=s" => \
@smtp_server_options,
507 "smtp-server-port=s" => \
$smtp_server_port,
508 "smtp-user=s" => \
$smtp_authuser,
509 "smtp-pass:s" => \
$smtp_authpass,
510 "smtp-ssl" => sub { $smtp_encryption = 'ssl' },
511 "smtp-encryption=s" => \
$smtp_encryption,
512 "smtp-ssl-cert-path=s" => \
$smtp_ssl_cert_path,
513 "smtp-debug:i" => \
$debug_net_smtp,
514 "smtp-domain:s" => \
$smtp_domain,
515 "smtp-auth=s" => \
$smtp_auth,
516 "no-smtp-auth" => sub {$smtp_auth = 'none'},
517 "annotate!" => \
$annotate,
518 "no-annotate" => sub {$annotate = 0},
519 "compose" => \
$compose,
521 "cc-cmd=s" => \
$cc_cmd,
522 "suppress-from!" => \
$suppress_from,
523 "no-suppress-from" => sub {$suppress_from = 0},
524 "suppress-cc=s" => \
@suppress_cc,
525 "signed-off-cc|signed-off-by-cc!" => \
$signed_off_by_cc,
526 "no-signed-off-cc|no-signed-off-by-cc" => sub {$signed_off_by_cc = 0},
527 "cc-cover|cc-cover!" => \
$cover_cc,
528 "no-cc-cover" => sub {$cover_cc = 0},
529 "to-cover|to-cover!" => \
$cover_to,
530 "no-to-cover" => sub {$cover_to = 0},
531 "confirm=s" => \
$confirm,
532 "dry-run" => \
$dry_run,
533 "envelope-sender=s" => \
$envelope_sender,
534 "thread!" => \
$thread,
535 "no-thread" => sub {$thread = 0},
536 "validate!" => \
$validate,
537 "no-validate" => sub {$validate = 0},
538 "transfer-encoding=s" => \
$target_xfer_encoding,
539 "format-patch!" => \
$format_patch,
540 "no-format-patch" => sub {$format_patch = 0},
541 "8bit-encoding=s" => \
$auto_8bit_encoding,
542 "compose-encoding=s" => \
$compose_encoding,
544 "xmailer!" => \
$use_xmailer,
545 "no-xmailer" => sub {$use_xmailer = 0},
546 "batch-size=i" => \
$batch_size,
547 "relogin-delay=i" => \
$relogin_delay,
548 "git-completion-helper" => \
$git_completion_helper,
549 "v=s" => \
$reroll_count,
551 $rc = GetOptions
(%options);
553 # Munge any "either config or getopt, not both" variables
554 my @initial_to = @getopt_to ?
@getopt_to : ($no_to ?
() : @config_to);
555 my @initial_cc = @getopt_cc ?
@getopt_cc : ($no_cc ?
() : @config_cc);
556 my @initial_bcc = @getopt_bcc ?
@getopt_bcc : ($no_bcc ?
() : @config_bcc);
559 my %all_options = (%options, %dump_aliases_options, %identity_options);
560 completion_helper
(\
%all_options) if $git_completion_helper;
565 if ($forbid_sendmail_variables && grep { /^sendmail/s } keys %known_config_keys) {
566 die __
("fatal: found configuration options for 'sendmail'\n" .
567 "git-send-email is configured with the sendemail.* options - note the 'e'.\n" .
568 "Set sendemail.forbidSendmailVariables to false to disable this check.\n");
571 die __
("Cannot run git format-patch from outside a repository\n")
572 if $format_patch and not $repo;
574 die __
("`batch-size` and `relogin` must be specified together " .
575 "(via command-line or configuration option)\n")
576 if defined $relogin_delay and not defined $batch_size;
578 # 'default' encryption is none -- this only prevents a warning
579 $smtp_encryption = '' unless (defined $smtp_encryption);
581 # Set CC suppressions
584 foreach my $entry (@suppress_cc) {
585 # Please update $__git_send_email_suppresscc_options
586 # in git-completion.bash when you add new options.
587 die sprintf(__
("Unknown --suppress-cc field: '%s'\n"), $entry)
588 unless $entry =~ /^(?:all|cccmd|cc|author|self|sob|body|bodycc|misc-by)$/;
589 $suppress_cc{$entry} = 1;
593 if ($suppress_cc{'all'}) {
594 foreach my $entry (qw
(cccmd cc author self sob body bodycc misc
-by
)) {
595 $suppress_cc{$entry} = 1;
597 delete $suppress_cc{'all'};
600 # If explicit old-style ones are specified, they trump --suppress-cc.
601 $suppress_cc{'self'} = $suppress_from if defined $suppress_from;
602 $suppress_cc{'sob'} = !$signed_off_by_cc if defined $signed_off_by_cc;
604 if ($suppress_cc{'body'}) {
605 foreach my $entry (qw
(sob bodycc misc
-by
)) {
606 $suppress_cc{$entry} = 1;
608 delete $suppress_cc{'body'};
611 # Set confirm's default value
612 my $confirm_unconfigured = !defined $confirm;
613 if ($confirm_unconfigured) {
614 $confirm = scalar %suppress_cc ?
'compose' : 'auto';
616 # Please update $__git_send_email_confirm_options in
617 # git-completion.bash when you add new options.
618 die sprintf(__
("Unknown --confirm setting: '%s'\n"), $confirm)
619 unless $confirm =~ /^(?:auto|cc|compose|always|never)/;
621 # Debugging, print out the suppressions.
623 print "suppressions:\n";
624 foreach my $entry (keys %suppress_cc) {
625 printf " %-5s -> $suppress_cc{$entry}\n", $entry;
629 my ($repoauthor, $repocommitter);
632 my ($author, $committer);
635 return $cache{$what} if exists $cache{$what};
636 ($cache{$what}) = Git
::ident_person
(@repo, $what);
637 return $cache{$what};
639 $repoauthor = sub { $common->('author') };
640 $repocommitter = sub { $common->('committer') };
643 sub parse_address_line
{
644 require Git
::LoadCPAN
::Mail
::Address
;
645 return map { $_->format } Mail
::Address
->parse($_[0]);
649 require Text
::ParseWords
;
650 return Text
::ParseWords
::quotewords
('\s*,\s*', 1, @_);
655 sub parse_sendmail_alias
{
658 printf STDERR __
("warning: sendmail alias with quotes is not supported: %s\n"), $_;
659 } elsif (/:include:/) {
660 printf STDERR __
("warning: `:include:` not supported: %s\n"), $_;
662 printf STDERR __
("warning: `/file` or `|pipe` redirection not supported: %s\n"), $_;
663 } elsif (/^(\S+?)\s*:\s*(.+)$/) {
664 my ($alias, $addr) = ($1, $2);
665 $aliases{$alias} = [ split_addrs
($addr) ];
667 printf STDERR __
("warning: sendmail line is not recognized: %s\n"), $_;
671 sub parse_sendmail_aliases
{
676 next if /^\s*$/ || /^\s*#/;
677 $s .= $_, next if $s =~ s/\\$// || s/^\s+//;
678 parse_sendmail_alias
($s) if $s;
681 $s =~ s/\\$//; # silently tolerate stray '\' on last line
682 parse_sendmail_alias
($s) if $s;
686 # multiline formats can be supported in the future
687 mutt
=> sub { my $fh = shift; while (<$fh>) {
688 if (/^\s*alias\s+(?:-group\s+\S+\s+)*(\S+)\s+(.*)$/) {
689 my ($alias, $addr) = ($1, $2);
690 $addr =~ s/#.*$//; # mutt allows # comments
691 # commas delimit multiple addresses
692 my @addr = split_addrs
($addr);
694 # quotes may be escaped in the file,
695 # unescape them so we do not double-escape them later.
696 s/\\"/"/g foreach @addr;
697 $aliases{$alias} = \
@addr
699 mailrc
=> sub { my $fh = shift; while (<$fh>) {
700 if (/^alias\s+(\S+)\s+(.*?)\s*$/) {
701 require Text
::ParseWords
;
702 # spaces delimit multiple addresses
703 $aliases{$1} = [ Text
::ParseWords
::quotewords
('\s+', 0, $2) ];
705 pine
=> sub { my $fh = shift; my $f='\t[^\t]*';
706 for (my $x = ''; defined($x); $x = $_) {
708 $x .= $1 while(defined($_ = <$fh>) && /^ +(.*)$/);
709 $x =~ /^(\S+)$f\t\(?([^\t]+?)\)?(:?$f){0,2}$/ or next;
710 $aliases{$1} = [ split_addrs
($2) ];
712 elm
=> sub { my $fh = shift;
714 if (/^(\S+)\s+=\s+[^=]+=\s(\S+)/) {
715 my ($alias, $addr) = ($1, $2);
716 $aliases{$alias} = [ split_addrs
($addr) ];
719 sendmail
=> \
&parse_sendmail_aliases
,
720 gnus
=> sub { my $fh = shift; while (<$fh>) {
721 if (/\(define-mail-alias\s+"(\S+?)"\s+"(\S+?)"\)/) {
722 $aliases{$1} = [ $2 ];
724 # Please update _git_config() in git-completion.bash when you
728 if (@alias_files and $aliasfiletype and defined $parse_alias{$aliasfiletype}) {
729 foreach my $file (@alias_files) {
730 open my $fh, '<', $file or die "opening $file: $!\n";
731 $parse_alias{$aliasfiletype}->($fh);
737 print "$_\n" for (sort keys %aliases);
741 # is_format_patch_arg($f) returns 0 if $f names a patch, or 1 if
742 # $f is a revision list specification to be passed to format-patch.
743 sub is_format_patch_arg
{
747 $repo->command('rev-parse', '--verify', '--quiet', $f);
748 if (defined($format_patch)) {
749 return $format_patch;
751 die sprintf(__
(<<EOF), $f, $f);
752 File '%s' exists but it could also be the range of commits
753 to produce patches for. Please disambiguate by...
755 * Saying "./%s" if you mean a file; or
756 * Giving --format-patch option if you mean a range.
758 } catch Git
::Error
::Command with
{
759 # Not a valid revision. Treat it as a filename.
764 # Now that all the defaults are set, process the rest of the command line
765 # arguments and collect up the files that need to be processed.
767 while (defined(my $f = shift @ARGV)) {
769 push @rev_list_opts, "--", @ARGV;
771 } elsif (-d
$f and !is_format_patch_arg
($f)) {
773 or die sprintf(__
("Failed to opendir %s: %s"), $f, $!);
776 push @files, grep { -f
$_ } map { File
::Spec
->catfile($f, $_) }
779 } elsif ((-f
$f or -p
$f) and !is_format_patch_arg
($f)) {
782 push @rev_list_opts, $f;
786 if (@rev_list_opts) {
787 die __
("Cannot run git format-patch from outside a repository\n")
790 push @files, $repo->command('format-patch', '-o', File
::Temp
::tempdir
(CLEANUP
=> 1),
791 defined $reroll_count ?
('-v', $reroll_count) : (),
795 @files = handle_backup_files
(@files);
798 foreach my $f (@files) {
800 validate_patch
($f, $target_xfer_encoding);
807 print $_,"\n" for (@files);
810 print STDERR __
("\nNo patch files specified!\n\n");
814 sub get_patch_subject
{
816 open (my $fh, '<', $fn);
817 while (my $line = <$fh>) {
818 next unless ($line =~ /^Subject: (.*)$/);
823 die sprintf(__
("No subject line in %s?"), $fn);
827 # Note that this does not need to be secure, but we will make a small
828 # effort to have it be unique
830 $compose_filename = ($repo ?
831 File
::Temp
::tempfile
(".gitsendemail.msg.XXXXXX", DIR
=> $repo->repo_path()) :
832 File
::Temp
::tempfile
(".gitsendemail.msg.XXXXXX", DIR
=> "."))[1];
833 open my $c, ">", $compose_filename
834 or die sprintf(__
("Failed to open for writing %s: %s"), $compose_filename, $!);
837 my $tpl_sender = $sender || $repoauthor->() || $repocommitter->() || '';
838 my $tpl_subject = $initial_subject || '';
839 my $tpl_in_reply_to = $initial_in_reply_to || '';
840 my $tpl_reply_to = $reply_to || '';
842 print $c <<EOT1, Git::prefix_lines("GIT: ", __(<<EOT2)), <<EOT3;
843 From $tpl_sender # This line is ignored.
845 Lines beginning in "GIT:" will be removed.
846 Consider including an overall diffstat or table of contents
847 for the patch you are writing.
849 Clear the body content if you don't wish to send a summary.
852 Reply-To: $tpl_reply_to
853 Subject: $tpl_subject
854 In-Reply-To: $tpl_in_reply_to
858 print $c get_patch_subject($f);
863 do_edit($compose_filename, @files);
865 do_edit($compose_filename);
868 open $c, "<", $compose_filename
869 or die sprintf(__("Failed to open %s: %s"), $compose_filename, $!);
871 if (!defined $compose_encoding) {
872 $compose_encoding = "UTF-8";
876 while (my $line = <$c>) {
877 next if $line =~ m/^GIT:/;
878 parse_header_line($line, \%parsed_email);
880 $parsed_email{'body'} = filter_body($c);
885 open my $c2, ">", $compose_filename . ".final"
886 or die sprintf(__("Failed to open %s.final: %s"), $compose_filename, $!);
889 if ($parsed_email{'From'}) {
890 $sender = delete($parsed_email{'From'});
892 if ($parsed_email{'In-Reply-To'}) {
893 $initial_in_reply_to = delete($parsed_email{'In-Reply-To'});
895 if ($parsed_email{'Reply-To'}) {
896 $reply_to = delete($parsed_email{'Reply-To'});
898 if ($parsed_email{'Subject'}) {
899 $initial_subject = delete($parsed_email{'Subject'});
900 print $c2 "Subject: " .
901 quote_subject($initial_subject, $compose_encoding) .
905 if ($parsed_email{'MIME-Version'}) {
906 print $c2 "MIME-Version: $parsed_email{'MIME-Version'}\n",
907 "Content-Type: $parsed_email{'Content-Type'};\n",
908 "Content-Transfer-Encoding: $parsed_email{'Content-Transfer-Encoding'}\n";
909 delete($parsed_email{'MIME-Version'});
910 delete($parsed_email{'Content-Type'});
911 delete($parsed_email{'Content-Transfer-Encoding'});
912 } elsif (file_has_nonascii($compose_filename)) {
913 my $content_type = (delete($parsed_email{'Content-Type'}) or
914 "text/plain; charset=$compose_encoding");
915 print $c2 "MIME-Version: 1.0\n",
916 "Content-Type: $content_type\n",
917 "Content-Transfer-Encoding: 8bit\n";
919 # Preserve unknown headers
920 foreach my $key (keys %parsed_email) {
921 next if $key eq 'body';
922 print $c2 "$key: $parsed_email{$key}";
925 if ($parsed_email{'body'}) {
926 print $c2 "\n$parsed_email{'body'}\n";
927 delete($parsed_email{'body'});
929 print __("Summary email is empty, skipping it\n");
935 } elsif ($annotate) {
941 require Term::ReadLine;
942 $ENV{"GIT_SEND_EMAIL_NOTTY"}
943 ? Term::ReadLine->new('git-send-email', \*STDIN, \*STDOUT)
944 : Term::ReadLine->new('git-send-email');
947 $term = FakeTerm->new("$@: going non-interactive");
953 my ($prompt, %arg) = @_;
954 my $valid_re = $arg{valid_re};
955 my $default = $arg{default};
956 my $confirm_only = $arg{confirm_only};
960 return defined $default ? $default : undef
961 unless defined $term->IN and defined fileno($term->IN) and
962 defined $term->OUT and defined fileno($term->OUT);
964 $resp = $term->readline($prompt);
965 if (!defined $resp) { # EOF
967 return defined $default ? $default : undef;
969 if ($resp eq '' and defined $default) {
972 if (!defined $valid_re or $resp =~ /$valid_re/) {
976 my $yesno = $term->readline(
977 # TRANSLATORS: please keep [y/N] as is.
978 sprintf(__("Are you sure you want to use <%s> [y/N]? "), $resp));
979 if (defined $yesno && $yesno =~ /y/i) {
987 sub parse_header_line {
989 my $parsed_line = shift;
990 my $addr_pat = join "|", qw(To Cc Bcc);
992 foreach (split(/\n/, $lines)) {
993 if (/^($addr_pat):\s*(.+)$/i) {
994 $parsed_line->{$1} = [ parse_address_line
($2) ];
995 } elsif (/^([^:]*):\s*(.+)\s*$/i) {
996 $parsed_line->{$1} = $2;
1004 while (my $body_line = <$c>) {
1005 if ($body_line !~ m/^GIT:/) {
1006 $body .= $body_line;
1013 my %broken_encoding;
1015 sub file_declares_8bit_cte
{
1017 open (my $fh, '<', $fn);
1018 while (my $line = <$fh>) {
1019 last if ($line =~ /^$/);
1020 return 1 if ($line =~ /^Content-Transfer-Encoding: .*8bit.*$/);
1026 foreach my $f (@files) {
1027 next unless (body_or_subject_has_nonascii
($f)
1028 && !file_declares_8bit_cte
($f));
1029 $broken_encoding{$f} = 1;
1032 if (!defined $auto_8bit_encoding && scalar %broken_encoding) {
1033 print __
("The following files are 8bit, but do not declare " .
1034 "a Content-Transfer-Encoding.\n");
1035 foreach my $f (sort keys %broken_encoding) {
1038 $auto_8bit_encoding = ask
(__
("Which 8bit encoding should I declare [UTF-8]? "),
1039 valid_re
=> qr/.{4}/, confirm_only
=> 1,
1040 default => "UTF-8");
1044 for my $f (@files) {
1045 if (get_patch_subject
($f) =~ /\Q*** SUBJECT HERE ***\E/) {
1046 die sprintf(__
("Refusing to send because the patch\n\t%s\n"
1047 . "has the template subject '*** SUBJECT HERE ***'. "
1048 . "Pass --force if you really want to send.\n"), $f);
1053 if (defined $sender) {
1054 $sender =~ s/^\s+|\s+$//g;
1055 ($sender) = expand_aliases
($sender);
1057 $sender = $repoauthor->() || $repocommitter->() || '';
1060 # $sender could be an already sanitized address
1061 # (e.g. sendemail.from could be manually sanitized by user).
1062 # But it's a no-op to run sanitize_address on an already sanitized address.
1063 $sender = sanitize_address
($sender);
1065 my $to_whom = __
("To whom should the emails be sent (if anyone)?");
1067 if (!@initial_to && !defined $to_cmd) {
1068 my $to = ask
("$to_whom ",
1070 valid_re
=> qr/\@.*\./, confirm_only
=> 1);
1071 push @initial_to, parse_address_line
($to) if defined $to; # sanitized/validated later
1075 sub expand_aliases
{
1076 return map { expand_one_alias
($_) } @_;
1079 my %EXPANDED_ALIASES;
1080 sub expand_one_alias
{
1082 if ($EXPANDED_ALIASES{$alias}) {
1083 die sprintf(__
("fatal: alias '%s' expands to itself\n"), $alias);
1085 local $EXPANDED_ALIASES{$alias} = 1;
1086 return $aliases{$alias} ? expand_aliases
(@
{$aliases{$alias}}) : $alias;
1089 @initial_to = process_address_list
(@initial_to);
1090 @initial_cc = process_address_list
(@initial_cc);
1091 @initial_bcc = process_address_list
(@initial_bcc);
1093 if ($thread && !defined $initial_in_reply_to && $prompting) {
1094 $initial_in_reply_to = ask
(
1095 __
("Message-ID to be used as In-Reply-To for the first email (if any)? "),
1097 valid_re
=> qr/\@.*\./, confirm_only
=> 1);
1099 if (defined $initial_in_reply_to) {
1100 $initial_in_reply_to =~ s/^\s*<?//;
1101 $initial_in_reply_to =~ s/>?\s*$//;
1102 $initial_in_reply_to = "<$initial_in_reply_to>" if $initial_in_reply_to ne '';
1105 if (defined $reply_to) {
1106 $reply_to =~ s/^\s+|\s+$//g;
1107 ($reply_to) = expand_aliases
($reply_to);
1108 $reply_to = sanitize_address
($reply_to);
1111 if (!defined $sendmail_cmd && !defined $smtp_server) {
1112 my @sendmail_paths = qw( /usr/sbin/sendmail /usr/lib/sendmail );
1113 push @sendmail_paths, map {"$_/sendmail"} split /:/, $ENV{PATH
};
1114 foreach (@sendmail_paths) {
1121 if (!defined $sendmail_cmd) {
1122 $smtp_server = 'localhost'; # could be 127.0.0.1, too... *shrug*
1126 if ($compose && $compose > 0) {
1127 @files = ($compose_filename . ".final", @files);
1130 # Variables we set as part of the loop over files
1131 our ($message_id, %mail, $subject, $in_reply_to, $references, $message,
1132 $needs_confirm, $message_num, $ask_default);
1134 sub extract_valid_address
{
1135 my $address = shift;
1136 my $local_part_regexp = qr/[^<>"\s@]+/;
1137 my $domain_regexp = qr/[^.<>"\s@]+(?:\.[^.<>"\s@]+)+/;
1139 # check for a local address:
1140 return $address if ($address =~ /^($local_part_regexp)$/);
1142 $address =~ s/^\s*<(.*)>\s*$/$1/;
1143 my $have_email_valid = eval { require Email
::Valid
; 1 };
1144 if ($have_email_valid) {
1145 return scalar Email
::Valid
->address($address);
1148 # less robust/correct than the monster regexp in Email::Valid,
1149 # but still does a 99% job, and one less dependency
1150 return $1 if $address =~ /($local_part_regexp\@$domain_regexp)/;
1154 sub extract_valid_address_or_die
{
1155 my $address = shift;
1156 $address = extract_valid_address
($address);
1157 die sprintf(__
("error: unable to extract a valid address from: %s\n"), $address)
1162 sub validate_address
{
1163 my $address = shift;
1164 while (!extract_valid_address
($address)) {
1165 printf STDERR __
("error: unable to extract a valid address from: %s\n"), $address;
1166 # TRANSLATORS: Make sure to include [q] [d] [e] in your
1167 # translation. The program will only accept English input
1169 $_ = ask
(__
("What to do with this address? ([q]uit|[d]rop|[e]dit): "),
1170 valid_re
=> qr/^(?:quit|q|drop|d|edit|e)/i,
1175 cleanup_compose_files
();
1178 $address = ask
("$to_whom ",
1180 valid_re
=> qr/\@.*\./, confirm_only
=> 1);
1185 sub validate_address_list
{
1186 return (grep { defined $_ }
1187 map { validate_address
($_) } @_);
1190 # Usually don't need to change anything below here.
1192 # we make a "fake" message id by taking the current number
1193 # of seconds since the beginning of Unix time and tacking on
1194 # a random number to the end, in case we are called quicker than
1195 # 1 second since the last time we were called.
1197 # We'll setup a template for the message id, using the "from" address:
1199 my ($message_id_stamp, $message_id_serial);
1200 sub make_message_id
{
1202 if (!defined $message_id_stamp) {
1204 $message_id_stamp = POSIX
::strftime
("%Y%m%d%H%M%S.$$", gmtime(time));
1205 $message_id_serial = 0;
1207 $message_id_serial++;
1208 $uniq = "$message_id_stamp-$message_id_serial";
1211 for ($sender, $repocommitter->(), $repoauthor->()) {
1212 $du_part = extract_valid_address
(sanitize_address
($_));
1213 last if (defined $du_part and $du_part ne '');
1215 if (not defined $du_part or $du_part eq '') {
1216 require Sys
::Hostname
;
1217 $du_part = 'user@' . Sys
::Hostname
::hostname
();
1219 my $message_id_template = "<%s-%s>";
1220 $message_id = sprintf($message_id_template, $uniq, $du_part);
1221 #print "new message id = $message_id\n"; # Was useful for debugging
1226 $time = time - scalar $#files;
1228 sub unquote_rfc2047
{
1231 my $sep = qr/[ \t]+/;
1232 s
{$re_encoded_word(?
:$sep$re_encoded_word)*}{
1233 my @words = split $sep, $&;
1235 m/$re_encoded_word/;
1239 if ($encoding eq 'q' || $encoding eq 'Q') {
1242 s/=([0-9A-F]{2})/chr(hex($1))/egi;
1244 # other encodings not supported yet
1249 return wantarray ?
($_, $charset) : $_;
1254 my $encoding = shift || 'UTF-8';
1255 s/([^-a-zA-Z0-9!*+\/])/sprintf
("=%02X", ord($1))/eg
;
1256 s/(.*)/=\?$encoding\?q\?$1\?=/;
1260 sub is_rfc2047_quoted
{
1263 $s =~ m/^(?:"[[:ascii:]]*"|$re_encoded_word)$/o;
1266 sub subject_needs_rfc2047_quoting
{
1269 return ($s =~ /[^[:ascii:]]/) || ($s =~ /=\?/);
1273 local $subject = shift;
1274 my $encoding = shift || 'UTF-8';
1276 if (subject_needs_rfc2047_quoting
($subject)) {
1277 return quote_rfc2047
($subject, $encoding);
1282 # use the simplest quoting being able to handle the recipient
1283 sub sanitize_address
{
1284 my ($recipient) = @_;
1286 # remove garbage after email address
1287 $recipient =~ s/(.*>).*$/$1/;
1289 my ($recipient_name, $recipient_addr) = ($recipient =~ /^(.*?)\s*(<.*)/);
1291 if (not $recipient_name) {
1295 # if recipient_name is already quoted, do nothing
1296 if (is_rfc2047_quoted
($recipient_name)) {
1300 # remove non-escaped quotes
1301 $recipient_name =~ s/(^|[^\\])"/$1/g;
1303 # rfc2047 is needed if a non-ascii char is included
1304 if ($recipient_name =~ /[^[:ascii:]]/) {
1305 $recipient_name = quote_rfc2047
($recipient_name);
1308 # double quotes are needed if specials or CTLs are included
1309 elsif ($recipient_name =~ /[][()<>@,;:\\".\000-\037\177]/) {
1310 $recipient_name =~ s/([\\\r])/\\$1/g;
1311 $recipient_name = qq["$recipient_name"];
1314 return "$recipient_name $recipient_addr";
1318 sub strip_garbage_one_address
{
1321 if ($addr =~ /^(("[^"]*"|[^"<]*)? *<[^>]*>).*/) {
1322 # "Foo Bar" <foobar@example.com> [possibly garbage here]
1323 # Foo Bar <foobar@example.com> [possibly garbage here]
1326 if ($addr =~ /^(<[^>]*>).*/) {
1327 # <foo@example.com> [possibly garbage here]
1328 # if garbage contains other addresses, they are ignored.
1331 if ($addr =~ /^([^"#,\s]*)/) {
1332 # address without quoting: remove anything after the address
1338 sub sanitize_address_list
{
1339 return (map { sanitize_address
($_) } @_);
1342 sub process_address_list
{
1343 my @addr_list = map { parse_address_line
($_) } @_;
1344 @addr_list = expand_aliases
(@addr_list);
1345 @addr_list = sanitize_address_list
(@addr_list);
1346 @addr_list = validate_address_list
(@addr_list);
1350 # Returns the local Fully Qualified Domain Name (FQDN) if available.
1352 # Tightly configured MTAa require that a caller sends a real DNS
1353 # domain name that corresponds the IP address in the HELO/EHLO
1354 # handshake. This is used to verify the connection and prevent
1355 # spammers from trying to hide their identity. If the DNS and IP don't
1356 # match, the receiving MTA may deny the connection.
1358 # Here is a deny example of Net::SMTP with the default "localhost.localdomain"
1360 # Net::SMTP=GLOB(0x267ec28)>>> EHLO localhost.localdomain
1361 # Net::SMTP=GLOB(0x267ec28)<<< 550 EHLO argument does not match calling host
1363 # This maildomain*() code is based on ideas in Perl library Test::Reporter
1364 # /usr/share/perl5/Test/Reporter/Mail/Util.pm ==> sub _maildomain ()
1368 return defined $domain && !($^O
eq 'darwin' && $domain =~ /\.local$/) && $domain =~ /\./;
1371 sub maildomain_net
{
1374 require Net
::Domain
;
1375 my $domain = Net
::Domain
::domainname
();
1376 $maildomain = $domain if valid_fqdn
($domain);
1381 sub maildomain_mta
{
1384 for my $host (qw(mailhost localhost)) {
1386 my $smtp = Net
::SMTP
->new($host);
1387 if (defined $smtp) {
1388 my $domain = $smtp->domain;
1391 $maildomain = $domain if valid_fqdn
($domain);
1393 last if $maildomain;
1401 return maildomain_net
() || maildomain_mta
() || 'localhost.localdomain';
1404 sub smtp_host_string
{
1405 if (defined $smtp_server_port) {
1406 return "$smtp_server:$smtp_server_port";
1408 return $smtp_server;
1412 # Returns 1 if authentication succeeded or was not necessary
1413 # (smtp_user was not specified), and 0 otherwise.
1415 sub smtp_auth_maybe
{
1416 if (!defined $smtp_authuser || $auth || (defined $smtp_auth && $smtp_auth eq "none")) {
1420 # Workaround AUTH PLAIN/LOGIN interaction defect
1421 # with Authen::SASL::Cyrus
1423 require Authen
::SASL
;
1424 Authen
::SASL
->import(qw(Perl));
1427 # Check mechanism naming as defined in:
1428 # https://tools.ietf.org/html/rfc4422#page-8
1429 if ($smtp_auth && $smtp_auth !~ /^(\b[A-Z0-9-_]{1,20}\s*)*$/) {
1430 die "invalid smtp auth: '${smtp_auth}'";
1433 # TODO: Authentication may fail not because credentials were
1434 # invalid but due to other reasons, in which we should not
1435 # reject credentials.
1436 $auth = Git
::credential
({
1437 'protocol' => 'smtp',
1438 'host' => smtp_host_string
(),
1439 'username' => $smtp_authuser,
1440 # if there's no password, "git credential fill" will
1441 # give us one, otherwise it'll just pass this one.
1442 'password' => $smtp_authpass
1447 my $sasl = Authen
::SASL
->new(
1448 mechanism
=> $smtp_auth,
1450 user
=> $cred->{'username'},
1451 pass
=> $cred->{'password'},
1452 authname
=> $cred->{'username'},
1456 return !!$smtp->auth($sasl);
1459 return !!$smtp->auth($cred->{'username'}, $cred->{'password'});
1465 sub ssl_verify_params
{
1467 require IO
::Socket
::SSL
;
1468 IO
::Socket
::SSL
->import(qw
/SSL_VERIFY_PEER SSL_VERIFY_NONE/);
1471 print STDERR
"Not using SSL_VERIFY_PEER due to out-of-date IO::Socket::SSL.\n";
1475 if (!defined $smtp_ssl_cert_path) {
1476 # use the OpenSSL defaults
1477 return (SSL_verify_mode
=> SSL_VERIFY_PEER
());
1480 if ($smtp_ssl_cert_path eq "") {
1481 return (SSL_verify_mode
=> SSL_VERIFY_NONE
());
1482 } elsif (-d
$smtp_ssl_cert_path) {
1483 return (SSL_verify_mode
=> SSL_VERIFY_PEER
(),
1484 SSL_ca_path
=> $smtp_ssl_cert_path);
1485 } elsif (-f
$smtp_ssl_cert_path) {
1486 return (SSL_verify_mode
=> SSL_VERIFY_PEER
(),
1487 SSL_ca_file
=> $smtp_ssl_cert_path);
1489 die sprintf(__
("CA path \"%s\" does not exist"), $smtp_ssl_cert_path);
1493 sub file_name_is_absolute
{
1496 # msys does not grok DOS drive-prefixes
1497 if ($^O
eq 'msys') {
1498 return ($path =~ m
#^/# || $path =~ m#^[a-zA-Z]\:#)
1501 require File
::Spec
::Functions
;
1502 return File
::Spec
::Functions
::file_name_is_absolute
($path);
1505 # Prepares the email, then asks the user what to do.
1507 # If the user chooses to send the email, it's sent and 1 is returned.
1508 # If the user chooses not to send the email, 0 is returned.
1509 # If the user decides they want to make further edits, -1 is returned and the
1510 # caller is expected to call send_message again after the edits are performed.
1512 # If an error occurs sending the email, this just dies.
1515 my @recipients = unique_email_list
(@to);
1516 @cc = (grep { my $cc = extract_valid_address_or_die
($_);
1517 not grep { $cc eq $_ || $_ =~ /<\Q${cc}\E>$/ } @recipients
1520 my $to = join (",\n\t", @recipients);
1521 @recipients = unique_email_list
(@recipients,@cc,@initial_bcc);
1522 @recipients = (map { extract_valid_address_or_die
($_) } @recipients);
1523 my $date = format_2822_time
($time++);
1524 my $gitversion = '@@GIT_VERSION@@';
1525 if ($gitversion =~ m/..GIT_VERSION../) {
1526 $gitversion = Git
::version
();
1529 my $cc = join(",\n\t", unique_email_list
(@cc));
1532 $ccline = "\nCc: $cc";
1534 make_message_id
() unless defined($message_id);
1536 my $header = "From: $sender
1540 Message-Id: $message_id
1543 $header .= "X-Mailer: git-send-email $gitversion\n";
1547 $header .= "In-Reply-To: $in_reply_to\n";
1548 $header .= "References: $references\n";
1551 $header .= "Reply-To: $reply_to\n";
1554 $header .= join("\n", @xh) . "\n";
1557 my @sendmail_parameters = ('-i', @recipients);
1558 my $raw_from = $sender;
1559 if (defined $envelope_sender && $envelope_sender ne "auto") {
1560 $raw_from = $envelope_sender;
1562 $raw_from = extract_valid_address
($raw_from);
1563 unshift (@sendmail_parameters,
1564 '-f', $raw_from) if(defined $envelope_sender);
1566 if ($needs_confirm && !$dry_run) {
1567 print "\n$header\n";
1568 if ($needs_confirm eq "inform") {
1569 $confirm_unconfigured = 0; # squelch this message for the rest of this run
1570 $ask_default = "y"; # assume yes on EOF since user hasn't explicitly asked for confirmation
1572 The Cc list above has been expanded by additional
1573 addresses found in the patch commit message. By default
1574 send-email prompts before sending whenever this occurs.
1575 This behavior is controlled by the sendemail.confirm
1576 configuration setting.
1578 For additional information, run 'git send-email --help'.
1579 To retain the current behavior, but squelch this message,
1580 run 'git config --global sendemail.confirm auto'.
1584 # TRANSLATORS: Make sure to include [y] [n] [e] [q] [a] in your
1585 # translation. The program will only accept English input
1587 $_ = ask
(__
("Send this email? ([y]es|[n]o|[e]dit|[q]uit|[a]ll): "),
1588 valid_re
=> qr/^(?:yes|y|no|n|edit|e|quit|q|all|a)/i,
1589 default => $ask_default);
1590 die __
("Send this email reply required") unless defined $_;
1596 cleanup_compose_files
();
1603 unshift (@sendmail_parameters, @smtp_server_options);
1606 # We don't want to send the email.
1607 } elsif (defined $sendmail_cmd || file_name_is_absolute
($smtp_server)) {
1608 my $pid = open my $sm, '|-';
1609 defined $pid or die $!;
1611 if (defined $sendmail_cmd) {
1612 exec ("sh", "-c", "$sendmail_cmd \"\$@\"", "-", @sendmail_parameters)
1615 exec ($smtp_server, @sendmail_parameters)
1619 print $sm "$header\n$message";
1620 close $sm or die $!;
1623 if (!defined $smtp_server) {
1624 die __
("The required SMTP server is not properly defined.")
1628 my $use_net_smtp_ssl = version
->parse($Net::SMTP
::VERSION
) < version
->parse("2.34");
1629 $smtp_domain ||= maildomain
();
1631 if ($smtp_encryption eq 'ssl') {
1632 $smtp_server_port ||= 465; # ssmtp
1633 require IO
::Socket
::SSL
;
1635 # Suppress "variable accessed once" warning.
1638 $IO::Socket
::SSL
::DEBUG
= 1;
1641 # Net::SMTP::SSL->new() does not forward any SSL options
1642 IO
::Socket
::SSL
::set_client_defaults
(
1643 ssl_verify_params
());
1645 if ($use_net_smtp_ssl) {
1646 require Net
::SMTP
::SSL
;
1647 $smtp ||= Net
::SMTP
::SSL
->new($smtp_server,
1648 Hello
=> $smtp_domain,
1649 Port
=> $smtp_server_port,
1650 Debug
=> $debug_net_smtp);
1653 $smtp ||= Net
::SMTP
->new($smtp_server,
1654 Hello
=> $smtp_domain,
1655 Port
=> $smtp_server_port,
1656 Debug
=> $debug_net_smtp,
1661 $smtp_server_port ||= 25;
1662 $smtp ||= Net
::SMTP
->new($smtp_server,
1663 Hello
=> $smtp_domain,
1664 Debug
=> $debug_net_smtp,
1665 Port
=> $smtp_server_port);
1666 if ($smtp_encryption eq 'tls' && $smtp) {
1667 if ($use_net_smtp_ssl) {
1668 $smtp->command('STARTTLS');
1670 if ($smtp->code != 220) {
1671 die sprintf(__
("Server does not support STARTTLS! %s"), $smtp->message);
1673 require Net
::SMTP
::SSL
;
1674 $smtp = Net
::SMTP
::SSL
->start_SSL($smtp,
1675 ssl_verify_params
())
1676 or die sprintf(__
("STARTTLS failed! %s"), IO
::Socket
::SSL
::errstr
());
1679 $smtp->starttls(ssl_verify_params
())
1680 or die sprintf(__
("STARTTLS failed! %s"), IO
::Socket
::SSL
::errstr
());
1682 # Send EHLO again to receive fresh
1683 # supported commands
1684 $smtp->hello($smtp_domain);
1689 die __
("Unable to initialize SMTP properly. Check config and use --smtp-debug."),
1690 " VALUES: server=$smtp_server ",
1691 "encryption=$smtp_encryption ",
1692 "hello=$smtp_domain",
1693 defined $smtp_server_port ?
" port=$smtp_server_port" : "";
1696 smtp_auth_maybe
or die $smtp->message;
1698 $smtp->mail( $raw_from ) or die $smtp->message;
1699 $smtp->to( @recipients ) or die $smtp->message;
1700 $smtp->data or die $smtp->message;
1701 $smtp->datasend("$header\n") or die $smtp->message;
1702 my @lines = split /^/, $message;
1703 foreach my $line (@lines) {
1704 $smtp->datasend("$line") or die $smtp->message;
1706 $smtp->dataend() or die $smtp->message;
1707 $smtp->code =~ /250|200/ or die sprintf(__
("Failed to send %s\n"), $subject).$smtp->message;
1710 printf($dry_run ? __
("Dry-Sent %s\n") : __
("Sent %s\n"), $subject);
1712 print($dry_run ? __
("Dry-OK. Log says:\n") : __
("OK. Log says:\n"));
1713 if (!defined $sendmail_cmd && !file_name_is_absolute
($smtp_server)) {
1714 print "Server: $smtp_server\n";
1715 print "MAIL FROM:<$raw_from>\n";
1716 foreach my $entry (@recipients) {
1717 print "RCPT TO:<$entry>\n";
1721 if (defined $sendmail_cmd) {
1722 $sm = $sendmail_cmd;
1727 print "Sendmail: $sm ".join(' ',@sendmail_parameters)."\n";
1729 print $header, "\n";
1731 print __
("Result: "), $smtp->code, ' ',
1732 ($smtp->message =~ /\n([^\n]+\n)$/s), "\n";
1734 print __
("Result: OK\n");
1741 $in_reply_to = $initial_in_reply_to;
1742 $references = $initial_in_reply_to || '';
1745 # Prepares the email, prompts the user, sends it out
1746 # Returns 0 if an edit was done and the function should be called again, or 1
1751 open my $fh, "<", $t or die sprintf(__
("can't open file %s"), $t);
1754 my $sauthor = undef;
1755 my $author_encoding;
1756 my $has_content_type;
1759 my $has_mime_version;
1763 my $input_format = undef;
1765 $subject = $initial_subject;
1768 # First unfold multiline header fields
1771 if (/^\s+\S/ and @header) {
1772 chomp($header[$#header]);
1774 $header[$#header] .= $_;
1779 # Now parse the header
1782 $input_format = 'mbox';
1786 if (!defined $input_format && /^[-A-Za-z]+:\s/) {
1787 $input_format = 'mbox';
1790 if (defined $input_format && $input_format eq 'mbox') {
1791 if (/^Subject:\s+(.*)$/i) {
1794 elsif (/^From:\s+(.*)$/i) {
1795 ($author, $author_encoding) = unquote_rfc2047
($1);
1796 $sauthor = sanitize_address
($author);
1797 next if $suppress_cc{'author'};
1798 next if $suppress_cc{'self'} and $sauthor eq $sender;
1799 printf(__
("(mbox) Adding cc: %s from line '%s'\n"),
1800 $1, $_) unless $quiet;
1803 elsif (/^To:\s+(.*)$/i) {
1804 foreach my $addr (parse_address_line
($1)) {
1805 printf(__
("(mbox) Adding to: %s from line '%s'\n"),
1806 $addr, $_) unless $quiet;
1810 elsif (/^Cc:\s+(.*)$/i) {
1811 foreach my $addr (parse_address_line
($1)) {
1812 my $qaddr = unquote_rfc2047
($addr);
1813 my $saddr = sanitize_address
($qaddr);
1814 if ($saddr eq $sender) {
1815 next if ($suppress_cc{'self'});
1817 next if ($suppress_cc{'cc'});
1819 printf(__
("(mbox) Adding cc: %s from line '%s'\n"),
1820 $addr, $_) unless $quiet;
1824 elsif (/^Content-type:/i) {
1825 $has_content_type = 1;
1826 if (/charset="?([^ "]+)/) {
1827 $body_encoding = $1;
1831 elsif (/^MIME-Version/i) {
1832 $has_mime_version = 1;
1835 elsif (/^Message-Id: (.*)/i) {
1838 elsif (/^Content-Transfer-Encoding: (.*)/i) {
1839 $xfer_encoding = $1 if not defined $xfer_encoding;
1841 elsif (/^In-Reply-To: (.*)/i) {
1842 if (!$initial_in_reply_to || $thread) {
1846 elsif (/^References: (.*)/i) {
1847 if (!$initial_in_reply_to || $thread) {
1851 elsif (!/^Date:\s/i && /^[-A-Za-z]+:\s+\S/) {
1855 # In the traditional
1856 # "send lots of email" format,
1859 # So let's support that, too.
1860 $input_format = 'lots';
1861 if (@cc == 0 && !$suppress_cc{'cc'}) {
1862 printf(__
("(non-mbox) Adding cc: %s from line '%s'\n"),
1863 $_, $_) unless $quiet;
1865 } elsif (!defined $subject) {
1870 # Now parse the message body
1873 if (/^([a-z][a-z-]*-by|Cc): (.*)/i) {
1875 my ($what, $c) = ($1, $2);
1876 # strip garbage for the address we'll use:
1877 $c = strip_garbage_one_address
($c);
1878 # sanitize a bit more to decide whether to suppress the address:
1879 my $sc = sanitize_address
($c);
1880 if ($sc eq $sender) {
1881 next if ($suppress_cc{'self'});
1883 if ($what =~ /^Signed-off-by$/i) {
1884 next if $suppress_cc{'sob'};
1885 } elsif ($what =~ /-by$/i) {
1886 next if $suppress_cc{'misc-by'};
1887 } elsif ($what =~ /Cc/i) {
1888 next if $suppress_cc{'bodycc'};
1891 if ($c !~ /.+@.+|<.+>/) {
1892 printf("(body) Ignoring %s from line '%s'\n",
1893 $what, $_) unless $quiet;
1897 printf(__
("(body) Adding cc: %s from line '%s'\n"),
1898 $c, $_) unless $quiet;
1903 push @to, recipients_cmd
("to-cmd", "to", $to_cmd, $t)
1905 push @cc, recipients_cmd
("cc-cmd", "cc", $cc_cmd, $t)
1906 if defined $cc_cmd && !$suppress_cc{'cccmd'};
1908 if ($broken_encoding{$t} && !$has_content_type) {
1909 $xfer_encoding = '8bit' if not defined $xfer_encoding;
1910 $has_content_type = 1;
1911 push @xh, "Content-Type: text/plain; charset=$auto_8bit_encoding";
1912 $body_encoding = $auto_8bit_encoding;
1915 if ($broken_encoding{$t} && !is_rfc2047_quoted
($subject)) {
1916 $subject = quote_subject
($subject, $auto_8bit_encoding);
1919 if (defined $sauthor and $sauthor ne $sender) {
1920 $message = "From: $author\n\n$message";
1921 if (defined $author_encoding) {
1922 if ($has_content_type) {
1923 if ($body_encoding eq $author_encoding) {
1924 # ok, we already have the right encoding
1927 # uh oh, we should re-encode
1931 $xfer_encoding = '8bit' if not defined $xfer_encoding;
1932 $has_content_type = 1;
1934 "Content-Type: text/plain; charset=$author_encoding";
1938 $xfer_encoding = '8bit' if not defined $xfer_encoding;
1939 ($message, $xfer_encoding) = apply_transfer_encoding
(
1940 $message, $xfer_encoding, $target_xfer_encoding);
1941 push @xh, "Content-Transfer-Encoding: $xfer_encoding";
1942 unshift @xh, 'MIME-Version: 1.0' unless $has_mime_version;
1945 $confirm eq "always" or
1946 ($confirm =~ /^(?:auto|cc)$/ && @cc) or
1947 ($confirm =~ /^(?:auto|compose)$/ && $compose && $message_num == 1));
1948 $needs_confirm = "inform" if ($needs_confirm && $confirm_unconfigured && @cc);
1950 @to = process_address_list
(@to);
1951 @cc = process_address_list
(@cc);
1953 @to = (@initial_to, @to);
1954 @cc = (@initial_cc, @cc);
1956 if ($message_num == 1) {
1957 if (defined $cover_cc and $cover_cc) {
1960 if (defined $cover_to and $cover_to) {
1965 my $message_was_sent = send_message
();
1966 if ($message_was_sent == -1) {
1971 # set up for the next message
1973 if ($message_was_sent &&
1974 ($chain_reply_to || !defined $in_reply_to || length($in_reply_to) == 0 ||
1975 $message_num == 1)) {
1976 $in_reply_to = $message_id;
1977 if (length $references > 0) {
1978 $references .= "\n $message_id";
1980 $references = "$message_id";
1983 } elsif (!defined $initial_in_reply_to) {
1984 # --thread and --in-reply-to manage the "In-Reply-To" header and by
1985 # extension the "References" header. If these commands are not used, reset
1986 # the header values to their defaults.
1987 $in_reply_to = undef;
1990 $message_id = undef;
1992 if (defined $batch_size && $num_sent == $batch_size) {
1994 $smtp->quit if defined $smtp;
1997 sleep($relogin_delay) if defined $relogin_delay;
2003 foreach my $t (@files) {
2004 while (!process_file
($t)) {
2005 # user edited the file
2009 # Execute a command (e.g. $to_cmd) to get a list of email addresses
2010 # and return a results array
2011 sub recipients_cmd
{
2012 my ($prefix, $what, $cmd, $file) = @_;
2015 open my $fh, "-|", "$cmd \Q$file\E"
2016 or die sprintf(__
("(%s) Could not execute '%s'"), $prefix, $cmd);
2017 while (my $address = <$fh>) {
2018 $address =~ s/^\s*//g;
2019 $address =~ s/\s*$//g;
2020 $address = sanitize_address
($address);
2021 next if ($address eq $sender and $suppress_cc{'self'});
2022 push @addresses, $address;
2023 printf(__
("(%s) Adding %s: %s from: '%s'\n"),
2024 $prefix, $what, $address, $cmd) unless $quiet;
2027 or die sprintf(__
("(%s) failed to close pipe to '%s'"), $prefix, $cmd);
2031 cleanup_compose_files
();
2033 sub cleanup_compose_files
{
2034 unlink($compose_filename, $compose_filename . ".final") if $compose;
2037 $smtp->quit if $smtp;
2039 sub apply_transfer_encoding
{
2040 my $message = shift;
2044 return ($message, $to) if ($from eq $to and $from ne '7bit');
2046 require MIME
::QuotedPrint
;
2047 require MIME
::Base64
;
2049 $message = MIME
::QuotedPrint
::decode
($message)
2050 if ($from eq 'quoted-printable');
2051 $message = MIME
::Base64
::decode
($message)
2052 if ($from eq 'base64');
2054 $to = ($message =~ /(?:.{999,}|\r)/) ?
'quoted-printable' : '8bit'
2057 die __
("cannot send message as 7bit")
2058 if ($to eq '7bit' and $message =~ /[^[:ascii:]]/);
2059 return ($message, $to)
2060 if ($to eq '7bit' or $to eq '8bit');
2061 return (MIME
::QuotedPrint
::encode
($message, "\n", 0), $to)
2062 if ($to eq 'quoted-printable');
2063 return (MIME
::Base64
::encode
($message, "\n"), $to)
2064 if ($to eq 'base64');
2065 die __
("invalid transfer encoding");
2068 sub unique_email_list
{
2072 foreach my $entry (@_) {
2073 my $clean = extract_valid_address_or_die
($entry);
2074 $seen{$clean} ||= 0;
2075 next if $seen{$clean}++;
2076 push @emails, $entry;
2081 sub validate_patch
{
2082 my ($fn, $xfer_encoding) = @_;
2085 my $hook_name = 'sendemail-validate';
2086 my $hooks_path = $repo->command_oneline('rev-parse', '--git-path', 'hooks');
2088 my $validate_hook = File
::Spec
->catfile($hooks_path, $hook_name);
2090 if (-x
$validate_hook) {
2092 my $target = Cwd
::abs_path
($fn);
2093 # The hook needs a correct cwd and GIT_DIR.
2094 my $cwd_save = Cwd
::getcwd
();
2095 chdir($repo->wc_path() or $repo->repo_path())
2096 or die("chdir: $!");
2097 local $ENV{"GIT_DIR"} = $repo->repo_path();
2098 my @cmd = ("git", "hook", "run", "--ignore-missing",
2100 my @cmd_msg = (@cmd, "<patch>");
2101 my @cmd_run = (@cmd, $target);
2102 $hook_error = system_or_msg
(\
@cmd_run, undef, "@cmd_msg");
2103 chdir($cwd_save) or die("chdir: $!");
2106 $hook_error = sprintf(
2107 __
("fatal: %s: rejected by %s hook\n%s\nwarning: no patches were sent\n"),
2108 $fn, $hook_name, $hook_error);
2113 # Any long lines will be automatically fixed if we use a suitable transfer
2115 unless ($xfer_encoding =~ /^(?:auto|quoted-printable|base64)$/) {
2116 open(my $fh, '<', $fn)
2117 or die sprintf(__
("unable to open %s: %s\n"), $fn, $!);
2118 while (my $line = <$fh>) {
2119 if (length($line) > 998) {
2120 die sprintf(__
("fatal: %s:%d is longer than 998 characters\n" .
2121 "warning: no patches were sent\n"), $fn, $.);
2129 my ($last, $lastlen, $file, $known_suffix) = @_;
2130 my ($suffix, $skip);
2133 if (defined $last &&
2134 ($lastlen < length($file)) &&
2135 (substr($file, 0, $lastlen) eq $last) &&
2136 ($suffix = substr($file, $lastlen)) !~ /^[a-z0-9]/i) {
2137 if (defined $known_suffix && $suffix eq $known_suffix) {
2138 printf(__
("Skipping %s with backup suffix '%s'.\n"), $file, $known_suffix);
2141 # TRANSLATORS: please keep "[y|N]" as is.
2142 my $answer = ask
(sprintf(__
("Do you really want to send %s? [y|N]: "), $file),
2143 valid_re
=> qr/^(?:y|n)/i,
2145 $skip = ($answer ne 'y');
2147 $known_suffix = $suffix;
2151 return ($skip, $known_suffix);
2154 sub handle_backup_files
{
2156 my ($last, $lastlen, $known_suffix, $skip, @result);
2157 for my $file (@file) {
2158 ($skip, $known_suffix) = handle_backup
($last, $lastlen,
2159 $file, $known_suffix);
2160 push @result, $file unless $skip;
2162 $lastlen = length($file);
2167 sub file_has_nonascii
{
2169 open(my $fh, '<', $fn)
2170 or die sprintf(__
("unable to open %s: %s\n"), $fn, $!);
2171 while (my $line = <$fh>) {
2172 return 1 if $line =~ /[^[:ascii:]]/;
2177 sub body_or_subject_has_nonascii
{
2179 open(my $fh, '<', $fn)
2180 or die sprintf(__
("unable to open %s: %s\n"), $fn, $!);
2181 while (my $line = <$fh>) {
2182 last if $line =~ /^$/;
2183 return 1 if $line =~ /^Subject.*[^[:ascii:]]/;
2185 while (my $line = <$fh>) {
2186 return 1 if $line =~ /[^[:ascii:]]/;