957 lines · 22.5 KB · Perl
RawDownload
#!/usr/bin/perl -w# (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>## Licensed under the terms of the GNU GPL License version 2 use strict; my $P = $0;my $V = '0.21'; use Getopt::Long qw(:config no_auto_abbrev); my $lk_path = "./";my $email = 1;my $email_usename = 1;my $email_maintainer = 1;my $email_list = 1;my $email_subscriber_list = 0;my $email_git = 1;my $email_git_penguin_chiefs = 0;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_git_blame = 0;my $email_remove_duplicates = 1;my $output_multiline = 1;my $output_separator = ", ";my $scm = 0;my $web = 0;my $subsystem = 0;my $status = 0;my $keywords = 1;my $from_filename = 0;my $pattern_depth = 0;my $version = 0;my $help = 0; my $exit = 0; 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) . "\)"; # rfc822 email address - preloaded methods go here.my $rfc822_lwsp = "(?:(?:\\r\\n)?[ \\t])";my $rfc822_char = '[\\000-\\377]'; if (!GetOptions(		'email!' => \$email,		'git!' => \$email_git,		'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,		'git-blame!' => \$email_git_blame,		'remove-duplicates!' => \$email_remove_duplicates,		'm!' => \$email_maintainer,		'n!' => \$email_usename,		'l!' => \$email_list,		's!' => \$email_subscriber_list,		'multiline!' => \$output_multiline,		'separator=s' => \$output_separator,		'subsystem!' => \$subsystem,		'status!' => \$status,		'scm!' => \$scm,		'web!' => \$web,		'pattern-depth=i' => \$pattern_depth,		'k|keywords!' => \$keywords,		'f|file' => \$from_filename,		'v|version' => \$version,		'h|help' => \$help,		)) {    usage();    die "$P: invalid argument\n";} if ($help != 0) {    usage();    exit 0;} if ($version != 0) {    print("${P} ${V}\n");    exit 0;} if ($#ARGV < 0) {    usage();    die "$P: argument missing: patchfile or -f file please\n";} if ($output_separator ne ", ") {    $output_multiline = 0;} my $selections = $email + $scm + $status + $subsystem + $web;if ($selections == 0) {    usage();    die "$P:  Missing required option: email, scm, status, subsystem or web\n";} if ($email &&    ($email_maintainer + $email_list + $email_subscriber_list +     $email_git + $email_git_penguin_chiefs + $email_git_blame) == 0) {    usage();    die "$P: Please select at least 1 email option\n";} if (!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; open(MAINT, "<${lk_path}MAINTAINERS") || die "$P: Can't open MAINTAINERS\n";while (<MAINT>) {    my $line = $_;     if ($line =~ m/^(\C):\s*(.*)/) {	my $type = $1;	my $value = $2; 	##Filename pattern matching	if ($type eq "F" || $type eq "X") {	    $value =~ s@\.@\\\.@g;       ##Convert . to \.	    $value =~ s/\*/\.\*/g;       ##Convert * to .*	    $value =~ s/\?/\./g;         ##Convert ? 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)*$/) {	$line =~ s/\n$//g;	push(@typevalue, $line);    }}close(MAINT); my %mailmap; if ($email_remove_duplicates) {    open(MAILMAP, "<${lk_path}.mailmap") || warn "$P: Can't open .mailmap\n";    while (<MAILMAP>) {	my $line = $_; 	next if ($line =~ m/^\s*#/);	next if ($line =~ m/^\s*$/); 	my ($name, $address) = parse_email($line);	$line = format_email($name, $address); 	next if ($line =~ m/^\s*$/); 	if (exists($mailmap{$name})) {	    my $obj = $mailmap{$name};	    push(@$obj, $address);	} else {	    my @arr = ($address);	    $mailmap{$name} = \@arr;	}    }    close(MAILMAP);} ## use the filenames on the command line or find the filenames in the patchfiles my @files = ();my @range = ();my @keyword_tvi = (); foreach my $file (@ARGV) {    ##if $file is a directory and it lacks a trailing slash, add one    if ((-d $file)) {	$file =~ s@([^/])$@$1/@;    } elsif (!(-f $file)) {	die "$P: file '${file}' not found\n";    }    if ($from_filename) {	push(@files, $file);	if (-f $file && $keywords) {	    open(FILE, "<$file") or die "$P: Can't open ${file}\n";	    while (<FILE>) {		my $patch_line = $_;		foreach my $line (keys %keyword_hash) {		    if ($patch_line =~ m/^.*$keyword_hash{$line}/x) {			push(@keyword_tvi, $line);		    }		}	    }	    close(FILE);	}    } else {	my $file_cnt = @files;	my $lastfile;	open(PATCH, "<$file") or die "$P: Can't open ${file}\n";	while (<PATCH>) {	    my $patch_line = $_;	    if (m/^\+\+\+\s+(\S+)/) {		my $filename = $1;		$filename =~ s@^[^/]*/@@;		$filename =~ s@\n@@;		$lastfile = $filename;		push(@files, $filename);	    } elsif (m/^\@\@ -(\d+),(\d+)/) {		if ($email_git_blame) {		    push(@range, "$lastfile:$1:$2");		}	    } elsif ($keywords) {		foreach my $line (keys %keyword_hash) {		    if ($patch_line =~ m/^[+-].*$keyword_hash{$line}/x) {			push(@keyword_tvi, $line);		    }		}	    }	}	close(PATCH);	if ($file_cnt == @files) {	    warn "$P: file '${file}' doesn't appear to be a patch.  "		. "Add -f to options?\n";	}	@files = sort_and_uniq(@files);    }} my @email_to = ();my @list_to = ();my @scm = ();my @web = ();my @subsystem = ();my @status = (); # Find responsible parties foreach my $file (@files) { #Do not match excluded file patterns     my $exclude = 0;    foreach my $line (@typevalue) {	if ($line =~ m/^(\C):\s*(.*)/) {	    my $type = $1;	    my $value = $2;	    if ($type eq 'X') {		if (file_match_pattern($file, $value)) {		    $exclude = 1;		    last;		}	    }	}    }     if (!$exclude) {	my $tvi = 0;	my %hash;	foreach my $line (@typevalue) {	    if ($line =~ m/^(\C):\s*(.*)/) {		my $type = $1;		my $value = $2;		if ($type eq 'F') {		    if (file_match_pattern($file, $value)) {			my $value_pd = ($value =~ tr@/@@);			my $file_pd = ($file  =~ tr@/@@);			$value_pd++ if (substr($value,-1,1) ne "/");			if ($pattern_depth == 0 ||			    (($file_pd - $value_pd) < $pattern_depth)) {			    $hash{$tvi} = $value_pd;			}		    }		}	    }	    $tvi++;	}	foreach my $line (sort {$hash{$b} <=> $hash{$a}} keys %hash) {	    add_categories($line);	}    }     if ($email && $email_git) {	recent_git_signoffs($file);    }     if ($email && $email_git_blame) {	git_assign_blame($file);    }} if ($keywords) {    @keyword_tvi = sort_and_uniq(@keyword_tvi);    foreach my $line (@keyword_tvi) {	add_categories($line);    }} if ($email) {    foreach my $chief (@penguin_chief) {	if ($chief =~ m/^(.*):(.*)/) {	    my $email_address; 	    $email_address = format_email($1, $2);	    if ($email_git_penguin_chiefs) {		push(@email_to, $email_address);	    } else {		@email_to = grep(!/${email_address}/, @email_to);	    }	}    }} if ($email || $email_list) {    my @to = ();    if ($email) {	@to = (@to, @email_to);    }    if ($email_list) {	@to = (@to, @list_to);    }    output(uniq(@to));} if ($scm) {    @scm = uniq(@scm);    output(@scm);} if ($status) {    @status = uniq(@status);    output(@status);} if ($subsystem) {    @subsystem = uniq(@subsystem);    output(@subsystem);} if ($web) {    @web = uniq(@web);    output(@web);} exit($exit); sub file_match_pattern {    my ($file, $pattern) = @_;    if (substr($pattern, -1) eq "/") {	if ($file =~ m@^$pattern@) {	    return 1;	}    } else {	if ($file =~ m@^$pattern@) {	    my $s1 = ($file =~ tr@/@@);	    my $s2 = ($pattern =~ tr@/@@);	    if ($s1 == $s2) {		return 1;	    }	}    }    return 0;} sub usage {    print <<EOT;usage: $P [options] patchfile       $P [options] -f file|directoryversion: $V MAINTAINER field selection options:  --email => print email address(es) if any    --git => include recent git \*-by: signers    --git-chief-penguins => include ${penguin_chiefs}    --git-min-signatures => number of signatures required (default: 1)    --git-max-maintainers => maximum maintainers to add (default: 5)    --git-min-percent => minimum percentage of commits required (default: 5)    --git-since => git history to use (default: 1-year-ago)    --git-blame => use git blame to find modified commits for patch or file    --m => include maintainer(s) if any    --n => include name 'Full Name <addr\@domain.tld>'    --l => include list(s) if any    --s => include subscriber only list(s) if any    --remove-duplicates => minimize duplicate email names/addresses  --scm => print SCM tree(s) if any  --status => print status if any  --subsystem => print subsystem name if any  --web => print website(s) if any Output type options:  --separator [, ] => separator for multiple entries on 1 line    using --separator also sets --nomultiline if --separator is not [, ]  --multiline => print 1 entry per line Other options:  --pattern-depth => Number of pattern directory traversals (default: 0 (all))  --keywords => scan patch for keywords (default: 1 (on))  --version => show version  --help => show this help information Default options:  [--email --git --m --n --l --multiline --pattern-depth=0 --remove-duplicates] Notes:  Using "-f directory" may give unexpected results:      Used with "--git", git signators for _all_ files in and below          directory are examined as git recurses directories.          Any specified X: (exclude) pattern matches are _not_ ignored.      Used with "--nogit", directory is used as a pattern match,         no individual file within the directory or subdirectory         is matched.      Used with "--git-blame", does not iterate all files in directory  Using "--git-blame" is slow and may add old committers and authors      that are no longer active maintainers to the output.EOT} sub top_of_kernel_tree {	my ($lk_path) = @_; 	if ($lk_path ne "" && substr($lk_path,length($lk_path)-1,1) ne "/") {	    $lk_path .= "/";	}	if (   (-f "${lk_path}COPYING")	    && (-f "${lk_path}CREDITS")	    && (-f "${lk_path}Kbuild")	    && (-f "${lk_path}MAINTAINERS")	    && (-f "${lk_path}Makefile")	    && (-f "${lk_path}README")	    && (-d "${lk_path}Documentation")	    && (-d "${lk_path}arch")	    && (-d "${lk_path}include")	    && (-d "${lk_path}drivers")	    && (-d "${lk_path}fs")	    && (-d "${lk_path}init")	    && (-d "${lk_path}ipc")	    && (-d "${lk_path}kernel")	    && (-d "${lk_path}lib")	    && (-d "${lk_path}scripts")) {		return 1;	}	return 0;} sub parse_email {    my ($formatted_email) = @_;     my $name = "";    my $address = "";     if ($formatted_email =~ /^([^<]+)<(.+\@.*)>.*$/) {	$name = $1;	$address = $2;    } elsif ($formatted_email =~ /^\s*<(.+\@\S*)>.*$/) {	$address = $1;    } elsif ($formatted_email =~ /^(.+\@\S*).*$/) {	$address = $1;    }     $name =~ s/^\s+|\s+$//g;    $name =~ s/^\"|\"$//g;    $address =~ s/^\s+|\s+$//g;     if ($name =~ /[^a-z0-9 \.\-]/i) {    ##has "must quote" chars	$name =~ s/(?<!\\)"/\\"/g;       ##escape quotes	$name = "\"$name\"";    }     return ($name, $address);} sub format_email {    my ($name, $address) = @_;     my $formatted_email;     $name =~ s/^\s+|\s+$//g;

Lines 1–500 of 957.