#!/usr/bin/env perl# SPDX-License-Identifier: GPL-2.0## (c) 2007, Joe Perches <joe@perches.com># created from checkpatch.pl## Print selected MAINTAINERS information for# the files modified in a patch or for a file## usage: perl scripts/get_maintainer.pl [OPTIONS] <patch># perl scripts/get_maintainer.pl [OPTIONS] -f <file> use warnings;use strict; my $P = $0;my $V = '0.26'; use Getopt::Long qw(:config no_auto_abbrev);use Cwd;use File::Find;use File::Spec::Functions;use open qw(:std :encoding(UTF-8));use JSON::PP; my $cur_path = fastgetcwd() . '/';my $lk_path = "./";my $email = 1;my $email_usename = 1;my $email_maintainer = 1;my $email_reviewer = 1;my $email_fixes = 1;my $email_list = 1;my $email_moderated_list = 1;my $email_subscriber_list = 0;my $email_git_penguin_chiefs = 0;my $email_git = 0;my $email_git_all_signature_types = 0;my $email_git_blame = 0;my $email_git_blame_signatures = 1;my $email_git_fallback = 1;my $email_git_min_signatures = 1;my $email_git_max_maintainers = 5;my $email_git_min_percent = 5;my $email_git_since = "1-year-ago";my $email_hg_since = "-365";my $interactive = 0;my $email_remove_duplicates = 1;my $email_use_mailmap = 1;my $output_multiline = 1;my $output_separator = ", ";my $output_roles = 0;my $output_rolestats = 1;my $output_substatus = undef;my $output_section_maxlen = 50;my $scm = 0;my $tree = 1;my $web = 0;my $bug = 0;my $subsystem = 0;my $status = 0;my $letters = "";my $keywords = 1;my $keywords_in_file = 0;my $sections = 0;my $email_file_emails = 0;my $from_filename = 0;my $pattern_depth = 0;my $self_test = undef;my $version = 0;my $help = 0;my $json = 0;my $find_maintainer_files = 0;my $maintainer_path;my $vcs_used = 0; my $exit = 0; my @files = ();my @fixes = (); # If a patch description includes Fixes: linesmy @range = ();my @keyword_tvi = ();my @file_emails = (); my %commit_author_hash;my %commit_signer_hash; my @penguin_chief = ();push(@penguin_chief, "Linus Torvalds:torvalds\@linux-foundation.org");#Andrew wants in on most everything - 2009/01/14#push(@penguin_chief, "Andrew Morton:akpm\@linux-foundation.org"); my @penguin_chief_names = ();foreach my $chief (@penguin_chief) { if ($chief =~ m/^(.*):(.*)/) { my $chief_name = $1; my $chief_addr = $2; push(@penguin_chief_names, $chief_name); }}my $penguin_chiefs = "\(" . join("|", @penguin_chief_names) . "\)"; # Signature types of people who are either# a) responsible for the code in question, or# b) familiar enough with it to give relevant feedbackmy @signature_tags = ();push(@signature_tags, "Signed-off-by:");push(@signature_tags, "Reviewed-by:");push(@signature_tags, "Acked-by:"); my $signature_pattern = "\(" . join("|", @signature_tags) . "\)"; # rfc822 email address - preloaded methods go here.my $rfc822_lwsp = "(?:(?:\\r\\n)?[ \\t])";my $rfc822_char = '[\\000-\\377]'; # VCS command support: class-like functions and strings my %VCS_cmds; my %VCS_cmds_git = ( "execute_cmd" => \&git_execute_cmd, "available" => '(which("git") ne "") && (-e ".git")', "find_signers_cmd" => "git log --no-color --follow --since=\$email_git_since " . '--numstat --no-merges ' . '--format="GitCommit: %H%n' . 'GitAuthor: %an <%ae>%n' . 'GitDate: %aD%n' . 'GitSubject: %s%n' . '%b%n"' . " -- \$file", "find_commit_signers_cmd" => "git log --no-color " . '--numstat ' . '--format="GitCommit: %H%n' . 'GitAuthor: %an <%ae>%n' . 'GitDate: %aD%n' . 'GitSubject: %s%n' . '%b%n"' . " -1 \$commit", "find_commit_author_cmd" => "git log --no-color " . '--numstat ' . '--format="GitCommit: %H%n' . 'GitAuthor: %an <%ae>%n' . 'GitDate: %aD%n' . 'GitSubject: %s%n"' . " -1 \$commit", "blame_range_cmd" => "git blame -l -L \$diff_start,+\$diff_length \$file", "blame_file_cmd" => "git blame -l \$file", "commit_pattern" => "^GitCommit: ([0-9a-f]{40,40})", "blame_commit_pattern" => "^([0-9a-f]+) ", "author_pattern" => "^GitAuthor: (.*)", "subject_pattern" => "^GitSubject: (.*)", "stat_pattern" => "^(\\d+)\\t(\\d+)\\t\$file\$", "file_exists_cmd" => "git ls-files \$file", "list_files_cmd" => "git ls-files \$file",); my %VCS_cmds_hg = ( "execute_cmd" => \&hg_execute_cmd, "available" => '(which("hg") ne "") && (-d ".hg")', "find_signers_cmd" => "hg log --date=\$email_hg_since " . "--template='HgCommit: {node}\\n" . "HgAuthor: {author}\\n" . "HgSubject: {desc}\\n'" . " -- \$file", "find_commit_signers_cmd" => "hg log " . "--template='HgSubject: {desc}\\n'" . " -r \$commit", "find_commit_author_cmd" => "hg log " . "--template='HgCommit: {node}\\n" . "HgAuthor: {author}\\n" . "HgSubject: {desc|firstline}\\n'" . " -r \$commit", "blame_range_cmd" => "", # not supported "blame_file_cmd" => "hg blame -n \$file", "commit_pattern" => "^HgCommit: ([0-9a-f]{40,40})", "blame_commit_pattern" => "^([ 0-9a-f]+):", "author_pattern" => "^HgAuthor: (.*)", "subject_pattern" => "^HgSubject: (.*)", "stat_pattern" => "^(\\d+)\t(\\d+)\t\$file\$", "file_exists_cmd" => "hg files \$file", "list_files_cmd" => "hg manifest -R \$file",); my $conf = which_conf(".get_maintainer.conf");if (-f $conf) { my @conf_args; open(my $conffile, '<', "$conf") or warn "$P: Can't find a readable .get_maintainer.conf file $!\n"; while (<$conffile>) { my $line = $_; $line =~ s/\s*\n?$//g; $line =~ s/^\s*//g; $line =~ s/\s+/ /g; next if ($line =~ m/^\s*#/); next if ($line =~ m/^\s*$/); my @words = split(" ", $line); foreach my $word (@words) { last if ($word =~ m/^#/); push (@conf_args, $word); } } close($conffile); unshift(@ARGV, @conf_args) if @conf_args;} my @ignore_emails = ();my $ignore_file = which_conf(".get_maintainer.ignore");if (-f $ignore_file) { open(my $ignore, '<', "$ignore_file") or warn "$P: Can't find a readable .get_maintainer.ignore file $!\n"; while (<$ignore>) { my $line = $_; $line =~ s/\s*\n?$//; $line =~ s/^\s*//; $line =~ s/\s+$//; $line =~ s/#.*$//; next if ($line =~ m/^\s*$/); if (rfc822_valid($line)) { push(@ignore_emails, $line); } } close($ignore);} if ($#ARGV > 0) { foreach (@ARGV) { if ($_ =~ /^-{1,2}self-test(?:=|$)/) { die "$P: using --self-test does not allow any other option or argument\n"; } }} if (!GetOptions( 'email!' => \$email, 'git!' => \$email_git, 'git-all-signature-types!' => \$email_git_all_signature_types, 'git-blame!' => \$email_git_blame, 'git-blame-signatures!' => \$email_git_blame_signatures, 'git-fallback!' => \$email_git_fallback, 'git-chief-penguins!' => \$email_git_penguin_chiefs, 'git-min-signatures=i' => \$email_git_min_signatures, 'git-max-maintainers=i' => \$email_git_max_maintainers, 'git-min-percent=i' => \$email_git_min_percent, 'git-since=s' => \$email_git_since, 'hg-since=s' => \$email_hg_since, 'i|interactive!' => \$interactive, 'remove-duplicates!' => \$email_remove_duplicates, 'mailmap!' => \$email_use_mailmap, 'm!' => \$email_maintainer, 'r!' => \$email_reviewer, 'n!' => \$email_usename, 'l!' => \$email_list, 'fixes!' => \$email_fixes, 'moderated!' => \$email_moderated_list, 's!' => \$email_subscriber_list, 'multiline!' => \$output_multiline, 'roles!' => \$output_roles, 'rolestats!' => \$output_rolestats, 'separator=s' => \$output_separator, 'subsystem!' => \$subsystem, 'status!' => \$status, 'substatus!' => \$output_substatus, 'scm!' => \$scm, 'tree!' => \$tree, 'web!' => \$web, 'bug!' => \$bug, 'letters=s' => \$letters, 'pattern-depth=i' => \$pattern_depth, 'k|keywords!' => \$keywords, 'kf|keywords-in-file!' => \$keywords_in_file, 'sections!' => \$sections, 'fe|file-emails!' => \$email_file_emails, 'f|file' => \$from_filename, 'find-maintainer-files' => \$find_maintainer_files, 'mpath|maintainer-path=s' => \$maintainer_path, 'self-test:s' => \$self_test, 'json!' => \$json, 'v|version' => \$version, 'h|help|usage' => \$help, )) { die "$P: invalid argument - use --help if necessary\n";} if ($help != 0) { usage(); exit 0;} if ($version != 0) { print("${P} ${V}\n"); exit 0;} if (defined $self_test) { read_all_maintainer_files(); self_test(); exit 0;} if (-t STDIN && !@ARGV) { # We're talking to a terminal, but have no command line arguments. die "$P: missing patchfile or -f file - use --help if necessary\n";} $output_multiline = 0 if ($output_separator ne ", ");$output_rolestats = 1 if ($interactive);$output_roles = 1 if ($output_rolestats); if (!defined $output_substatus) { $output_substatus = $email && $output_roles && -t STDOUT;} if ($sections || $letters ne "") { $sections = 1; $email = 0; $email_list = 0; $scm = 0; $status = 0; $subsystem = 0; $web = 0; $bug = 0; $keywords = 0; $keywords_in_file = 0; $interactive = 0;} else { my $selections = $email + $scm + $status + $subsystem + $web + $bug; if ($selections == 0) { die "$P: Missing required option: email, scm, status, subsystem, web or bug\n"; }} if ($email && ($email_maintainer + $email_reviewer + $email_list + $email_subscriber_list + $email_git + $email_git_penguin_chiefs + $email_git_blame) == 0) { die "$P: Please select at least 1 email option\n";} if ($tree && !top_of_kernel_tree($lk_path)) { die "$P: The current directory does not appear to be " . "a linux kernel source tree.\n";} ## Read MAINTAINERS for type/value pairs my @typevalue = ();my %keyword_hash;my @mfiles = ();my @self_test_info = (); sub read_maintainer_file { my ($file) = @_; open (my $maint, '<', "$file") or die "$P: Can't open MAINTAINERS file '$file': $!\n"; my $i = 1; while (<$maint>) { my $line = $_; chomp $line; if ($line =~ m/^([A-Z]):\s*(.*)/) { my $type = $1; my $value = $2; ##Filename pattern matching if ($type eq "F" || $type eq "X") { $value =~ s@\.@\\\.@g; ##Convert . to \. $value =~ s/\*\*/\x00/g; ##Convert ** to placeholder $value =~ s/\*/\.\*/g; ##Convert * to .* $value =~ s/\?/\./g; ##Convert ? to . $value =~ s/\x00/(?:.*)/g; ##Convert placeholder to (?:.*) ##if pattern is a directory and it lacks a trailing slash, add one if ((-d $value)) { $value =~ s@([^/])$@$1/@; } } elsif ($type eq "K") { $keyword_hash{@typevalue} = $value; } push(@typevalue, "$type:$value"); } elsif (!(/^\s*$/ || /^\s*\#/)) { push(@typevalue, $line); } if (defined $self_test) { push(@self_test_info, {file=>$file, linenr=>$i, line=>$line}); } $i++; } close($maint);} sub find_is_maintainer_file { my ($file) = $_; return if ($file !~ m@/MAINTAINERS$@); $file = $File::Find::name; return if (! -f $file); push(@mfiles, $file);} sub find_ignore_git { return grep { $_ !~ /^\.git$/; } @_;} read_all_maintainer_files(); sub read_all_maintainer_files { my $path = "${lk_path}MAINTAINERS"; if (defined $maintainer_path) { $path = $maintainer_path; # Perl Cookbook tilde expansion if necessary $path =~ s@^~([^/]*)@ $1 ? (getpwnam($1))[7] : ( $ENV{HOME} || $ENV{LOGDIR} || (getpwuid($<))[7])@ex; } if (-d $path) { $path .= '/' if ($path !~ m@/$@); if ($find_maintainer_files) { find( { wanted => \&find_is_maintainer_file, preprocess => \&find_ignore_git, no_chdir => 1, }, "$path"); } else { opendir(DIR, "$path") or die $!; my @files = readdir(DIR); closedir(DIR); foreach my $file (@files) { push(@mfiles, "$path$file") if ($file !~ /^\./); } } } elsif (-f "$path") { push(@mfiles, "$path"); } else { die "$P: MAINTAINER file not found '$path'\n"; } die "$P: No MAINTAINER files found in '$path'\n" if (scalar(@mfiles) == 0); foreach my $file (@mfiles) { read_maintainer_file("$file"); }} sub maintainers_in_file { my ($file) = @_; return if ($file =~ m@\bMAINTAINERS$@); if (-f $file && ($email_file_emails || $file =~ /\.yaml$/)) { open(my $f, '<', $file) or die "$P: Can't open $file: $!\n"; my $text = do { local($/) ; <$f> }; close($f); my @poss_addr = $text =~ m$[\p{L}\"\' \,\.\+-]*\s*[\,]*\s*[\(\<\{]{0,1}[A-Za-z0-9_\.\+-]+\@[A-Za-z0-9\.-]+\.[A-Za-z0-9]+[\)\>\}]{0,1}$g; push(@file_emails, clean_file_emails(@poss_addr)); }} ## Read mail address map# my $mailmap; read_mailmap(); sub read_mailmap { $mailmap = { names => {}, addresses => {} }; return if (!$email_use_mailmap || !(-f "${lk_path}.mailmap")); open(my $mailmap_file, '<', "${lk_path}.mailmap") or warn "$P: Can't open .mailmap: $!\n"; while (<$mailmap_file>) { s/#.*$//; #strip comments s/^\s+|\s+$//g; #trim next if (/^\s*$/); #skip empty lines #entries have one of the following formats: # name1 <mail1> # <mail1> <mail2> # name1 <mail1> <mail2> # name1 <mail1> name2 <mail2> # (see man git-shortlog) if (/^([^<]+)<([^>]+)>$/) { my $real_name = $1;Lines 1–500 of 2673. Load more
#!/usr/bin/env perl # SPDX-License-Identifier: GPL-2.0 # # (c) 2007, Joe Perches <joe@perches.com> # created from checkpatch.pl # # Print selected MAINTAINERS information for # the files modified in a patch or for a file # # usage: perl scripts/get_maintainer.pl [OPTIONS] <patch> # perl scripts/get_maintainer.pl [OPTIONS] -f <file> use warnings; use strict; my $P = $0; my $V = '0.26'; use Getopt::Long qw(:config no_auto_abbrev); use Cwd; use File::Find; use File::Spec::Functions; use open qw(:std :encoding(UTF-8)); use JSON::PP; my $cur_path = fastgetcwd() . '/'; my $lk_path = "./"; my $email = 1; my $email_usename = 1; my $email_maintainer = 1; my $email_reviewer = 1; my $email_fixes = 1; my $email_list = 1; my $email_moderated_list = 1; my $email_subscriber_list = 0; my $email_git_penguin_chiefs = 0; my $email_git = 0; my $email_git_all_signature_types = 0; my $email_git_blame = 0; my $email_git_blame_signatures = 1; my $email_git_fallback = 1; my $email_git_min_signatures = 1; my $email_git_max_maintainers = 5; my $email_git_min_percent = 5; my $email_git_since = "1-year-ago"; my $email_hg_since = "-365"; my $interactive = 0; my $email_remove_duplicates = 1; my $email_use_mailmap = 1; my $output_multiline = 1; my $output_separator = ", "; my $output_roles = 0; my $output_rolestats = 1; my $output_substatus = undef; my $output_section_maxlen = 50; my $scm = 0; my $tree = 1; my $web = 0; my $bug = 0; my $subsystem = 0; my $status = 0; my $letters = ""; my $keywords = 1; my $keywords_in_file = 0; my $sections = 0; my $email_file_emails = 0; my $from_filename = 0; my $pattern_depth = 0; my $self_test = undef; my $version = 0; my $help = 0; my $json = 0; my $find_maintainer_files = 0; my $maintainer_path; my $vcs_used = 0; my $exit = 0; my @files = (); my @fixes = (); # If a patch description includes Fixes: lines my @range = (); my @keyword_tvi = (); my @file_emails = (); my %commit_author_hash; my %commit_signer_hash; my @penguin_chief = (); push(@penguin_chief, "Linus Torvalds:torvalds\@linux-foundation.org"); #Andrew wants in on most everything - 2009/01/14 #push(@penguin_chief, "Andrew Morton:akpm\@linux-foundation.org"); my @penguin_chief_names = (); foreach my $chief (@penguin_chief) { if ($chief =~ m/^(.*):(.*)/) { my $chief_name = $1; my $chief_addr = $2; push(@penguin_chief_names, $chief_name); } } my $penguin_chiefs = "\(" . join("|", @penguin_chief_names) . "\)"; # Signature types of people who are either # a) responsible for the code in question, or # b) familiar enough with it to give relevant feedback my @signature_tags = (); push(@signature_tags, "Signed-off-by:"); push(@signature_tags, "Reviewed-by:"); push(@signature_tags, "Acked-by:"); my $signature_pattern = "\(" . join("|", @signature_tags) . "\)"; # rfc822 email address - preloaded methods go here. my $rfc822_lwsp = "(?:(?:\\r\\n)?[ \\t])"; my $rfc822_char = '[\\000-\\377]'; # VCS command support: class-like functions and strings my %VCS_cmds; my %VCS_cmds_git = ( "execute_cmd" => \&git_execute_cmd, "available" => '(which("git") ne "") && (-e ".git")', "find_signers_cmd" => "git log --no-color --follow --since=\$email_git_since " . '--numstat --no-merges ' . '--format="GitCommit: %H%n' . 'GitAuthor: %an <%ae>%n' . 'GitDate: %aD%n' . 'GitSubject: %s%n' . '%b%n"' . " -- \$file", "find_commit_signers_cmd" => "git log --no-color " . '--numstat ' . '--format="GitCommit: %H%n' . 'GitAuthor: %an <%ae>%n' . 'GitDate: %aD%n' . 'GitSubject: %s%n' . '%b%n"' . " -1 \$commit", "find_commit_author_cmd" => "git log --no-color " . '--numstat ' . '--format="GitCommit: %H%n' . 'GitAuthor: %an <%ae>%n' . 'GitDate: %aD%n' . 'GitSubject: %s%n"' . " -1 \$commit", "blame_range_cmd" => "git blame -l -L \$diff_start,+\$diff_length \$file", "blame_file_cmd" => "git blame -l \$file", "commit_pattern" => "^GitCommit: ([0-9a-f]{40,40})", "blame_commit_pattern" => "^([0-9a-f]+) ", "author_pattern" => "^GitAuthor: (.*)", "subject_pattern" => "^GitSubject: (.*)", "stat_pattern" => "^(\\d+)\\t(\\d+)\\t\$file\$", "file_exists_cmd" => "git ls-files \$file", "list_files_cmd" => "git ls-files \$file", ); my %VCS_cmds_hg = ( "execute_cmd" => \&hg_execute_cmd, "available" => '(which("hg") ne "") && (-d ".hg")', "find_signers_cmd" => "hg log --date=\$email_hg_since " . "--template='HgCommit: {node}\\n" . "HgAuthor: {author}\\n" . "HgSubject: {desc}\\n'" . " -- \$file", "find_commit_signers_cmd" => "hg log " . "--template='HgSubject: {desc}\\n'" . " -r \$commit", "find_commit_author_cmd" => "hg log " . "--template='HgCommit: {node}\\n" . "HgAuthor: {author}\\n" . "HgSubject: {desc|firstline}\\n'" . " -r \$commit", "blame_range_cmd" => "", # not supported "blame_file_cmd" => "hg blame -n \$file", "commit_pattern" => "^HgCommit: ([0-9a-f]{40,40})", "blame_commit_pattern" => "^([ 0-9a-f]+):", "author_pattern" => "^HgAuthor: (.*)", "subject_pattern" => "^HgSubject: (.*)", "stat_pattern" => "^(\\d+)\t(\\d+)\t\$file\$", "file_exists_cmd" => "hg files \$file", "list_files_cmd" => "hg manifest -R \$file", ); my $conf = which_conf(".get_maintainer.conf"); if (-f $conf) { my @conf_args; open(my $conffile, '<', "$conf") or warn "$P: Can't find a readable .get_maintainer.conf file $!\n"; while (<$conffile>) { my $line = $_; $line =~ s/\s*\n?$//g; $line =~ s/^\s*//g; $line =~ s/\s+/ /g; next if ($line =~ m/^\s*#/); next if ($line =~ m/^\s*$/); my @words = split(" ", $line); foreach my $word (@words) { last if ($word =~ m/^#/); push (@conf_args, $word); } } close($conffile); unshift(@ARGV, @conf_args) if @conf_args; } my @ignore_emails = (); my $ignore_file = which_conf(".get_maintainer.ignore"); if (-f $ignore_file) { open(my $ignore, '<', "$ignore_file") or warn "$P: Can't find a readable .get_maintainer.ignore file $!\n"; while (<$ignore>) { my $line = $_; $line =~ s/\s*\n?$//; $line =~ s/^\s*//; $line =~ s/\s+$//; $line =~ s/#.*$//; next if ($line =~ m/^\s*$/); if (rfc822_valid($line)) { push(@ignore_emails, $line); } } close($ignore); } if ($#ARGV > 0) { foreach (@ARGV) { if ($_ =~ /^-{1,2}self-test(?:=|$)/) { die "$P: using --self-test does not allow any other option or argument\n"; } } } if (!GetOptions( 'email!' => \$email, 'git!' => \$email_git, 'git-all-signature-types!' => \$email_git_all_signature_types, 'git-blame!' => \$email_git_blame, 'git-blame-signatures!' => \$email_git_blame_signatures, 'git-fallback!' => \$email_git_fallback, 'git-chief-penguins!' => \$email_git_penguin_chiefs, 'git-min-signatures=i' => \$email_git_min_signatures, 'git-max-maintainers=i' => \$email_git_max_maintainers, 'git-min-percent=i' => \$email_git_min_percent, 'git-since=s' => \$email_git_since, 'hg-since=s' => \$email_hg_since, 'i|interactive!' => \$interactive, 'remove-duplicates!' => \$email_remove_duplicates, 'mailmap!' => \$email_use_mailmap, 'm!' => \$email_maintainer, 'r!' => \$email_reviewer, 'n!' => \$email_usename, 'l!' => \$email_list, 'fixes!' => \$email_fixes, 'moderated!' => \$email_moderated_list, 's!' => \$email_subscriber_list, 'multiline!' => \$output_multiline, 'roles!' => \$output_roles, 'rolestats!' => \$output_rolestats, 'separator=s' => \$output_separator, 'subsystem!' => \$subsystem, 'status!' => \$status, 'substatus!' => \$output_substatus, 'scm!' => \$scm, 'tree!' => \$tree, 'web!' => \$web, 'bug!' => \$bug, 'letters=s' => \$letters, 'pattern-depth=i' => \$pattern_depth, 'k|keywords!' => \$keywords, 'kf|keywords-in-file!' => \$keywords_in_file, 'sections!' => \$sections, 'fe|file-emails!' => \$email_file_emails, 'f|file' => \$from_filename, 'find-maintainer-files' => \$find_maintainer_files, 'mpath|maintainer-path=s' => \$maintainer_path, 'self-test:s' => \$self_test, 'json!' => \$json, 'v|version' => \$version, 'h|help|usage' => \$help, )) { die "$P: invalid argument - use --help if necessary\n"; } if ($help != 0) { usage(); exit 0; } if ($version != 0) { print("${P} ${V}\n"); exit 0; } if (defined $self_test) { read_all_maintainer_files(); self_test(); exit 0; } if (-t STDIN && !@ARGV) { # We're talking to a terminal, but have no command line arguments. die "$P: missing patchfile or -f file - use --help if necessary\n"; } $output_multiline = 0 if ($output_separator ne ", "); $output_rolestats = 1 if ($interactive); $output_roles = 1 if ($output_rolestats); if (!defined $output_substatus) { $output_substatus = $email && $output_roles && -t STDOUT; } if ($sections || $letters ne "") { $sections = 1; $email = 0; $email_list = 0; $scm = 0; $status = 0; $subsystem = 0; $web = 0; $bug = 0; $keywords = 0; $keywords_in_file = 0; $interactive = 0; } else { my $selections = $email + $scm + $status + $subsystem + $web + $bug; if ($selections == 0) { die "$P: Missing required option: email, scm, status, subsystem, web or bug\n"; } } if ($email && ($email_maintainer + $email_reviewer + $email_list + $email_subscriber_list + $email_git + $email_git_penguin_chiefs + $email_git_blame) == 0) { die "$P: Please select at least 1 email option\n"; } if ($tree && !top_of_kernel_tree($lk_path)) { die "$P: The current directory does not appear to be " . "a linux kernel source tree.\n"; } ## Read MAINTAINERS for type/value pairs my @typevalue = (); my %keyword_hash; my @mfiles = (); my @self_test_info = (); sub read_maintainer_file { my ($file) = @_; open (my $maint, '<', "$file") or die "$P: Can't open MAINTAINERS file '$file': $!\n"; my $i = 1; while (<$maint>) { my $line = $_; chomp $line; if ($line =~ m/^([A-Z]):\s*(.*)/) { my $type = $1; my $value = $2; ##Filename pattern matching if ($type eq "F" || $type eq "X") { $value =~ s@\.@\\\.@g; ##Convert . to \. $value =~ s/\*\*/\x00/g; ##Convert ** to placeholder $value =~ s/\*/\.\*/g; ##Convert * to .* $value =~ s/\?/\./g; ##Convert ? to . $value =~ s/\x00/(?:.*)/g; ##Convert placeholder to (?:.*) ##if pattern is a directory and it lacks a trailing slash, add one if ((-d $value)) { $value =~ s@([^/])$@$1/@; } } elsif ($type eq "K") { $keyword_hash{@typevalue} = $value; } push(@typevalue, "$type:$value"); } elsif (!(/^\s*$/ || /^\s*\#/)) { push(@typevalue, $line); } if (defined $self_test) { push(@self_test_info, {file=>$file, linenr=>$i, line=>$line}); } $i++; } close($maint); } sub find_is_maintainer_file { my ($file) = $_; return if ($file !~ m@/MAINTAINERS$@); $file = $File::Find::name; return if (! -f $file); push(@mfiles, $file); } sub find_ignore_git { return grep { $_ !~ /^\.git$/; } @_; } read_all_maintainer_files(); sub read_all_maintainer_files { my $path = "${lk_path}MAINTAINERS"; if (defined $maintainer_path) { $path = $maintainer_path; # Perl Cookbook tilde expansion if necessary $path =~ s@^~([^/]*)@ $1 ? (getpwnam($1))[7] : ( $ENV{HOME} || $ENV{LOGDIR} || (getpwuid($<))[7])@ex; } if (-d $path) { $path .= '/' if ($path !~ m@/$@); if ($find_maintainer_files) { find( { wanted => \&find_is_maintainer_file, preprocess => \&find_ignore_git, no_chdir => 1, }, "$path"); } else { opendir(DIR, "$path") or die $!; my @files = readdir(DIR); closedir(DIR); foreach my $file (@files) { push(@mfiles, "$path$file") if ($file !~ /^\./); } } } elsif (-f "$path") { push(@mfiles, "$path"); } else { die "$P: MAINTAINER file not found '$path'\n"; } die "$P: No MAINTAINER files found in '$path'\n" if (scalar(@mfiles) == 0); foreach my $file (@mfiles) { read_maintainer_file("$file"); } } sub maintainers_in_file { my ($file) = @_; return if ($file =~ m@\bMAINTAINERS$@); if (-f $file && ($email_file_emails || $file =~ /\.yaml$/)) { open(my $f, '<', $file) or die "$P: Can't open $file: $!\n"; my $text = do { local($/) ; <$f> }; close($f); my @poss_addr = $text =~ m$[\p{L}\"\' \,\.\+-]*\s*[\,]*\s*[\(\<\{]{0,1}[A-Za-z0-9_\.\+-]+\@[A-Za-z0-9\.-]+\.[A-Za-z0-9]+[\)\>\}]{0,1}$g; push(@file_emails, clean_file_emails(@poss_addr)); } } # # Read mail address map # my $mailmap; read_mailmap(); sub read_mailmap { $mailmap = { names => {}, addresses => {} }; return if (!$email_use_mailmap || !(-f "${lk_path}.mailmap")); open(my $mailmap_file, '<', "${lk_path}.mailmap") or warn "$P: Can't open .mailmap: $!\n"; while (<$mailmap_file>) { s/#.*$//; #strip comments s/^\s+|\s+$//g; #trim next if (/^\s*$/); #skip empty lines #entries have one of the following formats: # name1 <mail1> # <mail1> <mail2> # name1 <mail1> <mail2> # name1 <mail1> name2 <mail2> # (see man git-shortlog) if (/^([^<]+)<([^>]+)>$/) { my $real_name = $1;