xref: /linux-6.15/scripts/checkpatch.pl (revision 481efd7b)
1cb77f0d6SKamil Rytarowski#!/usr/bin/env perl
2882ea1d6SJoe Perches# SPDX-License-Identifier: GPL-2.0
3882ea1d6SJoe Perches#
4dbf004d7SDave Jones# (c) 2001, Dave Jones. (the file handling bit)
500df344fSAndy Whitcroft# (c) 2005, Joel Schopp <[email protected]> (the ugly bit)
62a5a2c25SAndy Whitcroft# (c) 2007,2008, Andy Whitcroft <[email protected]> (new conditions, test suite)
7015830beSAndy Whitcroft# (c) 2008-2010 Andy Whitcroft <[email protected]>
8882ea1d6SJoe Perches# (c) 2010-2018 Joe Perches <[email protected]>
90a920b5bSAndy Whitcroft
100a920b5bSAndy Whitcroftuse strict;
11cb77f0d6SKamil Rytarowskiuse warnings;
12c707a81dSJoe Perchesuse POSIX;
1336061e38SJoe Perchesuse File::Basename;
1436061e38SJoe Perchesuse Cwd 'abs_path';
1557230297SJoe Perchesuse Term::ANSIColor qw(:constants);
16cd261496SGeert Uytterhoevenuse Encode qw(decode encode);
170a920b5bSAndy Whitcroft
180a920b5bSAndy Whitcroftmy $P = $0;
1936061e38SJoe Perchesmy $D = dirname(abs_path($P));
200a920b5bSAndy Whitcroft
21000d1cc1SJoe Perchesmy $V = '0.32';
220a920b5bSAndy Whitcroft
230a920b5bSAndy Whitcroftuse Getopt::Long qw(:config no_auto_abbrev);
240a920b5bSAndy Whitcroft
250a920b5bSAndy Whitcroftmy $quiet = 0;
2652178ce0SDwaipayan Raymy $verbose = 0;
2752178ce0SDwaipayan Raymy %verbose_messages = ();
2852178ce0SDwaipayan Raymy %verbose_emitted = ();
290a920b5bSAndy Whitcroftmy $tree = 1;
300a920b5bSAndy Whitcroftmy $chk_signoff = 1;
310a920b5bSAndy Whitcroftmy $chk_patch = 1;
32773647a0SAndy Whitcroftmy $tst_only;
336c72ffaaSAndy Whitcroftmy $emacs = 0;
348905a67cSAndy Whitcroftmy $terse = 0;
3534d8815fSJoe Perchesmy $showfile = 0;
366c72ffaaSAndy Whitcroftmy $file = 0;
374a593c34SDu, Changbinmy $git = 0;
380dea9f1eSJoe Perchesmy %git_commits = ();
396c72ffaaSAndy Whitcroftmy $check = 0;
402ac73b4fSJoe Perchesmy $check_orig = 0;
418905a67cSAndy Whitcroftmy $summary = 1;
428905a67cSAndy Whitcroftmy $mailback = 0;
4313214adfSAndy Whitcroftmy $summary_file = 0;
44000d1cc1SJoe Perchesmy $show_types = 0;
453beb42ecSJoe Perchesmy $list_types = 0;
463705ce5bSJoe Perchesmy $fix = 0;
479624b8d6SJoe Perchesmy $fix_inplace = 0;
486c72ffaaSAndy Whitcroftmy $root;
490f7f635bSJoe Perchesmy $gitroot = $ENV{'GIT_DIR'};
500f7f635bSJoe Perches$gitroot = ".git" if !defined($gitroot);
51c2fdda0dSAndy Whitcroftmy %debug;
523445686aSJoe Perchesmy %camelcase = ();
5391bfe484SJoe Perchesmy %use_type = ();
5491bfe484SJoe Perchesmy @use = ();
5591bfe484SJoe Perchesmy %ignore_type = ();
56000d1cc1SJoe Perchesmy @ignore = ();
5777f5b10aSHannes Edermy $help = 0;
58000d1cc1SJoe Perchesmy $configuration_file = ".checkpatch.conf";
59bdc48fa1SJoe Perchesmy $max_line_length = 100;
60d62a201fSDave Hansenmy $ignore_perl_version = 0;
61d62a201fSDave Hansenmy $minimum_perl_version = 5.10.0;
6256193274SVadim Bendeburymy $min_conf_desc_length = 4;
6366b47b4aSKees Cookmy $spelling_file = "$D/spelling.txt";
64ebfd7d62SJoe Perchesmy $codespell = 0;
65f1a63678SMaxim Uvarovmy $codespellfile = "/usr/share/codespell/dictionary.txt";
660ee3e7b8SPeter Ujfalusimy $user_codespellfile = "";
67bf1fa1daSJoe Perchesmy $conststructsfile = "$D/const_structs.checkpatch";
6852178ce0SDwaipayan Raymy $docsfile = "$D/../Documentation/dev-tools/checkpatch.rst";
69ced69da1SQuentin Monnetmy $typedefsfile;
70737c0767SJohn Brooksmy $color = "auto";
7198005e8cSVadim Bendeburymy $allow_c99_comments = 1; # Can be overridden by --ignore C99_COMMENT_TOLERANCE
72dbbf869dSJoe Perches# git output parsing needs US English output, so first set backtick child process LANGUAGE
73dbbf869dSJoe Perchesmy $git_command ='export LANGUAGE=en_US.UTF-8; git';
74713a09deSAntonio Borneomy $tabsize = 8;
753e89ad85SJerome Forissiermy ${CONFIG_} = "CONFIG_";
7677f5b10aSHannes Eder
7777f5b10aSHannes Edersub help {
7877f5b10aSHannes Eder	my ($exitcode) = @_;
7977f5b10aSHannes Eder
8077f5b10aSHannes Eder	print << "EOM";
8177f5b10aSHannes EderUsage: $P [OPTION]... [FILE]...
8277f5b10aSHannes EderVersion: $V
8377f5b10aSHannes Eder
8477f5b10aSHannes EderOptions:
8577f5b10aSHannes Eder  -q, --quiet                quiet
8652178ce0SDwaipayan Ray  -v, --verbose              verbose mode
8777f5b10aSHannes Eder  --no-tree                  run without a kernel tree
8877f5b10aSHannes Eder  --no-signoff               do not check for 'Signed-off-by' line
8977f5b10aSHannes Eder  --patch                    treat FILE as patchfile (default)
9077f5b10aSHannes Eder  --emacs                    emacs compile window format
9177f5b10aSHannes Eder  --terse                    one line per report
9234d8815fSJoe Perches  --showfile                 emit diffed file position, not input file position
934a593c34SDu, Changbin  -g, --git                  treat FILE as a single commit or git revision range
944a593c34SDu, Changbin                             single git commit with:
954a593c34SDu, Changbin                               <rev>
964a593c34SDu, Changbin                               <rev>^
974a593c34SDu, Changbin                               <rev>~n
984a593c34SDu, Changbin                             multiple git commits with:
994a593c34SDu, Changbin                               <rev1>..<rev2>
1004a593c34SDu, Changbin                               <rev1>...<rev2>
1014a593c34SDu, Changbin                               <rev>-<count>
1024a593c34SDu, Changbin                             git merges are ignored
10377f5b10aSHannes Eder  -f, --file                 treat FILE as regular source file
10477f5b10aSHannes Eder  --subjective, --strict     enable more subjective tests
1053beb42ecSJoe Perches  --list-types               list the possible message types
10691bfe484SJoe Perches  --types TYPE(,TYPE2...)    show only these comma separated message types
107000d1cc1SJoe Perches  --ignore TYPE(,TYPE2...)   ignore various comma separated message types
1083beb42ecSJoe Perches  --show-types               show the specific message type in the output
109bdc48fa1SJoe Perches  --max-line-length=n        set the maximum line length, (default $max_line_length)
110bdc48fa1SJoe Perches                             if exceeded, warn on patches
111bdc48fa1SJoe Perches                             requires --strict for use with --file
11256193274SVadim Bendebury  --min-conf-desc-length=n   set the min description length, if shorter, warn
113bdc48fa1SJoe Perches  --tab-size=n               set the number of spaces for tab (default $tabsize)
11477f5b10aSHannes Eder  --root=PATH                PATH to the kernel tree root
11577f5b10aSHannes Eder  --no-summary               suppress the per-file summary
11677f5b10aSHannes Eder  --mailback                 only produce a report in case of warnings/errors
11777f5b10aSHannes Eder  --summary-file             include the filename in summary
11877f5b10aSHannes Eder  --debug KEY=[0|1]          turn on/off debugging of KEY, where KEY is one of
11977f5b10aSHannes Eder                             'values', 'possible', 'type', and 'attr' (default
12077f5b10aSHannes Eder                             is all off)
12177f5b10aSHannes Eder  --test-only=WORD           report only warnings/errors containing WORD
12277f5b10aSHannes Eder                             literally
1233705ce5bSJoe Perches  --fix                      EXPERIMENTAL - may create horrible results
1243705ce5bSJoe Perches                             If correctable single-line errors exist, create
1253705ce5bSJoe Perches                             "<inputfile>.EXPERIMENTAL-checkpatch-fixes"
1263705ce5bSJoe Perches                             with potential errors corrected to the preferred
1273705ce5bSJoe Perches                             checkpatch style
1289624b8d6SJoe Perches  --fix-inplace              EXPERIMENTAL - may create horrible results
1299624b8d6SJoe Perches                             Is the same as --fix, but overwrites the input
1309624b8d6SJoe Perches                             file.  It's your fault if there's no backup or git
131d62a201fSDave Hansen  --ignore-perl-version      override checking of perl version.  expect
132d62a201fSDave Hansen                             runtime errors.
133ebfd7d62SJoe Perches  --codespell                Use the codespell dictionary for spelling/typos
1340ee3e7b8SPeter Ujfalusi                             (default:$codespellfile)
135ebfd7d62SJoe Perches  --codespellfile            Use this codespell dictionary
13675ad8c57SJerome Forissier  --typedefsfile             Read additional types from this file
137737c0767SJohn Brooks  --color[=WHEN]             Use colors 'always', 'never', or only when output
138737c0767SJohn Brooks                             is a terminal ('auto'). Default is 'auto'.
1393e89ad85SJerome Forissier  --kconfig-prefix=WORD      use WORD as a prefix for Kconfig symbols (default
1403e89ad85SJerome Forissier                             ${CONFIG_})
14177f5b10aSHannes Eder  -h, --help, --version      display this help and exit
14277f5b10aSHannes Eder
14377f5b10aSHannes EderWhen FILE is - read standard input.
14477f5b10aSHannes EderEOM
14577f5b10aSHannes Eder
14677f5b10aSHannes Eder	exit($exitcode);
14777f5b10aSHannes Eder}
14877f5b10aSHannes Eder
1493beb42ecSJoe Perchessub uniq {
1503beb42ecSJoe Perches	my %seen;
1513beb42ecSJoe Perches	return grep { !$seen{$_}++ } @_;
1523beb42ecSJoe Perches}
1533beb42ecSJoe Perches
1543beb42ecSJoe Perchessub list_types {
1553beb42ecSJoe Perches	my ($exitcode) = @_;
1563beb42ecSJoe Perches
1573beb42ecSJoe Perches	my $count = 0;
1583beb42ecSJoe Perches
1593beb42ecSJoe Perches	local $/ = undef;
1603beb42ecSJoe Perches
1613beb42ecSJoe Perches	open(my $script, '<', abs_path($P)) or
1623beb42ecSJoe Perches	    die "$P: Can't read '$P' $!\n";
1633beb42ecSJoe Perches
1643beb42ecSJoe Perches	my $text = <$script>;
1653beb42ecSJoe Perches	close($script);
1663beb42ecSJoe Perches
16752178ce0SDwaipayan Ray	my %types = ();
1680547fa58SJean Delvare	# Also catch when type or level is passed through a variable
16952178ce0SDwaipayan Ray	while ($text =~ /(?:(\bCHK|\bWARN|\bERROR|&\{\$msg_level})\s*\(|\$msg_type\s*=)\s*"([^"]+)"/g) {
17052178ce0SDwaipayan Ray		if (defined($1)) {
17152178ce0SDwaipayan Ray			if (exists($types{$2})) {
17252178ce0SDwaipayan Ray				$types{$2} .= ",$1" if ($types{$2} ne $1);
17352178ce0SDwaipayan Ray			} else {
17452178ce0SDwaipayan Ray				$types{$2} = $1;
1753beb42ecSJoe Perches			}
17652178ce0SDwaipayan Ray		} else {
17752178ce0SDwaipayan Ray			$types{$2} = "UNDETERMINED";
17852178ce0SDwaipayan Ray		}
17952178ce0SDwaipayan Ray	}
18052178ce0SDwaipayan Ray
1813beb42ecSJoe Perches	print("#\tMessage type\n\n");
18252178ce0SDwaipayan Ray	if ($color) {
18352178ce0SDwaipayan Ray		print(" ( Color coding: ");
18452178ce0SDwaipayan Ray		print(RED . "ERROR" . RESET);
18552178ce0SDwaipayan Ray		print(" | ");
18652178ce0SDwaipayan Ray		print(YELLOW . "WARNING" . RESET);
18752178ce0SDwaipayan Ray		print(" | ");
18852178ce0SDwaipayan Ray		print(GREEN . "CHECK" . RESET);
18952178ce0SDwaipayan Ray		print(" | ");
19052178ce0SDwaipayan Ray		print("Multiple levels / Undetermined");
19152178ce0SDwaipayan Ray		print(" )\n\n");
19252178ce0SDwaipayan Ray	}
19352178ce0SDwaipayan Ray
19452178ce0SDwaipayan Ray	foreach my $type (sort keys %types) {
19552178ce0SDwaipayan Ray		my $orig_type = $type;
19652178ce0SDwaipayan Ray		if ($color) {
19752178ce0SDwaipayan Ray			my $level = $types{$type};
19852178ce0SDwaipayan Ray			if ($level eq "ERROR") {
19952178ce0SDwaipayan Ray				$type = RED . $type . RESET;
20052178ce0SDwaipayan Ray			} elsif ($level eq "WARN") {
20152178ce0SDwaipayan Ray				$type = YELLOW . $type . RESET;
20252178ce0SDwaipayan Ray			} elsif ($level eq "CHK") {
20352178ce0SDwaipayan Ray				$type = GREEN . $type . RESET;
20452178ce0SDwaipayan Ray			}
20552178ce0SDwaipayan Ray		}
2063beb42ecSJoe Perches		print(++$count . "\t" . $type . "\n");
20752178ce0SDwaipayan Ray		if ($verbose && exists($verbose_messages{$orig_type})) {
20852178ce0SDwaipayan Ray			my $message = $verbose_messages{$orig_type};
20952178ce0SDwaipayan Ray			$message =~ s/\n/\n\t/g;
21052178ce0SDwaipayan Ray			print("\t" . $message . "\n\n");
21152178ce0SDwaipayan Ray		}
2123beb42ecSJoe Perches	}
2133beb42ecSJoe Perches
2143beb42ecSJoe Perches	exit($exitcode);
2153beb42ecSJoe Perches}
2163beb42ecSJoe Perches
217000d1cc1SJoe Perchesmy $conf = which_conf($configuration_file);
218000d1cc1SJoe Perchesif (-f $conf) {
219000d1cc1SJoe Perches	my @conf_args;
220000d1cc1SJoe Perches	open(my $conffile, '<', "$conf")
221000d1cc1SJoe Perches	    or warn "$P: Can't find a readable $configuration_file file $!\n";
222000d1cc1SJoe Perches
223000d1cc1SJoe Perches	while (<$conffile>) {
224000d1cc1SJoe Perches		my $line = $_;
225000d1cc1SJoe Perches
226000d1cc1SJoe Perches		$line =~ s/\s*\n?$//g;
227000d1cc1SJoe Perches		$line =~ s/^\s*//g;
228000d1cc1SJoe Perches		$line =~ s/\s+/ /g;
229000d1cc1SJoe Perches
230000d1cc1SJoe Perches		next if ($line =~ m/^\s*#/);
231000d1cc1SJoe Perches		next if ($line =~ m/^\s*$/);
232000d1cc1SJoe Perches
233000d1cc1SJoe Perches		my @words = split(" ", $line);
234000d1cc1SJoe Perches		foreach my $word (@words) {
235000d1cc1SJoe Perches			last if ($word =~ m/^#/);
236000d1cc1SJoe Perches			push (@conf_args, $word);
237000d1cc1SJoe Perches		}
238000d1cc1SJoe Perches	}
239000d1cc1SJoe Perches	close($conffile);
240000d1cc1SJoe Perches	unshift(@ARGV, @conf_args) if @conf_args;
241000d1cc1SJoe Perches}
242000d1cc1SJoe Perches
24352178ce0SDwaipayan Raysub load_docs {
24452178ce0SDwaipayan Ray	open(my $docs, '<', "$docsfile")
24552178ce0SDwaipayan Ray	    or warn "$P: Can't read the documentation file $docsfile $!\n";
24652178ce0SDwaipayan Ray
24752178ce0SDwaipayan Ray	my $type = '';
24852178ce0SDwaipayan Ray	my $desc = '';
24952178ce0SDwaipayan Ray	my $in_desc = 0;
25052178ce0SDwaipayan Ray
25152178ce0SDwaipayan Ray	while (<$docs>) {
25252178ce0SDwaipayan Ray		chomp;
25352178ce0SDwaipayan Ray		my $line = $_;
25452178ce0SDwaipayan Ray		$line =~ s/\s+$//;
25552178ce0SDwaipayan Ray
25652178ce0SDwaipayan Ray		if ($line =~ /^\s*\*\*(.+)\*\*$/) {
25752178ce0SDwaipayan Ray			if ($desc ne '') {
25852178ce0SDwaipayan Ray				$verbose_messages{$type} = trim($desc);
25952178ce0SDwaipayan Ray			}
26052178ce0SDwaipayan Ray			$type = $1;
26152178ce0SDwaipayan Ray			$desc = '';
26252178ce0SDwaipayan Ray			$in_desc = 1;
26352178ce0SDwaipayan Ray		} elsif ($in_desc) {
26452178ce0SDwaipayan Ray			if ($line =~ /^(?:\s{4,}|$)/) {
26552178ce0SDwaipayan Ray				$line =~ s/^\s{4}//;
26652178ce0SDwaipayan Ray				$desc .= $line;
26752178ce0SDwaipayan Ray				$desc .= "\n";
26852178ce0SDwaipayan Ray			} else {
26952178ce0SDwaipayan Ray				$verbose_messages{$type} = trim($desc);
27052178ce0SDwaipayan Ray				$type = '';
27152178ce0SDwaipayan Ray				$desc = '';
27252178ce0SDwaipayan Ray				$in_desc = 0;
27352178ce0SDwaipayan Ray			}
27452178ce0SDwaipayan Ray		}
27552178ce0SDwaipayan Ray	}
27652178ce0SDwaipayan Ray
27752178ce0SDwaipayan Ray	if ($desc ne '') {
27852178ce0SDwaipayan Ray		$verbose_messages{$type} = trim($desc);
27952178ce0SDwaipayan Ray	}
28052178ce0SDwaipayan Ray	close($docs);
28152178ce0SDwaipayan Ray}
28252178ce0SDwaipayan Ray
283737c0767SJohn Brooks# Perl's Getopt::Long allows options to take optional arguments after a space.
284737c0767SJohn Brooks# Prevent --color by itself from consuming other arguments
285737c0767SJohn Brooksforeach (@ARGV) {
286737c0767SJohn Brooks	if ($_ eq "--color" || $_ eq "-color") {
287737c0767SJohn Brooks		$_ = "--color=$color";
288737c0767SJohn Brooks	}
289737c0767SJohn Brooks}
290737c0767SJohn Brooks
2910a920b5bSAndy WhitcroftGetOptions(
2926c72ffaaSAndy Whitcroft	'q|quiet+'	=> \$quiet,
29352178ce0SDwaipayan Ray	'v|verbose!'	=> \$verbose,
2940a920b5bSAndy Whitcroft	'tree!'		=> \$tree,
2950a920b5bSAndy Whitcroft	'signoff!'	=> \$chk_signoff,
2960a920b5bSAndy Whitcroft	'patch!'	=> \$chk_patch,
2976c72ffaaSAndy Whitcroft	'emacs!'	=> \$emacs,
2988905a67cSAndy Whitcroft	'terse!'	=> \$terse,
29934d8815fSJoe Perches	'showfile!'	=> \$showfile,
30077f5b10aSHannes Eder	'f|file!'	=> \$file,
3014a593c34SDu, Changbin	'g|git!'	=> \$git,
3026c72ffaaSAndy Whitcroft	'subjective!'	=> \$check,
3036c72ffaaSAndy Whitcroft	'strict!'	=> \$check,
304000d1cc1SJoe Perches	'ignore=s'	=> \@ignore,
30591bfe484SJoe Perches	'types=s'	=> \@use,
306000d1cc1SJoe Perches	'show-types!'	=> \$show_types,
3073beb42ecSJoe Perches	'list-types!'	=> \$list_types,
3086cd7f386SJoe Perches	'max-line-length=i' => \$max_line_length,
30956193274SVadim Bendebury	'min-conf-desc-length=i' => \$min_conf_desc_length,
310713a09deSAntonio Borneo	'tab-size=i'	=> \$tabsize,
3116c72ffaaSAndy Whitcroft	'root=s'	=> \$root,
3128905a67cSAndy Whitcroft	'summary!'	=> \$summary,
3138905a67cSAndy Whitcroft	'mailback!'	=> \$mailback,
31413214adfSAndy Whitcroft	'summary-file!'	=> \$summary_file,
3153705ce5bSJoe Perches	'fix!'		=> \$fix,
3169624b8d6SJoe Perches	'fix-inplace!'	=> \$fix_inplace,
317d62a201fSDave Hansen	'ignore-perl-version!' => \$ignore_perl_version,
318c2fdda0dSAndy Whitcroft	'debug=s'	=> \%debug,
319773647a0SAndy Whitcroft	'test-only=s'	=> \$tst_only,
320ebfd7d62SJoe Perches	'codespell!'	=> \$codespell,
3210ee3e7b8SPeter Ujfalusi	'codespellfile=s'	=> \$user_codespellfile,
32275ad8c57SJerome Forissier	'typedefsfile=s'	=> \$typedefsfile,
323737c0767SJohn Brooks	'color=s'	=> \$color,
324737c0767SJohn Brooks	'no-color'	=> \$color,	#keep old behaviors of -nocolor
325737c0767SJohn Brooks	'nocolor'	=> \$color,	#keep old behaviors of -nocolor
3263e89ad85SJerome Forissier	'kconfig-prefix=s'	=> \${CONFIG_},
32777f5b10aSHannes Eder	'h|help'	=> \$help,
32877f5b10aSHannes Eder	'version'	=> \$help
3290ee3e7b8SPeter Ujfalusi) or $help = 2;
33077f5b10aSHannes Eder
3310ee3e7b8SPeter Ujfalusiif ($user_codespellfile) {
3320ee3e7b8SPeter Ujfalusi	# Use the user provided codespell file unconditionally
3330ee3e7b8SPeter Ujfalusi	$codespellfile = $user_codespellfile;
3340ee3e7b8SPeter Ujfalusi} elsif (!(-f $codespellfile)) {
3350ee3e7b8SPeter Ujfalusi	# If /usr/share/codespell/dictionary.txt is not present, try to find it
3360ee3e7b8SPeter Ujfalusi	# under codespell's install directory: <codespell_root>/data/dictionary.txt
3370ee3e7b8SPeter Ujfalusi	if (($codespell || $help) && which("codespell") ne "" && which("python") ne "") {
3380ee3e7b8SPeter Ujfalusi		my $python_codespell_dict = << "EOF";
3390ee3e7b8SPeter Ujfalusi
3400ee3e7b8SPeter Ujfalusiimport os.path as op
3410ee3e7b8SPeter Ujfalusiimport codespell_lib
3420ee3e7b8SPeter Ujfalusicodespell_dir = op.dirname(codespell_lib.__file__)
3430ee3e7b8SPeter Ujfalusicodespell_file = op.join(codespell_dir, 'data', 'dictionary.txt')
3440ee3e7b8SPeter Ujfalusiprint(codespell_file, end='')
3450ee3e7b8SPeter UjfalusiEOF
3460ee3e7b8SPeter Ujfalusi
3470ee3e7b8SPeter Ujfalusi		my $codespell_dict = `python -c "$python_codespell_dict" 2> /dev/null`;
3480ee3e7b8SPeter Ujfalusi		$codespellfile = $codespell_dict if (-f $codespell_dict);
3490ee3e7b8SPeter Ujfalusi	}
3500ee3e7b8SPeter Ujfalusi}
3510ee3e7b8SPeter Ujfalusi
3520ee3e7b8SPeter Ujfalusi# $help is 1 if either -h, --help or --version is passed as option - exitcode: 0
3530ee3e7b8SPeter Ujfalusi# $help is 2 if invalid option is passed - exitcode: 1
3540ee3e7b8SPeter Ujfalusihelp($help - 1) if ($help);
3550a920b5bSAndy Whitcroft
35652178ce0SDwaipayan Raydie "$P: --git cannot be used with --file or --fix\n" if ($git && ($file || $fix));
35752178ce0SDwaipayan Raydie "$P: --verbose cannot be used with --terse\n" if ($verbose && $terse);
35852178ce0SDwaipayan Ray
35952178ce0SDwaipayan Rayif ($color =~ /^[01]$/) {
36052178ce0SDwaipayan Ray	$color = !$color;
36152178ce0SDwaipayan Ray} elsif ($color =~ /^always$/i) {
36252178ce0SDwaipayan Ray	$color = 1;
36352178ce0SDwaipayan Ray} elsif ($color =~ /^never$/i) {
36452178ce0SDwaipayan Ray	$color = 0;
36552178ce0SDwaipayan Ray} elsif ($color =~ /^auto$/i) {
36652178ce0SDwaipayan Ray	$color = (-t STDOUT);
36752178ce0SDwaipayan Ray} else {
36852178ce0SDwaipayan Ray	die "$P: Invalid color mode: $color\n";
36952178ce0SDwaipayan Ray}
37052178ce0SDwaipayan Ray
37152178ce0SDwaipayan Rayload_docs() if ($verbose);
3723beb42ecSJoe Percheslist_types(0) if ($list_types);
3733beb42ecSJoe Perches
3749624b8d6SJoe Perches$fix = 1 if ($fix_inplace);
3752ac73b4fSJoe Perches$check_orig = $check;
3769624b8d6SJoe Perches
3770a920b5bSAndy Whitcroftmy $exit = 0;
3780a920b5bSAndy Whitcroft
3795b57980dSJoe Perchesmy $perl_version_ok = 1;
380d62a201fSDave Hansenif ($^V && $^V lt $minimum_perl_version) {
3815b57980dSJoe Perches	$perl_version_ok = 0;
382d62a201fSDave Hansen	printf "$P: requires at least perl version %vd\n", $minimum_perl_version;
3835b57980dSJoe Perches	exit(1) if (!$ignore_perl_version);
384d62a201fSDave Hansen}
385d62a201fSDave Hansen
38645107ff6SAllen Hubbe#if no filenames are given, push '-' to read patch from stdin
3870a920b5bSAndy Whitcroftif ($#ARGV < 0) {
38845107ff6SAllen Hubbe	push(@ARGV, '-');
3890a920b5bSAndy Whitcroft}
3900a920b5bSAndy Whitcroft
391713a09deSAntonio Borneo# skip TAB size 1 to avoid additional checks on $tabsize - 1
39232f30ca9SJoe Perchesdie "$P: Invalid TAB size: $tabsize\n" if ($tabsize < 2);
393713a09deSAntonio Borneo
39491bfe484SJoe Perchessub hash_save_array_words {
39591bfe484SJoe Perches	my ($hashRef, $arrayRef) = @_;
39691bfe484SJoe Perches
39791bfe484SJoe Perches	my @array = split(/,/, join(',', @$arrayRef));
39891bfe484SJoe Perches	foreach my $word (@array) {
399000d1cc1SJoe Perches		$word =~ s/\s*\n?$//g;
400000d1cc1SJoe Perches		$word =~ s/^\s*//g;
401000d1cc1SJoe Perches		$word =~ s/\s+/ /g;
402000d1cc1SJoe Perches		$word =~ tr/[a-z]/[A-Z]/;
403000d1cc1SJoe Perches
404000d1cc1SJoe Perches		next if ($word =~ m/^\s*#/);
405000d1cc1SJoe Perches		next if ($word =~ m/^\s*$/);
406000d1cc1SJoe Perches
40791bfe484SJoe Perches		$hashRef->{$word}++;
408000d1cc1SJoe Perches	}
40991bfe484SJoe Perches}
41091bfe484SJoe Perches
41191bfe484SJoe Perchessub hash_show_words {
41291bfe484SJoe Perches	my ($hashRef, $prefix) = @_;
41391bfe484SJoe Perches
4143c816e49SJoe Perches	if (keys %$hashRef) {
415d8469f16SJoe Perches		print "\nNOTE: $prefix message types:";
41658cb3cf6SJoe Perches		foreach my $word (sort keys %$hashRef) {
41791bfe484SJoe Perches			print " $word";
41891bfe484SJoe Perches		}
419d8469f16SJoe Perches		print "\n";
42091bfe484SJoe Perches	}
42191bfe484SJoe Perches}
42291bfe484SJoe Perches
42391bfe484SJoe Percheshash_save_array_words(\%ignore_type, \@ignore);
42491bfe484SJoe Percheshash_save_array_words(\%use_type, \@use);
425000d1cc1SJoe Perches
426c2fdda0dSAndy Whitcroftmy $dbg_values = 0;
427c2fdda0dSAndy Whitcroftmy $dbg_possible = 0;
4287429c690SAndy Whitcroftmy $dbg_type = 0;
429a1ef277eSAndy Whitcroftmy $dbg_attr = 0;
430c2fdda0dSAndy Whitcroftfor my $key (keys %debug) {
43121caa13cSAndy Whitcroft	## no critic
43221caa13cSAndy Whitcroft	eval "\${dbg_$key} = '$debug{$key}';";
43321caa13cSAndy Whitcroft	die "$@" if ($@);
434c2fdda0dSAndy Whitcroft}
435c2fdda0dSAndy Whitcroft
436d2c0a235SAndy Whitcroftmy $rpt_cleaners = 0;
437d2c0a235SAndy Whitcroft
4388905a67cSAndy Whitcroftif ($terse) {
4398905a67cSAndy Whitcroft	$emacs = 1;
4408905a67cSAndy Whitcroft	$quiet++;
4418905a67cSAndy Whitcroft}
4428905a67cSAndy Whitcroft
4436c72ffaaSAndy Whitcroftif ($tree) {
4446c72ffaaSAndy Whitcroft	if (defined $root) {
4456c72ffaaSAndy Whitcroft		if (!top_of_kernel_tree($root)) {
4466c72ffaaSAndy Whitcroft			die "$P: $root: --root does not point at a valid tree\n";
4476c72ffaaSAndy Whitcroft		}
4486c72ffaaSAndy Whitcroft	} else {
4496c72ffaaSAndy Whitcroft		if (top_of_kernel_tree('.')) {
4506c72ffaaSAndy Whitcroft			$root = '.';
4516c72ffaaSAndy Whitcroft		} elsif ($0 =~ m@(.*)/scripts/[^/]*$@ &&
4526c72ffaaSAndy Whitcroft						top_of_kernel_tree($1)) {
4536c72ffaaSAndy Whitcroft			$root = $1;
4546c72ffaaSAndy Whitcroft		}
4556c72ffaaSAndy Whitcroft	}
4566c72ffaaSAndy Whitcroft
4576c72ffaaSAndy Whitcroft	if (!defined $root) {
4580a920b5bSAndy Whitcroft		print "Must be run from the top-level dir. of a kernel tree\n";
4590a920b5bSAndy Whitcroft		exit(2);
4600a920b5bSAndy Whitcroft	}
4616c72ffaaSAndy Whitcroft}
4626c72ffaaSAndy Whitcroft
4636c72ffaaSAndy Whitcroftmy $emitted_corrupt = 0;
4646c72ffaaSAndy Whitcroft
4652ceb532bSAndy Whitcroftour $Ident	= qr{
4662ceb532bSAndy Whitcroft			[A-Za-z_][A-Za-z\d_]*
4672ceb532bSAndy Whitcroft			(?:\s*\#\#\s*[A-Za-z_][A-Za-z\d_]*)*
4682ceb532bSAndy Whitcroft		}x;
4696c72ffaaSAndy Whitcroftour $Storage	= qr{extern|static|asmlinkage};
4706c72ffaaSAndy Whitcroftour $Sparse	= qr{
4716c72ffaaSAndy Whitcroft			__user|
4726c72ffaaSAndy Whitcroft			__kernel|
4736c72ffaaSAndy Whitcroft			__force|
4746c72ffaaSAndy Whitcroft			__iomem|
4756c72ffaaSAndy Whitcroft			__must_check|
476417495edSAndy Whitcroft			__kprobes|
477165e72a6SSven Eckelmann			__ref|
47833aa4597SGeert Uytterhoeven			__refconst|
47933aa4597SGeert Uytterhoeven			__refdata|
480ad315455SBoqun Feng			__rcu|
481ad315455SBoqun Feng			__private
4826c72ffaaSAndy Whitcroft		}x;
483e970b884SJoe Perchesour $InitAttributePrefix = qr{__(?:mem|cpu|dev|net_|)};
484e970b884SJoe Perchesour $InitAttributeData = qr{$InitAttributePrefix(?:initdata\b)};
485e970b884SJoe Perchesour $InitAttributeConst = qr{$InitAttributePrefix(?:initconst\b)};
486e970b884SJoe Perchesour $InitAttributeInit = qr{$InitAttributePrefix(?:init\b)};
487e970b884SJoe Perchesour $InitAttribute = qr{$InitAttributeData|$InitAttributeConst|$InitAttributeInit};
4888716de38SJoe Perches
48952131292SWolfram Sang# Notes to $Attribute:
49052131292SWolfram Sang# We need \b after 'init' otherwise 'initconst' will cause a false positive in a check
4916c72ffaaSAndy Whitcroftour $Attribute	= qr{
4926c72ffaaSAndy Whitcroft			const|
493b5e8736aSJoe Perches			volatile|
49403f1df7dSJoe Perches			__percpu|
49503f1df7dSJoe Perches			__nocast|
49603f1df7dSJoe Perches			__safe|
49746d832f5SMichael S. Tsirkin			__bitwise|
49803f1df7dSJoe Perches			__packed__|
49903f1df7dSJoe Perches			__packed2__|
50003f1df7dSJoe Perches			__naked|
50103f1df7dSJoe Perches			__maybe_unused|
50203f1df7dSJoe Perches			__always_unused|
50303f1df7dSJoe Perches			__noreturn|
50403f1df7dSJoe Perches			__used|
50503f1df7dSJoe Perches			__cold|
506e23ef1f3SJoe Perches			__pure|
50703f1df7dSJoe Perches			__noclone|
50803f1df7dSJoe Perches			__deprecated|
5096c72ffaaSAndy Whitcroft			__read_mostly|
510c5967e98SJoe Perches			__ro_after_init|
5116c72ffaaSAndy Whitcroft			__kprobes|
5128716de38SJoe Perches			$InitAttribute|
51324e1d81aSAndy Whitcroft			____cacheline_aligned|
51424e1d81aSAndy Whitcroft			____cacheline_aligned_in_smp|
5155fe3af11SAndy Whitcroft			____cacheline_internodealigned_in_smp|
51686cffecdSKees Cook			__weak|
51786cffecdSKees Cook			__alloc_size\s*\(\s*\d+\s*(?:,\s*\d+\s*)?\)
5186c72ffaaSAndy Whitcroft		  }x;
519c45dcabdSAndy Whitcroftour $Modifier;
52091cb5195SJoe Perchesour $Inline	= qr{inline|__always_inline|noinline|__inline|__inline__};
5216c72ffaaSAndy Whitcroftour $Member	= qr{->$Ident|\.$Ident|\[[^]]*\]};
5226c72ffaaSAndy Whitcroftour $Lval	= qr{$Ident(?:$Member)*};
5236c72ffaaSAndy Whitcroft
52495e2c602SJoe Perchesour $Int_type	= qr{(?i)llu|ull|ll|lu|ul|l|u};
52595e2c602SJoe Perchesour $Binary	= qr{(?i)0b[01]+$Int_type?};
52695e2c602SJoe Perchesour $Hex	= qr{(?i)0x[0-9a-f]+$Int_type?};
52795e2c602SJoe Perchesour $Int	= qr{[0-9]+$Int_type?};
5282435880fSJoe Perchesour $Octal	= qr{0[0-7]+$Int_type?};
529d2af5aa6SJoe Perchesour $String	= qr{(?:\b[Lu])?"[X\t]*"};
530326b1ffcSJoe Perchesour $Float_hex	= qr{(?i)0x[0-9a-f]+p-?[0-9]+[fl]?};
531326b1ffcSJoe Perchesour $Float_dec	= qr{(?i)(?:[0-9]+\.[0-9]*|[0-9]*\.[0-9]+)(?:e-?[0-9]+)?[fl]?};
532326b1ffcSJoe Perchesour $Float_int	= qr{(?i)[0-9]+e-?[0-9]+[fl]?};
53374349bccSJoe Perchesour $Float	= qr{$Float_hex|$Float_dec|$Float_int};
5342435880fSJoe Perchesour $Constant	= qr{$Float|$Binary|$Octal|$Hex|$Int};
535326b1ffcSJoe Perchesour $Assignment	= qr{\*\=|/=|%=|\+=|-=|<<=|>>=|&=|\^=|\|=|=};
536447432f3SJoe Perchesour $Compare    = qr{<=|>=|==|!=|<|(?<!-)>};
53723f780c9SJoe Perchesour $Arithmetic = qr{\+|-|\*|\/|%};
5386c72ffaaSAndy Whitcroftour $Operators	= qr{
5396c72ffaaSAndy Whitcroft			<=|>=|==|!=|
5406c72ffaaSAndy Whitcroft			=>|->|<<|>>|<|>|!|~|
54123f780c9SJoe Perches			&&|\|\||,|\^|\+\+|--|&|\||$Arithmetic
5426c72ffaaSAndy Whitcroft		  }x;
5436c72ffaaSAndy Whitcroft
54491cb5195SJoe Perchesour $c90_Keywords = qr{do|for|while|if|else|return|goto|continue|switch|default|case|break}x;
54591cb5195SJoe Perches
546ab7e23f3SJoe Perchesour $BasicType;
5478905a67cSAndy Whitcroftour $NonptrType;
5481813087dSJoe Perchesour $NonptrTypeMisordered;
5498716de38SJoe Perchesour $NonptrTypeWithAttr;
5508905a67cSAndy Whitcroftour $Type;
5511813087dSJoe Perchesour $TypeMisordered;
5528905a67cSAndy Whitcroftour $Declare;
5531813087dSJoe Perchesour $DeclareMisordered;
5548905a67cSAndy Whitcroft
55515662b3eSJoe Perchesour $NON_ASCII_UTF8	= qr{
55615662b3eSJoe Perches	[\xC2-\xDF][\x80-\xBF]               # non-overlong 2-byte
557171ae1a4SAndy Whitcroft	|  \xE0[\xA0-\xBF][\x80-\xBF]        # excluding overlongs
558171ae1a4SAndy Whitcroft	| [\xE1-\xEC\xEE\xEF][\x80-\xBF]{2}  # straight 3-byte
559171ae1a4SAndy Whitcroft	|  \xED[\x80-\x9F][\x80-\xBF]        # excluding surrogates
560171ae1a4SAndy Whitcroft	|  \xF0[\x90-\xBF][\x80-\xBF]{2}     # planes 1-3
561171ae1a4SAndy Whitcroft	| [\xF1-\xF3][\x80-\xBF]{3}          # planes 4-15
562171ae1a4SAndy Whitcroft	|  \xF4[\x80-\x8F][\x80-\xBF]{2}     # plane 16
563171ae1a4SAndy Whitcroft}x;
564171ae1a4SAndy Whitcroft
56515662b3eSJoe Perchesour $UTF8	= qr{
56615662b3eSJoe Perches	[\x09\x0A\x0D\x20-\x7E]              # ASCII
56715662b3eSJoe Perches	| $NON_ASCII_UTF8
56815662b3eSJoe Perches}x;
56915662b3eSJoe Perches
570e6176fa4SJoe Perchesour $typeC99Typedefs = qr{(?:__)?(?:[us]_?)?int_?(?:8|16|32|64)_t};
571021158b4SJoe Perchesour $typeOtherOSTypedefs = qr{(?x:
572021158b4SJoe Perches	u_(?:char|short|int|long) |          # bsd
573021158b4SJoe Perches	u(?:nchar|short|int|long)            # sysv
574021158b4SJoe Perches)};
575e6176fa4SJoe Perchesour $typeKernelTypedefs = qr{(?x:
576fb9e9096SAndy Whitcroft	(?:__)?(?:u|s|be|le)(?:8|16|32|64)|
5778ed22cadSAndy Whitcroft	atomic_t
5788ed22cadSAndy Whitcroft)};
579e6176fa4SJoe Perchesour $typeTypedefs = qr{(?x:
580e6176fa4SJoe Perches	$typeC99Typedefs\b|
581e6176fa4SJoe Perches	$typeOtherOSTypedefs\b|
582e6176fa4SJoe Perches	$typeKernelTypedefs\b
583e6176fa4SJoe Perches)};
5848ed22cadSAndy Whitcroft
5856d32f7a3SJoe Perchesour $zero_initializer = qr{(?:(?:0[xX])?0+$Int_type?|NULL|false)\b};
5866d32f7a3SJoe Perches
587691e669bSJoe Perchesour $logFunctions = qr{(?x:
588758d7aadSMiles Chen	printk(?:_ratelimited|_once|_deferred_once|_deferred|)|
5897d0b6594SJacob Keller	(?:[a-z0-9]+_){1,2}(?:printk|emerg|alert|crit|err|warning|warn|notice|info|debug|dbg|vdbg|devel|cont|WARN)(?:_ratelimited|_once|)|
59087bd499aSJoe Perches	TP_printk|
5916e60c02eSJoe Perches	WARN(?:_RATELIMIT|_ONCE|)|
592b0531722SJoe Perches	panic|
59306668727SJoe Perches	MODULE_[A-Z_]+|
59406668727SJoe Perches	seq_vprintf|seq_printf|seq_puts
595691e669bSJoe Perches)};
596691e669bSJoe Perches
597e29a70f1SJoe Perchesour $allocFunctions = qr{(?x:
598e29a70f1SJoe Perches	(?:(?:devm_)?
59958f02267SJoe Perches		(?:kv|k|v)[czm]alloc(?:_array)?(?:_node)? |
600e29a70f1SJoe Perches		kstrdup(?:_const)? |
601e29a70f1SJoe Perches		kmemdup(?:_nul)?) |
602461e1565SChristophe JAILLET	(?:\w+)?alloc_skb(?:_ip_align)? |
603e29a70f1SJoe Perches				# dev_alloc_skb/netdev_alloc_skb, et al
604e29a70f1SJoe Perches	dma_alloc_coherent
605e29a70f1SJoe Perches)};
606e29a70f1SJoe Perches
60720112475SJoe Perchesour $signature_tags = qr{(?xi:
60820112475SJoe Perches	Signed-off-by:|
609d499480cSJorge Ramirez-Ortiz	Co-developed-by:|
61020112475SJoe Perches	Acked-by:|
61120112475SJoe Perches	Tested-by:|
61220112475SJoe Perches	Reviewed-by:|
61320112475SJoe Perches	Reported-by:|
6148543ae12SMugunthan V N	Suggested-by:|
61520112475SJoe Perches	To:|
61620112475SJoe Perches	Cc:
61720112475SJoe Perches)};
61820112475SJoe Perches
619adb2da82SJoe Perchesour $tracing_logging_tags = qr{(?xi:
620adb2da82SJoe Perches	[=-]*> |
621adb2da82SJoe Perches	<[=-]* |
622adb2da82SJoe Perches	\[ |
623adb2da82SJoe Perches	\] |
624adb2da82SJoe Perches	start |
625adb2da82SJoe Perches	called |
626adb2da82SJoe Perches	entered |
627adb2da82SJoe Perches	entry |
628adb2da82SJoe Perches	enter |
629adb2da82SJoe Perches	in |
630adb2da82SJoe Perches	inside |
631adb2da82SJoe Perches	here |
632adb2da82SJoe Perches	begin |
633adb2da82SJoe Perches	exit |
634adb2da82SJoe Perches	end |
635adb2da82SJoe Perches	done |
636adb2da82SJoe Perches	leave |
637adb2da82SJoe Perches	completed |
638adb2da82SJoe Perches	out |
639adb2da82SJoe Perches	return |
640adb2da82SJoe Perches	[\.\!:\s]*
641adb2da82SJoe Perches)};
642adb2da82SJoe Perches
643831242abSAditya Srivastavasub edit_distance_min {
644831242abSAditya Srivastava	my (@arr) = @_;
645831242abSAditya Srivastava	my $len = scalar @arr;
646831242abSAditya Srivastava	if ((scalar @arr) < 1) {
647831242abSAditya Srivastava		# if underflow, return
648831242abSAditya Srivastava		return;
649831242abSAditya Srivastava	}
650831242abSAditya Srivastava	my $min = $arr[0];
651831242abSAditya Srivastava	for my $i (0 .. ($len-1)) {
652831242abSAditya Srivastava		if ($arr[$i] < $min) {
653831242abSAditya Srivastava			$min = $arr[$i];
654831242abSAditya Srivastava		}
655831242abSAditya Srivastava	}
656831242abSAditya Srivastava	return $min;
657831242abSAditya Srivastava}
658831242abSAditya Srivastava
659831242abSAditya Srivastavasub get_edit_distance {
660831242abSAditya Srivastava	my ($str1, $str2) = @_;
661831242abSAditya Srivastava	$str1 = lc($str1);
662831242abSAditya Srivastava	$str2 = lc($str2);
663831242abSAditya Srivastava	$str1 =~ s/-//g;
664831242abSAditya Srivastava	$str2 =~ s/-//g;
665831242abSAditya Srivastava	my $len1 = length($str1);
666831242abSAditya Srivastava	my $len2 = length($str2);
667831242abSAditya Srivastava	# two dimensional array storing minimum edit distance
668831242abSAditya Srivastava	my @distance;
669831242abSAditya Srivastava	for my $i (0 .. $len1) {
670831242abSAditya Srivastava		for my $j (0 .. $len2) {
671831242abSAditya Srivastava			if ($i == 0) {
672831242abSAditya Srivastava				$distance[$i][$j] = $j;
673831242abSAditya Srivastava			} elsif ($j == 0) {
674831242abSAditya Srivastava				$distance[$i][$j] = $i;
675831242abSAditya Srivastava			} elsif (substr($str1, $i-1, 1) eq substr($str2, $j-1, 1)) {
676831242abSAditya Srivastava				$distance[$i][$j] = $distance[$i - 1][$j - 1];
677831242abSAditya Srivastava			} else {
678831242abSAditya Srivastava				my $dist1 = $distance[$i][$j - 1]; #insert distance
679831242abSAditya Srivastava				my $dist2 = $distance[$i - 1][$j]; # remove
680831242abSAditya Srivastava				my $dist3 = $distance[$i - 1][$j - 1]; #replace
681831242abSAditya Srivastava				$distance[$i][$j] = 1 + edit_distance_min($dist1, $dist2, $dist3);
682831242abSAditya Srivastava			}
683831242abSAditya Srivastava		}
684831242abSAditya Srivastava	}
685831242abSAditya Srivastava	return $distance[$len1][$len2];
686831242abSAditya Srivastava}
687831242abSAditya Srivastava
688831242abSAditya Srivastavasub find_standard_signature {
689831242abSAditya Srivastava	my ($sign_off) = @_;
690831242abSAditya Srivastava	my @standard_signature_tags = (
691831242abSAditya Srivastava		'Signed-off-by:', 'Co-developed-by:', 'Acked-by:', 'Tested-by:',
692831242abSAditya Srivastava		'Reviewed-by:', 'Reported-by:', 'Suggested-by:'
693831242abSAditya Srivastava	);
694831242abSAditya Srivastava	foreach my $signature (@standard_signature_tags) {
695831242abSAditya Srivastava		return $signature if (get_edit_distance($sign_off, $signature) <= 2);
696831242abSAditya Srivastava	}
697831242abSAditya Srivastava
698831242abSAditya Srivastava	return "";
699831242abSAditya Srivastava}
700831242abSAditya Srivastava
7011813087dSJoe Perchesour @typeListMisordered = (
7021813087dSJoe Perches	qr{char\s+(?:un)?signed},
7031813087dSJoe Perches	qr{int\s+(?:(?:un)?signed\s+)?short\s},
7041813087dSJoe Perches	qr{int\s+short(?:\s+(?:un)?signed)},
7051813087dSJoe Perches	qr{short\s+int(?:\s+(?:un)?signed)},
7061813087dSJoe Perches	qr{(?:un)?signed\s+int\s+short},
7071813087dSJoe Perches	qr{short\s+(?:un)?signed},
7081813087dSJoe Perches	qr{long\s+int\s+(?:un)?signed},
7091813087dSJoe Perches	qr{int\s+long\s+(?:un)?signed},
7101813087dSJoe Perches	qr{long\s+(?:un)?signed\s+int},
7111813087dSJoe Perches	qr{int\s+(?:un)?signed\s+long},
7121813087dSJoe Perches	qr{int\s+(?:un)?signed},
7131813087dSJoe Perches	qr{int\s+long\s+long\s+(?:un)?signed},
7141813087dSJoe Perches	qr{long\s+long\s+int\s+(?:un)?signed},
7151813087dSJoe Perches	qr{long\s+long\s+(?:un)?signed\s+int},
7161813087dSJoe Perches	qr{long\s+long\s+(?:un)?signed},
7171813087dSJoe Perches	qr{long\s+(?:un)?signed},
7181813087dSJoe Perches);
7191813087dSJoe Perches
7208905a67cSAndy Whitcroftour @typeList = (
7218905a67cSAndy Whitcroft	qr{void},
7220c773d9dSJoe Perches	qr{(?:(?:un)?signed\s+)?char},
7230c773d9dSJoe Perches	qr{(?:(?:un)?signed\s+)?short\s+int},
7240c773d9dSJoe Perches	qr{(?:(?:un)?signed\s+)?short},
7250c773d9dSJoe Perches	qr{(?:(?:un)?signed\s+)?int},
7260c773d9dSJoe Perches	qr{(?:(?:un)?signed\s+)?long\s+int},
7270c773d9dSJoe Perches	qr{(?:(?:un)?signed\s+)?long\s+long\s+int},
7280c773d9dSJoe Perches	qr{(?:(?:un)?signed\s+)?long\s+long},
7290c773d9dSJoe Perches	qr{(?:(?:un)?signed\s+)?long},
7300c773d9dSJoe Perches	qr{(?:un)?signed},
7318905a67cSAndy Whitcroft	qr{float},
7328905a67cSAndy Whitcroft	qr{double},
7338905a67cSAndy Whitcroft	qr{bool},
7348905a67cSAndy Whitcroft	qr{struct\s+$Ident},
7358905a67cSAndy Whitcroft	qr{union\s+$Ident},
7368905a67cSAndy Whitcroft	qr{enum\s+$Ident},
7378905a67cSAndy Whitcroft	qr{${Ident}_t},
7388905a67cSAndy Whitcroft	qr{${Ident}_handler},
7398905a67cSAndy Whitcroft	qr{${Ident}_handler_fn},
7401813087dSJoe Perches	@typeListMisordered,
7418905a67cSAndy Whitcroft);
742938224b5SJoe Perches
743938224b5SJoe Perchesour $C90_int_types = qr{(?x:
744938224b5SJoe Perches	long\s+long\s+int\s+(?:un)?signed|
745938224b5SJoe Perches	long\s+long\s+(?:un)?signed\s+int|
746938224b5SJoe Perches	long\s+long\s+(?:un)?signed|
747938224b5SJoe Perches	(?:(?:un)?signed\s+)?long\s+long\s+int|
748938224b5SJoe Perches	(?:(?:un)?signed\s+)?long\s+long|
749938224b5SJoe Perches	int\s+long\s+long\s+(?:un)?signed|
750938224b5SJoe Perches	int\s+(?:(?:un)?signed\s+)?long\s+long|
751938224b5SJoe Perches
752938224b5SJoe Perches	long\s+int\s+(?:un)?signed|
753938224b5SJoe Perches	long\s+(?:un)?signed\s+int|
754938224b5SJoe Perches	long\s+(?:un)?signed|
755938224b5SJoe Perches	(?:(?:un)?signed\s+)?long\s+int|
756938224b5SJoe Perches	(?:(?:un)?signed\s+)?long|
757938224b5SJoe Perches	int\s+long\s+(?:un)?signed|
758938224b5SJoe Perches	int\s+(?:(?:un)?signed\s+)?long|
759938224b5SJoe Perches
760938224b5SJoe Perches	int\s+(?:un)?signed|
761938224b5SJoe Perches	(?:(?:un)?signed\s+)?int
762938224b5SJoe Perches)};
763938224b5SJoe Perches
764485ff23eSAlex Dowadour @typeListFile = ();
7658716de38SJoe Perchesour @typeListWithAttr = (
7668716de38SJoe Perches	@typeList,
7678716de38SJoe Perches	qr{struct\s+$InitAttribute\s+$Ident},
7688716de38SJoe Perches	qr{union\s+$InitAttribute\s+$Ident},
7698716de38SJoe Perches);
7708716de38SJoe Perches
771c45dcabdSAndy Whitcroftour @modifierList = (
772c45dcabdSAndy Whitcroft	qr{fastcall},
773c45dcabdSAndy Whitcroft);
774485ff23eSAlex Dowadour @modifierListFile = ();
7758905a67cSAndy Whitcroft
7762435880fSJoe Perchesour @mode_permission_funcs = (
7772435880fSJoe Perches	["module_param", 3],
7782435880fSJoe Perches	["module_param_(?:array|named|string)", 4],
7792435880fSJoe Perches	["module_param_array_named", 5],
7802435880fSJoe Perches	["debugfs_create_(?:file|u8|u16|u32|u64|x8|x16|x32|x64|size_t|atomic_t|bool|blob|regset32|u32_array)", 2],
7812435880fSJoe Perches	["proc_create(?:_data|)", 2],
782459cf0aeSJoe Perches	["(?:CLASS|DEVICE|SENSOR|SENSOR_DEVICE|IIO_DEVICE)_ATTR", 2],
783459cf0aeSJoe Perches	["IIO_DEV_ATTR_[A-Z_]+", 1],
784459cf0aeSJoe Perches	["SENSOR_(?:DEVICE_|)ATTR_2", 2],
785459cf0aeSJoe Perches	["SENSOR_TEMPLATE(?:_2|)", 3],
786459cf0aeSJoe Perches	["__ATTR", 2],
7872435880fSJoe Perches);
7882435880fSJoe Perches
7891a3dcf2eSJoe Perchesmy $word_pattern = '\b[A-Z]?[a-z]{2,}\b';
7901a3dcf2eSJoe Perches
791515a235eSJoe Perches#Create a search pattern for all these functions to speed up a loop below
792515a235eSJoe Perchesour $mode_perms_search = "";
793515a235eSJoe Perchesforeach my $entry (@mode_permission_funcs) {
794515a235eSJoe Perches	$mode_perms_search .= '|' if ($mode_perms_search ne "");
795515a235eSJoe Perches	$mode_perms_search .= $entry->[0];
796515a235eSJoe Perches}
79700180468SJoe Perches$mode_perms_search = "(?:${mode_perms_search})";
798515a235eSJoe Perches
7999189c7e7SJoe Perchesour %deprecated_apis = (
8009189c7e7SJoe Perches	"synchronize_rcu_bh"			=> "synchronize_rcu",
8019189c7e7SJoe Perches	"synchronize_rcu_bh_expedited"		=> "synchronize_rcu_expedited",
8029189c7e7SJoe Perches	"call_rcu_bh"				=> "call_rcu",
8039189c7e7SJoe Perches	"rcu_barrier_bh"			=> "rcu_barrier",
8049189c7e7SJoe Perches	"synchronize_sched"			=> "synchronize_rcu",
8059189c7e7SJoe Perches	"synchronize_sched_expedited"		=> "synchronize_rcu_expedited",
8069189c7e7SJoe Perches	"call_rcu_sched"			=> "call_rcu",
8079189c7e7SJoe Perches	"rcu_barrier_sched"			=> "rcu_barrier",
8089189c7e7SJoe Perches	"get_state_synchronize_sched"		=> "get_state_synchronize_rcu",
8099189c7e7SJoe Perches	"cond_synchronize_sched"		=> "cond_synchronize_rcu",
8109189c7e7SJoe Perches);
8119189c7e7SJoe Perches
8129189c7e7SJoe Perches#Create a search pattern for all these strings to speed up a loop below
8139189c7e7SJoe Perchesour $deprecated_apis_search = "";
8149189c7e7SJoe Perchesforeach my $entry (keys %deprecated_apis) {
8159189c7e7SJoe Perches	$deprecated_apis_search .= '|' if ($deprecated_apis_search ne "");
8169189c7e7SJoe Perches	$deprecated_apis_search .= $entry;
8179189c7e7SJoe Perches}
8189189c7e7SJoe Perches$deprecated_apis_search = "(?:${deprecated_apis_search})";
8199189c7e7SJoe Perches
820b392c64fSJoe Perchesour $mode_perms_world_writable = qr{
821b392c64fSJoe Perches	S_IWUGO		|
822b392c64fSJoe Perches	S_IWOTH		|
823b392c64fSJoe Perches	S_IRWXUGO	|
824b392c64fSJoe Perches	S_IALLUGO	|
825b392c64fSJoe Perches	0[0-7][0-7][2367]
826b392c64fSJoe Perches}x;
827b392c64fSJoe Perches
828f90774e1SJoe Perchesour %mode_permission_string_types = (
829f90774e1SJoe Perches	"S_IRWXU" => 0700,
830f90774e1SJoe Perches	"S_IRUSR" => 0400,
831f90774e1SJoe Perches	"S_IWUSR" => 0200,
832f90774e1SJoe Perches	"S_IXUSR" => 0100,
833f90774e1SJoe Perches	"S_IRWXG" => 0070,
834f90774e1SJoe Perches	"S_IRGRP" => 0040,
835f90774e1SJoe Perches	"S_IWGRP" => 0020,
836f90774e1SJoe Perches	"S_IXGRP" => 0010,
837f90774e1SJoe Perches	"S_IRWXO" => 0007,
838f90774e1SJoe Perches	"S_IROTH" => 0004,
839f90774e1SJoe Perches	"S_IWOTH" => 0002,
840f90774e1SJoe Perches	"S_IXOTH" => 0001,
841f90774e1SJoe Perches	"S_IRWXUGO" => 0777,
842f90774e1SJoe Perches	"S_IRUGO" => 0444,
843f90774e1SJoe Perches	"S_IWUGO" => 0222,
844f90774e1SJoe Perches	"S_IXUGO" => 0111,
845f90774e1SJoe Perches);
846f90774e1SJoe Perches
847f90774e1SJoe Perches#Create a search pattern for all these strings to speed up a loop below
848f90774e1SJoe Perchesour $mode_perms_string_search = "";
849f90774e1SJoe Perchesforeach my $entry (keys %mode_permission_string_types) {
850f90774e1SJoe Perches	$mode_perms_string_search .= '|' if ($mode_perms_string_search ne "");
851f90774e1SJoe Perches	$mode_perms_string_search .= $entry;
852f90774e1SJoe Perches}
85300180468SJoe Perchesour $single_mode_perms_string_search = "(?:${mode_perms_string_search})";
85400180468SJoe Perchesour $multi_mode_perms_string_search = qr{
85500180468SJoe Perches	${single_mode_perms_string_search}
85600180468SJoe Perches	(?:\s*\|\s*${single_mode_perms_string_search})*
85700180468SJoe Perches}x;
85800180468SJoe Perches
85900180468SJoe Perchessub perms_to_octal {
86000180468SJoe Perches	my ($string) = @_;
86100180468SJoe Perches
86200180468SJoe Perches	return trim($string) if ($string =~ /^\s*0[0-7]{3,3}\s*$/);
86300180468SJoe Perches
86400180468SJoe Perches	my $val = "";
86500180468SJoe Perches	my $oval = "";
86600180468SJoe Perches	my $to = 0;
86700180468SJoe Perches	my $curpos = 0;
86800180468SJoe Perches	my $lastpos = 0;
86900180468SJoe Perches	while ($string =~ /\b(($single_mode_perms_string_search)\b(?:\s*\|\s*)?\s*)/g) {
87000180468SJoe Perches		$curpos = pos($string);
87100180468SJoe Perches		my $match = $2;
87200180468SJoe Perches		my $omatch = $1;
87300180468SJoe Perches		last if ($lastpos > 0 && ($curpos - length($omatch) != $lastpos));
87400180468SJoe Perches		$lastpos = $curpos;
87500180468SJoe Perches		$to |= $mode_permission_string_types{$match};
87600180468SJoe Perches		$val .= '\s*\|\s*' if ($val ne "");
87700180468SJoe Perches		$val .= $match;
87800180468SJoe Perches		$oval .= $omatch;
87900180468SJoe Perches	}
88000180468SJoe Perches	$oval =~ s/^\s*\|\s*//;
88100180468SJoe Perches	$oval =~ s/\s*\|\s*$//;
88200180468SJoe Perches	return sprintf("%04o", $to);
88300180468SJoe Perches}
884f90774e1SJoe Perches
8857840a94cSWolfram Sangour $allowed_asm_includes = qr{(?x:
8867840a94cSWolfram Sang	irq|
887cdcee686SSergey Ryazanov	memory|
888cdcee686SSergey Ryazanov	time|
889cdcee686SSergey Ryazanov	reboot
8907840a94cSWolfram Sang)};
8917840a94cSWolfram Sang# memory.h: ARM has a custom one
8927840a94cSWolfram Sang
89366b47b4aSKees Cook# Load common spelling mistakes and build regular expression list.
89466b47b4aSKees Cookmy $misspellings;
89566b47b4aSKees Cookmy %spelling_fix;
89636061e38SJoe Perches
89736061e38SJoe Perchesif (open(my $spelling, '<', $spelling_file)) {
89866b47b4aSKees Cook	while (<$spelling>) {
89966b47b4aSKees Cook		my $line = $_;
90066b47b4aSKees Cook
90166b47b4aSKees Cook		$line =~ s/\s*\n?$//g;
90266b47b4aSKees Cook		$line =~ s/^\s*//g;
90366b47b4aSKees Cook
90466b47b4aSKees Cook		next if ($line =~ m/^\s*#/);
90566b47b4aSKees Cook		next if ($line =~ m/^\s*$/);
90666b47b4aSKees Cook
90766b47b4aSKees Cook		my ($suspect, $fix) = split(/\|\|/, $line);
90866b47b4aSKees Cook
90966b47b4aSKees Cook		$spelling_fix{$suspect} = $fix;
91066b47b4aSKees Cook	}
91166b47b4aSKees Cook	close($spelling);
91236061e38SJoe Perches} else {
91336061e38SJoe Perches	warn "No typos will be found - file '$spelling_file': $!\n";
91436061e38SJoe Perches}
91566b47b4aSKees Cook
916ebfd7d62SJoe Perchesif ($codespell) {
917ebfd7d62SJoe Perches	if (open(my $spelling, '<', $codespellfile)) {
918ebfd7d62SJoe Perches		while (<$spelling>) {
919ebfd7d62SJoe Perches			my $line = $_;
920ebfd7d62SJoe Perches
921ebfd7d62SJoe Perches			$line =~ s/\s*\n?$//g;
922ebfd7d62SJoe Perches			$line =~ s/^\s*//g;
923ebfd7d62SJoe Perches
924ebfd7d62SJoe Perches			next if ($line =~ m/^\s*#/);
925ebfd7d62SJoe Perches			next if ($line =~ m/^\s*$/);
926ebfd7d62SJoe Perches			next if ($line =~ m/, disabled/i);
927ebfd7d62SJoe Perches
928ebfd7d62SJoe Perches			$line =~ s/,.*$//;
929ebfd7d62SJoe Perches
930ebfd7d62SJoe Perches			my ($suspect, $fix) = split(/->/, $line);
931ebfd7d62SJoe Perches
932ebfd7d62SJoe Perches			$spelling_fix{$suspect} = $fix;
933ebfd7d62SJoe Perches		}
934ebfd7d62SJoe Perches		close($spelling);
935ebfd7d62SJoe Perches	} else {
936ebfd7d62SJoe Perches		warn "No codespell typos will be found - file '$codespellfile': $!\n";
937ebfd7d62SJoe Perches	}
938ebfd7d62SJoe Perches}
939ebfd7d62SJoe Perches
940ebfd7d62SJoe Perches$misspellings = join("|", sort keys %spelling_fix) if keys %spelling_fix;
941ebfd7d62SJoe Perches
94275ad8c57SJerome Forissiersub read_words {
94375ad8c57SJerome Forissier	my ($wordsRef, $file) = @_;
94475ad8c57SJerome Forissier
94575ad8c57SJerome Forissier	if (open(my $words, '<', $file)) {
94675ad8c57SJerome Forissier		while (<$words>) {
947bf1fa1daSJoe Perches			my $line = $_;
948bf1fa1daSJoe Perches
949bf1fa1daSJoe Perches			$line =~ s/\s*\n?$//g;
950bf1fa1daSJoe Perches			$line =~ s/^\s*//g;
951bf1fa1daSJoe Perches
952bf1fa1daSJoe Perches			next if ($line =~ m/^\s*#/);
953bf1fa1daSJoe Perches			next if ($line =~ m/^\s*$/);
954bf1fa1daSJoe Perches			if ($line =~ /\s/) {
95575ad8c57SJerome Forissier				print("$file: '$line' invalid - ignored\n");
956bf1fa1daSJoe Perches				next;
957bf1fa1daSJoe Perches			}
958bf1fa1daSJoe Perches
959ced69da1SQuentin Monnet			$$wordsRef .= '|' if (defined $$wordsRef);
96075ad8c57SJerome Forissier			$$wordsRef .= $line;
961bf1fa1daSJoe Perches		}
96275ad8c57SJerome Forissier		close($file);
96375ad8c57SJerome Forissier		return 1;
964bf1fa1daSJoe Perches	}
965bf1fa1daSJoe Perches
96675ad8c57SJerome Forissier	return 0;
96775ad8c57SJerome Forissier}
96875ad8c57SJerome Forissier
969ced69da1SQuentin Monnetmy $const_structs;
970ced69da1SQuentin Monnetif (show_type("CONST_STRUCT")) {
97175ad8c57SJerome Forissier	read_words(\$const_structs, $conststructsfile)
97275ad8c57SJerome Forissier	    or warn "No structs that should be const will be found - file '$conststructsfile': $!\n";
973ced69da1SQuentin Monnet}
97475ad8c57SJerome Forissier
975ced69da1SQuentin Monnetif (defined($typedefsfile)) {
976ced69da1SQuentin Monnet	my $typeOtherTypedefs;
97775ad8c57SJerome Forissier	read_words(\$typeOtherTypedefs, $typedefsfile)
97875ad8c57SJerome Forissier	    or warn "No additional types will be considered - file '$typedefsfile': $!\n";
979ced69da1SQuentin Monnet	$typeTypedefs .= '|' . $typeOtherTypedefs if (defined $typeOtherTypedefs);
98075ad8c57SJerome Forissier}
98175ad8c57SJerome Forissier
9828905a67cSAndy Whitcroftsub build_types {
983485ff23eSAlex Dowad	my $mods = "(?x:  \n" . join("|\n  ", (@modifierList, @modifierListFile)) . "\n)";
984485ff23eSAlex Dowad	my $all = "(?x:  \n" . join("|\n  ", (@typeList, @typeListFile)) . "\n)";
9851813087dSJoe Perches	my $Misordered = "(?x:  \n" . join("|\n  ", @typeListMisordered) . "\n)";
9868716de38SJoe Perches	my $allWithAttr = "(?x:  \n" . join("|\n  ", @typeListWithAttr) . "\n)";
987c8cb2ca3SAndy Whitcroft	$Modifier	= qr{(?:$Attribute|$Sparse|$mods)};
988ab7e23f3SJoe Perches	$BasicType	= qr{
989ab7e23f3SJoe Perches				(?:$typeTypedefs\b)|
990ab7e23f3SJoe Perches				(?:${all}\b)
991ab7e23f3SJoe Perches		}x;
9928905a67cSAndy Whitcroft	$NonptrType	= qr{
993d2172eb5SAndy Whitcroft			(?:$Modifier\s+|const\s+)*
994cf655043SAndy Whitcroft			(?:
9956b48db24SAndy Whitcroft				(?:typeof|__typeof__)\s*\([^\)]*\)|
9968ed22cadSAndy Whitcroft				(?:$typeTypedefs\b)|
997c45dcabdSAndy Whitcroft				(?:${all}\b)
998cf655043SAndy Whitcroft			)
999c8cb2ca3SAndy Whitcroft			(?:\s+$Modifier|\s+const)*
10008905a67cSAndy Whitcroft		  }x;
10011813087dSJoe Perches	$NonptrTypeMisordered	= qr{
10021813087dSJoe Perches			(?:$Modifier\s+|const\s+)*
10031813087dSJoe Perches			(?:
10041813087dSJoe Perches				(?:${Misordered}\b)
10051813087dSJoe Perches			)
10061813087dSJoe Perches			(?:\s+$Modifier|\s+const)*
10071813087dSJoe Perches		  }x;
10088716de38SJoe Perches	$NonptrTypeWithAttr	= qr{
10098716de38SJoe Perches			(?:$Modifier\s+|const\s+)*
10108716de38SJoe Perches			(?:
10118716de38SJoe Perches				(?:typeof|__typeof__)\s*\([^\)]*\)|
10128716de38SJoe Perches				(?:$typeTypedefs\b)|
10138716de38SJoe Perches				(?:${allWithAttr}\b)
10148716de38SJoe Perches			)
10158716de38SJoe Perches			(?:\s+$Modifier|\s+const)*
10168716de38SJoe Perches		  }x;
10178905a67cSAndy Whitcroft	$Type	= qr{
1018c45dcabdSAndy Whitcroft			$NonptrType
10197b18496cSAntonio Borneo			(?:(?:\s|\*|\[\])+\s*const|(?:\s|\*\s*(?:const\s*)?|\[\])+|(?:\s*\[\s*\])+){0,4}
1020c8cb2ca3SAndy Whitcroft			(?:\s+$Inline|\s+$Modifier)*
10218905a67cSAndy Whitcroft		  }x;
10221813087dSJoe Perches	$TypeMisordered	= qr{
10231813087dSJoe Perches			$NonptrTypeMisordered
10247b18496cSAntonio Borneo			(?:(?:\s|\*|\[\])+\s*const|(?:\s|\*\s*(?:const\s*)?|\[\])+|(?:\s*\[\s*\])+){0,4}
10251813087dSJoe Perches			(?:\s+$Inline|\s+$Modifier)*
10261813087dSJoe Perches		  }x;
102791cb5195SJoe Perches	$Declare	= qr{(?:$Storage\s+(?:$Inline\s+)?)?$Type};
10281813087dSJoe Perches	$DeclareMisordered	= qr{(?:$Storage\s+(?:$Inline\s+)?)?$TypeMisordered};
10298905a67cSAndy Whitcroft}
10308905a67cSAndy Whitcroftbuild_types();
10316c72ffaaSAndy Whitcroft
10327d2367afSJoe Perchesour $Typecast	= qr{\s*(\(\s*$NonptrType\s*\)){0,1}\s*};
1033d1fe9c09SJoe Perches
1034d1fe9c09SJoe Perches# Using $balanced_parens, $LvalOrFunc, or $FuncArg
1035d1fe9c09SJoe Perches# requires at least perl version v5.10.0
1036d1fe9c09SJoe Perches# Any use must be runtime checked with $^V
1037d1fe9c09SJoe Perches
1038d1fe9c09SJoe Perchesour $balanced_parens = qr/(\((?:[^\(\)]++|(?-1))*\))/;
10392435880fSJoe Perchesour $LvalOrFunc	= qr{((?:[\&\*]\s*)?$Lval)\s*($balanced_parens{0,1})\s*};
1040c0a5c898SJoe Perchesour $FuncArg = qr{$Typecast{0,1}($LvalOrFunc|$Constant|$String)};
10417d2367afSJoe Perches
1042f8422308SJoe Perchesour $declaration_macros = qr{(?x:
10433e838b6cSJoe Perches	(?:$Storage\s+)?(?:[A-Z_][A-Z0-9]*_){0,2}(?:DEFINE|DECLARE)(?:_[A-Z0-9]+){1,6}\s*\(|
1044fe658f94SSteffen Maier	(?:$Storage\s+)?[HLP]?LIST_HEAD\s*\(|
10453d102fc0SGilad Ben-Yossef	(?:SKCIPHER_REQUEST|SHASH_DESC|AHASH_REQUEST)_ON_STACK\s*\(
1046f8422308SJoe Perches)};
1047f8422308SJoe Perches
10488d0325ccSAditya Srivastavaour %allow_repeated_words = (
10498d0325ccSAditya Srivastava	add => '',
10508d0325ccSAditya Srivastava	added => '',
10518d0325ccSAditya Srivastava	bad => '',
10528d0325ccSAditya Srivastava	be => '',
10538d0325ccSAditya Srivastava);
10548d0325ccSAditya Srivastava
10557d2367afSJoe Perchessub deparenthesize {
10567d2367afSJoe Perches	my ($string) = @_;
10577d2367afSJoe Perches	return "" if (!defined($string));
10585b9553abSJoe Perches
10595b9553abSJoe Perches	while ($string =~ /^\s*\(.*\)\s*$/) {
10605b9553abSJoe Perches		$string =~ s@^\s*\(\s*@@;
10615b9553abSJoe Perches		$string =~ s@\s*\)\s*$@@;
10625b9553abSJoe Perches	}
10635b9553abSJoe Perches
10647d2367afSJoe Perches	$string =~ s@\s+@ @g;
10655b9553abSJoe Perches
10667d2367afSJoe Perches	return $string;
10677d2367afSJoe Perches}
10687d2367afSJoe Perches
10693445686aSJoe Perchessub seed_camelcase_file {
10703445686aSJoe Perches	my ($file) = @_;
10713445686aSJoe Perches
10723445686aSJoe Perches	return if (!(-f $file));
10733445686aSJoe Perches
10743445686aSJoe Perches	local $/;
10753445686aSJoe Perches
10763445686aSJoe Perches	open(my $include_file, '<', "$file")
10773445686aSJoe Perches	    or warn "$P: Can't read '$file' $!\n";
10783445686aSJoe Perches	my $text = <$include_file>;
10793445686aSJoe Perches	close($include_file);
10803445686aSJoe Perches
10813445686aSJoe Perches	my @lines = split('\n', $text);
10823445686aSJoe Perches
10833445686aSJoe Perches	foreach my $line (@lines) {
10843445686aSJoe Perches		next if ($line !~ /(?:[A-Z][a-z]|[a-z][A-Z])/);
10853445686aSJoe Perches		if ($line =~ /^[ \t]*(?:#[ \t]*define|typedef\s+$Type)\s+(\w*(?:[A-Z][a-z]|[a-z][A-Z])\w*)/) {
10863445686aSJoe Perches			$camelcase{$1} = 1;
108711ea516aSJoe Perches		} elsif ($line =~ /^\s*$Declare\s+(\w*(?:[A-Z][a-z]|[a-z][A-Z])\w*)\s*[\(\[,;]/) {
108811ea516aSJoe Perches			$camelcase{$1} = 1;
108911ea516aSJoe Perches		} elsif ($line =~ /^\s*(?:union|struct|enum)\s+(\w*(?:[A-Z][a-z]|[a-z][A-Z])\w*)\s*[;\{]/) {
10903445686aSJoe Perches			$camelcase{$1} = 1;
10913445686aSJoe Perches		}
10923445686aSJoe Perches	}
10933445686aSJoe Perches}
10943445686aSJoe Perches
1095cd28b119SJoe Perchesour %maintained_status = ();
1096cd28b119SJoe Perches
109785b0ee18SJoe Perchessub is_maintained_obsolete {
109885b0ee18SJoe Perches	my ($filename) = @_;
109985b0ee18SJoe Perches
1100f2c19c2fSJerome Forissier	return 0 if (!$tree || !(-e "$root/scripts/get_maintainer.pl"));
110185b0ee18SJoe Perches
1102cd28b119SJoe Perches	if (!exists($maintained_status{$filename})) {
1103cd28b119SJoe Perches		$maintained_status{$filename} = `perl $root/scripts/get_maintainer.pl --status --nom --nol --nogit --nogit-fallback -f $filename 2>&1`;
1104cd28b119SJoe Perches	}
110585b0ee18SJoe Perches
1106cd28b119SJoe Perches	return $maintained_status{$filename} =~ /obsolete/i;
110785b0ee18SJoe Perches}
110885b0ee18SJoe Perches
11093b6e8ac9SJoe Perchessub is_SPDX_License_valid {
11103b6e8ac9SJoe Perches	my ($license) = @_;
11113b6e8ac9SJoe Perches
1112f9363b31SGuenter Roeck	return 1 if (!$tree || which("python3") eq "" || !(-x "$root/scripts/spdxcheck.py") || !(-e "$gitroot"));
11133b6e8ac9SJoe Perches
111456294112SJoe Perches	my $root_path = abs_path($root);
1115f9363b31SGuenter Roeck	my $status = `cd "$root_path"; echo "$license" | scripts/spdxcheck.py -`;
11163b6e8ac9SJoe Perches	return 0 if ($status ne "");
11173b6e8ac9SJoe Perches	return 1;
11183b6e8ac9SJoe Perches}
11193b6e8ac9SJoe Perches
11203445686aSJoe Perchesmy $camelcase_seeded = 0;
11213445686aSJoe Perchessub seed_camelcase_includes {
11223445686aSJoe Perches	return if ($camelcase_seeded);
11233445686aSJoe Perches
11243445686aSJoe Perches	my $files;
1125c707a81dSJoe Perches	my $camelcase_cache = "";
1126c707a81dSJoe Perches	my @include_files = ();
1127c707a81dSJoe Perches
1128c707a81dSJoe Perches	$camelcase_seeded = 1;
1129351b2a1fSJoe Perches
11300f7f635bSJoe Perches	if (-e "$gitroot") {
1131dbbf869dSJoe Perches		my $git_last_include_commit = `${git_command} log --no-merges --pretty=format:"%h%n" -1 -- include`;
1132351b2a1fSJoe Perches		chomp $git_last_include_commit;
1133c707a81dSJoe Perches		$camelcase_cache = ".checkpatch-camelcase.git.$git_last_include_commit";
1134c707a81dSJoe Perches	} else {
1135c707a81dSJoe Perches		my $last_mod_date = 0;
1136c707a81dSJoe Perches		$files = `find $root/include -name "*.h"`;
1137c707a81dSJoe Perches		@include_files = split('\n', $files);
1138c707a81dSJoe Perches		foreach my $file (@include_files) {
1139c707a81dSJoe Perches			my $date = POSIX::strftime("%Y%m%d%H%M",
1140c707a81dSJoe Perches						   localtime((stat $file)[9]));
1141c707a81dSJoe Perches			$last_mod_date = $date if ($last_mod_date < $date);
1142c707a81dSJoe Perches		}
1143c707a81dSJoe Perches		$camelcase_cache = ".checkpatch-camelcase.date.$last_mod_date";
1144c707a81dSJoe Perches	}
1145c707a81dSJoe Perches
1146c707a81dSJoe Perches	if ($camelcase_cache ne "" && -f $camelcase_cache) {
1147c707a81dSJoe Perches		open(my $camelcase_file, '<', "$camelcase_cache")
1148c707a81dSJoe Perches		    or warn "$P: Can't read '$camelcase_cache' $!\n";
1149351b2a1fSJoe Perches		while (<$camelcase_file>) {
1150351b2a1fSJoe Perches			chomp;
1151351b2a1fSJoe Perches			$camelcase{$_} = 1;
1152351b2a1fSJoe Perches		}
1153351b2a1fSJoe Perches		close($camelcase_file);
1154351b2a1fSJoe Perches
1155351b2a1fSJoe Perches		return;
1156351b2a1fSJoe Perches	}
1157c707a81dSJoe Perches
11580f7f635bSJoe Perches	if (-e "$gitroot") {
1159dbbf869dSJoe Perches		$files = `${git_command} ls-files "include/*.h"`;
1160c707a81dSJoe Perches		@include_files = split('\n', $files);
11613445686aSJoe Perches	}
1162c707a81dSJoe Perches
11633445686aSJoe Perches	foreach my $file (@include_files) {
11643445686aSJoe Perches		seed_camelcase_file($file);
11653445686aSJoe Perches	}
1166351b2a1fSJoe Perches
1167c707a81dSJoe Perches	if ($camelcase_cache ne "") {
1168351b2a1fSJoe Perches		unlink glob ".checkpatch-camelcase.*";
1169c707a81dSJoe Perches		open(my $camelcase_file, '>', "$camelcase_cache")
1170c707a81dSJoe Perches		    or warn "$P: Can't write '$camelcase_cache' $!\n";
1171351b2a1fSJoe Perches		foreach (sort { lc($a) cmp lc($b) } keys(%camelcase)) {
1172351b2a1fSJoe Perches			print $camelcase_file ("$_\n");
1173351b2a1fSJoe Perches		}
1174351b2a1fSJoe Perches		close($camelcase_file);
1175351b2a1fSJoe Perches	}
11763445686aSJoe Perches}
11773445686aSJoe Perches
1178f5f61325SJoe Perchessub git_is_single_file {
1179f5f61325SJoe Perches	my ($filename) = @_;
1180f5f61325SJoe Perches
1181f5f61325SJoe Perches	return 0 if ((which("git") eq "") || !(-e "$gitroot"));
1182f5f61325SJoe Perches
1183f5f61325SJoe Perches	my $output = `${git_command} ls-files -- $filename 2>/dev/null`;
1184f5f61325SJoe Perches	my $count = $output =~ tr/\n//;
1185f5f61325SJoe Perches	return $count eq 1 && $output =~ m{^${filename}$};
1186f5f61325SJoe Perches}
1187f5f61325SJoe Perches
1188d311cd44SJoe Perchessub git_commit_info {
1189d311cd44SJoe Perches	my ($commit, $id, $desc) = @_;
1190d311cd44SJoe Perches
11910f7f635bSJoe Perches	return ($id, $desc) if ((which("git") eq "") || !(-e "$gitroot"));
1192d311cd44SJoe Perches
1193dbbf869dSJoe Perches	my $output = `${git_command} log --no-color --format='%H %s' -1 $commit 2>&1`;
1194d311cd44SJoe Perches	$output =~ s/^\s*//gm;
1195d311cd44SJoe Perches	my @lines = split("\n", $output);
1196d311cd44SJoe Perches
11970d7835fcSJoe Perches	return ($id, $desc) if ($#lines < 0);
11980d7835fcSJoe Perches
11995a7f4455SSean Christopherson	if ($lines[0] =~ /^error: short SHA1 $commit is ambiguous/) {
1200d311cd44SJoe Perches# Maybe one day convert this block of bash into something that returns
1201d311cd44SJoe Perches# all matching commit ids, but it's very slow...
1202d311cd44SJoe Perches#
1203d311cd44SJoe Perches#		echo "checking commits $1..."
1204d311cd44SJoe Perches#		git rev-list --remotes | grep -i "^$1" |
1205d311cd44SJoe Perches#		while read line ; do
1206d311cd44SJoe Perches#		    git log --format='%H %s' -1 $line |
1207d311cd44SJoe Perches#		    echo "commit $(cut -c 1-12,41-)"
1208d311cd44SJoe Perches#		done
12094ce9f970SJoe Perches	} elsif ($lines[0] =~ /^fatal: ambiguous argument '$commit': unknown revision or path not in the working tree\./ ||
12104ce9f970SJoe Perches		 $lines[0] =~ /^fatal: bad object $commit/) {
1211948b133aSHeinrich Schuchardt		$id = undef;
1212d311cd44SJoe Perches	} else {
1213d311cd44SJoe Perches		$id = substr($lines[0], 0, 12);
1214d311cd44SJoe Perches		$desc = substr($lines[0], 41);
1215d311cd44SJoe Perches	}
1216d311cd44SJoe Perches
1217d311cd44SJoe Perches	return ($id, $desc);
1218d311cd44SJoe Perches}
1219d311cd44SJoe Perches
12206c72ffaaSAndy Whitcroft$chk_signoff = 0 if ($file);
12210a920b5bSAndy Whitcroft
122200df344fSAndy Whitcroftmy @rawlines = ();
1223c2fdda0dSAndy Whitcroftmy @lines = ();
12243705ce5bSJoe Perchesmy @fixed = ();
1225d752fcc8SJoe Perchesmy @fixed_inserted = ();
1226d752fcc8SJoe Perchesmy @fixed_deleted = ();
1227194f66fcSJoe Perchesmy $fixlinenr = -1;
1228194f66fcSJoe Perches
12294a593c34SDu, Changbin# If input is git commits, extract all commits from the commit expressions.
12304a593c34SDu, Changbin# For example, HEAD-3 means we need check 'HEAD, HEAD~1, HEAD~2'.
12310f7f635bSJoe Perchesdie "$P: No git repository found\n" if ($git && !-e "$gitroot");
12324a593c34SDu, Changbin
12334a593c34SDu, Changbinif ($git) {
12344a593c34SDu, Changbin	my @commits = ();
12350dea9f1eSJoe Perches	foreach my $commit_expr (@ARGV) {
12364a593c34SDu, Changbin		my $git_range;
123728898fd1SJoe Perches		if ($commit_expr =~ m/^(.*)-(\d+)$/) {
123828898fd1SJoe Perches			$git_range = "-$2 $1";
12394a593c34SDu, Changbin		} elsif ($commit_expr =~ m/\.\./) {
12404a593c34SDu, Changbin			$git_range = "$commit_expr";
12414a593c34SDu, Changbin		} else {
12420dea9f1eSJoe Perches			$git_range = "-1 $commit_expr";
12430dea9f1eSJoe Perches		}
1244dbbf869dSJoe Perches		my $lines = `${git_command} log --no-color --no-merges --pretty=format:'%H %s' $git_range`;
12450dea9f1eSJoe Perches		foreach my $line (split(/\n/, $lines)) {
124628898fd1SJoe Perches			$line =~ /^([0-9a-fA-F]{40,40}) (.*)$/;
124728898fd1SJoe Perches			next if (!defined($1) || !defined($2));
12480dea9f1eSJoe Perches			my $sha1 = $1;
12490dea9f1eSJoe Perches			my $subject = $2;
12500dea9f1eSJoe Perches			unshift(@commits, $sha1);
12510dea9f1eSJoe Perches			$git_commits{$sha1} = $subject;
12524a593c34SDu, Changbin		}
12534a593c34SDu, Changbin	}
12544a593c34SDu, Changbin	die "$P: no git commits after extraction!\n" if (@commits == 0);
12554a593c34SDu, Changbin	@ARGV = @commits;
12564a593c34SDu, Changbin}
12574a593c34SDu, Changbin
1258c2fdda0dSAndy Whitcroftmy $vname;
125998005e8cSVadim Bendebury$allow_c99_comments = !defined $ignore_type{"C99_COMMENT_TOLERANCE"};
12606c72ffaaSAndy Whitcroftfor my $filename (@ARGV) {
126121caa13cSAndy Whitcroft	my $FILE;
1262f5f61325SJoe Perches	my $is_git_file = git_is_single_file($filename);
1263f5f61325SJoe Perches	my $oldfile = $file;
1264f5f61325SJoe Perches	$file = 1 if ($is_git_file);
12654a593c34SDu, Changbin	if ($git) {
12664a593c34SDu, Changbin		open($FILE, '-|', "git format-patch -M --stdout -1 $filename") ||
12674a593c34SDu, Changbin			die "$P: $filename: git format-patch failed - $!\n";
12684a593c34SDu, Changbin	} elsif ($file) {
126921caa13cSAndy Whitcroft		open($FILE, '-|', "diff -u /dev/null $filename") ||
12706c72ffaaSAndy Whitcroft			die "$P: $filename: diff failed - $!\n";
127121caa13cSAndy Whitcroft	} elsif ($filename eq '-') {
127221caa13cSAndy Whitcroft		open($FILE, '<&STDIN');
12736c72ffaaSAndy Whitcroft	} else {
127421caa13cSAndy Whitcroft		open($FILE, '<', "$filename") ||
12756c72ffaaSAndy Whitcroft			die "$P: $filename: open failed - $!\n";
12766c72ffaaSAndy Whitcroft	}
1277c2fdda0dSAndy Whitcroft	if ($filename eq '-') {
1278c2fdda0dSAndy Whitcroft		$vname = 'Your patch';
12794a593c34SDu, Changbin	} elsif ($git) {
12800dea9f1eSJoe Perches		$vname = "Commit " . substr($filename, 0, 12) . ' ("' . $git_commits{$filename} . '")';
1281c2fdda0dSAndy Whitcroft	} else {
1282c2fdda0dSAndy Whitcroft		$vname = $filename;
1283c2fdda0dSAndy Whitcroft	}
128421caa13cSAndy Whitcroft	while (<$FILE>) {
12850a920b5bSAndy Whitcroft		chomp;
128600df344fSAndy Whitcroft		push(@rawlines, $_);
1287c7f574d0SGeert Uytterhoeven		$vname = qq("$1") if ($filename eq '-' && $_ =~ m/^Subject:\s+(.+)/i);
12886c72ffaaSAndy Whitcroft	}
128921caa13cSAndy Whitcroft	close($FILE);
1290d8469f16SJoe Perches
1291d8469f16SJoe Perches	if ($#ARGV > 0 && $quiet == 0) {
1292d8469f16SJoe Perches		print '-' x length($vname) . "\n";
1293d8469f16SJoe Perches		print "$vname\n";
1294d8469f16SJoe Perches		print '-' x length($vname) . "\n";
1295d8469f16SJoe Perches	}
1296d8469f16SJoe Perches
1297c2fdda0dSAndy Whitcroft	if (!process($filename)) {
12980a920b5bSAndy Whitcroft		$exit = 1;
12990a920b5bSAndy Whitcroft	}
130000df344fSAndy Whitcroft	@rawlines = ();
130113214adfSAndy Whitcroft	@lines = ();
13023705ce5bSJoe Perches	@fixed = ();
1303d752fcc8SJoe Perches	@fixed_inserted = ();
1304d752fcc8SJoe Perches	@fixed_deleted = ();
1305194f66fcSJoe Perches	$fixlinenr = -1;
1306485ff23eSAlex Dowad	@modifierListFile = ();
1307485ff23eSAlex Dowad	@typeListFile = ();
1308485ff23eSAlex Dowad	build_types();
1309f5f61325SJoe Perches	$file = $oldfile if ($is_git_file);
13100a920b5bSAndy Whitcroft}
13110a920b5bSAndy Whitcroft
1312d8469f16SJoe Perchesif (!$quiet) {
13133c816e49SJoe Perches	hash_show_words(\%use_type, "Used");
13143c816e49SJoe Perches	hash_show_words(\%ignore_type, "Ignored");
13153c816e49SJoe Perches
13165b57980dSJoe Perches	if (!$perl_version_ok) {
1317d8469f16SJoe Perches		print << "EOM"
1318d8469f16SJoe Perches
1319d8469f16SJoe PerchesNOTE: perl $^V is not modern enough to detect all possible issues.
13205b57980dSJoe Perches      An upgrade to at least perl $minimum_perl_version is suggested.
1321d8469f16SJoe PerchesEOM
1322d8469f16SJoe Perches	}
1323d8469f16SJoe Perches	if ($exit) {
1324d8469f16SJoe Perches		print << "EOM"
1325d8469f16SJoe Perches
1326d8469f16SJoe PerchesNOTE: If any of the errors are false positives, please report
1327d8469f16SJoe Perches      them to the maintainer, see CHECKPATCH in MAINTAINERS.
1328d8469f16SJoe PerchesEOM
1329d8469f16SJoe Perches	}
1330d8469f16SJoe Perches}
1331d8469f16SJoe Perches
13320a920b5bSAndy Whitcroftexit($exit);
13330a920b5bSAndy Whitcroft
13340a920b5bSAndy Whitcroftsub top_of_kernel_tree {
13356c72ffaaSAndy Whitcroft	my ($root) = @_;
13366c72ffaaSAndy Whitcroft
13376c72ffaaSAndy Whitcroft	my @tree_check = (
13386c72ffaaSAndy Whitcroft		"COPYING", "CREDITS", "Kbuild", "MAINTAINERS", "Makefile",
13396c72ffaaSAndy Whitcroft		"README", "Documentation", "arch", "include", "drivers",
13406c72ffaaSAndy Whitcroft		"fs", "init", "ipc", "kernel", "lib", "scripts",
13416c72ffaaSAndy Whitcroft	);
13426c72ffaaSAndy Whitcroft
13436c72ffaaSAndy Whitcroft	foreach my $check (@tree_check) {
13446c72ffaaSAndy Whitcroft		if (! -e $root . '/' . $check) {
13450a920b5bSAndy Whitcroft			return 0;
13460a920b5bSAndy Whitcroft		}
13476c72ffaaSAndy Whitcroft	}
13486c72ffaaSAndy Whitcroft	return 1;
13496c72ffaaSAndy Whitcroft}
13500a920b5bSAndy Whitcroft
135120112475SJoe Perchessub parse_email {
135220112475SJoe Perches	my ($formatted_email) = @_;
135320112475SJoe Perches
135420112475SJoe Perches	my $name = "";
1355fccaebf0SDwaipayan Ray	my $quoted = "";
1356dfa05c28SJoe Perches	my $name_comment = "";
135720112475SJoe Perches	my $address = "";
135820112475SJoe Perches	my $comment = "";
135920112475SJoe Perches
136020112475SJoe Perches	if ($formatted_email =~ /^(.*)<(\S+\@\S+)>(.*)$/) {
136120112475SJoe Perches		$name = $1;
136220112475SJoe Perches		$address = $2;
136320112475SJoe Perches		$comment = $3 if defined $3;
136420112475SJoe Perches	} elsif ($formatted_email =~ /^\s*<(\S+\@\S+)>(.*)$/) {
136520112475SJoe Perches		$address = $1;
136620112475SJoe Perches		$comment = $2 if defined $2;
136720112475SJoe Perches	} elsif ($formatted_email =~ /(\S+\@\S+)(.*)$/) {
136820112475SJoe Perches		$address = $1;
136920112475SJoe Perches		$comment = $2 if defined $2;
137085e12066SJoe Perches		$formatted_email =~ s/\Q$address\E.*$//;
137120112475SJoe Perches		$name = $formatted_email;
13723705ce5bSJoe Perches		$name = trim($name);
137320112475SJoe Perches		$name =~ s/^\"|\"$//g;
137420112475SJoe Perches		# If there's a name left after stripping spaces and
137520112475SJoe Perches		# leading quotes, and the address doesn't have both
137620112475SJoe Perches		# leading and trailing angle brackets, the address
137720112475SJoe Perches		# is invalid. ie:
137820112475SJoe Perches		#   "joe smith [email protected]" bad
137920112475SJoe Perches		#   "joe smith <[email protected]" bad
138020112475SJoe Perches		if ($name ne "" && $address !~ /^<[^>]+>$/) {
138120112475SJoe Perches			$name = "";
138220112475SJoe Perches			$address = "";
138320112475SJoe Perches			$comment = "";
138420112475SJoe Perches		}
138520112475SJoe Perches	}
138620112475SJoe Perches
1387fccaebf0SDwaipayan Ray	# Extract comments from names excluding quoted parts
1388fccaebf0SDwaipayan Ray	# "John D. (Doe)" - Do not extract
1389fccaebf0SDwaipayan Ray	if ($name =~ s/\"(.+)\"//) {
1390fccaebf0SDwaipayan Ray		$quoted = $1;
1391dfa05c28SJoe Perches	}
1392fccaebf0SDwaipayan Ray	while ($name =~ s/\s*($balanced_parens)\s*/ /) {
1393fccaebf0SDwaipayan Ray		$name_comment .= trim($1);
1394fccaebf0SDwaipayan Ray	}
1395fccaebf0SDwaipayan Ray	$name =~ s/^[ \"]+|[ \"]+$//g;
1396fccaebf0SDwaipayan Ray	$name = trim("$quoted $name");
1397fccaebf0SDwaipayan Ray
13983705ce5bSJoe Perches	$address = trim($address);
139920112475SJoe Perches	$address =~ s/^\<|\>$//g;
1400fccaebf0SDwaipayan Ray	$comment = trim($comment);
140120112475SJoe Perches
140220112475SJoe Perches	if ($name =~ /[^\w \-]/i) { ##has "must quote" chars
140320112475SJoe Perches		$name =~ s/(?<!\\)"/\\"/g; ##escape quotes
140420112475SJoe Perches		$name = "\"$name\"";
140520112475SJoe Perches	}
140620112475SJoe Perches
1407dfa05c28SJoe Perches	return ($name, $name_comment, $address, $comment);
140820112475SJoe Perches}
140920112475SJoe Perches
141020112475SJoe Perchessub format_email {
141148ca2d8aSDwaipayan Ray	my ($name, $name_comment, $address, $comment) = @_;
141220112475SJoe Perches
141320112475SJoe Perches	my $formatted_email;
141420112475SJoe Perches
1415fccaebf0SDwaipayan Ray	$name =~ s/^[ \"]+|[ \"]+$//g;
14163705ce5bSJoe Perches	$address = trim($address);
1417fccaebf0SDwaipayan Ray	$address =~ s/(?:\.|\,|\")+$//; ##trailing commas, dots or quotes
141820112475SJoe Perches
141920112475SJoe Perches	if ($name =~ /[^\w \-]/i) { ##has "must quote" chars
142020112475SJoe Perches		$name =~ s/(?<!\\)"/\\"/g; ##escape quotes
142120112475SJoe Perches		$name = "\"$name\"";
142220112475SJoe Perches	}
142320112475SJoe Perches
1424fccaebf0SDwaipayan Ray	$name_comment = trim($name_comment);
1425fccaebf0SDwaipayan Ray	$name_comment = " $name_comment" if ($name_comment ne "");
1426fccaebf0SDwaipayan Ray	$comment = trim($comment);
1427fccaebf0SDwaipayan Ray	$comment = " $comment" if ($comment ne "");
1428fccaebf0SDwaipayan Ray
142920112475SJoe Perches	if ("$name" eq "") {
143020112475SJoe Perches		$formatted_email = "$address";
143120112475SJoe Perches	} else {
143248ca2d8aSDwaipayan Ray		$formatted_email = "$name$name_comment <$address>";
143320112475SJoe Perches	}
143448ca2d8aSDwaipayan Ray	$formatted_email .= "$comment";
143520112475SJoe Perches	return $formatted_email;
143620112475SJoe Perches}
143720112475SJoe Perches
1438dfa05c28SJoe Perchessub reformat_email {
1439dfa05c28SJoe Perches	my ($email) = @_;
1440dfa05c28SJoe Perches
1441dfa05c28SJoe Perches	my ($email_name, $name_comment, $email_address, $comment) = parse_email($email);
144248ca2d8aSDwaipayan Ray	return format_email($email_name, $name_comment, $email_address, $comment);
1443dfa05c28SJoe Perches}
1444dfa05c28SJoe Perches
1445dfa05c28SJoe Perchessub same_email_addresses {
1446fccaebf0SDwaipayan Ray	my ($email1, $email2) = @_;
1447dfa05c28SJoe Perches
1448dfa05c28SJoe Perches	my ($email1_name, $name1_comment, $email1_address, $comment1) = parse_email($email1);
1449dfa05c28SJoe Perches	my ($email2_name, $name2_comment, $email2_address, $comment2) = parse_email($email2);
1450dfa05c28SJoe Perches
145148ca2d8aSDwaipayan Ray	return $email1_name eq $email2_name &&
145248ca2d8aSDwaipayan Ray	       $email1_address eq $email2_address &&
145348ca2d8aSDwaipayan Ray	       $name1_comment eq $name2_comment &&
145448ca2d8aSDwaipayan Ray	       $comment1 eq $comment2;
145548ca2d8aSDwaipayan Ray}
1456dfa05c28SJoe Perches
1457d311cd44SJoe Perchessub which {
1458d311cd44SJoe Perches	my ($bin) = @_;
1459d311cd44SJoe Perches
1460d311cd44SJoe Perches	foreach my $path (split(/:/, $ENV{PATH})) {
1461d311cd44SJoe Perches		if (-e "$path/$bin") {
1462d311cd44SJoe Perches			return "$path/$bin";
1463d311cd44SJoe Perches		}
1464d311cd44SJoe Perches	}
1465d311cd44SJoe Perches
1466d311cd44SJoe Perches	return "";
1467d311cd44SJoe Perches}
1468d311cd44SJoe Perches
1469000d1cc1SJoe Perchessub which_conf {
1470000d1cc1SJoe Perches	my ($conf) = @_;
1471000d1cc1SJoe Perches
1472000d1cc1SJoe Perches	foreach my $path (split(/:/, ".:$ENV{HOME}:.scripts")) {
1473000d1cc1SJoe Perches		if (-e "$path/$conf") {
1474000d1cc1SJoe Perches			return "$path/$conf";
1475000d1cc1SJoe Perches		}
1476000d1cc1SJoe Perches	}
1477000d1cc1SJoe Perches
1478000d1cc1SJoe Perches	return "";
1479000d1cc1SJoe Perches}
1480000d1cc1SJoe Perches
14810a920b5bSAndy Whitcroftsub expand_tabs {
14820a920b5bSAndy Whitcroft	my ($str) = @_;
14830a920b5bSAndy Whitcroft
14840a920b5bSAndy Whitcroft	my $res = '';
14850a920b5bSAndy Whitcroft	my $n = 0;
14860a920b5bSAndy Whitcroft	for my $c (split(//, $str)) {
14870a920b5bSAndy Whitcroft		if ($c eq "\t") {
14880a920b5bSAndy Whitcroft			$res .= ' ';
14890a920b5bSAndy Whitcroft			$n++;
1490713a09deSAntonio Borneo			for (; ($n % $tabsize) != 0; $n++) {
14910a920b5bSAndy Whitcroft				$res .= ' ';
14920a920b5bSAndy Whitcroft			}
14930a920b5bSAndy Whitcroft			next;
14940a920b5bSAndy Whitcroft		}
14950a920b5bSAndy Whitcroft		$res .= $c;
14960a920b5bSAndy Whitcroft		$n++;
14970a920b5bSAndy Whitcroft	}
14980a920b5bSAndy Whitcroft
14990a920b5bSAndy Whitcroft	return $res;
15000a920b5bSAndy Whitcroft}
15016c72ffaaSAndy Whitcroftsub copy_spacing {
1502773647a0SAndy Whitcroft	(my $res = shift) =~ tr/\t/ /c;
15036c72ffaaSAndy Whitcroft	return $res;
15046c72ffaaSAndy Whitcroft}
15050a920b5bSAndy Whitcroft
15064a0df2efSAndy Whitcroftsub line_stats {
15074a0df2efSAndy Whitcroft	my ($line) = @_;
15084a0df2efSAndy Whitcroft
15094a0df2efSAndy Whitcroft	# Drop the diff line leader and expand tabs
15104a0df2efSAndy Whitcroft	$line =~ s/^.//;
15114a0df2efSAndy Whitcroft	$line = expand_tabs($line);
15124a0df2efSAndy Whitcroft
15134a0df2efSAndy Whitcroft	# Pick the indent from the front of the line.
15144a0df2efSAndy Whitcroft	my ($white) = ($line =~ /^(\s*)/);
15154a0df2efSAndy Whitcroft
15164a0df2efSAndy Whitcroft	return (length($line), length($white));
15174a0df2efSAndy Whitcroft}
15184a0df2efSAndy Whitcroft
1519773647a0SAndy Whitcroftmy $sanitise_quote = '';
1520773647a0SAndy Whitcroft
1521773647a0SAndy Whitcroftsub sanitise_line_reset {
1522773647a0SAndy Whitcroft	my ($in_comment) = @_;
1523773647a0SAndy Whitcroft
1524773647a0SAndy Whitcroft	if ($in_comment) {
1525773647a0SAndy Whitcroft		$sanitise_quote = '*/';
1526773647a0SAndy Whitcroft	} else {
1527773647a0SAndy Whitcroft		$sanitise_quote = '';
1528773647a0SAndy Whitcroft	}
1529773647a0SAndy Whitcroft}
153000df344fSAndy Whitcroftsub sanitise_line {
153100df344fSAndy Whitcroft	my ($line) = @_;
153200df344fSAndy Whitcroft
153300df344fSAndy Whitcroft	my $res = '';
153400df344fSAndy Whitcroft	my $l = '';
153500df344fSAndy Whitcroft
1536c2fdda0dSAndy Whitcroft	my $qlen = 0;
1537773647a0SAndy Whitcroft	my $off = 0;
1538773647a0SAndy Whitcroft	my $c;
153900df344fSAndy Whitcroft
1540773647a0SAndy Whitcroft	# Always copy over the diff marker.
1541773647a0SAndy Whitcroft	$res = substr($line, 0, 1);
1542773647a0SAndy Whitcroft
1543773647a0SAndy Whitcroft	for ($off = 1; $off < length($line); $off++) {
1544773647a0SAndy Whitcroft		$c = substr($line, $off, 1);
1545773647a0SAndy Whitcroft
15468d2e11b2SClaudio Fontana		# Comments we are whacking completely including the begin
1547773647a0SAndy Whitcroft		# and end, all to $;.
1548773647a0SAndy Whitcroft		if ($sanitise_quote eq '' && substr($line, $off, 2) eq '/*') {
1549773647a0SAndy Whitcroft			$sanitise_quote = '*/';
1550773647a0SAndy Whitcroft
1551773647a0SAndy Whitcroft			substr($res, $off, 2, "$;$;");
1552773647a0SAndy Whitcroft			$off++;
155300df344fSAndy Whitcroft			next;
1554773647a0SAndy Whitcroft		}
155581bc0e02SAndy Whitcroft		if ($sanitise_quote eq '*/' && substr($line, $off, 2) eq '*/') {
1556773647a0SAndy Whitcroft			$sanitise_quote = '';
1557773647a0SAndy Whitcroft			substr($res, $off, 2, "$;$;");
1558773647a0SAndy Whitcroft			$off++;
1559773647a0SAndy Whitcroft			next;
1560773647a0SAndy Whitcroft		}
1561113f04a8SDaniel Walker		if ($sanitise_quote eq '' && substr($line, $off, 2) eq '//') {
1562113f04a8SDaniel Walker			$sanitise_quote = '//';
1563113f04a8SDaniel Walker
1564113f04a8SDaniel Walker			substr($res, $off, 2, $sanitise_quote);
1565113f04a8SDaniel Walker			$off++;
1566113f04a8SDaniel Walker			next;
1567113f04a8SDaniel Walker		}
1568773647a0SAndy Whitcroft
1569773647a0SAndy Whitcroft		# A \ in a string means ignore the next character.
1570773647a0SAndy Whitcroft		if (($sanitise_quote eq "'" || $sanitise_quote eq '"') &&
1571773647a0SAndy Whitcroft		    $c eq "\\") {
1572773647a0SAndy Whitcroft			substr($res, $off, 2, 'XX');
1573773647a0SAndy Whitcroft			$off++;
1574773647a0SAndy Whitcroft			next;
1575773647a0SAndy Whitcroft		}
1576773647a0SAndy Whitcroft		# Regular quotes.
1577773647a0SAndy Whitcroft		if ($c eq "'" || $c eq '"') {
1578773647a0SAndy Whitcroft			if ($sanitise_quote eq '') {
1579773647a0SAndy Whitcroft				$sanitise_quote = $c;
1580773647a0SAndy Whitcroft
1581773647a0SAndy Whitcroft				substr($res, $off, 1, $c);
1582773647a0SAndy Whitcroft				next;
1583773647a0SAndy Whitcroft			} elsif ($sanitise_quote eq $c) {
1584773647a0SAndy Whitcroft				$sanitise_quote = '';
158500df344fSAndy Whitcroft			}
158600df344fSAndy Whitcroft		}
1587773647a0SAndy Whitcroft
1588fae17daeSAndy Whitcroft		#print "c<$c> SQ<$sanitise_quote>\n";
1589773647a0SAndy Whitcroft		if ($off != 0 && $sanitise_quote eq '*/' && $c ne "\t") {
1590773647a0SAndy Whitcroft			substr($res, $off, 1, $;);
1591113f04a8SDaniel Walker		} elsif ($off != 0 && $sanitise_quote eq '//' && $c ne "\t") {
1592113f04a8SDaniel Walker			substr($res, $off, 1, $;);
1593773647a0SAndy Whitcroft		} elsif ($off != 0 && $sanitise_quote && $c ne "\t") {
1594773647a0SAndy Whitcroft			substr($res, $off, 1, 'X');
159500df344fSAndy Whitcroft		} else {
1596773647a0SAndy Whitcroft			substr($res, $off, 1, $c);
159700df344fSAndy Whitcroft		}
1598c2fdda0dSAndy Whitcroft	}
1599c2fdda0dSAndy Whitcroft
1600113f04a8SDaniel Walker	if ($sanitise_quote eq '//') {
1601113f04a8SDaniel Walker		$sanitise_quote = '';
1602113f04a8SDaniel Walker	}
1603113f04a8SDaniel Walker
1604c2fdda0dSAndy Whitcroft	# The pathname on a #include may be surrounded by '<' and '>'.
1605c45dcabdSAndy Whitcroft	if ($res =~ /^.\s*\#\s*include\s+\<(.*)\>/) {
1606c2fdda0dSAndy Whitcroft		my $clean = 'X' x length($1);
1607c2fdda0dSAndy Whitcroft		$res =~ s@\<.*\>@<$clean>@;
1608c2fdda0dSAndy Whitcroft
1609c2fdda0dSAndy Whitcroft	# The whole of a #error is a string.
1610c45dcabdSAndy Whitcroft	} elsif ($res =~ /^.\s*\#\s*(?:error|warning)\s+(.*)\b/) {
1611c2fdda0dSAndy Whitcroft		my $clean = 'X' x length($1);
1612c45dcabdSAndy Whitcroft		$res =~ s@(\#\s*(?:error|warning)\s+).*@$1$clean@;
1613c2fdda0dSAndy Whitcroft	}
1614c2fdda0dSAndy Whitcroft
1615dadf680dSJoe Perches	if ($allow_c99_comments && $res =~ m@(//.*$)@) {
1616dadf680dSJoe Perches		my $match = $1;
1617dadf680dSJoe Perches		$res =~ s/\Q$match\E/"$;" x length($match)/e;
1618dadf680dSJoe Perches	}
1619dadf680dSJoe Perches
162000df344fSAndy Whitcroft	return $res;
162100df344fSAndy Whitcroft}
162200df344fSAndy Whitcroft
1623a6962d72SJoe Perchessub get_quoted_string {
1624a6962d72SJoe Perches	my ($line, $rawline) = @_;
1625a6962d72SJoe Perches
1626478b1799SJoe Perches	return "" if (!defined($line) || !defined($rawline));
162733acb54aSJoe Perches	return "" if ($line !~ m/($String)/g);
1628a6962d72SJoe Perches	return substr($rawline, $-[0], $+[0] - $-[0]);
1629a6962d72SJoe Perches}
1630a6962d72SJoe Perches
16318905a67cSAndy Whitcroftsub ctx_statement_block {
16328905a67cSAndy Whitcroft	my ($linenr, $remain, $off) = @_;
16338905a67cSAndy Whitcroft	my $line = $linenr - 1;
16348905a67cSAndy Whitcroft	my $blk = '';
16358905a67cSAndy Whitcroft	my $soff = $off;
16368905a67cSAndy Whitcroft	my $coff = $off - 1;
1637773647a0SAndy Whitcroft	my $coff_set = 0;
16388905a67cSAndy Whitcroft
163913214adfSAndy Whitcroft	my $loff = 0;
164013214adfSAndy Whitcroft
16418905a67cSAndy Whitcroft	my $type = '';
16428905a67cSAndy Whitcroft	my $level = 0;
1643a2750645SAndy Whitcroft	my @stack = ();
1644cf655043SAndy Whitcroft	my $p;
16458905a67cSAndy Whitcroft	my $c;
16468905a67cSAndy Whitcroft	my $len = 0;
164713214adfSAndy Whitcroft
164813214adfSAndy Whitcroft	my $remainder;
16498905a67cSAndy Whitcroft	while (1) {
1650a2750645SAndy Whitcroft		@stack = (['', 0]) if ($#stack == -1);
1651a2750645SAndy Whitcroft
1652773647a0SAndy Whitcroft		#warn "CSB: blk<$blk> remain<$remain>\n";
16538905a67cSAndy Whitcroft		# If we are about to drop off the end, pull in more
16548905a67cSAndy Whitcroft		# context.
16558905a67cSAndy Whitcroft		if ($off >= $len) {
16568905a67cSAndy Whitcroft			for (; $remain > 0; $line++) {
1657dea33496SAndy Whitcroft				last if (!defined $lines[$line]);
1658c2fdda0dSAndy Whitcroft				next if ($lines[$line] =~ /^-/);
16598905a67cSAndy Whitcroft				$remain--;
166013214adfSAndy Whitcroft				$loff = $len;
1661c2fdda0dSAndy Whitcroft				$blk .= $lines[$line] . "\n";
16628905a67cSAndy Whitcroft				$len = length($blk);
16638905a67cSAndy Whitcroft				$line++;
16648905a67cSAndy Whitcroft				last;
16658905a67cSAndy Whitcroft			}
16668905a67cSAndy Whitcroft			# Bail if there is no further context.
16678905a67cSAndy Whitcroft			#warn "CSB: blk<$blk> off<$off> len<$len>\n";
166813214adfSAndy Whitcroft			if ($off >= $len) {
16698905a67cSAndy Whitcroft				last;
16708905a67cSAndy Whitcroft			}
1671f74bd194SAndy Whitcroft			if ($level == 0 && substr($blk, $off) =~ /^.\s*#\s*define/) {
1672f74bd194SAndy Whitcroft				$level++;
1673f74bd194SAndy Whitcroft				$type = '#';
1674f74bd194SAndy Whitcroft			}
16758905a67cSAndy Whitcroft		}
1676cf655043SAndy Whitcroft		$p = $c;
16778905a67cSAndy Whitcroft		$c = substr($blk, $off, 1);
167813214adfSAndy Whitcroft		$remainder = substr($blk, $off);
16798905a67cSAndy Whitcroft
1680773647a0SAndy Whitcroft		#warn "CSB: c<$c> type<$type> level<$level> remainder<$remainder> coff_set<$coff_set>\n";
16814635f4fbSAndy Whitcroft
16824635f4fbSAndy Whitcroft		# Handle nested #if/#else.
16834635f4fbSAndy Whitcroft		if ($remainder =~ /^#\s*(?:ifndef|ifdef|if)\s/) {
16844635f4fbSAndy Whitcroft			push(@stack, [ $type, $level ]);
16854635f4fbSAndy Whitcroft		} elsif ($remainder =~ /^#\s*(?:else|elif)\b/) {
16864635f4fbSAndy Whitcroft			($type, $level) = @{$stack[$#stack - 1]};
16874635f4fbSAndy Whitcroft		} elsif ($remainder =~ /^#\s*endif\b/) {
16884635f4fbSAndy Whitcroft			($type, $level) = @{pop(@stack)};
16894635f4fbSAndy Whitcroft		}
16904635f4fbSAndy Whitcroft
16918905a67cSAndy Whitcroft		# Statement ends at the ';' or a close '}' at the
16928905a67cSAndy Whitcroft		# outermost level.
16938905a67cSAndy Whitcroft		if ($level == 0 && $c eq ';') {
16948905a67cSAndy Whitcroft			last;
16958905a67cSAndy Whitcroft		}
16968905a67cSAndy Whitcroft
169713214adfSAndy Whitcroft		# An else is really a conditional as long as its not else if
1698773647a0SAndy Whitcroft		if ($level == 0 && $coff_set == 0 &&
1699773647a0SAndy Whitcroft				(!defined($p) || $p =~ /(?:\s|\}|\+)/) &&
1700773647a0SAndy Whitcroft				$remainder =~ /^(else)(?:\s|{)/ &&
1701773647a0SAndy Whitcroft				$remainder !~ /^else\s+if\b/) {
1702773647a0SAndy Whitcroft			$coff = $off + length($1) - 1;
1703773647a0SAndy Whitcroft			$coff_set = 1;
1704773647a0SAndy Whitcroft			#warn "CSB: mark coff<$coff> soff<$soff> 1<$1>\n";
1705773647a0SAndy Whitcroft			#warn "[" . substr($blk, $soff, $coff - $soff + 1) . "]\n";
170613214adfSAndy Whitcroft		}
170713214adfSAndy Whitcroft
17088905a67cSAndy Whitcroft		if (($type eq '' || $type eq '(') && $c eq '(') {
17098905a67cSAndy Whitcroft			$level++;
17108905a67cSAndy Whitcroft			$type = '(';
17118905a67cSAndy Whitcroft		}
17128905a67cSAndy Whitcroft		if ($type eq '(' && $c eq ')') {
17138905a67cSAndy Whitcroft			$level--;
17148905a67cSAndy Whitcroft			$type = ($level != 0)? '(' : '';
17158905a67cSAndy Whitcroft
17168905a67cSAndy Whitcroft			if ($level == 0 && $coff < $soff) {
17178905a67cSAndy Whitcroft				$coff = $off;
1718773647a0SAndy Whitcroft				$coff_set = 1;
1719773647a0SAndy Whitcroft				#warn "CSB: mark coff<$coff>\n";
17208905a67cSAndy Whitcroft			}
17218905a67cSAndy Whitcroft		}
17228905a67cSAndy Whitcroft		if (($type eq '' || $type eq '{') && $c eq '{') {
17238905a67cSAndy Whitcroft			$level++;
17248905a67cSAndy Whitcroft			$type = '{';
17258905a67cSAndy Whitcroft		}
17268905a67cSAndy Whitcroft		if ($type eq '{' && $c eq '}') {
17278905a67cSAndy Whitcroft			$level--;
17288905a67cSAndy Whitcroft			$type = ($level != 0)? '{' : '';
17298905a67cSAndy Whitcroft
17308905a67cSAndy Whitcroft			if ($level == 0) {
1731b998e001SPatrick Pannuto				if (substr($blk, $off + 1, 1) eq ';') {
1732b998e001SPatrick Pannuto					$off++;
1733b998e001SPatrick Pannuto				}
17348905a67cSAndy Whitcroft				last;
17358905a67cSAndy Whitcroft			}
17368905a67cSAndy Whitcroft		}
1737f74bd194SAndy Whitcroft		# Preprocessor commands end at the newline unless escaped.
1738f74bd194SAndy Whitcroft		if ($type eq '#' && $c eq "\n" && $p ne "\\") {
1739f74bd194SAndy Whitcroft			$level--;
1740f74bd194SAndy Whitcroft			$type = '';
1741f74bd194SAndy Whitcroft			$off++;
1742f74bd194SAndy Whitcroft			last;
1743f74bd194SAndy Whitcroft		}
17448905a67cSAndy Whitcroft		$off++;
17458905a67cSAndy Whitcroft	}
1746a3bb97a7SAndy Whitcroft	# We are truly at the end, so shuffle to the next line.
174713214adfSAndy Whitcroft	if ($off == $len) {
1748a3bb97a7SAndy Whitcroft		$loff = $len + 1;
174913214adfSAndy Whitcroft		$line++;
175013214adfSAndy Whitcroft		$remain--;
175113214adfSAndy Whitcroft	}
17528905a67cSAndy Whitcroft
17538905a67cSAndy Whitcroft	my $statement = substr($blk, $soff, $off - $soff + 1);
17548905a67cSAndy Whitcroft	my $condition = substr($blk, $soff, $coff - $soff + 1);
17558905a67cSAndy Whitcroft
17568905a67cSAndy Whitcroft	#warn "STATEMENT<$statement>\n";
17578905a67cSAndy Whitcroft	#warn "CONDITION<$condition>\n";
17588905a67cSAndy Whitcroft
1759773647a0SAndy Whitcroft	#print "coff<$coff> soff<$off> loff<$loff>\n";
176013214adfSAndy Whitcroft
176113214adfSAndy Whitcroft	return ($statement, $condition,
176213214adfSAndy Whitcroft			$line, $remain + 1, $off - $loff + 1, $level);
176313214adfSAndy Whitcroft}
176413214adfSAndy Whitcroft
1765cf655043SAndy Whitcroftsub statement_lines {
1766cf655043SAndy Whitcroft	my ($stmt) = @_;
1767cf655043SAndy Whitcroft
1768cf655043SAndy Whitcroft	# Strip the diff line prefixes and rip blank lines at start and end.
1769cf655043SAndy Whitcroft	$stmt =~ s/(^|\n)./$1/g;
1770cf655043SAndy Whitcroft	$stmt =~ s/^\s*//;
1771cf655043SAndy Whitcroft	$stmt =~ s/\s*$//;
1772cf655043SAndy Whitcroft
1773cf655043SAndy Whitcroft	my @stmt_lines = ($stmt =~ /\n/g);
1774cf655043SAndy Whitcroft
1775cf655043SAndy Whitcroft	return $#stmt_lines + 2;
1776cf655043SAndy Whitcroft}
1777cf655043SAndy Whitcroft
1778cf655043SAndy Whitcroftsub statement_rawlines {
1779cf655043SAndy Whitcroft	my ($stmt) = @_;
1780cf655043SAndy Whitcroft
1781cf655043SAndy Whitcroft	my @stmt_lines = ($stmt =~ /\n/g);
1782cf655043SAndy Whitcroft
1783cf655043SAndy Whitcroft	return $#stmt_lines + 2;
1784cf655043SAndy Whitcroft}
1785cf655043SAndy Whitcroft
1786cf655043SAndy Whitcroftsub statement_block_size {
1787cf655043SAndy Whitcroft	my ($stmt) = @_;
1788cf655043SAndy Whitcroft
1789cf655043SAndy Whitcroft	$stmt =~ s/(^|\n)./$1/g;
1790cf655043SAndy Whitcroft	$stmt =~ s/^\s*{//;
1791cf655043SAndy Whitcroft	$stmt =~ s/}\s*$//;
1792cf655043SAndy Whitcroft	$stmt =~ s/^\s*//;
1793cf655043SAndy Whitcroft	$stmt =~ s/\s*$//;
1794cf655043SAndy Whitcroft
1795cf655043SAndy Whitcroft	my @stmt_lines = ($stmt =~ /\n/g);
1796cf655043SAndy Whitcroft	my @stmt_statements = ($stmt =~ /;/g);
1797cf655043SAndy Whitcroft
1798cf655043SAndy Whitcroft	my $stmt_lines = $#stmt_lines + 2;
1799cf655043SAndy Whitcroft	my $stmt_statements = $#stmt_statements + 1;
1800cf655043SAndy Whitcroft
1801cf655043SAndy Whitcroft	if ($stmt_lines > $stmt_statements) {
1802cf655043SAndy Whitcroft		return $stmt_lines;
1803cf655043SAndy Whitcroft	} else {
1804cf655043SAndy Whitcroft		return $stmt_statements;
1805cf655043SAndy Whitcroft	}
1806cf655043SAndy Whitcroft}
1807cf655043SAndy Whitcroft
180813214adfSAndy Whitcroftsub ctx_statement_full {
180913214adfSAndy Whitcroft	my ($linenr, $remain, $off) = @_;
181013214adfSAndy Whitcroft	my ($statement, $condition, $level);
181113214adfSAndy Whitcroft
181213214adfSAndy Whitcroft	my (@chunks);
181313214adfSAndy Whitcroft
1814cf655043SAndy Whitcroft	# Grab the first conditional/block pair.
181513214adfSAndy Whitcroft	($statement, $condition, $linenr, $remain, $off, $level) =
181613214adfSAndy Whitcroft				ctx_statement_block($linenr, $remain, $off);
1817773647a0SAndy Whitcroft	#print "F: c<$condition> s<$statement> remain<$remain>\n";
181813214adfSAndy Whitcroft	push(@chunks, [ $condition, $statement ]);
1819cf655043SAndy Whitcroft	if (!($remain > 0 && $condition =~ /^\s*(?:\n[+-])?\s*(?:if|else|do)\b/s)) {
1820cf655043SAndy Whitcroft		return ($level, $linenr, @chunks);
1821cf655043SAndy Whitcroft	}
1822cf655043SAndy Whitcroft
1823cf655043SAndy Whitcroft	# Pull in the following conditional/block pairs and see if they
1824cf655043SAndy Whitcroft	# could continue the statement.
1825cf655043SAndy Whitcroft	for (;;) {
182613214adfSAndy Whitcroft		($statement, $condition, $linenr, $remain, $off, $level) =
182713214adfSAndy Whitcroft				ctx_statement_block($linenr, $remain, $off);
1828cf655043SAndy Whitcroft		#print "C: c<$condition> s<$statement> remain<$remain>\n";
1829773647a0SAndy Whitcroft		last if (!($remain > 0 && $condition =~ /^(?:\s*\n[+-])*\s*(?:else|do)\b/s));
1830cf655043SAndy Whitcroft		#print "C: push\n";
1831cf655043SAndy Whitcroft		push(@chunks, [ $condition, $statement ]);
183213214adfSAndy Whitcroft	}
183313214adfSAndy Whitcroft
183413214adfSAndy Whitcroft	return ($level, $linenr, @chunks);
18358905a67cSAndy Whitcroft}
18368905a67cSAndy Whitcroft
18374a0df2efSAndy Whitcroftsub ctx_block_get {
1838f0a594c1SAndy Whitcroft	my ($linenr, $remain, $outer, $open, $close, $off) = @_;
18394a0df2efSAndy Whitcroft	my $line;
18404a0df2efSAndy Whitcroft	my $start = $linenr - 1;
18414a0df2efSAndy Whitcroft	my $blk = '';
18424a0df2efSAndy Whitcroft	my @o;
18434a0df2efSAndy Whitcroft	my @c;
18444a0df2efSAndy Whitcroft	my @res = ();
18454a0df2efSAndy Whitcroft
1846f0a594c1SAndy Whitcroft	my $level = 0;
18474635f4fbSAndy Whitcroft	my @stack = ($level);
184800df344fSAndy Whitcroft	for ($line = $start; $remain > 0; $line++) {
184900df344fSAndy Whitcroft		next if ($rawlines[$line] =~ /^-/);
185000df344fSAndy Whitcroft		$remain--;
185100df344fSAndy Whitcroft
185200df344fSAndy Whitcroft		$blk .= $rawlines[$line];
18534635f4fbSAndy Whitcroft
18544635f4fbSAndy Whitcroft		# Handle nested #if/#else.
185501464f30SAndy Whitcroft		if ($lines[$line] =~ /^.\s*#\s*(?:ifndef|ifdef|if)\s/) {
18564635f4fbSAndy Whitcroft			push(@stack, $level);
185701464f30SAndy Whitcroft		} elsif ($lines[$line] =~ /^.\s*#\s*(?:else|elif)\b/) {
18584635f4fbSAndy Whitcroft			$level = $stack[$#stack - 1];
185901464f30SAndy Whitcroft		} elsif ($lines[$line] =~ /^.\s*#\s*endif\b/) {
18604635f4fbSAndy Whitcroft			$level = pop(@stack);
18614635f4fbSAndy Whitcroft		}
18624635f4fbSAndy Whitcroft
186301464f30SAndy Whitcroft		foreach my $c (split(//, $lines[$line])) {
1864f0a594c1SAndy Whitcroft			##print "C<$c>L<$level><$open$close>O<$off>\n";
1865f0a594c1SAndy Whitcroft			if ($off > 0) {
1866f0a594c1SAndy Whitcroft				$off--;
1867f0a594c1SAndy Whitcroft				next;
1868f0a594c1SAndy Whitcroft			}
18694a0df2efSAndy Whitcroft
1870f0a594c1SAndy Whitcroft			if ($c eq $close && $level > 0) {
1871f0a594c1SAndy Whitcroft				$level--;
1872f0a594c1SAndy Whitcroft				last if ($level == 0);
1873f0a594c1SAndy Whitcroft			} elsif ($c eq $open) {
1874f0a594c1SAndy Whitcroft				$level++;
1875f0a594c1SAndy Whitcroft			}
1876f0a594c1SAndy Whitcroft		}
18774a0df2efSAndy Whitcroft
1878f0a594c1SAndy Whitcroft		if (!$outer || $level <= 1) {
187900df344fSAndy Whitcroft			push(@res, $rawlines[$line]);
18804a0df2efSAndy Whitcroft		}
18814a0df2efSAndy Whitcroft
1882f0a594c1SAndy Whitcroft		last if ($level == 0);
18834a0df2efSAndy Whitcroft	}
18844a0df2efSAndy Whitcroft
1885f0a594c1SAndy Whitcroft	return ($level, @res);
18864a0df2efSAndy Whitcroft}
18874a0df2efSAndy Whitcroftsub ctx_block_outer {
18884a0df2efSAndy Whitcroft	my ($linenr, $remain) = @_;
18894a0df2efSAndy Whitcroft
1890f0a594c1SAndy Whitcroft	my ($level, @r) = ctx_block_get($linenr, $remain, 1, '{', '}', 0);
1891f0a594c1SAndy Whitcroft	return @r;
18924a0df2efSAndy Whitcroft}
18934a0df2efSAndy Whitcroftsub ctx_block {
18944a0df2efSAndy Whitcroft	my ($linenr, $remain) = @_;
18954a0df2efSAndy Whitcroft
1896f0a594c1SAndy Whitcroft	my ($level, @r) = ctx_block_get($linenr, $remain, 0, '{', '}', 0);
1897f0a594c1SAndy Whitcroft	return @r;
1898653d4876SAndy Whitcroft}
1899653d4876SAndy Whitcroftsub ctx_statement {
1900f0a594c1SAndy Whitcroft	my ($linenr, $remain, $off) = @_;
1901f0a594c1SAndy Whitcroft
1902f0a594c1SAndy Whitcroft	my ($level, @r) = ctx_block_get($linenr, $remain, 0, '(', ')', $off);
1903f0a594c1SAndy Whitcroft	return @r;
1904f0a594c1SAndy Whitcroft}
1905f0a594c1SAndy Whitcroftsub ctx_block_level {
1906653d4876SAndy Whitcroft	my ($linenr, $remain) = @_;
1907653d4876SAndy Whitcroft
1908f0a594c1SAndy Whitcroft	return ctx_block_get($linenr, $remain, 0, '{', '}', 0);
19094a0df2efSAndy Whitcroft}
19109c0ca6f9SAndy Whitcroftsub ctx_statement_level {
19119c0ca6f9SAndy Whitcroft	my ($linenr, $remain, $off) = @_;
19129c0ca6f9SAndy Whitcroft
19139c0ca6f9SAndy Whitcroft	return ctx_block_get($linenr, $remain, 0, '(', ')', $off);
19149c0ca6f9SAndy Whitcroft}
19154a0df2efSAndy Whitcroft
19164a0df2efSAndy Whitcroftsub ctx_locate_comment {
19174a0df2efSAndy Whitcroft	my ($first_line, $end_line) = @_;
19184a0df2efSAndy Whitcroft
1919a55ee0ccSJoe Perches	# If c99 comment on the current line, or the line before or after
1920a55ee0ccSJoe Perches	my ($current_comment) = ($rawlines[$end_line - 1] =~ m@^\+.*(//.*$)@);
1921a55ee0ccSJoe Perches	return $current_comment if (defined $current_comment);
1922a55ee0ccSJoe Perches	($current_comment) = ($rawlines[$end_line - 2] =~ m@^[\+ ].*(//.*$)@);
1923a55ee0ccSJoe Perches	return $current_comment if (defined $current_comment);
1924a55ee0ccSJoe Perches	($current_comment) = ($rawlines[$end_line] =~ m@^[\+ ].*(//.*$)@);
1925a55ee0ccSJoe Perches	return $current_comment if (defined $current_comment);
1926a55ee0ccSJoe Perches
19274a0df2efSAndy Whitcroft	# Catch a comment on the end of the line itself.
1928a55ee0ccSJoe Perches	($current_comment) = ($rawlines[$end_line - 1] =~ m@.*(/\*.*\*/)\s*(?:\\\s*)?$@);
19294a0df2efSAndy Whitcroft	return $current_comment if (defined $current_comment);
19304a0df2efSAndy Whitcroft
19314a0df2efSAndy Whitcroft	# Look through the context and try and figure out if there is a
19324a0df2efSAndy Whitcroft	# comment.
19334a0df2efSAndy Whitcroft	my $in_comment = 0;
19344a0df2efSAndy Whitcroft	$current_comment = '';
19354a0df2efSAndy Whitcroft	for (my $linenr = $first_line; $linenr < $end_line; $linenr++) {
193600df344fSAndy Whitcroft		my $line = $rawlines[$linenr - 1];
193700df344fSAndy Whitcroft		#warn "           $line\n";
19384a0df2efSAndy Whitcroft		if ($linenr == $first_line and $line =~ m@^.\s*\*@) {
19394a0df2efSAndy Whitcroft			$in_comment = 1;
19404a0df2efSAndy Whitcroft		}
19414a0df2efSAndy Whitcroft		if ($line =~ m@/\*@) {
19424a0df2efSAndy Whitcroft			$in_comment = 1;
19434a0df2efSAndy Whitcroft		}
19444a0df2efSAndy Whitcroft		if (!$in_comment && $current_comment ne '') {
19454a0df2efSAndy Whitcroft			$current_comment = '';
19464a0df2efSAndy Whitcroft		}
19474a0df2efSAndy Whitcroft		$current_comment .= $line . "\n" if ($in_comment);
19484a0df2efSAndy Whitcroft		if ($line =~ m@\*/@) {
19494a0df2efSAndy Whitcroft			$in_comment = 0;
19504a0df2efSAndy Whitcroft		}
19514a0df2efSAndy Whitcroft	}
19524a0df2efSAndy Whitcroft
19534a0df2efSAndy Whitcroft	chomp($current_comment);
19544a0df2efSAndy Whitcroft	return($current_comment);
19554a0df2efSAndy Whitcroft}
19564a0df2efSAndy Whitcroftsub ctx_has_comment {
19574a0df2efSAndy Whitcroft	my ($first_line, $end_line) = @_;
19584a0df2efSAndy Whitcroft	my $cmt = ctx_locate_comment($first_line, $end_line);
19594a0df2efSAndy Whitcroft
196000df344fSAndy Whitcroft	##print "LINE: $rawlines[$end_line - 1 ]\n";
19614a0df2efSAndy Whitcroft	##print "CMMT: $cmt\n";
19624a0df2efSAndy Whitcroft
19634a0df2efSAndy Whitcroft	return ($cmt ne '');
19644a0df2efSAndy Whitcroft}
19654a0df2efSAndy Whitcroft
19664d001e4dSAndy Whitcroftsub raw_line {
19674d001e4dSAndy Whitcroft	my ($linenr, $cnt) = @_;
19684d001e4dSAndy Whitcroft
19694d001e4dSAndy Whitcroft	my $offset = $linenr - 1;
19704d001e4dSAndy Whitcroft	$cnt++;
19714d001e4dSAndy Whitcroft
19724d001e4dSAndy Whitcroft	my $line;
19734d001e4dSAndy Whitcroft	while ($cnt) {
19744d001e4dSAndy Whitcroft		$line = $rawlines[$offset++];
19754d001e4dSAndy Whitcroft		next if (defined($line) && $line =~ /^-/);
19764d001e4dSAndy Whitcroft		$cnt--;
19774d001e4dSAndy Whitcroft	}
19784d001e4dSAndy Whitcroft
19794d001e4dSAndy Whitcroft	return $line;
19804d001e4dSAndy Whitcroft}
19814d001e4dSAndy Whitcroft
19822a9f9d85STobin C. Hardingsub get_stat_real {
19832a9f9d85STobin C. Harding	my ($linenr, $lc) = @_;
19842a9f9d85STobin C. Harding
19852a9f9d85STobin C. Harding	my $stat_real = raw_line($linenr, 0);
19862a9f9d85STobin C. Harding	for (my $count = $linenr + 1; $count <= $lc; $count++) {
19872a9f9d85STobin C. Harding		$stat_real = $stat_real . "\n" . raw_line($count, 0);
19882a9f9d85STobin C. Harding	}
19892a9f9d85STobin C. Harding
19902a9f9d85STobin C. Harding	return $stat_real;
19912a9f9d85STobin C. Harding}
19922a9f9d85STobin C. Harding
1993e3d95a2aSTobin C. Hardingsub get_stat_here {
1994e3d95a2aSTobin C. Harding	my ($linenr, $cnt, $here) = @_;
1995e3d95a2aSTobin C. Harding
1996e3d95a2aSTobin C. Harding	my $herectx = $here . "\n";
1997e3d95a2aSTobin C. Harding	for (my $n = 0; $n < $cnt; $n++) {
1998e3d95a2aSTobin C. Harding		$herectx .= raw_line($linenr, $n) . "\n";
1999e3d95a2aSTobin C. Harding	}
2000e3d95a2aSTobin C. Harding
2001e3d95a2aSTobin C. Harding	return $herectx;
2002e3d95a2aSTobin C. Harding}
2003e3d95a2aSTobin C. Harding
20040a920b5bSAndy Whitcroftsub cat_vet {
20050a920b5bSAndy Whitcroft	my ($vet) = @_;
20069c0ca6f9SAndy Whitcroft	my ($res, $coded);
20070a920b5bSAndy Whitcroft
20089c0ca6f9SAndy Whitcroft	$res = '';
20096c72ffaaSAndy Whitcroft	while ($vet =~ /([^[:cntrl:]]*)([[:cntrl:]]|$)/g) {
20106c72ffaaSAndy Whitcroft		$res .= $1;
20116c72ffaaSAndy Whitcroft		if ($2 ne '') {
20129c0ca6f9SAndy Whitcroft			$coded = sprintf("^%c", unpack('C', $2) + 64);
20136c72ffaaSAndy Whitcroft			$res .= $coded;
20146c72ffaaSAndy Whitcroft		}
20159c0ca6f9SAndy Whitcroft	}
20169c0ca6f9SAndy Whitcroft	$res =~ s/$/\$/;
20170a920b5bSAndy Whitcroft
20189c0ca6f9SAndy Whitcroft	return $res;
20190a920b5bSAndy Whitcroft}
20200a920b5bSAndy Whitcroft
2021c2fdda0dSAndy Whitcroftmy $av_preprocessor = 0;
2022cf655043SAndy Whitcroftmy $av_pending;
2023c2fdda0dSAndy Whitcroftmy @av_paren_type;
20241f65f947SAndy Whitcroftmy $av_pend_colon;
2025c2fdda0dSAndy Whitcroft
2026c2fdda0dSAndy Whitcroftsub annotate_reset {
2027c2fdda0dSAndy Whitcroft	$av_preprocessor = 0;
2028cf655043SAndy Whitcroft	$av_pending = '_';
2029cf655043SAndy Whitcroft	@av_paren_type = ('E');
20301f65f947SAndy Whitcroft	$av_pend_colon = 'O';
2031c2fdda0dSAndy Whitcroft}
2032c2fdda0dSAndy Whitcroft
20336c72ffaaSAndy Whitcroftsub annotate_values {
20346c72ffaaSAndy Whitcroft	my ($stream, $type) = @_;
20356c72ffaaSAndy Whitcroft
20366c72ffaaSAndy Whitcroft	my $res;
20371f65f947SAndy Whitcroft	my $var = '_' x length($stream);
20386c72ffaaSAndy Whitcroft	my $cur = $stream;
20396c72ffaaSAndy Whitcroft
2040c2fdda0dSAndy Whitcroft	print "$stream\n" if ($dbg_values > 1);
20416c72ffaaSAndy Whitcroft
20426c72ffaaSAndy Whitcroft	while (length($cur)) {
2043773647a0SAndy Whitcroft		@av_paren_type = ('E') if ($#av_paren_type < 0);
2044cf655043SAndy Whitcroft		print " <" . join('', @av_paren_type) .
2045171ae1a4SAndy Whitcroft				"> <$type> <$av_pending>" if ($dbg_values > 1);
20466c72ffaaSAndy Whitcroft		if ($cur =~ /^(\s+)/o) {
2047c2fdda0dSAndy Whitcroft			print "WS($1)\n" if ($dbg_values > 1);
2048c2fdda0dSAndy Whitcroft			if ($1 =~ /\n/ && $av_preprocessor) {
2049cf655043SAndy Whitcroft				$type = pop(@av_paren_type);
2050c2fdda0dSAndy Whitcroft				$av_preprocessor = 0;
20516c72ffaaSAndy Whitcroft			}
20526c72ffaaSAndy Whitcroft
2053c023e473SFlorian Mickler		} elsif ($cur =~ /^(\(\s*$Type\s*)\)/ && $av_pending eq '_') {
20549446ef56SAndy Whitcroft			print "CAST($1)\n" if ($dbg_values > 1);
20559446ef56SAndy Whitcroft			push(@av_paren_type, $type);
2056addcdceaSAndy Whitcroft			$type = 'c';
20579446ef56SAndy Whitcroft
2058e91b6e26SAndy Whitcroft		} elsif ($cur =~ /^($Type)\s*(?:$Ident|,|\)|\(|\s*$)/) {
2059c2fdda0dSAndy Whitcroft			print "DECLARE($1)\n" if ($dbg_values > 1);
20606c72ffaaSAndy Whitcroft			$type = 'T';
20616c72ffaaSAndy Whitcroft
2062389a2fe5SAndy Whitcroft		} elsif ($cur =~ /^($Modifier)\s*/) {
2063389a2fe5SAndy Whitcroft			print "MODIFIER($1)\n" if ($dbg_values > 1);
2064389a2fe5SAndy Whitcroft			$type = 'T';
2065389a2fe5SAndy Whitcroft
2066c45dcabdSAndy Whitcroft		} elsif ($cur =~ /^(\#\s*define\s*$Ident)(\(?)/o) {
2067171ae1a4SAndy Whitcroft			print "DEFINE($1,$2)\n" if ($dbg_values > 1);
2068c2fdda0dSAndy Whitcroft			$av_preprocessor = 1;
2069171ae1a4SAndy Whitcroft			push(@av_paren_type, $type);
2070171ae1a4SAndy Whitcroft			if ($2 ne '') {
2071cf655043SAndy Whitcroft				$av_pending = 'N';
2072171ae1a4SAndy Whitcroft			}
2073171ae1a4SAndy Whitcroft			$type = 'E';
2074171ae1a4SAndy Whitcroft
2075c45dcabdSAndy Whitcroft		} elsif ($cur =~ /^(\#\s*(?:undef\s*$Ident|include\b))/o) {
2076171ae1a4SAndy Whitcroft			print "UNDEF($1)\n" if ($dbg_values > 1);
2077171ae1a4SAndy Whitcroft			$av_preprocessor = 1;
2078171ae1a4SAndy Whitcroft			push(@av_paren_type, $type);
20796c72ffaaSAndy Whitcroft
2080c45dcabdSAndy Whitcroft		} elsif ($cur =~ /^(\#\s*(?:ifdef|ifndef|if))/o) {
2081cf655043SAndy Whitcroft			print "PRE_START($1)\n" if ($dbg_values > 1);
2082c2fdda0dSAndy Whitcroft			$av_preprocessor = 1;
2083cf655043SAndy Whitcroft
2084cf655043SAndy Whitcroft			push(@av_paren_type, $type);
2085cf655043SAndy Whitcroft			push(@av_paren_type, $type);
2086171ae1a4SAndy Whitcroft			$type = 'E';
2087cf655043SAndy Whitcroft
2088c45dcabdSAndy Whitcroft		} elsif ($cur =~ /^(\#\s*(?:else|elif))/o) {
2089cf655043SAndy Whitcroft			print "PRE_RESTART($1)\n" if ($dbg_values > 1);
2090cf655043SAndy Whitcroft			$av_preprocessor = 1;
2091cf655043SAndy Whitcroft
2092cf655043SAndy Whitcroft			push(@av_paren_type, $av_paren_type[$#av_paren_type]);
2093cf655043SAndy Whitcroft
2094171ae1a4SAndy Whitcroft			$type = 'E';
2095cf655043SAndy Whitcroft
2096c45dcabdSAndy Whitcroft		} elsif ($cur =~ /^(\#\s*(?:endif))/o) {
2097cf655043SAndy Whitcroft			print "PRE_END($1)\n" if ($dbg_values > 1);
2098cf655043SAndy Whitcroft
2099cf655043SAndy Whitcroft			$av_preprocessor = 1;
2100cf655043SAndy Whitcroft
2101cf655043SAndy Whitcroft			# Assume all arms of the conditional end as this
2102cf655043SAndy Whitcroft			# one does, and continue as if the #endif was not here.
2103cf655043SAndy Whitcroft			pop(@av_paren_type);
2104cf655043SAndy Whitcroft			push(@av_paren_type, $type);
2105171ae1a4SAndy Whitcroft			$type = 'E';
21066c72ffaaSAndy Whitcroft
21076c72ffaaSAndy Whitcroft		} elsif ($cur =~ /^(\\\n)/o) {
2108c2fdda0dSAndy Whitcroft			print "PRECONT($1)\n" if ($dbg_values > 1);
21096c72ffaaSAndy Whitcroft
2110171ae1a4SAndy Whitcroft		} elsif ($cur =~ /^(__attribute__)\s*\(?/o) {
2111171ae1a4SAndy Whitcroft			print "ATTR($1)\n" if ($dbg_values > 1);
2112171ae1a4SAndy Whitcroft			$av_pending = $type;
2113171ae1a4SAndy Whitcroft			$type = 'N';
2114171ae1a4SAndy Whitcroft
21156c72ffaaSAndy Whitcroft		} elsif ($cur =~ /^(sizeof)\s*(\()?/o) {
2116c2fdda0dSAndy Whitcroft			print "SIZEOF($1)\n" if ($dbg_values > 1);
21176c72ffaaSAndy Whitcroft			if (defined $2) {
2118cf655043SAndy Whitcroft				$av_pending = 'V';
21196c72ffaaSAndy Whitcroft			}
21206c72ffaaSAndy Whitcroft			$type = 'N';
21216c72ffaaSAndy Whitcroft
212214b111c1SAndy Whitcroft		} elsif ($cur =~ /^(if|while|for)\b/o) {
2123c2fdda0dSAndy Whitcroft			print "COND($1)\n" if ($dbg_values > 1);
212414b111c1SAndy Whitcroft			$av_pending = 'E';
21256c72ffaaSAndy Whitcroft			$type = 'N';
21266c72ffaaSAndy Whitcroft
21271f65f947SAndy Whitcroft		} elsif ($cur =~/^(case)/o) {
21281f65f947SAndy Whitcroft			print "CASE($1)\n" if ($dbg_values > 1);
21291f65f947SAndy Whitcroft			$av_pend_colon = 'C';
21301f65f947SAndy Whitcroft			$type = 'N';
21311f65f947SAndy Whitcroft
213214b111c1SAndy Whitcroft		} elsif ($cur =~/^(return|else|goto|typeof|__typeof__)\b/o) {
2133c2fdda0dSAndy Whitcroft			print "KEYWORD($1)\n" if ($dbg_values > 1);
21346c72ffaaSAndy Whitcroft			$type = 'N';
21356c72ffaaSAndy Whitcroft
21366c72ffaaSAndy Whitcroft		} elsif ($cur =~ /^(\()/o) {
2137c2fdda0dSAndy Whitcroft			print "PAREN('$1')\n" if ($dbg_values > 1);
2138cf655043SAndy Whitcroft			push(@av_paren_type, $av_pending);
2139cf655043SAndy Whitcroft			$av_pending = '_';
21406c72ffaaSAndy Whitcroft			$type = 'N';
21416c72ffaaSAndy Whitcroft
21426c72ffaaSAndy Whitcroft		} elsif ($cur =~ /^(\))/o) {
2143cf655043SAndy Whitcroft			my $new_type = pop(@av_paren_type);
2144cf655043SAndy Whitcroft			if ($new_type ne '_') {
2145cf655043SAndy Whitcroft				$type = $new_type;
2146c2fdda0dSAndy Whitcroft				print "PAREN('$1') -> $type\n"
2147c2fdda0dSAndy Whitcroft							if ($dbg_values > 1);
21486c72ffaaSAndy Whitcroft			} else {
2149c2fdda0dSAndy Whitcroft				print "PAREN('$1')\n" if ($dbg_values > 1);
21506c72ffaaSAndy Whitcroft			}
21516c72ffaaSAndy Whitcroft
2152c8cb2ca3SAndy Whitcroft		} elsif ($cur =~ /^($Ident)\s*\(/o) {
2153c2fdda0dSAndy Whitcroft			print "FUNC($1)\n" if ($dbg_values > 1);
2154c8cb2ca3SAndy Whitcroft			$type = 'V';
2155cf655043SAndy Whitcroft			$av_pending = 'V';
21566c72ffaaSAndy Whitcroft
21578e761b04SAndy Whitcroft		} elsif ($cur =~ /^($Ident\s*):(?:\s*\d+\s*(,|=|;))?/) {
21588e761b04SAndy Whitcroft			if (defined $2 && $type eq 'C' || $type eq 'T') {
21591f65f947SAndy Whitcroft				$av_pend_colon = 'B';
21608e761b04SAndy Whitcroft			} elsif ($type eq 'E') {
21618e761b04SAndy Whitcroft				$av_pend_colon = 'L';
21621f65f947SAndy Whitcroft			}
21631f65f947SAndy Whitcroft			print "IDENT_COLON($1,$type>$av_pend_colon)\n" if ($dbg_values > 1);
21641f65f947SAndy Whitcroft			$type = 'V';
21651f65f947SAndy Whitcroft
21666c72ffaaSAndy Whitcroft		} elsif ($cur =~ /^($Ident|$Constant)/o) {
2167c2fdda0dSAndy Whitcroft			print "IDENT($1)\n" if ($dbg_values > 1);
21686c72ffaaSAndy Whitcroft			$type = 'V';
21696c72ffaaSAndy Whitcroft
21706c72ffaaSAndy Whitcroft		} elsif ($cur =~ /^($Assignment)/o) {
2171c2fdda0dSAndy Whitcroft			print "ASSIGN($1)\n" if ($dbg_values > 1);
21726c72ffaaSAndy Whitcroft			$type = 'N';
21736c72ffaaSAndy Whitcroft
2174cf655043SAndy Whitcroft		} elsif ($cur =~/^(;|{|})/) {
2175c2fdda0dSAndy Whitcroft			print "END($1)\n" if ($dbg_values > 1);
217613214adfSAndy Whitcroft			$type = 'E';
21771f65f947SAndy Whitcroft			$av_pend_colon = 'O';
217813214adfSAndy Whitcroft
21798e761b04SAndy Whitcroft		} elsif ($cur =~/^(,)/) {
21808e761b04SAndy Whitcroft			print "COMMA($1)\n" if ($dbg_values > 1);
21818e761b04SAndy Whitcroft			$type = 'C';
21828e761b04SAndy Whitcroft
21831f65f947SAndy Whitcroft		} elsif ($cur =~ /^(\?)/o) {
21841f65f947SAndy Whitcroft			print "QUESTION($1)\n" if ($dbg_values > 1);
21851f65f947SAndy Whitcroft			$type = 'N';
21861f65f947SAndy Whitcroft
21871f65f947SAndy Whitcroft		} elsif ($cur =~ /^(:)/o) {
21881f65f947SAndy Whitcroft			print "COLON($1,$av_pend_colon)\n" if ($dbg_values > 1);
21891f65f947SAndy Whitcroft
21901f65f947SAndy Whitcroft			substr($var, length($res), 1, $av_pend_colon);
21911f65f947SAndy Whitcroft			if ($av_pend_colon eq 'C' || $av_pend_colon eq 'L') {
21921f65f947SAndy Whitcroft				$type = 'E';
21931f65f947SAndy Whitcroft			} else {
21941f65f947SAndy Whitcroft				$type = 'N';
21951f65f947SAndy Whitcroft			}
21961f65f947SAndy Whitcroft			$av_pend_colon = 'O';
21971f65f947SAndy Whitcroft
21988e761b04SAndy Whitcroft		} elsif ($cur =~ /^(\[)/o) {
219913214adfSAndy Whitcroft			print "CLOSE($1)\n" if ($dbg_values > 1);
22006c72ffaaSAndy Whitcroft			$type = 'N';
22016c72ffaaSAndy Whitcroft
22020d413866SAndy Whitcroft		} elsif ($cur =~ /^(-(?![->])|\+(?!\+)|\*|\&\&|\&)/o) {
220374048ed8SAndy Whitcroft			my $variant;
220474048ed8SAndy Whitcroft
220574048ed8SAndy Whitcroft			print "OPV($1)\n" if ($dbg_values > 1);
220674048ed8SAndy Whitcroft			if ($type eq 'V') {
220774048ed8SAndy Whitcroft				$variant = 'B';
220874048ed8SAndy Whitcroft			} else {
220974048ed8SAndy Whitcroft				$variant = 'U';
221074048ed8SAndy Whitcroft			}
221174048ed8SAndy Whitcroft
221274048ed8SAndy Whitcroft			substr($var, length($res), 1, $variant);
221374048ed8SAndy Whitcroft			$type = 'N';
221474048ed8SAndy Whitcroft
22156c72ffaaSAndy Whitcroft		} elsif ($cur =~ /^($Operators)/o) {
2216c2fdda0dSAndy Whitcroft			print "OP($1)\n" if ($dbg_values > 1);
22176c72ffaaSAndy Whitcroft			if ($1 ne '++' && $1 ne '--') {
22186c72ffaaSAndy Whitcroft				$type = 'N';
22196c72ffaaSAndy Whitcroft			}
22206c72ffaaSAndy Whitcroft
22216c72ffaaSAndy Whitcroft		} elsif ($cur =~ /(^.)/o) {
2222c2fdda0dSAndy Whitcroft			print "C($1)\n" if ($dbg_values > 1);
22236c72ffaaSAndy Whitcroft		}
22246c72ffaaSAndy Whitcroft		if (defined $1) {
22256c72ffaaSAndy Whitcroft			$cur = substr($cur, length($1));
22266c72ffaaSAndy Whitcroft			$res .= $type x length($1);
22276c72ffaaSAndy Whitcroft		}
22286c72ffaaSAndy Whitcroft	}
22296c72ffaaSAndy Whitcroft
22301f65f947SAndy Whitcroft	return ($res, $var);
22316c72ffaaSAndy Whitcroft}
22326c72ffaaSAndy Whitcroft
22338905a67cSAndy Whitcroftsub possible {
223413214adfSAndy Whitcroft	my ($possible, $line) = @_;
22359a974fdbSAndy Whitcroft	my $notPermitted = qr{(?:
22360776e594SAndy Whitcroft		^(?:
22370776e594SAndy Whitcroft			$Modifier|
22380776e594SAndy Whitcroft			$Storage|
22390776e594SAndy Whitcroft			$Type|
22409a974fdbSAndy Whitcroft			DEFINE_\S+
22419a974fdbSAndy Whitcroft		)$|
22429a974fdbSAndy Whitcroft		^(?:
22430776e594SAndy Whitcroft			goto|
22440776e594SAndy Whitcroft			return|
22450776e594SAndy Whitcroft			case|
22460776e594SAndy Whitcroft			else|
22470776e594SAndy Whitcroft			asm|__asm__|
224889a88353SAndy Whitcroft			do|
224989a88353SAndy Whitcroft			\#|
225089a88353SAndy Whitcroft			\#\#|
22519a974fdbSAndy Whitcroft		)(?:\s|$)|
22520776e594SAndy Whitcroft		^(?:typedef|struct|enum)\b
22539a974fdbSAndy Whitcroft	    )}x;
22549a974fdbSAndy Whitcroft	warn "CHECK<$possible> ($line)\n" if ($dbg_possible > 2);
22559a974fdbSAndy Whitcroft	if ($possible !~ $notPermitted) {
2256c45dcabdSAndy Whitcroft		# Check for modifiers.
2257c45dcabdSAndy Whitcroft		$possible =~ s/\s*$Storage\s*//g;
2258c45dcabdSAndy Whitcroft		$possible =~ s/\s*$Sparse\s*//g;
2259c45dcabdSAndy Whitcroft		if ($possible =~ /^\s*$/) {
2260c45dcabdSAndy Whitcroft
2261c45dcabdSAndy Whitcroft		} elsif ($possible =~ /\s/) {
2262c45dcabdSAndy Whitcroft			$possible =~ s/\s*$Type\s*//g;
2263d2506586SAndy Whitcroft			for my $modifier (split(' ', $possible)) {
22649a974fdbSAndy Whitcroft				if ($modifier !~ $notPermitted) {
2265d2506586SAndy Whitcroft					warn "MODIFIER: $modifier ($possible) ($line)\n" if ($dbg_possible);
2266485ff23eSAlex Dowad					push(@modifierListFile, $modifier);
2267d2506586SAndy Whitcroft				}
22689a974fdbSAndy Whitcroft			}
2269c45dcabdSAndy Whitcroft
2270c45dcabdSAndy Whitcroft		} else {
227113214adfSAndy Whitcroft			warn "POSSIBLE: $possible ($line)\n" if ($dbg_possible);
2272485ff23eSAlex Dowad			push(@typeListFile, $possible);
2273c45dcabdSAndy Whitcroft		}
22748905a67cSAndy Whitcroft		build_types();
22750776e594SAndy Whitcroft	} else {
22760776e594SAndy Whitcroft		warn "NOTPOSS: $possible ($line)\n" if ($dbg_possible > 1);
22778905a67cSAndy Whitcroft	}
22788905a67cSAndy Whitcroft}
22798905a67cSAndy Whitcroft
22806c72ffaaSAndy Whitcroftmy $prefix = '';
22816c72ffaaSAndy Whitcroft
2282000d1cc1SJoe Perchessub show_type {
2283cbec18afSJoe Perches	my ($type) = @_;
228491bfe484SJoe Perches
2285522b837cSAlexey Dobriyan	$type =~ tr/[a-z]/[A-Z]/;
2286522b837cSAlexey Dobriyan
2287cbec18afSJoe Perches	return defined $use_type{$type} if (scalar keys %use_type > 0);
2288cbec18afSJoe Perches
2289cbec18afSJoe Perches	return !defined $ignore_type{$type};
2290000d1cc1SJoe Perches}
2291000d1cc1SJoe Perches
2292f0a594c1SAndy Whitcroftsub report {
2293cbec18afSJoe Perches	my ($level, $type, $msg) = @_;
2294cbec18afSJoe Perches
2295cbec18afSJoe Perches	if (!show_type($type) ||
2296cbec18afSJoe Perches	    (defined $tst_only && $msg !~ /\Q$tst_only\E/)) {
2297773647a0SAndy Whitcroft		return 0;
2298773647a0SAndy Whitcroft	}
229957230297SJoe Perches	my $output = '';
2300737c0767SJohn Brooks	if ($color) {
230157230297SJoe Perches		if ($level eq 'ERROR') {
230257230297SJoe Perches			$output .= RED;
230357230297SJoe Perches		} elsif ($level eq 'WARNING') {
230457230297SJoe Perches			$output .= YELLOW;
2305000d1cc1SJoe Perches		} else {
230657230297SJoe Perches			$output .= GREEN;
2307000d1cc1SJoe Perches		}
230857230297SJoe Perches	}
230957230297SJoe Perches	$output .= $prefix . $level . ':';
231057230297SJoe Perches	if ($show_types) {
2311737c0767SJohn Brooks		$output .= BLUE if ($color);
231257230297SJoe Perches		$output .= "$type:";
231357230297SJoe Perches	}
2314737c0767SJohn Brooks	$output .= RESET if ($color);
231557230297SJoe Perches	$output .= ' ' . $msg . "\n";
231634d8815fSJoe Perches
231734d8815fSJoe Perches	if ($showfile) {
231834d8815fSJoe Perches		my @lines = split("\n", $output, -1);
231934d8815fSJoe Perches		splice(@lines, 1, 1);
232034d8815fSJoe Perches		$output = join("\n", @lines);
232134d8815fSJoe Perches	}
232252178ce0SDwaipayan Ray
232352178ce0SDwaipayan Ray	if ($terse) {
232452178ce0SDwaipayan Ray		$output = (split('\n', $output))[0] . "\n";
232552178ce0SDwaipayan Ray	}
232652178ce0SDwaipayan Ray
232752178ce0SDwaipayan Ray	if ($verbose && exists($verbose_messages{$type}) &&
232852178ce0SDwaipayan Ray	    !exists($verbose_emitted{$type})) {
232952178ce0SDwaipayan Ray		$output .= $verbose_messages{$type} . "\n\n";
233052178ce0SDwaipayan Ray		$verbose_emitted{$type} = 1;
233152178ce0SDwaipayan Ray	}
23328905a67cSAndy Whitcroft
233357230297SJoe Perches	push(our @report, $output);
2334773647a0SAndy Whitcroft
2335773647a0SAndy Whitcroft	return 1;
2336f0a594c1SAndy Whitcroft}
2337cbec18afSJoe Perches
2338f0a594c1SAndy Whitcroftsub report_dump {
233913214adfSAndy Whitcroft	our @report;
2340f0a594c1SAndy Whitcroft}
2341000d1cc1SJoe Perches
2342d752fcc8SJoe Perchessub fixup_current_range {
2343d752fcc8SJoe Perches	my ($lineRef, $offset, $length) = @_;
2344d752fcc8SJoe Perches
2345d752fcc8SJoe Perches	if ($$lineRef =~ /^\@\@ -\d+,\d+ \+(\d+),(\d+) \@\@/) {
2346d752fcc8SJoe Perches		my $o = $1;
2347d752fcc8SJoe Perches		my $l = $2;
2348d752fcc8SJoe Perches		my $no = $o + $offset;
2349d752fcc8SJoe Perches		my $nl = $l + $length;
2350d752fcc8SJoe Perches		$$lineRef =~ s/\+$o,$l \@\@/\+$no,$nl \@\@/;
2351d752fcc8SJoe Perches	}
2352d752fcc8SJoe Perches}
2353d752fcc8SJoe Perches
2354d752fcc8SJoe Perchessub fix_inserted_deleted_lines {
2355d752fcc8SJoe Perches	my ($linesRef, $insertedRef, $deletedRef) = @_;
2356d752fcc8SJoe Perches
2357d752fcc8SJoe Perches	my $range_last_linenr = 0;
2358d752fcc8SJoe Perches	my $delta_offset = 0;
2359d752fcc8SJoe Perches
2360d752fcc8SJoe Perches	my $old_linenr = 0;
2361d752fcc8SJoe Perches	my $new_linenr = 0;
2362d752fcc8SJoe Perches
2363d752fcc8SJoe Perches	my $next_insert = 0;
2364d752fcc8SJoe Perches	my $next_delete = 0;
2365d752fcc8SJoe Perches
2366d752fcc8SJoe Perches	my @lines = ();
2367d752fcc8SJoe Perches
2368d752fcc8SJoe Perches	my $inserted = @{$insertedRef}[$next_insert++];
2369d752fcc8SJoe Perches	my $deleted = @{$deletedRef}[$next_delete++];
2370d752fcc8SJoe Perches
2371d752fcc8SJoe Perches	foreach my $old_line (@{$linesRef}) {
2372d752fcc8SJoe Perches		my $save_line = 1;
2373d752fcc8SJoe Perches		my $line = $old_line;	#don't modify the array
2374323b267fSJoe Perches		if ($line =~ /^(?:\+\+\+|\-\-\-)\s+\S+/) {	#new filename
2375d752fcc8SJoe Perches			$delta_offset = 0;
2376d752fcc8SJoe Perches		} elsif ($line =~ /^\@\@ -\d+,\d+ \+\d+,\d+ \@\@/) {	#new hunk
2377d752fcc8SJoe Perches			$range_last_linenr = $new_linenr;
2378d752fcc8SJoe Perches			fixup_current_range(\$line, $delta_offset, 0);
2379d752fcc8SJoe Perches		}
2380d752fcc8SJoe Perches
2381d752fcc8SJoe Perches		while (defined($deleted) && ${$deleted}{'LINENR'} == $old_linenr) {
2382d752fcc8SJoe Perches			$deleted = @{$deletedRef}[$next_delete++];
2383d752fcc8SJoe Perches			$save_line = 0;
2384d752fcc8SJoe Perches			fixup_current_range(\$lines[$range_last_linenr], $delta_offset--, -1);
2385d752fcc8SJoe Perches		}
2386d752fcc8SJoe Perches
2387d752fcc8SJoe Perches		while (defined($inserted) && ${$inserted}{'LINENR'} == $old_linenr) {
2388d752fcc8SJoe Perches			push(@lines, ${$inserted}{'LINE'});
2389d752fcc8SJoe Perches			$inserted = @{$insertedRef}[$next_insert++];
2390d752fcc8SJoe Perches			$new_linenr++;
2391d752fcc8SJoe Perches			fixup_current_range(\$lines[$range_last_linenr], $delta_offset++, 1);
2392d752fcc8SJoe Perches		}
2393d752fcc8SJoe Perches
2394d752fcc8SJoe Perches		if ($save_line) {
2395d752fcc8SJoe Perches			push(@lines, $line);
2396d752fcc8SJoe Perches			$new_linenr++;
2397d752fcc8SJoe Perches		}
2398d752fcc8SJoe Perches
2399d752fcc8SJoe Perches		$old_linenr++;
2400d752fcc8SJoe Perches	}
2401d752fcc8SJoe Perches
2402d752fcc8SJoe Perches	return @lines;
2403d752fcc8SJoe Perches}
2404d752fcc8SJoe Perches
2405f2d7e4d4SJoe Perchessub fix_insert_line {
2406f2d7e4d4SJoe Perches	my ($linenr, $line) = @_;
2407f2d7e4d4SJoe Perches
2408f2d7e4d4SJoe Perches	my $inserted = {
2409f2d7e4d4SJoe Perches		LINENR => $linenr,
2410f2d7e4d4SJoe Perches		LINE => $line,
2411f2d7e4d4SJoe Perches	};
2412f2d7e4d4SJoe Perches	push(@fixed_inserted, $inserted);
2413f2d7e4d4SJoe Perches}
2414f2d7e4d4SJoe Perches
2415f2d7e4d4SJoe Perchessub fix_delete_line {
2416f2d7e4d4SJoe Perches	my ($linenr, $line) = @_;
2417f2d7e4d4SJoe Perches
2418f2d7e4d4SJoe Perches	my $deleted = {
2419f2d7e4d4SJoe Perches		LINENR => $linenr,
2420f2d7e4d4SJoe Perches		LINE => $line,
2421f2d7e4d4SJoe Perches	};
2422f2d7e4d4SJoe Perches
2423f2d7e4d4SJoe Perches	push(@fixed_deleted, $deleted);
2424f2d7e4d4SJoe Perches}
2425f2d7e4d4SJoe Perches
2426de7d4f0eSAndy Whitcroftsub ERROR {
2427cbec18afSJoe Perches	my ($type, $msg) = @_;
2428cbec18afSJoe Perches
2429cbec18afSJoe Perches	if (report("ERROR", $type, $msg)) {
2430de7d4f0eSAndy Whitcroft		our $clean = 0;
24316c72ffaaSAndy Whitcroft		our $cnt_error++;
24323705ce5bSJoe Perches		return 1;
2433de7d4f0eSAndy Whitcroft	}
24343705ce5bSJoe Perches	return 0;
2435773647a0SAndy Whitcroft}
2436de7d4f0eSAndy Whitcroftsub WARN {
2437cbec18afSJoe Perches	my ($type, $msg) = @_;
2438cbec18afSJoe Perches
2439cbec18afSJoe Perches	if (report("WARNING", $type, $msg)) {
2440de7d4f0eSAndy Whitcroft		our $clean = 0;
24416c72ffaaSAndy Whitcroft		our $cnt_warn++;
24423705ce5bSJoe Perches		return 1;
2443de7d4f0eSAndy Whitcroft	}
24443705ce5bSJoe Perches	return 0;
2445773647a0SAndy Whitcroft}
2446de7d4f0eSAndy Whitcroftsub CHK {
2447cbec18afSJoe Perches	my ($type, $msg) = @_;
2448cbec18afSJoe Perches
2449cbec18afSJoe Perches	if ($check && report("CHECK", $type, $msg)) {
2450de7d4f0eSAndy Whitcroft		our $clean = 0;
24516c72ffaaSAndy Whitcroft		our $cnt_chk++;
24523705ce5bSJoe Perches		return 1;
24536c72ffaaSAndy Whitcroft	}
24543705ce5bSJoe Perches	return 0;
2455de7d4f0eSAndy Whitcroft}
2456de7d4f0eSAndy Whitcroft
24576ecd9674SAndy Whitcroftsub check_absolute_file {
24586ecd9674SAndy Whitcroft	my ($absolute, $herecurr) = @_;
24596ecd9674SAndy Whitcroft	my $file = $absolute;
24606ecd9674SAndy Whitcroft
24616ecd9674SAndy Whitcroft	##print "absolute<$absolute>\n";
24626ecd9674SAndy Whitcroft
24636ecd9674SAndy Whitcroft	# See if any suffix of this path is a path within the tree.
24646ecd9674SAndy Whitcroft	while ($file =~ s@^[^/]*/@@) {
24656ecd9674SAndy Whitcroft		if (-f "$root/$file") {
24666ecd9674SAndy Whitcroft			##print "file<$file>\n";
24676ecd9674SAndy Whitcroft			last;
24686ecd9674SAndy Whitcroft		}
24696ecd9674SAndy Whitcroft	}
24706ecd9674SAndy Whitcroft	if (! -f _)  {
24716ecd9674SAndy Whitcroft		return 0;
24726ecd9674SAndy Whitcroft	}
24736ecd9674SAndy Whitcroft
24746ecd9674SAndy Whitcroft	# It is, so see if the prefix is acceptable.
24756ecd9674SAndy Whitcroft	my $prefix = $absolute;
24766ecd9674SAndy Whitcroft	substr($prefix, -length($file)) = '';
24776ecd9674SAndy Whitcroft
24786ecd9674SAndy Whitcroft	##print "prefix<$prefix>\n";
24796ecd9674SAndy Whitcroft	if ($prefix ne ".../") {
2480000d1cc1SJoe Perches		WARN("USE_RELATIVE_PATH",
2481000d1cc1SJoe Perches		     "use relative pathname instead of absolute in changelog text\n" . $herecurr);
24826ecd9674SAndy Whitcroft	}
24836ecd9674SAndy Whitcroft}
24846ecd9674SAndy Whitcroft
24853705ce5bSJoe Perchessub trim {
24863705ce5bSJoe Perches	my ($string) = @_;
24873705ce5bSJoe Perches
2488b34c648bSJoe Perches	$string =~ s/^\s+|\s+$//g;
2489b34c648bSJoe Perches
2490b34c648bSJoe Perches	return $string;
2491b34c648bSJoe Perches}
2492b34c648bSJoe Perches
2493b34c648bSJoe Perchessub ltrim {
2494b34c648bSJoe Perches	my ($string) = @_;
2495b34c648bSJoe Perches
2496b34c648bSJoe Perches	$string =~ s/^\s+//;
2497b34c648bSJoe Perches
2498b34c648bSJoe Perches	return $string;
2499b34c648bSJoe Perches}
2500b34c648bSJoe Perches
2501b34c648bSJoe Perchessub rtrim {
2502b34c648bSJoe Perches	my ($string) = @_;
2503b34c648bSJoe Perches
2504b34c648bSJoe Perches	$string =~ s/\s+$//;
25053705ce5bSJoe Perches
25063705ce5bSJoe Perches	return $string;
25073705ce5bSJoe Perches}
25083705ce5bSJoe Perches
250952ea8506SJoe Perchessub string_find_replace {
251052ea8506SJoe Perches	my ($string, $find, $replace) = @_;
251152ea8506SJoe Perches
251252ea8506SJoe Perches	$string =~ s/$find/$replace/g;
251352ea8506SJoe Perches
251452ea8506SJoe Perches	return $string;
251552ea8506SJoe Perches}
251652ea8506SJoe Perches
25173705ce5bSJoe Perchessub tabify {
25183705ce5bSJoe Perches	my ($leading) = @_;
25193705ce5bSJoe Perches
2520713a09deSAntonio Borneo	my $source_indent = $tabsize;
25213705ce5bSJoe Perches	my $max_spaces_before_tab = $source_indent - 1;
25223705ce5bSJoe Perches	my $spaces_to_tab = " " x $source_indent;
25233705ce5bSJoe Perches
25243705ce5bSJoe Perches	#convert leading spaces to tabs
25253705ce5bSJoe Perches	1 while $leading =~ s@^([\t]*)$spaces_to_tab@$1\t@g;
25263705ce5bSJoe Perches	#Remove spaces before a tab
25273705ce5bSJoe Perches	1 while $leading =~ s@^([\t]*)( {1,$max_spaces_before_tab})\t@$1\t@g;
25283705ce5bSJoe Perches
25293705ce5bSJoe Perches	return "$leading";
25303705ce5bSJoe Perches}
25313705ce5bSJoe Perches
2532d1fe9c09SJoe Perchessub pos_last_openparen {
2533d1fe9c09SJoe Perches	my ($line) = @_;
2534d1fe9c09SJoe Perches
2535d1fe9c09SJoe Perches	my $pos = 0;
2536d1fe9c09SJoe Perches
2537d1fe9c09SJoe Perches	my $opens = $line =~ tr/\(/\(/;
2538d1fe9c09SJoe Perches	my $closes = $line =~ tr/\)/\)/;
2539d1fe9c09SJoe Perches
2540d1fe9c09SJoe Perches	my $last_openparen = 0;
2541d1fe9c09SJoe Perches
2542d1fe9c09SJoe Perches	if (($opens == 0) || ($closes >= $opens)) {
2543d1fe9c09SJoe Perches		return -1;
2544d1fe9c09SJoe Perches	}
2545d1fe9c09SJoe Perches
2546d1fe9c09SJoe Perches	my $len = length($line);
2547d1fe9c09SJoe Perches
2548d1fe9c09SJoe Perches	for ($pos = 0; $pos < $len; $pos++) {
2549d1fe9c09SJoe Perches		my $string = substr($line, $pos);
2550d1fe9c09SJoe Perches		if ($string =~ /^($FuncArg|$balanced_parens)/) {
2551d1fe9c09SJoe Perches			$pos += length($1) - 1;
2552d1fe9c09SJoe Perches		} elsif (substr($line, $pos, 1) eq '(') {
2553d1fe9c09SJoe Perches			$last_openparen = $pos;
2554d1fe9c09SJoe Perches		} elsif (index($string, '(') == -1) {
2555d1fe9c09SJoe Perches			last;
2556d1fe9c09SJoe Perches		}
2557d1fe9c09SJoe Perches	}
2558d1fe9c09SJoe Perches
255991cb5195SJoe Perches	return length(expand_tabs(substr($line, 0, $last_openparen))) + 1;
2560d1fe9c09SJoe Perches}
2561d1fe9c09SJoe Perches
2562f36d3eb8SJoe Perchessub get_raw_comment {
2563f36d3eb8SJoe Perches	my ($line, $rawline) = @_;
2564f36d3eb8SJoe Perches	my $comment = '';
2565f36d3eb8SJoe Perches
2566f36d3eb8SJoe Perches	for my $i (0 .. (length($line) - 1)) {
2567f36d3eb8SJoe Perches		if (substr($line, $i, 1) eq "$;") {
2568f36d3eb8SJoe Perches			$comment .= substr($rawline, $i, 1);
2569f36d3eb8SJoe Perches		}
2570f36d3eb8SJoe Perches	}
2571f36d3eb8SJoe Perches
2572f36d3eb8SJoe Perches	return $comment;
2573f36d3eb8SJoe Perches}
2574f36d3eb8SJoe Perches
25755b8f82e1SSong Liusub exclude_global_initialisers {
25765b8f82e1SSong Liu	my ($realfile) = @_;
25775b8f82e1SSong Liu
25785b8f82e1SSong Liu	# Do not check for BPF programs (tools/testing/selftests/bpf/progs/*.c, samples/bpf/*_kern.c, *.bpf.c).
25795b8f82e1SSong Liu	return $realfile =~ m@^tools/testing/selftests/bpf/progs/.*\.c$@ ||
25805b8f82e1SSong Liu		$realfile =~ m@^samples/bpf/.*_kern\.c$@ ||
25815b8f82e1SSong Liu		$realfile =~ m@/bpf/.*\.bpf\.c$@;
25825b8f82e1SSong Liu}
25835b8f82e1SSong Liu
25840a920b5bSAndy Whitcroftsub process {
25850a920b5bSAndy Whitcroft	my $filename = shift;
25860a920b5bSAndy Whitcroft
25870a920b5bSAndy Whitcroft	my $linenr=0;
25880a920b5bSAndy Whitcroft	my $prevline="";
2589c2fdda0dSAndy Whitcroft	my $prevrawline="";
25900a920b5bSAndy Whitcroft	my $stashline="";
2591c2fdda0dSAndy Whitcroft	my $stashrawline="";
25920a920b5bSAndy Whitcroft
25934a0df2efSAndy Whitcroft	my $length;
25940a920b5bSAndy Whitcroft	my $indent;
25950a920b5bSAndy Whitcroft	my $previndent=0;
25960a920b5bSAndy Whitcroft	my $stashindent=0;
25970a920b5bSAndy Whitcroft
2598de7d4f0eSAndy Whitcroft	our $clean = 1;
25990a920b5bSAndy Whitcroft	my $signoff = 0;
2600cd261496SGeert Uytterhoeven	my $author = '';
2601cd261496SGeert Uytterhoeven	my $authorsignoff = 0;
260248ca2d8aSDwaipayan Ray	my $author_sob = '';
26030a920b5bSAndy Whitcroft	my $is_patch = 0;
2604133712a2SRob Herring	my $is_binding_patch = -1;
260529ee1b0cSJoe Perches	my $in_header_lines = $file ? 0 : 1;
260615662b3eSJoe Perches	my $in_commit_log = 0;		#Scanning lines before patch
260744d303ebSJoe Perches	my $has_patch_separator = 0;	#Found a --- line
2608ed43c4e5SAllen Hubbe	my $has_commit_log = 0;		#Encountered lines before patch
2609490b292cSJoe Perches	my $commit_log_lines = 0;	#Number of commit log lines
2610bf4daf12SJoe Perches	my $commit_log_possible_stack_dump = 0;
26112a076f40SJoe Perches	my $commit_log_long_line = 0;
2612e518e9a5SJoe Perches	my $commit_log_has_diff = 0;
261313f1937eSJoe Perches	my $reported_maintainer_file = 0;
2614fa64205dSPasi Savanainen	my $non_utf8_charset = 0;
2615fa64205dSPasi Savanainen
26164ce9f970SJoe Perches	my $last_git_commit_id_linenr = -1;
26174ce9f970SJoe Perches
2618365dd4eaSJoe Perches	my $last_blank_line = 0;
26195e4f6ba5SJoe Perches	my $last_coalesced_string_linenr = -1;
2620365dd4eaSJoe Perches
262113214adfSAndy Whitcroft	our @report = ();
26226c72ffaaSAndy Whitcroft	our $cnt_lines = 0;
26236c72ffaaSAndy Whitcroft	our $cnt_error = 0;
26246c72ffaaSAndy Whitcroft	our $cnt_warn = 0;
26256c72ffaaSAndy Whitcroft	our $cnt_chk = 0;
26266c72ffaaSAndy Whitcroft
26270a920b5bSAndy Whitcroft	# Trace the real file/line as we go.
26280a920b5bSAndy Whitcroft	my $realfile = '';
26290a920b5bSAndy Whitcroft	my $realline = 0;
26300a920b5bSAndy Whitcroft	my $realcnt = 0;
26310a920b5bSAndy Whitcroft	my $here = '';
263277cb8546SJoe Perches	my $context_function;		#undef'd unless there's a known function
26330a920b5bSAndy Whitcroft	my $in_comment = 0;
2634c2fdda0dSAndy Whitcroft	my $comment_edge = 0;
26350a920b5bSAndy Whitcroft	my $first_line = 0;
26361e855726SWolfram Sang	my $p1_prefix = '';
26370a920b5bSAndy Whitcroft
263813214adfSAndy Whitcroft	my $prev_values = 'E';
263913214adfSAndy Whitcroft
264013214adfSAndy Whitcroft	# suppression flags
2641773647a0SAndy Whitcroft	my %suppress_ifbraces;
2642170d3a22SAndy Whitcroft	my %suppress_whiletrailers;
26432b474a1aSAndy Whitcroft	my %suppress_export;
26443e469cdcSAndy Whitcroft	my $suppress_statement = 0;
2645653d4876SAndy Whitcroft
26467e51f197SJoe Perches	my %signatures = ();
2647323c1260SJoe Perches
2648c2fdda0dSAndy Whitcroft	# Pre-scan the patch sanitizing the lines.
2649de7d4f0eSAndy Whitcroft	# Pre-scan the patch looking for any __setup documentation.
2650c2fdda0dSAndy Whitcroft	#
2651de7d4f0eSAndy Whitcroft	my @setup_docs = ();
2652de7d4f0eSAndy Whitcroft	my $setup_docs = 0;
2653773647a0SAndy Whitcroft
2654d8b07710SJoe Perches	my $camelcase_file_seeded = 0;
2655d8b07710SJoe Perches
26569f3a8992SRob Herring	my $checklicenseline = 1;
26579f3a8992SRob Herring
2658773647a0SAndy Whitcroft	sanitise_line_reset();
2659c2fdda0dSAndy Whitcroft	my $line;
2660c2fdda0dSAndy Whitcroft	foreach my $rawline (@rawlines) {
2661773647a0SAndy Whitcroft		$linenr++;
2662773647a0SAndy Whitcroft		$line = $rawline;
2663c2fdda0dSAndy Whitcroft
26643705ce5bSJoe Perches		push(@fixed, $rawline) if ($fix);
26653705ce5bSJoe Perches
2666773647a0SAndy Whitcroft		if ($rawline=~/^\+\+\+\s+(\S+)/) {
2667de7d4f0eSAndy Whitcroft			$setup_docs = 0;
26682581ac7cSTim Froidcoeur			if ($1 =~ m@Documentation/admin-guide/kernel-parameters.txt$@) {
2669de7d4f0eSAndy Whitcroft				$setup_docs = 1;
2670de7d4f0eSAndy Whitcroft			}
2671773647a0SAndy Whitcroft			#next;
2672de7d4f0eSAndy Whitcroft		}
267374fd4f34SJoe Perches		if ($rawline =~ /^\@\@ -\d+(?:,\d+)? \+(\d+)(,(\d+))? \@\@/) {
2674773647a0SAndy Whitcroft			$realline=$1-1;
2675773647a0SAndy Whitcroft			if (defined $2) {
2676773647a0SAndy Whitcroft				$realcnt=$3+1;
2677773647a0SAndy Whitcroft			} else {
2678773647a0SAndy Whitcroft				$realcnt=1+1;
2679773647a0SAndy Whitcroft			}
2680c45dcabdSAndy Whitcroft			$in_comment = 0;
2681773647a0SAndy Whitcroft
2682773647a0SAndy Whitcroft			# Guestimate if this is a continuing comment.  Run
2683773647a0SAndy Whitcroft			# the context looking for a comment "edge".  If this
2684773647a0SAndy Whitcroft			# edge is a close comment then we must be in a comment
2685773647a0SAndy Whitcroft			# at context start.
2686773647a0SAndy Whitcroft			my $edge;
268701fa9147SAndy Whitcroft			my $cnt = $realcnt;
268801fa9147SAndy Whitcroft			for (my $ln = $linenr + 1; $cnt > 0; $ln++) {
268901fa9147SAndy Whitcroft				next if (defined $rawlines[$ln - 1] &&
269001fa9147SAndy Whitcroft					 $rawlines[$ln - 1] =~ /^-/);
269101fa9147SAndy Whitcroft				$cnt--;
269201fa9147SAndy Whitcroft				#print "RAW<$rawlines[$ln - 1]>\n";
2693721c1cb6SAndy Whitcroft				last if (!defined $rawlines[$ln - 1]);
2694fae17daeSAndy Whitcroft				if ($rawlines[$ln - 1] =~ m@(/\*|\*/)@ &&
2695fae17daeSAndy Whitcroft				    $rawlines[$ln - 1] !~ m@"[^"]*(?:/\*|\*/)[^"]*"@) {
2696fae17daeSAndy Whitcroft					($edge) = $1;
2697fae17daeSAndy Whitcroft					last;
2698fae17daeSAndy Whitcroft				}
2699773647a0SAndy Whitcroft			}
2700773647a0SAndy Whitcroft			if (defined $edge && $edge eq '*/') {
2701773647a0SAndy Whitcroft				$in_comment = 1;
2702773647a0SAndy Whitcroft			}
2703773647a0SAndy Whitcroft
2704773647a0SAndy Whitcroft			# Guestimate if this is a continuing comment.  If this
2705773647a0SAndy Whitcroft			# is the start of a diff block and this line starts
2706773647a0SAndy Whitcroft			# ' *' then it is very likely a comment.
2707773647a0SAndy Whitcroft			if (!defined $edge &&
270883242e0cSAndy Whitcroft			    $rawlines[$linenr] =~ m@^.\s*(?:\*\*+| \*)(?:\s|$)@)
2709773647a0SAndy Whitcroft			{
2710773647a0SAndy Whitcroft				$in_comment = 1;
2711773647a0SAndy Whitcroft			}
2712773647a0SAndy Whitcroft
2713773647a0SAndy Whitcroft			##print "COMMENT:$in_comment edge<$edge> $rawline\n";
2714773647a0SAndy Whitcroft			sanitise_line_reset($in_comment);
2715773647a0SAndy Whitcroft
2716171ae1a4SAndy Whitcroft		} elsif ($realcnt && $rawline =~ /^(?:\+| |$)/) {
2717773647a0SAndy Whitcroft			# Standardise the strings and chars within the input to
2718171ae1a4SAndy Whitcroft			# simplify matching -- only bother with positive lines.
2719773647a0SAndy Whitcroft			$line = sanitise_line($rawline);
2720773647a0SAndy Whitcroft		}
2721773647a0SAndy Whitcroft		push(@lines, $line);
2722773647a0SAndy Whitcroft
2723773647a0SAndy Whitcroft		if ($realcnt > 1) {
2724773647a0SAndy Whitcroft			$realcnt-- if ($line =~ /^(?:\+| |$)/);
2725773647a0SAndy Whitcroft		} else {
2726773647a0SAndy Whitcroft			$realcnt = 0;
2727773647a0SAndy Whitcroft		}
2728773647a0SAndy Whitcroft
2729773647a0SAndy Whitcroft		#print "==>$rawline\n";
2730773647a0SAndy Whitcroft		#print "-->$line\n";
2731de7d4f0eSAndy Whitcroft
2732de7d4f0eSAndy Whitcroft		if ($setup_docs && $line =~ /^\+/) {
2733de7d4f0eSAndy Whitcroft			push(@setup_docs, $line);
2734de7d4f0eSAndy Whitcroft		}
2735de7d4f0eSAndy Whitcroft	}
2736de7d4f0eSAndy Whitcroft
27376c72ffaaSAndy Whitcroft	$prefix = '';
27386c72ffaaSAndy Whitcroft
2739773647a0SAndy Whitcroft	$realcnt = 0;
2740773647a0SAndy Whitcroft	$linenr = 0;
2741194f66fcSJoe Perches	$fixlinenr = -1;
27420a920b5bSAndy Whitcroft	foreach my $line (@lines) {
27430a920b5bSAndy Whitcroft		$linenr++;
2744194f66fcSJoe Perches		$fixlinenr++;
27451b5539b1SJoe Perches		my $sline = $line;	#copy of $line
27461b5539b1SJoe Perches		$sline =~ s/$;/ /g;	#with comments as spaces
27470a920b5bSAndy Whitcroft
2748c2fdda0dSAndy Whitcroft		my $rawline = $rawlines[$linenr - 1];
2749f36d3eb8SJoe Perches		my $raw_comment = get_raw_comment($line, $rawline);
27506c72ffaaSAndy Whitcroft
275112c253abSJoe Perches# check if it's a mode change, rename or start of a patch
275212c253abSJoe Perches		if (!$in_commit_log &&
275312c253abSJoe Perches		    ($line =~ /^ mode change [0-7]+ => [0-7]+ \S+\s*$/ ||
275412c253abSJoe Perches		    ($line =~ /^rename (?:from|to) \S+\s*$/ ||
275512c253abSJoe Perches		     $line =~ /^diff --git a\/[\w\/\.\_\-]+ b\/\S+\s*$/))) {
275612c253abSJoe Perches			$is_patch = 1;
275712c253abSJoe Perches		}
275812c253abSJoe Perches
27590a920b5bSAndy Whitcroft#extract the line range in the file after the patch is applied
2760e518e9a5SJoe Perches		if (!$in_commit_log &&
276174fd4f34SJoe Perches		    $line =~ /^\@\@ -\d+(?:,\d+)? \+(\d+)(,(\d+))? \@\@(.*)/) {
276274fd4f34SJoe Perches			my $context = $4;
27630a920b5bSAndy Whitcroft			$is_patch = 1;
27644a0df2efSAndy Whitcroft			$first_line = $linenr + 1;
27650a920b5bSAndy Whitcroft			$realline=$1-1;
27660a920b5bSAndy Whitcroft			if (defined $2) {
27670a920b5bSAndy Whitcroft				$realcnt=$3+1;
27680a920b5bSAndy Whitcroft			} else {
27690a920b5bSAndy Whitcroft				$realcnt=1+1;
27700a920b5bSAndy Whitcroft			}
2771c2fdda0dSAndy Whitcroft			annotate_reset();
277213214adfSAndy Whitcroft			$prev_values = 'E';
277313214adfSAndy Whitcroft
2774773647a0SAndy Whitcroft			%suppress_ifbraces = ();
2775170d3a22SAndy Whitcroft			%suppress_whiletrailers = ();
27762b474a1aSAndy Whitcroft			%suppress_export = ();
27773e469cdcSAndy Whitcroft			$suppress_statement = 0;
277874fd4f34SJoe Perches			if ($context =~ /\b(\w+)\s*\(/) {
277974fd4f34SJoe Perches				$context_function = $1;
278074fd4f34SJoe Perches			} else {
278174fd4f34SJoe Perches				undef $context_function;
278274fd4f34SJoe Perches			}
27830a920b5bSAndy Whitcroft			next;
27840a920b5bSAndy Whitcroft
27854a0df2efSAndy Whitcroft# track the line number as we move through the hunk, note that
27864a0df2efSAndy Whitcroft# new versions of GNU diff omit the leading space on completely
27874a0df2efSAndy Whitcroft# blank context lines so we need to count that too.
2788773647a0SAndy Whitcroft		} elsif ($line =~ /^( |\+|$)/) {
27890a920b5bSAndy Whitcroft			$realline++;
2790d8aaf121SAndy Whitcroft			$realcnt-- if ($realcnt != 0);
27910a920b5bSAndy Whitcroft
27924a0df2efSAndy Whitcroft			# Measure the line length and indent.
2793c2fdda0dSAndy Whitcroft			($length, $indent) = line_stats($rawline);
27940a920b5bSAndy Whitcroft
27950a920b5bSAndy Whitcroft			# Track the previous line.
27960a920b5bSAndy Whitcroft			($prevline, $stashline) = ($stashline, $line);
27970a920b5bSAndy Whitcroft			($previndent, $stashindent) = ($stashindent, $indent);
2798c2fdda0dSAndy Whitcroft			($prevrawline, $stashrawline) = ($stashrawline, $rawline);
2799c2fdda0dSAndy Whitcroft
2800773647a0SAndy Whitcroft			#warn "line<$line>\n";
28016c72ffaaSAndy Whitcroft
2802d8aaf121SAndy Whitcroft		} elsif ($realcnt == 1) {
2803d8aaf121SAndy Whitcroft			$realcnt--;
28040a920b5bSAndy Whitcroft		}
28050a920b5bSAndy Whitcroft
2806cc77cdcaSAndy Whitcroft		my $hunk_line = ($realcnt != 0);
2807cc77cdcaSAndy Whitcroft
28086c72ffaaSAndy Whitcroft		$here = "#$linenr: " if (!$file);
28096c72ffaaSAndy Whitcroft		$here = "#$realline: " if ($file);
2810773647a0SAndy Whitcroft
28112ac73b4fSJoe Perches		my $found_file = 0;
2812773647a0SAndy Whitcroft		# extract the filename as it passes
28133bf9a009SRabin Vincent		if ($line =~ /^diff --git.*?(\S+)$/) {
28143bf9a009SRabin Vincent			$realfile = $1;
28152b7ab453SJoe Perches			$realfile =~ s@^([^/]*)/@@ if (!$file);
2816270c49a0SJoe Perches			$in_commit_log = 0;
28172ac73b4fSJoe Perches			$found_file = 1;
28183bf9a009SRabin Vincent		} elsif ($line =~ /^\+\+\+\s+(\S+)/) {
2819773647a0SAndy Whitcroft			$realfile = $1;
28202b7ab453SJoe Perches			$realfile =~ s@^([^/]*)/@@ if (!$file);
2821270c49a0SJoe Perches			$in_commit_log = 0;
28221e855726SWolfram Sang
28231e855726SWolfram Sang			$p1_prefix = $1;
2824e2f7aa4bSAndy Whitcroft			if (!$file && $tree && $p1_prefix ne '' &&
2825e2f7aa4bSAndy Whitcroft			    -e "$root/$p1_prefix") {
2826000d1cc1SJoe Perches				WARN("PATCH_PREFIX",
2827000d1cc1SJoe Perches				     "patch prefix '$p1_prefix' exists, appears to be a -p0 patch\n");
28281e855726SWolfram Sang			}
2829773647a0SAndy Whitcroft
2830c1ab3326SAndy Whitcroft			if ($realfile =~ m@^include/asm/@) {
2831000d1cc1SJoe Perches				ERROR("MODIFIED_INCLUDE_ASM",
2832000d1cc1SJoe Perches				      "do not modify files in include/asm, change architecture specific files in include/asm-<architecture>\n" . "$here$rawline\n");
2833773647a0SAndy Whitcroft			}
28342ac73b4fSJoe Perches			$found_file = 1;
28352ac73b4fSJoe Perches		}
28362ac73b4fSJoe Perches
283734d8815fSJoe Perches#make up the handle for any error we report on this line
283834d8815fSJoe Perches		if ($showfile) {
283934d8815fSJoe Perches			$prefix = "$realfile:$realline: "
284034d8815fSJoe Perches		} elsif ($emacs) {
28417d3a9f67SJoe Perches			if ($file) {
28427d3a9f67SJoe Perches				$prefix = "$filename:$realline: ";
28437d3a9f67SJoe Perches			} else {
284434d8815fSJoe Perches				$prefix = "$filename:$linenr: ";
284534d8815fSJoe Perches			}
28467d3a9f67SJoe Perches		}
284734d8815fSJoe Perches
28482ac73b4fSJoe Perches		if ($found_file) {
284985b0ee18SJoe Perches			if (is_maintained_obsolete($realfile)) {
285085b0ee18SJoe Perches				WARN("OBSOLETE",
285185b0ee18SJoe Perches				     "$realfile is marked as 'obsolete' in the MAINTAINERS hierarchy.  No unnecessary modifications please.\n");
285285b0ee18SJoe Perches			}
28537bd7e483SJoe Perches			if ($realfile =~ m@^(?:drivers/net/|net/|drivers/staging/)@) {
28542ac73b4fSJoe Perches				$check = 1;
28552ac73b4fSJoe Perches			} else {
28562ac73b4fSJoe Perches				$check = $check_orig;
28572ac73b4fSJoe Perches			}
28589f3a8992SRob Herring			$checklicenseline = 1;
2859133712a2SRob Herring
2860133712a2SRob Herring			if ($realfile !~ /^MAINTAINERS/) {
2861133712a2SRob Herring				my $last_binding_patch = $is_binding_patch;
2862133712a2SRob Herring
2863133712a2SRob Herring				$is_binding_patch = () = $realfile =~ m@^(?:Documentation/devicetree/|include/dt-bindings/)@;
2864133712a2SRob Herring
2865133712a2SRob Herring				if (($last_binding_patch != -1) &&
2866133712a2SRob Herring				    ($last_binding_patch ^ $is_binding_patch)) {
2867133712a2SRob Herring					WARN("DT_SPLIT_BINDING_PATCH",
2868858e6845SMauro Carvalho Chehab					     "DT binding docs and includes should be a separate patch. See: Documentation/devicetree/bindings/submitting-patches.rst\n");
2869133712a2SRob Herring				}
2870133712a2SRob Herring			}
2871133712a2SRob Herring
2872773647a0SAndy Whitcroft			next;
2873773647a0SAndy Whitcroft		}
2874773647a0SAndy Whitcroft
2875389834b6SRandy Dunlap		$here .= "FILE: $realfile:$realline:" if ($realcnt != 0);
28760a920b5bSAndy Whitcroft
2877c2fdda0dSAndy Whitcroft		my $hereline = "$here\n$rawline\n";
2878c2fdda0dSAndy Whitcroft		my $herecurr = "$here\n$rawline\n";
2879c2fdda0dSAndy Whitcroft		my $hereprev = "$here\n$prevrawline\n$rawline\n";
28800a920b5bSAndy Whitcroft
28816c72ffaaSAndy Whitcroft		$cnt_lines++ if ($realcnt != 0);
28826c72ffaaSAndy Whitcroft
2883490b292cSJoe Perches# Verify the existence of a commit log if appropriate
2884490b292cSJoe Perches# 2 is used because a $signature is counted in $commit_log_lines
2885490b292cSJoe Perches		if ($in_commit_log) {
2886490b292cSJoe Perches			if ($line !~ /^\s*$/) {
2887490b292cSJoe Perches				$commit_log_lines++;	#could be a $signature
2888490b292cSJoe Perches			}
2889490b292cSJoe Perches		} elsif ($has_commit_log && $commit_log_lines < 2) {
2890490b292cSJoe Perches			WARN("COMMIT_MESSAGE",
2891490b292cSJoe Perches			     "Missing commit description - Add an appropriate one\n");
2892490b292cSJoe Perches			$commit_log_lines = 2;	#warn only once
2893490b292cSJoe Perches		}
2894490b292cSJoe Perches
2895e518e9a5SJoe Perches# Check if the commit log has what seems like a diff which can confuse patch
2896e518e9a5SJoe Perches		if ($in_commit_log && !$commit_log_has_diff &&
289713e45417SMrinal Pandey		    (($line =~ m@^\s+diff\b.*a/([\w/]+)@ &&
289813e45417SMrinal Pandey		      $line =~ m@^\s+diff\b.*a/[\w/]+\s+b/$1\b@) ||
2899e518e9a5SJoe Perches		     $line =~ m@^\s*(?:\-\-\-\s+a/|\+\+\+\s+b/)@ ||
2900e518e9a5SJoe Perches		     $line =~ m/^\s*\@\@ \-\d+,\d+ \+\d+,\d+ \@\@/)) {
2901e518e9a5SJoe Perches			ERROR("DIFF_IN_COMMIT_MSG",
2902e518e9a5SJoe Perches			      "Avoid using diff content in the commit message - patch(1) might not work\n" . $herecurr);
2903e518e9a5SJoe Perches			$commit_log_has_diff = 1;
2904e518e9a5SJoe Perches		}
2905e518e9a5SJoe Perches
29063bf9a009SRabin Vincent# Check for incorrect file permissions
29073bf9a009SRabin Vincent		if ($line =~ /^new (file )?mode.*[7531]\d{0,2}$/) {
29083bf9a009SRabin Vincent			my $permhere = $here . "FILE: $realfile\n";
290904db4d25SJoe Perches			if ($realfile !~ m@scripts/@ &&
291004db4d25SJoe Perches			    $realfile !~ /\.(py|pl|awk|sh)$/) {
2911000d1cc1SJoe Perches				ERROR("EXECUTE_PERMISSIONS",
2912000d1cc1SJoe Perches				      "do not set execute permissions for source files\n" . $permhere);
29133bf9a009SRabin Vincent			}
29143bf9a009SRabin Vincent		}
29153bf9a009SRabin Vincent
2916cd261496SGeert Uytterhoeven# Check the patch for a From:
2917cd261496SGeert Uytterhoeven		if (decode("MIME-Header", $line) =~ /^From:\s*(.*)/) {
2918cd261496SGeert Uytterhoeven			$author = $1;
2919e7f929f3SDwaipayan Ray			my $curline = $linenr;
2920e7f929f3SDwaipayan Ray			while(defined($rawlines[$curline]) && ($rawlines[$curline++] =~ /^[ \t]\s*(.*)/)) {
2921e7f929f3SDwaipayan Ray				$author .= $1;
2922e7f929f3SDwaipayan Ray			}
2923cd261496SGeert Uytterhoeven			$author = encode("utf8", $author) if ($line =~ /=\?utf-8\?/i);
2924cd261496SGeert Uytterhoeven			$author =~ s/"//g;
2925dfa05c28SJoe Perches			$author = reformat_email($author);
2926cd261496SGeert Uytterhoeven		}
2927cd261496SGeert Uytterhoeven
292820112475SJoe Perches# Check the patch for a signoff:
2929dfa05c28SJoe Perches		if ($line =~ /^\s*signed-off-by:\s*(.*)/i) {
29304a0df2efSAndy Whitcroft			$signoff++;
293115662b3eSJoe Perches			$in_commit_log = 0;
293248ca2d8aSDwaipayan Ray			if ($author ne ''  && $authorsignoff != 1) {
2933fccaebf0SDwaipayan Ray				if (same_email_addresses($1, $author)) {
2934cd261496SGeert Uytterhoeven					$authorsignoff = 1;
293548ca2d8aSDwaipayan Ray				} else {
293648ca2d8aSDwaipayan Ray					my $ctx = $1;
293748ca2d8aSDwaipayan Ray					my ($email_name, $email_comment, $email_address, $comment1) = parse_email($ctx);
293848ca2d8aSDwaipayan Ray					my ($author_name, $author_comment, $author_address, $comment2) = parse_email($author);
293948ca2d8aSDwaipayan Ray
2940046fc741SMimi Zohar					if (lc $email_address eq lc $author_address && $email_name eq $author_name) {
294148ca2d8aSDwaipayan Ray						$author_sob = $ctx;
294248ca2d8aSDwaipayan Ray						$authorsignoff = 2;
2943046fc741SMimi Zohar					} elsif (lc $email_address eq lc $author_address) {
294448ca2d8aSDwaipayan Ray						$author_sob = $ctx;
294548ca2d8aSDwaipayan Ray						$authorsignoff = 3;
294648ca2d8aSDwaipayan Ray					} elsif ($email_name eq $author_name) {
294748ca2d8aSDwaipayan Ray						$author_sob = $ctx;
294848ca2d8aSDwaipayan Ray						$authorsignoff = 4;
294948ca2d8aSDwaipayan Ray
295048ca2d8aSDwaipayan Ray						my $address1 = $email_address;
295148ca2d8aSDwaipayan Ray						my $address2 = $author_address;
295248ca2d8aSDwaipayan Ray
295348ca2d8aSDwaipayan Ray						if ($address1 =~ /(\S+)\+\S+(\@.*)/) {
295448ca2d8aSDwaipayan Ray							$address1 = "$1$2";
295548ca2d8aSDwaipayan Ray						}
295648ca2d8aSDwaipayan Ray						if ($address2 =~ /(\S+)\+\S+(\@.*)/) {
295748ca2d8aSDwaipayan Ray							$address2 = "$1$2";
295848ca2d8aSDwaipayan Ray						}
295948ca2d8aSDwaipayan Ray						if ($address1 eq $address2) {
296048ca2d8aSDwaipayan Ray							$authorsignoff = 5;
296148ca2d8aSDwaipayan Ray						}
296248ca2d8aSDwaipayan Ray					}
2963cd261496SGeert Uytterhoeven				}
2964cd261496SGeert Uytterhoeven			}
29650a920b5bSAndy Whitcroft		}
296620112475SJoe Perches
296744d303ebSJoe Perches# Check for patch separator
296844d303ebSJoe Perches		if ($line =~ /^---$/) {
296944d303ebSJoe Perches			$has_patch_separator = 1;
297044d303ebSJoe Perches			$in_commit_log = 0;
297144d303ebSJoe Perches		}
297244d303ebSJoe Perches
2973e0d975b1SJoe Perches# Check if MAINTAINERS is being updated.  If so, there's probably no need to
2974e0d975b1SJoe Perches# emit the "does MAINTAINERS need updating?" message on file add/move/delete
2975e0d975b1SJoe Perches		if ($line =~ /^\s*MAINTAINERS\s*\|/) {
2976e0d975b1SJoe Perches			$reported_maintainer_file = 1;
2977e0d975b1SJoe Perches		}
2978e0d975b1SJoe Perches
297920112475SJoe Perches# Check signature styles
2980270c49a0SJoe Perches		if (!$in_header_lines &&
2981ce0338dfSJoe Perches		    $line =~ /^(\s*)([a-z0-9_-]+by:|$signature_tags)(\s*)(.*)/i) {
298220112475SJoe Perches			my $space_before = $1;
298320112475SJoe Perches			my $sign_off = $2;
298420112475SJoe Perches			my $space_after = $3;
298520112475SJoe Perches			my $email = $4;
298620112475SJoe Perches			my $ucfirst_sign_off = ucfirst(lc($sign_off));
298720112475SJoe Perches
2988ce0338dfSJoe Perches			if ($sign_off !~ /$signature_tags/) {
2989831242abSAditya Srivastava				my $suggested_signature = find_standard_signature($sign_off);
2990831242abSAditya Srivastava				if ($suggested_signature eq "") {
2991ce0338dfSJoe Perches					WARN("BAD_SIGN_OFF",
2992ce0338dfSJoe Perches					     "Non-standard signature: $sign_off\n" . $herecurr);
2993831242abSAditya Srivastava				} else {
2994831242abSAditya Srivastava					if (WARN("BAD_SIGN_OFF",
2995831242abSAditya Srivastava						 "Non-standard signature: '$sign_off' - perhaps '$suggested_signature'?\n" . $herecurr) &&
2996831242abSAditya Srivastava					    $fix) {
2997831242abSAditya Srivastava						$fixed[$fixlinenr] =~ s/$sign_off/$suggested_signature/;
2998831242abSAditya Srivastava					}
2999831242abSAditya Srivastava				}
3000ce0338dfSJoe Perches			}
300120112475SJoe Perches			if (defined $space_before && $space_before ne "") {
30023705ce5bSJoe Perches				if (WARN("BAD_SIGN_OFF",
30033705ce5bSJoe Perches					 "Do not use whitespace before $ucfirst_sign_off\n" . $herecurr) &&
30043705ce5bSJoe Perches				    $fix) {
3005194f66fcSJoe Perches					$fixed[$fixlinenr] =
30063705ce5bSJoe Perches					    "$ucfirst_sign_off $email";
30073705ce5bSJoe Perches				}
300820112475SJoe Perches			}
300920112475SJoe Perches			if ($sign_off =~ /-by:$/i && $sign_off ne $ucfirst_sign_off) {
30103705ce5bSJoe Perches				if (WARN("BAD_SIGN_OFF",
30113705ce5bSJoe Perches					 "'$ucfirst_sign_off' is the preferred signature form\n" . $herecurr) &&
30123705ce5bSJoe Perches				    $fix) {
3013194f66fcSJoe Perches					$fixed[$fixlinenr] =
30143705ce5bSJoe Perches					    "$ucfirst_sign_off $email";
30153705ce5bSJoe Perches				}
30163705ce5bSJoe Perches
301720112475SJoe Perches			}
301820112475SJoe Perches			if (!defined $space_after || $space_after ne " ") {
30193705ce5bSJoe Perches				if (WARN("BAD_SIGN_OFF",
30203705ce5bSJoe Perches					 "Use a single space after $ucfirst_sign_off\n" . $herecurr) &&
30213705ce5bSJoe Perches				    $fix) {
3022194f66fcSJoe Perches					$fixed[$fixlinenr] =
30233705ce5bSJoe Perches					    "$ucfirst_sign_off $email";
30243705ce5bSJoe Perches				}
302520112475SJoe Perches			}
302620112475SJoe Perches
3027dfa05c28SJoe Perches			my ($email_name, $name_comment, $email_address, $comment) = parse_email($email);
302848ca2d8aSDwaipayan Ray			my $suggested_email = format_email(($email_name, $name_comment, $email_address, $comment));
302920112475SJoe Perches			if ($suggested_email eq "") {
3030000d1cc1SJoe Perches				ERROR("BAD_SIGN_OFF",
3031000d1cc1SJoe Perches				      "Unrecognized email address: '$email'\n" . $herecurr);
303220112475SJoe Perches			} else {
303320112475SJoe Perches				my $dequoted = $suggested_email;
303420112475SJoe Perches				$dequoted =~ s/^"//;
303520112475SJoe Perches				$dequoted =~ s/" </ </;
303620112475SJoe Perches				# Don't force email to have quotes
303720112475SJoe Perches				# Allow just an angle bracketed address
3038fccaebf0SDwaipayan Ray				if (!same_email_addresses($email, $suggested_email)) {
3039fccaebf0SDwaipayan Ray					if (WARN("BAD_SIGN_OFF",
3040fccaebf0SDwaipayan Ray						 "email address '$email' might be better as '$suggested_email'\n" . $herecurr) &&
3041fccaebf0SDwaipayan Ray					    $fix) {
3042fccaebf0SDwaipayan Ray						$fixed[$fixlinenr] =~ s/\Q$email\E/$suggested_email/;
3043fccaebf0SDwaipayan Ray					}
3044fccaebf0SDwaipayan Ray				}
3045fccaebf0SDwaipayan Ray
3046fccaebf0SDwaipayan Ray				# Address part shouldn't have comments
3047fccaebf0SDwaipayan Ray				my $stripped_address = $email_address;
3048fccaebf0SDwaipayan Ray				$stripped_address =~ s/\([^\(\)]*\)//g;
3049fccaebf0SDwaipayan Ray				if ($email_address ne $stripped_address) {
3050fccaebf0SDwaipayan Ray					if (WARN("BAD_SIGN_OFF",
3051fccaebf0SDwaipayan Ray						 "address part of email should not have comments: '$email_address'\n" . $herecurr) &&
3052fccaebf0SDwaipayan Ray					    $fix) {
3053fccaebf0SDwaipayan Ray						$fixed[$fixlinenr] =~ s/\Q$email_address\E/$stripped_address/;
3054fccaebf0SDwaipayan Ray					}
3055fccaebf0SDwaipayan Ray				}
3056fccaebf0SDwaipayan Ray
3057fccaebf0SDwaipayan Ray				# Only one name comment should be allowed
3058fccaebf0SDwaipayan Ray				my $comment_count = () = $name_comment =~ /\([^\)]+\)/g;
3059fccaebf0SDwaipayan Ray				if ($comment_count > 1) {
3060000d1cc1SJoe Perches					WARN("BAD_SIGN_OFF",
3061fccaebf0SDwaipayan Ray					     "Use a single name comment in email: '$email'\n" . $herecurr);
3062fccaebf0SDwaipayan Ray				}
3063fccaebf0SDwaipayan Ray
3064fccaebf0SDwaipayan Ray
3065fccaebf0SDwaipayan Ray				# [email protected] or [email protected] shouldn't
3066e73d2715SDwaipayan Ray				# have an email name. In addition comments should strictly
3067fccaebf0SDwaipayan Ray				# begin with a #
3068fccaebf0SDwaipayan Ray				if ($email =~ /^.*stable\@(?:vger\.)?kernel\.org/i) {
3069fccaebf0SDwaipayan Ray					if (($comment ne "" && $comment !~ /^#.+/) ||
3070fccaebf0SDwaipayan Ray					    ($email_name ne "")) {
3071fccaebf0SDwaipayan Ray						my $cur_name = $email_name;
3072fccaebf0SDwaipayan Ray						my $new_comment = $comment;
3073fccaebf0SDwaipayan Ray						$cur_name =~ s/[a-zA-Z\s\-\"]+//g;
3074fccaebf0SDwaipayan Ray
3075fccaebf0SDwaipayan Ray						# Remove brackets enclosing comment text
3076fccaebf0SDwaipayan Ray						# and # from start of comments to get comment text
3077fccaebf0SDwaipayan Ray						$new_comment =~ s/^\((.*)\)$/$1/;
3078fccaebf0SDwaipayan Ray						$new_comment =~ s/^\[(.*)\]$/$1/;
3079fccaebf0SDwaipayan Ray						$new_comment =~ s/^[\s\#]+|\s+$//g;
3080fccaebf0SDwaipayan Ray
3081fccaebf0SDwaipayan Ray						$new_comment = trim("$new_comment $cur_name") if ($cur_name ne $new_comment);
3082fccaebf0SDwaipayan Ray						$new_comment = " # $new_comment" if ($new_comment ne "");
3083fccaebf0SDwaipayan Ray						my $new_email = "$email_address$new_comment";
3084fccaebf0SDwaipayan Ray
3085fccaebf0SDwaipayan Ray						if (WARN("BAD_STABLE_ADDRESS_STYLE",
3086fccaebf0SDwaipayan Ray							 "Invalid email format for stable: '$email', prefer '$new_email'\n" . $herecurr) &&
3087fccaebf0SDwaipayan Ray						    $fix) {
3088fccaebf0SDwaipayan Ray							$fixed[$fixlinenr] =~ s/\Q$email\E/$new_email/;
3089fccaebf0SDwaipayan Ray						}
3090fccaebf0SDwaipayan Ray					}
3091fccaebf0SDwaipayan Ray				} elsif ($comment ne "" && $comment !~ /^(?:#.+|\(.+\))$/) {
3092fccaebf0SDwaipayan Ray					my $new_comment = $comment;
3093fccaebf0SDwaipayan Ray
3094fccaebf0SDwaipayan Ray					# Extract comment text from within brackets or
3095fccaebf0SDwaipayan Ray					# c89 style /*...*/ comments
3096fccaebf0SDwaipayan Ray					$new_comment =~ s/^\[(.*)\]$/$1/;
3097fccaebf0SDwaipayan Ray					$new_comment =~ s/^\/\*(.*)\*\/$/$1/;
3098fccaebf0SDwaipayan Ray
3099fccaebf0SDwaipayan Ray					$new_comment = trim($new_comment);
3100fccaebf0SDwaipayan Ray					$new_comment =~ s/^[^\w]$//; # Single lettered comment with non word character is usually a typo
3101fccaebf0SDwaipayan Ray					$new_comment = "($new_comment)" if ($new_comment ne "");
3102fccaebf0SDwaipayan Ray					my $new_email = format_email($email_name, $name_comment, $email_address, $new_comment);
3103fccaebf0SDwaipayan Ray
3104fccaebf0SDwaipayan Ray					if (WARN("BAD_SIGN_OFF",
3105fccaebf0SDwaipayan Ray						 "Unexpected content after email: '$email', should be: '$new_email'\n" . $herecurr) &&
3106fccaebf0SDwaipayan Ray					    $fix) {
3107fccaebf0SDwaipayan Ray						$fixed[$fixlinenr] =~ s/\Q$email\E/$new_email/;
3108fccaebf0SDwaipayan Ray					}
310920112475SJoe Perches				}
31100a920b5bSAndy Whitcroft			}
31117e51f197SJoe Perches
31127e51f197SJoe Perches# Check for duplicate signatures
31137e51f197SJoe Perches			my $sig_nospace = $line;
31147e51f197SJoe Perches			$sig_nospace =~ s/\s//g;
31157e51f197SJoe Perches			$sig_nospace = lc($sig_nospace);
31167e51f197SJoe Perches			if (defined $signatures{$sig_nospace}) {
31177e51f197SJoe Perches				WARN("BAD_SIGN_OFF",
31187e51f197SJoe Perches				     "Duplicate signature\n" . $herecurr);
31197e51f197SJoe Perches			} else {
31207e51f197SJoe Perches				$signatures{$sig_nospace} = 1;
31217e51f197SJoe Perches			}
31226c5d24eeSSean Christopherson
31236c5d24eeSSean Christopherson# Check Co-developed-by: immediately followed by Signed-off-by: with same name and email
31246c5d24eeSSean Christopherson			if ($sign_off =~ /^co-developed-by:$/i) {
31256c5d24eeSSean Christopherson				if ($email eq $author) {
31266c5d24eeSSean Christopherson					WARN("BAD_SIGN_OFF",
31276c5d24eeSSean Christopherson					      "Co-developed-by: should not be used to attribute nominal patch author '$author'\n" . "$here\n" . $rawline);
31286c5d24eeSSean Christopherson				}
31296c5d24eeSSean Christopherson				if (!defined $lines[$linenr]) {
31306c5d24eeSSean Christopherson					WARN("BAD_SIGN_OFF",
31316c5d24eeSSean Christopherson					     "Co-developed-by: must be immediately followed by Signed-off-by:\n" . "$here\n" . $rawline);
31326c5d24eeSSean Christopherson				} elsif ($rawlines[$linenr] !~ /^\s*signed-off-by:\s*(.*)/i) {
31336c5d24eeSSean Christopherson					WARN("BAD_SIGN_OFF",
31346c5d24eeSSean Christopherson					     "Co-developed-by: must be immediately followed by Signed-off-by:\n" . "$here\n" . $rawline . "\n" .$rawlines[$linenr]);
31356c5d24eeSSean Christopherson				} elsif ($1 ne $email) {
31366c5d24eeSSean Christopherson					WARN("BAD_SIGN_OFF",
31376c5d24eeSSean Christopherson					     "Co-developed-by and Signed-off-by: name/email do not match \n" . "$here\n" . $rawline . "\n" .$rawlines[$linenr]);
31386c5d24eeSSean Christopherson				}
31396c5d24eeSSean Christopherson			}
31400a920b5bSAndy Whitcroft		}
31410a920b5bSAndy Whitcroft
3142a2fe16b9SJoe Perches# Check email subject for common tools that don't need to be mentioned
3143a2fe16b9SJoe Perches		if ($in_header_lines &&
3144a2fe16b9SJoe Perches		    $line =~ /^Subject:.*\b(?:checkpatch|sparse|smatch)\b[^:]/i) {
3145a2fe16b9SJoe Perches			WARN("EMAIL_SUBJECT",
3146a2fe16b9SJoe Perches			     "A patch subject line should describe the change not the tool that found it\n" . $herecurr);
3147a2fe16b9SJoe Perches		}
3148a2fe16b9SJoe Perches
314944d303ebSJoe Perches# Check for Gerrit Change-Ids not in any patch context
315044d303ebSJoe Perches		if ($realfile eq '' && !$has_patch_separator && $line =~ /^\s*change-id:/i) {
31517580c5b9SAditya Srivastava			if (ERROR("GERRIT_CHANGE_ID",
31527580c5b9SAditya Srivastava			          "Remove Gerrit Change-Id's before submitting upstream\n" . $herecurr) &&
31537580c5b9SAditya Srivastava			    $fix) {
31547580c5b9SAditya Srivastava				fix_delete_line($fixlinenr, $rawline);
31557580c5b9SAditya Srivastava			}
31567ebd05efSChristopher Covington		}
31577ebd05efSChristopher Covington
3158369c8dd3SJoe Perches# Check if the commit log is in a possible stack dump
3159369c8dd3SJoe Perches		if ($in_commit_log && !$commit_log_possible_stack_dump &&
3160369c8dd3SJoe Perches		    ($line =~ /^\s*(?:WARNING:|BUG:)/ ||
3161369c8dd3SJoe Perches		     $line =~ /^\s*\[\s*\d+\.\d{6,6}\s*\]/ ||
3162369c8dd3SJoe Perches					# timestamp
3163634cffccSJoe Perches		     $line =~ /^\s*\[\<[0-9a-fA-F]{8,}\>\]/) ||
3164634cffccSJoe Perches		     $line =~ /^(?:\s+\w+:\s+[0-9a-fA-F]+){3,3}/ ||
3165634cffccSJoe Perches		     $line =~ /^\s*\#\d+\s*\[[0-9a-fA-F]+\]\s*\w+ at [0-9a-fA-F]+/) {
3166634cffccSJoe Perches					# stack dump address styles
3167369c8dd3SJoe Perches			$commit_log_possible_stack_dump = 1;
3168369c8dd3SJoe Perches		}
3169369c8dd3SJoe Perches
31702a076f40SJoe Perches# Check for line lengths > 75 in commit log, warn once
31712a076f40SJoe Perches		if ($in_commit_log && !$commit_log_long_line &&
3172bf4daf12SJoe Perches		    length($line) > 75 &&
3173bf4daf12SJoe Perches		    !($line =~ /^\s*[a-zA-Z0-9_\/\.]+\s+\|\s+\d+/ ||
3174bf4daf12SJoe Perches					# file delta changes
317536f8b348SJerome Forissier		      $line =~ /^\s*(?:[\w\.\-\+]*\/)++[\w\.\-\+]+:/ ||
3176bf4daf12SJoe Perches					# filename then :
317727b379afSAditya Srivastava		      $line =~ /^\s*(?:Fixes:|Link:|$signature_tags)/i ||
317827b379afSAditya Srivastava					# A Fixes: or Link: line or signature tag line
3179bf4daf12SJoe Perches		      $commit_log_possible_stack_dump)) {
31802a076f40SJoe Perches			WARN("COMMIT_LOG_LONG_LINE",
31812a076f40SJoe Perches			     "Possible unwrapped commit description (prefer a maximum 75 chars per line)\n" . $herecurr);
31822a076f40SJoe Perches			$commit_log_long_line = 1;
31832a076f40SJoe Perches		}
31842a076f40SJoe Perches
3185bf4daf12SJoe Perches# Reset possible stack dump if a blank line is found
3186bf4daf12SJoe Perches		if ($in_commit_log && $commit_log_possible_stack_dump &&
3187bf4daf12SJoe Perches		    $line =~ /^\s*$/) {
3188bf4daf12SJoe Perches			$commit_log_possible_stack_dump = 0;
3189bf4daf12SJoe Perches		}
3190bf4daf12SJoe Perches
3191084a617aSDwaipayan Ray# Check for lines starting with a #
3192084a617aSDwaipayan Ray		if ($in_commit_log && $line =~ /^#/) {
3193084a617aSDwaipayan Ray			if (WARN("COMMIT_COMMENT_SYMBOL",
3194084a617aSDwaipayan Ray				 "Commit log lines starting with '#' are dropped by git as comments\n" . $herecurr) &&
3195084a617aSDwaipayan Ray			    $fix) {
3196084a617aSDwaipayan Ray				$fixed[$fixlinenr] =~ s/^/ /;
3197084a617aSDwaipayan Ray			}
3198084a617aSDwaipayan Ray		}
3199084a617aSDwaipayan Ray
32000d7835fcSJoe Perches# Check for git id commit length and improperly formed commit descriptions
32014ce9f970SJoe Perches# A correctly formed commit description is:
32024ce9f970SJoe Perches#    commit <SHA-1 hash length 12+ chars> ("Complete commit subject")
32034ce9f970SJoe Perches# with the commit subject '("' prefix and '")' suffix
32044ce9f970SJoe Perches# This is a fairly compilicated block as it tests for what appears to be
32054ce9f970SJoe Perches# bare SHA-1 hash with  minimum length of 5.  It also avoids several types of
32064ce9f970SJoe Perches# possible SHA-1 matches.
32074ce9f970SJoe Perches# A commit match can span multiple lines so this block attempts to find a
32084ce9f970SJoe Perches# complete typical commit on a maximum of 3 lines
32094ce9f970SJoe Perches		if ($perl_version_ok &&
32104ce9f970SJoe Perches		    $in_commit_log && !$commit_log_possible_stack_dump &&
3211a8972573SJohn Hubbard		    $line !~ /^\s*(?:Link|Patchwork|http|https|BugLink|base-commit):/i &&
3212e882dbfcSWei Wang		    $line !~ /^This reverts commit [0-9a-f]{7,40}/ &&
32134ce9f970SJoe Perches		    (($line =~ /\bcommit\s+[0-9a-f]{5,}\b/i ||
32144ce9f970SJoe Perches		      ($line =~ /\bcommit\s*$/i && defined($rawlines[$linenr]) && $rawlines[$linenr] =~ /^\s*[0-9a-f]{5,}\b/i)) ||
3215aab38f51SJoe Perches		     ($line =~ /(?:\s|^)[0-9a-f]{12,40}(?:[\s"'\(\[]|$)/i &&
3216369c8dd3SJoe Perches		      $line !~ /[\<\[][0-9a-f]{12,40}[\>\]]/i &&
3217bf4daf12SJoe Perches		      $line !~ /\bfixes:\s*[0-9a-f]{12,40}/i))) {
3218fe043ea1SJoe Perches			my $init_char = "c";
3219fe043ea1SJoe Perches			my $orig_commit = "";
32200d7835fcSJoe Perches			my $short = 1;
32210d7835fcSJoe Perches			my $long = 0;
32220d7835fcSJoe Perches			my $case = 1;
32230d7835fcSJoe Perches			my $space = 1;
32240d7835fcSJoe Perches			my $id = '0123456789ab';
32250d7835fcSJoe Perches			my $orig_desc = "commit description";
32260d7835fcSJoe Perches			my $description = "";
32274ce9f970SJoe Perches			my $herectx = $herecurr;
32284ce9f970SJoe Perches			my $has_parens = 0;
32294ce9f970SJoe Perches			my $has_quotes = 0;
32300d7835fcSJoe Perches
32314ce9f970SJoe Perches			my $input = $line;
32324ce9f970SJoe Perches			if ($line =~ /(?:\bcommit\s+[0-9a-f]{5,}|\bcommit\s*$)/i) {
32334ce9f970SJoe Perches				for (my $n = 0; $n < 2; $n++) {
32344ce9f970SJoe Perches					if ($input =~ /\bcommit\s+[0-9a-f]{5,}\s*($balanced_parens)/i) {
32354ce9f970SJoe Perches						$orig_desc = $1;
32364ce9f970SJoe Perches						$has_parens = 1;
32374ce9f970SJoe Perches						# Always strip leading/trailing parens then double quotes if existing
32384ce9f970SJoe Perches						$orig_desc = substr($orig_desc, 1, -1);
32394ce9f970SJoe Perches						if ($orig_desc =~ /^".*"$/) {
32404ce9f970SJoe Perches							$orig_desc = substr($orig_desc, 1, -1);
32414ce9f970SJoe Perches							$has_quotes = 1;
32424ce9f970SJoe Perches						}
32434ce9f970SJoe Perches						last;
32444ce9f970SJoe Perches					}
32454ce9f970SJoe Perches					last if ($#lines < $linenr + $n);
32464ce9f970SJoe Perches					$input .= " " . trim($rawlines[$linenr + $n]);
32474ce9f970SJoe Perches					$herectx .= "$rawlines[$linenr + $n]\n";
32484ce9f970SJoe Perches				}
32494ce9f970SJoe Perches				$herectx = $herecurr if (!$has_parens);
3250fe043ea1SJoe Perches			}
3251fe043ea1SJoe Perches
32524ce9f970SJoe Perches			if ($input =~ /\b(c)ommit\s+([0-9a-f]{5,})\b/i) {
32534ce9f970SJoe Perches				$init_char = $1;
32544ce9f970SJoe Perches				$orig_commit = lc($2);
32554ce9f970SJoe Perches				$short = 0 if ($input =~ /\bcommit\s+[0-9a-f]{12,40}/i);
32564ce9f970SJoe Perches				$long = 1 if ($input =~ /\bcommit\s+[0-9a-f]{41,}/i);
32574ce9f970SJoe Perches				$space = 0 if ($input =~ /\bcommit [0-9a-f]/i);
32584ce9f970SJoe Perches				$case = 0 if ($input =~ /\b[Cc]ommit\s+[0-9a-f]{5,40}[^A-F]/);
32594ce9f970SJoe Perches			} elsif ($input =~ /\b([0-9a-f]{12,40})\b/i) {
32604ce9f970SJoe Perches				$orig_commit = lc($1);
32610d7835fcSJoe Perches			}
32620d7835fcSJoe Perches
32630d7835fcSJoe Perches			($id, $description) = git_commit_info($orig_commit,
32640d7835fcSJoe Perches							      $id, $orig_desc);
32650d7835fcSJoe Perches
3266948b133aSHeinrich Schuchardt			if (defined($id) &&
32674ce9f970SJoe Perches			    ($short || $long || $space || $case || ($orig_desc ne $description) || !$has_quotes) &&
32684ce9f970SJoe Perches			    $last_git_commit_id_linenr != $linenr - 1) {
3269d311cd44SJoe Perches				ERROR("GIT_COMMIT_ID",
32704ce9f970SJoe Perches				      "Please use git commit description style 'commit <12+ chars of sha1> (\"<title line>\")' - ie: '${init_char}ommit $id (\"$description\")'\n" . $herectx);
32710d7835fcSJoe Perches			}
32724ce9f970SJoe Perches			#don't report the next line if this line ends in commit and the sha1 hash is the next line
32734ce9f970SJoe Perches			$last_git_commit_id_linenr = $linenr if ($line =~ /\bcommit\s*$/i);
3274d311cd44SJoe Perches		}
3275d311cd44SJoe Perches
327613f1937eSJoe Perches# Check for added, moved or deleted files
327713f1937eSJoe Perches		if (!$reported_maintainer_file && !$in_commit_log &&
327813f1937eSJoe Perches		    ($line =~ /^(?:new|deleted) file mode\s*\d+\s*$/ ||
327913f1937eSJoe Perches		     $line =~ /^rename (?:from|to) [\w\/\.\-]+\s*$/ ||
328013f1937eSJoe Perches		     ($line =~ /\{\s*([\w\/\.\-]*)\s*\=\>\s*([\w\/\.\-]*)\s*\}/ &&
328113f1937eSJoe Perches		      (defined($1) || defined($2))))) {
3282a82603a8SAndrew Jeffery			$is_patch = 1;
328313f1937eSJoe Perches			$reported_maintainer_file = 1;
328413f1937eSJoe Perches			WARN("FILE_PATH_CHANGES",
328513f1937eSJoe Perches			     "added, moved or deleted file(s), does MAINTAINERS need updating?\n" . $herecurr);
328613f1937eSJoe Perches		}
328713f1937eSJoe Perches
3288e400edb1SRob Herring# Check for adding new DT bindings not in schema format
3289e400edb1SRob Herring		if (!$in_commit_log &&
3290e400edb1SRob Herring		    ($line =~ /^new file mode\s*\d+\s*$/) &&
3291e400edb1SRob Herring		    ($realfile =~ m@^Documentation/devicetree/bindings/.*\.txt$@)) {
3292e400edb1SRob Herring			WARN("DT_SCHEMA_BINDING_PATCH",
329356ddc4cdSMauro Carvalho Chehab			     "DT bindings should be in DT schema format. See: Documentation/devicetree/bindings/writing-schema.rst\n");
3294e400edb1SRob Herring		}
3295e400edb1SRob Herring
329600df344fSAndy Whitcroft# Check for wrappage within a valid hunk of the file
32978905a67cSAndy Whitcroft		if ($realcnt != 0 && $line !~ m{^(?:\+|-| |\\ No newline|$)}) {
3298000d1cc1SJoe Perches			ERROR("CORRUPTED_PATCH",
3299000d1cc1SJoe Perches			      "patch seems to be corrupt (line wrapped?)\n" .
33006c72ffaaSAndy Whitcroft				$herecurr) if (!$emitted_corrupt++);
3301de7d4f0eSAndy Whitcroft		}
3302de7d4f0eSAndy Whitcroft
3303de7d4f0eSAndy Whitcroft# UTF-8 regex found at http://www.w3.org/International/questions/qa-forms-utf-8.en.php
3304de7d4f0eSAndy Whitcroft		if (($realfile =~ /^$/ || $line =~ /^\+/) &&
3305171ae1a4SAndy Whitcroft		    $rawline !~ m/^$UTF8*$/) {
3306171ae1a4SAndy Whitcroft			my ($utf8_prefix) = ($rawline =~ /^($UTF8*)/);
3307171ae1a4SAndy Whitcroft
3308171ae1a4SAndy Whitcroft			my $blank = copy_spacing($rawline);
3309171ae1a4SAndy Whitcroft			my $ptr = substr($blank, 0, length($utf8_prefix)) . "^";
3310171ae1a4SAndy Whitcroft			my $hereptr = "$hereline$ptr\n";
3311171ae1a4SAndy Whitcroft
331234d99219SJoe Perches			CHK("INVALID_UTF8",
3313000d1cc1SJoe Perches			    "Invalid UTF-8, patch and commit message should be encoded in UTF-8\n" . $hereptr);
331400df344fSAndy Whitcroft		}
33150a920b5bSAndy Whitcroft
331615662b3eSJoe Perches# Check if it's the start of a commit log
331715662b3eSJoe Perches# (not a header line and we haven't seen the patch filename)
331815662b3eSJoe Perches		if ($in_header_lines && $realfile =~ /^$/ &&
3319eb3a58deSJoe Perches		    !($rawline =~ /^\s+(?:\S|$)/ ||
3320eb3a58deSJoe Perches		      $rawline =~ /^(?:commit\b|from\b|[\w-]+:)/i)) {
332115662b3eSJoe Perches			$in_header_lines = 0;
332215662b3eSJoe Perches			$in_commit_log = 1;
3323ed43c4e5SAllen Hubbe			$has_commit_log = 1;
332415662b3eSJoe Perches		}
332515662b3eSJoe Perches
3326fa64205dSPasi Savanainen# Check if there is UTF-8 in a commit log when a mail header has explicitly
3327fa64205dSPasi Savanainen# declined it, i.e defined some charset where it is missing.
3328fa64205dSPasi Savanainen		if ($in_header_lines &&
3329fa64205dSPasi Savanainen		    $rawline =~ /^Content-Type:.+charset="(.+)".*$/ &&
3330fa64205dSPasi Savanainen		    $1 !~ /utf-8/i) {
3331fa64205dSPasi Savanainen			$non_utf8_charset = 1;
3332fa64205dSPasi Savanainen		}
3333fa64205dSPasi Savanainen
3334fa64205dSPasi Savanainen		if ($in_commit_log && $non_utf8_charset && $realfile =~ /^$/ &&
333515662b3eSJoe Perches		    $rawline =~ /$NON_ASCII_UTF8/) {
3336fa64205dSPasi Savanainen			WARN("UTF8_BEFORE_PATCH",
333715662b3eSJoe Perches			    "8-bit UTF-8 used in possible commit log\n" . $herecurr);
333815662b3eSJoe Perches		}
333915662b3eSJoe Perches
3340d6430f71SJoe Perches# Check for absolute kernel paths in commit message
3341d6430f71SJoe Perches		if ($tree && $in_commit_log) {
3342d6430f71SJoe Perches			while ($line =~ m{(?:^|\s)(/\S*)}g) {
3343d6430f71SJoe Perches				my $file = $1;
3344d6430f71SJoe Perches
3345d6430f71SJoe Perches				if ($file =~ m{^(.*?)(?::\d+)+:?$} &&
3346d6430f71SJoe Perches				    check_absolute_file($1, $herecurr)) {
3347d6430f71SJoe Perches					#
3348d6430f71SJoe Perches				} else {
3349d6430f71SJoe Perches					check_absolute_file($file, $herecurr);
3350d6430f71SJoe Perches				}
3351d6430f71SJoe Perches			}
3352d6430f71SJoe Perches		}
3353d6430f71SJoe Perches
335466b47b4aSKees Cook# Check for various typo / spelling mistakes
335566d7a382SJoe Perches		if (defined($misspellings) &&
335666d7a382SJoe Perches		    ($in_commit_log || $line =~ /^(?:\+|Subject:)/i)) {
33577da07c31SDwaipayan Ray			while ($rawline =~ /(?:^|[^\w\-'`])($misspellings)(?:[^\w\-'`]|$)/gi) {
335866b47b4aSKees Cook				my $typo = $1;
33597da07c31SDwaipayan Ray				my $blank = copy_spacing($rawline);
33607da07c31SDwaipayan Ray				my $ptr = substr($blank, 0, $-[1]) . "^" x length($typo);
33617da07c31SDwaipayan Ray				my $hereptr = "$hereline$ptr\n";
336266b47b4aSKees Cook				my $typo_fix = $spelling_fix{lc($typo)};
336366b47b4aSKees Cook				$typo_fix = ucfirst($typo_fix) if ($typo =~ /^[A-Z]/);
336466b47b4aSKees Cook				$typo_fix = uc($typo_fix) if ($typo =~ /^[A-Z]+$/);
33650675a8fbSJean Delvare				my $msg_level = \&WARN;
33660675a8fbSJean Delvare				$msg_level = \&CHK if ($file);
33670675a8fbSJean Delvare				if (&{$msg_level}("TYPO_SPELLING",
33687da07c31SDwaipayan Ray						  "'$typo' may be misspelled - perhaps '$typo_fix'?\n" . $hereptr) &&
336966b47b4aSKees Cook				    $fix) {
337066b47b4aSKees Cook					$fixed[$fixlinenr] =~ s/(^|[^A-Za-z@])($typo)($|[^A-Za-z@])/$1$typo_fix$3/;
337166b47b4aSKees Cook				}
337266b47b4aSKees Cook			}
337366b47b4aSKees Cook		}
337466b47b4aSKees Cook
3375a8dd86bfSMatteo Croce# check for invalid commit id
3376a8dd86bfSMatteo Croce		if ($in_commit_log && $line =~ /(^fixes:|\bcommit)\s+([0-9a-f]{6,40})\b/i) {
3377a8dd86bfSMatteo Croce			my $id;
3378a8dd86bfSMatteo Croce			my $description;
3379a8dd86bfSMatteo Croce			($id, $description) = git_commit_info($2, undef, undef);
3380a8dd86bfSMatteo Croce			if (!defined($id)) {
3381a8dd86bfSMatteo Croce				WARN("UNKNOWN_COMMIT_ID",
3382a8dd86bfSMatteo Croce				     "Unknown commit id '$2', maybe rebased or not pulled?\n" . $herecurr);
3383a8dd86bfSMatteo Croce			}
3384a8dd86bfSMatteo Croce		}
3385a8dd86bfSMatteo Croce
3386310cd06bSJoe Perches# check for repeated words separated by a single space
33878d0325ccSAditya Srivastava# avoid false positive from list command eg, '-rw-r--r-- 1 root root'
33888d0325ccSAditya Srivastava		if (($rawline =~ /^\+/ || $in_commit_log) &&
33898d0325ccSAditya Srivastava		    $rawline !~ /[bcCdDlMnpPs\?-][rwxsStT-]{9}/) {
33901db81a68SDwaipayan Ray			pos($rawline) = 1 if (!$in_commit_log);
3391310cd06bSJoe Perches			while ($rawline =~ /\b($word_pattern) (?=($word_pattern))/g) {
3392310cd06bSJoe Perches
3393310cd06bSJoe Perches				my $first = $1;
3394310cd06bSJoe Perches				my $second = $2;
33951db81a68SDwaipayan Ray				my $start_pos = $-[1];
33961db81a68SDwaipayan Ray				my $end_pos = $+[2];
3397310cd06bSJoe Perches				if ($first =~ /(?:struct|union|enum)/) {
3398310cd06bSJoe Perches					pos($rawline) += length($first) + length($second) + 1;
3399310cd06bSJoe Perches					next;
3400310cd06bSJoe Perches				}
3401310cd06bSJoe Perches
34021db81a68SDwaipayan Ray				next if (lc($first) ne lc($second));
3403310cd06bSJoe Perches				next if ($first eq 'long');
3404310cd06bSJoe Perches
34051db81a68SDwaipayan Ray				# check for character before and after the word matches
34061db81a68SDwaipayan Ray				my $start_char = '';
34071db81a68SDwaipayan Ray				my $end_char = '';
34081db81a68SDwaipayan Ray				$start_char = substr($rawline, $start_pos - 1, 1) if ($start_pos > ($in_commit_log ? 0 : 1));
34091db81a68SDwaipayan Ray				$end_char = substr($rawline, $end_pos, 1) if ($end_pos < length($rawline));
34101db81a68SDwaipayan Ray
34111db81a68SDwaipayan Ray				next if ($start_char =~ /^\S$/);
34121db81a68SDwaipayan Ray				next if (index(" \t.,;?!", $end_char) == -1);
34131db81a68SDwaipayan Ray
34148d0325ccSAditya Srivastava				# avoid repeating hex occurrences like 'ff ff fe 09 ...'
34158d0325ccSAditya Srivastava				if ($first =~ /\b[0-9a-f]{2,}\b/i) {
34168d0325ccSAditya Srivastava					next if (!exists($allow_repeated_words{lc($first)}));
34178d0325ccSAditya Srivastava				}
34188d0325ccSAditya Srivastava
3419310cd06bSJoe Perches				if (WARN("REPEATED_WORD",
3420310cd06bSJoe Perches					 "Possible repeated word: '$first'\n" . $herecurr) &&
3421310cd06bSJoe Perches				    $fix) {
3422310cd06bSJoe Perches					$fixed[$fixlinenr] =~ s/\b$first $second\b/$first/;
3423310cd06bSJoe Perches				}
3424310cd06bSJoe Perches			}
3425310cd06bSJoe Perches
3426310cd06bSJoe Perches			# if it's a repeated word on consecutive lines in a comment block
3427310cd06bSJoe Perches			if ($prevline =~ /$;+\s*$/ &&
3428310cd06bSJoe Perches			    $prevrawline =~ /($word_pattern)\s*$/) {
3429310cd06bSJoe Perches				my $last_word = $1;
3430310cd06bSJoe Perches				if ($rawline =~ /^\+\s*\*\s*$last_word /) {
3431310cd06bSJoe Perches					if (WARN("REPEATED_WORD",
3432310cd06bSJoe Perches						 "Possible repeated word: '$last_word'\n" . $hereprev) &&
3433310cd06bSJoe Perches					    $fix) {
3434310cd06bSJoe Perches						$fixed[$fixlinenr] =~ s/(\+\s*\*\s*)$last_word /$1/;
3435310cd06bSJoe Perches					}
3436310cd06bSJoe Perches				}
3437310cd06bSJoe Perches			}
3438310cd06bSJoe Perches		}
3439310cd06bSJoe Perches
344030670854SAndy Whitcroft# ignore non-hunk lines and lines being removed
344130670854SAndy Whitcroft		next if (!$hunk_line || $line =~ /^-/);
344200df344fSAndy Whitcroft
34430a920b5bSAndy Whitcroft#trailing whitespace
34449c0ca6f9SAndy Whitcroft		if ($line =~ /^\+.*\015/) {
3445c2fdda0dSAndy Whitcroft			my $herevet = "$here\n" . cat_vet($rawline) . "\n";
3446d5e616fcSJoe Perches			if (ERROR("DOS_LINE_ENDINGS",
3447d5e616fcSJoe Perches				  "DOS line endings\n" . $herevet) &&
3448d5e616fcSJoe Perches			    $fix) {
3449194f66fcSJoe Perches				$fixed[$fixlinenr] =~ s/[\s\015]+$//;
3450d5e616fcSJoe Perches			}
3451c2fdda0dSAndy Whitcroft		} elsif ($rawline =~ /^\+.*\S\s+$/ || $rawline =~ /^\+\s+$/) {
3452c2fdda0dSAndy Whitcroft			my $herevet = "$here\n" . cat_vet($rawline) . "\n";
34533705ce5bSJoe Perches			if (ERROR("TRAILING_WHITESPACE",
34543705ce5bSJoe Perches				  "trailing whitespace\n" . $herevet) &&
34553705ce5bSJoe Perches			    $fix) {
3456194f66fcSJoe Perches				$fixed[$fixlinenr] =~ s/\s+$//;
34573705ce5bSJoe Perches			}
34583705ce5bSJoe Perches
3459d2c0a235SAndy Whitcroft			$rpt_cleaners = 1;
34600a920b5bSAndy Whitcroft		}
34615368df20SAndy Whitcroft
34624783f894SJosh Triplett# Check for FSF mailing addresses.
3463109d8cb2SAlexander Duyck		if ($rawline =~ /\bwrite to the Free/i ||
34641bde561eSMatthew Wilcox		    $rawline =~ /\b675\s+Mass\s+Ave/i ||
34653e2232f2SJoe Perches		    $rawline =~ /\b59\s+Temple\s+Pl/i ||
34663e2232f2SJoe Perches		    $rawline =~ /\b51\s+Franklin\s+St/i) {
34674783f894SJosh Triplett			my $herevet = "$here\n" . cat_vet($rawline) . "\n";
34680675a8fbSJean Delvare			my $msg_level = \&ERROR;
34690675a8fbSJean Delvare			$msg_level = \&CHK if ($file);
34700675a8fbSJean Delvare			&{$msg_level}("FSF_MAILING_ADDRESS",
34714783f894SJosh Triplett				      "Do not include the paragraph about writing to the Free Software Foundation's mailing address from the sample GPL notice. The FSF has changed addresses in the past, and may do so again. Linux already includes a copy of the GPL.\n" . $herevet)
34724783f894SJosh Triplett		}
34734783f894SJosh Triplett
34743354957aSAndi Kleen# check for Kconfig help text having a real description
34759fe287d7SAndy Whitcroft# Only applies when adding the entry originally, after that we do not have
34769fe287d7SAndy Whitcroft# sufficient context to determine whether it is indeed long enough.
34773354957aSAndi Kleen		if ($realfile =~ /Kconfig/ &&
3478678ae162SUlf Magnusson		    # 'choice' is usually the last thing on the line (though
3479678ae162SUlf Magnusson		    # Kconfig supports named choices), so use a word boundary
3480678ae162SUlf Magnusson		    # (\b) rather than a whitespace character (\s)
3481678ae162SUlf Magnusson		    $line =~ /^\+\s*(?:config|menuconfig|choice)\b/) {
3482b8709bceSJoe Perches			my $ln = $linenr;
3483b8709bceSJoe Perches			my $needs_help = 0;
3484b8709bceSJoe Perches			my $has_help = 0;
3485b8709bceSJoe Perches			my $help_length = 0;
3486b8709bceSJoe Perches			while (defined $lines[$ln]) {
3487b8709bceSJoe Perches				my $f = $lines[$ln++];
34889fe287d7SAndy Whitcroft
34899fe287d7SAndy Whitcroft				next if ($f =~ /^-/);
3490b8709bceSJoe Perches				last if ($f !~ /^[\+ ]/);	# !patch context
3491a1385803SAndy Whitcroft
3492b8709bceSJoe Perches				if ($f =~ /^\+\s*(?:bool|tristate|prompt)\s*["']/) {
3493b8709bceSJoe Perches					$needs_help = 1;
3494b8709bceSJoe Perches					next;
3495b8709bceSJoe Perches				}
3496b8709bceSJoe Perches				if ($f =~ /^\+\s*help\s*$/) {
3497b8709bceSJoe Perches					$has_help = 1;
3498b8709bceSJoe Perches					next;
3499a1385803SAndy Whitcroft				}
3500a1385803SAndy Whitcroft
3501b8709bceSJoe Perches				$f =~ s/^.//;	# strip patch context [+ ]
3502b8709bceSJoe Perches				$f =~ s/#.*//;	# strip # directives
3503b8709bceSJoe Perches				$f =~ s/^\s+//;	# strip leading blanks
3504b8709bceSJoe Perches				next if ($f =~ /^$/);	# skip blank lines
3505678ae162SUlf Magnusson
3506b8709bceSJoe Perches				# At the end of this Kconfig block:
3507678ae162SUlf Magnusson				# This only checks context lines in the patch
3508678ae162SUlf Magnusson				# and so hopefully shouldn't trigger false
3509678ae162SUlf Magnusson				# positives, even though some of these are
3510678ae162SUlf Magnusson				# common words in help texts
3511b8709bceSJoe Perches				if ($f =~ /^(?:config|menuconfig|choice|endchoice|
3512678ae162SUlf Magnusson					       if|endif|menu|endmenu|source)\b/x) {
35139fe287d7SAndy Whitcroft					last;
35149fe287d7SAndy Whitcroft				}
3515b8709bceSJoe Perches				$help_length++ if ($has_help);
35163354957aSAndi Kleen			}
3517b8709bceSJoe Perches			if ($needs_help &&
3518b8709bceSJoe Perches			    $help_length < $min_conf_desc_length) {
3519b8709bceSJoe Perches				my $stat_real = get_stat_real($linenr, $ln - 1);
3520000d1cc1SJoe Perches				WARN("CONFIG_DESCRIPTION",
3521b8709bceSJoe Perches				     "please write a help paragraph that fully describes the config symbol\n" . "$here\n$stat_real\n");
352256193274SVadim Bendebury			}
35233354957aSAndi Kleen		}
35243354957aSAndi Kleen
35257ccf41a8SJoe Perches# check MAINTAINERS entries
35267ccf41a8SJoe Perches		if ($realfile =~ /^MAINTAINERS$/) {
35277ccf41a8SJoe Perches# check MAINTAINERS entries for the right form
35287ccf41a8SJoe Perches			if ($rawline =~ /^\+[A-Z]:/ &&
3529628f91a2SJoe Perches			    $rawline !~ /^\+[A-Z]:\t\S/) {
3530628f91a2SJoe Perches				if (WARN("MAINTAINERS_STYLE",
3531628f91a2SJoe Perches					 "MAINTAINERS entries use one tab after TYPE:\n" . $herecurr) &&
3532628f91a2SJoe Perches				    $fix) {
3533628f91a2SJoe Perches					$fixed[$fixlinenr] =~ s/^(\+[A-Z]):\s*/$1:\t/;
3534628f91a2SJoe Perches				}
3535628f91a2SJoe Perches			}
35367ccf41a8SJoe Perches# check MAINTAINERS entries for the right ordering too
35377ccf41a8SJoe Perches			my $preferred_order = 'MRLSWQBCPTFXNK';
35387ccf41a8SJoe Perches			if ($rawline =~ /^\+[A-Z]:/ &&
35397ccf41a8SJoe Perches			    $prevrawline =~ /^[\+ ][A-Z]:/) {
35407ccf41a8SJoe Perches				$rawline =~ /^\+([A-Z]):\s*(.*)/;
35417ccf41a8SJoe Perches				my $cur = $1;
35427ccf41a8SJoe Perches				my $curval = $2;
35437ccf41a8SJoe Perches				$prevrawline =~ /^[\+ ]([A-Z]):\s*(.*)/;
35447ccf41a8SJoe Perches				my $prev = $1;
35457ccf41a8SJoe Perches				my $prevval = $2;
35467ccf41a8SJoe Perches				my $curindex = index($preferred_order, $cur);
35477ccf41a8SJoe Perches				my $previndex = index($preferred_order, $prev);
35487ccf41a8SJoe Perches				if ($curindex < 0) {
35497ccf41a8SJoe Perches					WARN("MAINTAINERS_STYLE",
35507ccf41a8SJoe Perches					     "Unknown MAINTAINERS entry type: '$cur'\n" . $herecurr);
35517ccf41a8SJoe Perches				} else {
35527ccf41a8SJoe Perches					if ($previndex >= 0 && $curindex < $previndex) {
35537ccf41a8SJoe Perches						WARN("MAINTAINERS_STYLE",
35547ccf41a8SJoe Perches						     "Misordered MAINTAINERS entry - list '$cur:' before '$prev:'\n" . $hereprev);
35557ccf41a8SJoe Perches					} elsif ((($prev eq 'F' && $cur eq 'F') ||
35567ccf41a8SJoe Perches						  ($prev eq 'X' && $cur eq 'X')) &&
35577ccf41a8SJoe Perches						 ($prevval cmp $curval) > 0) {
35587ccf41a8SJoe Perches						WARN("MAINTAINERS_STYLE",
35597ccf41a8SJoe Perches						     "Misordered MAINTAINERS entry - list file patterns in alphabetic order\n" . $hereprev);
35607ccf41a8SJoe Perches					}
35617ccf41a8SJoe Perches				}
35627ccf41a8SJoe Perches			}
35637ccf41a8SJoe Perches		}
3564628f91a2SJoe Perches
3565c68e5878SArnaud Lacombe		if (($realfile =~ /Makefile.*/ || $realfile =~ /Kbuild.*/) &&
3566c68e5878SArnaud Lacombe		    ($line =~ /\+(EXTRA_[A-Z]+FLAGS).*/)) {
3567c68e5878SArnaud Lacombe			my $flag = $1;
3568c68e5878SArnaud Lacombe			my $replacement = {
3569c68e5878SArnaud Lacombe				'EXTRA_AFLAGS' =>   'asflags-y',
3570c68e5878SArnaud Lacombe				'EXTRA_CFLAGS' =>   'ccflags-y',
3571c68e5878SArnaud Lacombe				'EXTRA_CPPFLAGS' => 'cppflags-y',
3572c68e5878SArnaud Lacombe				'EXTRA_LDFLAGS' =>  'ldflags-y',
3573c68e5878SArnaud Lacombe			};
3574c68e5878SArnaud Lacombe
3575c68e5878SArnaud Lacombe			WARN("DEPRECATED_VARIABLE",
3576c68e5878SArnaud Lacombe			     "Use of $flag is deprecated, please use \`$replacement->{$flag} instead.\n" . $herecurr) if ($replacement->{$flag});
3577c68e5878SArnaud Lacombe		}
3578c68e5878SArnaud Lacombe
3579bff5da43SRob Herring# check for DT compatible documentation
35807dd05b38SFlorian Vaussard		if (defined $root &&
35817dd05b38SFlorian Vaussard			(($realfile =~ /\.dtsi?$/ && $line =~ /^\+\s*compatible\s*=\s*\"/) ||
35827dd05b38SFlorian Vaussard			 ($realfile =~ /\.[ch]$/ && $line =~ /^\+.*\.compatible\s*=\s*\"/))) {
35837dd05b38SFlorian Vaussard
3584bff5da43SRob Herring			my @compats = $rawline =~ /\"([a-zA-Z0-9\-\,\.\+_]+)\"/g;
3585bff5da43SRob Herring
3586cc93319bSFlorian Vaussard			my $dt_path = $root . "/Documentation/devicetree/bindings/";
3587852d095dSRob Herring			my $vp_file = $dt_path . "vendor-prefixes.yaml";
3588cc93319bSFlorian Vaussard
3589bff5da43SRob Herring			foreach my $compat (@compats) {
3590bff5da43SRob Herring				my $compat2 = $compat;
3591185d566bSRob Herring				$compat2 =~ s/\,[a-zA-Z0-9]*\-/\,<\.\*>\-/;
3592185d566bSRob Herring				my $compat3 = $compat;
3593185d566bSRob Herring				$compat3 =~ s/\,([a-z]*)[0-9]*\-/\,$1<\.\*>\-/;
3594185d566bSRob Herring				`grep -Erq "$compat|$compat2|$compat3" $dt_path`;
3595bff5da43SRob Herring				if ( $? >> 8 ) {
3596bff5da43SRob Herring					WARN("UNDOCUMENTED_DT_STRING",
3597bff5da43SRob Herring					     "DT compatible string \"$compat\" appears un-documented -- check $dt_path\n" . $herecurr);
3598bff5da43SRob Herring				}
3599bff5da43SRob Herring
36004fbf32a6SFlorian Vaussard				next if $compat !~ /^([a-zA-Z0-9\-]+)\,/;
36014fbf32a6SFlorian Vaussard				my $vendor = $1;
3602852d095dSRob Herring				`grep -Eq "\\"\\^\Q$vendor\E,\\.\\*\\":" $vp_file`;
3603bff5da43SRob Herring				if ( $? >> 8 ) {
3604bff5da43SRob Herring					WARN("UNDOCUMENTED_DT_STRING",
3605cc93319bSFlorian Vaussard					     "DT compatible string vendor \"$vendor\" appears un-documented -- check $vp_file\n" . $herecurr);
3606bff5da43SRob Herring				}
3607bff5da43SRob Herring			}
3608bff5da43SRob Herring		}
3609bff5da43SRob Herring
36109f3a8992SRob Herring# check for using SPDX license tag at beginning of files
36119f3a8992SRob Herring		if ($realline == $checklicenseline) {
36129f3a8992SRob Herring			if ($rawline =~ /^[ \+]\s*\#\!\s*\//) {
36139f3a8992SRob Herring				$checklicenseline = 2;
36149f3a8992SRob Herring			} elsif ($rawline =~ /^\+/) {
36159f3a8992SRob Herring				my $comment = "";
36169f3a8992SRob Herring				if ($realfile =~ /\.(h|s|S)$/) {
36179f3a8992SRob Herring					$comment = '/*';
36189f3a8992SRob Herring				} elsif ($realfile =~ /\.(c|dts|dtsi)$/) {
36199f3a8992SRob Herring					$comment = '//';
3620c8df0ab6SLubomir Rintel				} elsif (($checklicenseline == 2) || $realfile =~ /\.(sh|pl|py|awk|tc|yaml)$/) {
36219f3a8992SRob Herring					$comment = '#';
36229f3a8992SRob Herring				} elsif ($realfile =~ /\.rst$/) {
36239f3a8992SRob Herring					$comment = '..';
36249f3a8992SRob Herring				}
36259f3a8992SRob Herring
3626fdf13693SJoe Perches# check SPDX comment style for .[chsS] files
3627fdf13693SJoe Perches				if ($realfile =~ /\.[chsS]$/ &&
3628fdf13693SJoe Perches				    $rawline =~ /SPDX-License-Identifier:/ &&
3629ffbce897SJoe Perches				    $rawline !~ m@^\+\s*\Q$comment\E\s*@) {
3630fdf13693SJoe Perches					WARN("SPDX_LICENSE_TAG",
3631fdf13693SJoe Perches					     "Improper SPDX comment style for '$realfile', please use '$comment' instead\n" . $herecurr);
3632fdf13693SJoe Perches				}
3633fdf13693SJoe Perches
36349f3a8992SRob Herring				if ($comment !~ /^$/ &&
3635ffbce897SJoe Perches				    $rawline !~ m@^\+\Q$comment\E SPDX-License-Identifier: @) {
36369f3a8992SRob Herring					WARN("SPDX_LICENSE_TAG",
36379f3a8992SRob Herring					     "Missing or malformed SPDX-License-Identifier tag in line $checklicenseline\n" . $herecurr);
36383b6e8ac9SJoe Perches				} elsif ($rawline =~ /(SPDX-License-Identifier: .*)/) {
36393b6e8ac9SJoe Perches					my $spdx_license = $1;
36403b6e8ac9SJoe Perches					if (!is_SPDX_License_valid($spdx_license)) {
36413b6e8ac9SJoe Perches						WARN("SPDX_LICENSE_TAG",
36423b6e8ac9SJoe Perches						     "'$spdx_license' is not supported in LICENSES/...\n" . $herecurr);
36433b6e8ac9SJoe Perches					}
364450c92900SLubomir Rintel					if ($realfile =~ m@^Documentation/devicetree/bindings/@ &&
364550c92900SLubomir Rintel					    not $spdx_license =~ /GPL-2\.0.*BSD-2-Clause/) {
364650c92900SLubomir Rintel						my $msg_level = \&WARN;
364750c92900SLubomir Rintel						$msg_level = \&CHK if ($file);
364850c92900SLubomir Rintel						if (&{$msg_level}("SPDX_LICENSE_TAG",
364950c92900SLubomir Rintel
365050c92900SLubomir Rintel								  "DT binding documents should be licensed (GPL-2.0-only OR BSD-2-Clause)\n" . $herecurr) &&
365150c92900SLubomir Rintel						    $fix) {
365250c92900SLubomir Rintel							$fixed[$fixlinenr] =~ s/SPDX-License-Identifier: .*/SPDX-License-Identifier: (GPL-2.0-only OR BSD-2-Clause)/;
365350c92900SLubomir Rintel						}
365450c92900SLubomir Rintel					}
36559f3a8992SRob Herring				}
36569f3a8992SRob Herring			}
36579f3a8992SRob Herring		}
36589f3a8992SRob Herring
3659a0154cdbSJoe Perches# check for embedded filenames
3660a0154cdbSJoe Perches		if ($rawline =~ /^\+.*\Q$realfile\E/) {
3661a0154cdbSJoe Perches			WARN("EMBEDDED_FILENAME",
3662a0154cdbSJoe Perches			     "It's generally not useful to have the filename in the file\n" . $herecurr);
3663a0154cdbSJoe Perches		}
3664a0154cdbSJoe Perches
36655368df20SAndy Whitcroft# check we are in a valid source file if not then ignore this hunk
3666d6430f71SJoe Perches		next if ($realfile !~ /\.(h|c|s|S|sh|dtsi|dts)$/);
36675368df20SAndy Whitcroft
3668a8da38a9SJoe Perches# check for using SPDX-License-Identifier on the wrong line number
3669a8da38a9SJoe Perches		if ($realline != $checklicenseline &&
3670a8da38a9SJoe Perches		    $rawline =~ /\bSPDX-License-Identifier:/ &&
3671a8da38a9SJoe Perches		    substr($line, @-, @+ - @-) eq "$;" x (@+ - @-)) {
3672a8da38a9SJoe Perches			WARN("SPDX_LICENSE_TAG",
3673a8da38a9SJoe Perches			     "Misplaced SPDX-License-Identifier tag - use line $checklicenseline instead\n" . $herecurr);
3674a8da38a9SJoe Perches		}
3675a8da38a9SJoe Perches
367647e0c88bSJoe Perches# line length limit (with some exclusions)
367747e0c88bSJoe Perches#
367847e0c88bSJoe Perches# There are a few types of lines that may extend beyond $max_line_length:
367947e0c88bSJoe Perches#	logging functions like pr_info that end in a string
368047e0c88bSJoe Perches#	lines with a single string
368147e0c88bSJoe Perches#	#defines that are a single string
36822e4bbbc5SAndreas Brauchli#	lines with an RFC3986 like URL
368347e0c88bSJoe Perches#
368447e0c88bSJoe Perches# There are 3 different line length message types:
3685ab1ecabfSJean Delvare# LONG_LINE_COMMENT	a comment starts before but extends beyond $max_line_length
368647e0c88bSJoe Perches# LONG_LINE_STRING	a string starts before but extends beyond $max_line_length
368747e0c88bSJoe Perches# LONG_LINE		all other lines longer than $max_line_length
368847e0c88bSJoe Perches#
368947e0c88bSJoe Perches# if LONG_LINE is ignored, the other 2 types are also ignored
369047e0c88bSJoe Perches#
369147e0c88bSJoe Perches
3692b4749e96SJoe Perches		if ($line =~ /^\+/ && $length > $max_line_length) {
369347e0c88bSJoe Perches			my $msg_type = "LONG_LINE";
369447e0c88bSJoe Perches
369547e0c88bSJoe Perches			# Check the allowed long line types first
369647e0c88bSJoe Perches
369747e0c88bSJoe Perches			# logging functions that end in a string that starts
369847e0c88bSJoe Perches			# before $max_line_length
369947e0c88bSJoe Perches			if ($line =~ /^\+\s*$logFunctions\s*\(\s*(?:(?:KERN_\S+\s*|[^"]*))?($String\s*(?:|,|\)\s*;)\s*)$/ &&
370047e0c88bSJoe Perches			    length(expand_tabs(substr($line, 1, length($line) - length($1) - 1))) <= $max_line_length) {
370147e0c88bSJoe Perches				$msg_type = "";
370247e0c88bSJoe Perches
370347e0c88bSJoe Perches			# lines with only strings (w/ possible termination)
370447e0c88bSJoe Perches			# #defines with only strings
370547e0c88bSJoe Perches			} elsif ($line =~ /^\+\s*$String\s*(?:\s*|,|\)\s*;)\s*$/ ||
370647e0c88bSJoe Perches				 $line =~ /^\+\s*#\s*define\s+\w+\s+$String$/) {
370747e0c88bSJoe Perches				$msg_type = "";
370847e0c88bSJoe Perches
3709cc147506SJoe Perches			# More special cases
3710cc147506SJoe Perches			} elsif ($line =~ /^\+.*\bEFI_GUID\s*\(/ ||
3711cc147506SJoe Perches				 $line =~ /^\+\s*(?:\w+)?\s*DEFINE_PER_CPU/) {
3712d560a5f8SJoe Perches				$msg_type = "";
3713d560a5f8SJoe Perches
37142e4bbbc5SAndreas Brauchli			# URL ($rawline is used in case the URL is in a comment)
37152e4bbbc5SAndreas Brauchli			} elsif ($rawline =~ /^\+.*\b[a-z][\w\.\+\-]*:\/\/\S+/i) {
37162e4bbbc5SAndreas Brauchli				$msg_type = "";
37172e4bbbc5SAndreas Brauchli
371847e0c88bSJoe Perches			# Otherwise set the alternate message types
371947e0c88bSJoe Perches
372047e0c88bSJoe Perches			# a comment starts before $max_line_length
372147e0c88bSJoe Perches			} elsif ($line =~ /($;[\s$;]*)$/ &&
372247e0c88bSJoe Perches				 length(expand_tabs(substr($line, 1, length($line) - length($1) - 1))) <= $max_line_length) {
372347e0c88bSJoe Perches				$msg_type = "LONG_LINE_COMMENT"
372447e0c88bSJoe Perches
372547e0c88bSJoe Perches			# a quoted string starts before $max_line_length
372647e0c88bSJoe Perches			} elsif ($sline =~ /\s*($String(?:\s*(?:\\|,\s*|\)\s*;\s*))?)$/ &&
372747e0c88bSJoe Perches				 length(expand_tabs(substr($line, 1, length($line) - length($1) - 1))) <= $max_line_length) {
372847e0c88bSJoe Perches				$msg_type = "LONG_LINE_STRING"
372947e0c88bSJoe Perches			}
373047e0c88bSJoe Perches
373147e0c88bSJoe Perches			if ($msg_type ne "" &&
373247e0c88bSJoe Perches			    (show_type("LONG_LINE") || show_type($msg_type))) {
3733bdc48fa1SJoe Perches				my $msg_level = \&WARN;
3734bdc48fa1SJoe Perches				$msg_level = \&CHK if ($file);
3735bdc48fa1SJoe Perches				&{$msg_level}($msg_type,
3736bdc48fa1SJoe Perches					      "line length of $length exceeds $max_line_length columns\n" . $herecurr);
37370a920b5bSAndy Whitcroft			}
373847e0c88bSJoe Perches		}
37390a920b5bSAndy Whitcroft
37408905a67cSAndy Whitcroft# check for adding lines without a newline.
37418905a67cSAndy Whitcroft		if ($line =~ /^\+/ && defined $lines[$linenr] && $lines[$linenr] =~ /^\\ No newline at end of file/) {
374247ca69b8STom Rix			if (WARN("MISSING_EOF_NEWLINE",
374347ca69b8STom Rix			         "adding a line without newline at end of file\n" . $herecurr) &&
374447ca69b8STom Rix			    $fix) {
374547ca69b8STom Rix				fix_delete_line($fixlinenr+1, "No newline at end of file");
374647ca69b8STom Rix			}
37478905a67cSAndy Whitcroft		}
37488905a67cSAndy Whitcroft
3749de93245cSAditya Srivastava# check for .L prefix local symbols in .S files
3750de93245cSAditya Srivastava		if ($realfile =~ /\.S$/ &&
3751de93245cSAditya Srivastava		    $line =~ /^\+\s*(?:[A-Z]+_)?SYM_[A-Z]+_(?:START|END)(?:_[A-Z_]+)?\s*\(\s*\.L/) {
3752de93245cSAditya Srivastava			WARN("AVOID_L_PREFIX",
3753de93245cSAditya Srivastava			     "Avoid using '.L' prefixed local symbol names for denoting a range of code via 'SYM_*_START/END' annotations; see Documentation/asm-annotations.rst\n" . $herecurr);
3754de93245cSAditya Srivastava		}
3755de93245cSAditya Srivastava
3756b9ea10d6SAndy Whitcroft# check we are in a valid source file C or perl if not then ignore this hunk
3757de4c924cSGeert Uytterhoeven		next if ($realfile !~ /\.(h|c|pl|dtsi|dts)$/);
37580a920b5bSAndy Whitcroft
37590a920b5bSAndy Whitcroft# at the beginning of a line any tabs must come first and anything
3760713a09deSAntonio Borneo# more than $tabsize must use tabs.
3761c2fdda0dSAndy Whitcroft		if ($rawline =~ /^\+\s* \t\s*\S/ ||
3762c2fdda0dSAndy Whitcroft		    $rawline =~ /^\+\s*        \s*/) {
3763c2fdda0dSAndy Whitcroft			my $herevet = "$here\n" . cat_vet($rawline) . "\n";
3764d2c0a235SAndy Whitcroft			$rpt_cleaners = 1;
37653705ce5bSJoe Perches			if (ERROR("CODE_INDENT",
37663705ce5bSJoe Perches				  "code indent should use tabs where possible\n" . $herevet) &&
37673705ce5bSJoe Perches			    $fix) {
3768194f66fcSJoe Perches				$fixed[$fixlinenr] =~ s/^\+([ \t]+)/"\+" . tabify($1)/e;
37693705ce5bSJoe Perches			}
37700a920b5bSAndy Whitcroft		}
37710a920b5bSAndy Whitcroft
377208e44365SAlberto Panizzo# check for space before tabs.
377308e44365SAlberto Panizzo		if ($rawline =~ /^\+/ && $rawline =~ / \t/) {
377408e44365SAlberto Panizzo			my $herevet = "$here\n" . cat_vet($rawline) . "\n";
37753705ce5bSJoe Perches			if (WARN("SPACE_BEFORE_TAB",
37763705ce5bSJoe Perches				"please, no space before tabs\n" . $herevet) &&
37773705ce5bSJoe Perches			    $fix) {
3778194f66fcSJoe Perches				while ($fixed[$fixlinenr] =~
3779713a09deSAntonio Borneo					   s/(^\+.*) {$tabsize,$tabsize}\t/$1\t\t/) {}
3780194f66fcSJoe Perches				while ($fixed[$fixlinenr] =~
3781c76f4cb3SJoe Perches					   s/(^\+.*) +\t/$1\t/) {}
37823705ce5bSJoe Perches			}
378308e44365SAlberto Panizzo		}
378408e44365SAlberto Panizzo
37856a487211SJoe Perches# check for assignments on the start of a line
37866a487211SJoe Perches		if ($sline =~ /^\+\s+($Assignment)[^=]/) {
3787da7355abSAditya Srivastava			my $operator = $1;
3788da7355abSAditya Srivastava			if (CHK("ASSIGNMENT_CONTINUATIONS",
3789da7355abSAditya Srivastava				"Assignment operator '$1' should be on the previous line\n" . $hereprev) &&
3790da7355abSAditya Srivastava			    $fix && $prevrawline =~ /^\+/) {
3791da7355abSAditya Srivastava				# add assignment operator to the previous line, remove from current line
3792da7355abSAditya Srivastava				$fixed[$fixlinenr - 1] .= " $operator";
3793da7355abSAditya Srivastava				$fixed[$fixlinenr] =~ s/\Q$operator\E\s*//;
3794da7355abSAditya Srivastava			}
37956a487211SJoe Perches		}
37966a487211SJoe Perches
3797d1fe9c09SJoe Perches# check for && or || at the start of a line
3798d1fe9c09SJoe Perches		if ($rawline =~ /^\+\s*(&&|\|\|)/) {
37998e08f076SAditya Srivastava			my $operator = $1;
38008e08f076SAditya Srivastava			if (CHK("LOGICAL_CONTINUATIONS",
38018e08f076SAditya Srivastava				"Logical continuations should be on the previous line\n" . $hereprev) &&
38028e08f076SAditya Srivastava			    $fix && $prevrawline =~ /^\+/) {
38038e08f076SAditya Srivastava				# insert logical operator at last non-comment, non-whitepsace char on previous line
38048e08f076SAditya Srivastava				$prevline =~ /[\s$;]*$/;
38058e08f076SAditya Srivastava				my $line_end = substr($prevrawline, $-[0]);
38068e08f076SAditya Srivastava				$fixed[$fixlinenr - 1] =~ s/\Q$line_end\E$/ $operator$line_end/;
38078e08f076SAditya Srivastava				$fixed[$fixlinenr] =~ s/\Q$operator\E\s*//;
38088e08f076SAditya Srivastava			}
3809d1fe9c09SJoe Perches		}
3810d1fe9c09SJoe Perches
3811a91e8994SJoe Perches# check indentation starts on a tab stop
38125b57980dSJoe Perches		if ($perl_version_ok &&
3813bd49111fSJoe Perches		    $sline =~ /^\+\t+( +)(?:$c90_Keywords\b|\{\s*$|\}\s*(?:else\b|while\b|\s*$)|$Declare\s*$Ident\s*[;=])/) {
3814a91e8994SJoe Perches			my $indent = length($1);
3815713a09deSAntonio Borneo			if ($indent % $tabsize) {
3816a91e8994SJoe Perches				if (WARN("TABSTOP",
3817a91e8994SJoe Perches					 "Statements should start on a tabstop\n" . $herecurr) &&
3818a91e8994SJoe Perches				    $fix) {
3819713a09deSAntonio Borneo					$fixed[$fixlinenr] =~ s@(^\+\t+) +@$1 . "\t" x ($indent/$tabsize)@e;
3820a91e8994SJoe Perches				}
3821a91e8994SJoe Perches			}
3822a91e8994SJoe Perches		}
3823a91e8994SJoe Perches
3824d1fe9c09SJoe Perches# check multi-line statement indentation matches previous line
38255b57980dSJoe Perches		if ($perl_version_ok &&
3826fd71f632SJoe Perches		    $prevline =~ /^\+([ \t]*)((?:$c90_Keywords(?:\s+if)\s*)|(?:$Declare\s*)?(?:$Ident|\(\s*\*\s*$Ident\s*\))\s*|(?:\*\s*)*$Lval\s*=\s*$Ident\s*)\(.*(\&\&|\|\||,)\s*$/) {
3827d1fe9c09SJoe Perches			$prevline =~ /^\+(\t*)(.*)$/;
3828d1fe9c09SJoe Perches			my $oldindent = $1;
3829d1fe9c09SJoe Perches			my $rest = $2;
3830d1fe9c09SJoe Perches
3831d1fe9c09SJoe Perches			my $pos = pos_last_openparen($rest);
3832d1fe9c09SJoe Perches			if ($pos >= 0) {
3833b34a26f3SJoe Perches				$line =~ /^(\+| )([ \t]*)/;
3834b34a26f3SJoe Perches				my $newindent = $2;
3835d1fe9c09SJoe Perches
3836d1fe9c09SJoe Perches				my $goodtabindent = $oldindent .
3837713a09deSAntonio Borneo					"\t" x ($pos / $tabsize) .
3838713a09deSAntonio Borneo					" "  x ($pos % $tabsize);
3839d1fe9c09SJoe Perches				my $goodspaceindent = $oldindent . " "  x $pos;
3840d1fe9c09SJoe Perches
3841d1fe9c09SJoe Perches				if ($newindent ne $goodtabindent &&
3842d1fe9c09SJoe Perches				    $newindent ne $goodspaceindent) {
38433705ce5bSJoe Perches
38443705ce5bSJoe Perches					if (CHK("PARENTHESIS_ALIGNMENT",
38453705ce5bSJoe Perches						"Alignment should match open parenthesis\n" . $hereprev) &&
38463705ce5bSJoe Perches					    $fix && $line =~ /^\+/) {
3847194f66fcSJoe Perches						$fixed[$fixlinenr] =~
38483705ce5bSJoe Perches						    s/^\+[ \t]*/\+$goodtabindent/;
38493705ce5bSJoe Perches					}
3850d1fe9c09SJoe Perches				}
3851d1fe9c09SJoe Perches			}
3852d1fe9c09SJoe Perches		}
3853d1fe9c09SJoe Perches
38546ab3a970SJoe Perches# check for space after cast like "(int) foo" or "(struct foo) bar"
38556ab3a970SJoe Perches# avoid checking a few false positives:
38566ab3a970SJoe Perches#   "sizeof(<type>)" or "__alignof__(<type>)"
38576ab3a970SJoe Perches#   function pointer declarations like "(*foo)(int) = bar;"
38586ab3a970SJoe Perches#   structure definitions like "(struct foo) { 0 };"
38596ab3a970SJoe Perches#   multiline macros that define functions
38606ab3a970SJoe Perches#   known attributes or the __attribute__ keyword
38616ab3a970SJoe Perches		if ($line =~ /^\+(.*)\(\s*$Type\s*\)([ \t]++)((?![={]|\\$|$Attribute|__attribute__))/ &&
38626ab3a970SJoe Perches		    (!defined($1) || $1 !~ /\b(?:sizeof|__alignof__)\s*$/)) {
38633705ce5bSJoe Perches			if (CHK("SPACING",
3864f27c95dbSJoe Perches				"No space is necessary after a cast\n" . $herecurr) &&
38653705ce5bSJoe Perches			    $fix) {
3866194f66fcSJoe Perches				$fixed[$fixlinenr] =~
3867f27c95dbSJoe Perches				    s/(\(\s*$Type\s*\))[ \t]+/$1/;
38683705ce5bSJoe Perches			}
3869aad4f614SJoe Perches		}
3870aad4f614SJoe Perches
387186406b1cSJoe Perches# Block comment styles
387286406b1cSJoe Perches# Networking with an initial /*
387305880600SJoe Perches		if ($realfile =~ m@^(drivers/net/|net/)@ &&
3874fdb4bcd6SJoe Perches		    $prevrawline =~ /^\+[ \t]*\/\*[ \t]*$/ &&
387585ad978cSJoe Perches		    $rawline =~ /^\+[ \t]*\*/ &&
3876c70735c2SŁukasz Stelmach		    $realline > 3) { # Do not warn about the initial copyright comment block after SPDX-License-Identifier
387705880600SJoe Perches			WARN("NETWORKING_BLOCK_COMMENT_STYLE",
387805880600SJoe Perches			     "networking block comments don't use an empty /* line, use /* Comment...\n" . $hereprev);
387905880600SJoe Perches		}
388005880600SJoe Perches
388186406b1cSJoe Perches# Block comments use * on subsequent lines
388286406b1cSJoe Perches		if ($prevline =~ /$;[ \t]*$/ &&			#ends in comment
388386406b1cSJoe Perches		    $prevrawline =~ /^\+.*?\/\*/ &&		#starting /*
3884a605e32eSJoe Perches		    $prevrawline !~ /\*\/[ \t]*$/ &&		#no trailing */
388561135e96SJoe Perches		    $rawline =~ /^\+/ &&			#line is new
3886a605e32eSJoe Perches		    $rawline !~ /^\+[ \t]*\*/) {		#no leading *
388786406b1cSJoe Perches			WARN("BLOCK_COMMENT_STYLE",
388886406b1cSJoe Perches			     "Block comments use * on subsequent lines\n" . $hereprev);
3889a605e32eSJoe Perches		}
3890a605e32eSJoe Perches
389186406b1cSJoe Perches# Block comments use */ on trailing lines
389286406b1cSJoe Perches		if ($rawline !~ m@^\+[ \t]*\*/[ \t]*$@ &&	#trailing */
3893c24f9f19SJoe Perches		    $rawline !~ m@^\+.*/\*.*\*/[ \t]*$@ &&	#inline /*...*/
3894c24f9f19SJoe Perches		    $rawline !~ m@^\+.*\*{2,}/[ \t]*$@ &&	#trailing **/
3895c24f9f19SJoe Perches		    $rawline =~ m@^\+[ \t]*.+\*\/[ \t]*$@) {	#non blank */
389686406b1cSJoe Perches			WARN("BLOCK_COMMENT_STYLE",
389786406b1cSJoe Perches			     "Block comments use a trailing */ on a separate line\n" . $herecurr);
389805880600SJoe Perches		}
389905880600SJoe Perches
390008eb9b80SJoe Perches# Block comment * alignment
390108eb9b80SJoe Perches		if ($prevline =~ /$;[ \t]*$/ &&			#ends in comment
3902af207524SJoe Perches		    $line =~ /^\+[ \t]*$;/ &&			#leading comment
3903af207524SJoe Perches		    $rawline =~ /^\+[ \t]*\*/ &&		#leading *
3904af207524SJoe Perches		    (($prevrawline =~ /^\+.*?\/\*/ &&		#leading /*
390508eb9b80SJoe Perches		      $prevrawline !~ /\*\/[ \t]*$/) ||		#no trailing */
3906af207524SJoe Perches		     $prevrawline =~ /^\+[ \t]*\*/)) {		#leading *
3907af207524SJoe Perches			my $oldindent;
390808eb9b80SJoe Perches			$prevrawline =~ m@^\+([ \t]*/?)\*@;
3909af207524SJoe Perches			if (defined($1)) {
3910af207524SJoe Perches				$oldindent = expand_tabs($1);
3911af207524SJoe Perches			} else {
3912af207524SJoe Perches				$prevrawline =~ m@^\+(.*/?)\*@;
3913af207524SJoe Perches				$oldindent = expand_tabs($1);
3914af207524SJoe Perches			}
391508eb9b80SJoe Perches			$rawline =~ m@^\+([ \t]*)\*@;
391608eb9b80SJoe Perches			my $newindent = $1;
391708eb9b80SJoe Perches			$newindent = expand_tabs($newindent);
3918af207524SJoe Perches			if (length($oldindent) ne length($newindent)) {
391908eb9b80SJoe Perches				WARN("BLOCK_COMMENT_STYLE",
392008eb9b80SJoe Perches				     "Block comments should align the * on each line\n" . $hereprev);
392108eb9b80SJoe Perches			}
392208eb9b80SJoe Perches		}
392308eb9b80SJoe Perches
39247f619191SJoe Perches# check for missing blank lines after struct/union declarations
39257f619191SJoe Perches# with exceptions for various attributes and macros
39267f619191SJoe Perches		if ($prevline =~ /^[\+ ]};?\s*$/ &&
39277f619191SJoe Perches		    $line =~ /^\+/ &&
39287f619191SJoe Perches		    !($line =~ /^\+\s*$/ ||
39297f619191SJoe Perches		      $line =~ /^\+\s*EXPORT_SYMBOL/ ||
39307f619191SJoe Perches		      $line =~ /^\+\s*MODULE_/i ||
39317f619191SJoe Perches		      $line =~ /^\+\s*\#\s*(?:end|elif|else)/ ||
39327f619191SJoe Perches		      $line =~ /^\+[a-z_]*init/ ||
39337f619191SJoe Perches		      $line =~ /^\+\s*(?:static\s+)?[A-Z_]*ATTR/ ||
39347f619191SJoe Perches		      $line =~ /^\+\s*DECLARE/ ||
39350bc989ffSMasahiro Yamada		      $line =~ /^\+\s*builtin_[\w_]*driver/ ||
39367f619191SJoe Perches		      $line =~ /^\+\s*__setup/)) {
3937d752fcc8SJoe Perches			if (CHK("LINE_SPACING",
3938d752fcc8SJoe Perches				"Please use a blank line after function/struct/union/enum declarations\n" . $hereprev) &&
3939d752fcc8SJoe Perches			    $fix) {
3940f2d7e4d4SJoe Perches				fix_insert_line($fixlinenr, "\+");
3941d752fcc8SJoe Perches			}
39427f619191SJoe Perches		}
39437f619191SJoe Perches
3944365dd4eaSJoe Perches# check for multiple consecutive blank lines
3945365dd4eaSJoe Perches		if ($prevline =~ /^[\+ ]\s*$/ &&
3946365dd4eaSJoe Perches		    $line =~ /^\+\s*$/ &&
3947365dd4eaSJoe Perches		    $last_blank_line != ($linenr - 1)) {
3948d752fcc8SJoe Perches			if (CHK("LINE_SPACING",
3949d752fcc8SJoe Perches				"Please don't use multiple blank lines\n" . $hereprev) &&
3950d752fcc8SJoe Perches			    $fix) {
3951f2d7e4d4SJoe Perches				fix_delete_line($fixlinenr, $rawline);
3952d752fcc8SJoe Perches			}
3953d752fcc8SJoe Perches
3954365dd4eaSJoe Perches			$last_blank_line = $linenr;
3955365dd4eaSJoe Perches		}
3956365dd4eaSJoe Perches
39573b617e3bSJoe Perches# check for missing blank lines after declarations
3958b5e8736aSJoe Perches# (declarations must have the same indentation and not be at the start of line)
3959b5e8736aSJoe Perches		if (($prevline =~ /\+(\s+)\S/) && $sline =~ /^\+$1\S/) {
3960b5e8736aSJoe Perches			# use temporaries
3961b5e8736aSJoe Perches			my $sl = $sline;
3962b5e8736aSJoe Perches			my $pl = $prevline;
3963b5e8736aSJoe Perches			# remove $Attribute/$Sparse uses to simplify comparisons
3964b5e8736aSJoe Perches			$sl =~ s/\b(?:$Attribute|$Sparse)\b//g;
3965b5e8736aSJoe Perches			$pl =~ s/\b(?:$Attribute|$Sparse)\b//g;
3966b5e8736aSJoe Perches			if (($pl =~ /^\+\s+$Declare\s*$Ident\s*[=,;:\[]/ ||
39675a4e1fd3SJoe Perches			# function pointer declarations
3968b5e8736aSJoe Perches			     $pl =~ /^\+\s+$Declare\s*\(\s*\*\s*$Ident\s*\)\s*[=,;:\[\(]/ ||
39693f7bac03SJoe Perches			# foo bar; where foo is some local typedef or #define
3970b5e8736aSJoe Perches			     $pl =~ /^\+\s+$Ident(?:\s+|\s*\*\s*)$Ident\s*[=,;\[]/ ||
39713f7bac03SJoe Perches			# known declaration macros
3972b5e8736aSJoe Perches			     $pl =~ /^\+\s+$declaration_macros/) &&
39733f7bac03SJoe Perches			# for "else if" which can look like "$Ident $Ident"
3974b5e8736aSJoe Perches			    !($pl =~ /^\+\s+$c90_Keywords\b/ ||
39753f7bac03SJoe Perches			# other possible extensions of declaration lines
3976b5e8736aSJoe Perches			      $pl =~ /(?:$Compare|$Assignment|$Operators)\s*$/ ||
39773f7bac03SJoe Perches			# not starting a section or a macro "\" extended line
3978b5e8736aSJoe Perches			      $pl =~ /(?:\{\s*|\\)$/) &&
39793f7bac03SJoe Perches			# looks like a declaration
3980b5e8736aSJoe Perches			    !($sl =~ /^\+\s+$Declare\s*$Ident\s*[=,;:\[]/ ||
39815a4e1fd3SJoe Perches			# function pointer declarations
3982b5e8736aSJoe Perches			      $sl =~ /^\+\s+$Declare\s*\(\s*\*\s*$Ident\s*\)\s*[=,;:\[\(]/ ||
39833f7bac03SJoe Perches			# foo bar; where foo is some local typedef or #define
3984b5e8736aSJoe Perches			      $sl =~ /^\+\s+$Ident(?:\s+|\s*\*\s*)$Ident\s*[=,;\[]/ ||
39853f7bac03SJoe Perches			# known declaration macros
3986b5e8736aSJoe Perches			      $sl =~ /^\+\s+$declaration_macros/ ||
39873f7bac03SJoe Perches			# start of struct or union or enum
3988b5e8736aSJoe Perches			      $sl =~ /^\+\s+(?:static\s+)?(?:const\s+)?(?:union|struct|enum|typedef)\b/ ||
39893f7bac03SJoe Perches			# start or end of block or continuation of declaration
3990b5e8736aSJoe Perches			      $sl =~ /^\+\s+(?:$|[\{\}\.\#\"\?\:\(\[])/ ||
39913f7bac03SJoe Perches			# bitfield continuation
3992b5e8736aSJoe Perches			      $sl =~ /^\+\s+$Ident\s*:\s*\d+\s*[,;]/ ||
39933f7bac03SJoe Perches			# other possible extensions of declaration lines
3994b5e8736aSJoe Perches			      $sl =~ /^\+\s+\(?\s*(?:$Compare|$Assignment|$Operators)/)) {
3995d752fcc8SJoe Perches				if (WARN("LINE_SPACING",
3996d752fcc8SJoe Perches					 "Missing a blank line after declarations\n" . $hereprev) &&
3997d752fcc8SJoe Perches				    $fix) {
3998f2d7e4d4SJoe Perches					fix_insert_line($fixlinenr, "\+");
3999d752fcc8SJoe Perches				}
40003b617e3bSJoe Perches			}
4001b5e8736aSJoe Perches		}
40023b617e3bSJoe Perches
40035f7ddae6SRaffaele Recalcati# check for spaces at the beginning of a line.
40046b4c5bebSAndy Whitcroft# Exceptions:
40056b4c5bebSAndy Whitcroft#  1) within comments
40066b4c5bebSAndy Whitcroft#  2) indented preprocessor commands
40076b4c5bebSAndy Whitcroft#  3) hanging labels
40083705ce5bSJoe Perches		if ($rawline =~ /^\+ / && $line !~ /^\+ *(?:$;|#|$Ident:)/)  {
40095f7ddae6SRaffaele Recalcati			my $herevet = "$here\n" . cat_vet($rawline) . "\n";
40103705ce5bSJoe Perches			if (WARN("LEADING_SPACE",
40113705ce5bSJoe Perches				 "please, no spaces at the start of a line\n" . $herevet) &&
40123705ce5bSJoe Perches			    $fix) {
4013194f66fcSJoe Perches				$fixed[$fixlinenr] =~ s/^\+([ \t]+)/"\+" . tabify($1)/e;
40143705ce5bSJoe Perches			}
40155f7ddae6SRaffaele Recalcati		}
40165f7ddae6SRaffaele Recalcati
4017b9ea10d6SAndy Whitcroft# check we are in a valid C source file if not then ignore this hunk
4018b9ea10d6SAndy Whitcroft		next if ($realfile !~ /\.(h|c)$/);
4019b9ea10d6SAndy Whitcroft
40205751a24eSJoe Perches# check for unusual line ending [ or (
40215751a24eSJoe Perches		if ($line =~ /^\+.*([\[\(])\s*$/) {
40225751a24eSJoe Perches			CHK("OPEN_ENDED_LINE",
40235751a24eSJoe Perches			    "Lines should not end with a '$1'\n" . $herecurr);
40245751a24eSJoe Perches		}
40255751a24eSJoe Perches
40264dbed76fSJoe Perches# check if this appears to be the start function declaration, save the name
40274dbed76fSJoe Perches		if ($sline =~ /^\+\{\s*$/ &&
40284dbed76fSJoe Perches		    $prevline =~ /^\+(?:(?:(?:$Storage|$Inline)\s*)*\s*$Type\s*)?($Ident)\(/) {
40294dbed76fSJoe Perches			$context_function = $1;
40304dbed76fSJoe Perches		}
40314dbed76fSJoe Perches
40324dbed76fSJoe Perches# check if this appears to be the end of function declaration
40334dbed76fSJoe Perches		if ($sline =~ /^\+\}\s*$/) {
40344dbed76fSJoe Perches			undef $context_function;
40354dbed76fSJoe Perches		}
40364dbed76fSJoe Perches
4037032a4c0fSJoe Perches# check indentation of any line with a bare else
4038840080a0SJoe Perches# (but not if it is a multiple line "if (foo) return bar; else return baz;")
4039032a4c0fSJoe Perches# if the previous line is a break or return and is indented 1 tab more...
4040032a4c0fSJoe Perches		if ($sline =~ /^\+([\t]+)(?:}[ \t]*)?else(?:[ \t]*{)?\s*$/) {
4041032a4c0fSJoe Perches			my $tabs = length($1) + 1;
4042840080a0SJoe Perches			if ($prevline =~ /^\+\t{$tabs,$tabs}break\b/ ||
4043840080a0SJoe Perches			    ($prevline =~ /^\+\t{$tabs,$tabs}return\b/ &&
4044840080a0SJoe Perches			     defined $lines[$linenr] &&
4045840080a0SJoe Perches			     $lines[$linenr] !~ /^[ \+]\t{$tabs,$tabs}return/)) {
4046032a4c0fSJoe Perches				WARN("UNNECESSARY_ELSE",
4047032a4c0fSJoe Perches				     "else is not generally useful after a break or return\n" . $hereprev);
4048032a4c0fSJoe Perches			}
4049032a4c0fSJoe Perches		}
4050032a4c0fSJoe Perches
4051c00df19aSJoe Perches# check indentation of a line with a break;
4052dc58bc55SJoe Perches# if the previous line is a goto, return or break
4053dc58bc55SJoe Perches# and is indented the same # of tabs
4054c00df19aSJoe Perches		if ($sline =~ /^\+([\t]+)break\s*;\s*$/) {
4055c00df19aSJoe Perches			my $tabs = $1;
4056dc58bc55SJoe Perches			if ($prevline =~ /^\+$tabs(goto|return|break)\b/) {
4057dc58bc55SJoe Perches				if (WARN("UNNECESSARY_BREAK",
4058dc58bc55SJoe Perches					 "break is not useful after a $1\n" . $hereprev) &&
4059dc58bc55SJoe Perches				    $fix) {
4060dc58bc55SJoe Perches					fix_delete_line($fixlinenr, $rawline);
4061dc58bc55SJoe Perches				}
4062c00df19aSJoe Perches			}
4063c00df19aSJoe Perches		}
4064c00df19aSJoe Perches
4065c2fdda0dSAndy Whitcroft# check for RCS/CVS revision markers
4066cf655043SAndy Whitcroft		if ($rawline =~ /^\+.*\$(Revision|Log|Id)(?:\$|)/) {
4067000d1cc1SJoe Perches			WARN("CVS_KEYWORD",
4068000d1cc1SJoe Perches			     "CVS style keyword markers, these will _not_ be updated\n". $herecurr);
4069c2fdda0dSAndy Whitcroft		}
407022f2a2efSAndy Whitcroft
407156e77d70SJoe Perches# check for old HOTPLUG __dev<foo> section markings
407256e77d70SJoe Perches		if ($line =~ /\b(__dev(init|exit)(data|const|))\b/) {
407356e77d70SJoe Perches			WARN("HOTPLUG_SECTION",
407456e77d70SJoe Perches			     "Using $1 is unnecessary\n" . $herecurr);
407556e77d70SJoe Perches		}
407656e77d70SJoe Perches
40779c0ca6f9SAndy Whitcroft# Check for potential 'bare' types
40782b474a1aSAndy Whitcroft		my ($stat, $cond, $line_nr_next, $remain_next, $off_next,
40792b474a1aSAndy Whitcroft		    $realline_next);
40803e469cdcSAndy Whitcroft#print "LINE<$line>\n";
4081ca819864SJoe Perches		if ($linenr > $suppress_statement &&
40821b5539b1SJoe Perches		    $realcnt && $sline =~ /.\s*\S/) {
4083170d3a22SAndy Whitcroft			($stat, $cond, $line_nr_next, $remain_next, $off_next) =
4084f5fe35ddSAndy Whitcroft				ctx_statement_block($linenr, $realcnt, 0);
4085171ae1a4SAndy Whitcroft			$stat =~ s/\n./\n /g;
4086171ae1a4SAndy Whitcroft			$cond =~ s/\n./\n /g;
4087171ae1a4SAndy Whitcroft
40883e469cdcSAndy Whitcroft#print "linenr<$linenr> <$stat>\n";
40893e469cdcSAndy Whitcroft			# If this statement has no statement boundaries within
40903e469cdcSAndy Whitcroft			# it there is no point in retrying a statement scan
40913e469cdcSAndy Whitcroft			# until we hit end of it.
40923e469cdcSAndy Whitcroft			my $frag = $stat; $frag =~ s/;+\s*$//;
40933e469cdcSAndy Whitcroft			if ($frag !~ /(?:{|;)/) {
40943e469cdcSAndy Whitcroft#print "skip<$line_nr_next>\n";
40953e469cdcSAndy Whitcroft				$suppress_statement = $line_nr_next;
40963e469cdcSAndy Whitcroft			}
4097f74bd194SAndy Whitcroft
40982b474a1aSAndy Whitcroft			# Find the real next line.
40992b474a1aSAndy Whitcroft			$realline_next = $line_nr_next;
41002b474a1aSAndy Whitcroft			if (defined $realline_next &&
41012b474a1aSAndy Whitcroft			    (!defined $lines[$realline_next - 1] ||
41022b474a1aSAndy Whitcroft			     substr($lines[$realline_next - 1], $off_next) =~ /^\s*$/)) {
41032b474a1aSAndy Whitcroft				$realline_next++;
41042b474a1aSAndy Whitcroft			}
41052b474a1aSAndy Whitcroft
4106171ae1a4SAndy Whitcroft			my $s = $stat;
4107171ae1a4SAndy Whitcroft			$s =~ s/{.*$//s;
4108cf655043SAndy Whitcroft
4109c2fdda0dSAndy Whitcroft			# Ignore goto labels.
4110171ae1a4SAndy Whitcroft			if ($s =~ /$Ident:\*$/s) {
4111c2fdda0dSAndy Whitcroft
4112c2fdda0dSAndy Whitcroft			# Ignore functions being called
4113171ae1a4SAndy Whitcroft			} elsif ($s =~ /^.\s*$Ident\s*\(/s) {
4114c2fdda0dSAndy Whitcroft
4115463f2864SAndy Whitcroft			} elsif ($s =~ /^.\s*else\b/s) {
4116463f2864SAndy Whitcroft
4117c45dcabdSAndy Whitcroft			# declarations always start with types
4118d2506586SAndy Whitcroft			} elsif ($prev_values eq 'E' && $s =~ /^.\s*(?:$Storage\s+)?(?:$Inline\s+)?(?:const\s+)?((?:\s*$Ident)+?)\b(?:\s+$Sparse)?\s*\**\s*(?:$Ident|\(\*[^\)]*\))(?:\s*$Modifier)?\s*(?:;|=|,|\()/s) {
4119c45dcabdSAndy Whitcroft				my $type = $1;
4120c45dcabdSAndy Whitcroft				$type =~ s/\s+/ /g;
4121c45dcabdSAndy Whitcroft				possible($type, "A:" . $s);
4122c45dcabdSAndy Whitcroft
41236c72ffaaSAndy Whitcroft			# definitions in global scope can only start with types
4124a6a84062SAndy Whitcroft			} elsif ($s =~ /^.(?:$Storage\s+)?(?:$Inline\s+)?(?:const\s+)?($Ident)\b\s*(?!:)/s) {
4125c45dcabdSAndy Whitcroft				possible($1, "B:" . $s);
4126c2fdda0dSAndy Whitcroft			}
41278905a67cSAndy Whitcroft
41286c72ffaaSAndy Whitcroft			# any (foo ... *) is a pointer cast, and foo is a type
412965863862SAndy Whitcroft			while ($s =~ /\(($Ident)(?:\s+$Sparse)*[\s\*]+\s*\)/sg) {
4130c45dcabdSAndy Whitcroft				possible($1, "C:" . $s);
41319c0ca6f9SAndy Whitcroft			}
41328905a67cSAndy Whitcroft
41338905a67cSAndy Whitcroft			# Check for any sort of function declaration.
41348905a67cSAndy Whitcroft			# int foo(something bar, other baz);
41358905a67cSAndy Whitcroft			# void (*store_gdt)(x86_descr_ptr *);
4136171ae1a4SAndy Whitcroft			if ($prev_values eq 'E' && $s =~ /^(.(?:typedef\s*)?(?:(?:$Storage|$Inline)\s*)*\s*$Type\s*(?:\b$Ident|\(\*\s*$Ident\))\s*)\(/s) {
41378905a67cSAndy Whitcroft				my ($name_len) = length($1);
41388905a67cSAndy Whitcroft
4139cf655043SAndy Whitcroft				my $ctx = $s;
4140773647a0SAndy Whitcroft				substr($ctx, 0, $name_len + 1, '');
41418905a67cSAndy Whitcroft				$ctx =~ s/\)[^\)]*$//;
4142cf655043SAndy Whitcroft
41438905a67cSAndy Whitcroft				for my $arg (split(/\s*,\s*/, $ctx)) {
4144c45dcabdSAndy Whitcroft					if ($arg =~ /^(?:const\s+)?($Ident)(?:\s+$Sparse)*\s*\**\s*(:?\b$Ident)?$/s || $arg =~ /^($Ident)$/s) {
41458905a67cSAndy Whitcroft
4146c45dcabdSAndy Whitcroft						possible($1, "D:" . $s);
41478905a67cSAndy Whitcroft					}
41488905a67cSAndy Whitcroft				}
41498905a67cSAndy Whitcroft			}
41508905a67cSAndy Whitcroft
41519c0ca6f9SAndy Whitcroft		}
41529c0ca6f9SAndy Whitcroft
415300df344fSAndy Whitcroft#
415400df344fSAndy Whitcroft# Checks which may be anchored in the context.
415500df344fSAndy Whitcroft#
415600df344fSAndy Whitcroft
415700df344fSAndy Whitcroft# Check for switch () and associated case and default
415800df344fSAndy Whitcroft# statements should be at the same indent.
415900df344fSAndy Whitcroft		if ($line=~/\bswitch\s*\(.*\)/) {
416000df344fSAndy Whitcroft			my $err = '';
416100df344fSAndy Whitcroft			my $sep = '';
416200df344fSAndy Whitcroft			my @ctx = ctx_block_outer($linenr, $realcnt);
416300df344fSAndy Whitcroft			shift(@ctx);
416400df344fSAndy Whitcroft			for my $ctx (@ctx) {
416500df344fSAndy Whitcroft				my ($clen, $cindent) = line_stats($ctx);
416600df344fSAndy Whitcroft				if ($ctx =~ /^\+\s*(case\s+|default:)/ &&
416700df344fSAndy Whitcroft							$indent != $cindent) {
416800df344fSAndy Whitcroft					$err .= "$sep$ctx\n";
416900df344fSAndy Whitcroft					$sep = '';
417000df344fSAndy Whitcroft				} else {
417100df344fSAndy Whitcroft					$sep = "[...]\n";
417200df344fSAndy Whitcroft				}
417300df344fSAndy Whitcroft			}
417400df344fSAndy Whitcroft			if ($err ne '') {
4175000d1cc1SJoe Perches				ERROR("SWITCH_CASE_INDENT_LEVEL",
4176000d1cc1SJoe Perches				      "switch and case should be at the same indent\n$hereline$err");
4177de7d4f0eSAndy Whitcroft			}
4178de7d4f0eSAndy Whitcroft		}
4179de7d4f0eSAndy Whitcroft
4180de7d4f0eSAndy Whitcroft# if/while/etc brace do not go on next line, unless defining a do while loop,
4181de7d4f0eSAndy Whitcroft# or if that brace on the next line is for something else
41820fe3dc2bSJoe Perches		if ($line =~ /(.*)\b((?:if|while|for|switch|(?:[a-z_]+|)for_each[a-z_]+)\s*\(|do\b|else\b)/ && $line !~ /^.\s*\#/) {
4183773647a0SAndy Whitcroft			my $pre_ctx = "$1$2";
4184773647a0SAndy Whitcroft
41859c0ca6f9SAndy Whitcroft			my ($level, @ctx) = ctx_statement_level($linenr, $realcnt, 0);
41868eef05ddSJoe Perches
41878eef05ddSJoe Perches			if ($line =~ /^\+\t{6,}/) {
41888eef05ddSJoe Perches				WARN("DEEP_INDENTATION",
41898eef05ddSJoe Perches				     "Too many leading tabs - consider code refactoring\n" . $herecurr);
41908eef05ddSJoe Perches			}
41918eef05ddSJoe Perches
4192de7d4f0eSAndy Whitcroft			my $ctx_cnt = $realcnt - $#ctx - 1;
4193de7d4f0eSAndy Whitcroft			my $ctx = join("\n", @ctx);
4194de7d4f0eSAndy Whitcroft
4195548596d5SAndy Whitcroft			my $ctx_ln = $linenr;
4196548596d5SAndy Whitcroft			my $ctx_skip = $realcnt;
4197de7d4f0eSAndy Whitcroft
4198548596d5SAndy Whitcroft			while ($ctx_skip > $ctx_cnt || ($ctx_skip == $ctx_cnt &&
4199548596d5SAndy Whitcroft					defined $lines[$ctx_ln - 1] &&
4200548596d5SAndy Whitcroft					$lines[$ctx_ln - 1] =~ /^-/)) {
4201548596d5SAndy Whitcroft				##print "SKIP<$ctx_skip> CNT<$ctx_cnt>\n";
4202548596d5SAndy Whitcroft				$ctx_skip-- if (!defined $lines[$ctx_ln - 1] || $lines[$ctx_ln - 1] !~ /^-/);
4203773647a0SAndy Whitcroft				$ctx_ln++;
4204773647a0SAndy Whitcroft			}
4205548596d5SAndy Whitcroft
420653210168SAndy Whitcroft			#print "realcnt<$realcnt> ctx_cnt<$ctx_cnt>\n";
420753210168SAndy Whitcroft			#print "pre<$pre_ctx>\nline<$line>\nctx<$ctx>\nnext<$lines[$ctx_ln - 1]>\n";
4208773647a0SAndy Whitcroft
4209773647a0SAndy Whitcroft			if ($ctx !~ /{\s*/ && defined($lines[$ctx_ln - 1]) && $lines[$ctx_ln - 1] =~ /^\+\s*{/) {
4210000d1cc1SJoe Perches				ERROR("OPEN_BRACE",
4211000d1cc1SJoe Perches				      "that open brace { should be on the previous line\n" .
421201464f30SAndy Whitcroft					"$here\n$ctx\n$rawlines[$ctx_ln - 1]\n");
421300df344fSAndy Whitcroft			}
4214773647a0SAndy Whitcroft			if ($level == 0 && $pre_ctx !~ /}\s*while\s*\($/ &&
4215773647a0SAndy Whitcroft			    $ctx =~ /\)\s*\;\s*$/ &&
4216773647a0SAndy Whitcroft			    defined $lines[$ctx_ln - 1])
4217773647a0SAndy Whitcroft			{
42189c0ca6f9SAndy Whitcroft				my ($nlength, $nindent) = line_stats($lines[$ctx_ln - 1]);
42199c0ca6f9SAndy Whitcroft				if ($nindent > $indent) {
4220000d1cc1SJoe Perches					WARN("TRAILING_SEMICOLON",
4221000d1cc1SJoe Perches					     "trailing semicolon indicates no statements, indent implies otherwise\n" .
422201464f30SAndy Whitcroft						"$here\n$ctx\n$rawlines[$ctx_ln - 1]\n");
42239c0ca6f9SAndy Whitcroft				}
42249c0ca6f9SAndy Whitcroft			}
422500df344fSAndy Whitcroft		}
422600df344fSAndy Whitcroft
42274d001e4dSAndy Whitcroft# Check relative indent for conditionals and blocks.
4228f6950a73SJoe Perches		if ($line =~ /\b(?:(?:if|while|for|(?:[a-z_]+|)for_each[a-z_]+)\s*\(|(?:do|else)\b)/ && $line !~ /^.\s*#/ && $line !~ /\}\s*while\s*/) {
42293e469cdcSAndy Whitcroft			($stat, $cond, $line_nr_next, $remain_next, $off_next) =
42303e469cdcSAndy Whitcroft				ctx_statement_block($linenr, $realcnt, 0)
42313e469cdcSAndy Whitcroft					if (!defined $stat);
42324d001e4dSAndy Whitcroft			my ($s, $c) = ($stat, $cond);
42334d001e4dSAndy Whitcroft
42344d001e4dSAndy Whitcroft			substr($s, 0, length($c), '');
42354d001e4dSAndy Whitcroft
42369f5af480SJoe Perches			# remove inline comments
42379f5af480SJoe Perches			$s =~ s/$;/ /g;
42389f5af480SJoe Perches			$c =~ s/$;/ /g;
42394d001e4dSAndy Whitcroft
42404d001e4dSAndy Whitcroft			# Find out how long the conditional actually is.
42416f779c18SAndy Whitcroft			my @newlines = ($c =~ /\n/gs);
42426f779c18SAndy Whitcroft			my $cond_lines = 1 + $#newlines;
42434d001e4dSAndy Whitcroft
42449f5af480SJoe Perches			# Make sure we remove the line prefixes as we have
42459f5af480SJoe Perches			# none on the first line, and are going to readd them
42469f5af480SJoe Perches			# where necessary.
42479f5af480SJoe Perches			$s =~ s/\n./\n/gs;
42489f5af480SJoe Perches			while ($s =~ /\n\s+\\\n/) {
42499f5af480SJoe Perches				$cond_lines += $s =~ s/\n\s+\\\n/\n/g;
42509f5af480SJoe Perches			}
42519f5af480SJoe Perches
42524d001e4dSAndy Whitcroft			# We want to check the first line inside the block
42534d001e4dSAndy Whitcroft			# starting at the end of the conditional, so remove:
42544d001e4dSAndy Whitcroft			#  1) any blank line termination
42554d001e4dSAndy Whitcroft			#  2) any opening brace { on end of the line
42564d001e4dSAndy Whitcroft			#  3) any do (...) {
42574d001e4dSAndy Whitcroft			my $continuation = 0;
42584d001e4dSAndy Whitcroft			my $check = 0;
42594d001e4dSAndy Whitcroft			$s =~ s/^.*\bdo\b//;
42604d001e4dSAndy Whitcroft			$s =~ s/^\s*{//;
42614d001e4dSAndy Whitcroft			if ($s =~ s/^\s*\\//) {
42624d001e4dSAndy Whitcroft				$continuation = 1;
42634d001e4dSAndy Whitcroft			}
42649bd49efeSAndy Whitcroft			if ($s =~ s/^\s*?\n//) {
42654d001e4dSAndy Whitcroft				$check = 1;
42664d001e4dSAndy Whitcroft				$cond_lines++;
42674d001e4dSAndy Whitcroft			}
42684d001e4dSAndy Whitcroft
42694d001e4dSAndy Whitcroft			# Also ignore a loop construct at the end of a
42704d001e4dSAndy Whitcroft			# preprocessor statement.
42714d001e4dSAndy Whitcroft			if (($prevline =~ /^.\s*#\s*define\s/ ||
42724d001e4dSAndy Whitcroft			    $prevline =~ /\\\s*$/) && $continuation == 0) {
42734d001e4dSAndy Whitcroft				$check = 0;
42744d001e4dSAndy Whitcroft			}
42754d001e4dSAndy Whitcroft
42769bd49efeSAndy Whitcroft			my $cond_ptr = -1;
4277740504c6SAndy Whitcroft			$continuation = 0;
42789bd49efeSAndy Whitcroft			while ($cond_ptr != $cond_lines) {
42799bd49efeSAndy Whitcroft				$cond_ptr = $cond_lines;
42804d001e4dSAndy Whitcroft
4281f16fa28fSAndy Whitcroft				# If we see an #else/#elif then the code
4282f16fa28fSAndy Whitcroft				# is not linear.
4283f16fa28fSAndy Whitcroft				if ($s =~ /^\s*\#\s*(?:else|elif)/) {
4284f16fa28fSAndy Whitcroft					$check = 0;
4285f16fa28fSAndy Whitcroft				}
4286f16fa28fSAndy Whitcroft
42879bd49efeSAndy Whitcroft				# Ignore:
42889bd49efeSAndy Whitcroft				#  1) blank lines, they should be at 0,
42899bd49efeSAndy Whitcroft				#  2) preprocessor lines, and
42909bd49efeSAndy Whitcroft				#  3) labels.
4291740504c6SAndy Whitcroft				if ($continuation ||
4292740504c6SAndy Whitcroft				    $s =~ /^\s*?\n/ ||
42939bd49efeSAndy Whitcroft				    $s =~ /^\s*#\s*?/ ||
42949bd49efeSAndy Whitcroft				    $s =~ /^\s*$Ident\s*:/) {
4295740504c6SAndy Whitcroft					$continuation = ($s =~ /^.*?\\\n/) ? 1 : 0;
429630dad6ebSAndy Whitcroft					if ($s =~ s/^.*?\n//) {
42979bd49efeSAndy Whitcroft						$cond_lines++;
42989bd49efeSAndy Whitcroft					}
42994d001e4dSAndy Whitcroft				}
430030dad6ebSAndy Whitcroft			}
43014d001e4dSAndy Whitcroft
43024d001e4dSAndy Whitcroft			my (undef, $sindent) = line_stats("+" . $s);
43034d001e4dSAndy Whitcroft			my $stat_real = raw_line($linenr, $cond_lines);
43044d001e4dSAndy Whitcroft
43054d001e4dSAndy Whitcroft			# Check if either of these lines are modified, else
43064d001e4dSAndy Whitcroft			# this is not this patch's fault.
43074d001e4dSAndy Whitcroft			if (!defined($stat_real) ||
43084d001e4dSAndy Whitcroft			    $stat !~ /^\+/ && $stat_real !~ /^\+/) {
43094d001e4dSAndy Whitcroft				$check = 0;
43104d001e4dSAndy Whitcroft			}
43114d001e4dSAndy Whitcroft			if (defined($stat_real) && $cond_lines > 1) {
43124d001e4dSAndy Whitcroft				$stat_real = "[...]\n$stat_real";
43134d001e4dSAndy Whitcroft			}
43144d001e4dSAndy Whitcroft
43159bd49efeSAndy Whitcroft			#print "line<$line> prevline<$prevline> indent<$indent> sindent<$sindent> check<$check> continuation<$continuation> s<$s> cond_lines<$cond_lines> stat_real<$stat_real> stat<$stat>\n";
43164d001e4dSAndy Whitcroft
43179f5af480SJoe Perches			if ($check && $s ne '' &&
4318713a09deSAntonio Borneo			    (($sindent % $tabsize) != 0 ||
43199f5af480SJoe Perches			     ($sindent < $indent) ||
4320f6950a73SJoe Perches			     ($sindent == $indent &&
4321f6950a73SJoe Perches			      ($s !~ /^\s*(?:\}|\{|else\b)/)) ||
4322713a09deSAntonio Borneo			     ($sindent > $indent + $tabsize))) {
4323000d1cc1SJoe Perches				WARN("SUSPECT_CODE_INDENT",
4324000d1cc1SJoe Perches				     "suspect code indent for conditional statements ($indent, $sindent)\n" . $herecurr . "$stat_real\n");
43254d001e4dSAndy Whitcroft			}
43264d001e4dSAndy Whitcroft		}
43274d001e4dSAndy Whitcroft
43286c72ffaaSAndy Whitcroft		# Track the 'values' across context and added lines.
43296c72ffaaSAndy Whitcroft		my $opline = $line; $opline =~ s/^./ /;
43301f65f947SAndy Whitcroft		my ($curr_values, $curr_vars) =
43311f65f947SAndy Whitcroft				annotate_values($opline . "\n", $prev_values);
43326c72ffaaSAndy Whitcroft		$curr_values = $prev_values . $curr_values;
4333c2fdda0dSAndy Whitcroft		if ($dbg_values) {
4334c2fdda0dSAndy Whitcroft			my $outline = $opline; $outline =~ s/\t/ /g;
4335cf655043SAndy Whitcroft			print "$linenr > .$outline\n";
4336cf655043SAndy Whitcroft			print "$linenr > $curr_values\n";
43371f65f947SAndy Whitcroft			print "$linenr >  $curr_vars\n";
4338c2fdda0dSAndy Whitcroft		}
43396c72ffaaSAndy Whitcroft		$prev_values = substr($curr_values, -1);
43406c72ffaaSAndy Whitcroft
434100df344fSAndy Whitcroft#ignore lines not being added
43423705ce5bSJoe Perches		next if ($line =~ /^[^\+]/);
434300df344fSAndy Whitcroft
434499ca38c2SJoe Perches# check for self assignments used to avoid compiler warnings
434599ca38c2SJoe Perches# e.g.:	int foo = foo, *bar = NULL;
434699ca38c2SJoe Perches#	struct foo bar = *(&(bar));
434799ca38c2SJoe Perches		if ($line =~ /^\+\s*(?:$Declare)?([A-Za-z_][A-Za-z\d_]*)\s*=/) {
434899ca38c2SJoe Perches			my $var = $1;
434999ca38c2SJoe Perches			if ($line =~ /^\+\s*(?:$Declare)?$var\s*=\s*(?:$var|\*\s*\(?\s*&\s*\(?\s*$var\s*\)?\s*\)?)\s*[;,]/) {
435099ca38c2SJoe Perches				WARN("SELF_ASSIGNMENT",
435199ca38c2SJoe Perches				     "Do not use self-assignments to avoid compiler warnings\n" . $herecurr);
435299ca38c2SJoe Perches			}
435399ca38c2SJoe Perches		}
435499ca38c2SJoe Perches
435511ca40a0SJoe Perches# check for dereferences that span multiple lines
435611ca40a0SJoe Perches		if ($prevline =~ /^\+.*$Lval\s*(?:\.|->)\s*$/ &&
435711ca40a0SJoe Perches		    $line =~ /^\+\s*(?!\#\s*(?!define\s+|if))\s*$Lval/) {
435811ca40a0SJoe Perches			$prevline =~ /($Lval\s*(?:\.|->))\s*$/;
435911ca40a0SJoe Perches			my $ref = $1;
436011ca40a0SJoe Perches			$line =~ /^.\s*($Lval)/;
436111ca40a0SJoe Perches			$ref .= $1;
436211ca40a0SJoe Perches			$ref =~ s/\s//g;
436311ca40a0SJoe Perches			WARN("MULTILINE_DEREFERENCE",
436411ca40a0SJoe Perches			     "Avoid multiple line dereference - prefer '$ref'\n" . $hereprev);
436511ca40a0SJoe Perches		}
436611ca40a0SJoe Perches
4367a1ce18e4SJoe Perches# check for declarations of signed or unsigned without int
4368c8447115SJoe Perches		while ($line =~ m{\b($Declare)\s*(?!char\b|short\b|int\b|long\b)\s*($Ident)?\s*[=,;\[\)\(]}g) {
4369a1ce18e4SJoe Perches			my $type = $1;
4370a1ce18e4SJoe Perches			my $var = $2;
4371207a8e84SJoe Perches			$var = "" if (!defined $var);
4372207a8e84SJoe Perches			if ($type =~ /^(?:(?:$Storage|$Inline|$Attribute)\s+)*((?:un)?signed)((?:\s*\*)*)\s*$/) {
4373a1ce18e4SJoe Perches				my $sign = $1;
4374a1ce18e4SJoe Perches				my $pointer = $2;
4375a1ce18e4SJoe Perches
4376a1ce18e4SJoe Perches				$pointer = "" if (!defined $pointer);
4377a1ce18e4SJoe Perches
4378a1ce18e4SJoe Perches				if (WARN("UNSPECIFIED_INT",
4379a1ce18e4SJoe Perches					 "Prefer '" . trim($sign) . " int" . rtrim($pointer) . "' to bare use of '$sign" . rtrim($pointer) . "'\n" . $herecurr) &&
4380a1ce18e4SJoe Perches				    $fix) {
4381a1ce18e4SJoe Perches					my $decl = trim($sign) . " int ";
4382207a8e84SJoe Perches					my $comp_pointer = $pointer;
4383207a8e84SJoe Perches					$comp_pointer =~ s/\s//g;
4384207a8e84SJoe Perches					$decl .= $comp_pointer;
4385207a8e84SJoe Perches					$decl = rtrim($decl) if ($var eq "");
4386207a8e84SJoe Perches					$fixed[$fixlinenr] =~ s@\b$sign\s*\Q$pointer\E\s*$var\b@$decl$var@;
4387a1ce18e4SJoe Perches				}
4388a1ce18e4SJoe Perches			}
4389a1ce18e4SJoe Perches		}
4390a1ce18e4SJoe Perches
4391653d4876SAndy Whitcroft# TEST: allow direct testing of the type matcher.
43927429c690SAndy Whitcroft		if ($dbg_type) {
43937429c690SAndy Whitcroft			if ($line =~ /^.\s*$Declare\s*$/) {
4394000d1cc1SJoe Perches				ERROR("TEST_TYPE",
4395000d1cc1SJoe Perches				      "TEST: is type\n" . $herecurr);
43967429c690SAndy Whitcroft			} elsif ($dbg_type > 1 && $line =~ /^.+($Declare)/) {
4397000d1cc1SJoe Perches				ERROR("TEST_NOT_TYPE",
4398000d1cc1SJoe Perches				      "TEST: is not type ($1 is)\n". $herecurr);
43997429c690SAndy Whitcroft			}
4400653d4876SAndy Whitcroft			next;
4401653d4876SAndy Whitcroft		}
4402a1ef277eSAndy Whitcroft# TEST: allow direct testing of the attribute matcher.
4403a1ef277eSAndy Whitcroft		if ($dbg_attr) {
44049360b0e5SAndy Whitcroft			if ($line =~ /^.\s*$Modifier\s*$/) {
4405000d1cc1SJoe Perches				ERROR("TEST_ATTR",
4406000d1cc1SJoe Perches				      "TEST: is attr\n" . $herecurr);
44079360b0e5SAndy Whitcroft			} elsif ($dbg_attr > 1 && $line =~ /^.+($Modifier)/) {
4408000d1cc1SJoe Perches				ERROR("TEST_NOT_ATTR",
4409000d1cc1SJoe Perches				      "TEST: is not attr ($1 is)\n". $herecurr);
4410a1ef277eSAndy Whitcroft			}
4411a1ef277eSAndy Whitcroft			next;
4412a1ef277eSAndy Whitcroft		}
4413653d4876SAndy Whitcroft
4414f0a594c1SAndy Whitcroft# check for initialisation to aggregates open brace on the next line
441599423c20SAndy Whitcroft		if ($line =~ /^.\s*{/ &&
441699423c20SAndy Whitcroft		    $prevline =~ /(?:^|[^=])=\s*$/) {
4417d752fcc8SJoe Perches			if (ERROR("OPEN_BRACE",
4418d752fcc8SJoe Perches				  "that open brace { should be on the previous line\n" . $hereprev) &&
4419f2d7e4d4SJoe Perches			    $fix && $prevline =~ /^\+/ && $line =~ /^\+/) {
4420f2d7e4d4SJoe Perches				fix_delete_line($fixlinenr - 1, $prevrawline);
4421f2d7e4d4SJoe Perches				fix_delete_line($fixlinenr, $rawline);
4422d752fcc8SJoe Perches				my $fixedline = $prevrawline;
4423d752fcc8SJoe Perches				$fixedline =~ s/\s*=\s*$/ = {/;
4424f2d7e4d4SJoe Perches				fix_insert_line($fixlinenr, $fixedline);
4425d752fcc8SJoe Perches				$fixedline = $line;
44268d81ae05SCyril Bur				$fixedline =~ s/^(.\s*)\{\s*/$1/;
4427f2d7e4d4SJoe Perches				fix_insert_line($fixlinenr, $fixedline);
4428d752fcc8SJoe Perches			}
4429f0a594c1SAndy Whitcroft		}
4430f0a594c1SAndy Whitcroft
443100df344fSAndy Whitcroft#
443200df344fSAndy Whitcroft# Checks which are anchored on the added line.
443300df344fSAndy Whitcroft#
443400df344fSAndy Whitcroft
4435653d4876SAndy Whitcroft# check for malformed paths in #include statements (uses RAW line)
4436c45dcabdSAndy Whitcroft		if ($rawline =~ m{^.\s*\#\s*include\s+[<"](.*)[">]}) {
4437653d4876SAndy Whitcroft			my $path = $1;
4438653d4876SAndy Whitcroft			if ($path =~ m{//}) {
4439000d1cc1SJoe Perches				ERROR("MALFORMED_INCLUDE",
4440495e9d84SJoe Perches				      "malformed #include filename\n" . $herecurr);
4441495e9d84SJoe Perches			}
4442495e9d84SJoe Perches			if ($path =~ "^uapi/" && $realfile =~ m@\binclude/uapi/@) {
4443495e9d84SJoe Perches				ERROR("UAPI_INCLUDE",
4444495e9d84SJoe Perches				      "No #include in ...include/uapi/... should use a uapi/ path prefix\n" . $herecurr);
4445653d4876SAndy Whitcroft			}
4446653d4876SAndy Whitcroft		}
4447653d4876SAndy Whitcroft
444800df344fSAndy Whitcroft# no C99 // comments
444900df344fSAndy Whitcroft		if ($line =~ m{//}) {
44503705ce5bSJoe Perches			if (ERROR("C99_COMMENTS",
44513705ce5bSJoe Perches				  "do not use C99 // comments\n" . $herecurr) &&
44523705ce5bSJoe Perches			    $fix) {
4453194f66fcSJoe Perches				my $line = $fixed[$fixlinenr];
44543705ce5bSJoe Perches				if ($line =~ /\/\/(.*)$/) {
44553705ce5bSJoe Perches					my $comment = trim($1);
4456194f66fcSJoe Perches					$fixed[$fixlinenr] =~ s@\/\/(.*)$@/\* $comment \*/@;
44573705ce5bSJoe Perches				}
44583705ce5bSJoe Perches			}
445900df344fSAndy Whitcroft		}
446000df344fSAndy Whitcroft		# Remove C99 comments.
44610a920b5bSAndy Whitcroft		$line =~ s@//.*@@;
44626c72ffaaSAndy Whitcroft		$opline =~ s@//.*@@;
44630a920b5bSAndy Whitcroft
44642b474a1aSAndy Whitcroft# EXPORT_SYMBOL should immediately follow the thing it is exporting, consider
44652b474a1aSAndy Whitcroft# the whole statement.
44662b474a1aSAndy Whitcroft#print "APW <$lines[$realline_next - 1]>\n";
44672b474a1aSAndy Whitcroft		if (defined $realline_next &&
44682b474a1aSAndy Whitcroft		    exists $lines[$realline_next - 1] &&
44692b474a1aSAndy Whitcroft		    !defined $suppress_export{$realline_next} &&
447036794822SChristoph Hellwig		    ($lines[$realline_next - 1] =~ /EXPORT_SYMBOL.*\((.*)\)/)) {
44713cbf62dfSAndy Whitcroft			# Handle definitions which produce identifiers with
44723cbf62dfSAndy Whitcroft			# a prefix:
44733cbf62dfSAndy Whitcroft			#   XXX(foo);
44743cbf62dfSAndy Whitcroft			#   EXPORT_SYMBOL(something_foo);
4475653d4876SAndy Whitcroft			my $name = $1;
447670a11659SJoe Perches			$name =~ s/^\s*($Ident).*/$1/;
447787a53877SAndy Whitcroft			if ($stat =~ /^(?:.\s*}\s*\n)?.([A-Z_]+)\s*\(\s*($Ident)/ &&
44783cbf62dfSAndy Whitcroft			    $name =~ /^${Ident}_$2/) {
44793cbf62dfSAndy Whitcroft#print "FOO C name<$name>\n";
44803cbf62dfSAndy Whitcroft				$suppress_export{$realline_next} = 1;
44813cbf62dfSAndy Whitcroft
44823cbf62dfSAndy Whitcroft			} elsif ($stat !~ /(?:
44832b474a1aSAndy Whitcroft				\n.}\s*$|
448448012058SAndy Whitcroft				^.DEFINE_$Ident\(\Q$name\E\)|
448548012058SAndy Whitcroft				^.DECLARE_$Ident\(\Q$name\E\)|
448648012058SAndy Whitcroft				^.LIST_HEAD\(\Q$name\E\)|
44872b474a1aSAndy Whitcroft				^.(?:$Storage\s+)?$Type\s*\(\s*\*\s*\Q$name\E\s*\)\s*\(|
44882b474a1aSAndy Whitcroft				\b\Q$name\E(?:\s+$Attribute)*\s*(?:;|=|\[|\()
448948012058SAndy Whitcroft			    )/x) {
44902b474a1aSAndy Whitcroft#print "FOO A<$lines[$realline_next - 1]> stat<$stat> name<$name>\n";
44912b474a1aSAndy Whitcroft				$suppress_export{$realline_next} = 2;
44922b474a1aSAndy Whitcroft			} else {
44932b474a1aSAndy Whitcroft				$suppress_export{$realline_next} = 1;
44940a920b5bSAndy Whitcroft			}
44950a920b5bSAndy Whitcroft		}
44962b474a1aSAndy Whitcroft		if (!defined $suppress_export{$linenr} &&
44972b474a1aSAndy Whitcroft		    $prevline =~ /^.\s*$/ &&
449836794822SChristoph Hellwig		    ($line =~ /EXPORT_SYMBOL.*\((.*)\)/)) {
44992b474a1aSAndy Whitcroft#print "FOO B <$lines[$linenr - 1]>\n";
45002b474a1aSAndy Whitcroft			$suppress_export{$linenr} = 2;
45012b474a1aSAndy Whitcroft		}
45022b474a1aSAndy Whitcroft		if (defined $suppress_export{$linenr} &&
45032b474a1aSAndy Whitcroft		    $suppress_export{$linenr} == 2) {
4504000d1cc1SJoe Perches			WARN("EXPORT_SYMBOL",
4505000d1cc1SJoe Perches			     "EXPORT_SYMBOL(foo); should immediately follow its function/variable\n" . $herecurr);
45062b474a1aSAndy Whitcroft		}
45070a920b5bSAndy Whitcroft
45085150bda4SJoe Eloff# check for global initialisers.
45095b8f82e1SSong Liu		if ($line =~ /^\+$Type\s*$Ident(?:\s+$Modifier)*\s*=\s*($zero_initializer)\s*;/ &&
45105b8f82e1SSong Liu		    !exclude_global_initialisers($realfile)) {
4511d5e616fcSJoe Perches			if (ERROR("GLOBAL_INITIALISERS",
45126d32f7a3SJoe Perches				  "do not initialise globals to $1\n" . $herecurr) &&
4513d5e616fcSJoe Perches			    $fix) {
45146d32f7a3SJoe Perches				$fixed[$fixlinenr] =~ s/(^.$Type\s*$Ident(?:\s+$Modifier)*)\s*=\s*$zero_initializer\s*;/$1;/;
4515d5e616fcSJoe Perches			}
4516f0a594c1SAndy Whitcroft		}
45170a920b5bSAndy Whitcroft# check for static initialisers.
45186d32f7a3SJoe Perches		if ($line =~ /^\+.*\bstatic\s.*=\s*($zero_initializer)\s*;/) {
4519d5e616fcSJoe Perches			if (ERROR("INITIALISED_STATIC",
45206d32f7a3SJoe Perches				  "do not initialise statics to $1\n" .
4521d5e616fcSJoe Perches				      $herecurr) &&
4522d5e616fcSJoe Perches			    $fix) {
45236d32f7a3SJoe Perches				$fixed[$fixlinenr] =~ s/(\bstatic\s.*?)\s*=\s*$zero_initializer\s*;/$1;/;
4524d5e616fcSJoe Perches			}
45250a920b5bSAndy Whitcroft		}
45260a920b5bSAndy Whitcroft
45271813087dSJoe Perches# check for misordered declarations of char/short/int/long with signed/unsigned
45281813087dSJoe Perches		while ($sline =~ m{(\b$TypeMisordered\b)}g) {
45291813087dSJoe Perches			my $tmp = trim($1);
45301813087dSJoe Perches			WARN("MISORDERED_TYPE",
45311813087dSJoe Perches			     "type '$tmp' should be specified in [[un]signed] [short|int|long|long long] order\n" . $herecurr);
45321813087dSJoe Perches		}
45331813087dSJoe Perches
4534809e082eSJoe Perches# check for unnecessary <signed> int declarations of short/long/long long
4535809e082eSJoe Perches		while ($sline =~ m{\b($TypeMisordered(\s*\*)*|$C90_int_types)\b}g) {
4536809e082eSJoe Perches			my $type = trim($1);
4537809e082eSJoe Perches			next if ($type !~ /\bint\b/);
4538809e082eSJoe Perches			next if ($type !~ /\b(?:short|long\s+long|long)\b/);
4539809e082eSJoe Perches			my $new_type = $type;
4540809e082eSJoe Perches			$new_type =~ s/\b\s*int\s*\b/ /;
4541809e082eSJoe Perches			$new_type =~ s/\b\s*(?:un)?signed\b\s*/ /;
4542809e082eSJoe Perches			$new_type =~ s/^const\s+//;
4543809e082eSJoe Perches			$new_type = "unsigned $new_type" if ($type =~ /\bunsigned\b/);
4544809e082eSJoe Perches			$new_type = "const $new_type" if ($type =~ /^const\b/);
4545809e082eSJoe Perches			$new_type =~ s/\s+/ /g;
4546809e082eSJoe Perches			$new_type = trim($new_type);
4547809e082eSJoe Perches			if (WARN("UNNECESSARY_INT",
4548809e082eSJoe Perches				 "Prefer '$new_type' over '$type' as the int is unnecessary\n" . $herecurr) &&
4549809e082eSJoe Perches			    $fix) {
4550809e082eSJoe Perches				$fixed[$fixlinenr] =~ s/\b\Q$type\E\b/$new_type/;
4551809e082eSJoe Perches			}
4552809e082eSJoe Perches		}
4553809e082eSJoe Perches
4554cb710ecaSJoe Perches# check for static const char * arrays.
4555cb710ecaSJoe Perches		if ($line =~ /\bstatic\s+const\s+char\s*\*\s*(\w+)\s*\[\s*\]\s*=\s*/) {
4556000d1cc1SJoe Perches			WARN("STATIC_CONST_CHAR_ARRAY",
4557000d1cc1SJoe Perches			     "static const char * array should probably be static const char * const\n" .
4558cb710ecaSJoe Perches				$herecurr);
4559cb710ecaSJoe Perches		}
4560cb710ecaSJoe Perches
456177b8c0a8SJoe Perches# check for initialized const char arrays that should be static const
456277b8c0a8SJoe Perches		if ($line =~ /^\+\s*const\s+(char|unsigned\s+char|_*u8|(?:[us]_)?int8_t)\s+\w+\s*\[\s*(?:\w+\s*)?\]\s*=\s*"/) {
456377b8c0a8SJoe Perches			if (WARN("STATIC_CONST_CHAR_ARRAY",
456477b8c0a8SJoe Perches				 "const array should probably be static const\n" . $herecurr) &&
456577b8c0a8SJoe Perches			    $fix) {
456677b8c0a8SJoe Perches				$fixed[$fixlinenr] =~ s/(^.\s*)const\b/${1}static const/;
456777b8c0a8SJoe Perches			}
456877b8c0a8SJoe Perches		}
456977b8c0a8SJoe Perches
4570cb710ecaSJoe Perches# check for static char foo[] = "bar" declarations.
4571cb710ecaSJoe Perches		if ($line =~ /\bstatic\s+char\s+(\w+)\s*\[\s*\]\s*=\s*"/) {
4572000d1cc1SJoe Perches			WARN("STATIC_CONST_CHAR_ARRAY",
4573000d1cc1SJoe Perches			     "static char array declaration should probably be static const char\n" .
4574cb710ecaSJoe Perches				$herecurr);
4575cb710ecaSJoe Perches		}
4576cb710ecaSJoe Perches
4577ab7e23f3SJoe Perches# check for const <foo> const where <foo> is not a pointer or array type
4578ab7e23f3SJoe Perches		if ($sline =~ /\bconst\s+($BasicType)\s+const\b/) {
4579ab7e23f3SJoe Perches			my $found = $1;
4580ab7e23f3SJoe Perches			if ($sline =~ /\bconst\s+\Q$found\E\s+const\b\s*\*/) {
4581ab7e23f3SJoe Perches				WARN("CONST_CONST",
4582ab7e23f3SJoe Perches				     "'const $found const *' should probably be 'const $found * const'\n" . $herecurr);
4583ab7e23f3SJoe Perches			} elsif ($sline !~ /\bconst\s+\Q$found\E\s+const\s+\w+\s*\[/) {
4584ab7e23f3SJoe Perches				WARN("CONST_CONST",
4585ab7e23f3SJoe Perches				     "'const $found const' should probably be 'const $found'\n" . $herecurr);
4586ab7e23f3SJoe Perches			}
4587ab7e23f3SJoe Perches		}
4588ab7e23f3SJoe Perches
458973169765SJoe Perches# check for const static or static <non ptr type> const declarations
459073169765SJoe Perches# prefer 'static const <foo>' over 'const static <foo>' and 'static <foo> const'
459173169765SJoe Perches		if ($sline =~ /^\+\s*const\s+static\s+($Type)\b/ ||
459273169765SJoe Perches		    $sline =~ /^\+\s*static\s+($BasicType)\s+const\b/) {
459373169765SJoe Perches			if (WARN("STATIC_CONST",
459473169765SJoe Perches				 "Move const after static - use 'static const $1'\n" . $herecurr) &&
459573169765SJoe Perches			    $fix) {
459673169765SJoe Perches				$fixed[$fixlinenr] =~ s/\bconst\s+static\b/static const/;
459773169765SJoe Perches				$fixed[$fixlinenr] =~ s/\bstatic\s+($BasicType)\s+const\b/static const $1/;
459873169765SJoe Perches			}
459973169765SJoe Perches		}
460073169765SJoe Perches
46019b0fa60dSJoe Perches# check for non-global char *foo[] = {"bar", ...} declarations.
46029b0fa60dSJoe Perches		if ($line =~ /^.\s+(?:static\s+|const\s+)?char\s+\*\s*\w+\s*\[\s*\]\s*=\s*\{/) {
46039b0fa60dSJoe Perches			WARN("STATIC_CONST_CHAR_ARRAY",
46049b0fa60dSJoe Perches			     "char * array declaration might be better as static const\n" .
46059b0fa60dSJoe Perches				$herecurr);
46069b0fa60dSJoe Perches		}
46079b0fa60dSJoe Perches
4608b598b670SJoe Perches# check for sizeof(foo)/sizeof(foo[0]) that could be ARRAY_SIZE(foo)
4609b598b670SJoe Perches		if ($line =~ m@\bsizeof\s*\(\s*($Lval)\s*\)@) {
4610b598b670SJoe Perches			my $array = $1;
4611b598b670SJoe Perches			if ($line =~ m@\b(sizeof\s*\(\s*\Q$array\E\s*\)\s*/\s*sizeof\s*\(\s*\Q$array\E\s*\[\s*0\s*\]\s*\))@) {
4612b598b670SJoe Perches				my $array_div = $1;
4613b598b670SJoe Perches				if (WARN("ARRAY_SIZE",
4614b598b670SJoe Perches					 "Prefer ARRAY_SIZE($array)\n" . $herecurr) &&
4615b598b670SJoe Perches				    $fix) {
4616b598b670SJoe Perches					$fixed[$fixlinenr] =~ s/\Q$array_div\E/ARRAY_SIZE($array)/;
4617b598b670SJoe Perches				}
4618b598b670SJoe Perches			}
4619b598b670SJoe Perches		}
4620b598b670SJoe Perches
4621b36190c5SJoe Perches# check for function declarations without arguments like "int foo()"
462216b7f3c8SJoe Perches		if ($line =~ /(\b$Type\s*$Ident)\s*\(\s*\)/) {
4623b36190c5SJoe Perches			if (ERROR("FUNCTION_WITHOUT_ARGS",
4624b36190c5SJoe Perches				  "Bad function definition - $1() should probably be $1(void)\n" . $herecurr) &&
4625b36190c5SJoe Perches			    $fix) {
4626194f66fcSJoe Perches				$fixed[$fixlinenr] =~ s/(\b($Type)\s+($Ident))\s*\(\s*\)/$2 $3(void)/;
4627b36190c5SJoe Perches			}
4628b36190c5SJoe Perches		}
4629b36190c5SJoe Perches
4630653d4876SAndy Whitcroft# check for new typedefs, only function parameters and sparse annotations
4631653d4876SAndy Whitcroft# make sense.
4632653d4876SAndy Whitcroft		if ($line =~ /\btypedef\s/ &&
46338054576dSAndy Whitcroft		    $line !~ /\btypedef\s+$Type\s*\(\s*\*?$Ident\s*\)\s*\(/ &&
4634c45dcabdSAndy Whitcroft		    $line !~ /\btypedef\s+$Type\s+$Ident\s*\(/ &&
46358ed22cadSAndy Whitcroft		    $line !~ /\b$typeTypedefs\b/ &&
463646d832f5SMichael S. Tsirkin		    $line !~ /\b__bitwise\b/) {
4637000d1cc1SJoe Perches			WARN("NEW_TYPEDEFS",
4638000d1cc1SJoe Perches			     "do not add new typedefs\n" . $herecurr);
46390a920b5bSAndy Whitcroft		}
46400a920b5bSAndy Whitcroft
46410a920b5bSAndy Whitcroft# * goes on variable not on type
464265863862SAndy Whitcroft		# (char*[ const])
4643bfcb2cc7SAndy Whitcroft		while ($line =~ m{(\($NonptrType(\s*(?:$Modifier\b\s*|\*\s*)+)\))}g) {
4644bfcb2cc7SAndy Whitcroft			#print "AA<$1>\n";
46453705ce5bSJoe Perches			my ($ident, $from, $to) = ($1, $2, $2);
4646d8aaf121SAndy Whitcroft
464765863862SAndy Whitcroft			# Should start with a space.
464865863862SAndy Whitcroft			$to =~ s/^(\S)/ $1/;
464965863862SAndy Whitcroft			# Should not end with a space.
465065863862SAndy Whitcroft			$to =~ s/\s+$//;
465165863862SAndy Whitcroft			# '*'s should not have spaces between.
4652f9a0b3d1SAndy Whitcroft			while ($to =~ s/\*\s+\*/\*\*/) {
465365863862SAndy Whitcroft			}
4654d8aaf121SAndy Whitcroft
46553705ce5bSJoe Perches##			print "1: from<$from> to<$to> ident<$ident>\n";
465665863862SAndy Whitcroft			if ($from ne $to) {
46573705ce5bSJoe Perches				if (ERROR("POINTER_LOCATION",
46583705ce5bSJoe Perches					  "\"(foo$from)\" should be \"(foo$to)\"\n" .  $herecurr) &&
46593705ce5bSJoe Perches				    $fix) {
46603705ce5bSJoe Perches					my $sub_from = $ident;
46613705ce5bSJoe Perches					my $sub_to = $ident;
46623705ce5bSJoe Perches					$sub_to =~ s/\Q$from\E/$to/;
4663194f66fcSJoe Perches					$fixed[$fixlinenr] =~
46643705ce5bSJoe Perches					    s@\Q$sub_from\E@$sub_to@;
46653705ce5bSJoe Perches				}
466665863862SAndy Whitcroft			}
4667bfcb2cc7SAndy Whitcroft		}
4668bfcb2cc7SAndy Whitcroft		while ($line =~ m{(\b$NonptrType(\s*(?:$Modifier\b\s*|\*\s*)+)($Ident))}g) {
4669bfcb2cc7SAndy Whitcroft			#print "BB<$1>\n";
46703705ce5bSJoe Perches			my ($match, $from, $to, $ident) = ($1, $2, $2, $3);
4671d8aaf121SAndy Whitcroft
467265863862SAndy Whitcroft			# Should start with a space.
467365863862SAndy Whitcroft			$to =~ s/^(\S)/ $1/;
467465863862SAndy Whitcroft			# Should not end with a space.
467565863862SAndy Whitcroft			$to =~ s/\s+$//;
467665863862SAndy Whitcroft			# '*'s should not have spaces between.
4677f9a0b3d1SAndy Whitcroft			while ($to =~ s/\*\s+\*/\*\*/) {
467865863862SAndy Whitcroft			}
467965863862SAndy Whitcroft			# Modifiers should have spaces.
468065863862SAndy Whitcroft			$to =~ s/(\b$Modifier$)/$1 /;
468165863862SAndy Whitcroft
46823705ce5bSJoe Perches##			print "2: from<$from> to<$to> ident<$ident>\n";
4683667026e7SAndy Whitcroft			if ($from ne $to && $ident !~ /^$Modifier$/) {
46843705ce5bSJoe Perches				if (ERROR("POINTER_LOCATION",
46853705ce5bSJoe Perches					  "\"foo${from}bar\" should be \"foo${to}bar\"\n" .  $herecurr) &&
46863705ce5bSJoe Perches				    $fix) {
46873705ce5bSJoe Perches
46883705ce5bSJoe Perches					my $sub_from = $match;
46893705ce5bSJoe Perches					my $sub_to = $match;
46903705ce5bSJoe Perches					$sub_to =~ s/\Q$from\E/$to/;
4691194f66fcSJoe Perches					$fixed[$fixlinenr] =~
46923705ce5bSJoe Perches					    s@\Q$sub_from\E@$sub_to@;
46933705ce5bSJoe Perches				}
469465863862SAndy Whitcroft			}
46950a920b5bSAndy Whitcroft		}
46960a920b5bSAndy Whitcroft
46979d3e3c70SJoe Perches# avoid BUG() or BUG_ON()
46989d3e3c70SJoe Perches		if ($line =~ /\b(?:BUG|BUG_ON)\b/) {
46990675a8fbSJean Delvare			my $msg_level = \&WARN;
47000675a8fbSJean Delvare			$msg_level = \&CHK if ($file);
47010675a8fbSJean Delvare			&{$msg_level}("AVOID_BUG",
47029d3e3c70SJoe Perches				      "Avoid crashing the kernel - try using WARN_ON & recovery code rather than BUG() or BUG_ON()\n" . $herecurr);
47039d3e3c70SJoe Perches		}
47040a920b5bSAndy Whitcroft
47059d3e3c70SJoe Perches# avoid LINUX_VERSION_CODE
47068905a67cSAndy Whitcroft		if ($line =~ /\bLINUX_VERSION_CODE\b/) {
4707000d1cc1SJoe Perches			WARN("LINUX_VERSION_CODE",
4708000d1cc1SJoe Perches			     "LINUX_VERSION_CODE should be avoided, code should be for the version to which it is merged\n" . $herecurr);
47098905a67cSAndy Whitcroft		}
47108905a67cSAndy Whitcroft
471117441227SJoe Perches# check for uses of printk_ratelimit
471217441227SJoe Perches		if ($line =~ /\bprintk_ratelimit\s*\(/) {
4713000d1cc1SJoe Perches			WARN("PRINTK_RATELIMITED",
4714000d1cc1SJoe Perches			     "Prefer printk_ratelimited or pr_<level>_ratelimited to printk_ratelimit\n" . $herecurr);
471517441227SJoe Perches		}
471617441227SJoe Perches
4717eeef5733SJoe Perches# printk should use KERN_* levels
4718eeef5733SJoe Perches		if ($line =~ /\bprintk\s*\(\s*(?!KERN_[A-Z]+\b)/) {
4719000d1cc1SJoe Perches			WARN("PRINTK_WITHOUT_KERN_LEVEL",
4720eeef5733SJoe Perches			     "printk() should include KERN_<LEVEL> facility level\n" . $herecurr);
472100df344fSAndy Whitcroft		}
47220a920b5bSAndy Whitcroft
4723f5eea3b0SJoe Perches# prefer variants of (subsystem|netdev|dev|pr)_<level> to printk(KERN_<LEVEL>
4724f5eea3b0SJoe Perches		if ($line =~ /\b(printk(_once|_ratelimited)?)\s*\(\s*KERN_([A-Z]+)/) {
4725f5eea3b0SJoe Perches			my $printk = $1;
4726f5eea3b0SJoe Perches			my $modifier = $2;
4727f5eea3b0SJoe Perches			my $orig = $3;
4728f5eea3b0SJoe Perches			$modifier = "" if (!defined($modifier));
4729243f3803SJoe Perches			my $level = lc($orig);
4730243f3803SJoe Perches			$level = "warn" if ($level eq "warning");
47318f26b837SJoe Perches			my $level2 = $level;
47328f26b837SJoe Perches			$level2 = "dbg" if ($level eq "debug");
4733f5eea3b0SJoe Perches			$level .= $modifier;
4734f5eea3b0SJoe Perches			$level2 .= $modifier;
4735243f3803SJoe Perches			WARN("PREFER_PR_LEVEL",
4736f5eea3b0SJoe Perches			     "Prefer [subsystem eg: netdev]_$level2([subsystem]dev, ... then dev_$level2(dev, ... then pr_$level(...  to $printk(KERN_$orig ...\n" . $herecurr);
4737243f3803SJoe Perches		}
4738243f3803SJoe Perches
4739f5eea3b0SJoe Perches# prefer dev_<level> to dev_printk(KERN_<LEVEL>
4740dc139313SJoe Perches		if ($line =~ /\bdev_printk\s*\(\s*KERN_([A-Z]+)/) {
4741dc139313SJoe Perches			my $orig = $1;
4742dc139313SJoe Perches			my $level = lc($orig);
4743dc139313SJoe Perches			$level = "warn" if ($level eq "warning");
4744dc139313SJoe Perches			$level = "dbg" if ($level eq "debug");
4745dc139313SJoe Perches			WARN("PREFER_DEV_LEVEL",
4746dc139313SJoe Perches			     "Prefer dev_$level(... to dev_printk(KERN_$orig, ...\n" . $herecurr);
4747dc139313SJoe Perches		}
4748dc139313SJoe Perches
47498020b253SNicolas Boichat# trace_printk should not be used in production code.
47508020b253SNicolas Boichat		if ($line =~ /\b(trace_printk|trace_puts|ftrace_vprintk)\s*\(/) {
47518020b253SNicolas Boichat			WARN("TRACE_PRINTK",
47528020b253SNicolas Boichat			     "Do not use $1() in production code (this can be ignored if built only with a debug config option)\n" . $herecurr);
47538020b253SNicolas Boichat		}
47548020b253SNicolas Boichat
475591c9afafSAndy Lutomirski# ENOSYS means "bad syscall nr" and nothing else.  This will have a small
475691c9afafSAndy Lutomirski# number of false positives, but assembly files are not checked, so at
475791c9afafSAndy Lutomirski# least the arch entry code will not trigger this warning.
475891c9afafSAndy Lutomirski		if ($line =~ /\bENOSYS\b/) {
475991c9afafSAndy Lutomirski			WARN("ENOSYS",
476091c9afafSAndy Lutomirski			     "ENOSYS means 'invalid syscall nr' and nothing else\n" . $herecurr);
476191c9afafSAndy Lutomirski		}
476291c9afafSAndy Lutomirski
47636b9ea5ffSJakub Kicinski# ENOTSUPP is not a standard error code and should be avoided in new patches.
47646b9ea5ffSJakub Kicinski# Folks usually mean EOPNOTSUPP (also called ENOTSUP), when they type ENOTSUPP.
47656b9ea5ffSJakub Kicinski# Similarly to ENOSYS warning a small number of false positives is expected.
47666b9ea5ffSJakub Kicinski		if (!$file && $line =~ /\bENOTSUPP\b/) {
47676b9ea5ffSJakub Kicinski			if (WARN("ENOTSUPP",
47686b9ea5ffSJakub Kicinski				 "ENOTSUPP is not a SUSV4 error code, prefer EOPNOTSUPP\n" . $herecurr) &&
47696b9ea5ffSJakub Kicinski			    $fix) {
47706b9ea5ffSJakub Kicinski				$fixed[$fixlinenr] =~ s/\bENOTSUPP\b/EOPNOTSUPP/;
47716b9ea5ffSJakub Kicinski			}
47726b9ea5ffSJakub Kicinski		}
47736b9ea5ffSJakub Kicinski
4774653d4876SAndy Whitcroft# function brace can't be on same line, except for #defines of do while,
4775653d4876SAndy Whitcroft# or if closed on same line
47765b57980dSJoe Perches		if ($perl_version_ok &&
47772d453e3bSJoe Perches		    $sline =~ /$Type\s*$Ident\s*$balanced_parens\s*\{/ &&
47782d453e3bSJoe Perches		    $sline !~ /\#\s*define\b.*do\s*\{/ &&
47792d453e3bSJoe Perches		    $sline !~ /}/) {
47808d182478SJoe Perches			if (ERROR("OPEN_BRACE",
47812d453e3bSJoe Perches				  "open brace '{' following function definitions go on the next line\n" . $herecurr) &&
47828d182478SJoe Perches			    $fix) {
47838d182478SJoe Perches				fix_delete_line($fixlinenr, $rawline);
47848d182478SJoe Perches				my $fixed_line = $rawline;
478503f49351SDwaipayan Ray				$fixed_line =~ /(^..*$Type\s*$Ident\(.*\)\s*)\{(.*)$/;
47868d182478SJoe Perches				my $line1 = $1;
47878d182478SJoe Perches				my $line2 = $2;
47888d182478SJoe Perches				fix_insert_line($fixlinenr, ltrim($line1));
47898d182478SJoe Perches				fix_insert_line($fixlinenr, "\+{");
47908d182478SJoe Perches				if ($line2 !~ /^\s*$/) {
47918d182478SJoe Perches					fix_insert_line($fixlinenr, "\+\t" . trim($line2));
47928d182478SJoe Perches				}
47938d182478SJoe Perches			}
47940a920b5bSAndy Whitcroft		}
4795653d4876SAndy Whitcroft
47968905a67cSAndy Whitcroft# open braces for enum, union and struct go on the same line.
47978905a67cSAndy Whitcroft		if ($line =~ /^.\s*{/ &&
47988905a67cSAndy Whitcroft		    $prevline =~ /^.\s*(?:typedef\s+)?(enum|union|struct)(?:\s+$Ident)?\s*$/) {
47998d182478SJoe Perches			if (ERROR("OPEN_BRACE",
48008d182478SJoe Perches				  "open brace '{' following $1 go on the same line\n" . $hereprev) &&
48018d182478SJoe Perches			    $fix && $prevline =~ /^\+/ && $line =~ /^\+/) {
48028d182478SJoe Perches				fix_delete_line($fixlinenr - 1, $prevrawline);
48038d182478SJoe Perches				fix_delete_line($fixlinenr, $rawline);
48048d182478SJoe Perches				my $fixedline = rtrim($prevrawline) . " {";
48058d182478SJoe Perches				fix_insert_line($fixlinenr, $fixedline);
48068d182478SJoe Perches				$fixedline = $rawline;
48078d81ae05SCyril Bur				$fixedline =~ s/^(.\s*)\{\s*/$1\t/;
48088d182478SJoe Perches				if ($fixedline !~ /^\+\s*$/) {
48098d182478SJoe Perches					fix_insert_line($fixlinenr, $fixedline);
48108d182478SJoe Perches				}
48118d182478SJoe Perches			}
48128905a67cSAndy Whitcroft		}
48138905a67cSAndy Whitcroft
48140c73b4ebSAndy Whitcroft# missing space after union, struct or enum definition
48153705ce5bSJoe Perches		if ($line =~ /^.\s*(?:typedef\s+)?(enum|union|struct)(?:\s+$Ident){1,2}[=\{]/) {
48163705ce5bSJoe Perches			if (WARN("SPACING",
48173705ce5bSJoe Perches				 "missing space after $1 definition\n" . $herecurr) &&
48183705ce5bSJoe Perches			    $fix) {
4819194f66fcSJoe Perches				$fixed[$fixlinenr] =~
48203705ce5bSJoe Perches				    s/^(.\s*(?:typedef\s+)?(?:enum|union|struct)(?:\s+$Ident){1,2})([=\{])/$1 $2/;
48213705ce5bSJoe Perches			}
48220c73b4ebSAndy Whitcroft		}
48230c73b4ebSAndy Whitcroft
482431070b5dSJoe Perches# Function pointer declarations
482531070b5dSJoe Perches# check spacing between type, funcptr, and args
482631070b5dSJoe Perches# canonical declaration is "type (*funcptr)(args...)"
482791f72e9cSJoe Perches		if ($line =~ /^.\s*($Declare)\((\s*)\*(\s*)($Ident)(\s*)\)(\s*)\(/) {
482831070b5dSJoe Perches			my $declare = $1;
482931070b5dSJoe Perches			my $pre_pointer_space = $2;
483031070b5dSJoe Perches			my $post_pointer_space = $3;
483131070b5dSJoe Perches			my $funcname = $4;
483231070b5dSJoe Perches			my $post_funcname_space = $5;
483331070b5dSJoe Perches			my $pre_args_space = $6;
483431070b5dSJoe Perches
483591f72e9cSJoe Perches# the $Declare variable will capture all spaces after the type
483691f72e9cSJoe Perches# so check it for a missing trailing missing space but pointer return types
483791f72e9cSJoe Perches# don't need a space so don't warn for those.
483891f72e9cSJoe Perches			my $post_declare_space = "";
483991f72e9cSJoe Perches			if ($declare =~ /(\s+)$/) {
484091f72e9cSJoe Perches				$post_declare_space = $1;
484191f72e9cSJoe Perches				$declare = rtrim($declare);
484291f72e9cSJoe Perches			}
484391f72e9cSJoe Perches			if ($declare !~ /\*$/ && $post_declare_space =~ /^$/) {
484431070b5dSJoe Perches				WARN("SPACING",
484531070b5dSJoe Perches				     "missing space after return type\n" . $herecurr);
484691f72e9cSJoe Perches				$post_declare_space = " ";
484731070b5dSJoe Perches			}
484831070b5dSJoe Perches
484931070b5dSJoe Perches# unnecessary space "type  (*funcptr)(args...)"
485091f72e9cSJoe Perches# This test is not currently implemented because these declarations are
485191f72e9cSJoe Perches# equivalent to
485291f72e9cSJoe Perches#	int  foo(int bar, ...)
485391f72e9cSJoe Perches# and this is form shouldn't/doesn't generate a checkpatch warning.
485491f72e9cSJoe Perches#
485591f72e9cSJoe Perches#			elsif ($declare =~ /\s{2,}$/) {
485691f72e9cSJoe Perches#				WARN("SPACING",
485791f72e9cSJoe Perches#				     "Multiple spaces after return type\n" . $herecurr);
485891f72e9cSJoe Perches#			}
485931070b5dSJoe Perches
486031070b5dSJoe Perches# unnecessary space "type ( *funcptr)(args...)"
486131070b5dSJoe Perches			if (defined $pre_pointer_space &&
486231070b5dSJoe Perches			    $pre_pointer_space =~ /^\s/) {
486331070b5dSJoe Perches				WARN("SPACING",
486431070b5dSJoe Perches				     "Unnecessary space after function pointer open parenthesis\n" . $herecurr);
486531070b5dSJoe Perches			}
486631070b5dSJoe Perches
486731070b5dSJoe Perches# unnecessary space "type (* funcptr)(args...)"
486831070b5dSJoe Perches			if (defined $post_pointer_space &&
486931070b5dSJoe Perches			    $post_pointer_space =~ /^\s/) {
487031070b5dSJoe Perches				WARN("SPACING",
487131070b5dSJoe Perches				     "Unnecessary space before function pointer name\n" . $herecurr);
487231070b5dSJoe Perches			}
487331070b5dSJoe Perches
487431070b5dSJoe Perches# unnecessary space "type (*funcptr )(args...)"
487531070b5dSJoe Perches			if (defined $post_funcname_space &&
487631070b5dSJoe Perches			    $post_funcname_space =~ /^\s/) {
487731070b5dSJoe Perches				WARN("SPACING",
487831070b5dSJoe Perches				     "Unnecessary space after function pointer name\n" . $herecurr);
487931070b5dSJoe Perches			}
488031070b5dSJoe Perches
488131070b5dSJoe Perches# unnecessary space "type (*funcptr) (args...)"
488231070b5dSJoe Perches			if (defined $pre_args_space &&
488331070b5dSJoe Perches			    $pre_args_space =~ /^\s/) {
488431070b5dSJoe Perches				WARN("SPACING",
488531070b5dSJoe Perches				     "Unnecessary space before function pointer arguments\n" . $herecurr);
488631070b5dSJoe Perches			}
488731070b5dSJoe Perches
488831070b5dSJoe Perches			if (show_type("SPACING") && $fix) {
4889194f66fcSJoe Perches				$fixed[$fixlinenr] =~
489091f72e9cSJoe Perches				    s/^(.\s*)$Declare\s*\(\s*\*\s*$Ident\s*\)\s*\(/$1 . $declare . $post_declare_space . '(*' . $funcname . ')('/ex;
489131070b5dSJoe Perches			}
489231070b5dSJoe Perches		}
489331070b5dSJoe Perches
48948d31cfceSAndy Whitcroft# check for spacing round square brackets; allowed:
48958d31cfceSAndy Whitcroft#  1. with a type on the left -- int [] a;
4896fe2a7dbcSAndy Whitcroft#  2. at the beginning of a line for slice initialisers -- [0...10] = 5,
4897fe2a7dbcSAndy Whitcroft#  3. inside a curly brace -- = { [0...10] = 5 }
48988d31cfceSAndy Whitcroft		while ($line =~ /(.*?\s)\[/g) {
48998d31cfceSAndy Whitcroft			my ($where, $prefix) = ($-[1], $1);
49008d31cfceSAndy Whitcroft			if ($prefix !~ /$Type\s+$/ &&
4901fe2a7dbcSAndy Whitcroft			    ($where != 0 || $prefix !~ /^.\s+$/) &&
490238dca988SHeinrich Schuchardt			    $prefix !~ /[{,:]\s+$/) {
49033705ce5bSJoe Perches				if (ERROR("BRACKET_SPACE",
49043705ce5bSJoe Perches					  "space prohibited before open square bracket '['\n" . $herecurr) &&
49053705ce5bSJoe Perches				    $fix) {
4906194f66fcSJoe Perches				    $fixed[$fixlinenr] =~
49073705ce5bSJoe Perches					s/^(\+.*?)\s+\[/$1\[/;
49083705ce5bSJoe Perches				}
49098d31cfceSAndy Whitcroft			}
49108d31cfceSAndy Whitcroft		}
49118d31cfceSAndy Whitcroft
4912f0a594c1SAndy Whitcroft# check for spaces between functions and their parentheses.
49136c72ffaaSAndy Whitcroft		while ($line =~ /($Ident)\s+\(/g) {
4914c2fdda0dSAndy Whitcroft			my $name = $1;
4915773647a0SAndy Whitcroft			my $ctx_before = substr($line, 0, $-[1]);
4916773647a0SAndy Whitcroft			my $ctx = "$ctx_before$name";
4917c2fdda0dSAndy Whitcroft
4918c2fdda0dSAndy Whitcroft			# Ignore those directives where spaces _are_ permitted.
4919773647a0SAndy Whitcroft			if ($name =~ /^(?:
4920773647a0SAndy Whitcroft				if|for|while|switch|return|case|
4921773647a0SAndy Whitcroft				volatile|__volatile__|
4922773647a0SAndy Whitcroft				__attribute__|format|__extension__|
4923773647a0SAndy Whitcroft				asm|__asm__)$/x)
4924773647a0SAndy Whitcroft			{
4925c2fdda0dSAndy Whitcroft			# cpp #define statements have non-optional spaces, ie
4926c2fdda0dSAndy Whitcroft			# if there is a space between the name and the open
4927c2fdda0dSAndy Whitcroft			# parenthesis it is simply not a parameter group.
4928c45dcabdSAndy Whitcroft			} elsif ($ctx_before =~ /^.\s*\#\s*define\s*$/) {
4929773647a0SAndy Whitcroft
4930773647a0SAndy Whitcroft			# cpp #elif statement condition may start with a (
4931c45dcabdSAndy Whitcroft			} elsif ($ctx =~ /^.\s*\#\s*elif\s*$/) {
4932c2fdda0dSAndy Whitcroft
4933c2fdda0dSAndy Whitcroft			# If this whole things ends with a type its most
4934c2fdda0dSAndy Whitcroft			# likely a typedef for a function.
4935773647a0SAndy Whitcroft			} elsif ($ctx =~ /$Type$/) {
4936c2fdda0dSAndy Whitcroft
4937c2fdda0dSAndy Whitcroft			} else {
49383705ce5bSJoe Perches				if (WARN("SPACING",
49393705ce5bSJoe Perches					 "space prohibited between function name and open parenthesis '('\n" . $herecurr) &&
49403705ce5bSJoe Perches					     $fix) {
4941194f66fcSJoe Perches					$fixed[$fixlinenr] =~
49423705ce5bSJoe Perches					    s/\b$name\s+\(/$name\(/;
49433705ce5bSJoe Perches				}
4944f0a594c1SAndy Whitcroft			}
49456c72ffaaSAndy Whitcroft		}
49469a4cad4eSEric Nelson
4947653d4876SAndy Whitcroft# Check operator spacing.
49480a920b5bSAndy Whitcroft		if (!($line=~/\#\s*include/)) {
49493705ce5bSJoe Perches			my $fixed_line = "";
49503705ce5bSJoe Perches			my $line_fixed = 0;
49513705ce5bSJoe Perches
49529c0ca6f9SAndy Whitcroft			my $ops = qr{
49539c0ca6f9SAndy Whitcroft				<<=|>>=|<=|>=|==|!=|
49549c0ca6f9SAndy Whitcroft				\+=|-=|\*=|\/=|%=|\^=|\|=|&=|
49559c0ca6f9SAndy Whitcroft				=>|->|<<|>>|<|>|=|!|~|
49561f65f947SAndy Whitcroft				&&|\|\||,|\^|\+\+|--|&|\||\+|-|\*|\/|%|
495784731623SJoe Perches				\?:|\?|:
49589c0ca6f9SAndy Whitcroft			}x;
4959cf655043SAndy Whitcroft			my @elements = split(/($ops|;)/, $opline);
49603705ce5bSJoe Perches
49613705ce5bSJoe Perches##			print("element count: <" . $#elements . ">\n");
49623705ce5bSJoe Perches##			foreach my $el (@elements) {
49633705ce5bSJoe Perches##				print("el: <$el>\n");
49643705ce5bSJoe Perches##			}
49653705ce5bSJoe Perches
49663705ce5bSJoe Perches			my @fix_elements = ();
496700df344fSAndy Whitcroft			my $off = 0;
49686c72ffaaSAndy Whitcroft
49693705ce5bSJoe Perches			foreach my $el (@elements) {
49703705ce5bSJoe Perches				push(@fix_elements, substr($rawline, $off, length($el)));
49713705ce5bSJoe Perches				$off += length($el);
49723705ce5bSJoe Perches			}
49733705ce5bSJoe Perches
49743705ce5bSJoe Perches			$off = 0;
49753705ce5bSJoe Perches
49766c72ffaaSAndy Whitcroft			my $blank = copy_spacing($opline);
4977b34c648bSJoe Perches			my $last_after = -1;
49786c72ffaaSAndy Whitcroft
49790a920b5bSAndy Whitcroft			for (my $n = 0; $n < $#elements; $n += 2) {
49803705ce5bSJoe Perches
49813705ce5bSJoe Perches				my $good = $fix_elements[$n] . $fix_elements[$n + 1];
49823705ce5bSJoe Perches
49833705ce5bSJoe Perches##				print("n: <$n> good: <$good>\n");
49843705ce5bSJoe Perches
49854a0df2efSAndy Whitcroft				$off += length($elements[$n]);
49864a0df2efSAndy Whitcroft
498725985edcSLucas De Marchi				# Pick up the preceding and succeeding characters.
4988773647a0SAndy Whitcroft				my $ca = substr($opline, 0, $off);
4989773647a0SAndy Whitcroft				my $cc = '';
4990773647a0SAndy Whitcroft				if (length($opline) >= ($off + length($elements[$n + 1]))) {
4991773647a0SAndy Whitcroft					$cc = substr($opline, $off + length($elements[$n + 1]));
4992773647a0SAndy Whitcroft				}
4993773647a0SAndy Whitcroft				my $cb = "$ca$;$cc";
4994773647a0SAndy Whitcroft
49954a0df2efSAndy Whitcroft				my $a = '';
49964a0df2efSAndy Whitcroft				$a = 'V' if ($elements[$n] ne '');
49974a0df2efSAndy Whitcroft				$a = 'W' if ($elements[$n] =~ /\s$/);
4998cf655043SAndy Whitcroft				$a = 'C' if ($elements[$n] =~ /$;$/);
49994a0df2efSAndy Whitcroft				$a = 'B' if ($elements[$n] =~ /(\[|\()$/);
50004a0df2efSAndy Whitcroft				$a = 'O' if ($elements[$n] eq '');
5001773647a0SAndy Whitcroft				$a = 'E' if ($ca =~ /^\s*$/);
50024a0df2efSAndy Whitcroft
50030a920b5bSAndy Whitcroft				my $op = $elements[$n + 1];
50044a0df2efSAndy Whitcroft
50054a0df2efSAndy Whitcroft				my $c = '';
50060a920b5bSAndy Whitcroft				if (defined $elements[$n + 2]) {
50074a0df2efSAndy Whitcroft					$c = 'V' if ($elements[$n + 2] ne '');
50084a0df2efSAndy Whitcroft					$c = 'W' if ($elements[$n + 2] =~ /^\s/);
5009cf655043SAndy Whitcroft					$c = 'C' if ($elements[$n + 2] =~ /^$;/);
50104a0df2efSAndy Whitcroft					$c = 'B' if ($elements[$n + 2] =~ /^(\)|\]|;)/);
50114a0df2efSAndy Whitcroft					$c = 'O' if ($elements[$n + 2] eq '');
50128b1b3378SAndy Whitcroft					$c = 'E' if ($elements[$n + 2] =~ /^\s*\\$/);
50134a0df2efSAndy Whitcroft				} else {
50144a0df2efSAndy Whitcroft					$c = 'E';
50150a920b5bSAndy Whitcroft				}
50160a920b5bSAndy Whitcroft
50174a0df2efSAndy Whitcroft				my $ctx = "${a}x${c}";
50184a0df2efSAndy Whitcroft
50194a0df2efSAndy Whitcroft				my $at = "(ctx:$ctx)";
50204a0df2efSAndy Whitcroft
50216c72ffaaSAndy Whitcroft				my $ptr = substr($blank, 0, $off) . "^";
5022de7d4f0eSAndy Whitcroft				my $hereptr = "$hereline$ptr\n";
50230a920b5bSAndy Whitcroft
502474048ed8SAndy Whitcroft				# Pull out the value of this operator.
50256c72ffaaSAndy Whitcroft				my $op_type = substr($curr_values, $off + 1, 1);
50260a920b5bSAndy Whitcroft
50271f65f947SAndy Whitcroft				# Get the full operator variant.
50281f65f947SAndy Whitcroft				my $opv = $op . substr($curr_vars, $off, 1);
50291f65f947SAndy Whitcroft
503013214adfSAndy Whitcroft				# Ignore operators passed as parameters.
503113214adfSAndy Whitcroft				if ($op_type ne 'V' &&
5032d7fe8065SSam Bobroff				    $ca =~ /\s$/ && $cc =~ /^\s*[,\)]/) {
503313214adfSAndy Whitcroft
5034cf655043SAndy Whitcroft#				# Ignore comments
5035cf655043SAndy Whitcroft#				} elsif ($op =~ /^$;+$/) {
503613214adfSAndy Whitcroft
5037d8aaf121SAndy Whitcroft				# ; should have either the end of line or a space or \ after it
503813214adfSAndy Whitcroft				} elsif ($op eq ';') {
5039cf655043SAndy Whitcroft					if ($ctx !~ /.x[WEBC]/ &&
5040cf655043SAndy Whitcroft					    $cc !~ /^\\/ && $cc !~ /^;/) {
50413705ce5bSJoe Perches						if (ERROR("SPACING",
50423705ce5bSJoe Perches							  "space required after that '$op' $at\n" . $hereptr)) {
5043b34c648bSJoe Perches							$good = $fix_elements[$n] . trim($fix_elements[$n + 1]) . " ";
50443705ce5bSJoe Perches							$line_fixed = 1;
50453705ce5bSJoe Perches						}
5046d8aaf121SAndy Whitcroft					}
5047d8aaf121SAndy Whitcroft
5048d8aaf121SAndy Whitcroft				# // is a comment
5049d8aaf121SAndy Whitcroft				} elsif ($op eq '//') {
50500a920b5bSAndy Whitcroft
5051b00e4814SJoe Perches				#   :   when part of a bitfield
5052b00e4814SJoe Perches				} elsif ($opv eq ':B') {
5053b00e4814SJoe Perches					# skip the bitfield test for now
5054b00e4814SJoe Perches
50551f65f947SAndy Whitcroft				# No spaces for:
50561f65f947SAndy Whitcroft				#   ->
5057b00e4814SJoe Perches				} elsif ($op eq '->') {
50584a0df2efSAndy Whitcroft					if ($ctx =~ /Wx.|.xW/) {
50593705ce5bSJoe Perches						if (ERROR("SPACING",
50603705ce5bSJoe Perches							  "spaces prohibited around that '$op' $at\n" . $hereptr)) {
5061b34c648bSJoe Perches							$good = rtrim($fix_elements[$n]) . trim($fix_elements[$n + 1]);
50623705ce5bSJoe Perches							if (defined $fix_elements[$n + 2]) {
50633705ce5bSJoe Perches								$fix_elements[$n + 2] =~ s/^\s+//;
50643705ce5bSJoe Perches							}
5065b34c648bSJoe Perches							$line_fixed = 1;
50663705ce5bSJoe Perches						}
50670a920b5bSAndy Whitcroft					}
50680a920b5bSAndy Whitcroft
50692381097bSJoe Perches				# , must not have a space before and must have a space on the right.
50700a920b5bSAndy Whitcroft				} elsif ($op eq ',') {
50712381097bSJoe Perches					my $rtrim_before = 0;
50722381097bSJoe Perches					my $space_after = 0;
50732381097bSJoe Perches					if ($ctx =~ /Wx./) {
50742381097bSJoe Perches						if (ERROR("SPACING",
50752381097bSJoe Perches							  "space prohibited before that '$op' $at\n" . $hereptr)) {
50762381097bSJoe Perches							$line_fixed = 1;
50772381097bSJoe Perches							$rtrim_before = 1;
50782381097bSJoe Perches						}
50792381097bSJoe Perches					}
5080cf655043SAndy Whitcroft					if ($ctx !~ /.x[WEC]/ && $cc !~ /^}/) {
50813705ce5bSJoe Perches						if (ERROR("SPACING",
50823705ce5bSJoe Perches							  "space required after that '$op' $at\n" . $hereptr)) {
50833705ce5bSJoe Perches							$line_fixed = 1;
5084b34c648bSJoe Perches							$last_after = $n;
50852381097bSJoe Perches							$space_after = 1;
50862381097bSJoe Perches						}
50872381097bSJoe Perches					}
50882381097bSJoe Perches					if ($rtrim_before || $space_after) {
50892381097bSJoe Perches						if ($rtrim_before) {
50902381097bSJoe Perches							$good = rtrim($fix_elements[$n]) . trim($fix_elements[$n + 1]);
50912381097bSJoe Perches						} else {
50922381097bSJoe Perches							$good = $fix_elements[$n] . trim($fix_elements[$n + 1]);
50932381097bSJoe Perches						}
50942381097bSJoe Perches						if ($space_after) {
50952381097bSJoe Perches							$good .= " ";
50963705ce5bSJoe Perches						}
50970a920b5bSAndy Whitcroft					}
50980a920b5bSAndy Whitcroft
50999c0ca6f9SAndy Whitcroft				# '*' as part of a type definition -- reported already.
510074048ed8SAndy Whitcroft				} elsif ($opv eq '*_') {
51019c0ca6f9SAndy Whitcroft					#warn "'*' is part of type\n";
51029c0ca6f9SAndy Whitcroft
51039c0ca6f9SAndy Whitcroft				# unary operators should have a space before and
51049c0ca6f9SAndy Whitcroft				# none after.  May be left adjacent to another
51059c0ca6f9SAndy Whitcroft				# unary operator, or a cast
51069c0ca6f9SAndy Whitcroft				} elsif ($op eq '!' || $op eq '~' ||
510774048ed8SAndy Whitcroft					 $opv eq '*U' || $opv eq '-U' ||
51080d413866SAndy Whitcroft					 $opv eq '&U' || $opv eq '&&U') {
5109cf655043SAndy Whitcroft					if ($ctx !~ /[WEBC]x./ && $ca !~ /(?:\)|!|~|\*|-|\&|\||\+\+|\-\-|\{)$/) {
51103705ce5bSJoe Perches						if (ERROR("SPACING",
51113705ce5bSJoe Perches							  "space required before that '$op' $at\n" . $hereptr)) {
5112b34c648bSJoe Perches							if ($n != $last_after + 2) {
5113b34c648bSJoe Perches								$good = $fix_elements[$n] . " " . ltrim($fix_elements[$n + 1]);
51143705ce5bSJoe Perches								$line_fixed = 1;
51153705ce5bSJoe Perches							}
51160a920b5bSAndy Whitcroft						}
5117b34c648bSJoe Perches					}
5118a3340b35SAndy Whitcroft					if ($op eq '*' && $cc =~/\s*$Modifier\b/) {
5119171ae1a4SAndy Whitcroft						# A unary '*' may be const
5120171ae1a4SAndy Whitcroft
5121171ae1a4SAndy Whitcroft					} elsif ($ctx =~ /.xW/) {
51223705ce5bSJoe Perches						if (ERROR("SPACING",
51233705ce5bSJoe Perches							  "space prohibited after that '$op' $at\n" . $hereptr)) {
5124b34c648bSJoe Perches							$good = $fix_elements[$n] . rtrim($fix_elements[$n + 1]);
51253705ce5bSJoe Perches							if (defined $fix_elements[$n + 2]) {
51263705ce5bSJoe Perches								$fix_elements[$n + 2] =~ s/^\s+//;
51273705ce5bSJoe Perches							}
5128b34c648bSJoe Perches							$line_fixed = 1;
51293705ce5bSJoe Perches						}
51300a920b5bSAndy Whitcroft					}
51310a920b5bSAndy Whitcroft
51320a920b5bSAndy Whitcroft				# unary ++ and unary -- are allowed no space on one side.
51330a920b5bSAndy Whitcroft				} elsif ($op eq '++' or $op eq '--') {
5134773647a0SAndy Whitcroft					if ($ctx !~ /[WEOBC]x[^W]/ && $ctx !~ /[^W]x[WOBEC]/) {
51353705ce5bSJoe Perches						if (ERROR("SPACING",
51363705ce5bSJoe Perches							  "space required one side of that '$op' $at\n" . $hereptr)) {
5137b34c648bSJoe Perches							$good = $fix_elements[$n] . trim($fix_elements[$n + 1]) . " ";
51383705ce5bSJoe Perches							$line_fixed = 1;
51393705ce5bSJoe Perches						}
51400a920b5bSAndy Whitcroft					}
5141773647a0SAndy Whitcroft					if ($ctx =~ /Wx[BE]/ ||
5142773647a0SAndy Whitcroft					    ($ctx =~ /Wx./ && $cc =~ /^;/)) {
51433705ce5bSJoe Perches						if (ERROR("SPACING",
51443705ce5bSJoe Perches							  "space prohibited before that '$op' $at\n" . $hereptr)) {
5145b34c648bSJoe Perches							$good = rtrim($fix_elements[$n]) . trim($fix_elements[$n + 1]);
51463705ce5bSJoe Perches							$line_fixed = 1;
51473705ce5bSJoe Perches						}
5148653d4876SAndy Whitcroft					}
5149773647a0SAndy Whitcroft					if ($ctx =~ /ExW/) {
51503705ce5bSJoe Perches						if (ERROR("SPACING",
51513705ce5bSJoe Perches							  "space prohibited after that '$op' $at\n" . $hereptr)) {
5152b34c648bSJoe Perches							$good = $fix_elements[$n] . trim($fix_elements[$n + 1]);
51533705ce5bSJoe Perches							if (defined $fix_elements[$n + 2]) {
51543705ce5bSJoe Perches								$fix_elements[$n + 2] =~ s/^\s+//;
5155773647a0SAndy Whitcroft							}
5156b34c648bSJoe Perches							$line_fixed = 1;
51573705ce5bSJoe Perches						}
51583705ce5bSJoe Perches					}
51590a920b5bSAndy Whitcroft
51600a920b5bSAndy Whitcroft				# << and >> may either have or not have spaces both sides
51619c0ca6f9SAndy Whitcroft				} elsif ($op eq '<<' or $op eq '>>' or
51629c0ca6f9SAndy Whitcroft					 $op eq '&' or $op eq '^' or $op eq '|' or
51639c0ca6f9SAndy Whitcroft					 $op eq '+' or $op eq '-' or
5164c2fdda0dSAndy Whitcroft					 $op eq '*' or $op eq '/' or
5165c2fdda0dSAndy Whitcroft					 $op eq '%')
51660a920b5bSAndy Whitcroft				{
5167d2e025f3SJoe Perches					if ($check) {
5168d2e025f3SJoe Perches						if (defined $fix_elements[$n + 2] && $ctx !~ /[EW]x[EW]/) {
5169d2e025f3SJoe Perches							if (CHK("SPACING",
5170d2e025f3SJoe Perches								"spaces preferred around that '$op' $at\n" . $hereptr)) {
5171d2e025f3SJoe Perches								$good = rtrim($fix_elements[$n]) . " " . trim($fix_elements[$n + 1]) . " ";
5172d2e025f3SJoe Perches								$fix_elements[$n + 2] =~ s/^\s+//;
5173d2e025f3SJoe Perches								$line_fixed = 1;
5174d2e025f3SJoe Perches							}
5175d2e025f3SJoe Perches						} elsif (!defined $fix_elements[$n + 2] && $ctx !~ /Wx[OE]/) {
5176d2e025f3SJoe Perches							if (CHK("SPACING",
5177d2e025f3SJoe Perches								"space preferred before that '$op' $at\n" . $hereptr)) {
5178d2e025f3SJoe Perches								$good = rtrim($fix_elements[$n]) . " " . trim($fix_elements[$n + 1]);
5179d2e025f3SJoe Perches								$line_fixed = 1;
5180d2e025f3SJoe Perches							}
5181d2e025f3SJoe Perches						}
5182d2e025f3SJoe Perches					} elsif ($ctx =~ /Wx[^WCE]|[^WCE]xW/) {
51833705ce5bSJoe Perches						if (ERROR("SPACING",
51843705ce5bSJoe Perches							  "need consistent spacing around '$op' $at\n" . $hereptr)) {
5185b34c648bSJoe Perches							$good = rtrim($fix_elements[$n]) . " " . trim($fix_elements[$n + 1]) . " ";
5186b34c648bSJoe Perches							if (defined $fix_elements[$n + 2]) {
5187b34c648bSJoe Perches								$fix_elements[$n + 2] =~ s/^\s+//;
5188b34c648bSJoe Perches							}
51893705ce5bSJoe Perches							$line_fixed = 1;
51903705ce5bSJoe Perches						}
51910a920b5bSAndy Whitcroft					}
51920a920b5bSAndy Whitcroft
51931f65f947SAndy Whitcroft				# A colon needs no spaces before when it is
51941f65f947SAndy Whitcroft				# terminating a case value or a label.
51951f65f947SAndy Whitcroft				} elsif ($opv eq ':C' || $opv eq ':L') {
5196263afd39SChris Down					if ($ctx =~ /Wx./ and $realfile !~ m@.*\.lds\.h$@) {
51973705ce5bSJoe Perches						if (ERROR("SPACING",
51983705ce5bSJoe Perches							  "space prohibited before that '$op' $at\n" . $hereptr)) {
5199b34c648bSJoe Perches							$good = rtrim($fix_elements[$n]) . trim($fix_elements[$n + 1]);
52003705ce5bSJoe Perches							$line_fixed = 1;
52013705ce5bSJoe Perches						}
52021f65f947SAndy Whitcroft					}
52031f65f947SAndy Whitcroft
52040a920b5bSAndy Whitcroft				# All the others need spaces both sides.
5205cf655043SAndy Whitcroft				} elsif ($ctx !~ /[EWC]x[CWE]/) {
52061f65f947SAndy Whitcroft					my $ok = 0;
52071f65f947SAndy Whitcroft
520822f2a2efSAndy Whitcroft					# Ignore email addresses <foo@bar>
52091f65f947SAndy Whitcroft					if (($op eq '<' &&
52101f65f947SAndy Whitcroft					     $cc =~ /^\S+\@\S+>/) ||
52111f65f947SAndy Whitcroft					    ($op eq '>' &&
52121f65f947SAndy Whitcroft					     $ca =~ /<\S+\@\S+$/))
52131f65f947SAndy Whitcroft					{
52141f65f947SAndy Whitcroft						$ok = 1;
52151f65f947SAndy Whitcroft					}
52161f65f947SAndy Whitcroft
5217e0df7e1fSJoe Perches					# for asm volatile statements
5218e0df7e1fSJoe Perches					# ignore a colon with another
5219e0df7e1fSJoe Perches					# colon immediately before or after
5220e0df7e1fSJoe Perches					if (($op eq ':') &&
5221e0df7e1fSJoe Perches					    ($ca =~ /:$/ || $cc =~ /^:/)) {
5222e0df7e1fSJoe Perches						$ok = 1;
5223e0df7e1fSJoe Perches					}
5224e0df7e1fSJoe Perches
522584731623SJoe Perches					# messages are ERROR, but ?: are CHK
52261f65f947SAndy Whitcroft					if ($ok == 0) {
52270675a8fbSJean Delvare						my $msg_level = \&ERROR;
52280675a8fbSJean Delvare						$msg_level = \&CHK if (($op eq '?:' || $op eq '?' || $op eq ':') && $ctx =~ /VxV/);
522984731623SJoe Perches
52300675a8fbSJean Delvare						if (&{$msg_level}("SPACING",
52313705ce5bSJoe Perches								  "spaces required around that '$op' $at\n" . $hereptr)) {
5232b34c648bSJoe Perches							$good = rtrim($fix_elements[$n]) . " " . trim($fix_elements[$n + 1]) . " ";
5233b34c648bSJoe Perches							if (defined $fix_elements[$n + 2]) {
5234b34c648bSJoe Perches								$fix_elements[$n + 2] =~ s/^\s+//;
5235b34c648bSJoe Perches							}
52363705ce5bSJoe Perches							$line_fixed = 1;
52373705ce5bSJoe Perches						}
52380a920b5bSAndy Whitcroft					}
523922f2a2efSAndy Whitcroft				}
52404a0df2efSAndy Whitcroft				$off += length($elements[$n + 1]);
52413705ce5bSJoe Perches
52423705ce5bSJoe Perches##				print("n: <$n> GOOD: <$good>\n");
52433705ce5bSJoe Perches
52443705ce5bSJoe Perches				$fixed_line = $fixed_line . $good;
52450a920b5bSAndy Whitcroft			}
52463705ce5bSJoe Perches
52473705ce5bSJoe Perches			if (($#elements % 2) == 0) {
52483705ce5bSJoe Perches				$fixed_line = $fixed_line . $fix_elements[$#elements];
52493705ce5bSJoe Perches			}
52503705ce5bSJoe Perches
5251194f66fcSJoe Perches			if ($fix && $line_fixed && $fixed_line ne $fixed[$fixlinenr]) {
5252194f66fcSJoe Perches				$fixed[$fixlinenr] = $fixed_line;
52533705ce5bSJoe Perches			}
52543705ce5bSJoe Perches
52553705ce5bSJoe Perches
52560a920b5bSAndy Whitcroft		}
52570a920b5bSAndy Whitcroft
5258786b6326SJoe Perches# check for whitespace before a non-naked semicolon
5259d2e248e7SJoe Perches		if ($line =~ /^\+.*\S\s+;\s*$/) {
5260786b6326SJoe Perches			if (WARN("SPACING",
5261786b6326SJoe Perches				 "space prohibited before semicolon\n" . $herecurr) &&
5262786b6326SJoe Perches			    $fix) {
5263194f66fcSJoe Perches				1 while $fixed[$fixlinenr] =~
5264786b6326SJoe Perches				    s/^(\+.*\S)\s+;/$1;/;
5265786b6326SJoe Perches			}
5266786b6326SJoe Perches		}
5267786b6326SJoe Perches
5268f0a594c1SAndy Whitcroft# check for multiple assignments
5269f0a594c1SAndy Whitcroft		if ($line =~ /^.\s*$Lval\s*=\s*$Lval\s*=(?!=)/) {
5270000d1cc1SJoe Perches			CHK("MULTIPLE_ASSIGNMENTS",
5271000d1cc1SJoe Perches			    "multiple assignments should be avoided\n" . $herecurr);
5272f0a594c1SAndy Whitcroft		}
5273f0a594c1SAndy Whitcroft
527422f2a2efSAndy Whitcroft## # check for multiple declarations, allowing for a function declaration
527522f2a2efSAndy Whitcroft## # continuation.
527622f2a2efSAndy Whitcroft## 		if ($line =~ /^.\s*$Type\s+$Ident(?:\s*=[^,{]*)?\s*,\s*$Ident.*/ &&
527722f2a2efSAndy Whitcroft## 		    $line !~ /^.\s*$Type\s+$Ident(?:\s*=[^,{]*)?\s*,\s*$Type\s*$Ident.*/) {
527822f2a2efSAndy Whitcroft##
527922f2a2efSAndy Whitcroft## 			# Remove any bracketed sections to ensure we do not
5280e73d2715SDwaipayan Ray## 			# falsely report the parameters of functions.
528122f2a2efSAndy Whitcroft## 			my $ln = $line;
528222f2a2efSAndy Whitcroft## 			while ($ln =~ s/\([^\(\)]*\)//g) {
528322f2a2efSAndy Whitcroft## 			}
528422f2a2efSAndy Whitcroft## 			if ($ln =~ /,/) {
5285000d1cc1SJoe Perches## 				WARN("MULTIPLE_DECLARATION",
5286000d1cc1SJoe Perches##				     "declaring multiple variables together should be avoided\n" . $herecurr);
528722f2a2efSAndy Whitcroft## 			}
528822f2a2efSAndy Whitcroft## 		}
5289f0a594c1SAndy Whitcroft
52900a920b5bSAndy Whitcroft#need space before brace following if, while, etc
52916b8c69e4SGeyslan G. Bem		if (($line =~ /\(.*\)\{/ && $line !~ /\($Type\)\{/) ||
52926ad724e2SMichal Zylowski		    $line =~ /\b(?:else|do)\{/) {
52933705ce5bSJoe Perches			if (ERROR("SPACING",
52943705ce5bSJoe Perches				  "space required before the open brace '{'\n" . $herecurr) &&
52953705ce5bSJoe Perches			    $fix) {
52966ad724e2SMichal Zylowski				$fixed[$fixlinenr] =~ s/^(\+.*(?:do|else|\)))\{/$1 {/;
52973705ce5bSJoe Perches			}
5298de7d4f0eSAndy Whitcroft		}
5299de7d4f0eSAndy Whitcroft
5300c4a62ef9SJoe Perches## # check for blank lines before declarations
5301c4a62ef9SJoe Perches##		if ($line =~ /^.\t+$Type\s+$Ident(?:\s*=.*)?;/ &&
5302c4a62ef9SJoe Perches##		    $prevrawline =~ /^.\s*$/) {
5303c4a62ef9SJoe Perches##			WARN("SPACING",
5304c4a62ef9SJoe Perches##			     "No blank lines before declarations\n" . $hereprev);
5305c4a62ef9SJoe Perches##		}
5306c4a62ef9SJoe Perches##
5307c4a62ef9SJoe Perches
5308de7d4f0eSAndy Whitcroft# closing brace should have a space following it when it has anything
5309de7d4f0eSAndy Whitcroft# on the line
531094fb9845SJoe Perches		if ($line =~ /}(?!(?:,|;|\)|\}))\S/) {
5311d5e616fcSJoe Perches			if (ERROR("SPACING",
5312d5e616fcSJoe Perches				  "space required after that close brace '}'\n" . $herecurr) &&
5313d5e616fcSJoe Perches			    $fix) {
5314194f66fcSJoe Perches				$fixed[$fixlinenr] =~
5315d5e616fcSJoe Perches				    s/}((?!(?:,|;|\)))\S)/} $1/;
5316d5e616fcSJoe Perches			}
53170a920b5bSAndy Whitcroft		}
53180a920b5bSAndy Whitcroft
531922f2a2efSAndy Whitcroft# check spacing on square brackets
532022f2a2efSAndy Whitcroft		if ($line =~ /\[\s/ && $line !~ /\[\s*$/) {
53213705ce5bSJoe Perches			if (ERROR("SPACING",
53223705ce5bSJoe Perches				  "space prohibited after that open square bracket '['\n" . $herecurr) &&
53233705ce5bSJoe Perches			    $fix) {
5324194f66fcSJoe Perches				$fixed[$fixlinenr] =~
53253705ce5bSJoe Perches				    s/\[\s+/\[/;
53263705ce5bSJoe Perches			}
532722f2a2efSAndy Whitcroft		}
532822f2a2efSAndy Whitcroft		if ($line =~ /\s\]/) {
53293705ce5bSJoe Perches			if (ERROR("SPACING",
53303705ce5bSJoe Perches				  "space prohibited before that close square bracket ']'\n" . $herecurr) &&
53313705ce5bSJoe Perches			    $fix) {
5332194f66fcSJoe Perches				$fixed[$fixlinenr] =~
53333705ce5bSJoe Perches				    s/\s+\]/\]/;
53343705ce5bSJoe Perches			}
533522f2a2efSAndy Whitcroft		}
533622f2a2efSAndy Whitcroft
5337c45dcabdSAndy Whitcroft# check spacing on parentheses
53389c0ca6f9SAndy Whitcroft		if ($line =~ /\(\s/ && $line !~ /\(\s*(?:\\)?$/ &&
53399c0ca6f9SAndy Whitcroft		    $line !~ /for\s*\(\s+;/) {
53403705ce5bSJoe Perches			if (ERROR("SPACING",
53413705ce5bSJoe Perches				  "space prohibited after that open parenthesis '('\n" . $herecurr) &&
53423705ce5bSJoe Perches			    $fix) {
5343194f66fcSJoe Perches				$fixed[$fixlinenr] =~
53443705ce5bSJoe Perches				    s/\(\s+/\(/;
53453705ce5bSJoe Perches			}
534622f2a2efSAndy Whitcroft		}
534713214adfSAndy Whitcroft		if ($line =~ /(\s+)\)/ && $line !~ /^.\s*\)/ &&
5348c45dcabdSAndy Whitcroft		    $line !~ /for\s*\(.*;\s+\)/ &&
5349c45dcabdSAndy Whitcroft		    $line !~ /:\s+\)/) {
53503705ce5bSJoe Perches			if (ERROR("SPACING",
53513705ce5bSJoe Perches				  "space prohibited before that close parenthesis ')'\n" . $herecurr) &&
53523705ce5bSJoe Perches			    $fix) {
5353194f66fcSJoe Perches				$fixed[$fixlinenr] =~
53543705ce5bSJoe Perches				    s/\s+\)/\)/;
53553705ce5bSJoe Perches			}
535622f2a2efSAndy Whitcroft		}
535722f2a2efSAndy Whitcroft
5358e2826fd0SJoe Perches# check unnecessary parentheses around addressof/dereference single $Lvals
5359e2826fd0SJoe Perches# ie: &(foo->bar) should be &foo->bar and *(foo->bar) should be *foo->bar
5360e2826fd0SJoe Perches
5361e2826fd0SJoe Perches		while ($line =~ /(?:[^&]&\s*|\*)\(\s*($Ident\s*(?:$Member\s*)+)\s*\)/g) {
5362ea4acbb1SJoe Perches			my $var = $1;
5363ea4acbb1SJoe Perches			if (CHK("UNNECESSARY_PARENTHESES",
5364ea4acbb1SJoe Perches				"Unnecessary parentheses around $var\n" . $herecurr) &&
5365ea4acbb1SJoe Perches			    $fix) {
5366ea4acbb1SJoe Perches				$fixed[$fixlinenr] =~ s/\(\s*\Q$var\E\s*\)/$var/;
5367ea4acbb1SJoe Perches			}
5368ea4acbb1SJoe Perches		}
5369ea4acbb1SJoe Perches
5370ea4acbb1SJoe Perches# check for unnecessary parentheses around function pointer uses
5371ea4acbb1SJoe Perches# ie: (foo->bar)(); should be foo->bar();
5372ea4acbb1SJoe Perches# but not "if (foo->bar) (" to avoid some false positives
5373ea4acbb1SJoe Perches		if ($line =~ /(\bif\s*|)(\(\s*$Ident\s*(?:$Member\s*)+\))[ \t]*\(/ && $1 !~ /^if/) {
5374ea4acbb1SJoe Perches			my $var = $2;
5375ea4acbb1SJoe Perches			if (CHK("UNNECESSARY_PARENTHESES",
5376ea4acbb1SJoe Perches				"Unnecessary parentheses around function pointer $var\n" . $herecurr) &&
5377ea4acbb1SJoe Perches			    $fix) {
5378ea4acbb1SJoe Perches				my $var2 = deparenthesize($var);
5379ea4acbb1SJoe Perches				$var2 =~ s/\s//g;
5380ea4acbb1SJoe Perches				$fixed[$fixlinenr] =~ s/\Q$var\E/$var2/;
5381ea4acbb1SJoe Perches			}
5382e2826fd0SJoe Perches		}
5383e2826fd0SJoe Perches
538463b7c73eSJoe Perches# check for unnecessary parentheses around comparisons in if uses
5385a032aa4cSJoe Perches# when !drivers/staging or command-line uses --strict
5386a032aa4cSJoe Perches		if (($realfile !~ m@^(?:drivers/staging/)@ || $check_orig) &&
53875b57980dSJoe Perches		    $perl_version_ok && defined($stat) &&
538863b7c73eSJoe Perches		    $stat =~ /(^.\s*if\s*($balanced_parens))/) {
538963b7c73eSJoe Perches			my $if_stat = $1;
539063b7c73eSJoe Perches			my $test = substr($2, 1, -1);
539163b7c73eSJoe Perches			my $herectx;
539263b7c73eSJoe Perches			while ($test =~ /(?:^|[^\w\&\!\~])+\s*\(\s*([\&\!\~]?\s*$Lval\s*(?:$Compare\s*$FuncArg)?)\s*\)/g) {
539363b7c73eSJoe Perches				my $match = $1;
539463b7c73eSJoe Perches				# avoid parentheses around potential macro args
539563b7c73eSJoe Perches				next if ($match =~ /^\s*\w+\s*$/);
539663b7c73eSJoe Perches				if (!defined($herectx)) {
539763b7c73eSJoe Perches					$herectx = $here . "\n";
539863b7c73eSJoe Perches					my $cnt = statement_rawlines($if_stat);
539963b7c73eSJoe Perches					for (my $n = 0; $n < $cnt; $n++) {
540063b7c73eSJoe Perches						my $rl = raw_line($linenr, $n);
540163b7c73eSJoe Perches						$herectx .=  $rl . "\n";
540263b7c73eSJoe Perches						last if $rl =~ /^[ \+].*\{/;
540363b7c73eSJoe Perches					}
540463b7c73eSJoe Perches				}
540563b7c73eSJoe Perches				CHK("UNNECESSARY_PARENTHESES",
540663b7c73eSJoe Perches				    "Unnecessary parentheses around '$match'\n" . $herectx);
540763b7c73eSJoe Perches			}
540863b7c73eSJoe Perches		}
540963b7c73eSJoe Perches
541069078651SJoe Perches# check that goto labels aren't indented (allow a single space indentation)
541169078651SJoe Perches# and ignore bitfield definitions like foo:1
541269078651SJoe Perches# Strictly, labels can have whitespace after the identifier and before the :
541369078651SJoe Perches# but this is not allowed here as many ?: uses would appear to be labels
541469078651SJoe Perches		if ($sline =~ /^.\s+[A-Za-z_][A-Za-z\d_]*:(?!\s*\d+)/ &&
541569078651SJoe Perches		    $sline !~ /^. [A-Za-z\d_][A-Za-z\d_]*:/ &&
541669078651SJoe Perches		    $sline !~ /^.\s+default:/) {
54173705ce5bSJoe Perches			if (WARN("INDENTED_LABEL",
54183705ce5bSJoe Perches				 "labels should not be indented\n" . $herecurr) &&
54193705ce5bSJoe Perches			    $fix) {
5420194f66fcSJoe Perches				$fixed[$fixlinenr] =~
54213705ce5bSJoe Perches				    s/^(.)\s+/$1/;
54223705ce5bSJoe Perches			}
54230a920b5bSAndy Whitcroft		}
54240a920b5bSAndy Whitcroft
542540873abaSJoe Perches# check if a statement with a comma should be two statements like:
542640873abaSJoe Perches#	foo = bar(),	/* comma should be semicolon */
542740873abaSJoe Perches#	bar = baz();
542840873abaSJoe Perches		if (defined($stat) &&
542940873abaSJoe Perches		    $stat =~ /^\+\s*(?:$Lval\s*$Assignment\s*)?$FuncArg\s*,\s*(?:$Lval\s*$Assignment\s*)?$FuncArg\s*;\s*$/) {
543040873abaSJoe Perches			my $cnt = statement_rawlines($stat);
543140873abaSJoe Perches			my $herectx = get_stat_here($linenr, $cnt, $here);
543240873abaSJoe Perches			WARN("SUSPECT_COMMA_SEMICOLON",
543340873abaSJoe Perches			     "Possible comma where semicolon could be used\n" . $herectx);
543440873abaSJoe Perches		}
543540873abaSJoe Perches
54365b9553abSJoe Perches# return is not a function
5437507e5141SJoe Perches		if (defined($stat) && $stat =~ /^.\s*return(\s*)\(/s) {
5438c45dcabdSAndy Whitcroft			my $spacing = $1;
54395b57980dSJoe Perches			if ($perl_version_ok &&
54405b9553abSJoe Perches			    $stat =~ /^.\s*return\s*($balanced_parens)\s*;\s*$/) {
54415b9553abSJoe Perches				my $value = $1;
54425b9553abSJoe Perches				$value = deparenthesize($value);
54435b9553abSJoe Perches				if ($value =~ m/^\s*$FuncArg\s*(?:\?|$)/) {
5444000d1cc1SJoe Perches					ERROR("RETURN_PARENTHESES",
5445000d1cc1SJoe Perches					      "return is not a function, parentheses are not required\n" . $herecurr);
54465b9553abSJoe Perches				}
5447c45dcabdSAndy Whitcroft			} elsif ($spacing !~ /\s+/) {
5448000d1cc1SJoe Perches				ERROR("SPACING",
5449000d1cc1SJoe Perches				      "space required before the open parenthesis '('\n" . $herecurr);
5450c45dcabdSAndy Whitcroft			}
5451c45dcabdSAndy Whitcroft		}
5452507e5141SJoe Perches
5453b43ae21bSJoe Perches# unnecessary return in a void function
5454b43ae21bSJoe Perches# at end-of-function, with the previous line a single leading tab, then return;
5455b43ae21bSJoe Perches# and the line before that not a goto label target like "out:"
5456b43ae21bSJoe Perches		if ($sline =~ /^[ \+]}\s*$/ &&
5457b43ae21bSJoe Perches		    $prevline =~ /^\+\treturn\s*;\s*$/ &&
5458b43ae21bSJoe Perches		    $linenr >= 3 &&
5459b43ae21bSJoe Perches		    $lines[$linenr - 3] =~ /^[ +]/ &&
5460b43ae21bSJoe Perches		    $lines[$linenr - 3] !~ /^[ +]\s*$Ident\s*:/) {
54619819cf25SJoe Perches			WARN("RETURN_VOID",
5462b43ae21bSJoe Perches			     "void function return statements are not generally useful\n" . $hereprev);
54639819cf25SJoe Perches		}
54649819cf25SJoe Perches
5465189248d8SJoe Perches# if statements using unnecessary parentheses - ie: if ((foo == bar))
54665b57980dSJoe Perches		if ($perl_version_ok &&
5467189248d8SJoe Perches		    $line =~ /\bif\s*((?:\(\s*){2,})/) {
5468189248d8SJoe Perches			my $openparens = $1;
5469189248d8SJoe Perches			my $count = $openparens =~ tr@\(@\(@;
5470189248d8SJoe Perches			my $msg = "";
5471189248d8SJoe Perches			if ($line =~ /\bif\s*(?:\(\s*){$count,$count}$LvalOrFunc\s*($Compare)\s*$LvalOrFunc(?:\s*\)){$count,$count}/) {
5472189248d8SJoe Perches				my $comp = $4;	#Not $1 because of $LvalOrFunc
5473189248d8SJoe Perches				$msg = " - maybe == should be = ?" if ($comp eq "==");
5474189248d8SJoe Perches				WARN("UNNECESSARY_PARENTHESES",
5475189248d8SJoe Perches				     "Unnecessary parentheses$msg\n" . $herecurr);
5476189248d8SJoe Perches			}
5477189248d8SJoe Perches		}
5478189248d8SJoe Perches
5479c5595fa2SJoe Perches# comparisons with a constant or upper case identifier on the left
5480c5595fa2SJoe Perches#	avoid cases like "foo + BAR < baz"
5481c5595fa2SJoe Perches#	only fix matches surrounded by parentheses to avoid incorrect
5482c5595fa2SJoe Perches#	conversions like "FOO < baz() + 5" being "misfixed" to "baz() > FOO + 5"
54835b57980dSJoe Perches		if ($perl_version_ok &&
5484c5595fa2SJoe Perches		    $line =~ /^\+(.*)\b($Constant|[A-Z_][A-Z0-9_]*)\s*($Compare)\s*($LvalOrFunc)/) {
5485c5595fa2SJoe Perches			my $lead = $1;
5486c5595fa2SJoe Perches			my $const = $2;
5487c5595fa2SJoe Perches			my $comp = $3;
5488c5595fa2SJoe Perches			my $to = $4;
5489c5595fa2SJoe Perches			my $newcomp = $comp;
5490f39e1769SJoe Perches			if ($lead !~ /(?:$Operators|\.)\s*$/ &&
5491c5595fa2SJoe Perches			    $to !~ /^(?:Constant|[A-Z_][A-Z0-9_]*)$/ &&
5492c5595fa2SJoe Perches			    WARN("CONSTANT_COMPARISON",
5493c5595fa2SJoe Perches				 "Comparisons should place the constant on the right side of the test\n" . $herecurr) &&
5494c5595fa2SJoe Perches			    $fix) {
5495c5595fa2SJoe Perches				if ($comp eq "<") {
5496c5595fa2SJoe Perches					$newcomp = ">";
5497c5595fa2SJoe Perches				} elsif ($comp eq "<=") {
5498c5595fa2SJoe Perches					$newcomp = ">=";
5499c5595fa2SJoe Perches				} elsif ($comp eq ">") {
5500c5595fa2SJoe Perches					$newcomp = "<";
5501c5595fa2SJoe Perches				} elsif ($comp eq ">=") {
5502c5595fa2SJoe Perches					$newcomp = "<=";
5503c5595fa2SJoe Perches				}
5504c5595fa2SJoe Perches				$fixed[$fixlinenr] =~ s/\(\s*\Q$const\E\s*$Compare\s*\Q$to\E\s*\)/($to $newcomp $const)/;
5505c5595fa2SJoe Perches			}
5506c5595fa2SJoe Perches		}
5507c5595fa2SJoe Perches
5508f34e4a4fSJoe Perches# Return of what appears to be an errno should normally be negative
5509f34e4a4fSJoe Perches		if ($sline =~ /\breturn(?:\s*\(+\s*|\s+)(E[A-Z]+)(?:\s*\)+\s*|\s*)[;:,]/) {
551053a3c448SAndy Whitcroft			my $name = $1;
551146b85bf9SGuenter Roeck			if ($name ne 'EOF' && $name ne 'ERROR' && $name !~ /^EPOLL/) {
5512000d1cc1SJoe Perches				WARN("USE_NEGATIVE_ERRNO",
5513f34e4a4fSJoe Perches				     "return of an errno should typically be negative (ie: return -$1)\n" . $herecurr);
551453a3c448SAndy Whitcroft			}
551553a3c448SAndy Whitcroft		}
5516c45dcabdSAndy Whitcroft
55170a920b5bSAndy Whitcroft# Need a space before open parenthesis after if, while etc
55184a0df2efSAndy Whitcroft		if ($line =~ /\b(if|while|for|switch)\(/) {
55193705ce5bSJoe Perches			if (ERROR("SPACING",
55203705ce5bSJoe Perches				  "space required before the open parenthesis '('\n" . $herecurr) &&
55213705ce5bSJoe Perches			    $fix) {
5522194f66fcSJoe Perches				$fixed[$fixlinenr] =~
55233705ce5bSJoe Perches				    s/\b(if|while|for|switch)\(/$1 \(/;
55243705ce5bSJoe Perches			}
55250a920b5bSAndy Whitcroft		}
55260a920b5bSAndy Whitcroft
5527f5fe35ddSAndy Whitcroft# Check for illegal assignment in if conditional -- and check for trailing
5528f5fe35ddSAndy Whitcroft# statements after the conditional.
5529170d3a22SAndy Whitcroft		if ($line =~ /do\s*(?!{)/) {
55303e469cdcSAndy Whitcroft			($stat, $cond, $line_nr_next, $remain_next, $off_next) =
55313e469cdcSAndy Whitcroft				ctx_statement_block($linenr, $realcnt, 0)
55323e469cdcSAndy Whitcroft					if (!defined $stat);
5533170d3a22SAndy Whitcroft			my ($stat_next) = ctx_statement_block($line_nr_next,
5534170d3a22SAndy Whitcroft						$remain_next, $off_next);
5535170d3a22SAndy Whitcroft			$stat_next =~ s/\n./\n /g;
5536170d3a22SAndy Whitcroft			##print "stat<$stat> stat_next<$stat_next>\n";
5537170d3a22SAndy Whitcroft
5538170d3a22SAndy Whitcroft			if ($stat_next =~ /^\s*while\b/) {
5539170d3a22SAndy Whitcroft				# If the statement carries leading newlines,
5540170d3a22SAndy Whitcroft				# then count those as offsets.
5541170d3a22SAndy Whitcroft				my ($whitespace) =
5542170d3a22SAndy Whitcroft					($stat_next =~ /^((?:\s*\n[+-])*\s*)/s);
5543170d3a22SAndy Whitcroft				my $offset =
5544170d3a22SAndy Whitcroft					statement_rawlines($whitespace) - 1;
5545170d3a22SAndy Whitcroft
5546170d3a22SAndy Whitcroft				$suppress_whiletrailers{$line_nr_next +
5547170d3a22SAndy Whitcroft								$offset} = 1;
5548170d3a22SAndy Whitcroft			}
5549170d3a22SAndy Whitcroft		}
5550170d3a22SAndy Whitcroft		if (!defined $suppress_whiletrailers{$linenr} &&
5551c11230f4SJoe Perches		    defined($stat) && defined($cond) &&
5552170d3a22SAndy Whitcroft		    $line =~ /\b(?:if|while|for)\s*\(/ && $line !~ /^.\s*#/) {
5553171ae1a4SAndy Whitcroft			my ($s, $c) = ($stat, $cond);
5554*481efd7bSJoe Perches			my $fixed_assign_in_if = 0;
55558905a67cSAndy Whitcroft
5556b53c8e10SAndy Whitcroft			if ($c =~ /\bif\s*\(.*[^<>!=]=[^=].*/s) {
555765b64b3bSJoe Perches				if (ERROR("ASSIGN_IN_IF",
555865b64b3bSJoe Perches					  "do not use assignment in if condition\n" . $herecurr) &&
555965b64b3bSJoe Perches				    $fix && $perl_version_ok) {
556065b64b3bSJoe Perches					if ($rawline =~ /^\+(\s+)if\s*\(\s*(\!)?\s*\(\s*(($Lval)\s*=\s*$LvalOrFunc)\s*\)\s*(?:($Compare)\s*($FuncArg))?\s*\)\s*(\{)?\s*$/) {
556165b64b3bSJoe Perches						my $space = $1;
556265b64b3bSJoe Perches						my $not = $2;
556365b64b3bSJoe Perches						my $statement = $3;
556465b64b3bSJoe Perches						my $assigned = $4;
556565b64b3bSJoe Perches						my $test = $8;
556665b64b3bSJoe Perches						my $against = $9;
556765b64b3bSJoe Perches						my $brace = $15;
556865b64b3bSJoe Perches						fix_delete_line($fixlinenr, $rawline);
556965b64b3bSJoe Perches						fix_insert_line($fixlinenr, "$space$statement;");
557065b64b3bSJoe Perches						my $newline = "${space}if (";
557165b64b3bSJoe Perches						$newline .= '!' if defined($not);
557265b64b3bSJoe Perches						$newline .= '(' if (defined $not && defined($test) && defined($against));
557365b64b3bSJoe Perches						$newline .= "$assigned";
557465b64b3bSJoe Perches						$newline .= " $test $against" if (defined($test) && defined($against));
557565b64b3bSJoe Perches						$newline .= ')' if (defined $not && defined($test) && defined($against));
557665b64b3bSJoe Perches						$newline .= ')';
557765b64b3bSJoe Perches						$newline .= " {" if (defined($brace));
557865b64b3bSJoe Perches						fix_insert_line($fixlinenr + 1, $newline);
5579*481efd7bSJoe Perches						$fixed_assign_in_if = 1;
558065b64b3bSJoe Perches					}
558165b64b3bSJoe Perches				}
55828905a67cSAndy Whitcroft			}
55838905a67cSAndy Whitcroft
55848905a67cSAndy Whitcroft			# Find out what is on the end of the line after the
55858905a67cSAndy Whitcroft			# conditional.
5586773647a0SAndy Whitcroft			substr($s, 0, length($c), '');
55878905a67cSAndy Whitcroft			$s =~ s/\n.*//g;
558813214adfSAndy Whitcroft			$s =~ s/$;//g;	# Remove any comments
558953210168SAndy Whitcroft			if (length($c) && $s !~ /^\s*{?\s*\\*\s*$/ &&
559053210168SAndy Whitcroft			    $c !~ /}\s*while\s*/)
5591773647a0SAndy Whitcroft			{
5592bb44ad39SAndy Whitcroft				# Find out how long the conditional actually is.
5593bb44ad39SAndy Whitcroft				my @newlines = ($c =~ /\n/gs);
5594bb44ad39SAndy Whitcroft				my $cond_lines = 1 + $#newlines;
559542bdf74cSHidetoshi Seto				my $stat_real = '';
5596bb44ad39SAndy Whitcroft
559742bdf74cSHidetoshi Seto				$stat_real = raw_line($linenr, $cond_lines)
559842bdf74cSHidetoshi Seto							. "\n" if ($cond_lines);
5599bb44ad39SAndy Whitcroft				if (defined($stat_real) && $cond_lines > 1) {
5600bb44ad39SAndy Whitcroft					$stat_real = "[...]\n$stat_real";
5601bb44ad39SAndy Whitcroft				}
5602bb44ad39SAndy Whitcroft
5603*481efd7bSJoe Perches				if (ERROR("TRAILING_STATEMENTS",
5604*481efd7bSJoe Perches					  "trailing statements should be on next line\n" . $herecurr . $stat_real) &&
5605*481efd7bSJoe Perches				    !$fixed_assign_in_if &&
5606*481efd7bSJoe Perches				    $cond_lines == 0 &&
5607*481efd7bSJoe Perches				    $fix && $perl_version_ok &&
5608*481efd7bSJoe Perches				    $fixed[$fixlinenr] =~ /^\+(\s*)((?:if|while|for)\s*$balanced_parens)\s*(.*)$/) {
5609*481efd7bSJoe Perches					my $indent = $1;
5610*481efd7bSJoe Perches					my $test = $2;
5611*481efd7bSJoe Perches					my $rest = rtrim($4);
5612*481efd7bSJoe Perches					if ($rest =~ /;$/) {
5613*481efd7bSJoe Perches						$fixed[$fixlinenr] = "\+$indent$test";
5614*481efd7bSJoe Perches						fix_insert_line($fixlinenr + 1, "$indent\t$rest");
5615*481efd7bSJoe Perches					}
5616*481efd7bSJoe Perches				}
56178905a67cSAndy Whitcroft			}
56188905a67cSAndy Whitcroft		}
56198905a67cSAndy Whitcroft
562013214adfSAndy Whitcroft# Check for bitwise tests written as boolean
562113214adfSAndy Whitcroft		if ($line =~ /
562213214adfSAndy Whitcroft			(?:
562313214adfSAndy Whitcroft				(?:\[|\(|\&\&|\|\|)
562413214adfSAndy Whitcroft				\s*0[xX][0-9]+\s*
562513214adfSAndy Whitcroft				(?:\&\&|\|\|)
562613214adfSAndy Whitcroft			|
562713214adfSAndy Whitcroft				(?:\&\&|\|\|)
562813214adfSAndy Whitcroft				\s*0[xX][0-9]+\s*
562913214adfSAndy Whitcroft				(?:\&\&|\|\||\)|\])
563013214adfSAndy Whitcroft			)/x)
563113214adfSAndy Whitcroft		{
5632000d1cc1SJoe Perches			WARN("HEXADECIMAL_BOOLEAN_TEST",
5633000d1cc1SJoe Perches			     "boolean test with hexadecimal, perhaps just 1 \& or \|?\n" . $herecurr);
563413214adfSAndy Whitcroft		}
563513214adfSAndy Whitcroft
56368905a67cSAndy Whitcroft# if and else should not have general statements after it
563713214adfSAndy Whitcroft		if ($line =~ /^.\s*(?:}\s*)?else\b(.*)/) {
563813214adfSAndy Whitcroft			my $s = $1;
563913214adfSAndy Whitcroft			$s =~ s/$;//g;	# Remove any comments
564013214adfSAndy Whitcroft			if ($s !~ /^\s*(?:\sif|(?:{|)\s*\\?\s*$)/) {
5641000d1cc1SJoe Perches				ERROR("TRAILING_STATEMENTS",
5642000d1cc1SJoe Perches				      "trailing statements should be on next line\n" . $herecurr);
56430a920b5bSAndy Whitcroft			}
564413214adfSAndy Whitcroft		}
564539667782SAndy Whitcroft# if should not continue a brace
564639667782SAndy Whitcroft		if ($line =~ /}\s*if\b/) {
5647000d1cc1SJoe Perches			ERROR("TRAILING_STATEMENTS",
5648048b123fSRasmus Villemoes			      "trailing statements should be on next line (or did you mean 'else if'?)\n" .
564939667782SAndy Whitcroft				$herecurr);
565039667782SAndy Whitcroft		}
5651a1080bf8SAndy Whitcroft# case and default should not have general statements after them
5652a1080bf8SAndy Whitcroft		if ($line =~ /^.\s*(?:case\s*.*|default\s*):/g &&
5653a1080bf8SAndy Whitcroft		    $line !~ /\G(?:
56543fef12d6SAndy Whitcroft			(?:\s*$;*)(?:\s*{)?(?:\s*$;*)(?:\s*\\)?\s*$|
5655a1080bf8SAndy Whitcroft			\s*return\s+
5656a1080bf8SAndy Whitcroft		    )/xg)
5657a1080bf8SAndy Whitcroft		{
5658000d1cc1SJoe Perches			ERROR("TRAILING_STATEMENTS",
5659000d1cc1SJoe Perches			      "trailing statements should be on next line\n" . $herecurr);
5660a1080bf8SAndy Whitcroft		}
56610a920b5bSAndy Whitcroft
56620a920b5bSAndy Whitcroft		# Check for }<nl>else {, these must be at the same
56630a920b5bSAndy Whitcroft		# indent level to be relevant to each other.
56648b8856f4SJoe Perches		if ($prevline=~/}\s*$/ and $line=~/^.\s*else\s*/ &&
56650a920b5bSAndy Whitcroft		    $previndent == $indent) {
56668b8856f4SJoe Perches			if (ERROR("ELSE_AFTER_BRACE",
56678b8856f4SJoe Perches				  "else should follow close brace '}'\n" . $hereprev) &&
56688b8856f4SJoe Perches			    $fix && $prevline =~ /^\+/ && $line =~ /^\+/) {
56698b8856f4SJoe Perches				fix_delete_line($fixlinenr - 1, $prevrawline);
56708b8856f4SJoe Perches				fix_delete_line($fixlinenr, $rawline);
56718b8856f4SJoe Perches				my $fixedline = $prevrawline;
56728b8856f4SJoe Perches				$fixedline =~ s/}\s*$//;
56738b8856f4SJoe Perches				if ($fixedline !~ /^\+\s*$/) {
56748b8856f4SJoe Perches					fix_insert_line($fixlinenr, $fixedline);
56758b8856f4SJoe Perches				}
56768b8856f4SJoe Perches				$fixedline = $rawline;
56778b8856f4SJoe Perches				$fixedline =~ s/^(.\s*)else/$1} else/;
56788b8856f4SJoe Perches				fix_insert_line($fixlinenr, $fixedline);
56798b8856f4SJoe Perches			}
56800a920b5bSAndy Whitcroft		}
56810a920b5bSAndy Whitcroft
56828b8856f4SJoe Perches		if ($prevline=~/}\s*$/ and $line=~/^.\s*while\s*/ &&
5683c2fdda0dSAndy Whitcroft		    $previndent == $indent) {
5684c2fdda0dSAndy Whitcroft			my ($s, $c) = ctx_statement_block($linenr, $realcnt, 0);
5685c2fdda0dSAndy Whitcroft
5686c2fdda0dSAndy Whitcroft			# Find out what is on the end of the line after the
5687c2fdda0dSAndy Whitcroft			# conditional.
5688773647a0SAndy Whitcroft			substr($s, 0, length($c), '');
5689c2fdda0dSAndy Whitcroft			$s =~ s/\n.*//g;
5690c2fdda0dSAndy Whitcroft
5691c2fdda0dSAndy Whitcroft			if ($s =~ /^\s*;/) {
56928b8856f4SJoe Perches				if (ERROR("WHILE_AFTER_BRACE",
56938b8856f4SJoe Perches					  "while should follow close brace '}'\n" . $hereprev) &&
56948b8856f4SJoe Perches				    $fix && $prevline =~ /^\+/ && $line =~ /^\+/) {
56958b8856f4SJoe Perches					fix_delete_line($fixlinenr - 1, $prevrawline);
56968b8856f4SJoe Perches					fix_delete_line($fixlinenr, $rawline);
56978b8856f4SJoe Perches					my $fixedline = $prevrawline;
56988b8856f4SJoe Perches					my $trailing = $rawline;
56998b8856f4SJoe Perches					$trailing =~ s/^\+//;
57008b8856f4SJoe Perches					$trailing = trim($trailing);
57018b8856f4SJoe Perches					$fixedline =~ s/}\s*$/} $trailing/;
57028b8856f4SJoe Perches					fix_insert_line($fixlinenr, $fixedline);
57038b8856f4SJoe Perches				}
5704c2fdda0dSAndy Whitcroft			}
5705c2fdda0dSAndy Whitcroft		}
5706c2fdda0dSAndy Whitcroft
570795e2c602SJoe Perches#Specific variable tests
5708323c1260SJoe Perches		while ($line =~ m{($Constant|$Lval)}g) {
5709323c1260SJoe Perches			my $var = $1;
571095e2c602SJoe Perches
571195e2c602SJoe Perches#CamelCase
5712807bd26cSJoe Perches			if ($var !~ /^$Constant$/ &&
5713be79794bSJoe Perches			    $var =~ /[A-Z][a-z]|[a-z][A-Z]/ &&
57144104a206SŁukasz Stelmach#Ignore some autogenerated defines and enum values
57154104a206SŁukasz Stelmach			    $var !~ /^(?:[A-Z]+_){1,5}[A-Z]{1,3}[a-z]/ &&
571622735ce8SJoe Perches#Ignore Page<foo> variants
5717807bd26cSJoe Perches			    $var !~ /^(?:Clear|Set|TestClear|TestSet|)Page[A-Z]/ &&
5718d439e6a5SJoe Perches#Ignore SI style variants like nS, mV and dB
5719d439e6a5SJoe Perches#(ie: max_uV, regulator_min_uA_show, RANGE_mA_VALUE)
5720d439e6a5SJoe Perches			    $var !~ /^(?:[a-z0-9_]*|[A-Z0-9_]*)?_?[a-z][A-Z](?:_[a-z0-9_]+|_[A-Z0-9_]+)?$/ &&
5721f5123576SJulius Werner#Ignore some three character SI units explicitly, like MiB and KHz
5722f5123576SJulius Werner			    $var !~ /^(?:[a-z_]*?)_?(?:[KMGT]iB|[KMGT]?Hz)(?:_[a-z_]+)?$/) {
57237e781f67SJoe Perches				while ($var =~ m{($Ident)}g) {
57247e781f67SJoe Perches					my $word = $1;
57257e781f67SJoe Perches					next if ($word !~ /[A-Z][a-z]|[a-z][A-Z]/);
5726d8b07710SJoe Perches					if ($check) {
5727d8b07710SJoe Perches						seed_camelcase_includes();
5728d8b07710SJoe Perches						if (!$file && !$camelcase_file_seeded) {
5729d8b07710SJoe Perches							seed_camelcase_file($realfile);
5730d8b07710SJoe Perches							$camelcase_file_seeded = 1;
5731d8b07710SJoe Perches						}
5732d8b07710SJoe Perches					}
57337e781f67SJoe Perches					if (!defined $camelcase{$word}) {
57347e781f67SJoe Perches						$camelcase{$word} = 1;
5735be79794bSJoe Perches						CHK("CAMELCASE",
57367e781f67SJoe Perches						    "Avoid CamelCase: <$word>\n" . $herecurr);
57377e781f67SJoe Perches					}
5738323c1260SJoe Perches				}
5739323c1260SJoe Perches			}
57403445686aSJoe Perches		}
57410a920b5bSAndy Whitcroft
57420a920b5bSAndy Whitcroft#no spaces allowed after \ in define
5743d5e616fcSJoe Perches		if ($line =~ /\#\s*define.*\\\s+$/) {
5744d5e616fcSJoe Perches			if (WARN("WHITESPACE_AFTER_LINE_CONTINUATION",
5745d5e616fcSJoe Perches				 "Whitespace after \\ makes next lines useless\n" . $herecurr) &&
5746d5e616fcSJoe Perches			    $fix) {
5747194f66fcSJoe Perches				$fixed[$fixlinenr] =~ s/\s+$//;
5748d5e616fcSJoe Perches			}
57490a920b5bSAndy Whitcroft		}
57500a920b5bSAndy Whitcroft
57510e212e0aSFabian Frederick# warn if <asm/foo.h> is #included and <linux/foo.h> is available and includes
57520e212e0aSFabian Frederick# itself <asm/foo.h> (uses RAW line)
5753c45dcabdSAndy Whitcroft		if ($tree && $rawline =~ m{^.\s*\#\s*include\s*\<asm\/(.*)\.h\>}) {
5754e09dec48SAndy Whitcroft			my $file = "$1.h";
5755e09dec48SAndy Whitcroft			my $checkfile = "include/linux/$file";
5756e09dec48SAndy Whitcroft			if (-f "$root/$checkfile" &&
5757e09dec48SAndy Whitcroft			    $realfile ne $checkfile &&
57587840a94cSWolfram Sang			    $1 !~ /$allowed_asm_includes/)
5759c45dcabdSAndy Whitcroft			{
57600e212e0aSFabian Frederick				my $asminclude = `grep -Ec "#include\\s+<asm/$file>" $root/$checkfile`;
57610e212e0aSFabian Frederick				if ($asminclude > 0) {
5762e09dec48SAndy Whitcroft					if ($realfile =~ m{^arch/}) {
5763000d1cc1SJoe Perches						CHK("ARCH_INCLUDE_LINUX",
5764000d1cc1SJoe Perches						    "Consider using #include <linux/$file> instead of <asm/$file>\n" . $herecurr);
5765e09dec48SAndy Whitcroft					} else {
5766000d1cc1SJoe Perches						WARN("INCLUDE_LINUX",
5767000d1cc1SJoe Perches						     "Use #include <linux/$file> instead of <asm/$file>\n" . $herecurr);
5768e09dec48SAndy Whitcroft					}
57690a920b5bSAndy Whitcroft				}
57700a920b5bSAndy Whitcroft			}
57710e212e0aSFabian Frederick		}
57720a920b5bSAndy Whitcroft
5773653d4876SAndy Whitcroft# multi-statement macros should be enclosed in a do while loop, grab the
5774653d4876SAndy Whitcroft# first statement and ensure its the whole macro if its not enclosed
5775cf655043SAndy Whitcroft# in a known good container
5776b8f96a31SAndy Whitcroft		if ($realfile !~ m@/vmlinux.lds.h$@ &&
5777b8f96a31SAndy Whitcroft		    $line =~ /^.\s*\#\s*define\s*$Ident(\()?/) {
5778d8aaf121SAndy Whitcroft			my $ln = $linenr;
5779d8aaf121SAndy Whitcroft			my $cnt = $realcnt;
5780c45dcabdSAndy Whitcroft			my ($off, $dstat, $dcond, $rest);
5781c45dcabdSAndy Whitcroft			my $ctx = '';
578208a2843eSJoe Perches			my $has_flow_statement = 0;
578308a2843eSJoe Perches			my $has_arg_concat = 0;
5784c45dcabdSAndy Whitcroft			($dstat, $dcond, $ln, $cnt, $off) =
5785f74bd194SAndy Whitcroft				ctx_statement_block($linenr, $realcnt, 0);
5786f74bd194SAndy Whitcroft			$ctx = $dstat;
5787c45dcabdSAndy Whitcroft			#print "dstat<$dstat> dcond<$dcond> cnt<$cnt> off<$off>\n";
5788a3bb97a7SAndy Whitcroft			#print "LINE<$lines[$ln-1]> len<" . length($lines[$ln-1]) . "\n";
5789c45dcabdSAndy Whitcroft
579008a2843eSJoe Perches			$has_flow_statement = 1 if ($ctx =~ /\b(goto|return)\b/);
579162e15a6dSJoe Perches			$has_arg_concat = 1 if ($ctx =~ /\#\#/ && $ctx !~ /\#\#\s*(?:__VA_ARGS__|args)\b/);
579208a2843eSJoe Perches
5793f59b64bfSJoe Perches			$dstat =~ s/^.\s*\#\s*define\s+$Ident(\([^\)]*\))?\s*//;
5794f59b64bfSJoe Perches			my $define_args = $1;
5795f59b64bfSJoe Perches			my $define_stmt = $dstat;
5796f59b64bfSJoe Perches			my @def_args = ();
5797f59b64bfSJoe Perches
5798f59b64bfSJoe Perches			if (defined $define_args && $define_args ne "") {
5799f59b64bfSJoe Perches				$define_args = substr($define_args, 1, length($define_args) - 2);
5800f59b64bfSJoe Perches				$define_args =~ s/\s*//g;
58018c8c45cfSJoe Perches				$define_args =~ s/\\\+?//g;
5802f59b64bfSJoe Perches				@def_args = split(",", $define_args);
5803f59b64bfSJoe Perches			}
5804f59b64bfSJoe Perches
5805292f1a9bSAndy Whitcroft			$dstat =~ s/$;//g;
5806c45dcabdSAndy Whitcroft			$dstat =~ s/\\\n.//g;
5807c45dcabdSAndy Whitcroft			$dstat =~ s/^\s*//s;
5808c45dcabdSAndy Whitcroft			$dstat =~ s/\s*$//s;
5809c45dcabdSAndy Whitcroft
5810c45dcabdSAndy Whitcroft			# Flatten any parentheses and braces
58112e44e803SDwaipayan Ray			while ($dstat =~ s/\([^\(\)]*\)/1u/ ||
58122e44e803SDwaipayan Ray			       $dstat =~ s/\{[^\{\}]*\}/1u/ ||
58132e44e803SDwaipayan Ray			       $dstat =~ s/.\[[^\[\]]*\]/1u/)
5814bf30d6edSAndy Whitcroft			{
5815c45dcabdSAndy Whitcroft			}
5816c45dcabdSAndy Whitcroft
5817342d3d2fSAntonio Borneo			# Flatten any obvious string concatenation.
581833acb54aSJoe Perches			while ($dstat =~ s/($String)\s*$Ident/$1/ ||
581933acb54aSJoe Perches			       $dstat =~ s/$Ident\s*($String)/$1/)
5820e45bab8eSAndy Whitcroft			{
5821e45bab8eSAndy Whitcroft			}
5822e45bab8eSAndy Whitcroft
582342e15293SJoe Perches			# Make asm volatile uses seem like a generic function
582442e15293SJoe Perches			$dstat =~ s/\b_*asm_*\s+_*volatile_*\b/asm_volatile/g;
582542e15293SJoe Perches
5826c45dcabdSAndy Whitcroft			my $exceptions = qr{
5827c45dcabdSAndy Whitcroft				$Declare|
5828c45dcabdSAndy Whitcroft				module_param_named|
5829a0a0a7a9SKees Cook				MODULE_PARM_DESC|
5830c45dcabdSAndy Whitcroft				DECLARE_PER_CPU|
5831c45dcabdSAndy Whitcroft				DEFINE_PER_CPU|
5832383099fdSAndy Whitcroft				__typeof__\(|
583322fd2d3eSStefani Seibold				union|
583422fd2d3eSStefani Seibold				struct|
5835ea71a0a0SAndy Whitcroft				\.$Ident\s*=\s*|
58366b10df42SVladimir Zapolskiy				^\"|\"$|
58376b10df42SVladimir Zapolskiy				^\[
5838c45dcabdSAndy Whitcroft			}x;
58395eaa20b9SAndy Whitcroft			#print "REST<$rest> dstat<$dstat> ctx<$ctx>\n";
5840f59b64bfSJoe Perches
5841f59b64bfSJoe Perches			$ctx =~ s/\n*$//;
5842f59b64bfSJoe Perches			my $stmt_cnt = statement_rawlines($ctx);
5843e3d95a2aSTobin C. Harding			my $herectx = get_stat_here($linenr, $stmt_cnt, $here);
5844f59b64bfSJoe Perches
5845f74bd194SAndy Whitcroft			if ($dstat ne '' &&
5846f74bd194SAndy Whitcroft			    $dstat !~ /^(?:$Ident|-?$Constant),$/ &&			# 10, // foo(),
5847f74bd194SAndy Whitcroft			    $dstat !~ /^(?:$Ident|-?$Constant);$/ &&			# foo();
58483cc4b1c3SJoe Perches			    $dstat !~ /^[!~-]?(?:$Lval|$Constant)$/ &&		# 10 // foo() // !foo // ~foo // -foo // foo->bar // foo.bar->baz
5849356fd398SJoe Perches			    $dstat !~ /^'X'$/ && $dstat !~ /^'XX'$/ &&			# character constants
5850f74bd194SAndy Whitcroft			    $dstat !~ /$exceptions/ &&
5851f74bd194SAndy Whitcroft			    $dstat !~ /^\.$Ident\s*=/ &&				# .foo =
5852e942e2c3SJoe Perches			    $dstat !~ /^(?:\#\s*$Ident|\#\s*$Constant)\s*$/ &&		# stringification #foo
585372f115f9SAndy Whitcroft			    $dstat !~ /^do\s*$Constant\s*while\s*$Constant;?$/ &&	# do {...} while (...); // do {...} while (...)
58542e44e803SDwaipayan Ray			    $dstat !~ /^while\s*$Constant\s*$Constant\s*$/ &&		# while (...) {...}
5855f74bd194SAndy Whitcroft			    $dstat !~ /^for\s*$Constant$/ &&				# for (...)
5856f74bd194SAndy Whitcroft			    $dstat !~ /^for\s*$Constant\s+(?:$Ident|-?$Constant)$/ &&	# for (...) bar()
5857f74bd194SAndy Whitcroft			    $dstat !~ /^do\s*{/ &&					# do {...
58584e5d56bdSEddie Kovsky			    $dstat !~ /^\(\{/ &&						# ({...
5859f95a7e6aSJoe Perches			    $ctx !~ /^.\s*#\s*define\s+TRACE_(?:SYSTEM|INCLUDE_FILE|INCLUDE_PATH)\b/)
5860c45dcabdSAndy Whitcroft			{
5861e795556aSJoe Perches				if ($dstat =~ /^\s*if\b/) {
5862e795556aSJoe Perches					ERROR("MULTISTATEMENT_MACRO_USE_DO_WHILE",
5863e795556aSJoe Perches					      "Macros starting with if should be enclosed by a do - while loop to avoid possible if/else logic defects\n" . "$herectx");
5864e795556aSJoe Perches				} elsif ($dstat =~ /;/) {
5865f74bd194SAndy Whitcroft					ERROR("MULTISTATEMENT_MACRO_USE_DO_WHILE",
5866f74bd194SAndy Whitcroft					      "Macros with multiple statements should be enclosed in a do - while loop\n" . "$herectx");
5867f74bd194SAndy Whitcroft				} else {
5868000d1cc1SJoe Perches					ERROR("COMPLEX_MACRO",
5869388982b5SAndrew Morton					      "Macros with complex values should be enclosed in parentheses\n" . "$herectx");
5870d8aaf121SAndy Whitcroft				}
5871f59b64bfSJoe Perches
5872f59b64bfSJoe Perches			}
58735207649bSJoe Perches
58745207649bSJoe Perches			# Make $define_stmt single line, comment-free, etc
58755207649bSJoe Perches			my @stmt_array = split('\n', $define_stmt);
58765207649bSJoe Perches			my $first = 1;
58775207649bSJoe Perches			$define_stmt = "";
58785207649bSJoe Perches			foreach my $l (@stmt_array) {
58795207649bSJoe Perches				$l =~ s/\\$//;
58805207649bSJoe Perches				if ($first) {
58815207649bSJoe Perches					$define_stmt = $l;
58825207649bSJoe Perches					$first = 0;
58835207649bSJoe Perches				} elsif ($l =~ /^[\+ ]/) {
58845207649bSJoe Perches					$define_stmt .= substr($l, 1);
58855207649bSJoe Perches				}
58865207649bSJoe Perches			}
58875207649bSJoe Perches			$define_stmt =~ s/$;//g;
58885207649bSJoe Perches			$define_stmt =~ s/\s+/ /g;
58895207649bSJoe Perches			$define_stmt = trim($define_stmt);
58905207649bSJoe Perches
5891f59b64bfSJoe Perches# check if any macro arguments are reused (ignore '...' and 'type')
5892f59b64bfSJoe Perches			foreach my $arg (@def_args) {
5893f59b64bfSJoe Perches			        next if ($arg =~ /\.\.\./);
58949192d41aSJoe Perches			        next if ($arg =~ /^type$/i);
58957fe528a2SJoe Perches				my $tmp_stmt = $define_stmt;
58967b844345SVincent Mailhol				$tmp_stmt =~ s/\b(__must_be_array|offsetof|sizeof|sizeof_field|__stringify|typeof|__typeof__|__builtin\w+|typecheck\s*\(\s*$Type\s*,|\#+)\s*\(*\s*$arg\s*\)*\b//g;
58977fe528a2SJoe Perches				$tmp_stmt =~ s/\#+\s*$arg\b//g;
58987fe528a2SJoe Perches				$tmp_stmt =~ s/\b$arg\s*\#\#//g;
5899d41362edSJoe Perches				my $use_cnt = () = $tmp_stmt =~ /\b$arg\b/g;
5900f59b64bfSJoe Perches				if ($use_cnt > 1) {
5901f59b64bfSJoe Perches					CHK("MACRO_ARG_REUSE",
5902f59b64bfSJoe Perches					    "Macro argument reuse '$arg' - possible side-effects?\n" . "$herectx");
5903f59b64bfSJoe Perches				    }
59049192d41aSJoe Perches# check if any macro arguments may have other precedence issues
59057fe528a2SJoe Perches				if ($tmp_stmt =~ m/($Operators)?\s*\b$arg\b\s*($Operators)?/m &&
59069192d41aSJoe Perches				    ((defined($1) && $1 ne ',') ||
59079192d41aSJoe Perches				     (defined($2) && $2 ne ','))) {
59089192d41aSJoe Perches					CHK("MACRO_ARG_PRECEDENCE",
59099192d41aSJoe Perches					    "Macro argument '$arg' may be better as '($arg)' to avoid precedence issues\n" . "$herectx");
59109192d41aSJoe Perches				}
59110a920b5bSAndy Whitcroft			}
59125023d347SJoe Perches
591308a2843eSJoe Perches# check for macros with flow control, but without ## concatenation
591408a2843eSJoe Perches# ## concatenation is commonly a macro that defines a function so ignore those
591508a2843eSJoe Perches			if ($has_flow_statement && !$has_arg_concat) {
591608a2843eSJoe Perches				my $cnt = statement_rawlines($ctx);
5917e3d95a2aSTobin C. Harding				my $herectx = get_stat_here($linenr, $cnt, $here);
591808a2843eSJoe Perches
591908a2843eSJoe Perches				WARN("MACRO_WITH_FLOW_CONTROL",
592008a2843eSJoe Perches				     "Macros with flow control statements should be avoided\n" . "$herectx");
592108a2843eSJoe Perches			}
592208a2843eSJoe Perches
5923481eb486SJoe Perches# check for line continuations outside of #defines, preprocessor #, and asm
59245023d347SJoe Perches
59255023d347SJoe Perches		} else {
59265023d347SJoe Perches			if ($prevline !~ /^..*\\$/ &&
5927481eb486SJoe Perches			    $line !~ /^\+\s*\#.*\\$/ &&		# preprocessor
5928481eb486SJoe Perches			    $line !~ /^\+.*\b(__asm__|asm)\b.*\\$/ &&	# asm
59295023d347SJoe Perches			    $line =~ /^\+.*\\$/) {
59305023d347SJoe Perches				WARN("LINE_CONTINUATIONS",
59315023d347SJoe Perches				     "Avoid unnecessary line continuations\n" . $herecurr);
59325023d347SJoe Perches			}
5933653d4876SAndy Whitcroft		}
59340a920b5bSAndy Whitcroft
5935b13edf7fSJoe Perches# do {} while (0) macro tests:
5936b13edf7fSJoe Perches# single-statement macros do not need to be enclosed in do while (0) loop,
5937b13edf7fSJoe Perches# macro should not end with a semicolon
59385b57980dSJoe Perches		if ($perl_version_ok &&
5939b13edf7fSJoe Perches		    $realfile !~ m@/vmlinux.lds.h$@ &&
5940b13edf7fSJoe Perches		    $line =~ /^.\s*\#\s*define\s+$Ident(\()?/) {
5941b13edf7fSJoe Perches			my $ln = $linenr;
5942b13edf7fSJoe Perches			my $cnt = $realcnt;
5943b13edf7fSJoe Perches			my ($off, $dstat, $dcond, $rest);
5944b13edf7fSJoe Perches			my $ctx = '';
5945b13edf7fSJoe Perches			($dstat, $dcond, $ln, $cnt, $off) =
5946b13edf7fSJoe Perches				ctx_statement_block($linenr, $realcnt, 0);
5947b13edf7fSJoe Perches			$ctx = $dstat;
5948b13edf7fSJoe Perches
5949b13edf7fSJoe Perches			$dstat =~ s/\\\n.//g;
59501b36b201SJoe Perches			$dstat =~ s/$;/ /g;
5951b13edf7fSJoe Perches
5952b13edf7fSJoe Perches			if ($dstat =~ /^\+\s*#\s*define\s+$Ident\s*${balanced_parens}\s*do\s*{(.*)\s*}\s*while\s*\(\s*0\s*\)\s*([;\s]*)\s*$/) {
5953b13edf7fSJoe Perches				my $stmts = $2;
5954b13edf7fSJoe Perches				my $semis = $3;
5955b13edf7fSJoe Perches
5956b13edf7fSJoe Perches				$ctx =~ s/\n*$//;
5957b13edf7fSJoe Perches				my $cnt = statement_rawlines($ctx);
5958e3d95a2aSTobin C. Harding				my $herectx = get_stat_here($linenr, $cnt, $here);
5959b13edf7fSJoe Perches
5960ac8e97f8SJoe Perches				if (($stmts =~ tr/;/;/) == 1 &&
5961ac8e97f8SJoe Perches				    $stmts !~ /^\s*(if|while|for|switch)\b/) {
5962b13edf7fSJoe Perches					WARN("SINGLE_STATEMENT_DO_WHILE_MACRO",
5963b13edf7fSJoe Perches					     "Single statement macros should not use a do {} while (0) loop\n" . "$herectx");
5964b13edf7fSJoe Perches				}
5965b13edf7fSJoe Perches				if (defined $semis && $semis ne "") {
5966b13edf7fSJoe Perches					WARN("DO_WHILE_MACRO_WITH_TRAILING_SEMICOLON",
5967b13edf7fSJoe Perches					     "do {} while (0) macros should not be semicolon terminated\n" . "$herectx");
5968b13edf7fSJoe Perches				}
5969f5ef95b1SJoe Perches			} elsif ($dstat =~ /^\+\s*#\s*define\s+$Ident.*;\s*$/) {
5970f5ef95b1SJoe Perches				$ctx =~ s/\n*$//;
5971f5ef95b1SJoe Perches				my $cnt = statement_rawlines($ctx);
5972e3d95a2aSTobin C. Harding				my $herectx = get_stat_here($linenr, $cnt, $here);
5973f5ef95b1SJoe Perches
5974f5ef95b1SJoe Perches				WARN("TRAILING_SEMICOLON",
5975f5ef95b1SJoe Perches				     "macros should not use a trailing semicolon\n" . "$herectx");
5976b13edf7fSJoe Perches			}
5977b13edf7fSJoe Perches		}
5978b13edf7fSJoe Perches
5979f0a594c1SAndy Whitcroft# check for redundant bracing round if etc
598013214adfSAndy Whitcroft		if ($line =~ /(^.*)\bif\b/ && $1 !~ /else\s*$/) {
598113214adfSAndy Whitcroft			my ($level, $endln, @chunks) =
5982cf655043SAndy Whitcroft				ctx_statement_full($linenr, $realcnt, 1);
598313214adfSAndy Whitcroft			#print "chunks<$#chunks> linenr<$linenr> endln<$endln> level<$level>\n";
5984cf655043SAndy Whitcroft			#print "APW: <<$chunks[1][0]>><<$chunks[1][1]>>\n";
5985cf655043SAndy Whitcroft			if ($#chunks > 0 && $level == 0) {
5986aad4f614SJoe Perches				my @allowed = ();
5987aad4f614SJoe Perches				my $allow = 0;
598813214adfSAndy Whitcroft				my $seen = 0;
5989773647a0SAndy Whitcroft				my $herectx = $here . "\n";
5990cf655043SAndy Whitcroft				my $ln = $linenr - 1;
599113214adfSAndy Whitcroft				for my $chunk (@chunks) {
599213214adfSAndy Whitcroft					my ($cond, $block) = @{$chunk};
599313214adfSAndy Whitcroft
5994773647a0SAndy Whitcroft					# If the condition carries leading newlines, then count those as offsets.
5995773647a0SAndy Whitcroft					my ($whitespace) = ($cond =~ /^((?:\s*\n[+-])*\s*)/s);
5996773647a0SAndy Whitcroft					my $offset = statement_rawlines($whitespace) - 1;
5997773647a0SAndy Whitcroft
5998aad4f614SJoe Perches					$allowed[$allow] = 0;
5999773647a0SAndy Whitcroft					#print "COND<$cond> whitespace<$whitespace> offset<$offset>\n";
6000773647a0SAndy Whitcroft
6001773647a0SAndy Whitcroft					# We have looked at and allowed this specific line.
6002773647a0SAndy Whitcroft					$suppress_ifbraces{$ln + $offset} = 1;
6003773647a0SAndy Whitcroft
6004773647a0SAndy Whitcroft					$herectx .= "$rawlines[$ln + $offset]\n[...]\n";
6005cf655043SAndy Whitcroft					$ln += statement_rawlines($block) - 1;
6006cf655043SAndy Whitcroft
6007773647a0SAndy Whitcroft					substr($block, 0, length($cond), '');
600813214adfSAndy Whitcroft
600913214adfSAndy Whitcroft					$seen++ if ($block =~ /^\s*{/);
601013214adfSAndy Whitcroft
6011aad4f614SJoe Perches					#print "cond<$cond> block<$block> allowed<$allowed[$allow]>\n";
6012cf655043SAndy Whitcroft					if (statement_lines($cond) > 1) {
6013cf655043SAndy Whitcroft						#print "APW: ALLOWED: cond<$cond>\n";
6014aad4f614SJoe Perches						$allowed[$allow] = 1;
601513214adfSAndy Whitcroft					}
601613214adfSAndy Whitcroft					if ($block =~/\b(?:if|for|while)\b/) {
6017cf655043SAndy Whitcroft						#print "APW: ALLOWED: block<$block>\n";
6018aad4f614SJoe Perches						$allowed[$allow] = 1;
601913214adfSAndy Whitcroft					}
6020cf655043SAndy Whitcroft					if (statement_block_size($block) > 1) {
6021cf655043SAndy Whitcroft						#print "APW: ALLOWED: lines block<$block>\n";
6022aad4f614SJoe Perches						$allowed[$allow] = 1;
602313214adfSAndy Whitcroft					}
6024aad4f614SJoe Perches					$allow++;
602513214adfSAndy Whitcroft				}
6026aad4f614SJoe Perches				if ($seen) {
6027aad4f614SJoe Perches					my $sum_allowed = 0;
6028aad4f614SJoe Perches					foreach (@allowed) {
6029aad4f614SJoe Perches						$sum_allowed += $_;
6030aad4f614SJoe Perches					}
6031aad4f614SJoe Perches					if ($sum_allowed == 0) {
6032000d1cc1SJoe Perches						WARN("BRACES",
6033000d1cc1SJoe Perches						     "braces {} are not necessary for any arm of this statement\n" . $herectx);
6034aad4f614SJoe Perches					} elsif ($sum_allowed != $allow &&
6035aad4f614SJoe Perches						 $seen != $allow) {
6036aad4f614SJoe Perches						CHK("BRACES",
6037aad4f614SJoe Perches						    "braces {} should be used on all arms of this statement\n" . $herectx);
6038aad4f614SJoe Perches					}
603913214adfSAndy Whitcroft				}
604013214adfSAndy Whitcroft			}
604113214adfSAndy Whitcroft		}
6042773647a0SAndy Whitcroft		if (!defined $suppress_ifbraces{$linenr - 1} &&
604313214adfSAndy Whitcroft					$line =~ /\b(if|while|for|else)\b/) {
6044cf655043SAndy Whitcroft			my $allowed = 0;
6045f0a594c1SAndy Whitcroft
6046cf655043SAndy Whitcroft			# Check the pre-context.
6047cf655043SAndy Whitcroft			if (substr($line, 0, $-[0]) =~ /(\}\s*)$/) {
6048cf655043SAndy Whitcroft				#print "APW: ALLOWED: pre<$1>\n";
6049cf655043SAndy Whitcroft				$allowed = 1;
6050f0a594c1SAndy Whitcroft			}
6051773647a0SAndy Whitcroft
6052773647a0SAndy Whitcroft			my ($level, $endln, @chunks) =
6053773647a0SAndy Whitcroft				ctx_statement_full($linenr, $realcnt, $-[0]);
6054773647a0SAndy Whitcroft
6055cf655043SAndy Whitcroft			# Check the condition.
6056cf655043SAndy Whitcroft			my ($cond, $block) = @{$chunks[0]};
6057773647a0SAndy Whitcroft			#print "CHECKING<$linenr> cond<$cond> block<$block>\n";
6058cf655043SAndy Whitcroft			if (defined $cond) {
6059773647a0SAndy Whitcroft				substr($block, 0, length($cond), '');
6060cf655043SAndy Whitcroft			}
6061cf655043SAndy Whitcroft			if (statement_lines($cond) > 1) {
6062cf655043SAndy Whitcroft				#print "APW: ALLOWED: cond<$cond>\n";
6063cf655043SAndy Whitcroft				$allowed = 1;
6064cf655043SAndy Whitcroft			}
6065cf655043SAndy Whitcroft			if ($block =~/\b(?:if|for|while)\b/) {
6066cf655043SAndy Whitcroft				#print "APW: ALLOWED: block<$block>\n";
6067cf655043SAndy Whitcroft				$allowed = 1;
6068cf655043SAndy Whitcroft			}
6069cf655043SAndy Whitcroft			if (statement_block_size($block) > 1) {
6070cf655043SAndy Whitcroft				#print "APW: ALLOWED: lines block<$block>\n";
6071cf655043SAndy Whitcroft				$allowed = 1;
6072cf655043SAndy Whitcroft			}
6073cf655043SAndy Whitcroft			# Check the post-context.
6074cf655043SAndy Whitcroft			if (defined $chunks[1]) {
6075cf655043SAndy Whitcroft				my ($cond, $block) = @{$chunks[1]};
6076cf655043SAndy Whitcroft				if (defined $cond) {
6077773647a0SAndy Whitcroft					substr($block, 0, length($cond), '');
6078cf655043SAndy Whitcroft				}
6079cf655043SAndy Whitcroft				if ($block =~ /^\s*\{/) {
6080cf655043SAndy Whitcroft					#print "APW: ALLOWED: chunk-1 block<$block>\n";
6081cf655043SAndy Whitcroft					$allowed = 1;
6082cf655043SAndy Whitcroft				}
6083cf655043SAndy Whitcroft			}
6084cf655043SAndy Whitcroft			if ($level == 0 && $block =~ /^\s*\{/ && !$allowed) {
6085f055663cSAndy Whitcroft				my $cnt = statement_rawlines($block);
6086e3d95a2aSTobin C. Harding				my $herectx = get_stat_here($linenr, $cnt, $here);
6087cf655043SAndy Whitcroft
6088000d1cc1SJoe Perches				WARN("BRACES",
6089000d1cc1SJoe Perches				     "braces {} are not necessary for single statement blocks\n" . $herectx);
6090f0a594c1SAndy Whitcroft			}
6091f0a594c1SAndy Whitcroft		}
6092f0a594c1SAndy Whitcroft
6093e4c5babdSJoe Perches# check for single line unbalanced braces
609495330473SSven Eckelmann		if ($sline =~ /^.\s*\}\s*else\s*$/ ||
609595330473SSven Eckelmann		    $sline =~ /^.\s*else\s*\{\s*$/) {
6096e4c5babdSJoe Perches			CHK("BRACES", "Unbalanced braces around else statement\n" . $herecurr);
6097e4c5babdSJoe Perches		}
6098e4c5babdSJoe Perches
60990979ae66SJoe Perches# check for unnecessary blank lines around braces
610077b9a53aSJoe Perches		if (($line =~ /^.\s*}\s*$/ && $prevrawline =~ /^.\s*$/)) {
6101f8e58219SJoe Perches			if (CHK("BRACES",
6102f8e58219SJoe Perches				"Blank lines aren't necessary before a close brace '}'\n" . $hereprev) &&
6103f8e58219SJoe Perches			    $fix && $prevrawline =~ /^\+/) {
6104f8e58219SJoe Perches				fix_delete_line($fixlinenr - 1, $prevrawline);
6105f8e58219SJoe Perches			}
61060979ae66SJoe Perches		}
610777b9a53aSJoe Perches		if (($rawline =~ /^.\s*$/ && $prevline =~ /^..*{\s*$/)) {
6108f8e58219SJoe Perches			if (CHK("BRACES",
6109f8e58219SJoe Perches				"Blank lines aren't necessary after an open brace '{'\n" . $hereprev) &&
6110f8e58219SJoe Perches			    $fix) {
6111f8e58219SJoe Perches				fix_delete_line($fixlinenr, $rawline);
6112f8e58219SJoe Perches			}
61130979ae66SJoe Perches		}
61140979ae66SJoe Perches
61154a0df2efSAndy Whitcroft# no volatiles please
61166c72ffaaSAndy Whitcroft		my $asm_volatile = qr{\b(__asm__|asm)\s+(__volatile__|volatile)\b};
61176c72ffaaSAndy Whitcroft		if ($line =~ /\bvolatile\b/ && $line !~ /$asm_volatile/) {
6118000d1cc1SJoe Perches			WARN("VOLATILE",
61198c27ceffSMauro Carvalho Chehab			     "Use of volatile is usually wrong: see Documentation/process/volatile-considered-harmful.rst\n" . $herecurr);
61204a0df2efSAndy Whitcroft		}
61214a0df2efSAndy Whitcroft
61225e4f6ba5SJoe Perches# Check for user-visible strings broken across lines, which breaks the ability
61235e4f6ba5SJoe Perches# to grep for the string.  Make exceptions when the previous string ends in a
61245e4f6ba5SJoe Perches# newline (multiple lines in one string constant) or '\t', '\r', ';', or '{'
61255e4f6ba5SJoe Perches# (common in inline assembly) or is a octal \123 or hexadecimal \xaf value
612633acb54aSJoe Perches		if ($line =~ /^\+\s*$String/ &&
61275e4f6ba5SJoe Perches		    $prevline =~ /"\s*$/ &&
61285e4f6ba5SJoe Perches		    $prevrawline !~ /(?:\\(?:[ntr]|[0-7]{1,3}|x[0-9a-fA-F]{1,2})|;\s*|\{\s*)"\s*$/) {
61295e4f6ba5SJoe Perches			if (WARN("SPLIT_STRING",
61305e4f6ba5SJoe Perches				 "quoted string split across lines\n" . $hereprev) &&
61315e4f6ba5SJoe Perches				     $fix &&
61325e4f6ba5SJoe Perches				     $prevrawline =~ /^\+.*"\s*$/ &&
61335e4f6ba5SJoe Perches				     $last_coalesced_string_linenr != $linenr - 1) {
61345e4f6ba5SJoe Perches				my $extracted_string = get_quoted_string($line, $rawline);
61355e4f6ba5SJoe Perches				my $comma_close = "";
61365e4f6ba5SJoe Perches				if ($rawline =~ /\Q$extracted_string\E(\s*\)\s*;\s*$|\s*,\s*)/) {
61375e4f6ba5SJoe Perches					$comma_close = $1;
61385e4f6ba5SJoe Perches				}
61395e4f6ba5SJoe Perches
61405e4f6ba5SJoe Perches				fix_delete_line($fixlinenr - 1, $prevrawline);
61415e4f6ba5SJoe Perches				fix_delete_line($fixlinenr, $rawline);
61425e4f6ba5SJoe Perches				my $fixedline = $prevrawline;
61435e4f6ba5SJoe Perches				$fixedline =~ s/"\s*$//;
61445e4f6ba5SJoe Perches				$fixedline .= substr($extracted_string, 1) . trim($comma_close);
61455e4f6ba5SJoe Perches				fix_insert_line($fixlinenr - 1, $fixedline);
61465e4f6ba5SJoe Perches				$fixedline = $rawline;
61475e4f6ba5SJoe Perches				$fixedline =~ s/\Q$extracted_string\E\Q$comma_close\E//;
61485e4f6ba5SJoe Perches				if ($fixedline !~ /\+\s*$/) {
61495e4f6ba5SJoe Perches					fix_insert_line($fixlinenr, $fixedline);
61505e4f6ba5SJoe Perches				}
61515e4f6ba5SJoe Perches				$last_coalesced_string_linenr = $linenr;
61525e4f6ba5SJoe Perches			}
61535e4f6ba5SJoe Perches		}
61545e4f6ba5SJoe Perches
61555e4f6ba5SJoe Perches# check for missing a space in a string concatenation
61565e4f6ba5SJoe Perches		if ($prevrawline =~ /[^\\]\w"$/ && $rawline =~ /^\+[\t ]+"\w/) {
61575e4f6ba5SJoe Perches			WARN('MISSING_SPACE',
61585e4f6ba5SJoe Perches			     "break quoted strings at a space character\n" . $hereprev);
61595e4f6ba5SJoe Perches		}
61605e4f6ba5SJoe Perches
616177cb8546SJoe Perches# check for an embedded function name in a string when the function is known
6162e4b7d309SJoe Perches# This does not work very well for -f --file checking as it depends on patch
6163e4b7d309SJoe Perches# context providing the function name or a single line form for in-file
6164e4b7d309SJoe Perches# function declarations
616577cb8546SJoe Perches		if ($line =~ /^\+.*$String/ &&
616677cb8546SJoe Perches		    defined($context_function) &&
6167e4b7d309SJoe Perches		    get_quoted_string($line, $rawline) =~ /\b$context_function\b/ &&
6168e4b7d309SJoe Perches		    length(get_quoted_string($line, $rawline)) != (length($context_function) + 2)) {
616977cb8546SJoe Perches			WARN("EMBEDDED_FUNCTION_NAME",
6170e4b7d309SJoe Perches			     "Prefer using '\"%s...\", __func__' to using '$context_function', this function's name, in a string\n" . $herecurr);
617177cb8546SJoe Perches		}
617277cb8546SJoe Perches
6173adb2da82SJoe Perches# check for unnecessary function tracing like uses
6174adb2da82SJoe Perches# This does not use $logFunctions because there are many instances like
6175adb2da82SJoe Perches# 'dprintk(FOO, "%s()\n", __func__);' which do not match $logFunctions
6176adb2da82SJoe Perches		if ($rawline =~ /^\+.*\([^"]*"$tracing_logging_tags{0,3}%s(?:\s*\(\s*\)\s*)?$tracing_logging_tags{0,3}(?:\\n)?"\s*,\s*__func__\s*\)\s*;/) {
6177adb2da82SJoe Perches			if (WARN("TRACING_LOGGING",
6178adb2da82SJoe Perches				 "Unnecessary ftrace-like logging - prefer using ftrace\n" . $herecurr) &&
6179adb2da82SJoe Perches			    $fix) {
6180adb2da82SJoe Perches                                fix_delete_line($fixlinenr, $rawline);
6181adb2da82SJoe Perches			}
6182adb2da82SJoe Perches		}
6183adb2da82SJoe Perches
61845e4f6ba5SJoe Perches# check for spaces before a quoted newline
61855e4f6ba5SJoe Perches		if ($rawline =~ /^.*\".*\s\\n/) {
61865e4f6ba5SJoe Perches			if (WARN("QUOTED_WHITESPACE_BEFORE_NEWLINE",
61875e4f6ba5SJoe Perches				 "unnecessary whitespace before a quoted newline\n" . $herecurr) &&
61885e4f6ba5SJoe Perches			    $fix) {
61895e4f6ba5SJoe Perches				$fixed[$fixlinenr] =~ s/^(\+.*\".*)\s+\\n/$1\\n/;
61905e4f6ba5SJoe Perches			}
61915e4f6ba5SJoe Perches
61925e4f6ba5SJoe Perches		}
61935e4f6ba5SJoe Perches
6194f17dba4fSJoe Perches# concatenated string without spaces between elements
6195d2af5aa6SJoe Perches		if ($line =~ /$String[A-Z_]/ ||
6196d2af5aa6SJoe Perches		    ($line =~ /([A-Za-z0-9_]+)$String/ && $1 !~ /^[Lu]$/)) {
619779682c0cSJoe Perches			if (CHK("CONCATENATED_STRING",
619879682c0cSJoe Perches				"Concatenated strings should use spaces between elements\n" . $herecurr) &&
619979682c0cSJoe Perches			    $fix) {
620079682c0cSJoe Perches				while ($line =~ /($String)/g) {
620179682c0cSJoe Perches					my $extracted_string = substr($rawline, $-[0], $+[0] - $-[0]);
620279682c0cSJoe Perches					$fixed[$fixlinenr] =~ s/\Q$extracted_string\E([A-Za-z0-9_])/$extracted_string $1/;
620379682c0cSJoe Perches					$fixed[$fixlinenr] =~ s/([A-Za-z0-9_])\Q$extracted_string\E/$1 $extracted_string/;
620479682c0cSJoe Perches				}
620579682c0cSJoe Perches			}
6206f17dba4fSJoe Perches		}
6207f17dba4fSJoe Perches
620890ad30e5SJoe Perches# uncoalesced string fragments
6209d2af5aa6SJoe Perches		if ($line =~ /$String\s*[Lu]?"/) {
621079682c0cSJoe Perches			if (WARN("STRING_FRAGMENTS",
621179682c0cSJoe Perches				 "Consecutive strings are generally better as a single string\n" . $herecurr) &&
621279682c0cSJoe Perches			    $fix) {
621379682c0cSJoe Perches				while ($line =~ /($String)(?=\s*")/g) {
621479682c0cSJoe Perches					my $extracted_string = substr($rawline, $-[0], $+[0] - $-[0]);
621579682c0cSJoe Perches					$fixed[$fixlinenr] =~ s/\Q$extracted_string\E\s*"/substr($extracted_string, 0, -1)/e;
621679682c0cSJoe Perches				}
621779682c0cSJoe Perches			}
621890ad30e5SJoe Perches		}
621990ad30e5SJoe Perches
6220522b837cSAlexey Dobriyan# check for non-standard and hex prefixed decimal printf formats
6221522b837cSAlexey Dobriyan		my $show_L = 1;	#don't show the same defect twice
6222522b837cSAlexey Dobriyan		my $show_Z = 1;
62235e4f6ba5SJoe Perches		while ($line =~ /(?:^|")([X\t]*)(?:"|$)/g) {
6224522b837cSAlexey Dobriyan			my $string = substr($rawline, $-[1], $+[1] - $-[1]);
62255e4f6ba5SJoe Perches			$string =~ s/%%/__/g;
6226522b837cSAlexey Dobriyan			# check for %L
6227522b837cSAlexey Dobriyan			if ($show_L && $string =~ /%[\*\d\.\$]*L([diouxX])/) {
62285e4f6ba5SJoe Perches				WARN("PRINTF_L",
6229522b837cSAlexey Dobriyan				     "\%L$1 is non-standard C, use %ll$1\n" . $herecurr);
6230522b837cSAlexey Dobriyan				$show_L = 0;
62315e4f6ba5SJoe Perches			}
6232522b837cSAlexey Dobriyan			# check for %Z
6233522b837cSAlexey Dobriyan			if ($show_Z && $string =~ /%[\*\d\.\$]*Z([diouxX])/) {
6234522b837cSAlexey Dobriyan				WARN("PRINTF_Z",
6235522b837cSAlexey Dobriyan				     "%Z$1 is non-standard C, use %z$1\n" . $herecurr);
6236522b837cSAlexey Dobriyan				$show_Z = 0;
6237522b837cSAlexey Dobriyan			}
6238522b837cSAlexey Dobriyan			# check for 0x<decimal>
6239522b837cSAlexey Dobriyan			if ($string =~ /0x%[\*\d\.\$\Llzth]*[diou]/) {
6240522b837cSAlexey Dobriyan				ERROR("PRINTF_0XDECIMAL",
62416e300757SJoe Perches				      "Prefixing 0x with decimal output is defective\n" . $herecurr);
62426e300757SJoe Perches			}
62435e4f6ba5SJoe Perches		}
62445e4f6ba5SJoe Perches
62455e4f6ba5SJoe Perches# check for line continuations in quoted strings with odd counts of "
62463f7f335dSJoe Perches		if ($rawline =~ /\\$/ && $sline =~ tr/"/"/ % 2) {
62475e4f6ba5SJoe Perches			WARN("LINE_CONTINUATIONS",
62485e4f6ba5SJoe Perches			     "Avoid line continuations in quoted strings\n" . $herecurr);
62495e4f6ba5SJoe Perches		}
62505e4f6ba5SJoe Perches
625100df344fSAndy Whitcroft# warn about #if 0
6252c45dcabdSAndy Whitcroft		if ($line =~ /^.\s*\#\s*if\s+0\b/) {
625360f89010SPrakruthi Deepak Heragu			WARN("IF_0",
625460f89010SPrakruthi Deepak Heragu			     "Consider removing the code enclosed by this #if 0 and its #endif\n" . $herecurr);
625560f89010SPrakruthi Deepak Heragu		}
625660f89010SPrakruthi Deepak Heragu
625760f89010SPrakruthi Deepak Heragu# warn about #if 1
625860f89010SPrakruthi Deepak Heragu		if ($line =~ /^.\s*\#\s*if\s+1\b/) {
625960f89010SPrakruthi Deepak Heragu			WARN("IF_1",
626060f89010SPrakruthi Deepak Heragu			     "Consider removing the #if 1 and its #endif\n" . $herecurr);
62614a0df2efSAndy Whitcroft		}
62624a0df2efSAndy Whitcroft
626303df4b51SAndy Whitcroft# check for needless "if (<foo>) fn(<foo>)" uses
626403df4b51SAndy Whitcroft		if ($prevline =~ /\bif\s*\(\s*($Lval)\s*\)/) {
6265100425deSJoe Perches			my $tested = quotemeta($1);
6266100425deSJoe Perches			my $expr = '\s*\(\s*' . $tested . '\s*\)\s*;';
6267100425deSJoe Perches			if ($line =~ /\b(kfree|usb_free_urb|debugfs_remove(?:_recursive)?|(?:kmem_cache|mempool|dma_pool)_destroy)$expr/) {
6268100425deSJoe Perches				my $func = $1;
6269100425deSJoe Perches				if (WARN('NEEDLESS_IF',
6270100425deSJoe Perches					 "$func(NULL) is safe and this check is probably not required\n" . $hereprev) &&
6271100425deSJoe Perches				    $fix) {
6272100425deSJoe Perches					my $do_fix = 1;
6273100425deSJoe Perches					my $leading_tabs = "";
6274100425deSJoe Perches					my $new_leading_tabs = "";
6275100425deSJoe Perches					if ($lines[$linenr - 2] =~ /^\+(\t*)if\s*\(\s*$tested\s*\)\s*$/) {
6276100425deSJoe Perches						$leading_tabs = $1;
6277100425deSJoe Perches					} else {
6278100425deSJoe Perches						$do_fix = 0;
6279100425deSJoe Perches					}
6280100425deSJoe Perches					if ($lines[$linenr - 1] =~ /^\+(\t+)$func\s*\(\s*$tested\s*\)\s*;\s*$/) {
6281100425deSJoe Perches						$new_leading_tabs = $1;
6282100425deSJoe Perches						if (length($leading_tabs) + 1 ne length($new_leading_tabs)) {
6283100425deSJoe Perches							$do_fix = 0;
6284100425deSJoe Perches						}
6285100425deSJoe Perches					} else {
6286100425deSJoe Perches						$do_fix = 0;
6287100425deSJoe Perches					}
6288100425deSJoe Perches					if ($do_fix) {
6289100425deSJoe Perches						fix_delete_line($fixlinenr - 1, $prevrawline);
6290100425deSJoe Perches						$fixed[$fixlinenr] =~ s/^\+$new_leading_tabs/\+$leading_tabs/;
6291100425deSJoe Perches					}
6292100425deSJoe Perches				}
62934c432a8fSGreg Kroah-Hartman			}
62944c432a8fSGreg Kroah-Hartman		}
6295f0a594c1SAndy Whitcroft
6296ebfdc409SJoe Perches# check for unnecessary "Out of Memory" messages
6297ebfdc409SJoe Perches		if ($line =~ /^\+.*\b$logFunctions\s*\(/ &&
6298ebfdc409SJoe Perches		    $prevline =~ /^[ \+]\s*if\s*\(\s*(\!\s*|NULL\s*==\s*)?($Lval)(\s*==\s*NULL\s*)?\s*\)/ &&
6299ebfdc409SJoe Perches		    (defined $1 || defined $3) &&
6300ebfdc409SJoe Perches		    $linenr > 3) {
6301ebfdc409SJoe Perches			my $testval = $2;
6302ebfdc409SJoe Perches			my $testline = $lines[$linenr - 3];
6303ebfdc409SJoe Perches
6304ebfdc409SJoe Perches			my ($s, $c) = ctx_statement_block($linenr - 3, $realcnt, 0);
6305ebfdc409SJoe Perches#			print("line: <$line>\nprevline: <$prevline>\ns: <$s>\nc: <$c>\n\n\n");
6306ebfdc409SJoe Perches
6307e29a70f1SJoe Perches			if ($s =~ /(?:^|\n)[ \+]\s*(?:$Type\s*)?\Q$testval\E\s*=\s*(?:\([^\)]*\)\s*)?\s*$allocFunctions\s*\(/ &&
6308e29a70f1SJoe Perches			    $s !~ /\b__GFP_NOWARN\b/ ) {
6309ebfdc409SJoe Perches				WARN("OOM_MESSAGE",
6310ebfdc409SJoe Perches				     "Possible unnecessary 'out of memory' message\n" . $hereprev);
6311ebfdc409SJoe Perches			}
6312ebfdc409SJoe Perches		}
6313ebfdc409SJoe Perches
6314f78d98f6SJoe Perches# check for logging functions with KERN_<LEVEL>
6315dcaf1123SPaolo Bonzini		if ($line !~ /printk(?:_ratelimited|_once)?\s*\(/ &&
6316f78d98f6SJoe Perches		    $line =~ /\b$logFunctions\s*\(.*\b(KERN_[A-Z]+)\b/) {
6317f78d98f6SJoe Perches			my $level = $1;
6318f78d98f6SJoe Perches			if (WARN("UNNECESSARY_KERN_LEVEL",
6319f78d98f6SJoe Perches				 "Possible unnecessary $level\n" . $herecurr) &&
6320f78d98f6SJoe Perches			    $fix) {
6321f78d98f6SJoe Perches				$fixed[$fixlinenr] =~ s/\s*$level\s*//;
6322f78d98f6SJoe Perches			}
6323f78d98f6SJoe Perches		}
6324f78d98f6SJoe Perches
632545c55e92SJoe Perches# check for logging continuations
632645c55e92SJoe Perches		if ($line =~ /\bprintk\s*\(\s*KERN_CONT\b|\bpr_cont\s*\(/) {
632745c55e92SJoe Perches			WARN("LOGGING_CONTINUATION",
632845c55e92SJoe Perches			     "Avoid logging continuation uses where feasible\n" . $herecurr);
632945c55e92SJoe Perches		}
633045c55e92SJoe Perches
633170eb2275SDwaipayan Ray# check for unnecessary use of %h[xudi] and %hh[xudi] in logging functions
633270eb2275SDwaipayan Ray		if (defined $stat &&
633370eb2275SDwaipayan Ray		    $line =~ /\b$logFunctions\s*\(/ &&
633470eb2275SDwaipayan Ray		    index($stat, '"') >= 0) {
633570eb2275SDwaipayan Ray			my $lc = $stat =~ tr@\n@@;
633670eb2275SDwaipayan Ray			$lc = $lc + $linenr;
633770eb2275SDwaipayan Ray			my $stat_real = get_stat_real($linenr, $lc);
633870eb2275SDwaipayan Ray			pos($stat_real) = index($stat_real, '"');
633970eb2275SDwaipayan Ray			while ($stat_real =~ /[^\"%]*(%[\#\d\.\*\-]*(h+)[idux])/g) {
634070eb2275SDwaipayan Ray				my $pspec = $1;
634170eb2275SDwaipayan Ray				my $h = $2;
634270eb2275SDwaipayan Ray				my $lineoff = substr($stat_real, 0, $-[1]) =~ tr@\n@@;
634370eb2275SDwaipayan Ray				if (WARN("UNNECESSARY_MODIFIER",
634470eb2275SDwaipayan Ray					 "Integer promotion: Using '$h' in '$pspec' is unnecessary\n" . "$here\n$stat_real\n") &&
634570eb2275SDwaipayan Ray				    $fix && $fixed[$fixlinenr + $lineoff] =~ /^\+/) {
634670eb2275SDwaipayan Ray					my $nspec = $pspec;
634770eb2275SDwaipayan Ray					$nspec =~ s/h//g;
634870eb2275SDwaipayan Ray					$fixed[$fixlinenr + $lineoff] =~ s/\Q$pspec\E/$nspec/;
634970eb2275SDwaipayan Ray				}
635070eb2275SDwaipayan Ray			}
635170eb2275SDwaipayan Ray		}
635270eb2275SDwaipayan Ray
6353abb08a53SJoe Perches# check for mask then right shift without a parentheses
63545b57980dSJoe Perches		if ($perl_version_ok &&
6355abb08a53SJoe Perches		    $line =~ /$LvalOrFunc\s*\&\s*($LvalOrFunc)\s*>>/ &&
6356abb08a53SJoe Perches		    $4 !~ /^\&/) { # $LvalOrFunc may be &foo, ignore if so
6357abb08a53SJoe Perches			WARN("MASK_THEN_SHIFT",
6358abb08a53SJoe Perches			     "Possible precedence defect with mask then right shift - may need parentheses\n" . $herecurr);
6359abb08a53SJoe Perches		}
6360abb08a53SJoe Perches
6361b75ac618SJoe Perches# check for pointer comparisons to NULL
63625b57980dSJoe Perches		if ($perl_version_ok) {
6363b75ac618SJoe Perches			while ($line =~ /\b$LvalOrFunc\s*(==|\!=)\s*NULL\b/g) {
6364b75ac618SJoe Perches				my $val = $1;
6365b75ac618SJoe Perches				my $equal = "!";
6366b75ac618SJoe Perches				$equal = "" if ($4 eq "!=");
6367b75ac618SJoe Perches				if (CHK("COMPARISON_TO_NULL",
6368b75ac618SJoe Perches					"Comparison to NULL could be written \"${equal}${val}\"\n" . $herecurr) &&
6369b75ac618SJoe Perches					    $fix) {
6370b75ac618SJoe Perches					$fixed[$fixlinenr] =~ s/\b\Q$val\E\s*(?:==|\!=)\s*NULL\b/$equal$val/;
6371b75ac618SJoe Perches				}
6372b75ac618SJoe Perches			}
6373b75ac618SJoe Perches		}
6374b75ac618SJoe Perches
63758716de38SJoe Perches# check for bad placement of section $InitAttribute (e.g.: __initdata)
63768716de38SJoe Perches		if ($line =~ /(\b$InitAttribute\b)/) {
63778716de38SJoe Perches			my $attr = $1;
63788716de38SJoe Perches			if ($line =~ /^\+\s*static\s+(?:const\s+)?(?:$attr\s+)?($NonptrTypeWithAttr)\s+(?:$attr\s+)?($Ident(?:\[[^]]*\])?)\s*[=;]/) {
63798716de38SJoe Perches				my $ptr = $1;
63808716de38SJoe Perches				my $var = $2;
63818716de38SJoe Perches				if ((($ptr =~ /\b(union|struct)\s+$attr\b/ &&
63828716de38SJoe Perches				      ERROR("MISPLACED_INIT",
63838716de38SJoe Perches					    "$attr should be placed after $var\n" . $herecurr)) ||
63848716de38SJoe Perches				     ($ptr !~ /\b(union|struct)\s+$attr\b/ &&
63858716de38SJoe Perches				      WARN("MISPLACED_INIT",
63868716de38SJoe Perches					   "$attr should be placed after $var\n" . $herecurr))) &&
63878716de38SJoe Perches				    $fix) {
6388194f66fcSJoe Perches					$fixed[$fixlinenr] =~ s/(\bstatic\s+(?:const\s+)?)(?:$attr\s+)?($NonptrTypeWithAttr)\s+(?:$attr\s+)?($Ident(?:\[[^]]*\])?)\s*([=;])\s*/"$1" . trim(string_find_replace($2, "\\s*$attr\\s*", " ")) . " " . trim(string_find_replace($3, "\\s*$attr\\s*", "")) . " $attr" . ("$4" eq ";" ? ";" : " = ")/e;
63898716de38SJoe Perches				}
63908716de38SJoe Perches			}
63918716de38SJoe Perches		}
63928716de38SJoe Perches
6393e970b884SJoe Perches# check for $InitAttributeData (ie: __initdata) with const
6394e970b884SJoe Perches		if ($line =~ /\bconst\b/ && $line =~ /($InitAttributeData)/) {
6395e970b884SJoe Perches			my $attr = $1;
6396e970b884SJoe Perches			$attr =~ /($InitAttributePrefix)(.*)/;
6397e970b884SJoe Perches			my $attr_prefix = $1;
6398e970b884SJoe Perches			my $attr_type = $2;
6399e970b884SJoe Perches			if (ERROR("INIT_ATTRIBUTE",
6400e970b884SJoe Perches				  "Use of const init definition must use ${attr_prefix}initconst\n" . $herecurr) &&
6401e970b884SJoe Perches			    $fix) {
6402194f66fcSJoe Perches				$fixed[$fixlinenr] =~
6403e970b884SJoe Perches				    s/$InitAttributeData/${attr_prefix}initconst/;
6404e970b884SJoe Perches			}
6405e970b884SJoe Perches		}
6406e970b884SJoe Perches
6407e970b884SJoe Perches# check for $InitAttributeConst (ie: __initconst) without const
6408e970b884SJoe Perches		if ($line !~ /\bconst\b/ && $line =~ /($InitAttributeConst)/) {
6409e970b884SJoe Perches			my $attr = $1;
6410e970b884SJoe Perches			if (ERROR("INIT_ATTRIBUTE",
6411e970b884SJoe Perches				  "Use of $attr requires a separate use of const\n" . $herecurr) &&
6412e970b884SJoe Perches			    $fix) {
6413194f66fcSJoe Perches				my $lead = $fixed[$fixlinenr] =~
6414e970b884SJoe Perches				    /(^\+\s*(?:static\s+))/;
6415e970b884SJoe Perches				$lead = rtrim($1);
6416e970b884SJoe Perches				$lead = "$lead " if ($lead !~ /^\+$/);
6417e970b884SJoe Perches				$lead = "${lead}const ";
6418194f66fcSJoe Perches				$fixed[$fixlinenr] =~ s/(^\+\s*(?:static\s+))/$lead/;
6419e970b884SJoe Perches			}
6420e970b884SJoe Perches		}
6421e970b884SJoe Perches
6422c17893c7SJoe Perches# check for __read_mostly with const non-pointer (should just be const)
6423c17893c7SJoe Perches		if ($line =~ /\b__read_mostly\b/ &&
6424c17893c7SJoe Perches		    $line =~ /($Type)\s*$Ident/ && $1 !~ /\*\s*$/ && $1 =~ /\bconst\b/) {
6425c17893c7SJoe Perches			if (ERROR("CONST_READ_MOSTLY",
6426c17893c7SJoe Perches				  "Invalid use of __read_mostly with const type\n" . $herecurr) &&
6427c17893c7SJoe Perches			    $fix) {
6428c17893c7SJoe Perches				$fixed[$fixlinenr] =~ s/\s+__read_mostly\b//;
6429c17893c7SJoe Perches			}
6430c17893c7SJoe Perches		}
6431c17893c7SJoe Perches
6432fbdb8138SJoe Perches# don't use __constant_<foo> functions outside of include/uapi/
6433fbdb8138SJoe Perches		if ($realfile !~ m@^include/uapi/@ &&
6434fbdb8138SJoe Perches		    $line =~ /(__constant_(?:htons|ntohs|[bl]e(?:16|32|64)_to_cpu|cpu_to_[bl]e(?:16|32|64)))\s*\(/) {
6435fbdb8138SJoe Perches			my $constant_func = $1;
6436fbdb8138SJoe Perches			my $func = $constant_func;
6437fbdb8138SJoe Perches			$func =~ s/^__constant_//;
6438fbdb8138SJoe Perches			if (WARN("CONSTANT_CONVERSION",
6439fbdb8138SJoe Perches				 "$constant_func should be $func\n" . $herecurr) &&
6440fbdb8138SJoe Perches			    $fix) {
6441194f66fcSJoe Perches				$fixed[$fixlinenr] =~ s/\b$constant_func\b/$func/g;
6442fbdb8138SJoe Perches			}
6443fbdb8138SJoe Perches		}
6444fbdb8138SJoe Perches
64451a15a250SPatrick Pannuto# prefer usleep_range over udelay
644637581c28SBruce Allan		if ($line =~ /\budelay\s*\(\s*(\d+)\s*\)/) {
644743c1d77cSJoe Perches			my $delay = $1;
64481a15a250SPatrick Pannuto			# ignore udelay's < 10, however
644943c1d77cSJoe Perches			if (! ($delay < 10) ) {
6450000d1cc1SJoe Perches				CHK("USLEEP_RANGE",
6451458f69efSMauro Carvalho Chehab				    "usleep_range is preferred over udelay; see Documentation/timers/timers-howto.rst\n" . $herecurr);
645243c1d77cSJoe Perches			}
645343c1d77cSJoe Perches			if ($delay > 2000) {
645443c1d77cSJoe Perches				WARN("LONG_UDELAY",
645543c1d77cSJoe Perches				     "long udelay - prefer mdelay; see arch/arm/include/asm/delay.h\n" . $herecurr);
64561a15a250SPatrick Pannuto			}
64571a15a250SPatrick Pannuto		}
64581a15a250SPatrick Pannuto
645909ef8725SPatrick Pannuto# warn about unexpectedly long msleep's
646009ef8725SPatrick Pannuto		if ($line =~ /\bmsleep\s*\((\d+)\);/) {
646109ef8725SPatrick Pannuto			if ($1 < 20) {
6462000d1cc1SJoe Perches				WARN("MSLEEP",
6463458f69efSMauro Carvalho Chehab				     "msleep < 20ms can sleep for up to 20ms; see Documentation/timers/timers-howto.rst\n" . $herecurr);
646409ef8725SPatrick Pannuto			}
646509ef8725SPatrick Pannuto		}
646609ef8725SPatrick Pannuto
646736ec1939SJoe Perches# check for comparisons of jiffies
646836ec1939SJoe Perches		if ($line =~ /\bjiffies\s*$Compare|$Compare\s*jiffies\b/) {
646936ec1939SJoe Perches			WARN("JIFFIES_COMPARISON",
647036ec1939SJoe Perches			     "Comparing jiffies is almost always wrong; prefer time_after, time_before and friends\n" . $herecurr);
647136ec1939SJoe Perches		}
647236ec1939SJoe Perches
64739d7a34a5SJoe Perches# check for comparisons of get_jiffies_64()
64749d7a34a5SJoe Perches		if ($line =~ /\bget_jiffies_64\s*\(\s*\)\s*$Compare|$Compare\s*get_jiffies_64\s*\(\s*\)/) {
64759d7a34a5SJoe Perches			WARN("JIFFIES_COMPARISON",
64769d7a34a5SJoe Perches			     "Comparing get_jiffies_64() is almost always wrong; prefer time_after64, time_before64 and friends\n" . $herecurr);
64779d7a34a5SJoe Perches		}
64789d7a34a5SJoe Perches
647900df344fSAndy Whitcroft# warn about #ifdefs in C files
6480c45dcabdSAndy Whitcroft#		if ($line =~ /^.\s*\#\s*if(|n)def/ && ($realfile =~ /\.c$/)) {
648100df344fSAndy Whitcroft#			print "#ifdef in C files should be avoided\n";
648200df344fSAndy Whitcroft#			print "$herecurr";
648300df344fSAndy Whitcroft#			$clean = 0;
648400df344fSAndy Whitcroft#		}
648500df344fSAndy Whitcroft
648622f2a2efSAndy Whitcroft# warn about spacing in #ifdefs
6487c45dcabdSAndy Whitcroft		if ($line =~ /^.\s*\#\s*(ifdef|ifndef|elif)\s\s+/) {
64883705ce5bSJoe Perches			if (ERROR("SPACING",
64893705ce5bSJoe Perches				  "exactly one space required after that #$1\n" . $herecurr) &&
64903705ce5bSJoe Perches			    $fix) {
6491194f66fcSJoe Perches				$fixed[$fixlinenr] =~
64923705ce5bSJoe Perches				    s/^(.\s*\#\s*(ifdef|ifndef|elif))\s{2,}/$1 /;
64933705ce5bSJoe Perches			}
64943705ce5bSJoe Perches
649522f2a2efSAndy Whitcroft		}
649622f2a2efSAndy Whitcroft
64974a0df2efSAndy Whitcroft# check for spinlock_t definitions without a comment.
6498171ae1a4SAndy Whitcroft		if ($line =~ /^.\s*(struct\s+mutex|spinlock_t)\s+\S+;/ ||
6499171ae1a4SAndy Whitcroft		    $line =~ /^.\s*(DEFINE_MUTEX)\s*\(/) {
65004a0df2efSAndy Whitcroft			my $which = $1;
65014a0df2efSAndy Whitcroft			if (!ctx_has_comment($first_line, $linenr)) {
6502000d1cc1SJoe Perches				CHK("UNCOMMENTED_DEFINITION",
6503000d1cc1SJoe Perches				    "$1 definition without comment\n" . $herecurr);
65044a0df2efSAndy Whitcroft			}
65054a0df2efSAndy Whitcroft		}
65064a0df2efSAndy Whitcroft# check for memory barriers without a comment.
6507402c2553SMichael S. Tsirkin
6508402c2553SMichael S. Tsirkin		my $barriers = qr{
6509402c2553SMichael S. Tsirkin			mb|
6510402c2553SMichael S. Tsirkin			rmb|
6511ad83ec6cSWill Deacon			wmb
6512402c2553SMichael S. Tsirkin		}x;
6513402c2553SMichael S. Tsirkin		my $barrier_stems = qr{
6514402c2553SMichael S. Tsirkin			mb__before_atomic|
6515402c2553SMichael S. Tsirkin			mb__after_atomic|
6516402c2553SMichael S. Tsirkin			store_release|
6517402c2553SMichael S. Tsirkin			load_acquire|
6518402c2553SMichael S. Tsirkin			store_mb|
6519402c2553SMichael S. Tsirkin			(?:$barriers)
6520402c2553SMichael S. Tsirkin		}x;
6521402c2553SMichael S. Tsirkin		my $all_barriers = qr{
6522402c2553SMichael S. Tsirkin			(?:$barriers)|
652343e361f2SMichael S. Tsirkin			smp_(?:$barrier_stems)|
652443e361f2SMichael S. Tsirkin			virt_(?:$barrier_stems)
6525402c2553SMichael S. Tsirkin		}x;
6526402c2553SMichael S. Tsirkin
6527402c2553SMichael S. Tsirkin		if ($line =~ /\b(?:$all_barriers)\s*\(/) {
65284a0df2efSAndy Whitcroft			if (!ctx_has_comment($first_line, $linenr)) {
6529c1fd7bb9SJoe Perches				WARN("MEMORY_BARRIER",
6530000d1cc1SJoe Perches				     "memory barrier without comment\n" . $herecurr);
65314a0df2efSAndy Whitcroft			}
65324a0df2efSAndy Whitcroft		}
65333ad81779SPaul E. McKenney
6534f4073b0fSMichael S. Tsirkin		my $underscore_smp_barriers = qr{__smp_(?:$barrier_stems)}x;
6535f4073b0fSMichael S. Tsirkin
6536f4073b0fSMichael S. Tsirkin		if ($realfile !~ m@^include/asm-generic/@ &&
6537f4073b0fSMichael S. Tsirkin		    $realfile !~ m@/barrier\.h$@ &&
6538f4073b0fSMichael S. Tsirkin		    $line =~ m/\b(?:$underscore_smp_barriers)\s*\(/ &&
6539f4073b0fSMichael S. Tsirkin		    $line !~ m/^.\s*\#\s*define\s+(?:$underscore_smp_barriers)\s*\(/) {
6540f4073b0fSMichael S. Tsirkin			WARN("MEMORY_BARRIER",
6541f4073b0fSMichael S. Tsirkin			     "__smp memory barriers shouldn't be used outside barrier.h and asm-generic\n" . $herecurr);
6542f4073b0fSMichael S. Tsirkin		}
6543f4073b0fSMichael S. Tsirkin
6544cb426e99SJoe Perches# check for waitqueue_active without a comment.
6545cb426e99SJoe Perches		if ($line =~ /\bwaitqueue_active\s*\(/) {
6546cb426e99SJoe Perches			if (!ctx_has_comment($first_line, $linenr)) {
6547cb426e99SJoe Perches				WARN("WAITQUEUE_ACTIVE",
6548cb426e99SJoe Perches				     "waitqueue_active without comment\n" . $herecurr);
6549cb426e99SJoe Perches			}
6550cb426e99SJoe Perches		}
65513ad81779SPaul E. McKenney
65525099a722SMarco Elver# check for data_race without a comment.
65535099a722SMarco Elver		if ($line =~ /\bdata_race\s*\(/) {
65545099a722SMarco Elver			if (!ctx_has_comment($first_line, $linenr)) {
65555099a722SMarco Elver				WARN("DATA_RACE",
65565099a722SMarco Elver				     "data_race without comment\n" . $herecurr);
65575099a722SMarco Elver			}
65585099a722SMarco Elver		}
65595099a722SMarco Elver
65604a0df2efSAndy Whitcroft# check of hardware specific defines
6561c45dcabdSAndy Whitcroft		if ($line =~ m@^.\s*\#\s*if.*\b(__i386__|__powerpc64__|__sun__|__s390x__)\b@ && $realfile !~ m@include/asm-@) {
6562000d1cc1SJoe Perches			CHK("ARCH_DEFINES",
6563000d1cc1SJoe Perches			    "architecture specific defines should be avoided\n" .  $herecurr);
65640a920b5bSAndy Whitcroft		}
6565653d4876SAndy Whitcroft
6566596ed45bSJoe Perches# check that the storage class is not after a type
6567596ed45bSJoe Perches		if ($line =~ /\b($Type)\s+($Storage)\b/) {
6568000d1cc1SJoe Perches			WARN("STORAGE_CLASS",
6569596ed45bSJoe Perches			     "storage class '$2' should be located before type '$1'\n" . $herecurr);
6570596ed45bSJoe Perches		}
6571596ed45bSJoe Perches# Check that the storage class is at the beginning of a declaration
6572596ed45bSJoe Perches		if ($line =~ /\b$Storage\b/ &&
6573596ed45bSJoe Perches		    $line !~ /^.\s*$Storage/ &&
6574596ed45bSJoe Perches		    $line =~ /^.\s*(.+?)\$Storage\s/ &&
6575596ed45bSJoe Perches		    $1 !~ /[\,\)]\s*$/) {
6576596ed45bSJoe Perches			WARN("STORAGE_CLASS",
6577596ed45bSJoe Perches			     "storage class should be at the beginning of the declaration\n" . $herecurr);
6578d4977c78STobias Klauser		}
6579d4977c78STobias Klauser
6580de7d4f0eSAndy Whitcroft# check the location of the inline attribute, that it is between
6581de7d4f0eSAndy Whitcroft# storage class and type.
65829c0ca6f9SAndy Whitcroft		if ($line =~ /\b$Type\s+$Inline\b/ ||
65839c0ca6f9SAndy Whitcroft		    $line =~ /\b$Inline\s+$Storage\b/) {
6584000d1cc1SJoe Perches			ERROR("INLINE_LOCATION",
6585000d1cc1SJoe Perches			      "inline keyword should sit between storage class and type\n" . $herecurr);
6586de7d4f0eSAndy Whitcroft		}
6587de7d4f0eSAndy Whitcroft
65888905a67cSAndy Whitcroft# Check for __inline__ and __inline, prefer inline
65892b7ab453SJoe Perches		if ($realfile !~ m@\binclude/uapi/@ &&
65902b7ab453SJoe Perches		    $line =~ /\b(__inline__|__inline)\b/) {
6591d5e616fcSJoe Perches			if (WARN("INLINE",
6592d5e616fcSJoe Perches				 "plain inline is preferred over $1\n" . $herecurr) &&
6593d5e616fcSJoe Perches			    $fix) {
6594194f66fcSJoe Perches				$fixed[$fixlinenr] =~ s/\b(__inline__|__inline)\b/inline/;
6595d5e616fcSJoe Perches
6596d5e616fcSJoe Perches			}
65978905a67cSAndy Whitcroft		}
65988905a67cSAndy Whitcroft
65997ebe1d17SDwaipayan Ray# Check for compiler attributes
66002b7ab453SJoe Perches		if ($realfile !~ m@\binclude/uapi/@ &&
66017ebe1d17SDwaipayan Ray		    $rawline =~ /\b__attribute__\s*\(\s*($balanced_parens)\s*\)/) {
66027ebe1d17SDwaipayan Ray			my $attr = $1;
66037ebe1d17SDwaipayan Ray			$attr =~ s/\s*\(\s*(.*)\)\s*/$1/;
66047ebe1d17SDwaipayan Ray
66057ebe1d17SDwaipayan Ray			my %attr_list = (
66060830aab0SJoe Perches				"alias"				=> "__alias",
66077ebe1d17SDwaipayan Ray				"aligned"			=> "__aligned",
66087ebe1d17SDwaipayan Ray				"always_inline"			=> "__always_inline",
66097ebe1d17SDwaipayan Ray				"assume_aligned"		=> "__assume_aligned",
66107ebe1d17SDwaipayan Ray				"cold"				=> "__cold",
66117ebe1d17SDwaipayan Ray				"const"				=> "__attribute_const__",
66127ebe1d17SDwaipayan Ray				"copy"				=> "__copy",
66137ebe1d17SDwaipayan Ray				"designated_init"		=> "__designated_init",
66147ebe1d17SDwaipayan Ray				"externally_visible"		=> "__visible",
66157ebe1d17SDwaipayan Ray				"format"			=> "printf|scanf",
66167ebe1d17SDwaipayan Ray				"gnu_inline"			=> "__gnu_inline",
66177ebe1d17SDwaipayan Ray				"malloc"			=> "__malloc",
66187ebe1d17SDwaipayan Ray				"mode"				=> "__mode",
66197ebe1d17SDwaipayan Ray				"no_caller_saved_registers"	=> "__no_caller_saved_registers",
66207ebe1d17SDwaipayan Ray				"noclone"			=> "__noclone",
66217ebe1d17SDwaipayan Ray				"noinline"			=> "noinline",
66227ebe1d17SDwaipayan Ray				"nonstring"			=> "__nonstring",
66237ebe1d17SDwaipayan Ray				"noreturn"			=> "__noreturn",
66247ebe1d17SDwaipayan Ray				"packed"			=> "__packed",
66257ebe1d17SDwaipayan Ray				"pure"				=> "__pure",
6626339f29d9SJoe Perches				"section"			=> "__section",
66270830aab0SJoe Perches				"used"				=> "__used",
66280830aab0SJoe Perches				"weak"				=> "__weak"
66297ebe1d17SDwaipayan Ray			);
66307ebe1d17SDwaipayan Ray
66317ebe1d17SDwaipayan Ray			while ($attr =~ /\s*(\w+)\s*(${balanced_parens})?/g) {
6632339f29d9SJoe Perches				my $orig_attr = $1;
66337ebe1d17SDwaipayan Ray				my $params = '';
66347ebe1d17SDwaipayan Ray				$params = $2 if defined($2);
6635339f29d9SJoe Perches				my $curr_attr = $orig_attr;
66367ebe1d17SDwaipayan Ray				$curr_attr =~ s/^[\s_]+|[\s_]+$//g;
66377ebe1d17SDwaipayan Ray				if (exists($attr_list{$curr_attr})) {
6638339f29d9SJoe Perches					my $new = $attr_list{$curr_attr};
66397ebe1d17SDwaipayan Ray					if ($curr_attr eq "format" && $params) {
66407ebe1d17SDwaipayan Ray						$params =~ /^\s*\(\s*(\w+)\s*,\s*(.*)/;
6641339f29d9SJoe Perches						$new = "__$1\($2";
66427ebe1d17SDwaipayan Ray					} else {
6643339f29d9SJoe Perches						$new = "$new$params";
66447ebe1d17SDwaipayan Ray					}
66457ebe1d17SDwaipayan Ray					if (WARN("PREFER_DEFINED_ATTRIBUTE_MACRO",
6646339f29d9SJoe Perches						 "Prefer $new over __attribute__(($orig_attr$params))\n" . $herecurr) &&
66477ebe1d17SDwaipayan Ray					    $fix) {
6648339f29d9SJoe Perches						my $remove = "\Q$orig_attr\E" . '\s*' . "\Q$params\E" . '(?:\s*,\s*)?';
6649339f29d9SJoe Perches						$fixed[$fixlinenr] =~ s/$remove//;
6650339f29d9SJoe Perches						$fixed[$fixlinenr] =~ s/\b__attribute__/$new __attribute__/;
6651339f29d9SJoe Perches						$fixed[$fixlinenr] =~ s/\}\Q$new\E/} $new/;
6652339f29d9SJoe Perches						$fixed[$fixlinenr] =~ s/ __attribute__\s*\(\s*\(\s*\)\s*\)//;
66537ebe1d17SDwaipayan Ray					}
665439b7e287SJoe Perches				}
6655462811d9SJoe Perches			}
6656462811d9SJoe Perches
66577ebe1d17SDwaipayan Ray			# Check for __attribute__ unused, prefer __always_unused or __maybe_unused
66587ebe1d17SDwaipayan Ray			if ($attr =~ /^_*unused/) {
66597ebe1d17SDwaipayan Ray				WARN("PREFER_DEFINED_ATTRIBUTE_MACRO",
66607ebe1d17SDwaipayan Ray				     "__always_unused or __maybe_unused is preferred over __attribute__((__unused__))\n" . $herecurr);
6661d5e616fcSJoe Perches			}
66626061d949SJoe Perches		}
66636061d949SJoe Perches
6664619a908aSJoe Perches# Check for __attribute__ weak, or __weak declarations (may have link issues)
66655b57980dSJoe Perches		if ($perl_version_ok &&
6666619a908aSJoe Perches		    $line =~ /(?:$Declare|$DeclareMisordered)\s*$Ident\s*$balanced_parens\s*(?:$Attribute)?\s*;/ &&
6667619a908aSJoe Perches		    ($line =~ /\b__attribute__\s*\(\s*\(.*\bweak\b/ ||
6668619a908aSJoe Perches		     $line =~ /\b__weak\b/)) {
6669619a908aSJoe Perches			ERROR("WEAK_DECLARATION",
6670619a908aSJoe Perches			      "Using weak declarations can have unintended link defects\n" . $herecurr);
6671619a908aSJoe Perches		}
6672619a908aSJoe Perches
6673fd39f904STomas Winkler# check for c99 types like uint8_t used outside of uapi/ and tools/
6674e6176fa4SJoe Perches		if ($realfile !~ m@\binclude/uapi/@ &&
6675fd39f904STomas Winkler		    $realfile !~ m@\btools/@ &&
6676e6176fa4SJoe Perches		    $line =~ /\b($Declare)\s*$Ident\s*[=;,\[]/) {
6677e6176fa4SJoe Perches			my $type = $1;
6678e6176fa4SJoe Perches			if ($type =~ /\b($typeC99Typedefs)\b/) {
6679e6176fa4SJoe Perches				$type = $1;
6680e6176fa4SJoe Perches				my $kernel_type = 'u';
6681e6176fa4SJoe Perches				$kernel_type = 's' if ($type =~ /^_*[si]/);
6682e6176fa4SJoe Perches				$type =~ /(\d+)/;
6683e6176fa4SJoe Perches				$kernel_type .= $1;
6684e6176fa4SJoe Perches				if (CHK("PREFER_KERNEL_TYPES",
6685e6176fa4SJoe Perches					"Prefer kernel type '$kernel_type' over '$type'\n" . $herecurr) &&
6686e6176fa4SJoe Perches				    $fix) {
6687e6176fa4SJoe Perches					$fixed[$fixlinenr] =~ s/\b$type\b/$kernel_type/;
6688e6176fa4SJoe Perches				}
6689e6176fa4SJoe Perches			}
6690e6176fa4SJoe Perches		}
6691e6176fa4SJoe Perches
6692938224b5SJoe Perches# check for cast of C90 native int or longer types constants
6693938224b5SJoe Perches		if ($line =~ /(\(\s*$C90_int_types\s*\)\s*)($Constant)\b/) {
6694938224b5SJoe Perches			my $cast = $1;
6695938224b5SJoe Perches			my $const = $2;
6696938224b5SJoe Perches			my $suffix = "";
6697938224b5SJoe Perches			my $newconst = $const;
6698938224b5SJoe Perches			$newconst =~ s/${Int_type}$//;
6699938224b5SJoe Perches			$suffix .= 'U' if ($cast =~ /\bunsigned\b/);
6700938224b5SJoe Perches			if ($cast =~ /\blong\s+long\b/) {
6701938224b5SJoe Perches			    $suffix .= 'LL';
6702938224b5SJoe Perches			} elsif ($cast =~ /\blong\b/) {
6703938224b5SJoe Perches			    $suffix .= 'L';
6704938224b5SJoe Perches			}
67050972b8bfSJoe Perches			if (WARN("TYPECAST_INT_CONSTANT",
67060972b8bfSJoe Perches				 "Unnecessary typecast of c90 int constant - '$cast$const' could be '$const$suffix'\n" . $herecurr) &&
67070972b8bfSJoe Perches			    $fix) {
6708938224b5SJoe Perches				$fixed[$fixlinenr] =~ s/\Q$cast\E$const\b/$newconst$suffix/;
6709938224b5SJoe Perches			}
6710938224b5SJoe Perches		}
6711938224b5SJoe Perches
67128f53a9b8SJoe Perches# check for sizeof(&)
67138f53a9b8SJoe Perches		if ($line =~ /\bsizeof\s*\(\s*\&/) {
6714000d1cc1SJoe Perches			WARN("SIZEOF_ADDRESS",
6715000d1cc1SJoe Perches			     "sizeof(& should be avoided\n" . $herecurr);
67168f53a9b8SJoe Perches		}
67178f53a9b8SJoe Perches
671866c80b60SJoe Perches# check for sizeof without parenthesis
671966c80b60SJoe Perches		if ($line =~ /\bsizeof\s+((?:\*\s*|)$Lval|$Type(?:\s+$Lval|))/) {
6720d5e616fcSJoe Perches			if (WARN("SIZEOF_PARENTHESIS",
6721d5e616fcSJoe Perches				 "sizeof $1 should be sizeof($1)\n" . $herecurr) &&
6722d5e616fcSJoe Perches			    $fix) {
6723194f66fcSJoe Perches				$fixed[$fixlinenr] =~ s/\bsizeof\s+((?:\*\s*|)$Lval|$Type(?:\s+$Lval|))/"sizeof(" . trim($1) . ")"/ex;
6724d5e616fcSJoe Perches			}
672566c80b60SJoe Perches		}
672666c80b60SJoe Perches
672788982feaSJoe Perches# check for struct spinlock declarations
672888982feaSJoe Perches		if ($line =~ /^.\s*\bstruct\s+spinlock\s+\w+\s*;/) {
672988982feaSJoe Perches			WARN("USE_SPINLOCK_T",
673088982feaSJoe Perches			     "struct spinlock should be spinlock_t\n" . $herecurr);
673188982feaSJoe Perches		}
673288982feaSJoe Perches
6733a6962d72SJoe Perches# check for seq_printf uses that could be seq_puts
673406668727SJoe Perches		if ($sline =~ /\bseq_printf\s*\(.*"\s*\)\s*;\s*$/) {
6735a6962d72SJoe Perches			my $fmt = get_quoted_string($line, $rawline);
6736caac1d5fSHeba Aamer			$fmt =~ s/%%//g;
6737caac1d5fSHeba Aamer			if ($fmt !~ /%/) {
6738d5e616fcSJoe Perches				if (WARN("PREFER_SEQ_PUTS",
6739d5e616fcSJoe Perches					 "Prefer seq_puts to seq_printf\n" . $herecurr) &&
6740d5e616fcSJoe Perches				    $fix) {
6741194f66fcSJoe Perches					$fixed[$fixlinenr] =~ s/\bseq_printf\b/seq_puts/;
6742d5e616fcSJoe Perches				}
6743a6962d72SJoe Perches			}
6744a6962d72SJoe Perches		}
6745a6962d72SJoe Perches
67460b523769SJoe Perches# check for vsprintf extension %p<foo> misuses
67475b57980dSJoe Perches		if ($perl_version_ok &&
67480b523769SJoe Perches		    defined $stat &&
67490b523769SJoe Perches		    $stat =~ /^\+(?![^\{]*\{\s*).*\b(\w+)\s*\(.*$String\s*,/s &&
67500b523769SJoe Perches		    $1 !~ /^_*volatile_*$/) {
6751e3c6bc95STobin C. Harding			my $stat_real;
6752e3c6bc95STobin C. Harding
67530b523769SJoe Perches			my $lc = $stat =~ tr@\n@@;
67540b523769SJoe Perches			$lc = $lc + $linenr;
67550b523769SJoe Perches		        for (my $count = $linenr; $count <= $lc; $count++) {
6756ffe07513SJoe Perches				my $specifier;
6757ffe07513SJoe Perches				my $extension;
67583bd32d6aSSakari Ailus				my $qualifier;
6759ffe07513SJoe Perches				my $bad_specifier = "";
67600b523769SJoe Perches				my $fmt = get_quoted_string($lines[$count - 1], raw_line($count, 0));
67610b523769SJoe Perches				$fmt =~ s/%%//g;
6762e3c6bc95STobin C. Harding
67633bd32d6aSSakari Ailus				while ($fmt =~ /(\%[\*\d\.]*p(\w)(\w*))/g) {
6764e3c6bc95STobin C. Harding					$specifier = $1;
6765e3c6bc95STobin C. Harding					$extension = $2;
67663bd32d6aSSakari Ailus					$qualifier = $3;
6767af612e43SSakari Ailus					if ($extension !~ /[4SsBKRraEehMmIiUDdgVCbGNOxtf]/ ||
67683bd32d6aSSakari Ailus					    ($extension eq "f" &&
6769af612e43SSakari Ailus					     defined $qualifier && $qualifier !~ /^w/) ||
6770af612e43SSakari Ailus					    ($extension eq "4" &&
6771af612e43SSakari Ailus					     defined $qualifier && $qualifier !~ /^cc/)) {
6772e3c6bc95STobin C. Harding						$bad_specifier = $specifier;
67730b523769SJoe Perches						last;
67740b523769SJoe Perches					}
6775e3c6bc95STobin C. Harding					if ($extension eq "x" && !defined($stat_real)) {
6776e3c6bc95STobin C. Harding						if (!defined($stat_real)) {
6777e3c6bc95STobin C. Harding							$stat_real = get_stat_real($linenr, $lc);
67780b523769SJoe Perches						}
6779e3c6bc95STobin C. Harding						WARN("VSPRINTF_SPECIFIER_PX",
6780e3c6bc95STobin C. Harding						     "Using vsprintf specifier '\%px' potentially exposes the kernel memory layout, if you don't really need the address please consider using '\%p'.\n" . "$here\n$stat_real\n");
6781e3c6bc95STobin C. Harding					}
6782e3c6bc95STobin C. Harding				}
6783e3c6bc95STobin C. Harding				if ($bad_specifier ne "") {
67842a9f9d85STobin C. Harding					my $stat_real = get_stat_real($linenr, $lc);
67851df7338aSSergey Senozhatsky					my $ext_type = "Invalid";
67861df7338aSSergey Senozhatsky					my $use = "";
6787e3c6bc95STobin C. Harding					if ($bad_specifier =~ /p[Ff]/) {
67881df7338aSSergey Senozhatsky						$use = " - use %pS instead";
6789e3c6bc95STobin C. Harding						$use =~ s/pS/ps/ if ($bad_specifier =~ /pf/);
67901df7338aSSergey Senozhatsky					}
67912a9f9d85STobin C. Harding
67920b523769SJoe Perches					WARN("VSPRINTF_POINTER_EXTENSION",
6793e3c6bc95STobin C. Harding					     "$ext_type vsprintf pointer extension '$bad_specifier'$use\n" . "$here\n$stat_real\n");
6794e3c6bc95STobin C. Harding				}
67950b523769SJoe Perches			}
67960b523769SJoe Perches		}
67970b523769SJoe Perches
6798554e165cSAndy Whitcroft# Check for misused memsets
67995b57980dSJoe Perches		if ($perl_version_ok &&
6800d1fe9c09SJoe Perches		    defined $stat &&
68019e20a853SMateusz Kulikowski		    $stat =~ /^\+(?:.*?)\bmemset\s*\(\s*$FuncArg\s*,\s*$FuncArg\s*\,\s*$FuncArg\s*\)/) {
6802554e165cSAndy Whitcroft
6803d7c76ba7SJoe Perches			my $ms_addr = $2;
6804d1fe9c09SJoe Perches			my $ms_val = $7;
6805d1fe9c09SJoe Perches			my $ms_size = $12;
6806d7c76ba7SJoe Perches
6807554e165cSAndy Whitcroft			if ($ms_size =~ /^(0x|)0$/i) {
6808554e165cSAndy Whitcroft				ERROR("MEMSET",
6809d7c76ba7SJoe Perches				      "memset to 0's uses 0 as the 2nd argument, not the 3rd\n" . "$here\n$stat\n");
6810554e165cSAndy Whitcroft			} elsif ($ms_size =~ /^(0x|)1$/i) {
6811554e165cSAndy Whitcroft				WARN("MEMSET",
6812d7c76ba7SJoe Perches				     "single byte memset is suspicious. Swapped 2nd/3rd argument?\n" . "$here\n$stat\n");
6813d7c76ba7SJoe Perches			}
6814d7c76ba7SJoe Perches		}
6815d7c76ba7SJoe Perches
681698a9bba5SJoe Perches# Check for memcpy(foo, bar, ETH_ALEN) that could be ether_addr_copy(foo, bar)
68175b57980dSJoe Perches#		if ($perl_version_ok &&
6818f333195dSJoe Perches#		    defined $stat &&
6819f333195dSJoe Perches#		    $stat =~ /^\+(?:.*?)\bmemcpy\s*\(\s*$FuncArg\s*,\s*$FuncArg\s*\,\s*ETH_ALEN\s*\)/) {
6820f333195dSJoe Perches#			if (WARN("PREFER_ETHER_ADDR_COPY",
6821f333195dSJoe Perches#				 "Prefer ether_addr_copy() over memcpy() if the Ethernet addresses are __aligned(2)\n" . "$here\n$stat\n") &&
6822f333195dSJoe Perches#			    $fix) {
6823f333195dSJoe Perches#				$fixed[$fixlinenr] =~ s/\bmemcpy\s*\(\s*$FuncArg\s*,\s*$FuncArg\s*\,\s*ETH_ALEN\s*\)/ether_addr_copy($2, $7)/;
6824f333195dSJoe Perches#			}
6825f333195dSJoe Perches#		}
682698a9bba5SJoe Perches
6827b6117d17SMateusz Kulikowski# Check for memcmp(foo, bar, ETH_ALEN) that could be ether_addr_equal*(foo, bar)
68285b57980dSJoe Perches#		if ($perl_version_ok &&
6829f333195dSJoe Perches#		    defined $stat &&
6830f333195dSJoe Perches#		    $stat =~ /^\+(?:.*?)\bmemcmp\s*\(\s*$FuncArg\s*,\s*$FuncArg\s*\,\s*ETH_ALEN\s*\)/) {
6831f333195dSJoe Perches#			WARN("PREFER_ETHER_ADDR_EQUAL",
6832f333195dSJoe Perches#			     "Prefer ether_addr_equal() or ether_addr_equal_unaligned() over memcmp()\n" . "$here\n$stat\n")
6833f333195dSJoe Perches#		}
6834b6117d17SMateusz Kulikowski
68358617cd09SMateusz Kulikowski# check for memset(foo, 0x0, ETH_ALEN) that could be eth_zero_addr
68368617cd09SMateusz Kulikowski# check for memset(foo, 0xFF, ETH_ALEN) that could be eth_broadcast_addr
68375b57980dSJoe Perches#		if ($perl_version_ok &&
6838f333195dSJoe Perches#		    defined $stat &&
6839f333195dSJoe Perches#		    $stat =~ /^\+(?:.*?)\bmemset\s*\(\s*$FuncArg\s*,\s*$FuncArg\s*\,\s*ETH_ALEN\s*\)/) {
6840f333195dSJoe Perches#
6841f333195dSJoe Perches#			my $ms_val = $7;
6842f333195dSJoe Perches#
6843f333195dSJoe Perches#			if ($ms_val =~ /^(?:0x|)0+$/i) {
6844f333195dSJoe Perches#				if (WARN("PREFER_ETH_ZERO_ADDR",
6845f333195dSJoe Perches#					 "Prefer eth_zero_addr over memset()\n" . "$here\n$stat\n") &&
6846f333195dSJoe Perches#				    $fix) {
6847f333195dSJoe Perches#					$fixed[$fixlinenr] =~ s/\bmemset\s*\(\s*$FuncArg\s*,\s*$FuncArg\s*,\s*ETH_ALEN\s*\)/eth_zero_addr($2)/;
6848f333195dSJoe Perches#				}
6849f333195dSJoe Perches#			} elsif ($ms_val =~ /^(?:0xff|255)$/i) {
6850f333195dSJoe Perches#				if (WARN("PREFER_ETH_BROADCAST_ADDR",
6851f333195dSJoe Perches#					 "Prefer eth_broadcast_addr() over memset()\n" . "$here\n$stat\n") &&
6852f333195dSJoe Perches#				    $fix) {
6853f333195dSJoe Perches#					$fixed[$fixlinenr] =~ s/\bmemset\s*\(\s*$FuncArg\s*,\s*$FuncArg\s*,\s*ETH_ALEN\s*\)/eth_broadcast_addr($2)/;
6854f333195dSJoe Perches#				}
6855f333195dSJoe Perches#			}
6856f333195dSJoe Perches#		}
68578617cd09SMateusz Kulikowski
68585dbdb2d8SJoe Perches# strlcpy uses that should likely be strscpy
68595dbdb2d8SJoe Perches		if ($line =~ /\bstrlcpy\s*\(/) {
68605dbdb2d8SJoe Perches			WARN("STRLCPY",
68615dbdb2d8SJoe Perches			     "Prefer strscpy over strlcpy - see: https://lore.kernel.org/r/CAHk-=wgfRnXz0W3D37d01q3JFkr_i_uTL=V6A6G1oUZcprmknw\@mail.gmail.com/\n" . $herecurr);
68625dbdb2d8SJoe Perches		}
68635dbdb2d8SJoe Perches
6864d7c76ba7SJoe Perches# typecasts on min/max could be min_t/max_t
68655b57980dSJoe Perches		if ($perl_version_ok &&
6866d1fe9c09SJoe Perches		    defined $stat &&
6867d7c76ba7SJoe Perches		    $stat =~ /^\+(?:.*?)\b(min|max)\s*\(\s*$FuncArg\s*,\s*$FuncArg\s*\)/) {
6868d1fe9c09SJoe Perches			if (defined $2 || defined $7) {
6869d7c76ba7SJoe Perches				my $call = $1;
6870d7c76ba7SJoe Perches				my $cast1 = deparenthesize($2);
6871d7c76ba7SJoe Perches				my $arg1 = $3;
6872d1fe9c09SJoe Perches				my $cast2 = deparenthesize($7);
6873d1fe9c09SJoe Perches				my $arg2 = $8;
6874d7c76ba7SJoe Perches				my $cast;
6875d7c76ba7SJoe Perches
6876d1fe9c09SJoe Perches				if ($cast1 ne "" && $cast2 ne "" && $cast1 ne $cast2) {
6877d7c76ba7SJoe Perches					$cast = "$cast1 or $cast2";
6878d7c76ba7SJoe Perches				} elsif ($cast1 ne "") {
6879d7c76ba7SJoe Perches					$cast = $cast1;
6880d7c76ba7SJoe Perches				} else {
6881d7c76ba7SJoe Perches					$cast = $cast2;
6882d7c76ba7SJoe Perches				}
6883d7c76ba7SJoe Perches				WARN("MINMAX",
6884d7c76ba7SJoe Perches				     "$call() should probably be ${call}_t($cast, $arg1, $arg2)\n" . "$here\n$stat\n");
6885554e165cSAndy Whitcroft			}
6886554e165cSAndy Whitcroft		}
6887554e165cSAndy Whitcroft
68884a273195SJoe Perches# check usleep_range arguments
68895b57980dSJoe Perches		if ($perl_version_ok &&
68904a273195SJoe Perches		    defined $stat &&
68914a273195SJoe Perches		    $stat =~ /^\+(?:.*?)\busleep_range\s*\(\s*($FuncArg)\s*,\s*($FuncArg)\s*\)/) {
68924a273195SJoe Perches			my $min = $1;
68934a273195SJoe Perches			my $max = $7;
68944a273195SJoe Perches			if ($min eq $max) {
68954a273195SJoe Perches				WARN("USLEEP_RANGE",
6896458f69efSMauro Carvalho Chehab				     "usleep_range should not use min == max args; see Documentation/timers/timers-howto.rst\n" . "$here\n$stat\n");
68974a273195SJoe Perches			} elsif ($min =~ /^\d+$/ && $max =~ /^\d+$/ &&
68984a273195SJoe Perches				 $min > $max) {
68994a273195SJoe Perches				WARN("USLEEP_RANGE",
6900458f69efSMauro Carvalho Chehab				     "usleep_range args reversed, use min then max; see Documentation/timers/timers-howto.rst\n" . "$here\n$stat\n");
69014a273195SJoe Perches			}
69024a273195SJoe Perches		}
69034a273195SJoe Perches
6904823b794cSJoe Perches# check for naked sscanf
69055b57980dSJoe Perches		if ($perl_version_ok &&
6906823b794cSJoe Perches		    defined $stat &&
69076c8bd707SJoe Perches		    $line =~ /\bsscanf\b/ &&
6908823b794cSJoe Perches		    ($stat !~ /$Ident\s*=\s*sscanf\s*$balanced_parens/ &&
6909823b794cSJoe Perches		     $stat !~ /\bsscanf\s*$balanced_parens\s*(?:$Compare)/ &&
6910823b794cSJoe Perches		     $stat !~ /(?:$Compare)\s*\bsscanf\s*$balanced_parens/)) {
6911823b794cSJoe Perches			my $lc = $stat =~ tr@\n@@;
6912823b794cSJoe Perches			$lc = $lc + $linenr;
69132a9f9d85STobin C. Harding			my $stat_real = get_stat_real($linenr, $lc);
6914823b794cSJoe Perches			WARN("NAKED_SSCANF",
6915823b794cSJoe Perches			     "unchecked sscanf return value\n" . "$here\n$stat_real\n");
6916823b794cSJoe Perches		}
6917823b794cSJoe Perches
6918afc819abSJoe Perches# check for simple sscanf that should be kstrto<foo>
69195b57980dSJoe Perches		if ($perl_version_ok &&
6920afc819abSJoe Perches		    defined $stat &&
6921afc819abSJoe Perches		    $line =~ /\bsscanf\b/) {
6922afc819abSJoe Perches			my $lc = $stat =~ tr@\n@@;
6923afc819abSJoe Perches			$lc = $lc + $linenr;
69242a9f9d85STobin C. Harding			my $stat_real = get_stat_real($linenr, $lc);
6925afc819abSJoe Perches			if ($stat_real =~ /\bsscanf\b\s*\(\s*$FuncArg\s*,\s*("[^"]+")/) {
6926afc819abSJoe Perches				my $format = $6;
6927afc819abSJoe Perches				my $count = $format =~ tr@%@%@;
6928afc819abSJoe Perches				if ($count == 1 &&
6929afc819abSJoe Perches				    $format =~ /^"\%(?i:ll[udxi]|[udxi]ll|ll|[hl]h?[udxi]|[udxi][hl]h?|[hl]h?|[udxi])"$/) {
6930afc819abSJoe Perches					WARN("SSCANF_TO_KSTRTO",
6931afc819abSJoe Perches					     "Prefer kstrto<type> to single variable sscanf\n" . "$here\n$stat_real\n");
6932afc819abSJoe Perches				}
6933afc819abSJoe Perches			}
6934afc819abSJoe Perches		}
6935afc819abSJoe Perches
693670dc8a48SJoe Perches# check for new externs in .h files.
693770dc8a48SJoe Perches		if ($realfile =~ /\.h$/ &&
693870dc8a48SJoe Perches		    $line =~ /^\+\s*(extern\s+)$Type\s*$Ident\s*\(/s) {
6939d1d85780SJoe Perches			if (CHK("AVOID_EXTERNS",
694070dc8a48SJoe Perches				"extern prototypes should be avoided in .h files\n" . $herecurr) &&
694170dc8a48SJoe Perches			    $fix) {
6942194f66fcSJoe Perches				$fixed[$fixlinenr] =~ s/(.*)\bextern\b\s*(.*)/$1$2/;
694370dc8a48SJoe Perches			}
694470dc8a48SJoe Perches		}
694570dc8a48SJoe Perches
6946de7d4f0eSAndy Whitcroft# check for new externs in .c files.
6947171ae1a4SAndy Whitcroft		if ($realfile =~ /\.c$/ && defined $stat &&
6948c45dcabdSAndy Whitcroft		    $stat =~ /^.\s*(?:extern\s+)?$Type\s+($Ident)(\s*)\(/s)
6949171ae1a4SAndy Whitcroft		{
6950c45dcabdSAndy Whitcroft			my $function_name = $1;
6951c45dcabdSAndy Whitcroft			my $paren_space = $2;
6952171ae1a4SAndy Whitcroft
6953171ae1a4SAndy Whitcroft			my $s = $stat;
6954171ae1a4SAndy Whitcroft			if (defined $cond) {
6955171ae1a4SAndy Whitcroft				substr($s, 0, length($cond), '');
6956171ae1a4SAndy Whitcroft			}
6957d8b44b58SKees Cook			if ($s =~ /^\s*;/)
6958c45dcabdSAndy Whitcroft			{
6959000d1cc1SJoe Perches				WARN("AVOID_EXTERNS",
6960000d1cc1SJoe Perches				     "externs should be avoided in .c files\n" .  $herecurr);
6961de7d4f0eSAndy Whitcroft			}
6962de7d4f0eSAndy Whitcroft
6963171ae1a4SAndy Whitcroft			if ($paren_space =~ /\n/) {
6964000d1cc1SJoe Perches				WARN("FUNCTION_ARGUMENTS",
6965000d1cc1SJoe Perches				     "arguments for function declarations should follow identifier\n" . $herecurr);
6966171ae1a4SAndy Whitcroft			}
69679c9ba34eSAndy Whitcroft
69689c9ba34eSAndy Whitcroft		} elsif ($realfile =~ /\.c$/ && defined $stat &&
69699c9ba34eSAndy Whitcroft		    $stat =~ /^.\s*extern\s+/)
69709c9ba34eSAndy Whitcroft		{
6971000d1cc1SJoe Perches			WARN("AVOID_EXTERNS",
6972000d1cc1SJoe Perches			     "externs should be avoided in .c files\n" .  $herecurr);
6973171ae1a4SAndy Whitcroft		}
6974171ae1a4SAndy Whitcroft
6975a0ad7596SJoe Perches# check for function declarations that have arguments without identifier names
6976a0ad7596SJoe Perches		if (defined $stat &&
6977d8b44b58SKees Cook		    $stat =~ /^.\s*(?:extern\s+)?$Type\s*(?:$Ident|\(\s*\*\s*$Ident\s*\))\s*\(\s*([^{]+)\s*\)\s*;/s &&
6978d8b44b58SKees Cook		    $1 ne "void") {
6979d8b44b58SKees Cook			my $args = trim($1);
6980ca0d8929SJoe Perches			while ($args =~ m/\s*($Type\s*(?:$Ident|\(\s*\*\s*$Ident?\s*\)\s*$balanced_parens)?)/g) {
6981ca0d8929SJoe Perches				my $arg = trim($1);
6982d8b44b58SKees Cook				if ($arg =~ /^$Type$/ && $arg !~ /enum\s+$Ident$/) {
6983ca0d8929SJoe Perches					WARN("FUNCTION_ARGUMENTS",
6984ca0d8929SJoe Perches					     "function definition argument '$arg' should also have an identifier name\n" . $herecurr);
6985ca0d8929SJoe Perches				}
6986ca0d8929SJoe Perches			}
6987ca0d8929SJoe Perches		}
6988ca0d8929SJoe Perches
6989a0ad7596SJoe Perches# check for function definitions
69905b57980dSJoe Perches		if ($perl_version_ok &&
6991a0ad7596SJoe Perches		    defined $stat &&
6992a0ad7596SJoe Perches		    $stat =~ /^.\s*(?:$Storage\s+)?$Type\s*($Ident)\s*$balanced_parens\s*{/s) {
6993a0ad7596SJoe Perches			$context_function = $1;
6994a0ad7596SJoe Perches
6995a0ad7596SJoe Perches# check for multiline function definition with misplaced open brace
6996a0ad7596SJoe Perches			my $ok = 0;
6997a0ad7596SJoe Perches			my $cnt = statement_rawlines($stat);
6998a0ad7596SJoe Perches			my $herectx = $here . "\n";
6999a0ad7596SJoe Perches			for (my $n = 0; $n < $cnt; $n++) {
7000a0ad7596SJoe Perches				my $rl = raw_line($linenr, $n);
7001a0ad7596SJoe Perches				$herectx .=  $rl . "\n";
7002a0ad7596SJoe Perches				$ok = 1 if ($rl =~ /^[ \+]\{/);
7003a0ad7596SJoe Perches				$ok = 1 if ($rl =~ /\{/ && $n == 0);
7004a0ad7596SJoe Perches				last if $rl =~ /^[ \+].*\{/;
7005a0ad7596SJoe Perches			}
7006a0ad7596SJoe Perches			if (!$ok) {
7007a0ad7596SJoe Perches				ERROR("OPEN_BRACE",
7008a0ad7596SJoe Perches				      "open brace '{' following function definitions go on the next line\n" . $herectx);
7009a0ad7596SJoe Perches			}
7010a0ad7596SJoe Perches		}
7011a0ad7596SJoe Perches
7012de7d4f0eSAndy Whitcroft# checks for new __setup's
7013de7d4f0eSAndy Whitcroft		if ($rawline =~ /\b__setup\("([^"]*)"/) {
7014de7d4f0eSAndy Whitcroft			my $name = $1;
7015de7d4f0eSAndy Whitcroft
7016de7d4f0eSAndy Whitcroft			if (!grep(/$name/, @setup_docs)) {
7017000d1cc1SJoe Perches				CHK("UNDOCUMENTED_SETUP",
70182581ac7cSTim Froidcoeur				    "__setup appears un-documented -- check Documentation/admin-guide/kernel-parameters.txt\n" . $herecurr);
7019de7d4f0eSAndy Whitcroft			}
7020653d4876SAndy Whitcroft		}
70219c0ca6f9SAndy Whitcroft
7022e29a70f1SJoe Perches# check for pointless casting of alloc functions
7023e29a70f1SJoe Perches		if ($line =~ /\*\s*\)\s*$allocFunctions\b/) {
7024000d1cc1SJoe Perches			WARN("UNNECESSARY_CASTS",
7025000d1cc1SJoe Perches			     "unnecessary cast may hide bugs, see http://c-faq.com/malloc/mallocnocast.html\n" . $herecurr);
70269c0ca6f9SAndy Whitcroft		}
702713214adfSAndy Whitcroft
7028a640d25cSJoe Perches# alloc style
7029a640d25cSJoe Perches# p = alloc(sizeof(struct foo), ...) should be p = alloc(sizeof(*p), ...)
70305b57980dSJoe Perches		if ($perl_version_ok &&
7031e29a70f1SJoe Perches		    $line =~ /\b($Lval)\s*\=\s*(?:$balanced_parens)?\s*((?:kv|k|v)[mz]alloc(?:_node)?)\s*\(\s*(sizeof\s*\(\s*struct\s+$Lval\s*\))/) {
7032a640d25cSJoe Perches			CHK("ALLOC_SIZEOF_STRUCT",
7033a640d25cSJoe Perches			    "Prefer $3(sizeof(*$1)...) over $3($4...)\n" . $herecurr);
7034a640d25cSJoe Perches		}
7035a640d25cSJoe Perches
703660a55369SJoe Perches# check for k[mz]alloc with multiplies that could be kmalloc_array/kcalloc
70375b57980dSJoe Perches		if ($perl_version_ok &&
70381b4a2ed4SJoe Perches		    defined $stat &&
70391b4a2ed4SJoe Perches		    $stat =~ /^\+\s*($Lval)\s*\=\s*(?:$balanced_parens)?\s*(k[mz]alloc)\s*\(\s*($FuncArg)\s*\*\s*($FuncArg)\s*,/) {
704060a55369SJoe Perches			my $oldfunc = $3;
704160a55369SJoe Perches			my $a1 = $4;
704260a55369SJoe Perches			my $a2 = $10;
704360a55369SJoe Perches			my $newfunc = "kmalloc_array";
704460a55369SJoe Perches			$newfunc = "kcalloc" if ($oldfunc eq "kzalloc");
704560a55369SJoe Perches			my $r1 = $a1;
704660a55369SJoe Perches			my $r2 = $a2;
704760a55369SJoe Perches			if ($a1 =~ /^sizeof\s*\S/) {
704860a55369SJoe Perches				$r1 = $a2;
704960a55369SJoe Perches				$r2 = $a1;
705060a55369SJoe Perches			}
7051e367455aSJoe Perches			if ($r1 !~ /^sizeof\b/ && $r2 =~ /^sizeof\s*\S/ &&
7052e367455aSJoe Perches			    !($r1 =~ /^$Constant$/ || $r1 =~ /^[A-Z_][A-Z0-9_]*$/)) {
70531b4a2ed4SJoe Perches				my $cnt = statement_rawlines($stat);
7054e3d95a2aSTobin C. Harding				my $herectx = get_stat_here($linenr, $cnt, $here);
7055e3d95a2aSTobin C. Harding
7056e367455aSJoe Perches				if (WARN("ALLOC_WITH_MULTIPLY",
70571b4a2ed4SJoe Perches					 "Prefer $newfunc over $oldfunc with multiply\n" . $herectx) &&
70581b4a2ed4SJoe Perches				    $cnt == 1 &&
7059e367455aSJoe Perches				    $fix) {
7060194f66fcSJoe Perches					$fixed[$fixlinenr] =~ s/\b($Lval)\s*\=\s*(?:$balanced_parens)?\s*(k[mz]alloc)\s*\(\s*($FuncArg)\s*\*\s*($FuncArg)/$1 . ' = ' . "$newfunc(" . trim($r1) . ', ' . trim($r2)/e;
706160a55369SJoe Perches				}
706260a55369SJoe Perches			}
706360a55369SJoe Perches		}
706460a55369SJoe Perches
7065972fdea2SJoe Perches# check for krealloc arg reuse
70665b57980dSJoe Perches		if ($perl_version_ok &&
70674cab63ceSJoe Perches		    $line =~ /\b($Lval)\s*\=\s*(?:$balanced_parens)?\s*krealloc\s*\(\s*($Lval)\s*,/ &&
70684cab63ceSJoe Perches		    $1 eq $3) {
7069972fdea2SJoe Perches			WARN("KREALLOC_ARG_REUSE",
7070972fdea2SJoe Perches			     "Reusing the krealloc arg is almost always a bug\n" . $herecurr);
7071972fdea2SJoe Perches		}
7072972fdea2SJoe Perches
70735ce59ae0SJoe Perches# check for alloc argument mismatch
70747e6cdd7fSChristophe JAILLET		if ($line =~ /\b((?:devm_)?(?:kcalloc|kmalloc_array))\s*\(\s*sizeof\b/) {
70755ce59ae0SJoe Perches			WARN("ALLOC_ARRAY_ARGS",
70765ce59ae0SJoe Perches			     "$1 uses number as first arg, sizeof is generally wrong\n" . $herecurr);
70775ce59ae0SJoe Perches		}
70785ce59ae0SJoe Perches
7079caf2a54fSJoe Perches# check for multiple semicolons
7080caf2a54fSJoe Perches		if ($line =~ /;\s*;\s*$/) {
7081d5e616fcSJoe Perches			if (WARN("ONE_SEMICOLON",
7082d5e616fcSJoe Perches				 "Statements terminations use 1 semicolon\n" . $herecurr) &&
7083d5e616fcSJoe Perches			    $fix) {
7084194f66fcSJoe Perches				$fixed[$fixlinenr] =~ s/(\s*;\s*){2,}$/;/g;
7085d5e616fcSJoe Perches			}
7086d1e2ad07SJoe Perches		}
7087d1e2ad07SJoe Perches
7088cec3aaa5STomas Winkler# check for #defines like: 1 << <digit> that could be BIT(digit), it is not exported to uapi
7089cec3aaa5STomas Winkler		if ($realfile !~ m@^include/uapi/@ &&
7090cec3aaa5STomas Winkler		    $line =~ /#\s*define\s+\w+\s+\(?\s*1\s*([ulUL]*)\s*\<\<\s*(?:\d+|$Ident)\s*\)?/) {
70910ab90191SJoe Perches			my $ull = "";
70920ab90191SJoe Perches			$ull = "_ULL" if (defined($1) && $1 =~ /ll/i);
70930ab90191SJoe Perches			if (CHK("BIT_MACRO",
70940ab90191SJoe Perches				"Prefer using the BIT$ull macro\n" . $herecurr) &&
70950ab90191SJoe Perches			    $fix) {
70960ab90191SJoe Perches				$fixed[$fixlinenr] =~ s/\(?\s*1\s*[ulUL]*\s*<<\s*(\d+|$Ident)\s*\)?/BIT${ull}($1)/;
70970ab90191SJoe Perches			}
70980ab90191SJoe Perches		}
70990ab90191SJoe Perches
710050161266SJoe Perches# check for IS_ENABLED() without CONFIG_<FOO> ($rawline for comments too)
71013e89ad85SJerome Forissier		if ($rawline =~ /\bIS_ENABLED\s*\(\s*(\w+)\s*\)/ && $1 !~ /^${CONFIG_}/) {
710250161266SJoe Perches			WARN("IS_ENABLED_CONFIG",
71033e89ad85SJerome Forissier			     "IS_ENABLED($1) is normally used as IS_ENABLED(${CONFIG_}$1)\n" . $herecurr);
710450161266SJoe Perches		}
710550161266SJoe Perches
71062d632745SJoe Perches# check for #if defined CONFIG_<FOO> || defined CONFIG_<FOO>_MODULE
71073e89ad85SJerome Forissier		if ($line =~ /^\+\s*#\s*if\s+defined(?:\s*\(?\s*|\s+)(${CONFIG_}[A-Z_]+)\s*\)?\s*\|\|\s*defined(?:\s*\(?\s*|\s+)\1_MODULE\s*\)?\s*$/) {
71082d632745SJoe Perches			my $config = $1;
71092d632745SJoe Perches			if (WARN("PREFER_IS_ENABLED",
71103e89ad85SJerome Forissier				 "Prefer IS_ENABLED(<FOO>) to ${CONFIG_}<FOO> || ${CONFIG_}<FOO>_MODULE\n" . $herecurr) &&
71112d632745SJoe Perches			    $fix) {
71122d632745SJoe Perches				$fixed[$fixlinenr] = "\+#if IS_ENABLED($config)";
71132d632745SJoe Perches			}
71142d632745SJoe Perches		}
71152d632745SJoe Perches
7116f36d3eb8SJoe Perches# check for /* fallthrough */ like comment, prefer fallthrough;
7117f36d3eb8SJoe Perches		my @fallthroughs = (
7118f36d3eb8SJoe Perches			'fallthrough',
7119f36d3eb8SJoe Perches			'@fallthrough@',
7120f36d3eb8SJoe Perches			'lint -fallthrough[ \t]*',
7121f36d3eb8SJoe Perches			'intentional(?:ly)?[ \t]*fall(?:(?:s | |-)[Tt]|t)hr(?:ough|u|ew)',
7122f36d3eb8SJoe Perches			'(?:else,?\s*)?FALL(?:S | |-)?THR(?:OUGH|U|EW)[ \t.!]*(?:-[^\n\r]*)?',
7123f36d3eb8SJoe Perches			'Fall(?:(?:s | |-)[Tt]|t)hr(?:ough|u|ew)[ \t.!]*(?:-[^\n\r]*)?',
7124f36d3eb8SJoe Perches			'fall(?:s | |-)?thr(?:ough|u|ew)[ \t.!]*(?:-[^\n\r]*)?',
7125f36d3eb8SJoe Perches		    );
7126f36d3eb8SJoe Perches		if ($raw_comment ne '') {
7127f36d3eb8SJoe Perches			foreach my $ft (@fallthroughs) {
7128f36d3eb8SJoe Perches				if ($raw_comment =~ /$ft/) {
7129f36d3eb8SJoe Perches					my $msg_level = \&WARN;
7130f36d3eb8SJoe Perches					$msg_level = \&CHK if ($file);
7131f36d3eb8SJoe Perches					&{$msg_level}("PREFER_FALLTHROUGH",
7132f36d3eb8SJoe Perches						      "Prefer 'fallthrough;' over fallthrough comment\n" . $herecurr);
7133f36d3eb8SJoe Perches					last;
7134f36d3eb8SJoe Perches				}
7135f36d3eb8SJoe Perches			}
7136f36d3eb8SJoe Perches		}
7137f36d3eb8SJoe Perches
7138d1e2ad07SJoe Perches# check for switch/default statements without a break;
71395b57980dSJoe Perches		if ($perl_version_ok &&
7140d1e2ad07SJoe Perches		    defined $stat &&
7141d1e2ad07SJoe Perches		    $stat =~ /^\+[$;\s]*(?:case[$;\s]+\w+[$;\s]*:[$;\s]*|)*[$;\s]*\bdefault[$;\s]*:[$;\s]*;/g) {
7142d1e2ad07SJoe Perches			my $cnt = statement_rawlines($stat);
7143e3d95a2aSTobin C. Harding			my $herectx = get_stat_here($linenr, $cnt, $here);
7144e3d95a2aSTobin C. Harding
7145d1e2ad07SJoe Perches			WARN("DEFAULT_NO_BREAK",
7146d1e2ad07SJoe Perches			     "switch default: should use break\n" . $herectx);
7147caf2a54fSJoe Perches		}
7148caf2a54fSJoe Perches
714913214adfSAndy Whitcroft# check for gcc specific __FUNCTION__
7150d5e616fcSJoe Perches		if ($line =~ /\b__FUNCTION__\b/) {
7151d5e616fcSJoe Perches			if (WARN("USE_FUNC",
7152d5e616fcSJoe Perches				 "__func__ should be used instead of gcc specific __FUNCTION__\n"  . $herecurr) &&
7153d5e616fcSJoe Perches			    $fix) {
7154194f66fcSJoe Perches				$fixed[$fixlinenr] =~ s/\b__FUNCTION__\b/__func__/g;
7155d5e616fcSJoe Perches			}
715613214adfSAndy Whitcroft		}
7157773647a0SAndy Whitcroft
715862ec818fSJoe Perches# check for uses of __DATE__, __TIME__, __TIMESTAMP__
715962ec818fSJoe Perches		while ($line =~ /\b(__(?:DATE|TIME|TIMESTAMP)__)\b/g) {
716062ec818fSJoe Perches			ERROR("DATE_TIME",
716162ec818fSJoe Perches			      "Use of the '$1' macro makes the build non-deterministic\n" . $herecurr);
716262ec818fSJoe Perches		}
716362ec818fSJoe Perches
71642c92488aSJoe Perches# check for use of yield()
71652c92488aSJoe Perches		if ($line =~ /\byield\s*\(\s*\)/) {
71662c92488aSJoe Perches			WARN("YIELD",
71672c92488aSJoe Perches			     "Using yield() is generally wrong. See yield() kernel-doc (sched/core.c)\n"  . $herecurr);
71682c92488aSJoe Perches		}
71692c92488aSJoe Perches
7170179f8f40SJoe Perches# check for comparisons against true and false
7171179f8f40SJoe Perches		if ($line =~ /\+\s*(.*?)\b(true|false|$Lval)\s*(==|\!=)\s*(true|false|$Lval)\b(.*)$/i) {
7172179f8f40SJoe Perches			my $lead = $1;
7173179f8f40SJoe Perches			my $arg = $2;
7174179f8f40SJoe Perches			my $test = $3;
7175179f8f40SJoe Perches			my $otype = $4;
7176179f8f40SJoe Perches			my $trail = $5;
7177179f8f40SJoe Perches			my $op = "!";
7178179f8f40SJoe Perches
7179179f8f40SJoe Perches			($arg, $otype) = ($otype, $arg) if ($arg =~ /^(?:true|false)$/i);
7180179f8f40SJoe Perches
7181179f8f40SJoe Perches			my $type = lc($otype);
7182179f8f40SJoe Perches			if ($type =~ /^(?:true|false)$/) {
7183179f8f40SJoe Perches				if (("$test" eq "==" && "$type" eq "true") ||
7184179f8f40SJoe Perches				    ("$test" eq "!=" && "$type" eq "false")) {
7185179f8f40SJoe Perches					$op = "";
7186179f8f40SJoe Perches				}
7187179f8f40SJoe Perches
7188179f8f40SJoe Perches				CHK("BOOL_COMPARISON",
7189179f8f40SJoe Perches				    "Using comparison to $otype is error prone\n" . $herecurr);
7190179f8f40SJoe Perches
7191179f8f40SJoe Perches## maybe suggesting a correct construct would better
7192179f8f40SJoe Perches##				    "Using comparison to $otype is error prone.  Perhaps use '${lead}${op}${arg}${trail}'\n" . $herecurr);
7193179f8f40SJoe Perches
7194179f8f40SJoe Perches			}
7195179f8f40SJoe Perches		}
7196179f8f40SJoe Perches
71974882720bSThomas Gleixner# check for semaphores initialized locked
71984882720bSThomas Gleixner		if ($line =~ /^.\s*sema_init.+,\W?0\W?\)/) {
7199000d1cc1SJoe Perches			WARN("CONSIDER_COMPLETION",
7200000d1cc1SJoe Perches			     "consider using a completion\n" . $herecurr);
7201773647a0SAndy Whitcroft		}
72026712d858SJoe Perches
720367d0a075SJoe Perches# recommend kstrto* over simple_strto* and strict_strto*
720467d0a075SJoe Perches		if ($line =~ /\b((simple|strict)_(strto(l|ll|ul|ull)))\s*\(/) {
7205000d1cc1SJoe Perches			WARN("CONSIDER_KSTRTO",
720667d0a075SJoe Perches			     "$1 is obsolete, use k$3 instead\n" . $herecurr);
7207773647a0SAndy Whitcroft		}
72086712d858SJoe Perches
7209ae3ccc46SFabian Frederick# check for __initcall(), use device_initcall() explicitly or more appropriate function please
7210f3db6639SMichael Ellerman		if ($line =~ /^.\s*__initcall\s*\(/) {
7211000d1cc1SJoe Perches			WARN("USE_DEVICE_INITCALL",
7212ae3ccc46SFabian Frederick			     "please use device_initcall() or more appropriate function instead of __initcall() (see include/linux/init.h)\n" . $herecurr);
7213f3db6639SMichael Ellerman		}
72146712d858SJoe Perches
72153d709ab5SPaul E. McKenney# check for spin_is_locked(), suggest lockdep instead
72163d709ab5SPaul E. McKenney		if ($line =~ /\bspin_is_locked\(/) {
72173d709ab5SPaul E. McKenney			WARN("USE_LOCKDEP",
72183d709ab5SPaul E. McKenney			     "Where possible, use lockdep_assert_held instead of assertions based on spin_is_locked\n" . $herecurr);
72193d709ab5SPaul E. McKenney		}
72203d709ab5SPaul E. McKenney
72219189c7e7SJoe Perches# check for deprecated apis
72229189c7e7SJoe Perches		if ($line =~ /\b($deprecated_apis_search)\b\s*\(/) {
72239189c7e7SJoe Perches			my $deprecated_api = $1;
72249189c7e7SJoe Perches			my $new_api = $deprecated_apis{$deprecated_api};
72259189c7e7SJoe Perches			WARN("DEPRECATED_API",
72269189c7e7SJoe Perches			     "Deprecated use of '$deprecated_api', prefer '$new_api' instead\n" . $herecurr);
72279189c7e7SJoe Perches		}
72289189c7e7SJoe Perches
72290f3c5aabSJoe Perches# check for various structs that are normally const (ops, kgdb, device_tree)
7230d9190e4eSJoe Perches# and avoid what seem like struct definitions 'struct foo {'
7231ced69da1SQuentin Monnet		if (defined($const_structs) &&
7232ced69da1SQuentin Monnet		    $line !~ /\bconst\b/ &&
7233d9190e4eSJoe Perches		    $line =~ /\bstruct\s+($const_structs)\b(?!\s*\{)/) {
7234000d1cc1SJoe Perches			WARN("CONST_STRUCT",
7235d9190e4eSJoe Perches			     "struct $1 should normally be const\n" . $herecurr);
72362b6db5cbSAndy Whitcroft		}
7237773647a0SAndy Whitcroft
7238773647a0SAndy Whitcroft# use of NR_CPUS is usually wrong
7239773647a0SAndy Whitcroft# ignore definitions of NR_CPUS and usage to define arrays as likely right
724035cdcbfcSPeng Wang# ignore designated initializers using NR_CPUS
7241773647a0SAndy Whitcroft		if ($line =~ /\bNR_CPUS\b/ &&
7242c45dcabdSAndy Whitcroft		    $line !~ /^.\s*\s*#\s*if\b.*\bNR_CPUS\b/ &&
7243c45dcabdSAndy Whitcroft		    $line !~ /^.\s*\s*#\s*define\b.*\bNR_CPUS\b/ &&
7244171ae1a4SAndy Whitcroft		    $line !~ /^.\s*$Declare\s.*\[[^\]]*NR_CPUS[^\]]*\]/ &&
7245171ae1a4SAndy Whitcroft		    $line !~ /\[[^\]]*\.\.\.[^\]]*NR_CPUS[^\]]*\]/ &&
724635cdcbfcSPeng Wang		    $line !~ /\[[^\]]*NR_CPUS[^\]]*\.\.\.[^\]]*\]/ &&
724735cdcbfcSPeng Wang		    $line !~ /^.\s*\.\w+\s*=\s*.*\bNR_CPUS\b/)
7248773647a0SAndy Whitcroft		{
7249000d1cc1SJoe Perches			WARN("NR_CPUS",
7250000d1cc1SJoe Perches			     "usage of NR_CPUS is often wrong - consider using cpu_possible(), num_possible_cpus(), for_each_possible_cpu(), etc\n" . $herecurr);
7251773647a0SAndy Whitcroft		}
72529c9ba34eSAndy Whitcroft
725352ea8506SJoe Perches# Use of __ARCH_HAS_<FOO> or ARCH_HAVE_<BAR> is wrong.
725452ea8506SJoe Perches		if ($line =~ /\+\s*#\s*define\s+((?:__)?ARCH_(?:HAS|HAVE)\w*)\b/) {
725552ea8506SJoe Perches			ERROR("DEFINE_ARCH_HAS",
725652ea8506SJoe Perches			      "#define of '$1' is wrong - use Kconfig variables or standard guards instead\n" . $herecurr);
725752ea8506SJoe Perches		}
725852ea8506SJoe Perches
7259acd9362cSJoe Perches# likely/unlikely comparisons similar to "(likely(foo) > 0)"
72605b57980dSJoe Perches		if ($perl_version_ok &&
7261acd9362cSJoe Perches		    $line =~ /\b((?:un)?likely)\s*\(\s*$FuncArg\s*\)\s*$Compare/) {
7262acd9362cSJoe Perches			WARN("LIKELY_MISUSE",
7263acd9362cSJoe Perches			     "Using $1 should generally have parentheses around the comparison\n" . $herecurr);
7264acd9362cSJoe Perches		}
7265acd9362cSJoe Perches
7266fbe74541SJoe Perches# return sysfs_emit(foo, fmt, ...) fmt without newline
7267fbe74541SJoe Perches		if ($line =~ /\breturn\s+sysfs_emit\s*\(\s*$FuncArg\s*,\s*($String)/ &&
7268fbe74541SJoe Perches		    substr($rawline, $-[6], $+[6] - $-[6]) !~ /\\n"$/) {
7269fbe74541SJoe Perches			my $offset = $+[6] - 1;
7270fbe74541SJoe Perches			if (WARN("SYSFS_EMIT",
7271fbe74541SJoe Perches				 "return sysfs_emit(...) formats should include a terminating newline\n" . $herecurr) &&
7272fbe74541SJoe Perches			    $fix) {
7273fbe74541SJoe Perches				substr($fixed[$fixlinenr], $offset, 0) = '\\n';
7274fbe74541SJoe Perches			}
7275fbe74541SJoe Perches		}
7276fbe74541SJoe Perches
7277de3f186fSDenis Efremov# nested likely/unlikely calls
7278de3f186fSDenis Efremov		if ($line =~ /\b(?:(?:un)?likely)\s*\(\s*!?\s*(IS_ERR(?:_OR_NULL|_VALUE)?|WARN)/) {
7279de3f186fSDenis Efremov			WARN("LIKELY_MISUSE",
7280de3f186fSDenis Efremov			     "nested (un)?likely() calls, $1 already uses unlikely() internally\n" . $herecurr);
7281de3f186fSDenis Efremov		}
7282de3f186fSDenis Efremov
7283691d77b6SAndy Whitcroft# whine mightly about in_atomic
7284691d77b6SAndy Whitcroft		if ($line =~ /\bin_atomic\s*\(/) {
7285691d77b6SAndy Whitcroft			if ($realfile =~ m@^drivers/@) {
7286000d1cc1SJoe Perches				ERROR("IN_ATOMIC",
7287000d1cc1SJoe Perches				      "do not use in_atomic in drivers\n" . $herecurr);
7288f4a87736SAndy Whitcroft			} elsif ($realfile !~ m@^kernel/@) {
7289000d1cc1SJoe Perches				WARN("IN_ATOMIC",
7290000d1cc1SJoe Perches				     "use of in_atomic() is incorrect outside core kernel code\n" . $herecurr);
7291691d77b6SAndy Whitcroft			}
7292691d77b6SAndy Whitcroft		}
72931704f47bSPeter Zijlstra
72941704f47bSPeter Zijlstra# check for lockdep_set_novalidate_class
72951704f47bSPeter Zijlstra		if ($line =~ /^.\s*lockdep_set_novalidate_class\s*\(/ ||
72961704f47bSPeter Zijlstra		    $line =~ /__lockdep_no_validate__\s*\)/ ) {
72971704f47bSPeter Zijlstra			if ($realfile !~ m@^kernel/lockdep@ &&
72981704f47bSPeter Zijlstra			    $realfile !~ m@^include/linux/lockdep@ &&
72991704f47bSPeter Zijlstra			    $realfile !~ m@^drivers/base/core@) {
7300000d1cc1SJoe Perches				ERROR("LOCKDEP",
7301000d1cc1SJoe Perches				      "lockdep_no_validate class is reserved for device->mutex.\n" . $herecurr);
73021704f47bSPeter Zijlstra			}
73031704f47bSPeter Zijlstra		}
730488f8831cSDave Jones
7305b392c64fSJoe Perches		if ($line =~ /debugfs_create_\w+.*\b$mode_perms_world_writable\b/ ||
7306b392c64fSJoe Perches		    $line =~ /DEVICE_ATTR.*\b$mode_perms_world_writable\b/) {
7307000d1cc1SJoe Perches			WARN("EXPORTED_WORLD_WRITABLE",
7308000d1cc1SJoe Perches			     "Exporting world writable files is usually an error. Consider more restrictive permissions.\n" . $herecurr);
730988f8831cSDave Jones		}
73102435880fSJoe Perches
731100180468SJoe Perches# check for DEVICE_ATTR uses that could be DEVICE_ATTR_<FOO>
731200180468SJoe Perches# and whether or not function naming is typical and if
731300180468SJoe Perches# DEVICE_ATTR permissions uses are unusual too
73145b57980dSJoe Perches		if ($perl_version_ok &&
731500180468SJoe Perches		    defined $stat &&
731600180468SJoe Perches		    $stat =~ /\bDEVICE_ATTR\s*\(\s*(\w+)\s*,\s*\(?\s*(\s*(?:${multi_mode_perms_string_search}|0[0-7]{3,3})\s*)\s*\)?\s*,\s*(\w+)\s*,\s*(\w+)\s*\)/) {
731700180468SJoe Perches			my $var = $1;
731800180468SJoe Perches			my $perms = $2;
731900180468SJoe Perches			my $show = $3;
732000180468SJoe Perches			my $store = $4;
732100180468SJoe Perches			my $octal_perms = perms_to_octal($perms);
732200180468SJoe Perches			if ($show =~ /^${var}_show$/ &&
732300180468SJoe Perches			    $store =~ /^${var}_store$/ &&
732400180468SJoe Perches			    $octal_perms eq "0644") {
732500180468SJoe Perches				if (WARN("DEVICE_ATTR_RW",
732600180468SJoe Perches					 "Use DEVICE_ATTR_RW\n" . $herecurr) &&
732700180468SJoe Perches				    $fix) {
732800180468SJoe Perches					$fixed[$fixlinenr] =~ s/\bDEVICE_ATTR\s*\(\s*$var\s*,\s*\Q$perms\E\s*,\s*$show\s*,\s*$store\s*\)/DEVICE_ATTR_RW(${var})/;
732900180468SJoe Perches				}
733000180468SJoe Perches			} elsif ($show =~ /^${var}_show$/ &&
733100180468SJoe Perches				 $store =~ /^NULL$/ &&
733200180468SJoe Perches				 $octal_perms eq "0444") {
733300180468SJoe Perches				if (WARN("DEVICE_ATTR_RO",
733400180468SJoe Perches					 "Use DEVICE_ATTR_RO\n" . $herecurr) &&
733500180468SJoe Perches				    $fix) {
733600180468SJoe Perches					$fixed[$fixlinenr] =~ s/\bDEVICE_ATTR\s*\(\s*$var\s*,\s*\Q$perms\E\s*,\s*$show\s*,\s*NULL\s*\)/DEVICE_ATTR_RO(${var})/;
733700180468SJoe Perches				}
733800180468SJoe Perches			} elsif ($show =~ /^NULL$/ &&
733900180468SJoe Perches				 $store =~ /^${var}_store$/ &&
734000180468SJoe Perches				 $octal_perms eq "0200") {
734100180468SJoe Perches				if (WARN("DEVICE_ATTR_WO",
734200180468SJoe Perches					 "Use DEVICE_ATTR_WO\n" . $herecurr) &&
734300180468SJoe Perches				    $fix) {
734400180468SJoe Perches					$fixed[$fixlinenr] =~ s/\bDEVICE_ATTR\s*\(\s*$var\s*,\s*\Q$perms\E\s*,\s*NULL\s*,\s*$store\s*\)/DEVICE_ATTR_WO(${var})/;
734500180468SJoe Perches				}
734600180468SJoe Perches			} elsif ($octal_perms eq "0644" ||
734700180468SJoe Perches				 $octal_perms eq "0444" ||
734800180468SJoe Perches				 $octal_perms eq "0200") {
734900180468SJoe Perches				my $newshow = "$show";
735000180468SJoe Perches				$newshow = "${var}_show" if ($show ne "NULL" && $show ne "${var}_show");
735100180468SJoe Perches				my $newstore = $store;
735200180468SJoe Perches				$newstore = "${var}_store" if ($store ne "NULL" && $store ne "${var}_store");
735300180468SJoe Perches				my $rename = "";
735400180468SJoe Perches				if ($show ne $newshow) {
735500180468SJoe Perches					$rename .= " '$show' to '$newshow'";
735600180468SJoe Perches				}
735700180468SJoe Perches				if ($store ne $newstore) {
735800180468SJoe Perches					$rename .= " '$store' to '$newstore'";
735900180468SJoe Perches				}
736000180468SJoe Perches				WARN("DEVICE_ATTR_FUNCTIONS",
736100180468SJoe Perches				     "Consider renaming function(s)$rename\n" . $herecurr);
736200180468SJoe Perches			} else {
736300180468SJoe Perches				WARN("DEVICE_ATTR_PERMS",
736400180468SJoe Perches				     "DEVICE_ATTR unusual permissions '$perms' used\n" . $herecurr);
736500180468SJoe Perches			}
736600180468SJoe Perches		}
736700180468SJoe Perches
7368515a235eSJoe Perches# Mode permission misuses where it seems decimal should be octal
7369515a235eSJoe Perches# This uses a shortcut match to avoid unnecessary uses of a slow foreach loop
737073121534SJoe Perches# o Ignore module_param*(...) uses with a decimal 0 permission as that has a
737173121534SJoe Perches#   specific definition of not visible in sysfs.
737273121534SJoe Perches# o Ignore proc_create*(...) uses with a decimal 0 permission as that means
737373121534SJoe Perches#   use the default permissions
73745b57980dSJoe Perches		if ($perl_version_ok &&
7375459cf0aeSJoe Perches		    defined $stat &&
7376515a235eSJoe Perches		    $line =~ /$mode_perms_search/) {
73772435880fSJoe Perches			foreach my $entry (@mode_permission_funcs) {
73782435880fSJoe Perches				my $func = $entry->[0];
73792435880fSJoe Perches				my $arg_pos = $entry->[1];
73802435880fSJoe Perches
7381459cf0aeSJoe Perches				my $lc = $stat =~ tr@\n@@;
7382459cf0aeSJoe Perches				$lc = $lc + $linenr;
73832a9f9d85STobin C. Harding				my $stat_real = get_stat_real($linenr, $lc);
7384459cf0aeSJoe Perches
73852435880fSJoe Perches				my $skip_args = "";
73862435880fSJoe Perches				if ($arg_pos > 1) {
73872435880fSJoe Perches					$arg_pos--;
73882435880fSJoe Perches					$skip_args = "(?:\\s*$FuncArg\\s*,\\s*){$arg_pos,$arg_pos}";
73892435880fSJoe Perches				}
7390f90774e1SJoe Perches				my $test = "\\b$func\\s*\\(${skip_args}($FuncArg(?:\\|\\s*$FuncArg)*)\\s*[,\\)]";
7391459cf0aeSJoe Perches				if ($stat =~ /$test/) {
73922435880fSJoe Perches					my $val = $1;
73932435880fSJoe Perches					$val = $6 if ($skip_args ne "");
739473121534SJoe Perches					if (!($func =~ /^(?:module_param|proc_create)/ && $val eq "0") &&
739573121534SJoe Perches					    (($val =~ /^$Int$/ && $val !~ /^$Octal$/) ||
739673121534SJoe Perches					     ($val =~ /^$Octal$/ && length($val) ne 4))) {
73972435880fSJoe Perches						ERROR("NON_OCTAL_PERMISSIONS",
7398459cf0aeSJoe Perches						      "Use 4 digit octal (0777) not decimal permissions\n" . "$here\n" . $stat_real);
7399f90774e1SJoe Perches					}
7400f90774e1SJoe Perches					if ($val =~ /^$Octal$/ && (oct($val) & 02)) {
7401c0a5c898SJoe Perches						ERROR("EXPORTED_WORLD_WRITABLE",
7402459cf0aeSJoe Perches						      "Exporting writable files is usually an error. Consider more restrictive permissions.\n" . "$here\n" . $stat_real);
74032435880fSJoe Perches					}
7404459cf0aeSJoe Perches				}
7405459cf0aeSJoe Perches			}
7406459cf0aeSJoe Perches		}
7407459cf0aeSJoe Perches
7408459cf0aeSJoe Perches# check for uses of S_<PERMS> that could be octal for readability
7409bc22d9a7SJoe Perches		while ($line =~ m{\b($multi_mode_perms_string_search)\b}g) {
741000180468SJoe Perches			my $oval = $1;
741100180468SJoe Perches			my $octal = perms_to_octal($oval);
7412f90774e1SJoe Perches			if (WARN("SYMBOLIC_PERMS",
7413459cf0aeSJoe Perches				 "Symbolic permissions '$oval' are not preferred. Consider using octal permissions '$octal'.\n" . $herecurr) &&
7414f90774e1SJoe Perches			    $fix) {
741500180468SJoe Perches				$fixed[$fixlinenr] =~ s/\Q$oval\E/$octal/;
74162435880fSJoe Perches			}
741713214adfSAndy Whitcroft		}
74185a6d20ceSBjorn Andersson
74195a6d20ceSBjorn Andersson# validate content of MODULE_LICENSE against list from include/linux/module.h
74205a6d20ceSBjorn Andersson		if ($line =~ /\bMODULE_LICENSE\s*\(\s*($String)\s*\)/) {
74215a6d20ceSBjorn Andersson			my $extracted_string = get_quoted_string($line, $rawline);
74225a6d20ceSBjorn Andersson			my $valid_licenses = qr{
74235a6d20ceSBjorn Andersson						GPL|
74245a6d20ceSBjorn Andersson						GPL\ v2|
74255a6d20ceSBjorn Andersson						GPL\ and\ additional\ rights|
74265a6d20ceSBjorn Andersson						Dual\ BSD/GPL|
74275a6d20ceSBjorn Andersson						Dual\ MIT/GPL|
74285a6d20ceSBjorn Andersson						Dual\ MPL/GPL|
74295a6d20ceSBjorn Andersson						Proprietary
74305a6d20ceSBjorn Andersson					}x;
74315a6d20ceSBjorn Andersson			if ($extracted_string !~ /^"(?:$valid_licenses)"$/x) {
74325a6d20ceSBjorn Andersson				WARN("MODULE_LICENSE",
74335a6d20ceSBjorn Andersson				     "unknown module license " . $extracted_string . "\n" . $herecurr);
74345a6d20ceSBjorn Andersson			}
74356e8f42dcSJoe Perches			if (!$file && $extracted_string eq '"GPL v2"') {
74366e8f42dcSJoe Perches				if (WARN("MODULE_LICENSE",
74376e8f42dcSJoe Perches				     "Prefer \"GPL\" over \"GPL v2\" - see commit bf7fbeeae6db (\"module: Cure the MODULE_LICENSE \"GPL\" vs. \"GPL v2\" bogosity\")\n" . $herecurr) &&
74386e8f42dcSJoe Perches				    $fix) {
74396e8f42dcSJoe Perches					$fixed[$fixlinenr] =~ s/\bMODULE_LICENSE\s*\(\s*"GPL v2"\s*\)/MODULE_LICENSE("GPL")/;
74406e8f42dcSJoe Perches				}
74416e8f42dcSJoe Perches			}
74425a6d20ceSBjorn Andersson		}
74436a8d76cbSMatteo Croce
74446a8d76cbSMatteo Croce# check for sysctl duplicate constants
74456a8d76cbSMatteo Croce		if ($line =~ /\.extra[12]\s*=\s*&(zero|one|int_max)\b/) {
74466a8d76cbSMatteo Croce			WARN("DUPLICATED_SYSCTL_CONST",
74476a8d76cbSMatteo Croce				"duplicated sysctl range checking value '$1', consider using the shared one in include/linux/sysctl.h\n" . $herecurr);
74486a8d76cbSMatteo Croce		}
7449515a235eSJoe Perches	}
745013214adfSAndy Whitcroft
745113214adfSAndy Whitcroft	# If we have no input at all, then there is nothing to report on
745213214adfSAndy Whitcroft	# so just keep quiet.
745313214adfSAndy Whitcroft	if ($#rawlines == -1) {
745413214adfSAndy Whitcroft		exit(0);
74550a920b5bSAndy Whitcroft	}
74560a920b5bSAndy Whitcroft
74578905a67cSAndy Whitcroft	# In mailback mode only produce a report in the negative, for
74588905a67cSAndy Whitcroft	# things that appear to be patches.
74598905a67cSAndy Whitcroft	if ($mailback && ($clean == 1 || !$is_patch)) {
74608905a67cSAndy Whitcroft		exit(0);
74618905a67cSAndy Whitcroft	}
74628905a67cSAndy Whitcroft
7463e73d2715SDwaipayan Ray	# This is not a patch, and we are in 'no-patch' mode so
74648905a67cSAndy Whitcroft	# just keep quiet.
74658905a67cSAndy Whitcroft	if (!$chk_patch && !$is_patch) {
74668905a67cSAndy Whitcroft		exit(0);
74678905a67cSAndy Whitcroft	}
74688905a67cSAndy Whitcroft
7469a08ffbefSStafford Horne	if (!$is_patch && $filename !~ /cover-letter\.patch$/) {
7470000d1cc1SJoe Perches		ERROR("NOT_UNIFIED_DIFF",
7471000d1cc1SJoe Perches		      "Does not appear to be a unified-diff format patch\n");
74720a920b5bSAndy Whitcroft	}
7473cd261496SGeert Uytterhoeven	if ($is_patch && $has_commit_log && $chk_signoff) {
7474cd261496SGeert Uytterhoeven		if ($signoff == 0) {
7475000d1cc1SJoe Perches			ERROR("MISSING_SIGN_OFF",
7476000d1cc1SJoe Perches			      "Missing Signed-off-by: line(s)\n");
747748ca2d8aSDwaipayan Ray		} elsif ($authorsignoff != 1) {
747848ca2d8aSDwaipayan Ray			# authorsignoff values:
747948ca2d8aSDwaipayan Ray			# 0 -> missing sign off
748048ca2d8aSDwaipayan Ray			# 1 -> sign off identical
748148ca2d8aSDwaipayan Ray			# 2 -> names and addresses match, comments mismatch
748248ca2d8aSDwaipayan Ray			# 3 -> addresses match, names different
748348ca2d8aSDwaipayan Ray			# 4 -> names match, addresses different
748448ca2d8aSDwaipayan Ray			# 5 -> names match, addresses excluding subaddress details (refer RFC 5233) match
748548ca2d8aSDwaipayan Ray
748648ca2d8aSDwaipayan Ray			my $sob_msg = "'From: $author' != 'Signed-off-by: $author_sob'";
748748ca2d8aSDwaipayan Ray
748848ca2d8aSDwaipayan Ray			if ($authorsignoff == 0) {
748948ca2d8aSDwaipayan Ray				ERROR("NO_AUTHOR_SIGN_OFF",
7490cd261496SGeert Uytterhoeven				      "Missing Signed-off-by: line by nominal patch author '$author'\n");
749148ca2d8aSDwaipayan Ray			} elsif ($authorsignoff == 2) {
749248ca2d8aSDwaipayan Ray				CHK("FROM_SIGN_OFF_MISMATCH",
749348ca2d8aSDwaipayan Ray				    "From:/Signed-off-by: email comments mismatch: $sob_msg\n");
749448ca2d8aSDwaipayan Ray			} elsif ($authorsignoff == 3) {
749548ca2d8aSDwaipayan Ray				WARN("FROM_SIGN_OFF_MISMATCH",
749648ca2d8aSDwaipayan Ray				     "From:/Signed-off-by: email name mismatch: $sob_msg\n");
749748ca2d8aSDwaipayan Ray			} elsif ($authorsignoff == 4) {
749848ca2d8aSDwaipayan Ray				WARN("FROM_SIGN_OFF_MISMATCH",
749948ca2d8aSDwaipayan Ray				     "From:/Signed-off-by: email address mismatch: $sob_msg\n");
750048ca2d8aSDwaipayan Ray			} elsif ($authorsignoff == 5) {
750148ca2d8aSDwaipayan Ray				WARN("FROM_SIGN_OFF_MISMATCH",
750248ca2d8aSDwaipayan Ray				     "From:/Signed-off-by: email subaddress mismatch: $sob_msg\n");
750348ca2d8aSDwaipayan Ray			}
7504cd261496SGeert Uytterhoeven		}
75050a920b5bSAndy Whitcroft	}
75060a920b5bSAndy Whitcroft
7507f0a594c1SAndy Whitcroft	print report_dump();
750813214adfSAndy Whitcroft	if ($summary && !($clean == 1 && $quiet == 1)) {
750913214adfSAndy Whitcroft		print "$filename " if ($summary_file);
75106c72ffaaSAndy Whitcroft		print "total: $cnt_error errors, $cnt_warn warnings, " .
75116c72ffaaSAndy Whitcroft			(($check)? "$cnt_chk checks, " : "") .
75126c72ffaaSAndy Whitcroft			"$cnt_lines lines checked\n";
75136c72ffaaSAndy Whitcroft	}
75148905a67cSAndy Whitcroft
7515d2c0a235SAndy Whitcroft	if ($quiet == 0) {
7516ef212196SJoe Perches		# If there were any defects found and not already fixing them
7517ef212196SJoe Perches		if (!$clean and !$fix) {
7518ef212196SJoe Perches			print << "EOM"
7519ef212196SJoe Perches
7520ef212196SJoe PerchesNOTE: For some of the reported defects, checkpatch may be able to
7521ef212196SJoe Perches      mechanically convert to the typical style using --fix or --fix-inplace.
7522ef212196SJoe PerchesEOM
7523ef212196SJoe Perches		}
7524d2c0a235SAndy Whitcroft		# If there were whitespace errors which cleanpatch can fix
7525d2c0a235SAndy Whitcroft		# then suggest that.
7526d2c0a235SAndy Whitcroft		if ($rpt_cleaners) {
7527b0781216SMike Frysinger			$rpt_cleaners = 0;
7528d8469f16SJoe Perches			print << "EOM"
7529d8469f16SJoe Perches
7530d8469f16SJoe PerchesNOTE: Whitespace errors detected.
7531d8469f16SJoe Perches      You may wish to use scripts/cleanpatch or scripts/cleanfile
7532d8469f16SJoe PerchesEOM
7533d2c0a235SAndy Whitcroft		}
7534d2c0a235SAndy Whitcroft	}
7535d2c0a235SAndy Whitcroft
7536d752fcc8SJoe Perches	if ($clean == 0 && $fix &&
7537d752fcc8SJoe Perches	    ("@rawlines" ne "@fixed" ||
7538d752fcc8SJoe Perches	     $#fixed_inserted >= 0 || $#fixed_deleted >= 0)) {
75399624b8d6SJoe Perches		my $newfile = $filename;
75409624b8d6SJoe Perches		$newfile .= ".EXPERIMENTAL-checkpatch-fixes" if (!$fix_inplace);
75413705ce5bSJoe Perches		my $linecount = 0;
75423705ce5bSJoe Perches		my $f;
75433705ce5bSJoe Perches
7544d752fcc8SJoe Perches		@fixed = fix_inserted_deleted_lines(\@fixed, \@fixed_inserted, \@fixed_deleted);
7545d752fcc8SJoe Perches
75463705ce5bSJoe Perches		open($f, '>', $newfile)
75473705ce5bSJoe Perches		    or die "$P: Can't open $newfile for write\n";
75483705ce5bSJoe Perches		foreach my $fixed_line (@fixed) {
75493705ce5bSJoe Perches			$linecount++;
75503705ce5bSJoe Perches			if ($file) {
75513705ce5bSJoe Perches				if ($linecount > 3) {
75523705ce5bSJoe Perches					$fixed_line =~ s/^\+//;
75533705ce5bSJoe Perches					print $f $fixed_line . "\n";
75543705ce5bSJoe Perches				}
75553705ce5bSJoe Perches			} else {
75563705ce5bSJoe Perches				print $f $fixed_line . "\n";
75573705ce5bSJoe Perches			}
75583705ce5bSJoe Perches		}
75593705ce5bSJoe Perches		close($f);
75603705ce5bSJoe Perches
75613705ce5bSJoe Perches		if (!$quiet) {
75623705ce5bSJoe Perches			print << "EOM";
7563d8469f16SJoe Perches
75643705ce5bSJoe PerchesWrote EXPERIMENTAL --fix correction(s) to '$newfile'
75653705ce5bSJoe Perches
75663705ce5bSJoe PerchesDo _NOT_ trust the results written to this file.
75673705ce5bSJoe PerchesDo _NOT_ submit these changes without inspecting them for correctness.
75683705ce5bSJoe Perches
75693705ce5bSJoe PerchesThis EXPERIMENTAL file is simply a convenience to help rewrite patches.
75703705ce5bSJoe PerchesNo warranties, expressed or implied...
75713705ce5bSJoe PerchesEOM
75723705ce5bSJoe Perches		}
75733705ce5bSJoe Perches	}
75743705ce5bSJoe Perches
7575d8469f16SJoe Perches	if ($quiet == 0) {
7576d8469f16SJoe Perches		print "\n";
7577d8469f16SJoe Perches		if ($clean == 1) {
7578d8469f16SJoe Perches			print "$vname has no obvious style problems and is ready for submission.\n";
7579d8469f16SJoe Perches		} else {
7580d8469f16SJoe Perches			print "$vname has style problems, please review.\n";
75810a920b5bSAndy Whitcroft		}
75820a920b5bSAndy Whitcroft	}
75830a920b5bSAndy Whitcroft	return $clean;
75840a920b5bSAndy Whitcroft}
7585