xref: /linux-6.15/scripts/checkpatch.pl (revision 8d2e11b2)
1cb77f0d6SKamil Rytarowski#!/usr/bin/env perl
2dbf004d7SDave Jones# (c) 2001, Dave Jones. (the file handling bit)
300df344fSAndy Whitcroft# (c) 2005, Joel Schopp <[email protected]> (the ugly bit)
42a5a2c25SAndy Whitcroft# (c) 2007,2008, Andy Whitcroft <[email protected]> (new conditions, test suite)
5015830beSAndy Whitcroft# (c) 2008-2010 Andy Whitcroft <[email protected]>
60a920b5bSAndy Whitcroft# Licensed under the terms of the GNU GPL License version 2
70a920b5bSAndy Whitcroft
80a920b5bSAndy Whitcroftuse strict;
9cb77f0d6SKamil Rytarowskiuse warnings;
10c707a81dSJoe Perchesuse POSIX;
1136061e38SJoe Perchesuse File::Basename;
1236061e38SJoe Perchesuse Cwd 'abs_path';
1357230297SJoe Perchesuse Term::ANSIColor qw(:constants);
140a920b5bSAndy Whitcroft
150a920b5bSAndy Whitcroftmy $P = $0;
1636061e38SJoe Perchesmy $D = dirname(abs_path($P));
170a920b5bSAndy Whitcroft
18000d1cc1SJoe Perchesmy $V = '0.32';
190a920b5bSAndy Whitcroft
200a920b5bSAndy Whitcroftuse Getopt::Long qw(:config no_auto_abbrev);
210a920b5bSAndy Whitcroft
220a920b5bSAndy Whitcroftmy $quiet = 0;
230a920b5bSAndy Whitcroftmy $tree = 1;
240a920b5bSAndy Whitcroftmy $chk_signoff = 1;
250a920b5bSAndy Whitcroftmy $chk_patch = 1;
26773647a0SAndy Whitcroftmy $tst_only;
276c72ffaaSAndy Whitcroftmy $emacs = 0;
288905a67cSAndy Whitcroftmy $terse = 0;
2934d8815fSJoe Perchesmy $showfile = 0;
306c72ffaaSAndy Whitcroftmy $file = 0;
314a593c34SDu, Changbinmy $git = 0;
320dea9f1eSJoe Perchesmy %git_commits = ();
336c72ffaaSAndy Whitcroftmy $check = 0;
342ac73b4fSJoe Perchesmy $check_orig = 0;
358905a67cSAndy Whitcroftmy $summary = 1;
368905a67cSAndy Whitcroftmy $mailback = 0;
3713214adfSAndy Whitcroftmy $summary_file = 0;
38000d1cc1SJoe Perchesmy $show_types = 0;
393beb42ecSJoe Perchesmy $list_types = 0;
403705ce5bSJoe Perchesmy $fix = 0;
419624b8d6SJoe Perchesmy $fix_inplace = 0;
426c72ffaaSAndy Whitcroftmy $root;
43c2fdda0dSAndy Whitcroftmy %debug;
443445686aSJoe Perchesmy %camelcase = ();
4591bfe484SJoe Perchesmy %use_type = ();
4691bfe484SJoe Perchesmy @use = ();
4791bfe484SJoe Perchesmy %ignore_type = ();
48000d1cc1SJoe Perchesmy @ignore = ();
4977f5b10aSHannes Edermy $help = 0;
50000d1cc1SJoe Perchesmy $configuration_file = ".checkpatch.conf";
516cd7f386SJoe Perchesmy $max_line_length = 80;
52d62a201fSDave Hansenmy $ignore_perl_version = 0;
53d62a201fSDave Hansenmy $minimum_perl_version = 5.10.0;
5456193274SVadim Bendeburymy $min_conf_desc_length = 4;
5566b47b4aSKees Cookmy $spelling_file = "$D/spelling.txt";
56ebfd7d62SJoe Perchesmy $codespell = 0;
57f1a63678SMaxim Uvarovmy $codespellfile = "/usr/share/codespell/dictionary.txt";
58bf1fa1daSJoe Perchesmy $conststructsfile = "$D/const_structs.checkpatch";
5975ad8c57SJerome Forissiermy $typedefsfile = "";
60737c0767SJohn Brooksmy $color = "auto";
61dadf680dSJoe Perchesmy $allow_c99_comments = 1;
6277f5b10aSHannes Eder
6377f5b10aSHannes Edersub help {
6477f5b10aSHannes Eder	my ($exitcode) = @_;
6577f5b10aSHannes Eder
6677f5b10aSHannes Eder	print << "EOM";
6777f5b10aSHannes EderUsage: $P [OPTION]... [FILE]...
6877f5b10aSHannes EderVersion: $V
6977f5b10aSHannes Eder
7077f5b10aSHannes EderOptions:
7177f5b10aSHannes Eder  -q, --quiet                quiet
7277f5b10aSHannes Eder  --no-tree                  run without a kernel tree
7377f5b10aSHannes Eder  --no-signoff               do not check for 'Signed-off-by' line
7477f5b10aSHannes Eder  --patch                    treat FILE as patchfile (default)
7577f5b10aSHannes Eder  --emacs                    emacs compile window format
7677f5b10aSHannes Eder  --terse                    one line per report
7734d8815fSJoe Perches  --showfile                 emit diffed file position, not input file position
784a593c34SDu, Changbin  -g, --git                  treat FILE as a single commit or git revision range
794a593c34SDu, Changbin                             single git commit with:
804a593c34SDu, Changbin                               <rev>
814a593c34SDu, Changbin                               <rev>^
824a593c34SDu, Changbin                               <rev>~n
834a593c34SDu, Changbin                             multiple git commits with:
844a593c34SDu, Changbin                               <rev1>..<rev2>
854a593c34SDu, Changbin                               <rev1>...<rev2>
864a593c34SDu, Changbin                               <rev>-<count>
874a593c34SDu, Changbin                             git merges are ignored
8877f5b10aSHannes Eder  -f, --file                 treat FILE as regular source file
8977f5b10aSHannes Eder  --subjective, --strict     enable more subjective tests
903beb42ecSJoe Perches  --list-types               list the possible message types
9191bfe484SJoe Perches  --types TYPE(,TYPE2...)    show only these comma separated message types
92000d1cc1SJoe Perches  --ignore TYPE(,TYPE2...)   ignore various comma separated message types
933beb42ecSJoe Perches  --show-types               show the specific message type in the output
946cd7f386SJoe Perches  --max-line-length=n        set the maximum line length, if exceeded, warn
9556193274SVadim Bendebury  --min-conf-desc-length=n   set the min description length, if shorter, warn
9677f5b10aSHannes Eder  --root=PATH                PATH to the kernel tree root
9777f5b10aSHannes Eder  --no-summary               suppress the per-file summary
9877f5b10aSHannes Eder  --mailback                 only produce a report in case of warnings/errors
9977f5b10aSHannes Eder  --summary-file             include the filename in summary
10077f5b10aSHannes Eder  --debug KEY=[0|1]          turn on/off debugging of KEY, where KEY is one of
10177f5b10aSHannes Eder                             'values', 'possible', 'type', and 'attr' (default
10277f5b10aSHannes Eder                             is all off)
10377f5b10aSHannes Eder  --test-only=WORD           report only warnings/errors containing WORD
10477f5b10aSHannes Eder                             literally
1053705ce5bSJoe Perches  --fix                      EXPERIMENTAL - may create horrible results
1063705ce5bSJoe Perches                             If correctable single-line errors exist, create
1073705ce5bSJoe Perches                             "<inputfile>.EXPERIMENTAL-checkpatch-fixes"
1083705ce5bSJoe Perches                             with potential errors corrected to the preferred
1093705ce5bSJoe Perches                             checkpatch style
1109624b8d6SJoe Perches  --fix-inplace              EXPERIMENTAL - may create horrible results
1119624b8d6SJoe Perches                             Is the same as --fix, but overwrites the input
1129624b8d6SJoe Perches                             file.  It's your fault if there's no backup or git
113d62a201fSDave Hansen  --ignore-perl-version      override checking of perl version.  expect
114d62a201fSDave Hansen                             runtime errors.
115ebfd7d62SJoe Perches  --codespell                Use the codespell dictionary for spelling/typos
116f1a63678SMaxim Uvarov                             (default:/usr/share/codespell/dictionary.txt)
117ebfd7d62SJoe Perches  --codespellfile            Use this codespell dictionary
11875ad8c57SJerome Forissier  --typedefsfile             Read additional types from this file
119737c0767SJohn Brooks  --color[=WHEN]             Use colors 'always', 'never', or only when output
120737c0767SJohn Brooks                             is a terminal ('auto'). Default is 'auto'.
12177f5b10aSHannes Eder  -h, --help, --version      display this help and exit
12277f5b10aSHannes Eder
12377f5b10aSHannes EderWhen FILE is - read standard input.
12477f5b10aSHannes EderEOM
12577f5b10aSHannes Eder
12677f5b10aSHannes Eder	exit($exitcode);
12777f5b10aSHannes Eder}
12877f5b10aSHannes Eder
1293beb42ecSJoe Perchessub uniq {
1303beb42ecSJoe Perches	my %seen;
1313beb42ecSJoe Perches	return grep { !$seen{$_}++ } @_;
1323beb42ecSJoe Perches}
1333beb42ecSJoe Perches
1343beb42ecSJoe Perchessub list_types {
1353beb42ecSJoe Perches	my ($exitcode) = @_;
1363beb42ecSJoe Perches
1373beb42ecSJoe Perches	my $count = 0;
1383beb42ecSJoe Perches
1393beb42ecSJoe Perches	local $/ = undef;
1403beb42ecSJoe Perches
1413beb42ecSJoe Perches	open(my $script, '<', abs_path($P)) or
1423beb42ecSJoe Perches	    die "$P: Can't read '$P' $!\n";
1433beb42ecSJoe Perches
1443beb42ecSJoe Perches	my $text = <$script>;
1453beb42ecSJoe Perches	close($script);
1463beb42ecSJoe Perches
1473beb42ecSJoe Perches	my @types = ();
1480547fa58SJean Delvare	# Also catch when type or level is passed through a variable
1490547fa58SJean Delvare	for ($text =~ /(?:(?:\bCHK|\bWARN|\bERROR|&\{\$msg_level})\s*\(|\$msg_type\s*=)\s*"([^"]+)"/g) {
1503beb42ecSJoe Perches		push (@types, $_);
1513beb42ecSJoe Perches	}
1523beb42ecSJoe Perches	@types = sort(uniq(@types));
1533beb42ecSJoe Perches	print("#\tMessage type\n\n");
1543beb42ecSJoe Perches	foreach my $type (@types) {
1553beb42ecSJoe Perches		print(++$count . "\t" . $type . "\n");
1563beb42ecSJoe Perches	}
1573beb42ecSJoe Perches
1583beb42ecSJoe Perches	exit($exitcode);
1593beb42ecSJoe Perches}
1603beb42ecSJoe Perches
161000d1cc1SJoe Perchesmy $conf = which_conf($configuration_file);
162000d1cc1SJoe Perchesif (-f $conf) {
163000d1cc1SJoe Perches	my @conf_args;
164000d1cc1SJoe Perches	open(my $conffile, '<', "$conf")
165000d1cc1SJoe Perches	    or warn "$P: Can't find a readable $configuration_file file $!\n";
166000d1cc1SJoe Perches
167000d1cc1SJoe Perches	while (<$conffile>) {
168000d1cc1SJoe Perches		my $line = $_;
169000d1cc1SJoe Perches
170000d1cc1SJoe Perches		$line =~ s/\s*\n?$//g;
171000d1cc1SJoe Perches		$line =~ s/^\s*//g;
172000d1cc1SJoe Perches		$line =~ s/\s+/ /g;
173000d1cc1SJoe Perches
174000d1cc1SJoe Perches		next if ($line =~ m/^\s*#/);
175000d1cc1SJoe Perches		next if ($line =~ m/^\s*$/);
176000d1cc1SJoe Perches
177000d1cc1SJoe Perches		my @words = split(" ", $line);
178000d1cc1SJoe Perches		foreach my $word (@words) {
179000d1cc1SJoe Perches			last if ($word =~ m/^#/);
180000d1cc1SJoe Perches			push (@conf_args, $word);
181000d1cc1SJoe Perches		}
182000d1cc1SJoe Perches	}
183000d1cc1SJoe Perches	close($conffile);
184000d1cc1SJoe Perches	unshift(@ARGV, @conf_args) if @conf_args;
185000d1cc1SJoe Perches}
186000d1cc1SJoe Perches
187737c0767SJohn Brooks# Perl's Getopt::Long allows options to take optional arguments after a space.
188737c0767SJohn Brooks# Prevent --color by itself from consuming other arguments
189737c0767SJohn Brooksforeach (@ARGV) {
190737c0767SJohn Brooks	if ($_ eq "--color" || $_ eq "-color") {
191737c0767SJohn Brooks		$_ = "--color=$color";
192737c0767SJohn Brooks	}
193737c0767SJohn Brooks}
194737c0767SJohn Brooks
1950a920b5bSAndy WhitcroftGetOptions(
1966c72ffaaSAndy Whitcroft	'q|quiet+'	=> \$quiet,
1970a920b5bSAndy Whitcroft	'tree!'		=> \$tree,
1980a920b5bSAndy Whitcroft	'signoff!'	=> \$chk_signoff,
1990a920b5bSAndy Whitcroft	'patch!'	=> \$chk_patch,
2006c72ffaaSAndy Whitcroft	'emacs!'	=> \$emacs,
2018905a67cSAndy Whitcroft	'terse!'	=> \$terse,
20234d8815fSJoe Perches	'showfile!'	=> \$showfile,
20377f5b10aSHannes Eder	'f|file!'	=> \$file,
2044a593c34SDu, Changbin	'g|git!'	=> \$git,
2056c72ffaaSAndy Whitcroft	'subjective!'	=> \$check,
2066c72ffaaSAndy Whitcroft	'strict!'	=> \$check,
207000d1cc1SJoe Perches	'ignore=s'	=> \@ignore,
20891bfe484SJoe Perches	'types=s'	=> \@use,
209000d1cc1SJoe Perches	'show-types!'	=> \$show_types,
2103beb42ecSJoe Perches	'list-types!'	=> \$list_types,
2116cd7f386SJoe Perches	'max-line-length=i' => \$max_line_length,
21256193274SVadim Bendebury	'min-conf-desc-length=i' => \$min_conf_desc_length,
2136c72ffaaSAndy Whitcroft	'root=s'	=> \$root,
2148905a67cSAndy Whitcroft	'summary!'	=> \$summary,
2158905a67cSAndy Whitcroft	'mailback!'	=> \$mailback,
21613214adfSAndy Whitcroft	'summary-file!'	=> \$summary_file,
2173705ce5bSJoe Perches	'fix!'		=> \$fix,
2189624b8d6SJoe Perches	'fix-inplace!'	=> \$fix_inplace,
219d62a201fSDave Hansen	'ignore-perl-version!' => \$ignore_perl_version,
220c2fdda0dSAndy Whitcroft	'debug=s'	=> \%debug,
221773647a0SAndy Whitcroft	'test-only=s'	=> \$tst_only,
222ebfd7d62SJoe Perches	'codespell!'	=> \$codespell,
223ebfd7d62SJoe Perches	'codespellfile=s'	=> \$codespellfile,
22475ad8c57SJerome Forissier	'typedefsfile=s'	=> \$typedefsfile,
225737c0767SJohn Brooks	'color=s'	=> \$color,
226737c0767SJohn Brooks	'no-color'	=> \$color,	#keep old behaviors of -nocolor
227737c0767SJohn Brooks	'nocolor'	=> \$color,	#keep old behaviors of -nocolor
22877f5b10aSHannes Eder	'h|help'	=> \$help,
22977f5b10aSHannes Eder	'version'	=> \$help
23077f5b10aSHannes Eder) or help(1);
23177f5b10aSHannes Eder
23277f5b10aSHannes Ederhelp(0) if ($help);
2330a920b5bSAndy Whitcroft
2343beb42ecSJoe Percheslist_types(0) if ($list_types);
2353beb42ecSJoe Perches
2369624b8d6SJoe Perches$fix = 1 if ($fix_inplace);
2372ac73b4fSJoe Perches$check_orig = $check;
2389624b8d6SJoe Perches
2390a920b5bSAndy Whitcroftmy $exit = 0;
2400a920b5bSAndy Whitcroft
241d62a201fSDave Hansenif ($^V && $^V lt $minimum_perl_version) {
242d62a201fSDave Hansen	printf "$P: requires at least perl version %vd\n", $minimum_perl_version;
243d62a201fSDave Hansen	if (!$ignore_perl_version) {
244d62a201fSDave Hansen		exit(1);
245d62a201fSDave Hansen	}
246d62a201fSDave Hansen}
247d62a201fSDave Hansen
24845107ff6SAllen Hubbe#if no filenames are given, push '-' to read patch from stdin
2490a920b5bSAndy Whitcroftif ($#ARGV < 0) {
25045107ff6SAllen Hubbe	push(@ARGV, '-');
2510a920b5bSAndy Whitcroft}
2520a920b5bSAndy Whitcroft
253737c0767SJohn Brooksif ($color =~ /^[01]$/) {
254737c0767SJohn Brooks	$color = !$color;
255737c0767SJohn Brooks} elsif ($color =~ /^always$/i) {
256737c0767SJohn Brooks	$color = 1;
257737c0767SJohn Brooks} elsif ($color =~ /^never$/i) {
258737c0767SJohn Brooks	$color = 0;
259737c0767SJohn Brooks} elsif ($color =~ /^auto$/i) {
260737c0767SJohn Brooks	$color = (-t STDOUT);
261737c0767SJohn Brooks} else {
262737c0767SJohn Brooks	die "Invalid color mode: $color\n";
263737c0767SJohn Brooks}
264737c0767SJohn Brooks
26591bfe484SJoe Perchessub hash_save_array_words {
26691bfe484SJoe Perches	my ($hashRef, $arrayRef) = @_;
26791bfe484SJoe Perches
26891bfe484SJoe Perches	my @array = split(/,/, join(',', @$arrayRef));
26991bfe484SJoe Perches	foreach my $word (@array) {
270000d1cc1SJoe Perches		$word =~ s/\s*\n?$//g;
271000d1cc1SJoe Perches		$word =~ s/^\s*//g;
272000d1cc1SJoe Perches		$word =~ s/\s+/ /g;
273000d1cc1SJoe Perches		$word =~ tr/[a-z]/[A-Z]/;
274000d1cc1SJoe Perches
275000d1cc1SJoe Perches		next if ($word =~ m/^\s*#/);
276000d1cc1SJoe Perches		next if ($word =~ m/^\s*$/);
277000d1cc1SJoe Perches
27891bfe484SJoe Perches		$hashRef->{$word}++;
279000d1cc1SJoe Perches	}
28091bfe484SJoe Perches}
28191bfe484SJoe Perches
28291bfe484SJoe Perchessub hash_show_words {
28391bfe484SJoe Perches	my ($hashRef, $prefix) = @_;
28491bfe484SJoe Perches
2853c816e49SJoe Perches	if (keys %$hashRef) {
286d8469f16SJoe Perches		print "\nNOTE: $prefix message types:";
28758cb3cf6SJoe Perches		foreach my $word (sort keys %$hashRef) {
28891bfe484SJoe Perches			print " $word";
28991bfe484SJoe Perches		}
290d8469f16SJoe Perches		print "\n";
29191bfe484SJoe Perches	}
29291bfe484SJoe Perches}
29391bfe484SJoe Perches
29491bfe484SJoe Percheshash_save_array_words(\%ignore_type, \@ignore);
29591bfe484SJoe Percheshash_save_array_words(\%use_type, \@use);
296000d1cc1SJoe Perches
297c2fdda0dSAndy Whitcroftmy $dbg_values = 0;
298c2fdda0dSAndy Whitcroftmy $dbg_possible = 0;
2997429c690SAndy Whitcroftmy $dbg_type = 0;
300a1ef277eSAndy Whitcroftmy $dbg_attr = 0;
301c2fdda0dSAndy Whitcroftfor my $key (keys %debug) {
30221caa13cSAndy Whitcroft	## no critic
30321caa13cSAndy Whitcroft	eval "\${dbg_$key} = '$debug{$key}';";
30421caa13cSAndy Whitcroft	die "$@" if ($@);
305c2fdda0dSAndy Whitcroft}
306c2fdda0dSAndy Whitcroft
307d2c0a235SAndy Whitcroftmy $rpt_cleaners = 0;
308d2c0a235SAndy Whitcroft
3098905a67cSAndy Whitcroftif ($terse) {
3108905a67cSAndy Whitcroft	$emacs = 1;
3118905a67cSAndy Whitcroft	$quiet++;
3128905a67cSAndy Whitcroft}
3138905a67cSAndy Whitcroft
3146c72ffaaSAndy Whitcroftif ($tree) {
3156c72ffaaSAndy Whitcroft	if (defined $root) {
3166c72ffaaSAndy Whitcroft		if (!top_of_kernel_tree($root)) {
3176c72ffaaSAndy Whitcroft			die "$P: $root: --root does not point at a valid tree\n";
3186c72ffaaSAndy Whitcroft		}
3196c72ffaaSAndy Whitcroft	} else {
3206c72ffaaSAndy Whitcroft		if (top_of_kernel_tree('.')) {
3216c72ffaaSAndy Whitcroft			$root = '.';
3226c72ffaaSAndy Whitcroft		} elsif ($0 =~ m@(.*)/scripts/[^/]*$@ &&
3236c72ffaaSAndy Whitcroft						top_of_kernel_tree($1)) {
3246c72ffaaSAndy Whitcroft			$root = $1;
3256c72ffaaSAndy Whitcroft		}
3266c72ffaaSAndy Whitcroft	}
3276c72ffaaSAndy Whitcroft
3286c72ffaaSAndy Whitcroft	if (!defined $root) {
3290a920b5bSAndy Whitcroft		print "Must be run from the top-level dir. of a kernel tree\n";
3300a920b5bSAndy Whitcroft		exit(2);
3310a920b5bSAndy Whitcroft	}
3326c72ffaaSAndy Whitcroft}
3336c72ffaaSAndy Whitcroft
3346c72ffaaSAndy Whitcroftmy $emitted_corrupt = 0;
3356c72ffaaSAndy Whitcroft
3362ceb532bSAndy Whitcroftour $Ident	= qr{
3372ceb532bSAndy Whitcroft			[A-Za-z_][A-Za-z\d_]*
3382ceb532bSAndy Whitcroft			(?:\s*\#\#\s*[A-Za-z_][A-Za-z\d_]*)*
3392ceb532bSAndy Whitcroft		}x;
3406c72ffaaSAndy Whitcroftour $Storage	= qr{extern|static|asmlinkage};
3416c72ffaaSAndy Whitcroftour $Sparse	= qr{
3426c72ffaaSAndy Whitcroft			__user|
3436c72ffaaSAndy Whitcroft			__kernel|
3446c72ffaaSAndy Whitcroft			__force|
3456c72ffaaSAndy Whitcroft			__iomem|
3466c72ffaaSAndy Whitcroft			__must_check|
3476c72ffaaSAndy Whitcroft			__init_refok|
348417495edSAndy Whitcroft			__kprobes|
349165e72a6SSven Eckelmann			__ref|
350ad315455SBoqun Feng			__rcu|
351ad315455SBoqun Feng			__private
3526c72ffaaSAndy Whitcroft		}x;
353e970b884SJoe Perchesour $InitAttributePrefix = qr{__(?:mem|cpu|dev|net_|)};
354e970b884SJoe Perchesour $InitAttributeData = qr{$InitAttributePrefix(?:initdata\b)};
355e970b884SJoe Perchesour $InitAttributeConst = qr{$InitAttributePrefix(?:initconst\b)};
356e970b884SJoe Perchesour $InitAttributeInit = qr{$InitAttributePrefix(?:init\b)};
357e970b884SJoe Perchesour $InitAttribute = qr{$InitAttributeData|$InitAttributeConst|$InitAttributeInit};
3588716de38SJoe Perches
35952131292SWolfram Sang# Notes to $Attribute:
36052131292SWolfram Sang# We need \b after 'init' otherwise 'initconst' will cause a false positive in a check
3616c72ffaaSAndy Whitcroftour $Attribute	= qr{
3626c72ffaaSAndy Whitcroft			const|
36303f1df7dSJoe Perches			__percpu|
36403f1df7dSJoe Perches			__nocast|
36503f1df7dSJoe Perches			__safe|
36646d832f5SMichael S. Tsirkin			__bitwise|
36703f1df7dSJoe Perches			__packed__|
36803f1df7dSJoe Perches			__packed2__|
36903f1df7dSJoe Perches			__naked|
37003f1df7dSJoe Perches			__maybe_unused|
37103f1df7dSJoe Perches			__always_unused|
37203f1df7dSJoe Perches			__noreturn|
37303f1df7dSJoe Perches			__used|
37403f1df7dSJoe Perches			__cold|
375e23ef1f3SJoe Perches			__pure|
37603f1df7dSJoe Perches			__noclone|
37703f1df7dSJoe Perches			__deprecated|
3786c72ffaaSAndy Whitcroft			__read_mostly|
3796c72ffaaSAndy Whitcroft			__kprobes|
3808716de38SJoe Perches			$InitAttribute|
38124e1d81aSAndy Whitcroft			____cacheline_aligned|
38224e1d81aSAndy Whitcroft			____cacheline_aligned_in_smp|
3835fe3af11SAndy Whitcroft			____cacheline_internodealigned_in_smp|
3845fe3af11SAndy Whitcroft			__weak
3856c72ffaaSAndy Whitcroft		  }x;
386c45dcabdSAndy Whitcroftour $Modifier;
38791cb5195SJoe Perchesour $Inline	= qr{inline|__always_inline|noinline|__inline|__inline__};
3886c72ffaaSAndy Whitcroftour $Member	= qr{->$Ident|\.$Ident|\[[^]]*\]};
3896c72ffaaSAndy Whitcroftour $Lval	= qr{$Ident(?:$Member)*};
3906c72ffaaSAndy Whitcroft
39195e2c602SJoe Perchesour $Int_type	= qr{(?i)llu|ull|ll|lu|ul|l|u};
39295e2c602SJoe Perchesour $Binary	= qr{(?i)0b[01]+$Int_type?};
39395e2c602SJoe Perchesour $Hex	= qr{(?i)0x[0-9a-f]+$Int_type?};
39495e2c602SJoe Perchesour $Int	= qr{[0-9]+$Int_type?};
3952435880fSJoe Perchesour $Octal	= qr{0[0-7]+$Int_type?};
396c0a5c898SJoe Perchesour $String	= qr{"[X\t]*"};
397326b1ffcSJoe Perchesour $Float_hex	= qr{(?i)0x[0-9a-f]+p-?[0-9]+[fl]?};
398326b1ffcSJoe Perchesour $Float_dec	= qr{(?i)(?:[0-9]+\.[0-9]*|[0-9]*\.[0-9]+)(?:e-?[0-9]+)?[fl]?};
399326b1ffcSJoe Perchesour $Float_int	= qr{(?i)[0-9]+e-?[0-9]+[fl]?};
40074349bccSJoe Perchesour $Float	= qr{$Float_hex|$Float_dec|$Float_int};
4012435880fSJoe Perchesour $Constant	= qr{$Float|$Binary|$Octal|$Hex|$Int};
402326b1ffcSJoe Perchesour $Assignment	= qr{\*\=|/=|%=|\+=|-=|<<=|>>=|&=|\^=|\|=|=};
403447432f3SJoe Perchesour $Compare    = qr{<=|>=|==|!=|<|(?<!-)>};
40423f780c9SJoe Perchesour $Arithmetic = qr{\+|-|\*|\/|%};
4056c72ffaaSAndy Whitcroftour $Operators	= qr{
4066c72ffaaSAndy Whitcroft			<=|>=|==|!=|
4076c72ffaaSAndy Whitcroft			=>|->|<<|>>|<|>|!|~|
40823f780c9SJoe Perches			&&|\|\||,|\^|\+\+|--|&|\||$Arithmetic
4096c72ffaaSAndy Whitcroft		  }x;
4106c72ffaaSAndy Whitcroft
41191cb5195SJoe Perchesour $c90_Keywords = qr{do|for|while|if|else|return|goto|continue|switch|default|case|break}x;
41291cb5195SJoe Perches
413ab7e23f3SJoe Perchesour $BasicType;
4148905a67cSAndy Whitcroftour $NonptrType;
4151813087dSJoe Perchesour $NonptrTypeMisordered;
4168716de38SJoe Perchesour $NonptrTypeWithAttr;
4178905a67cSAndy Whitcroftour $Type;
4181813087dSJoe Perchesour $TypeMisordered;
4198905a67cSAndy Whitcroftour $Declare;
4201813087dSJoe Perchesour $DeclareMisordered;
4218905a67cSAndy Whitcroft
42215662b3eSJoe Perchesour $NON_ASCII_UTF8	= qr{
42315662b3eSJoe Perches	[\xC2-\xDF][\x80-\xBF]               # non-overlong 2-byte
424171ae1a4SAndy Whitcroft	|  \xE0[\xA0-\xBF][\x80-\xBF]        # excluding overlongs
425171ae1a4SAndy Whitcroft	| [\xE1-\xEC\xEE\xEF][\x80-\xBF]{2}  # straight 3-byte
426171ae1a4SAndy Whitcroft	|  \xED[\x80-\x9F][\x80-\xBF]        # excluding surrogates
427171ae1a4SAndy Whitcroft	|  \xF0[\x90-\xBF][\x80-\xBF]{2}     # planes 1-3
428171ae1a4SAndy Whitcroft	| [\xF1-\xF3][\x80-\xBF]{3}          # planes 4-15
429171ae1a4SAndy Whitcroft	|  \xF4[\x80-\x8F][\x80-\xBF]{2}     # plane 16
430171ae1a4SAndy Whitcroft}x;
431171ae1a4SAndy Whitcroft
43215662b3eSJoe Perchesour $UTF8	= qr{
43315662b3eSJoe Perches	[\x09\x0A\x0D\x20-\x7E]              # ASCII
43415662b3eSJoe Perches	| $NON_ASCII_UTF8
43515662b3eSJoe Perches}x;
43615662b3eSJoe Perches
437e6176fa4SJoe Perchesour $typeC99Typedefs = qr{(?:__)?(?:[us]_?)?int_?(?:8|16|32|64)_t};
438021158b4SJoe Perchesour $typeOtherOSTypedefs = qr{(?x:
439021158b4SJoe Perches	u_(?:char|short|int|long) |          # bsd
440021158b4SJoe Perches	u(?:nchar|short|int|long)            # sysv
441021158b4SJoe Perches)};
442e6176fa4SJoe Perchesour $typeKernelTypedefs = qr{(?x:
443fb9e9096SAndy Whitcroft	(?:__)?(?:u|s|be|le)(?:8|16|32|64)|
4448ed22cadSAndy Whitcroft	atomic_t
4458ed22cadSAndy Whitcroft)};
446e6176fa4SJoe Perchesour $typeTypedefs = qr{(?x:
447e6176fa4SJoe Perches	$typeC99Typedefs\b|
448e6176fa4SJoe Perches	$typeOtherOSTypedefs\b|
449e6176fa4SJoe Perches	$typeKernelTypedefs\b
450e6176fa4SJoe Perches)};
4518ed22cadSAndy Whitcroft
4526d32f7a3SJoe Perchesour $zero_initializer = qr{(?:(?:0[xX])?0+$Int_type?|NULL|false)\b};
4536d32f7a3SJoe Perches
454691e669bSJoe Perchesour $logFunctions = qr{(?x:
455758d7aadSMiles Chen	printk(?:_ratelimited|_once|_deferred_once|_deferred|)|
4567d0b6594SJacob Keller	(?:[a-z0-9]+_){1,2}(?:printk|emerg|alert|crit|err|warning|warn|notice|info|debug|dbg|vdbg|devel|cont|WARN)(?:_ratelimited|_once|)|
45787bd499aSJoe Perches	TP_printk|
4586e60c02eSJoe Perches	WARN(?:_RATELIMIT|_ONCE|)|
459b0531722SJoe Perches	panic|
46006668727SJoe Perches	MODULE_[A-Z_]+|
46106668727SJoe Perches	seq_vprintf|seq_printf|seq_puts
462691e669bSJoe Perches)};
463691e669bSJoe Perches
46420112475SJoe Perchesour $signature_tags = qr{(?xi:
46520112475SJoe Perches	Signed-off-by:|
46620112475SJoe Perches	Acked-by:|
46720112475SJoe Perches	Tested-by:|
46820112475SJoe Perches	Reviewed-by:|
46920112475SJoe Perches	Reported-by:|
4708543ae12SMugunthan V N	Suggested-by:|
47120112475SJoe Perches	To:|
47220112475SJoe Perches	Cc:
47320112475SJoe Perches)};
47420112475SJoe Perches
4751813087dSJoe Perchesour @typeListMisordered = (
4761813087dSJoe Perches	qr{char\s+(?:un)?signed},
4771813087dSJoe Perches	qr{int\s+(?:(?:un)?signed\s+)?short\s},
4781813087dSJoe Perches	qr{int\s+short(?:\s+(?:un)?signed)},
4791813087dSJoe Perches	qr{short\s+int(?:\s+(?:un)?signed)},
4801813087dSJoe Perches	qr{(?:un)?signed\s+int\s+short},
4811813087dSJoe Perches	qr{short\s+(?:un)?signed},
4821813087dSJoe Perches	qr{long\s+int\s+(?:un)?signed},
4831813087dSJoe Perches	qr{int\s+long\s+(?:un)?signed},
4841813087dSJoe Perches	qr{long\s+(?:un)?signed\s+int},
4851813087dSJoe Perches	qr{int\s+(?:un)?signed\s+long},
4861813087dSJoe Perches	qr{int\s+(?:un)?signed},
4871813087dSJoe Perches	qr{int\s+long\s+long\s+(?:un)?signed},
4881813087dSJoe Perches	qr{long\s+long\s+int\s+(?:un)?signed},
4891813087dSJoe Perches	qr{long\s+long\s+(?:un)?signed\s+int},
4901813087dSJoe Perches	qr{long\s+long\s+(?:un)?signed},
4911813087dSJoe Perches	qr{long\s+(?:un)?signed},
4921813087dSJoe Perches);
4931813087dSJoe Perches
4948905a67cSAndy Whitcroftour @typeList = (
4958905a67cSAndy Whitcroft	qr{void},
4960c773d9dSJoe Perches	qr{(?:(?:un)?signed\s+)?char},
4970c773d9dSJoe Perches	qr{(?:(?:un)?signed\s+)?short\s+int},
4980c773d9dSJoe Perches	qr{(?:(?:un)?signed\s+)?short},
4990c773d9dSJoe Perches	qr{(?:(?:un)?signed\s+)?int},
5000c773d9dSJoe Perches	qr{(?:(?:un)?signed\s+)?long\s+int},
5010c773d9dSJoe Perches	qr{(?:(?:un)?signed\s+)?long\s+long\s+int},
5020c773d9dSJoe Perches	qr{(?:(?:un)?signed\s+)?long\s+long},
5030c773d9dSJoe Perches	qr{(?:(?:un)?signed\s+)?long},
5040c773d9dSJoe Perches	qr{(?:un)?signed},
5058905a67cSAndy Whitcroft	qr{float},
5068905a67cSAndy Whitcroft	qr{double},
5078905a67cSAndy Whitcroft	qr{bool},
5088905a67cSAndy Whitcroft	qr{struct\s+$Ident},
5098905a67cSAndy Whitcroft	qr{union\s+$Ident},
5108905a67cSAndy Whitcroft	qr{enum\s+$Ident},
5118905a67cSAndy Whitcroft	qr{${Ident}_t},
5128905a67cSAndy Whitcroft	qr{${Ident}_handler},
5138905a67cSAndy Whitcroft	qr{${Ident}_handler_fn},
5141813087dSJoe Perches	@typeListMisordered,
5158905a67cSAndy Whitcroft);
516938224b5SJoe Perches
517938224b5SJoe Perchesour $C90_int_types = qr{(?x:
518938224b5SJoe Perches	long\s+long\s+int\s+(?:un)?signed|
519938224b5SJoe Perches	long\s+long\s+(?:un)?signed\s+int|
520938224b5SJoe Perches	long\s+long\s+(?:un)?signed|
521938224b5SJoe Perches	(?:(?:un)?signed\s+)?long\s+long\s+int|
522938224b5SJoe Perches	(?:(?:un)?signed\s+)?long\s+long|
523938224b5SJoe Perches	int\s+long\s+long\s+(?:un)?signed|
524938224b5SJoe Perches	int\s+(?:(?:un)?signed\s+)?long\s+long|
525938224b5SJoe Perches
526938224b5SJoe Perches	long\s+int\s+(?:un)?signed|
527938224b5SJoe Perches	long\s+(?:un)?signed\s+int|
528938224b5SJoe Perches	long\s+(?:un)?signed|
529938224b5SJoe Perches	(?:(?:un)?signed\s+)?long\s+int|
530938224b5SJoe Perches	(?:(?:un)?signed\s+)?long|
531938224b5SJoe Perches	int\s+long\s+(?:un)?signed|
532938224b5SJoe Perches	int\s+(?:(?:un)?signed\s+)?long|
533938224b5SJoe Perches
534938224b5SJoe Perches	int\s+(?:un)?signed|
535938224b5SJoe Perches	(?:(?:un)?signed\s+)?int
536938224b5SJoe Perches)};
537938224b5SJoe Perches
538485ff23eSAlex Dowadour @typeListFile = ();
5398716de38SJoe Perchesour @typeListWithAttr = (
5408716de38SJoe Perches	@typeList,
5418716de38SJoe Perches	qr{struct\s+$InitAttribute\s+$Ident},
5428716de38SJoe Perches	qr{union\s+$InitAttribute\s+$Ident},
5438716de38SJoe Perches);
5448716de38SJoe Perches
545c45dcabdSAndy Whitcroftour @modifierList = (
546c45dcabdSAndy Whitcroft	qr{fastcall},
547c45dcabdSAndy Whitcroft);
548485ff23eSAlex Dowadour @modifierListFile = ();
5498905a67cSAndy Whitcroft
5502435880fSJoe Perchesour @mode_permission_funcs = (
5512435880fSJoe Perches	["module_param", 3],
5522435880fSJoe Perches	["module_param_(?:array|named|string)", 4],
5532435880fSJoe Perches	["module_param_array_named", 5],
5542435880fSJoe Perches	["debugfs_create_(?:file|u8|u16|u32|u64|x8|x16|x32|x64|size_t|atomic_t|bool|blob|regset32|u32_array)", 2],
5552435880fSJoe Perches	["proc_create(?:_data|)", 2],
556459cf0aeSJoe Perches	["(?:CLASS|DEVICE|SENSOR|SENSOR_DEVICE|IIO_DEVICE)_ATTR", 2],
557459cf0aeSJoe Perches	["IIO_DEV_ATTR_[A-Z_]+", 1],
558459cf0aeSJoe Perches	["SENSOR_(?:DEVICE_|)ATTR_2", 2],
559459cf0aeSJoe Perches	["SENSOR_TEMPLATE(?:_2|)", 3],
560459cf0aeSJoe Perches	["__ATTR", 2],
5612435880fSJoe Perches);
5622435880fSJoe Perches
563515a235eSJoe Perches#Create a search pattern for all these functions to speed up a loop below
564515a235eSJoe Perchesour $mode_perms_search = "";
565515a235eSJoe Perchesforeach my $entry (@mode_permission_funcs) {
566515a235eSJoe Perches	$mode_perms_search .= '|' if ($mode_perms_search ne "");
567515a235eSJoe Perches	$mode_perms_search .= $entry->[0];
568515a235eSJoe Perches}
56900180468SJoe Perches$mode_perms_search = "(?:${mode_perms_search})";
570515a235eSJoe Perches
571b392c64fSJoe Perchesour $mode_perms_world_writable = qr{
572b392c64fSJoe Perches	S_IWUGO		|
573b392c64fSJoe Perches	S_IWOTH		|
574b392c64fSJoe Perches	S_IRWXUGO	|
575b392c64fSJoe Perches	S_IALLUGO	|
576b392c64fSJoe Perches	0[0-7][0-7][2367]
577b392c64fSJoe Perches}x;
578b392c64fSJoe Perches
579f90774e1SJoe Perchesour %mode_permission_string_types = (
580f90774e1SJoe Perches	"S_IRWXU" => 0700,
581f90774e1SJoe Perches	"S_IRUSR" => 0400,
582f90774e1SJoe Perches	"S_IWUSR" => 0200,
583f90774e1SJoe Perches	"S_IXUSR" => 0100,
584f90774e1SJoe Perches	"S_IRWXG" => 0070,
585f90774e1SJoe Perches	"S_IRGRP" => 0040,
586f90774e1SJoe Perches	"S_IWGRP" => 0020,
587f90774e1SJoe Perches	"S_IXGRP" => 0010,
588f90774e1SJoe Perches	"S_IRWXO" => 0007,
589f90774e1SJoe Perches	"S_IROTH" => 0004,
590f90774e1SJoe Perches	"S_IWOTH" => 0002,
591f90774e1SJoe Perches	"S_IXOTH" => 0001,
592f90774e1SJoe Perches	"S_IRWXUGO" => 0777,
593f90774e1SJoe Perches	"S_IRUGO" => 0444,
594f90774e1SJoe Perches	"S_IWUGO" => 0222,
595f90774e1SJoe Perches	"S_IXUGO" => 0111,
596f90774e1SJoe Perches);
597f90774e1SJoe Perches
598f90774e1SJoe Perches#Create a search pattern for all these strings to speed up a loop below
599f90774e1SJoe Perchesour $mode_perms_string_search = "";
600f90774e1SJoe Perchesforeach my $entry (keys %mode_permission_string_types) {
601f90774e1SJoe Perches	$mode_perms_string_search .= '|' if ($mode_perms_string_search ne "");
602f90774e1SJoe Perches	$mode_perms_string_search .= $entry;
603f90774e1SJoe Perches}
60400180468SJoe Perchesour $single_mode_perms_string_search = "(?:${mode_perms_string_search})";
60500180468SJoe Perchesour $multi_mode_perms_string_search = qr{
60600180468SJoe Perches	${single_mode_perms_string_search}
60700180468SJoe Perches	(?:\s*\|\s*${single_mode_perms_string_search})*
60800180468SJoe Perches}x;
60900180468SJoe Perches
61000180468SJoe Perchessub perms_to_octal {
61100180468SJoe Perches	my ($string) = @_;
61200180468SJoe Perches
61300180468SJoe Perches	return trim($string) if ($string =~ /^\s*0[0-7]{3,3}\s*$/);
61400180468SJoe Perches
61500180468SJoe Perches	my $val = "";
61600180468SJoe Perches	my $oval = "";
61700180468SJoe Perches	my $to = 0;
61800180468SJoe Perches	my $curpos = 0;
61900180468SJoe Perches	my $lastpos = 0;
62000180468SJoe Perches	while ($string =~ /\b(($single_mode_perms_string_search)\b(?:\s*\|\s*)?\s*)/g) {
62100180468SJoe Perches		$curpos = pos($string);
62200180468SJoe Perches		my $match = $2;
62300180468SJoe Perches		my $omatch = $1;
62400180468SJoe Perches		last if ($lastpos > 0 && ($curpos - length($omatch) != $lastpos));
62500180468SJoe Perches		$lastpos = $curpos;
62600180468SJoe Perches		$to |= $mode_permission_string_types{$match};
62700180468SJoe Perches		$val .= '\s*\|\s*' if ($val ne "");
62800180468SJoe Perches		$val .= $match;
62900180468SJoe Perches		$oval .= $omatch;
63000180468SJoe Perches	}
63100180468SJoe Perches	$oval =~ s/^\s*\|\s*//;
63200180468SJoe Perches	$oval =~ s/\s*\|\s*$//;
63300180468SJoe Perches	return sprintf("%04o", $to);
63400180468SJoe Perches}
635f90774e1SJoe Perches
6367840a94cSWolfram Sangour $allowed_asm_includes = qr{(?x:
6377840a94cSWolfram Sang	irq|
638cdcee686SSergey Ryazanov	memory|
639cdcee686SSergey Ryazanov	time|
640cdcee686SSergey Ryazanov	reboot
6417840a94cSWolfram Sang)};
6427840a94cSWolfram Sang# memory.h: ARM has a custom one
6437840a94cSWolfram Sang
64466b47b4aSKees Cook# Load common spelling mistakes and build regular expression list.
64566b47b4aSKees Cookmy $misspellings;
64666b47b4aSKees Cookmy %spelling_fix;
64736061e38SJoe Perches
64836061e38SJoe Perchesif (open(my $spelling, '<', $spelling_file)) {
64966b47b4aSKees Cook	while (<$spelling>) {
65066b47b4aSKees Cook		my $line = $_;
65166b47b4aSKees Cook
65266b47b4aSKees Cook		$line =~ s/\s*\n?$//g;
65366b47b4aSKees Cook		$line =~ s/^\s*//g;
65466b47b4aSKees Cook
65566b47b4aSKees Cook		next if ($line =~ m/^\s*#/);
65666b47b4aSKees Cook		next if ($line =~ m/^\s*$/);
65766b47b4aSKees Cook
65866b47b4aSKees Cook		my ($suspect, $fix) = split(/\|\|/, $line);
65966b47b4aSKees Cook
66066b47b4aSKees Cook		$spelling_fix{$suspect} = $fix;
66166b47b4aSKees Cook	}
66266b47b4aSKees Cook	close($spelling);
66336061e38SJoe Perches} else {
66436061e38SJoe Perches	warn "No typos will be found - file '$spelling_file': $!\n";
66536061e38SJoe Perches}
66666b47b4aSKees Cook
667ebfd7d62SJoe Perchesif ($codespell) {
668ebfd7d62SJoe Perches	if (open(my $spelling, '<', $codespellfile)) {
669ebfd7d62SJoe Perches		while (<$spelling>) {
670ebfd7d62SJoe Perches			my $line = $_;
671ebfd7d62SJoe Perches
672ebfd7d62SJoe Perches			$line =~ s/\s*\n?$//g;
673ebfd7d62SJoe Perches			$line =~ s/^\s*//g;
674ebfd7d62SJoe Perches
675ebfd7d62SJoe Perches			next if ($line =~ m/^\s*#/);
676ebfd7d62SJoe Perches			next if ($line =~ m/^\s*$/);
677ebfd7d62SJoe Perches			next if ($line =~ m/, disabled/i);
678ebfd7d62SJoe Perches
679ebfd7d62SJoe Perches			$line =~ s/,.*$//;
680ebfd7d62SJoe Perches
681ebfd7d62SJoe Perches			my ($suspect, $fix) = split(/->/, $line);
682ebfd7d62SJoe Perches
683ebfd7d62SJoe Perches			$spelling_fix{$suspect} = $fix;
684ebfd7d62SJoe Perches		}
685ebfd7d62SJoe Perches		close($spelling);
686ebfd7d62SJoe Perches	} else {
687ebfd7d62SJoe Perches		warn "No codespell typos will be found - file '$codespellfile': $!\n";
688ebfd7d62SJoe Perches	}
689ebfd7d62SJoe Perches}
690ebfd7d62SJoe Perches
691ebfd7d62SJoe Perches$misspellings = join("|", sort keys %spelling_fix) if keys %spelling_fix;
692ebfd7d62SJoe Perches
69375ad8c57SJerome Forissiersub read_words {
69475ad8c57SJerome Forissier	my ($wordsRef, $file) = @_;
69575ad8c57SJerome Forissier
69675ad8c57SJerome Forissier	if (open(my $words, '<', $file)) {
69775ad8c57SJerome Forissier		while (<$words>) {
698bf1fa1daSJoe Perches			my $line = $_;
699bf1fa1daSJoe Perches
700bf1fa1daSJoe Perches			$line =~ s/\s*\n?$//g;
701bf1fa1daSJoe Perches			$line =~ s/^\s*//g;
702bf1fa1daSJoe Perches
703bf1fa1daSJoe Perches			next if ($line =~ m/^\s*#/);
704bf1fa1daSJoe Perches			next if ($line =~ m/^\s*$/);
705bf1fa1daSJoe Perches			if ($line =~ /\s/) {
70675ad8c57SJerome Forissier				print("$file: '$line' invalid - ignored\n");
707bf1fa1daSJoe Perches				next;
708bf1fa1daSJoe Perches			}
709bf1fa1daSJoe Perches
71075ad8c57SJerome Forissier			$$wordsRef .= '|' if ($$wordsRef ne "");
71175ad8c57SJerome Forissier			$$wordsRef .= $line;
712bf1fa1daSJoe Perches		}
71375ad8c57SJerome Forissier		close($file);
71475ad8c57SJerome Forissier		return 1;
715bf1fa1daSJoe Perches	}
716bf1fa1daSJoe Perches
71775ad8c57SJerome Forissier	return 0;
71875ad8c57SJerome Forissier}
71975ad8c57SJerome Forissier
72075ad8c57SJerome Forissiermy $const_structs = "";
72175ad8c57SJerome Forissierread_words(\$const_structs, $conststructsfile)
72275ad8c57SJerome Forissier    or warn "No structs that should be const will be found - file '$conststructsfile': $!\n";
72375ad8c57SJerome Forissier
72475ad8c57SJerome Forissiermy $typeOtherTypedefs = "";
72575ad8c57SJerome Forissierif (length($typedefsfile)) {
72675ad8c57SJerome Forissier	read_words(\$typeOtherTypedefs, $typedefsfile)
72775ad8c57SJerome Forissier	    or warn "No additional types will be considered - file '$typedefsfile': $!\n";
72875ad8c57SJerome Forissier}
72975ad8c57SJerome Forissier$typeTypedefs .= '|' . $typeOtherTypedefs if ($typeOtherTypedefs ne "");
73075ad8c57SJerome Forissier
7318905a67cSAndy Whitcroftsub build_types {
732485ff23eSAlex Dowad	my $mods = "(?x:  \n" . join("|\n  ", (@modifierList, @modifierListFile)) . "\n)";
733485ff23eSAlex Dowad	my $all = "(?x:  \n" . join("|\n  ", (@typeList, @typeListFile)) . "\n)";
7341813087dSJoe Perches	my $Misordered = "(?x:  \n" . join("|\n  ", @typeListMisordered) . "\n)";
7358716de38SJoe Perches	my $allWithAttr = "(?x:  \n" . join("|\n  ", @typeListWithAttr) . "\n)";
736c8cb2ca3SAndy Whitcroft	$Modifier	= qr{(?:$Attribute|$Sparse|$mods)};
737ab7e23f3SJoe Perches	$BasicType	= qr{
738ab7e23f3SJoe Perches				(?:$typeTypedefs\b)|
739ab7e23f3SJoe Perches				(?:${all}\b)
740ab7e23f3SJoe Perches		}x;
7418905a67cSAndy Whitcroft	$NonptrType	= qr{
742d2172eb5SAndy Whitcroft			(?:$Modifier\s+|const\s+)*
743cf655043SAndy Whitcroft			(?:
7446b48db24SAndy Whitcroft				(?:typeof|__typeof__)\s*\([^\)]*\)|
7458ed22cadSAndy Whitcroft				(?:$typeTypedefs\b)|
746c45dcabdSAndy Whitcroft				(?:${all}\b)
747cf655043SAndy Whitcroft			)
748c8cb2ca3SAndy Whitcroft			(?:\s+$Modifier|\s+const)*
7498905a67cSAndy Whitcroft		  }x;
7501813087dSJoe Perches	$NonptrTypeMisordered	= qr{
7511813087dSJoe Perches			(?:$Modifier\s+|const\s+)*
7521813087dSJoe Perches			(?:
7531813087dSJoe Perches				(?:${Misordered}\b)
7541813087dSJoe Perches			)
7551813087dSJoe Perches			(?:\s+$Modifier|\s+const)*
7561813087dSJoe Perches		  }x;
7578716de38SJoe Perches	$NonptrTypeWithAttr	= qr{
7588716de38SJoe Perches			(?:$Modifier\s+|const\s+)*
7598716de38SJoe Perches			(?:
7608716de38SJoe Perches				(?:typeof|__typeof__)\s*\([^\)]*\)|
7618716de38SJoe Perches				(?:$typeTypedefs\b)|
7628716de38SJoe Perches				(?:${allWithAttr}\b)
7638716de38SJoe Perches			)
7648716de38SJoe Perches			(?:\s+$Modifier|\s+const)*
7658716de38SJoe Perches		  }x;
7668905a67cSAndy Whitcroft	$Type	= qr{
767c45dcabdSAndy Whitcroft			$NonptrType
7681574a29fSJoe Perches			(?:(?:\s|\*|\[\])+\s*const|(?:\s|\*\s*(?:const\s*)?|\[\])+|(?:\s*\[\s*\])+)?
769c8cb2ca3SAndy Whitcroft			(?:\s+$Inline|\s+$Modifier)*
7708905a67cSAndy Whitcroft		  }x;
7711813087dSJoe Perches	$TypeMisordered	= qr{
7721813087dSJoe Perches			$NonptrTypeMisordered
7731813087dSJoe Perches			(?:(?:\s|\*|\[\])+\s*const|(?:\s|\*\s*(?:const\s*)?|\[\])+|(?:\s*\[\s*\])+)?
7741813087dSJoe Perches			(?:\s+$Inline|\s+$Modifier)*
7751813087dSJoe Perches		  }x;
77691cb5195SJoe Perches	$Declare	= qr{(?:$Storage\s+(?:$Inline\s+)?)?$Type};
7771813087dSJoe Perches	$DeclareMisordered	= qr{(?:$Storage\s+(?:$Inline\s+)?)?$TypeMisordered};
7788905a67cSAndy Whitcroft}
7798905a67cSAndy Whitcroftbuild_types();
7806c72ffaaSAndy Whitcroft
7817d2367afSJoe Perchesour $Typecast	= qr{\s*(\(\s*$NonptrType\s*\)){0,1}\s*};
782d1fe9c09SJoe Perches
783d1fe9c09SJoe Perches# Using $balanced_parens, $LvalOrFunc, or $FuncArg
784d1fe9c09SJoe Perches# requires at least perl version v5.10.0
785d1fe9c09SJoe Perches# Any use must be runtime checked with $^V
786d1fe9c09SJoe Perches
787d1fe9c09SJoe Perchesour $balanced_parens = qr/(\((?:[^\(\)]++|(?-1))*\))/;
7882435880fSJoe Perchesour $LvalOrFunc	= qr{((?:[\&\*]\s*)?$Lval)\s*($balanced_parens{0,1})\s*};
789c0a5c898SJoe Perchesour $FuncArg = qr{$Typecast{0,1}($LvalOrFunc|$Constant|$String)};
7907d2367afSJoe Perches
791f8422308SJoe Perchesour $declaration_macros = qr{(?x:
7923e838b6cSJoe Perches	(?:$Storage\s+)?(?:[A-Z_][A-Z0-9]*_){0,2}(?:DEFINE|DECLARE)(?:_[A-Z0-9]+){1,6}\s*\(|
793fe658f94SSteffen Maier	(?:$Storage\s+)?[HLP]?LIST_HEAD\s*\(|
7943d102fc0SGilad Ben-Yossef	(?:$Storage\s+)?${Type}\s+uninitialized_var\s*\(|
7953d102fc0SGilad Ben-Yossef	(?:SKCIPHER_REQUEST|SHASH_DESC|AHASH_REQUEST)_ON_STACK\s*\(
796f8422308SJoe Perches)};
797f8422308SJoe Perches
7987d2367afSJoe Perchessub deparenthesize {
7997d2367afSJoe Perches	my ($string) = @_;
8007d2367afSJoe Perches	return "" if (!defined($string));
8015b9553abSJoe Perches
8025b9553abSJoe Perches	while ($string =~ /^\s*\(.*\)\s*$/) {
8035b9553abSJoe Perches		$string =~ s@^\s*\(\s*@@;
8045b9553abSJoe Perches		$string =~ s@\s*\)\s*$@@;
8055b9553abSJoe Perches	}
8065b9553abSJoe Perches
8077d2367afSJoe Perches	$string =~ s@\s+@ @g;
8085b9553abSJoe Perches
8097d2367afSJoe Perches	return $string;
8107d2367afSJoe Perches}
8117d2367afSJoe Perches
8123445686aSJoe Perchessub seed_camelcase_file {
8133445686aSJoe Perches	my ($file) = @_;
8143445686aSJoe Perches
8153445686aSJoe Perches	return if (!(-f $file));
8163445686aSJoe Perches
8173445686aSJoe Perches	local $/;
8183445686aSJoe Perches
8193445686aSJoe Perches	open(my $include_file, '<', "$file")
8203445686aSJoe Perches	    or warn "$P: Can't read '$file' $!\n";
8213445686aSJoe Perches	my $text = <$include_file>;
8223445686aSJoe Perches	close($include_file);
8233445686aSJoe Perches
8243445686aSJoe Perches	my @lines = split('\n', $text);
8253445686aSJoe Perches
8263445686aSJoe Perches	foreach my $line (@lines) {
8273445686aSJoe Perches		next if ($line !~ /(?:[A-Z][a-z]|[a-z][A-Z])/);
8283445686aSJoe Perches		if ($line =~ /^[ \t]*(?:#[ \t]*define|typedef\s+$Type)\s+(\w*(?:[A-Z][a-z]|[a-z][A-Z])\w*)/) {
8293445686aSJoe Perches			$camelcase{$1} = 1;
83011ea516aSJoe Perches		} elsif ($line =~ /^\s*$Declare\s+(\w*(?:[A-Z][a-z]|[a-z][A-Z])\w*)\s*[\(\[,;]/) {
83111ea516aSJoe Perches			$camelcase{$1} = 1;
83211ea516aSJoe Perches		} elsif ($line =~ /^\s*(?:union|struct|enum)\s+(\w*(?:[A-Z][a-z]|[a-z][A-Z])\w*)\s*[;\{]/) {
8333445686aSJoe Perches			$camelcase{$1} = 1;
8343445686aSJoe Perches		}
8353445686aSJoe Perches	}
8363445686aSJoe Perches}
8373445686aSJoe Perches
83885b0ee18SJoe Perchessub is_maintained_obsolete {
83985b0ee18SJoe Perches	my ($filename) = @_;
84085b0ee18SJoe Perches
841f2c19c2fSJerome Forissier	return 0 if (!$tree || !(-e "$root/scripts/get_maintainer.pl"));
84285b0ee18SJoe Perches
8430616efa4SJoe Perches	my $status = `perl $root/scripts/get_maintainer.pl --status --nom --nol --nogit --nogit-fallback -f $filename 2>&1`;
84485b0ee18SJoe Perches
84585b0ee18SJoe Perches	return $status =~ /obsolete/i;
84685b0ee18SJoe Perches}
84785b0ee18SJoe Perches
8483445686aSJoe Perchesmy $camelcase_seeded = 0;
8493445686aSJoe Perchessub seed_camelcase_includes {
8503445686aSJoe Perches	return if ($camelcase_seeded);
8513445686aSJoe Perches
8523445686aSJoe Perches	my $files;
853c707a81dSJoe Perches	my $camelcase_cache = "";
854c707a81dSJoe Perches	my @include_files = ();
855c707a81dSJoe Perches
856c707a81dSJoe Perches	$camelcase_seeded = 1;
857351b2a1fSJoe Perches
8583645e328SRichard Genoud	if (-e ".git") {
859351b2a1fSJoe Perches		my $git_last_include_commit = `git log --no-merges --pretty=format:"%h%n" -1 -- include`;
860351b2a1fSJoe Perches		chomp $git_last_include_commit;
861c707a81dSJoe Perches		$camelcase_cache = ".checkpatch-camelcase.git.$git_last_include_commit";
862c707a81dSJoe Perches	} else {
863c707a81dSJoe Perches		my $last_mod_date = 0;
864c707a81dSJoe Perches		$files = `find $root/include -name "*.h"`;
865c707a81dSJoe Perches		@include_files = split('\n', $files);
866c707a81dSJoe Perches		foreach my $file (@include_files) {
867c707a81dSJoe Perches			my $date = POSIX::strftime("%Y%m%d%H%M",
868c707a81dSJoe Perches						   localtime((stat $file)[9]));
869c707a81dSJoe Perches			$last_mod_date = $date if ($last_mod_date < $date);
870c707a81dSJoe Perches		}
871c707a81dSJoe Perches		$camelcase_cache = ".checkpatch-camelcase.date.$last_mod_date";
872c707a81dSJoe Perches	}
873c707a81dSJoe Perches
874c707a81dSJoe Perches	if ($camelcase_cache ne "" && -f $camelcase_cache) {
875c707a81dSJoe Perches		open(my $camelcase_file, '<', "$camelcase_cache")
876c707a81dSJoe Perches		    or warn "$P: Can't read '$camelcase_cache' $!\n";
877351b2a1fSJoe Perches		while (<$camelcase_file>) {
878351b2a1fSJoe Perches			chomp;
879351b2a1fSJoe Perches			$camelcase{$_} = 1;
880351b2a1fSJoe Perches		}
881351b2a1fSJoe Perches		close($camelcase_file);
882351b2a1fSJoe Perches
883351b2a1fSJoe Perches		return;
884351b2a1fSJoe Perches	}
885c707a81dSJoe Perches
8863645e328SRichard Genoud	if (-e ".git") {
887c707a81dSJoe Perches		$files = `git ls-files "include/*.h"`;
888c707a81dSJoe Perches		@include_files = split('\n', $files);
8893445686aSJoe Perches	}
890c707a81dSJoe Perches
8913445686aSJoe Perches	foreach my $file (@include_files) {
8923445686aSJoe Perches		seed_camelcase_file($file);
8933445686aSJoe Perches	}
894351b2a1fSJoe Perches
895c707a81dSJoe Perches	if ($camelcase_cache ne "") {
896351b2a1fSJoe Perches		unlink glob ".checkpatch-camelcase.*";
897c707a81dSJoe Perches		open(my $camelcase_file, '>', "$camelcase_cache")
898c707a81dSJoe Perches		    or warn "$P: Can't write '$camelcase_cache' $!\n";
899351b2a1fSJoe Perches		foreach (sort { lc($a) cmp lc($b) } keys(%camelcase)) {
900351b2a1fSJoe Perches			print $camelcase_file ("$_\n");
901351b2a1fSJoe Perches		}
902351b2a1fSJoe Perches		close($camelcase_file);
903351b2a1fSJoe Perches	}
9043445686aSJoe Perches}
9053445686aSJoe Perches
906d311cd44SJoe Perchessub git_commit_info {
907d311cd44SJoe Perches	my ($commit, $id, $desc) = @_;
908d311cd44SJoe Perches
909d311cd44SJoe Perches	return ($id, $desc) if ((which("git") eq "") || !(-e ".git"));
910d311cd44SJoe Perches
911d311cd44SJoe Perches	my $output = `git log --no-color --format='%H %s' -1 $commit 2>&1`;
912d311cd44SJoe Perches	$output =~ s/^\s*//gm;
913d311cd44SJoe Perches	my @lines = split("\n", $output);
914d311cd44SJoe Perches
9150d7835fcSJoe Perches	return ($id, $desc) if ($#lines < 0);
9160d7835fcSJoe Perches
917d311cd44SJoe Perches	if ($lines[0] =~ /^error: short SHA1 $commit is ambiguous\./) {
918d311cd44SJoe Perches# Maybe one day convert this block of bash into something that returns
919d311cd44SJoe Perches# all matching commit ids, but it's very slow...
920d311cd44SJoe Perches#
921d311cd44SJoe Perches#		echo "checking commits $1..."
922d311cd44SJoe Perches#		git rev-list --remotes | grep -i "^$1" |
923d311cd44SJoe Perches#		while read line ; do
924d311cd44SJoe Perches#		    git log --format='%H %s' -1 $line |
925d311cd44SJoe Perches#		    echo "commit $(cut -c 1-12,41-)"
926d311cd44SJoe Perches#		done
927d311cd44SJoe Perches	} elsif ($lines[0] =~ /^fatal: ambiguous argument '$commit': unknown revision or path not in the working tree\./) {
928948b133aSHeinrich Schuchardt		$id = undef;
929d311cd44SJoe Perches	} else {
930d311cd44SJoe Perches		$id = substr($lines[0], 0, 12);
931d311cd44SJoe Perches		$desc = substr($lines[0], 41);
932d311cd44SJoe Perches	}
933d311cd44SJoe Perches
934d311cd44SJoe Perches	return ($id, $desc);
935d311cd44SJoe Perches}
936d311cd44SJoe Perches
9376c72ffaaSAndy Whitcroft$chk_signoff = 0 if ($file);
9380a920b5bSAndy Whitcroft
93900df344fSAndy Whitcroftmy @rawlines = ();
940c2fdda0dSAndy Whitcroftmy @lines = ();
9413705ce5bSJoe Perchesmy @fixed = ();
942d752fcc8SJoe Perchesmy @fixed_inserted = ();
943d752fcc8SJoe Perchesmy @fixed_deleted = ();
944194f66fcSJoe Perchesmy $fixlinenr = -1;
945194f66fcSJoe Perches
9464a593c34SDu, Changbin# If input is git commits, extract all commits from the commit expressions.
9474a593c34SDu, Changbin# For example, HEAD-3 means we need check 'HEAD, HEAD~1, HEAD~2'.
9484a593c34SDu, Changbindie "$P: No git repository found\n" if ($git && !-e ".git");
9494a593c34SDu, Changbin
9504a593c34SDu, Changbinif ($git) {
9514a593c34SDu, Changbin	my @commits = ();
9520dea9f1eSJoe Perches	foreach my $commit_expr (@ARGV) {
9534a593c34SDu, Changbin		my $git_range;
95428898fd1SJoe Perches		if ($commit_expr =~ m/^(.*)-(\d+)$/) {
95528898fd1SJoe Perches			$git_range = "-$2 $1";
9564a593c34SDu, Changbin		} elsif ($commit_expr =~ m/\.\./) {
9574a593c34SDu, Changbin			$git_range = "$commit_expr";
9584a593c34SDu, Changbin		} else {
9590dea9f1eSJoe Perches			$git_range = "-1 $commit_expr";
9600dea9f1eSJoe Perches		}
9610dea9f1eSJoe Perches		my $lines = `git log --no-color --no-merges --pretty=format:'%H %s' $git_range`;
9620dea9f1eSJoe Perches		foreach my $line (split(/\n/, $lines)) {
96328898fd1SJoe Perches			$line =~ /^([0-9a-fA-F]{40,40}) (.*)$/;
96428898fd1SJoe Perches			next if (!defined($1) || !defined($2));
9650dea9f1eSJoe Perches			my $sha1 = $1;
9660dea9f1eSJoe Perches			my $subject = $2;
9670dea9f1eSJoe Perches			unshift(@commits, $sha1);
9680dea9f1eSJoe Perches			$git_commits{$sha1} = $subject;
9694a593c34SDu, Changbin		}
9704a593c34SDu, Changbin	}
9714a593c34SDu, Changbin	die "$P: no git commits after extraction!\n" if (@commits == 0);
9724a593c34SDu, Changbin	@ARGV = @commits;
9734a593c34SDu, Changbin}
9744a593c34SDu, Changbin
975c2fdda0dSAndy Whitcroftmy $vname;
9766c72ffaaSAndy Whitcroftfor my $filename (@ARGV) {
97721caa13cSAndy Whitcroft	my $FILE;
9784a593c34SDu, Changbin	if ($git) {
9794a593c34SDu, Changbin		open($FILE, '-|', "git format-patch -M --stdout -1 $filename") ||
9804a593c34SDu, Changbin			die "$P: $filename: git format-patch failed - $!\n";
9814a593c34SDu, Changbin	} elsif ($file) {
98221caa13cSAndy Whitcroft		open($FILE, '-|', "diff -u /dev/null $filename") ||
9836c72ffaaSAndy Whitcroft			die "$P: $filename: diff failed - $!\n";
98421caa13cSAndy Whitcroft	} elsif ($filename eq '-') {
98521caa13cSAndy Whitcroft		open($FILE, '<&STDIN');
9866c72ffaaSAndy Whitcroft	} else {
98721caa13cSAndy Whitcroft		open($FILE, '<', "$filename") ||
9886c72ffaaSAndy Whitcroft			die "$P: $filename: open failed - $!\n";
9896c72ffaaSAndy Whitcroft	}
990c2fdda0dSAndy Whitcroft	if ($filename eq '-') {
991c2fdda0dSAndy Whitcroft		$vname = 'Your patch';
9924a593c34SDu, Changbin	} elsif ($git) {
9930dea9f1eSJoe Perches		$vname = "Commit " . substr($filename, 0, 12) . ' ("' . $git_commits{$filename} . '")';
994c2fdda0dSAndy Whitcroft	} else {
995c2fdda0dSAndy Whitcroft		$vname = $filename;
996c2fdda0dSAndy Whitcroft	}
99721caa13cSAndy Whitcroft	while (<$FILE>) {
9980a920b5bSAndy Whitcroft		chomp;
99900df344fSAndy Whitcroft		push(@rawlines, $_);
10006c72ffaaSAndy Whitcroft	}
100121caa13cSAndy Whitcroft	close($FILE);
1002d8469f16SJoe Perches
1003d8469f16SJoe Perches	if ($#ARGV > 0 && $quiet == 0) {
1004d8469f16SJoe Perches		print '-' x length($vname) . "\n";
1005d8469f16SJoe Perches		print "$vname\n";
1006d8469f16SJoe Perches		print '-' x length($vname) . "\n";
1007d8469f16SJoe Perches	}
1008d8469f16SJoe Perches
1009c2fdda0dSAndy Whitcroft	if (!process($filename)) {
10100a920b5bSAndy Whitcroft		$exit = 1;
10110a920b5bSAndy Whitcroft	}
101200df344fSAndy Whitcroft	@rawlines = ();
101313214adfSAndy Whitcroft	@lines = ();
10143705ce5bSJoe Perches	@fixed = ();
1015d752fcc8SJoe Perches	@fixed_inserted = ();
1016d752fcc8SJoe Perches	@fixed_deleted = ();
1017194f66fcSJoe Perches	$fixlinenr = -1;
1018485ff23eSAlex Dowad	@modifierListFile = ();
1019485ff23eSAlex Dowad	@typeListFile = ();
1020485ff23eSAlex Dowad	build_types();
10210a920b5bSAndy Whitcroft}
10220a920b5bSAndy Whitcroft
1023d8469f16SJoe Perchesif (!$quiet) {
10243c816e49SJoe Perches	hash_show_words(\%use_type, "Used");
10253c816e49SJoe Perches	hash_show_words(\%ignore_type, "Ignored");
10263c816e49SJoe Perches
1027d8469f16SJoe Perches	if ($^V lt 5.10.0) {
1028d8469f16SJoe Perches		print << "EOM"
1029d8469f16SJoe Perches
1030d8469f16SJoe PerchesNOTE: perl $^V is not modern enough to detect all possible issues.
1031d8469f16SJoe Perches      An upgrade to at least perl v5.10.0 is suggested.
1032d8469f16SJoe PerchesEOM
1033d8469f16SJoe Perches	}
1034d8469f16SJoe Perches	if ($exit) {
1035d8469f16SJoe Perches		print << "EOM"
1036d8469f16SJoe Perches
1037d8469f16SJoe PerchesNOTE: If any of the errors are false positives, please report
1038d8469f16SJoe Perches      them to the maintainer, see CHECKPATCH in MAINTAINERS.
1039d8469f16SJoe PerchesEOM
1040d8469f16SJoe Perches	}
1041d8469f16SJoe Perches}
1042d8469f16SJoe Perches
10430a920b5bSAndy Whitcroftexit($exit);
10440a920b5bSAndy Whitcroft
10450a920b5bSAndy Whitcroftsub top_of_kernel_tree {
10466c72ffaaSAndy Whitcroft	my ($root) = @_;
10476c72ffaaSAndy Whitcroft
10486c72ffaaSAndy Whitcroft	my @tree_check = (
10496c72ffaaSAndy Whitcroft		"COPYING", "CREDITS", "Kbuild", "MAINTAINERS", "Makefile",
10506c72ffaaSAndy Whitcroft		"README", "Documentation", "arch", "include", "drivers",
10516c72ffaaSAndy Whitcroft		"fs", "init", "ipc", "kernel", "lib", "scripts",
10526c72ffaaSAndy Whitcroft	);
10536c72ffaaSAndy Whitcroft
10546c72ffaaSAndy Whitcroft	foreach my $check (@tree_check) {
10556c72ffaaSAndy Whitcroft		if (! -e $root . '/' . $check) {
10560a920b5bSAndy Whitcroft			return 0;
10570a920b5bSAndy Whitcroft		}
10586c72ffaaSAndy Whitcroft	}
10596c72ffaaSAndy Whitcroft	return 1;
10606c72ffaaSAndy Whitcroft}
10610a920b5bSAndy Whitcroft
106220112475SJoe Perchessub parse_email {
106320112475SJoe Perches	my ($formatted_email) = @_;
106420112475SJoe Perches
106520112475SJoe Perches	my $name = "";
106620112475SJoe Perches	my $address = "";
106720112475SJoe Perches	my $comment = "";
106820112475SJoe Perches
106920112475SJoe Perches	if ($formatted_email =~ /^(.*)<(\S+\@\S+)>(.*)$/) {
107020112475SJoe Perches		$name = $1;
107120112475SJoe Perches		$address = $2;
107220112475SJoe Perches		$comment = $3 if defined $3;
107320112475SJoe Perches	} elsif ($formatted_email =~ /^\s*<(\S+\@\S+)>(.*)$/) {
107420112475SJoe Perches		$address = $1;
107520112475SJoe Perches		$comment = $2 if defined $2;
107620112475SJoe Perches	} elsif ($formatted_email =~ /(\S+\@\S+)(.*)$/) {
107720112475SJoe Perches		$address = $1;
107820112475SJoe Perches		$comment = $2 if defined $2;
107985e12066SJoe Perches		$formatted_email =~ s/\Q$address\E.*$//;
108020112475SJoe Perches		$name = $formatted_email;
10813705ce5bSJoe Perches		$name = trim($name);
108220112475SJoe Perches		$name =~ s/^\"|\"$//g;
108320112475SJoe Perches		# If there's a name left after stripping spaces and
108420112475SJoe Perches		# leading quotes, and the address doesn't have both
108520112475SJoe Perches		# leading and trailing angle brackets, the address
108620112475SJoe Perches		# is invalid. ie:
108720112475SJoe Perches		#   "joe smith [email protected]" bad
108820112475SJoe Perches		#   "joe smith <[email protected]" bad
108920112475SJoe Perches		if ($name ne "" && $address !~ /^<[^>]+>$/) {
109020112475SJoe Perches			$name = "";
109120112475SJoe Perches			$address = "";
109220112475SJoe Perches			$comment = "";
109320112475SJoe Perches		}
109420112475SJoe Perches	}
109520112475SJoe Perches
10963705ce5bSJoe Perches	$name = trim($name);
109720112475SJoe Perches	$name =~ s/^\"|\"$//g;
10983705ce5bSJoe Perches	$address = trim($address);
109920112475SJoe Perches	$address =~ s/^\<|\>$//g;
110020112475SJoe Perches
110120112475SJoe Perches	if ($name =~ /[^\w \-]/i) { ##has "must quote" chars
110220112475SJoe Perches		$name =~ s/(?<!\\)"/\\"/g; ##escape quotes
110320112475SJoe Perches		$name = "\"$name\"";
110420112475SJoe Perches	}
110520112475SJoe Perches
110620112475SJoe Perches	return ($name, $address, $comment);
110720112475SJoe Perches}
110820112475SJoe Perches
110920112475SJoe Perchessub format_email {
111020112475SJoe Perches	my ($name, $address) = @_;
111120112475SJoe Perches
111220112475SJoe Perches	my $formatted_email;
111320112475SJoe Perches
11143705ce5bSJoe Perches	$name = trim($name);
111520112475SJoe Perches	$name =~ s/^\"|\"$//g;
11163705ce5bSJoe Perches	$address = trim($address);
111720112475SJoe Perches
111820112475SJoe Perches	if ($name =~ /[^\w \-]/i) { ##has "must quote" chars
111920112475SJoe Perches		$name =~ s/(?<!\\)"/\\"/g; ##escape quotes
112020112475SJoe Perches		$name = "\"$name\"";
112120112475SJoe Perches	}
112220112475SJoe Perches
112320112475SJoe Perches	if ("$name" eq "") {
112420112475SJoe Perches		$formatted_email = "$address";
112520112475SJoe Perches	} else {
112620112475SJoe Perches		$formatted_email = "$name <$address>";
112720112475SJoe Perches	}
112820112475SJoe Perches
112920112475SJoe Perches	return $formatted_email;
113020112475SJoe Perches}
113120112475SJoe Perches
1132d311cd44SJoe Perchessub which {
1133d311cd44SJoe Perches	my ($bin) = @_;
1134d311cd44SJoe Perches
1135d311cd44SJoe Perches	foreach my $path (split(/:/, $ENV{PATH})) {
1136d311cd44SJoe Perches		if (-e "$path/$bin") {
1137d311cd44SJoe Perches			return "$path/$bin";
1138d311cd44SJoe Perches		}
1139d311cd44SJoe Perches	}
1140d311cd44SJoe Perches
1141d311cd44SJoe Perches	return "";
1142d311cd44SJoe Perches}
1143d311cd44SJoe Perches
1144000d1cc1SJoe Perchessub which_conf {
1145000d1cc1SJoe Perches	my ($conf) = @_;
1146000d1cc1SJoe Perches
1147000d1cc1SJoe Perches	foreach my $path (split(/:/, ".:$ENV{HOME}:.scripts")) {
1148000d1cc1SJoe Perches		if (-e "$path/$conf") {
1149000d1cc1SJoe Perches			return "$path/$conf";
1150000d1cc1SJoe Perches		}
1151000d1cc1SJoe Perches	}
1152000d1cc1SJoe Perches
1153000d1cc1SJoe Perches	return "";
1154000d1cc1SJoe Perches}
1155000d1cc1SJoe Perches
11560a920b5bSAndy Whitcroftsub expand_tabs {
11570a920b5bSAndy Whitcroft	my ($str) = @_;
11580a920b5bSAndy Whitcroft
11590a920b5bSAndy Whitcroft	my $res = '';
11600a920b5bSAndy Whitcroft	my $n = 0;
11610a920b5bSAndy Whitcroft	for my $c (split(//, $str)) {
11620a920b5bSAndy Whitcroft		if ($c eq "\t") {
11630a920b5bSAndy Whitcroft			$res .= ' ';
11640a920b5bSAndy Whitcroft			$n++;
11650a920b5bSAndy Whitcroft			for (; ($n % 8) != 0; $n++) {
11660a920b5bSAndy Whitcroft				$res .= ' ';
11670a920b5bSAndy Whitcroft			}
11680a920b5bSAndy Whitcroft			next;
11690a920b5bSAndy Whitcroft		}
11700a920b5bSAndy Whitcroft		$res .= $c;
11710a920b5bSAndy Whitcroft		$n++;
11720a920b5bSAndy Whitcroft	}
11730a920b5bSAndy Whitcroft
11740a920b5bSAndy Whitcroft	return $res;
11750a920b5bSAndy Whitcroft}
11766c72ffaaSAndy Whitcroftsub copy_spacing {
1177773647a0SAndy Whitcroft	(my $res = shift) =~ tr/\t/ /c;
11786c72ffaaSAndy Whitcroft	return $res;
11796c72ffaaSAndy Whitcroft}
11800a920b5bSAndy Whitcroft
11814a0df2efSAndy Whitcroftsub line_stats {
11824a0df2efSAndy Whitcroft	my ($line) = @_;
11834a0df2efSAndy Whitcroft
11844a0df2efSAndy Whitcroft	# Drop the diff line leader and expand tabs
11854a0df2efSAndy Whitcroft	$line =~ s/^.//;
11864a0df2efSAndy Whitcroft	$line = expand_tabs($line);
11874a0df2efSAndy Whitcroft
11884a0df2efSAndy Whitcroft	# Pick the indent from the front of the line.
11894a0df2efSAndy Whitcroft	my ($white) = ($line =~ /^(\s*)/);
11904a0df2efSAndy Whitcroft
11914a0df2efSAndy Whitcroft	return (length($line), length($white));
11924a0df2efSAndy Whitcroft}
11934a0df2efSAndy Whitcroft
1194773647a0SAndy Whitcroftmy $sanitise_quote = '';
1195773647a0SAndy Whitcroft
1196773647a0SAndy Whitcroftsub sanitise_line_reset {
1197773647a0SAndy Whitcroft	my ($in_comment) = @_;
1198773647a0SAndy Whitcroft
1199773647a0SAndy Whitcroft	if ($in_comment) {
1200773647a0SAndy Whitcroft		$sanitise_quote = '*/';
1201773647a0SAndy Whitcroft	} else {
1202773647a0SAndy Whitcroft		$sanitise_quote = '';
1203773647a0SAndy Whitcroft	}
1204773647a0SAndy Whitcroft}
120500df344fSAndy Whitcroftsub sanitise_line {
120600df344fSAndy Whitcroft	my ($line) = @_;
120700df344fSAndy Whitcroft
120800df344fSAndy Whitcroft	my $res = '';
120900df344fSAndy Whitcroft	my $l = '';
121000df344fSAndy Whitcroft
1211c2fdda0dSAndy Whitcroft	my $qlen = 0;
1212773647a0SAndy Whitcroft	my $off = 0;
1213773647a0SAndy Whitcroft	my $c;
121400df344fSAndy Whitcroft
1215773647a0SAndy Whitcroft	# Always copy over the diff marker.
1216773647a0SAndy Whitcroft	$res = substr($line, 0, 1);
1217773647a0SAndy Whitcroft
1218773647a0SAndy Whitcroft	for ($off = 1; $off < length($line); $off++) {
1219773647a0SAndy Whitcroft		$c = substr($line, $off, 1);
1220773647a0SAndy Whitcroft
1221*8d2e11b2SClaudio Fontana		# Comments we are whacking completely including the begin
1222773647a0SAndy Whitcroft		# and end, all to $;.
1223773647a0SAndy Whitcroft		if ($sanitise_quote eq '' && substr($line, $off, 2) eq '/*') {
1224773647a0SAndy Whitcroft			$sanitise_quote = '*/';
1225773647a0SAndy Whitcroft
1226773647a0SAndy Whitcroft			substr($res, $off, 2, "$;$;");
1227773647a0SAndy Whitcroft			$off++;
122800df344fSAndy Whitcroft			next;
1229773647a0SAndy Whitcroft		}
123081bc0e02SAndy Whitcroft		if ($sanitise_quote eq '*/' && substr($line, $off, 2) eq '*/') {
1231773647a0SAndy Whitcroft			$sanitise_quote = '';
1232773647a0SAndy Whitcroft			substr($res, $off, 2, "$;$;");
1233773647a0SAndy Whitcroft			$off++;
1234773647a0SAndy Whitcroft			next;
1235773647a0SAndy Whitcroft		}
1236113f04a8SDaniel Walker		if ($sanitise_quote eq '' && substr($line, $off, 2) eq '//') {
1237113f04a8SDaniel Walker			$sanitise_quote = '//';
1238113f04a8SDaniel Walker
1239113f04a8SDaniel Walker			substr($res, $off, 2, $sanitise_quote);
1240113f04a8SDaniel Walker			$off++;
1241113f04a8SDaniel Walker			next;
1242113f04a8SDaniel Walker		}
1243773647a0SAndy Whitcroft
1244773647a0SAndy Whitcroft		# A \ in a string means ignore the next character.
1245773647a0SAndy Whitcroft		if (($sanitise_quote eq "'" || $sanitise_quote eq '"') &&
1246773647a0SAndy Whitcroft		    $c eq "\\") {
1247773647a0SAndy Whitcroft			substr($res, $off, 2, 'XX');
1248773647a0SAndy Whitcroft			$off++;
1249773647a0SAndy Whitcroft			next;
1250773647a0SAndy Whitcroft		}
1251773647a0SAndy Whitcroft		# Regular quotes.
1252773647a0SAndy Whitcroft		if ($c eq "'" || $c eq '"') {
1253773647a0SAndy Whitcroft			if ($sanitise_quote eq '') {
1254773647a0SAndy Whitcroft				$sanitise_quote = $c;
1255773647a0SAndy Whitcroft
1256773647a0SAndy Whitcroft				substr($res, $off, 1, $c);
1257773647a0SAndy Whitcroft				next;
1258773647a0SAndy Whitcroft			} elsif ($sanitise_quote eq $c) {
1259773647a0SAndy Whitcroft				$sanitise_quote = '';
126000df344fSAndy Whitcroft			}
126100df344fSAndy Whitcroft		}
1262773647a0SAndy Whitcroft
1263fae17daeSAndy Whitcroft		#print "c<$c> SQ<$sanitise_quote>\n";
1264773647a0SAndy Whitcroft		if ($off != 0 && $sanitise_quote eq '*/' && $c ne "\t") {
1265773647a0SAndy Whitcroft			substr($res, $off, 1, $;);
1266113f04a8SDaniel Walker		} elsif ($off != 0 && $sanitise_quote eq '//' && $c ne "\t") {
1267113f04a8SDaniel Walker			substr($res, $off, 1, $;);
1268773647a0SAndy Whitcroft		} elsif ($off != 0 && $sanitise_quote && $c ne "\t") {
1269773647a0SAndy Whitcroft			substr($res, $off, 1, 'X');
127000df344fSAndy Whitcroft		} else {
1271773647a0SAndy Whitcroft			substr($res, $off, 1, $c);
127200df344fSAndy Whitcroft		}
1273c2fdda0dSAndy Whitcroft	}
1274c2fdda0dSAndy Whitcroft
1275113f04a8SDaniel Walker	if ($sanitise_quote eq '//') {
1276113f04a8SDaniel Walker		$sanitise_quote = '';
1277113f04a8SDaniel Walker	}
1278113f04a8SDaniel Walker
1279c2fdda0dSAndy Whitcroft	# The pathname on a #include may be surrounded by '<' and '>'.
1280c45dcabdSAndy Whitcroft	if ($res =~ /^.\s*\#\s*include\s+\<(.*)\>/) {
1281c2fdda0dSAndy Whitcroft		my $clean = 'X' x length($1);
1282c2fdda0dSAndy Whitcroft		$res =~ s@\<.*\>@<$clean>@;
1283c2fdda0dSAndy Whitcroft
1284c2fdda0dSAndy Whitcroft	# The whole of a #error is a string.
1285c45dcabdSAndy Whitcroft	} elsif ($res =~ /^.\s*\#\s*(?:error|warning)\s+(.*)\b/) {
1286c2fdda0dSAndy Whitcroft		my $clean = 'X' x length($1);
1287c45dcabdSAndy Whitcroft		$res =~ s@(\#\s*(?:error|warning)\s+).*@$1$clean@;
1288c2fdda0dSAndy Whitcroft	}
1289c2fdda0dSAndy Whitcroft
1290dadf680dSJoe Perches	if ($allow_c99_comments && $res =~ m@(//.*$)@) {
1291dadf680dSJoe Perches		my $match = $1;
1292dadf680dSJoe Perches		$res =~ s/\Q$match\E/"$;" x length($match)/e;
1293dadf680dSJoe Perches	}
1294dadf680dSJoe Perches
129500df344fSAndy Whitcroft	return $res;
129600df344fSAndy Whitcroft}
129700df344fSAndy Whitcroft
1298a6962d72SJoe Perchessub get_quoted_string {
1299a6962d72SJoe Perches	my ($line, $rawline) = @_;
1300a6962d72SJoe Perches
1301478b1799SJoe Perches	return "" if (!defined($line) || !defined($rawline));
130233acb54aSJoe Perches	return "" if ($line !~ m/($String)/g);
1303a6962d72SJoe Perches	return substr($rawline, $-[0], $+[0] - $-[0]);
1304a6962d72SJoe Perches}
1305a6962d72SJoe Perches
13068905a67cSAndy Whitcroftsub ctx_statement_block {
13078905a67cSAndy Whitcroft	my ($linenr, $remain, $off) = @_;
13088905a67cSAndy Whitcroft	my $line = $linenr - 1;
13098905a67cSAndy Whitcroft	my $blk = '';
13108905a67cSAndy Whitcroft	my $soff = $off;
13118905a67cSAndy Whitcroft	my $coff = $off - 1;
1312773647a0SAndy Whitcroft	my $coff_set = 0;
13138905a67cSAndy Whitcroft
131413214adfSAndy Whitcroft	my $loff = 0;
131513214adfSAndy Whitcroft
13168905a67cSAndy Whitcroft	my $type = '';
13178905a67cSAndy Whitcroft	my $level = 0;
1318a2750645SAndy Whitcroft	my @stack = ();
1319cf655043SAndy Whitcroft	my $p;
13208905a67cSAndy Whitcroft	my $c;
13218905a67cSAndy Whitcroft	my $len = 0;
132213214adfSAndy Whitcroft
132313214adfSAndy Whitcroft	my $remainder;
13248905a67cSAndy Whitcroft	while (1) {
1325a2750645SAndy Whitcroft		@stack = (['', 0]) if ($#stack == -1);
1326a2750645SAndy Whitcroft
1327773647a0SAndy Whitcroft		#warn "CSB: blk<$blk> remain<$remain>\n";
13288905a67cSAndy Whitcroft		# If we are about to drop off the end, pull in more
13298905a67cSAndy Whitcroft		# context.
13308905a67cSAndy Whitcroft		if ($off >= $len) {
13318905a67cSAndy Whitcroft			for (; $remain > 0; $line++) {
1332dea33496SAndy Whitcroft				last if (!defined $lines[$line]);
1333c2fdda0dSAndy Whitcroft				next if ($lines[$line] =~ /^-/);
13348905a67cSAndy Whitcroft				$remain--;
133513214adfSAndy Whitcroft				$loff = $len;
1336c2fdda0dSAndy Whitcroft				$blk .= $lines[$line] . "\n";
13378905a67cSAndy Whitcroft				$len = length($blk);
13388905a67cSAndy Whitcroft				$line++;
13398905a67cSAndy Whitcroft				last;
13408905a67cSAndy Whitcroft			}
13418905a67cSAndy Whitcroft			# Bail if there is no further context.
13428905a67cSAndy Whitcroft			#warn "CSB: blk<$blk> off<$off> len<$len>\n";
134313214adfSAndy Whitcroft			if ($off >= $len) {
13448905a67cSAndy Whitcroft				last;
13458905a67cSAndy Whitcroft			}
1346f74bd194SAndy Whitcroft			if ($level == 0 && substr($blk, $off) =~ /^.\s*#\s*define/) {
1347f74bd194SAndy Whitcroft				$level++;
1348f74bd194SAndy Whitcroft				$type = '#';
1349f74bd194SAndy Whitcroft			}
13508905a67cSAndy Whitcroft		}
1351cf655043SAndy Whitcroft		$p = $c;
13528905a67cSAndy Whitcroft		$c = substr($blk, $off, 1);
135313214adfSAndy Whitcroft		$remainder = substr($blk, $off);
13548905a67cSAndy Whitcroft
1355773647a0SAndy Whitcroft		#warn "CSB: c<$c> type<$type> level<$level> remainder<$remainder> coff_set<$coff_set>\n";
13564635f4fbSAndy Whitcroft
13574635f4fbSAndy Whitcroft		# Handle nested #if/#else.
13584635f4fbSAndy Whitcroft		if ($remainder =~ /^#\s*(?:ifndef|ifdef|if)\s/) {
13594635f4fbSAndy Whitcroft			push(@stack, [ $type, $level ]);
13604635f4fbSAndy Whitcroft		} elsif ($remainder =~ /^#\s*(?:else|elif)\b/) {
13614635f4fbSAndy Whitcroft			($type, $level) = @{$stack[$#stack - 1]};
13624635f4fbSAndy Whitcroft		} elsif ($remainder =~ /^#\s*endif\b/) {
13634635f4fbSAndy Whitcroft			($type, $level) = @{pop(@stack)};
13644635f4fbSAndy Whitcroft		}
13654635f4fbSAndy Whitcroft
13668905a67cSAndy Whitcroft		# Statement ends at the ';' or a close '}' at the
13678905a67cSAndy Whitcroft		# outermost level.
13688905a67cSAndy Whitcroft		if ($level == 0 && $c eq ';') {
13698905a67cSAndy Whitcroft			last;
13708905a67cSAndy Whitcroft		}
13718905a67cSAndy Whitcroft
137213214adfSAndy Whitcroft		# An else is really a conditional as long as its not else if
1373773647a0SAndy Whitcroft		if ($level == 0 && $coff_set == 0 &&
1374773647a0SAndy Whitcroft				(!defined($p) || $p =~ /(?:\s|\}|\+)/) &&
1375773647a0SAndy Whitcroft				$remainder =~ /^(else)(?:\s|{)/ &&
1376773647a0SAndy Whitcroft				$remainder !~ /^else\s+if\b/) {
1377773647a0SAndy Whitcroft			$coff = $off + length($1) - 1;
1378773647a0SAndy Whitcroft			$coff_set = 1;
1379773647a0SAndy Whitcroft			#warn "CSB: mark coff<$coff> soff<$soff> 1<$1>\n";
1380773647a0SAndy Whitcroft			#warn "[" . substr($blk, $soff, $coff - $soff + 1) . "]\n";
138113214adfSAndy Whitcroft		}
138213214adfSAndy Whitcroft
13838905a67cSAndy Whitcroft		if (($type eq '' || $type eq '(') && $c eq '(') {
13848905a67cSAndy Whitcroft			$level++;
13858905a67cSAndy Whitcroft			$type = '(';
13868905a67cSAndy Whitcroft		}
13878905a67cSAndy Whitcroft		if ($type eq '(' && $c eq ')') {
13888905a67cSAndy Whitcroft			$level--;
13898905a67cSAndy Whitcroft			$type = ($level != 0)? '(' : '';
13908905a67cSAndy Whitcroft
13918905a67cSAndy Whitcroft			if ($level == 0 && $coff < $soff) {
13928905a67cSAndy Whitcroft				$coff = $off;
1393773647a0SAndy Whitcroft				$coff_set = 1;
1394773647a0SAndy Whitcroft				#warn "CSB: mark coff<$coff>\n";
13958905a67cSAndy Whitcroft			}
13968905a67cSAndy Whitcroft		}
13978905a67cSAndy Whitcroft		if (($type eq '' || $type eq '{') && $c eq '{') {
13988905a67cSAndy Whitcroft			$level++;
13998905a67cSAndy Whitcroft			$type = '{';
14008905a67cSAndy Whitcroft		}
14018905a67cSAndy Whitcroft		if ($type eq '{' && $c eq '}') {
14028905a67cSAndy Whitcroft			$level--;
14038905a67cSAndy Whitcroft			$type = ($level != 0)? '{' : '';
14048905a67cSAndy Whitcroft
14058905a67cSAndy Whitcroft			if ($level == 0) {
1406b998e001SPatrick Pannuto				if (substr($blk, $off + 1, 1) eq ';') {
1407b998e001SPatrick Pannuto					$off++;
1408b998e001SPatrick Pannuto				}
14098905a67cSAndy Whitcroft				last;
14108905a67cSAndy Whitcroft			}
14118905a67cSAndy Whitcroft		}
1412f74bd194SAndy Whitcroft		# Preprocessor commands end at the newline unless escaped.
1413f74bd194SAndy Whitcroft		if ($type eq '#' && $c eq "\n" && $p ne "\\") {
1414f74bd194SAndy Whitcroft			$level--;
1415f74bd194SAndy Whitcroft			$type = '';
1416f74bd194SAndy Whitcroft			$off++;
1417f74bd194SAndy Whitcroft			last;
1418f74bd194SAndy Whitcroft		}
14198905a67cSAndy Whitcroft		$off++;
14208905a67cSAndy Whitcroft	}
1421a3bb97a7SAndy Whitcroft	# We are truly at the end, so shuffle to the next line.
142213214adfSAndy Whitcroft	if ($off == $len) {
1423a3bb97a7SAndy Whitcroft		$loff = $len + 1;
142413214adfSAndy Whitcroft		$line++;
142513214adfSAndy Whitcroft		$remain--;
142613214adfSAndy Whitcroft	}
14278905a67cSAndy Whitcroft
14288905a67cSAndy Whitcroft	my $statement = substr($blk, $soff, $off - $soff + 1);
14298905a67cSAndy Whitcroft	my $condition = substr($blk, $soff, $coff - $soff + 1);
14308905a67cSAndy Whitcroft
14318905a67cSAndy Whitcroft	#warn "STATEMENT<$statement>\n";
14328905a67cSAndy Whitcroft	#warn "CONDITION<$condition>\n";
14338905a67cSAndy Whitcroft
1434773647a0SAndy Whitcroft	#print "coff<$coff> soff<$off> loff<$loff>\n";
143513214adfSAndy Whitcroft
143613214adfSAndy Whitcroft	return ($statement, $condition,
143713214adfSAndy Whitcroft			$line, $remain + 1, $off - $loff + 1, $level);
143813214adfSAndy Whitcroft}
143913214adfSAndy Whitcroft
1440cf655043SAndy Whitcroftsub statement_lines {
1441cf655043SAndy Whitcroft	my ($stmt) = @_;
1442cf655043SAndy Whitcroft
1443cf655043SAndy Whitcroft	# Strip the diff line prefixes and rip blank lines at start and end.
1444cf655043SAndy Whitcroft	$stmt =~ s/(^|\n)./$1/g;
1445cf655043SAndy Whitcroft	$stmt =~ s/^\s*//;
1446cf655043SAndy Whitcroft	$stmt =~ s/\s*$//;
1447cf655043SAndy Whitcroft
1448cf655043SAndy Whitcroft	my @stmt_lines = ($stmt =~ /\n/g);
1449cf655043SAndy Whitcroft
1450cf655043SAndy Whitcroft	return $#stmt_lines + 2;
1451cf655043SAndy Whitcroft}
1452cf655043SAndy Whitcroft
1453cf655043SAndy Whitcroftsub statement_rawlines {
1454cf655043SAndy Whitcroft	my ($stmt) = @_;
1455cf655043SAndy Whitcroft
1456cf655043SAndy Whitcroft	my @stmt_lines = ($stmt =~ /\n/g);
1457cf655043SAndy Whitcroft
1458cf655043SAndy Whitcroft	return $#stmt_lines + 2;
1459cf655043SAndy Whitcroft}
1460cf655043SAndy Whitcroft
1461cf655043SAndy Whitcroftsub statement_block_size {
1462cf655043SAndy Whitcroft	my ($stmt) = @_;
1463cf655043SAndy Whitcroft
1464cf655043SAndy Whitcroft	$stmt =~ s/(^|\n)./$1/g;
1465cf655043SAndy Whitcroft	$stmt =~ s/^\s*{//;
1466cf655043SAndy Whitcroft	$stmt =~ s/}\s*$//;
1467cf655043SAndy Whitcroft	$stmt =~ s/^\s*//;
1468cf655043SAndy Whitcroft	$stmt =~ s/\s*$//;
1469cf655043SAndy Whitcroft
1470cf655043SAndy Whitcroft	my @stmt_lines = ($stmt =~ /\n/g);
1471cf655043SAndy Whitcroft	my @stmt_statements = ($stmt =~ /;/g);
1472cf655043SAndy Whitcroft
1473cf655043SAndy Whitcroft	my $stmt_lines = $#stmt_lines + 2;
1474cf655043SAndy Whitcroft	my $stmt_statements = $#stmt_statements + 1;
1475cf655043SAndy Whitcroft
1476cf655043SAndy Whitcroft	if ($stmt_lines > $stmt_statements) {
1477cf655043SAndy Whitcroft		return $stmt_lines;
1478cf655043SAndy Whitcroft	} else {
1479cf655043SAndy Whitcroft		return $stmt_statements;
1480cf655043SAndy Whitcroft	}
1481cf655043SAndy Whitcroft}
1482cf655043SAndy Whitcroft
148313214adfSAndy Whitcroftsub ctx_statement_full {
148413214adfSAndy Whitcroft	my ($linenr, $remain, $off) = @_;
148513214adfSAndy Whitcroft	my ($statement, $condition, $level);
148613214adfSAndy Whitcroft
148713214adfSAndy Whitcroft	my (@chunks);
148813214adfSAndy Whitcroft
1489cf655043SAndy Whitcroft	# Grab the first conditional/block pair.
149013214adfSAndy Whitcroft	($statement, $condition, $linenr, $remain, $off, $level) =
149113214adfSAndy Whitcroft				ctx_statement_block($linenr, $remain, $off);
1492773647a0SAndy Whitcroft	#print "F: c<$condition> s<$statement> remain<$remain>\n";
149313214adfSAndy Whitcroft	push(@chunks, [ $condition, $statement ]);
1494cf655043SAndy Whitcroft	if (!($remain > 0 && $condition =~ /^\s*(?:\n[+-])?\s*(?:if|else|do)\b/s)) {
1495cf655043SAndy Whitcroft		return ($level, $linenr, @chunks);
1496cf655043SAndy Whitcroft	}
1497cf655043SAndy Whitcroft
1498cf655043SAndy Whitcroft	# Pull in the following conditional/block pairs and see if they
1499cf655043SAndy Whitcroft	# could continue the statement.
1500cf655043SAndy Whitcroft	for (;;) {
150113214adfSAndy Whitcroft		($statement, $condition, $linenr, $remain, $off, $level) =
150213214adfSAndy Whitcroft				ctx_statement_block($linenr, $remain, $off);
1503cf655043SAndy Whitcroft		#print "C: c<$condition> s<$statement> remain<$remain>\n";
1504773647a0SAndy Whitcroft		last if (!($remain > 0 && $condition =~ /^(?:\s*\n[+-])*\s*(?:else|do)\b/s));
1505cf655043SAndy Whitcroft		#print "C: push\n";
1506cf655043SAndy Whitcroft		push(@chunks, [ $condition, $statement ]);
150713214adfSAndy Whitcroft	}
150813214adfSAndy Whitcroft
150913214adfSAndy Whitcroft	return ($level, $linenr, @chunks);
15108905a67cSAndy Whitcroft}
15118905a67cSAndy Whitcroft
15124a0df2efSAndy Whitcroftsub ctx_block_get {
1513f0a594c1SAndy Whitcroft	my ($linenr, $remain, $outer, $open, $close, $off) = @_;
15144a0df2efSAndy Whitcroft	my $line;
15154a0df2efSAndy Whitcroft	my $start = $linenr - 1;
15164a0df2efSAndy Whitcroft	my $blk = '';
15174a0df2efSAndy Whitcroft	my @o;
15184a0df2efSAndy Whitcroft	my @c;
15194a0df2efSAndy Whitcroft	my @res = ();
15204a0df2efSAndy Whitcroft
1521f0a594c1SAndy Whitcroft	my $level = 0;
15224635f4fbSAndy Whitcroft	my @stack = ($level);
152300df344fSAndy Whitcroft	for ($line = $start; $remain > 0; $line++) {
152400df344fSAndy Whitcroft		next if ($rawlines[$line] =~ /^-/);
152500df344fSAndy Whitcroft		$remain--;
152600df344fSAndy Whitcroft
152700df344fSAndy Whitcroft		$blk .= $rawlines[$line];
15284635f4fbSAndy Whitcroft
15294635f4fbSAndy Whitcroft		# Handle nested #if/#else.
153001464f30SAndy Whitcroft		if ($lines[$line] =~ /^.\s*#\s*(?:ifndef|ifdef|if)\s/) {
15314635f4fbSAndy Whitcroft			push(@stack, $level);
153201464f30SAndy Whitcroft		} elsif ($lines[$line] =~ /^.\s*#\s*(?:else|elif)\b/) {
15334635f4fbSAndy Whitcroft			$level = $stack[$#stack - 1];
153401464f30SAndy Whitcroft		} elsif ($lines[$line] =~ /^.\s*#\s*endif\b/) {
15354635f4fbSAndy Whitcroft			$level = pop(@stack);
15364635f4fbSAndy Whitcroft		}
15374635f4fbSAndy Whitcroft
153801464f30SAndy Whitcroft		foreach my $c (split(//, $lines[$line])) {
1539f0a594c1SAndy Whitcroft			##print "C<$c>L<$level><$open$close>O<$off>\n";
1540f0a594c1SAndy Whitcroft			if ($off > 0) {
1541f0a594c1SAndy Whitcroft				$off--;
1542f0a594c1SAndy Whitcroft				next;
1543f0a594c1SAndy Whitcroft			}
15444a0df2efSAndy Whitcroft
1545f0a594c1SAndy Whitcroft			if ($c eq $close && $level > 0) {
1546f0a594c1SAndy Whitcroft				$level--;
1547f0a594c1SAndy Whitcroft				last if ($level == 0);
1548f0a594c1SAndy Whitcroft			} elsif ($c eq $open) {
1549f0a594c1SAndy Whitcroft				$level++;
1550f0a594c1SAndy Whitcroft			}
1551f0a594c1SAndy Whitcroft		}
15524a0df2efSAndy Whitcroft
1553f0a594c1SAndy Whitcroft		if (!$outer || $level <= 1) {
155400df344fSAndy Whitcroft			push(@res, $rawlines[$line]);
15554a0df2efSAndy Whitcroft		}
15564a0df2efSAndy Whitcroft
1557f0a594c1SAndy Whitcroft		last if ($level == 0);
15584a0df2efSAndy Whitcroft	}
15594a0df2efSAndy Whitcroft
1560f0a594c1SAndy Whitcroft	return ($level, @res);
15614a0df2efSAndy Whitcroft}
15624a0df2efSAndy Whitcroftsub ctx_block_outer {
15634a0df2efSAndy Whitcroft	my ($linenr, $remain) = @_;
15644a0df2efSAndy Whitcroft
1565f0a594c1SAndy Whitcroft	my ($level, @r) = ctx_block_get($linenr, $remain, 1, '{', '}', 0);
1566f0a594c1SAndy Whitcroft	return @r;
15674a0df2efSAndy Whitcroft}
15684a0df2efSAndy Whitcroftsub ctx_block {
15694a0df2efSAndy Whitcroft	my ($linenr, $remain) = @_;
15704a0df2efSAndy Whitcroft
1571f0a594c1SAndy Whitcroft	my ($level, @r) = ctx_block_get($linenr, $remain, 0, '{', '}', 0);
1572f0a594c1SAndy Whitcroft	return @r;
1573653d4876SAndy Whitcroft}
1574653d4876SAndy Whitcroftsub ctx_statement {
1575f0a594c1SAndy Whitcroft	my ($linenr, $remain, $off) = @_;
1576f0a594c1SAndy Whitcroft
1577f0a594c1SAndy Whitcroft	my ($level, @r) = ctx_block_get($linenr, $remain, 0, '(', ')', $off);
1578f0a594c1SAndy Whitcroft	return @r;
1579f0a594c1SAndy Whitcroft}
1580f0a594c1SAndy Whitcroftsub ctx_block_level {
1581653d4876SAndy Whitcroft	my ($linenr, $remain) = @_;
1582653d4876SAndy Whitcroft
1583f0a594c1SAndy Whitcroft	return ctx_block_get($linenr, $remain, 0, '{', '}', 0);
15844a0df2efSAndy Whitcroft}
15859c0ca6f9SAndy Whitcroftsub ctx_statement_level {
15869c0ca6f9SAndy Whitcroft	my ($linenr, $remain, $off) = @_;
15879c0ca6f9SAndy Whitcroft
15889c0ca6f9SAndy Whitcroft	return ctx_block_get($linenr, $remain, 0, '(', ')', $off);
15899c0ca6f9SAndy Whitcroft}
15904a0df2efSAndy Whitcroft
15914a0df2efSAndy Whitcroftsub ctx_locate_comment {
15924a0df2efSAndy Whitcroft	my ($first_line, $end_line) = @_;
15934a0df2efSAndy Whitcroft
15944a0df2efSAndy Whitcroft	# Catch a comment on the end of the line itself.
1595beae6332SAndy Whitcroft	my ($current_comment) = ($rawlines[$end_line - 1] =~ m@.*(/\*.*\*/)\s*(?:\\\s*)?$@);
15964a0df2efSAndy Whitcroft	return $current_comment if (defined $current_comment);
15974a0df2efSAndy Whitcroft
15984a0df2efSAndy Whitcroft	# Look through the context and try and figure out if there is a
15994a0df2efSAndy Whitcroft	# comment.
16004a0df2efSAndy Whitcroft	my $in_comment = 0;
16014a0df2efSAndy Whitcroft	$current_comment = '';
16024a0df2efSAndy Whitcroft	for (my $linenr = $first_line; $linenr < $end_line; $linenr++) {
160300df344fSAndy Whitcroft		my $line = $rawlines[$linenr - 1];
160400df344fSAndy Whitcroft		#warn "           $line\n";
16054a0df2efSAndy Whitcroft		if ($linenr == $first_line and $line =~ m@^.\s*\*@) {
16064a0df2efSAndy Whitcroft			$in_comment = 1;
16074a0df2efSAndy Whitcroft		}
16084a0df2efSAndy Whitcroft		if ($line =~ m@/\*@) {
16094a0df2efSAndy Whitcroft			$in_comment = 1;
16104a0df2efSAndy Whitcroft		}
16114a0df2efSAndy Whitcroft		if (!$in_comment && $current_comment ne '') {
16124a0df2efSAndy Whitcroft			$current_comment = '';
16134a0df2efSAndy Whitcroft		}
16144a0df2efSAndy Whitcroft		$current_comment .= $line . "\n" if ($in_comment);
16154a0df2efSAndy Whitcroft		if ($line =~ m@\*/@) {
16164a0df2efSAndy Whitcroft			$in_comment = 0;
16174a0df2efSAndy Whitcroft		}
16184a0df2efSAndy Whitcroft	}
16194a0df2efSAndy Whitcroft
16204a0df2efSAndy Whitcroft	chomp($current_comment);
16214a0df2efSAndy Whitcroft	return($current_comment);
16224a0df2efSAndy Whitcroft}
16234a0df2efSAndy Whitcroftsub ctx_has_comment {
16244a0df2efSAndy Whitcroft	my ($first_line, $end_line) = @_;
16254a0df2efSAndy Whitcroft	my $cmt = ctx_locate_comment($first_line, $end_line);
16264a0df2efSAndy Whitcroft
162700df344fSAndy Whitcroft	##print "LINE: $rawlines[$end_line - 1 ]\n";
16284a0df2efSAndy Whitcroft	##print "CMMT: $cmt\n";
16294a0df2efSAndy Whitcroft
16304a0df2efSAndy Whitcroft	return ($cmt ne '');
16314a0df2efSAndy Whitcroft}
16324a0df2efSAndy Whitcroft
16334d001e4dSAndy Whitcroftsub raw_line {
16344d001e4dSAndy Whitcroft	my ($linenr, $cnt) = @_;
16354d001e4dSAndy Whitcroft
16364d001e4dSAndy Whitcroft	my $offset = $linenr - 1;
16374d001e4dSAndy Whitcroft	$cnt++;
16384d001e4dSAndy Whitcroft
16394d001e4dSAndy Whitcroft	my $line;
16404d001e4dSAndy Whitcroft	while ($cnt) {
16414d001e4dSAndy Whitcroft		$line = $rawlines[$offset++];
16424d001e4dSAndy Whitcroft		next if (defined($line) && $line =~ /^-/);
16434d001e4dSAndy Whitcroft		$cnt--;
16444d001e4dSAndy Whitcroft	}
16454d001e4dSAndy Whitcroft
16464d001e4dSAndy Whitcroft	return $line;
16474d001e4dSAndy Whitcroft}
16484d001e4dSAndy Whitcroft
16492a9f9d85STobin C. Hardingsub get_stat_real {
16502a9f9d85STobin C. Harding	my ($linenr, $lc) = @_;
16512a9f9d85STobin C. Harding
16522a9f9d85STobin C. Harding	my $stat_real = raw_line($linenr, 0);
16532a9f9d85STobin C. Harding	for (my $count = $linenr + 1; $count <= $lc; $count++) {
16542a9f9d85STobin C. Harding		$stat_real = $stat_real . "\n" . raw_line($count, 0);
16552a9f9d85STobin C. Harding	}
16562a9f9d85STobin C. Harding
16572a9f9d85STobin C. Harding	return $stat_real;
16582a9f9d85STobin C. Harding}
16592a9f9d85STobin C. Harding
1660e3d95a2aSTobin C. Hardingsub get_stat_here {
1661e3d95a2aSTobin C. Harding	my ($linenr, $cnt, $here) = @_;
1662e3d95a2aSTobin C. Harding
1663e3d95a2aSTobin C. Harding	my $herectx = $here . "\n";
1664e3d95a2aSTobin C. Harding	for (my $n = 0; $n < $cnt; $n++) {
1665e3d95a2aSTobin C. Harding		$herectx .= raw_line($linenr, $n) . "\n";
1666e3d95a2aSTobin C. Harding	}
1667e3d95a2aSTobin C. Harding
1668e3d95a2aSTobin C. Harding	return $herectx;
1669e3d95a2aSTobin C. Harding}
1670e3d95a2aSTobin C. Harding
16710a920b5bSAndy Whitcroftsub cat_vet {
16720a920b5bSAndy Whitcroft	my ($vet) = @_;
16739c0ca6f9SAndy Whitcroft	my ($res, $coded);
16740a920b5bSAndy Whitcroft
16759c0ca6f9SAndy Whitcroft	$res = '';
16766c72ffaaSAndy Whitcroft	while ($vet =~ /([^[:cntrl:]]*)([[:cntrl:]]|$)/g) {
16776c72ffaaSAndy Whitcroft		$res .= $1;
16786c72ffaaSAndy Whitcroft		if ($2 ne '') {
16799c0ca6f9SAndy Whitcroft			$coded = sprintf("^%c", unpack('C', $2) + 64);
16806c72ffaaSAndy Whitcroft			$res .= $coded;
16816c72ffaaSAndy Whitcroft		}
16829c0ca6f9SAndy Whitcroft	}
16839c0ca6f9SAndy Whitcroft	$res =~ s/$/\$/;
16840a920b5bSAndy Whitcroft
16859c0ca6f9SAndy Whitcroft	return $res;
16860a920b5bSAndy Whitcroft}
16870a920b5bSAndy Whitcroft
1688c2fdda0dSAndy Whitcroftmy $av_preprocessor = 0;
1689cf655043SAndy Whitcroftmy $av_pending;
1690c2fdda0dSAndy Whitcroftmy @av_paren_type;
16911f65f947SAndy Whitcroftmy $av_pend_colon;
1692c2fdda0dSAndy Whitcroft
1693c2fdda0dSAndy Whitcroftsub annotate_reset {
1694c2fdda0dSAndy Whitcroft	$av_preprocessor = 0;
1695cf655043SAndy Whitcroft	$av_pending = '_';
1696cf655043SAndy Whitcroft	@av_paren_type = ('E');
16971f65f947SAndy Whitcroft	$av_pend_colon = 'O';
1698c2fdda0dSAndy Whitcroft}
1699c2fdda0dSAndy Whitcroft
17006c72ffaaSAndy Whitcroftsub annotate_values {
17016c72ffaaSAndy Whitcroft	my ($stream, $type) = @_;
17026c72ffaaSAndy Whitcroft
17036c72ffaaSAndy Whitcroft	my $res;
17041f65f947SAndy Whitcroft	my $var = '_' x length($stream);
17056c72ffaaSAndy Whitcroft	my $cur = $stream;
17066c72ffaaSAndy Whitcroft
1707c2fdda0dSAndy Whitcroft	print "$stream\n" if ($dbg_values > 1);
17086c72ffaaSAndy Whitcroft
17096c72ffaaSAndy Whitcroft	while (length($cur)) {
1710773647a0SAndy Whitcroft		@av_paren_type = ('E') if ($#av_paren_type < 0);
1711cf655043SAndy Whitcroft		print " <" . join('', @av_paren_type) .
1712171ae1a4SAndy Whitcroft				"> <$type> <$av_pending>" if ($dbg_values > 1);
17136c72ffaaSAndy Whitcroft		if ($cur =~ /^(\s+)/o) {
1714c2fdda0dSAndy Whitcroft			print "WS($1)\n" if ($dbg_values > 1);
1715c2fdda0dSAndy Whitcroft			if ($1 =~ /\n/ && $av_preprocessor) {
1716cf655043SAndy Whitcroft				$type = pop(@av_paren_type);
1717c2fdda0dSAndy Whitcroft				$av_preprocessor = 0;
17186c72ffaaSAndy Whitcroft			}
17196c72ffaaSAndy Whitcroft
1720c023e473SFlorian Mickler		} elsif ($cur =~ /^(\(\s*$Type\s*)\)/ && $av_pending eq '_') {
17219446ef56SAndy Whitcroft			print "CAST($1)\n" if ($dbg_values > 1);
17229446ef56SAndy Whitcroft			push(@av_paren_type, $type);
1723addcdceaSAndy Whitcroft			$type = 'c';
17249446ef56SAndy Whitcroft
1725e91b6e26SAndy Whitcroft		} elsif ($cur =~ /^($Type)\s*(?:$Ident|,|\)|\(|\s*$)/) {
1726c2fdda0dSAndy Whitcroft			print "DECLARE($1)\n" if ($dbg_values > 1);
17276c72ffaaSAndy Whitcroft			$type = 'T';
17286c72ffaaSAndy Whitcroft
1729389a2fe5SAndy Whitcroft		} elsif ($cur =~ /^($Modifier)\s*/) {
1730389a2fe5SAndy Whitcroft			print "MODIFIER($1)\n" if ($dbg_values > 1);
1731389a2fe5SAndy Whitcroft			$type = 'T';
1732389a2fe5SAndy Whitcroft
1733c45dcabdSAndy Whitcroft		} elsif ($cur =~ /^(\#\s*define\s*$Ident)(\(?)/o) {
1734171ae1a4SAndy Whitcroft			print "DEFINE($1,$2)\n" if ($dbg_values > 1);
1735c2fdda0dSAndy Whitcroft			$av_preprocessor = 1;
1736171ae1a4SAndy Whitcroft			push(@av_paren_type, $type);
1737171ae1a4SAndy Whitcroft			if ($2 ne '') {
1738cf655043SAndy Whitcroft				$av_pending = 'N';
1739171ae1a4SAndy Whitcroft			}
1740171ae1a4SAndy Whitcroft			$type = 'E';
1741171ae1a4SAndy Whitcroft
1742c45dcabdSAndy Whitcroft		} elsif ($cur =~ /^(\#\s*(?:undef\s*$Ident|include\b))/o) {
1743171ae1a4SAndy Whitcroft			print "UNDEF($1)\n" if ($dbg_values > 1);
1744171ae1a4SAndy Whitcroft			$av_preprocessor = 1;
1745171ae1a4SAndy Whitcroft			push(@av_paren_type, $type);
17466c72ffaaSAndy Whitcroft
1747c45dcabdSAndy Whitcroft		} elsif ($cur =~ /^(\#\s*(?:ifdef|ifndef|if))/o) {
1748cf655043SAndy Whitcroft			print "PRE_START($1)\n" if ($dbg_values > 1);
1749c2fdda0dSAndy Whitcroft			$av_preprocessor = 1;
1750cf655043SAndy Whitcroft
1751cf655043SAndy Whitcroft			push(@av_paren_type, $type);
1752cf655043SAndy Whitcroft			push(@av_paren_type, $type);
1753171ae1a4SAndy Whitcroft			$type = 'E';
1754cf655043SAndy Whitcroft
1755c45dcabdSAndy Whitcroft		} elsif ($cur =~ /^(\#\s*(?:else|elif))/o) {
1756cf655043SAndy Whitcroft			print "PRE_RESTART($1)\n" if ($dbg_values > 1);
1757cf655043SAndy Whitcroft			$av_preprocessor = 1;
1758cf655043SAndy Whitcroft
1759cf655043SAndy Whitcroft			push(@av_paren_type, $av_paren_type[$#av_paren_type]);
1760cf655043SAndy Whitcroft
1761171ae1a4SAndy Whitcroft			$type = 'E';
1762cf655043SAndy Whitcroft
1763c45dcabdSAndy Whitcroft		} elsif ($cur =~ /^(\#\s*(?:endif))/o) {
1764cf655043SAndy Whitcroft			print "PRE_END($1)\n" if ($dbg_values > 1);
1765cf655043SAndy Whitcroft
1766cf655043SAndy Whitcroft			$av_preprocessor = 1;
1767cf655043SAndy Whitcroft
1768cf655043SAndy Whitcroft			# Assume all arms of the conditional end as this
1769cf655043SAndy Whitcroft			# one does, and continue as if the #endif was not here.
1770cf655043SAndy Whitcroft			pop(@av_paren_type);
1771cf655043SAndy Whitcroft			push(@av_paren_type, $type);
1772171ae1a4SAndy Whitcroft			$type = 'E';
17736c72ffaaSAndy Whitcroft
17746c72ffaaSAndy Whitcroft		} elsif ($cur =~ /^(\\\n)/o) {
1775c2fdda0dSAndy Whitcroft			print "PRECONT($1)\n" if ($dbg_values > 1);
17766c72ffaaSAndy Whitcroft
1777171ae1a4SAndy Whitcroft		} elsif ($cur =~ /^(__attribute__)\s*\(?/o) {
1778171ae1a4SAndy Whitcroft			print "ATTR($1)\n" if ($dbg_values > 1);
1779171ae1a4SAndy Whitcroft			$av_pending = $type;
1780171ae1a4SAndy Whitcroft			$type = 'N';
1781171ae1a4SAndy Whitcroft
17826c72ffaaSAndy Whitcroft		} elsif ($cur =~ /^(sizeof)\s*(\()?/o) {
1783c2fdda0dSAndy Whitcroft			print "SIZEOF($1)\n" if ($dbg_values > 1);
17846c72ffaaSAndy Whitcroft			if (defined $2) {
1785cf655043SAndy Whitcroft				$av_pending = 'V';
17866c72ffaaSAndy Whitcroft			}
17876c72ffaaSAndy Whitcroft			$type = 'N';
17886c72ffaaSAndy Whitcroft
178914b111c1SAndy Whitcroft		} elsif ($cur =~ /^(if|while|for)\b/o) {
1790c2fdda0dSAndy Whitcroft			print "COND($1)\n" if ($dbg_values > 1);
179114b111c1SAndy Whitcroft			$av_pending = 'E';
17926c72ffaaSAndy Whitcroft			$type = 'N';
17936c72ffaaSAndy Whitcroft
17941f65f947SAndy Whitcroft		} elsif ($cur =~/^(case)/o) {
17951f65f947SAndy Whitcroft			print "CASE($1)\n" if ($dbg_values > 1);
17961f65f947SAndy Whitcroft			$av_pend_colon = 'C';
17971f65f947SAndy Whitcroft			$type = 'N';
17981f65f947SAndy Whitcroft
179914b111c1SAndy Whitcroft		} elsif ($cur =~/^(return|else|goto|typeof|__typeof__)\b/o) {
1800c2fdda0dSAndy Whitcroft			print "KEYWORD($1)\n" if ($dbg_values > 1);
18016c72ffaaSAndy Whitcroft			$type = 'N';
18026c72ffaaSAndy Whitcroft
18036c72ffaaSAndy Whitcroft		} elsif ($cur =~ /^(\()/o) {
1804c2fdda0dSAndy Whitcroft			print "PAREN('$1')\n" if ($dbg_values > 1);
1805cf655043SAndy Whitcroft			push(@av_paren_type, $av_pending);
1806cf655043SAndy Whitcroft			$av_pending = '_';
18076c72ffaaSAndy Whitcroft			$type = 'N';
18086c72ffaaSAndy Whitcroft
18096c72ffaaSAndy Whitcroft		} elsif ($cur =~ /^(\))/o) {
1810cf655043SAndy Whitcroft			my $new_type = pop(@av_paren_type);
1811cf655043SAndy Whitcroft			if ($new_type ne '_') {
1812cf655043SAndy Whitcroft				$type = $new_type;
1813c2fdda0dSAndy Whitcroft				print "PAREN('$1') -> $type\n"
1814c2fdda0dSAndy Whitcroft							if ($dbg_values > 1);
18156c72ffaaSAndy Whitcroft			} else {
1816c2fdda0dSAndy Whitcroft				print "PAREN('$1')\n" if ($dbg_values > 1);
18176c72ffaaSAndy Whitcroft			}
18186c72ffaaSAndy Whitcroft
1819c8cb2ca3SAndy Whitcroft		} elsif ($cur =~ /^($Ident)\s*\(/o) {
1820c2fdda0dSAndy Whitcroft			print "FUNC($1)\n" if ($dbg_values > 1);
1821c8cb2ca3SAndy Whitcroft			$type = 'V';
1822cf655043SAndy Whitcroft			$av_pending = 'V';
18236c72ffaaSAndy Whitcroft
18248e761b04SAndy Whitcroft		} elsif ($cur =~ /^($Ident\s*):(?:\s*\d+\s*(,|=|;))?/) {
18258e761b04SAndy Whitcroft			if (defined $2 && $type eq 'C' || $type eq 'T') {
18261f65f947SAndy Whitcroft				$av_pend_colon = 'B';
18278e761b04SAndy Whitcroft			} elsif ($type eq 'E') {
18288e761b04SAndy Whitcroft				$av_pend_colon = 'L';
18291f65f947SAndy Whitcroft			}
18301f65f947SAndy Whitcroft			print "IDENT_COLON($1,$type>$av_pend_colon)\n" if ($dbg_values > 1);
18311f65f947SAndy Whitcroft			$type = 'V';
18321f65f947SAndy Whitcroft
18336c72ffaaSAndy Whitcroft		} elsif ($cur =~ /^($Ident|$Constant)/o) {
1834c2fdda0dSAndy Whitcroft			print "IDENT($1)\n" if ($dbg_values > 1);
18356c72ffaaSAndy Whitcroft			$type = 'V';
18366c72ffaaSAndy Whitcroft
18376c72ffaaSAndy Whitcroft		} elsif ($cur =~ /^($Assignment)/o) {
1838c2fdda0dSAndy Whitcroft			print "ASSIGN($1)\n" if ($dbg_values > 1);
18396c72ffaaSAndy Whitcroft			$type = 'N';
18406c72ffaaSAndy Whitcroft
1841cf655043SAndy Whitcroft		} elsif ($cur =~/^(;|{|})/) {
1842c2fdda0dSAndy Whitcroft			print "END($1)\n" if ($dbg_values > 1);
184313214adfSAndy Whitcroft			$type = 'E';
18441f65f947SAndy Whitcroft			$av_pend_colon = 'O';
184513214adfSAndy Whitcroft
18468e761b04SAndy Whitcroft		} elsif ($cur =~/^(,)/) {
18478e761b04SAndy Whitcroft			print "COMMA($1)\n" if ($dbg_values > 1);
18488e761b04SAndy Whitcroft			$type = 'C';
18498e761b04SAndy Whitcroft
18501f65f947SAndy Whitcroft		} elsif ($cur =~ /^(\?)/o) {
18511f65f947SAndy Whitcroft			print "QUESTION($1)\n" if ($dbg_values > 1);
18521f65f947SAndy Whitcroft			$type = 'N';
18531f65f947SAndy Whitcroft
18541f65f947SAndy Whitcroft		} elsif ($cur =~ /^(:)/o) {
18551f65f947SAndy Whitcroft			print "COLON($1,$av_pend_colon)\n" if ($dbg_values > 1);
18561f65f947SAndy Whitcroft
18571f65f947SAndy Whitcroft			substr($var, length($res), 1, $av_pend_colon);
18581f65f947SAndy Whitcroft			if ($av_pend_colon eq 'C' || $av_pend_colon eq 'L') {
18591f65f947SAndy Whitcroft				$type = 'E';
18601f65f947SAndy Whitcroft			} else {
18611f65f947SAndy Whitcroft				$type = 'N';
18621f65f947SAndy Whitcroft			}
18631f65f947SAndy Whitcroft			$av_pend_colon = 'O';
18641f65f947SAndy Whitcroft
18658e761b04SAndy Whitcroft		} elsif ($cur =~ /^(\[)/o) {
186613214adfSAndy Whitcroft			print "CLOSE($1)\n" if ($dbg_values > 1);
18676c72ffaaSAndy Whitcroft			$type = 'N';
18686c72ffaaSAndy Whitcroft
18690d413866SAndy Whitcroft		} elsif ($cur =~ /^(-(?![->])|\+(?!\+)|\*|\&\&|\&)/o) {
187074048ed8SAndy Whitcroft			my $variant;
187174048ed8SAndy Whitcroft
187274048ed8SAndy Whitcroft			print "OPV($1)\n" if ($dbg_values > 1);
187374048ed8SAndy Whitcroft			if ($type eq 'V') {
187474048ed8SAndy Whitcroft				$variant = 'B';
187574048ed8SAndy Whitcroft			} else {
187674048ed8SAndy Whitcroft				$variant = 'U';
187774048ed8SAndy Whitcroft			}
187874048ed8SAndy Whitcroft
187974048ed8SAndy Whitcroft			substr($var, length($res), 1, $variant);
188074048ed8SAndy Whitcroft			$type = 'N';
188174048ed8SAndy Whitcroft
18826c72ffaaSAndy Whitcroft		} elsif ($cur =~ /^($Operators)/o) {
1883c2fdda0dSAndy Whitcroft			print "OP($1)\n" if ($dbg_values > 1);
18846c72ffaaSAndy Whitcroft			if ($1 ne '++' && $1 ne '--') {
18856c72ffaaSAndy Whitcroft				$type = 'N';
18866c72ffaaSAndy Whitcroft			}
18876c72ffaaSAndy Whitcroft
18886c72ffaaSAndy Whitcroft		} elsif ($cur =~ /(^.)/o) {
1889c2fdda0dSAndy Whitcroft			print "C($1)\n" if ($dbg_values > 1);
18906c72ffaaSAndy Whitcroft		}
18916c72ffaaSAndy Whitcroft		if (defined $1) {
18926c72ffaaSAndy Whitcroft			$cur = substr($cur, length($1));
18936c72ffaaSAndy Whitcroft			$res .= $type x length($1);
18946c72ffaaSAndy Whitcroft		}
18956c72ffaaSAndy Whitcroft	}
18966c72ffaaSAndy Whitcroft
18971f65f947SAndy Whitcroft	return ($res, $var);
18986c72ffaaSAndy Whitcroft}
18996c72ffaaSAndy Whitcroft
19008905a67cSAndy Whitcroftsub possible {
190113214adfSAndy Whitcroft	my ($possible, $line) = @_;
19029a974fdbSAndy Whitcroft	my $notPermitted = qr{(?:
19030776e594SAndy Whitcroft		^(?:
19040776e594SAndy Whitcroft			$Modifier|
19050776e594SAndy Whitcroft			$Storage|
19060776e594SAndy Whitcroft			$Type|
19079a974fdbSAndy Whitcroft			DEFINE_\S+
19089a974fdbSAndy Whitcroft		)$|
19099a974fdbSAndy Whitcroft		^(?:
19100776e594SAndy Whitcroft			goto|
19110776e594SAndy Whitcroft			return|
19120776e594SAndy Whitcroft			case|
19130776e594SAndy Whitcroft			else|
19140776e594SAndy Whitcroft			asm|__asm__|
191589a88353SAndy Whitcroft			do|
191689a88353SAndy Whitcroft			\#|
191789a88353SAndy Whitcroft			\#\#|
19189a974fdbSAndy Whitcroft		)(?:\s|$)|
19190776e594SAndy Whitcroft		^(?:typedef|struct|enum)\b
19209a974fdbSAndy Whitcroft	    )}x;
19219a974fdbSAndy Whitcroft	warn "CHECK<$possible> ($line)\n" if ($dbg_possible > 2);
19229a974fdbSAndy Whitcroft	if ($possible !~ $notPermitted) {
1923c45dcabdSAndy Whitcroft		# Check for modifiers.
1924c45dcabdSAndy Whitcroft		$possible =~ s/\s*$Storage\s*//g;
1925c45dcabdSAndy Whitcroft		$possible =~ s/\s*$Sparse\s*//g;
1926c45dcabdSAndy Whitcroft		if ($possible =~ /^\s*$/) {
1927c45dcabdSAndy Whitcroft
1928c45dcabdSAndy Whitcroft		} elsif ($possible =~ /\s/) {
1929c45dcabdSAndy Whitcroft			$possible =~ s/\s*$Type\s*//g;
1930d2506586SAndy Whitcroft			for my $modifier (split(' ', $possible)) {
19319a974fdbSAndy Whitcroft				if ($modifier !~ $notPermitted) {
1932d2506586SAndy Whitcroft					warn "MODIFIER: $modifier ($possible) ($line)\n" if ($dbg_possible);
1933485ff23eSAlex Dowad					push(@modifierListFile, $modifier);
1934d2506586SAndy Whitcroft				}
19359a974fdbSAndy Whitcroft			}
1936c45dcabdSAndy Whitcroft
1937c45dcabdSAndy Whitcroft		} else {
193813214adfSAndy Whitcroft			warn "POSSIBLE: $possible ($line)\n" if ($dbg_possible);
1939485ff23eSAlex Dowad			push(@typeListFile, $possible);
1940c45dcabdSAndy Whitcroft		}
19418905a67cSAndy Whitcroft		build_types();
19420776e594SAndy Whitcroft	} else {
19430776e594SAndy Whitcroft		warn "NOTPOSS: $possible ($line)\n" if ($dbg_possible > 1);
19448905a67cSAndy Whitcroft	}
19458905a67cSAndy Whitcroft}
19468905a67cSAndy Whitcroft
19476c72ffaaSAndy Whitcroftmy $prefix = '';
19486c72ffaaSAndy Whitcroft
1949000d1cc1SJoe Perchessub show_type {
1950cbec18afSJoe Perches	my ($type) = @_;
195191bfe484SJoe Perches
1952522b837cSAlexey Dobriyan	$type =~ tr/[a-z]/[A-Z]/;
1953522b837cSAlexey Dobriyan
1954cbec18afSJoe Perches	return defined $use_type{$type} if (scalar keys %use_type > 0);
1955cbec18afSJoe Perches
1956cbec18afSJoe Perches	return !defined $ignore_type{$type};
1957000d1cc1SJoe Perches}
1958000d1cc1SJoe Perches
1959f0a594c1SAndy Whitcroftsub report {
1960cbec18afSJoe Perches	my ($level, $type, $msg) = @_;
1961cbec18afSJoe Perches
1962cbec18afSJoe Perches	if (!show_type($type) ||
1963cbec18afSJoe Perches	    (defined $tst_only && $msg !~ /\Q$tst_only\E/)) {
1964773647a0SAndy Whitcroft		return 0;
1965773647a0SAndy Whitcroft	}
196657230297SJoe Perches	my $output = '';
1967737c0767SJohn Brooks	if ($color) {
196857230297SJoe Perches		if ($level eq 'ERROR') {
196957230297SJoe Perches			$output .= RED;
197057230297SJoe Perches		} elsif ($level eq 'WARNING') {
197157230297SJoe Perches			$output .= YELLOW;
1972000d1cc1SJoe Perches		} else {
197357230297SJoe Perches			$output .= GREEN;
1974000d1cc1SJoe Perches		}
197557230297SJoe Perches	}
197657230297SJoe Perches	$output .= $prefix . $level . ':';
197757230297SJoe Perches	if ($show_types) {
1978737c0767SJohn Brooks		$output .= BLUE if ($color);
197957230297SJoe Perches		$output .= "$type:";
198057230297SJoe Perches	}
1981737c0767SJohn Brooks	$output .= RESET if ($color);
198257230297SJoe Perches	$output .= ' ' . $msg . "\n";
198334d8815fSJoe Perches
198434d8815fSJoe Perches	if ($showfile) {
198534d8815fSJoe Perches		my @lines = split("\n", $output, -1);
198634d8815fSJoe Perches		splice(@lines, 1, 1);
198734d8815fSJoe Perches		$output = join("\n", @lines);
198834d8815fSJoe Perches	}
198957230297SJoe Perches	$output = (split('\n', $output))[0] . "\n" if ($terse);
19908905a67cSAndy Whitcroft
199157230297SJoe Perches	push(our @report, $output);
1992773647a0SAndy Whitcroft
1993773647a0SAndy Whitcroft	return 1;
1994f0a594c1SAndy Whitcroft}
1995cbec18afSJoe Perches
1996f0a594c1SAndy Whitcroftsub report_dump {
199713214adfSAndy Whitcroft	our @report;
1998f0a594c1SAndy Whitcroft}
1999000d1cc1SJoe Perches
2000d752fcc8SJoe Perchessub fixup_current_range {
2001d752fcc8SJoe Perches	my ($lineRef, $offset, $length) = @_;
2002d752fcc8SJoe Perches
2003d752fcc8SJoe Perches	if ($$lineRef =~ /^\@\@ -\d+,\d+ \+(\d+),(\d+) \@\@/) {
2004d752fcc8SJoe Perches		my $o = $1;
2005d752fcc8SJoe Perches		my $l = $2;
2006d752fcc8SJoe Perches		my $no = $o + $offset;
2007d752fcc8SJoe Perches		my $nl = $l + $length;
2008d752fcc8SJoe Perches		$$lineRef =~ s/\+$o,$l \@\@/\+$no,$nl \@\@/;
2009d752fcc8SJoe Perches	}
2010d752fcc8SJoe Perches}
2011d752fcc8SJoe Perches
2012d752fcc8SJoe Perchessub fix_inserted_deleted_lines {
2013d752fcc8SJoe Perches	my ($linesRef, $insertedRef, $deletedRef) = @_;
2014d752fcc8SJoe Perches
2015d752fcc8SJoe Perches	my $range_last_linenr = 0;
2016d752fcc8SJoe Perches	my $delta_offset = 0;
2017d752fcc8SJoe Perches
2018d752fcc8SJoe Perches	my $old_linenr = 0;
2019d752fcc8SJoe Perches	my $new_linenr = 0;
2020d752fcc8SJoe Perches
2021d752fcc8SJoe Perches	my $next_insert = 0;
2022d752fcc8SJoe Perches	my $next_delete = 0;
2023d752fcc8SJoe Perches
2024d752fcc8SJoe Perches	my @lines = ();
2025d752fcc8SJoe Perches
2026d752fcc8SJoe Perches	my $inserted = @{$insertedRef}[$next_insert++];
2027d752fcc8SJoe Perches	my $deleted = @{$deletedRef}[$next_delete++];
2028d752fcc8SJoe Perches
2029d752fcc8SJoe Perches	foreach my $old_line (@{$linesRef}) {
2030d752fcc8SJoe Perches		my $save_line = 1;
2031d752fcc8SJoe Perches		my $line = $old_line;	#don't modify the array
2032323b267fSJoe Perches		if ($line =~ /^(?:\+\+\+|\-\-\-)\s+\S+/) {	#new filename
2033d752fcc8SJoe Perches			$delta_offset = 0;
2034d752fcc8SJoe Perches		} elsif ($line =~ /^\@\@ -\d+,\d+ \+\d+,\d+ \@\@/) {	#new hunk
2035d752fcc8SJoe Perches			$range_last_linenr = $new_linenr;
2036d752fcc8SJoe Perches			fixup_current_range(\$line, $delta_offset, 0);
2037d752fcc8SJoe Perches		}
2038d752fcc8SJoe Perches
2039d752fcc8SJoe Perches		while (defined($deleted) && ${$deleted}{'LINENR'} == $old_linenr) {
2040d752fcc8SJoe Perches			$deleted = @{$deletedRef}[$next_delete++];
2041d752fcc8SJoe Perches			$save_line = 0;
2042d752fcc8SJoe Perches			fixup_current_range(\$lines[$range_last_linenr], $delta_offset--, -1);
2043d752fcc8SJoe Perches		}
2044d752fcc8SJoe Perches
2045d752fcc8SJoe Perches		while (defined($inserted) && ${$inserted}{'LINENR'} == $old_linenr) {
2046d752fcc8SJoe Perches			push(@lines, ${$inserted}{'LINE'});
2047d752fcc8SJoe Perches			$inserted = @{$insertedRef}[$next_insert++];
2048d752fcc8SJoe Perches			$new_linenr++;
2049d752fcc8SJoe Perches			fixup_current_range(\$lines[$range_last_linenr], $delta_offset++, 1);
2050d752fcc8SJoe Perches		}
2051d752fcc8SJoe Perches
2052d752fcc8SJoe Perches		if ($save_line) {
2053d752fcc8SJoe Perches			push(@lines, $line);
2054d752fcc8SJoe Perches			$new_linenr++;
2055d752fcc8SJoe Perches		}
2056d752fcc8SJoe Perches
2057d752fcc8SJoe Perches		$old_linenr++;
2058d752fcc8SJoe Perches	}
2059d752fcc8SJoe Perches
2060d752fcc8SJoe Perches	return @lines;
2061d752fcc8SJoe Perches}
2062d752fcc8SJoe Perches
2063f2d7e4d4SJoe Perchessub fix_insert_line {
2064f2d7e4d4SJoe Perches	my ($linenr, $line) = @_;
2065f2d7e4d4SJoe Perches
2066f2d7e4d4SJoe Perches	my $inserted = {
2067f2d7e4d4SJoe Perches		LINENR => $linenr,
2068f2d7e4d4SJoe Perches		LINE => $line,
2069f2d7e4d4SJoe Perches	};
2070f2d7e4d4SJoe Perches	push(@fixed_inserted, $inserted);
2071f2d7e4d4SJoe Perches}
2072f2d7e4d4SJoe Perches
2073f2d7e4d4SJoe Perchessub fix_delete_line {
2074f2d7e4d4SJoe Perches	my ($linenr, $line) = @_;
2075f2d7e4d4SJoe Perches
2076f2d7e4d4SJoe Perches	my $deleted = {
2077f2d7e4d4SJoe Perches		LINENR => $linenr,
2078f2d7e4d4SJoe Perches		LINE => $line,
2079f2d7e4d4SJoe Perches	};
2080f2d7e4d4SJoe Perches
2081f2d7e4d4SJoe Perches	push(@fixed_deleted, $deleted);
2082f2d7e4d4SJoe Perches}
2083f2d7e4d4SJoe Perches
2084de7d4f0eSAndy Whitcroftsub ERROR {
2085cbec18afSJoe Perches	my ($type, $msg) = @_;
2086cbec18afSJoe Perches
2087cbec18afSJoe Perches	if (report("ERROR", $type, $msg)) {
2088de7d4f0eSAndy Whitcroft		our $clean = 0;
20896c72ffaaSAndy Whitcroft		our $cnt_error++;
20903705ce5bSJoe Perches		return 1;
2091de7d4f0eSAndy Whitcroft	}
20923705ce5bSJoe Perches	return 0;
2093773647a0SAndy Whitcroft}
2094de7d4f0eSAndy Whitcroftsub WARN {
2095cbec18afSJoe Perches	my ($type, $msg) = @_;
2096cbec18afSJoe Perches
2097cbec18afSJoe Perches	if (report("WARNING", $type, $msg)) {
2098de7d4f0eSAndy Whitcroft		our $clean = 0;
20996c72ffaaSAndy Whitcroft		our $cnt_warn++;
21003705ce5bSJoe Perches		return 1;
2101de7d4f0eSAndy Whitcroft	}
21023705ce5bSJoe Perches	return 0;
2103773647a0SAndy Whitcroft}
2104de7d4f0eSAndy Whitcroftsub CHK {
2105cbec18afSJoe Perches	my ($type, $msg) = @_;
2106cbec18afSJoe Perches
2107cbec18afSJoe Perches	if ($check && report("CHECK", $type, $msg)) {
2108de7d4f0eSAndy Whitcroft		our $clean = 0;
21096c72ffaaSAndy Whitcroft		our $cnt_chk++;
21103705ce5bSJoe Perches		return 1;
21116c72ffaaSAndy Whitcroft	}
21123705ce5bSJoe Perches	return 0;
2113de7d4f0eSAndy Whitcroft}
2114de7d4f0eSAndy Whitcroft
21156ecd9674SAndy Whitcroftsub check_absolute_file {
21166ecd9674SAndy Whitcroft	my ($absolute, $herecurr) = @_;
21176ecd9674SAndy Whitcroft	my $file = $absolute;
21186ecd9674SAndy Whitcroft
21196ecd9674SAndy Whitcroft	##print "absolute<$absolute>\n";
21206ecd9674SAndy Whitcroft
21216ecd9674SAndy Whitcroft	# See if any suffix of this path is a path within the tree.
21226ecd9674SAndy Whitcroft	while ($file =~ s@^[^/]*/@@) {
21236ecd9674SAndy Whitcroft		if (-f "$root/$file") {
21246ecd9674SAndy Whitcroft			##print "file<$file>\n";
21256ecd9674SAndy Whitcroft			last;
21266ecd9674SAndy Whitcroft		}
21276ecd9674SAndy Whitcroft	}
21286ecd9674SAndy Whitcroft	if (! -f _)  {
21296ecd9674SAndy Whitcroft		return 0;
21306ecd9674SAndy Whitcroft	}
21316ecd9674SAndy Whitcroft
21326ecd9674SAndy Whitcroft	# It is, so see if the prefix is acceptable.
21336ecd9674SAndy Whitcroft	my $prefix = $absolute;
21346ecd9674SAndy Whitcroft	substr($prefix, -length($file)) = '';
21356ecd9674SAndy Whitcroft
21366ecd9674SAndy Whitcroft	##print "prefix<$prefix>\n";
21376ecd9674SAndy Whitcroft	if ($prefix ne ".../") {
2138000d1cc1SJoe Perches		WARN("USE_RELATIVE_PATH",
2139000d1cc1SJoe Perches		     "use relative pathname instead of absolute in changelog text\n" . $herecurr);
21406ecd9674SAndy Whitcroft	}
21416ecd9674SAndy Whitcroft}
21426ecd9674SAndy Whitcroft
21433705ce5bSJoe Perchessub trim {
21443705ce5bSJoe Perches	my ($string) = @_;
21453705ce5bSJoe Perches
2146b34c648bSJoe Perches	$string =~ s/^\s+|\s+$//g;
2147b34c648bSJoe Perches
2148b34c648bSJoe Perches	return $string;
2149b34c648bSJoe Perches}
2150b34c648bSJoe Perches
2151b34c648bSJoe Perchessub ltrim {
2152b34c648bSJoe Perches	my ($string) = @_;
2153b34c648bSJoe Perches
2154b34c648bSJoe Perches	$string =~ s/^\s+//;
2155b34c648bSJoe Perches
2156b34c648bSJoe Perches	return $string;
2157b34c648bSJoe Perches}
2158b34c648bSJoe Perches
2159b34c648bSJoe Perchessub rtrim {
2160b34c648bSJoe Perches	my ($string) = @_;
2161b34c648bSJoe Perches
2162b34c648bSJoe Perches	$string =~ s/\s+$//;
21633705ce5bSJoe Perches
21643705ce5bSJoe Perches	return $string;
21653705ce5bSJoe Perches}
21663705ce5bSJoe Perches
216752ea8506SJoe Perchessub string_find_replace {
216852ea8506SJoe Perches	my ($string, $find, $replace) = @_;
216952ea8506SJoe Perches
217052ea8506SJoe Perches	$string =~ s/$find/$replace/g;
217152ea8506SJoe Perches
217252ea8506SJoe Perches	return $string;
217352ea8506SJoe Perches}
217452ea8506SJoe Perches
21753705ce5bSJoe Perchessub tabify {
21763705ce5bSJoe Perches	my ($leading) = @_;
21773705ce5bSJoe Perches
21783705ce5bSJoe Perches	my $source_indent = 8;
21793705ce5bSJoe Perches	my $max_spaces_before_tab = $source_indent - 1;
21803705ce5bSJoe Perches	my $spaces_to_tab = " " x $source_indent;
21813705ce5bSJoe Perches
21823705ce5bSJoe Perches	#convert leading spaces to tabs
21833705ce5bSJoe Perches	1 while $leading =~ s@^([\t]*)$spaces_to_tab@$1\t@g;
21843705ce5bSJoe Perches	#Remove spaces before a tab
21853705ce5bSJoe Perches	1 while $leading =~ s@^([\t]*)( {1,$max_spaces_before_tab})\t@$1\t@g;
21863705ce5bSJoe Perches
21873705ce5bSJoe Perches	return "$leading";
21883705ce5bSJoe Perches}
21893705ce5bSJoe Perches
2190d1fe9c09SJoe Perchessub pos_last_openparen {
2191d1fe9c09SJoe Perches	my ($line) = @_;
2192d1fe9c09SJoe Perches
2193d1fe9c09SJoe Perches	my $pos = 0;
2194d1fe9c09SJoe Perches
2195d1fe9c09SJoe Perches	my $opens = $line =~ tr/\(/\(/;
2196d1fe9c09SJoe Perches	my $closes = $line =~ tr/\)/\)/;
2197d1fe9c09SJoe Perches
2198d1fe9c09SJoe Perches	my $last_openparen = 0;
2199d1fe9c09SJoe Perches
2200d1fe9c09SJoe Perches	if (($opens == 0) || ($closes >= $opens)) {
2201d1fe9c09SJoe Perches		return -1;
2202d1fe9c09SJoe Perches	}
2203d1fe9c09SJoe Perches
2204d1fe9c09SJoe Perches	my $len = length($line);
2205d1fe9c09SJoe Perches
2206d1fe9c09SJoe Perches	for ($pos = 0; $pos < $len; $pos++) {
2207d1fe9c09SJoe Perches		my $string = substr($line, $pos);
2208d1fe9c09SJoe Perches		if ($string =~ /^($FuncArg|$balanced_parens)/) {
2209d1fe9c09SJoe Perches			$pos += length($1) - 1;
2210d1fe9c09SJoe Perches		} elsif (substr($line, $pos, 1) eq '(') {
2211d1fe9c09SJoe Perches			$last_openparen = $pos;
2212d1fe9c09SJoe Perches		} elsif (index($string, '(') == -1) {
2213d1fe9c09SJoe Perches			last;
2214d1fe9c09SJoe Perches		}
2215d1fe9c09SJoe Perches	}
2216d1fe9c09SJoe Perches
221791cb5195SJoe Perches	return length(expand_tabs(substr($line, 0, $last_openparen))) + 1;
2218d1fe9c09SJoe Perches}
2219d1fe9c09SJoe Perches
22200a920b5bSAndy Whitcroftsub process {
22210a920b5bSAndy Whitcroft	my $filename = shift;
22220a920b5bSAndy Whitcroft
22230a920b5bSAndy Whitcroft	my $linenr=0;
22240a920b5bSAndy Whitcroft	my $prevline="";
2225c2fdda0dSAndy Whitcroft	my $prevrawline="";
22260a920b5bSAndy Whitcroft	my $stashline="";
2227c2fdda0dSAndy Whitcroft	my $stashrawline="";
22280a920b5bSAndy Whitcroft
22294a0df2efSAndy Whitcroft	my $length;
22300a920b5bSAndy Whitcroft	my $indent;
22310a920b5bSAndy Whitcroft	my $previndent=0;
22320a920b5bSAndy Whitcroft	my $stashindent=0;
22330a920b5bSAndy Whitcroft
2234de7d4f0eSAndy Whitcroft	our $clean = 1;
22350a920b5bSAndy Whitcroft	my $signoff = 0;
22360a920b5bSAndy Whitcroft	my $is_patch = 0;
223729ee1b0cSJoe Perches	my $in_header_lines = $file ? 0 : 1;
223815662b3eSJoe Perches	my $in_commit_log = 0;		#Scanning lines before patch
2239ed43c4e5SAllen Hubbe	my $has_commit_log = 0;		#Encountered lines before patch
2240bf4daf12SJoe Perches	my $commit_log_possible_stack_dump = 0;
22412a076f40SJoe Perches	my $commit_log_long_line = 0;
2242e518e9a5SJoe Perches	my $commit_log_has_diff = 0;
224313f1937eSJoe Perches	my $reported_maintainer_file = 0;
2244fa64205dSPasi Savanainen	my $non_utf8_charset = 0;
2245fa64205dSPasi Savanainen
2246365dd4eaSJoe Perches	my $last_blank_line = 0;
22475e4f6ba5SJoe Perches	my $last_coalesced_string_linenr = -1;
2248365dd4eaSJoe Perches
224913214adfSAndy Whitcroft	our @report = ();
22506c72ffaaSAndy Whitcroft	our $cnt_lines = 0;
22516c72ffaaSAndy Whitcroft	our $cnt_error = 0;
22526c72ffaaSAndy Whitcroft	our $cnt_warn = 0;
22536c72ffaaSAndy Whitcroft	our $cnt_chk = 0;
22546c72ffaaSAndy Whitcroft
22550a920b5bSAndy Whitcroft	# Trace the real file/line as we go.
22560a920b5bSAndy Whitcroft	my $realfile = '';
22570a920b5bSAndy Whitcroft	my $realline = 0;
22580a920b5bSAndy Whitcroft	my $realcnt = 0;
22590a920b5bSAndy Whitcroft	my $here = '';
226077cb8546SJoe Perches	my $context_function;		#undef'd unless there's a known function
22610a920b5bSAndy Whitcroft	my $in_comment = 0;
2262c2fdda0dSAndy Whitcroft	my $comment_edge = 0;
22630a920b5bSAndy Whitcroft	my $first_line = 0;
22641e855726SWolfram Sang	my $p1_prefix = '';
22650a920b5bSAndy Whitcroft
226613214adfSAndy Whitcroft	my $prev_values = 'E';
226713214adfSAndy Whitcroft
226813214adfSAndy Whitcroft	# suppression flags
2269773647a0SAndy Whitcroft	my %suppress_ifbraces;
2270170d3a22SAndy Whitcroft	my %suppress_whiletrailers;
22712b474a1aSAndy Whitcroft	my %suppress_export;
22723e469cdcSAndy Whitcroft	my $suppress_statement = 0;
2273653d4876SAndy Whitcroft
22747e51f197SJoe Perches	my %signatures = ();
2275323c1260SJoe Perches
2276c2fdda0dSAndy Whitcroft	# Pre-scan the patch sanitizing the lines.
2277de7d4f0eSAndy Whitcroft	# Pre-scan the patch looking for any __setup documentation.
2278c2fdda0dSAndy Whitcroft	#
2279de7d4f0eSAndy Whitcroft	my @setup_docs = ();
2280de7d4f0eSAndy Whitcroft	my $setup_docs = 0;
2281773647a0SAndy Whitcroft
2282d8b07710SJoe Perches	my $camelcase_file_seeded = 0;
2283d8b07710SJoe Perches
22849f3a8992SRob Herring	my $checklicenseline = 1;
22859f3a8992SRob Herring
2286773647a0SAndy Whitcroft	sanitise_line_reset();
2287c2fdda0dSAndy Whitcroft	my $line;
2288c2fdda0dSAndy Whitcroft	foreach my $rawline (@rawlines) {
2289773647a0SAndy Whitcroft		$linenr++;
2290773647a0SAndy Whitcroft		$line = $rawline;
2291c2fdda0dSAndy Whitcroft
22923705ce5bSJoe Perches		push(@fixed, $rawline) if ($fix);
22933705ce5bSJoe Perches
2294773647a0SAndy Whitcroft		if ($rawline=~/^\+\+\+\s+(\S+)/) {
2295de7d4f0eSAndy Whitcroft			$setup_docs = 0;
22968c27ceffSMauro Carvalho Chehab			if ($1 =~ m@Documentation/admin-guide/kernel-parameters.rst$@) {
2297de7d4f0eSAndy Whitcroft				$setup_docs = 1;
2298de7d4f0eSAndy Whitcroft			}
2299773647a0SAndy Whitcroft			#next;
2300de7d4f0eSAndy Whitcroft		}
230174fd4f34SJoe Perches		if ($rawline =~ /^\@\@ -\d+(?:,\d+)? \+(\d+)(,(\d+))? \@\@/) {
2302773647a0SAndy Whitcroft			$realline=$1-1;
2303773647a0SAndy Whitcroft			if (defined $2) {
2304773647a0SAndy Whitcroft				$realcnt=$3+1;
2305773647a0SAndy Whitcroft			} else {
2306773647a0SAndy Whitcroft				$realcnt=1+1;
2307773647a0SAndy Whitcroft			}
2308c45dcabdSAndy Whitcroft			$in_comment = 0;
2309773647a0SAndy Whitcroft
2310773647a0SAndy Whitcroft			# Guestimate if this is a continuing comment.  Run
2311773647a0SAndy Whitcroft			# the context looking for a comment "edge".  If this
2312773647a0SAndy Whitcroft			# edge is a close comment then we must be in a comment
2313773647a0SAndy Whitcroft			# at context start.
2314773647a0SAndy Whitcroft			my $edge;
231501fa9147SAndy Whitcroft			my $cnt = $realcnt;
231601fa9147SAndy Whitcroft			for (my $ln = $linenr + 1; $cnt > 0; $ln++) {
231701fa9147SAndy Whitcroft				next if (defined $rawlines[$ln - 1] &&
231801fa9147SAndy Whitcroft					 $rawlines[$ln - 1] =~ /^-/);
231901fa9147SAndy Whitcroft				$cnt--;
232001fa9147SAndy Whitcroft				#print "RAW<$rawlines[$ln - 1]>\n";
2321721c1cb6SAndy Whitcroft				last if (!defined $rawlines[$ln - 1]);
2322fae17daeSAndy Whitcroft				if ($rawlines[$ln - 1] =~ m@(/\*|\*/)@ &&
2323fae17daeSAndy Whitcroft				    $rawlines[$ln - 1] !~ m@"[^"]*(?:/\*|\*/)[^"]*"@) {
2324fae17daeSAndy Whitcroft					($edge) = $1;
2325fae17daeSAndy Whitcroft					last;
2326fae17daeSAndy Whitcroft				}
2327773647a0SAndy Whitcroft			}
2328773647a0SAndy Whitcroft			if (defined $edge && $edge eq '*/') {
2329773647a0SAndy Whitcroft				$in_comment = 1;
2330773647a0SAndy Whitcroft			}
2331773647a0SAndy Whitcroft
2332773647a0SAndy Whitcroft			# Guestimate if this is a continuing comment.  If this
2333773647a0SAndy Whitcroft			# is the start of a diff block and this line starts
2334773647a0SAndy Whitcroft			# ' *' then it is very likely a comment.
2335773647a0SAndy Whitcroft			if (!defined $edge &&
233683242e0cSAndy Whitcroft			    $rawlines[$linenr] =~ m@^.\s*(?:\*\*+| \*)(?:\s|$)@)
2337773647a0SAndy Whitcroft			{
2338773647a0SAndy Whitcroft				$in_comment = 1;
2339773647a0SAndy Whitcroft			}
2340773647a0SAndy Whitcroft
2341773647a0SAndy Whitcroft			##print "COMMENT:$in_comment edge<$edge> $rawline\n";
2342773647a0SAndy Whitcroft			sanitise_line_reset($in_comment);
2343773647a0SAndy Whitcroft
2344171ae1a4SAndy Whitcroft		} elsif ($realcnt && $rawline =~ /^(?:\+| |$)/) {
2345773647a0SAndy Whitcroft			# Standardise the strings and chars within the input to
2346171ae1a4SAndy Whitcroft			# simplify matching -- only bother with positive lines.
2347773647a0SAndy Whitcroft			$line = sanitise_line($rawline);
2348773647a0SAndy Whitcroft		}
2349773647a0SAndy Whitcroft		push(@lines, $line);
2350773647a0SAndy Whitcroft
2351773647a0SAndy Whitcroft		if ($realcnt > 1) {
2352773647a0SAndy Whitcroft			$realcnt-- if ($line =~ /^(?:\+| |$)/);
2353773647a0SAndy Whitcroft		} else {
2354773647a0SAndy Whitcroft			$realcnt = 0;
2355773647a0SAndy Whitcroft		}
2356773647a0SAndy Whitcroft
2357773647a0SAndy Whitcroft		#print "==>$rawline\n";
2358773647a0SAndy Whitcroft		#print "-->$line\n";
2359de7d4f0eSAndy Whitcroft
2360de7d4f0eSAndy Whitcroft		if ($setup_docs && $line =~ /^\+/) {
2361de7d4f0eSAndy Whitcroft			push(@setup_docs, $line);
2362de7d4f0eSAndy Whitcroft		}
2363de7d4f0eSAndy Whitcroft	}
2364de7d4f0eSAndy Whitcroft
23656c72ffaaSAndy Whitcroft	$prefix = '';
23666c72ffaaSAndy Whitcroft
2367773647a0SAndy Whitcroft	$realcnt = 0;
2368773647a0SAndy Whitcroft	$linenr = 0;
2369194f66fcSJoe Perches	$fixlinenr = -1;
23700a920b5bSAndy Whitcroft	foreach my $line (@lines) {
23710a920b5bSAndy Whitcroft		$linenr++;
2372194f66fcSJoe Perches		$fixlinenr++;
23731b5539b1SJoe Perches		my $sline = $line;	#copy of $line
23741b5539b1SJoe Perches		$sline =~ s/$;/ /g;	#with comments as spaces
23750a920b5bSAndy Whitcroft
2376c2fdda0dSAndy Whitcroft		my $rawline = $rawlines[$linenr - 1];
23776c72ffaaSAndy Whitcroft
23780a920b5bSAndy Whitcroft#extract the line range in the file after the patch is applied
2379e518e9a5SJoe Perches		if (!$in_commit_log &&
238074fd4f34SJoe Perches		    $line =~ /^\@\@ -\d+(?:,\d+)? \+(\d+)(,(\d+))? \@\@(.*)/) {
238174fd4f34SJoe Perches			my $context = $4;
23820a920b5bSAndy Whitcroft			$is_patch = 1;
23834a0df2efSAndy Whitcroft			$first_line = $linenr + 1;
23840a920b5bSAndy Whitcroft			$realline=$1-1;
23850a920b5bSAndy Whitcroft			if (defined $2) {
23860a920b5bSAndy Whitcroft				$realcnt=$3+1;
23870a920b5bSAndy Whitcroft			} else {
23880a920b5bSAndy Whitcroft				$realcnt=1+1;
23890a920b5bSAndy Whitcroft			}
2390c2fdda0dSAndy Whitcroft			annotate_reset();
239113214adfSAndy Whitcroft			$prev_values = 'E';
239213214adfSAndy Whitcroft
2393773647a0SAndy Whitcroft			%suppress_ifbraces = ();
2394170d3a22SAndy Whitcroft			%suppress_whiletrailers = ();
23952b474a1aSAndy Whitcroft			%suppress_export = ();
23963e469cdcSAndy Whitcroft			$suppress_statement = 0;
239774fd4f34SJoe Perches			if ($context =~ /\b(\w+)\s*\(/) {
239874fd4f34SJoe Perches				$context_function = $1;
239974fd4f34SJoe Perches			} else {
240074fd4f34SJoe Perches				undef $context_function;
240174fd4f34SJoe Perches			}
24020a920b5bSAndy Whitcroft			next;
24030a920b5bSAndy Whitcroft
24044a0df2efSAndy Whitcroft# track the line number as we move through the hunk, note that
24054a0df2efSAndy Whitcroft# new versions of GNU diff omit the leading space on completely
24064a0df2efSAndy Whitcroft# blank context lines so we need to count that too.
2407773647a0SAndy Whitcroft		} elsif ($line =~ /^( |\+|$)/) {
24080a920b5bSAndy Whitcroft			$realline++;
2409d8aaf121SAndy Whitcroft			$realcnt-- if ($realcnt != 0);
24100a920b5bSAndy Whitcroft
24114a0df2efSAndy Whitcroft			# Measure the line length and indent.
2412c2fdda0dSAndy Whitcroft			($length, $indent) = line_stats($rawline);
24130a920b5bSAndy Whitcroft
24140a920b5bSAndy Whitcroft			# Track the previous line.
24150a920b5bSAndy Whitcroft			($prevline, $stashline) = ($stashline, $line);
24160a920b5bSAndy Whitcroft			($previndent, $stashindent) = ($stashindent, $indent);
2417c2fdda0dSAndy Whitcroft			($prevrawline, $stashrawline) = ($stashrawline, $rawline);
2418c2fdda0dSAndy Whitcroft
2419773647a0SAndy Whitcroft			#warn "line<$line>\n";
24206c72ffaaSAndy Whitcroft
2421d8aaf121SAndy Whitcroft		} elsif ($realcnt == 1) {
2422d8aaf121SAndy Whitcroft			$realcnt--;
24230a920b5bSAndy Whitcroft		}
24240a920b5bSAndy Whitcroft
2425cc77cdcaSAndy Whitcroft		my $hunk_line = ($realcnt != 0);
2426cc77cdcaSAndy Whitcroft
24276c72ffaaSAndy Whitcroft		$here = "#$linenr: " if (!$file);
24286c72ffaaSAndy Whitcroft		$here = "#$realline: " if ($file);
2429773647a0SAndy Whitcroft
24302ac73b4fSJoe Perches		my $found_file = 0;
2431773647a0SAndy Whitcroft		# extract the filename as it passes
24323bf9a009SRabin Vincent		if ($line =~ /^diff --git.*?(\S+)$/) {
24333bf9a009SRabin Vincent			$realfile = $1;
24342b7ab453SJoe Perches			$realfile =~ s@^([^/]*)/@@ if (!$file);
2435270c49a0SJoe Perches			$in_commit_log = 0;
24362ac73b4fSJoe Perches			$found_file = 1;
24373bf9a009SRabin Vincent		} elsif ($line =~ /^\+\+\+\s+(\S+)/) {
2438773647a0SAndy Whitcroft			$realfile = $1;
24392b7ab453SJoe Perches			$realfile =~ s@^([^/]*)/@@ if (!$file);
2440270c49a0SJoe Perches			$in_commit_log = 0;
24411e855726SWolfram Sang
24421e855726SWolfram Sang			$p1_prefix = $1;
2443e2f7aa4bSAndy Whitcroft			if (!$file && $tree && $p1_prefix ne '' &&
2444e2f7aa4bSAndy Whitcroft			    -e "$root/$p1_prefix") {
2445000d1cc1SJoe Perches				WARN("PATCH_PREFIX",
2446000d1cc1SJoe Perches				     "patch prefix '$p1_prefix' exists, appears to be a -p0 patch\n");
24471e855726SWolfram Sang			}
2448773647a0SAndy Whitcroft
2449c1ab3326SAndy Whitcroft			if ($realfile =~ m@^include/asm/@) {
2450000d1cc1SJoe Perches				ERROR("MODIFIED_INCLUDE_ASM",
2451000d1cc1SJoe Perches				      "do not modify files in include/asm, change architecture specific files in include/asm-<architecture>\n" . "$here$rawline\n");
2452773647a0SAndy Whitcroft			}
24532ac73b4fSJoe Perches			$found_file = 1;
24542ac73b4fSJoe Perches		}
24552ac73b4fSJoe Perches
245634d8815fSJoe Perches#make up the handle for any error we report on this line
245734d8815fSJoe Perches		if ($showfile) {
245834d8815fSJoe Perches			$prefix = "$realfile:$realline: "
245934d8815fSJoe Perches		} elsif ($emacs) {
24607d3a9f67SJoe Perches			if ($file) {
24617d3a9f67SJoe Perches				$prefix = "$filename:$realline: ";
24627d3a9f67SJoe Perches			} else {
246334d8815fSJoe Perches				$prefix = "$filename:$linenr: ";
246434d8815fSJoe Perches			}
24657d3a9f67SJoe Perches		}
246634d8815fSJoe Perches
24672ac73b4fSJoe Perches		if ($found_file) {
246885b0ee18SJoe Perches			if (is_maintained_obsolete($realfile)) {
246985b0ee18SJoe Perches				WARN("OBSOLETE",
247085b0ee18SJoe Perches				     "$realfile is marked as 'obsolete' in the MAINTAINERS hierarchy.  No unnecessary modifications please.\n");
247185b0ee18SJoe Perches			}
24727bd7e483SJoe Perches			if ($realfile =~ m@^(?:drivers/net/|net/|drivers/staging/)@) {
24732ac73b4fSJoe Perches				$check = 1;
24742ac73b4fSJoe Perches			} else {
24752ac73b4fSJoe Perches				$check = $check_orig;
24762ac73b4fSJoe Perches			}
24779f3a8992SRob Herring			$checklicenseline = 1;
2478773647a0SAndy Whitcroft			next;
2479773647a0SAndy Whitcroft		}
2480773647a0SAndy Whitcroft
2481389834b6SRandy Dunlap		$here .= "FILE: $realfile:$realline:" if ($realcnt != 0);
24820a920b5bSAndy Whitcroft
2483c2fdda0dSAndy Whitcroft		my $hereline = "$here\n$rawline\n";
2484c2fdda0dSAndy Whitcroft		my $herecurr = "$here\n$rawline\n";
2485c2fdda0dSAndy Whitcroft		my $hereprev = "$here\n$prevrawline\n$rawline\n";
24860a920b5bSAndy Whitcroft
24876c72ffaaSAndy Whitcroft		$cnt_lines++ if ($realcnt != 0);
24886c72ffaaSAndy Whitcroft
2489e518e9a5SJoe Perches# Check if the commit log has what seems like a diff which can confuse patch
2490e518e9a5SJoe Perches		if ($in_commit_log && !$commit_log_has_diff &&
2491e518e9a5SJoe Perches		    (($line =~ m@^\s+diff\b.*a/[\w/]+@ &&
2492e518e9a5SJoe Perches		      $line =~ m@^\s+diff\b.*a/([\w/]+)\s+b/$1\b@) ||
2493e518e9a5SJoe Perches		     $line =~ m@^\s*(?:\-\-\-\s+a/|\+\+\+\s+b/)@ ||
2494e518e9a5SJoe Perches		     $line =~ m/^\s*\@\@ \-\d+,\d+ \+\d+,\d+ \@\@/)) {
2495e518e9a5SJoe Perches			ERROR("DIFF_IN_COMMIT_MSG",
2496e518e9a5SJoe Perches			      "Avoid using diff content in the commit message - patch(1) might not work\n" . $herecurr);
2497e518e9a5SJoe Perches			$commit_log_has_diff = 1;
2498e518e9a5SJoe Perches		}
2499e518e9a5SJoe Perches
25003bf9a009SRabin Vincent# Check for incorrect file permissions
25013bf9a009SRabin Vincent		if ($line =~ /^new (file )?mode.*[7531]\d{0,2}$/) {
25023bf9a009SRabin Vincent			my $permhere = $here . "FILE: $realfile\n";
250304db4d25SJoe Perches			if ($realfile !~ m@scripts/@ &&
250404db4d25SJoe Perches			    $realfile !~ /\.(py|pl|awk|sh)$/) {
2505000d1cc1SJoe Perches				ERROR("EXECUTE_PERMISSIONS",
2506000d1cc1SJoe Perches				      "do not set execute permissions for source files\n" . $permhere);
25073bf9a009SRabin Vincent			}
25083bf9a009SRabin Vincent		}
25093bf9a009SRabin Vincent
251020112475SJoe Perches# Check the patch for a signoff:
2511d8aaf121SAndy Whitcroft		if ($line =~ /^\s*signed-off-by:/i) {
25124a0df2efSAndy Whitcroft			$signoff++;
251315662b3eSJoe Perches			$in_commit_log = 0;
25140a920b5bSAndy Whitcroft		}
251520112475SJoe Perches
2516e0d975b1SJoe Perches# Check if MAINTAINERS is being updated.  If so, there's probably no need to
2517e0d975b1SJoe Perches# emit the "does MAINTAINERS need updating?" message on file add/move/delete
2518e0d975b1SJoe Perches		if ($line =~ /^\s*MAINTAINERS\s*\|/) {
2519e0d975b1SJoe Perches			$reported_maintainer_file = 1;
2520e0d975b1SJoe Perches		}
2521e0d975b1SJoe Perches
252220112475SJoe Perches# Check signature styles
2523270c49a0SJoe Perches		if (!$in_header_lines &&
2524ce0338dfSJoe Perches		    $line =~ /^(\s*)([a-z0-9_-]+by:|$signature_tags)(\s*)(.*)/i) {
252520112475SJoe Perches			my $space_before = $1;
252620112475SJoe Perches			my $sign_off = $2;
252720112475SJoe Perches			my $space_after = $3;
252820112475SJoe Perches			my $email = $4;
252920112475SJoe Perches			my $ucfirst_sign_off = ucfirst(lc($sign_off));
253020112475SJoe Perches
2531ce0338dfSJoe Perches			if ($sign_off !~ /$signature_tags/) {
2532ce0338dfSJoe Perches				WARN("BAD_SIGN_OFF",
2533ce0338dfSJoe Perches				     "Non-standard signature: $sign_off\n" . $herecurr);
2534ce0338dfSJoe Perches			}
253520112475SJoe Perches			if (defined $space_before && $space_before ne "") {
25363705ce5bSJoe Perches				if (WARN("BAD_SIGN_OFF",
25373705ce5bSJoe Perches					 "Do not use whitespace before $ucfirst_sign_off\n" . $herecurr) &&
25383705ce5bSJoe Perches				    $fix) {
2539194f66fcSJoe Perches					$fixed[$fixlinenr] =
25403705ce5bSJoe Perches					    "$ucfirst_sign_off $email";
25413705ce5bSJoe Perches				}
254220112475SJoe Perches			}
254320112475SJoe Perches			if ($sign_off =~ /-by:$/i && $sign_off ne $ucfirst_sign_off) {
25443705ce5bSJoe Perches				if (WARN("BAD_SIGN_OFF",
25453705ce5bSJoe Perches					 "'$ucfirst_sign_off' is the preferred signature form\n" . $herecurr) &&
25463705ce5bSJoe Perches				    $fix) {
2547194f66fcSJoe Perches					$fixed[$fixlinenr] =
25483705ce5bSJoe Perches					    "$ucfirst_sign_off $email";
25493705ce5bSJoe Perches				}
25503705ce5bSJoe Perches
255120112475SJoe Perches			}
255220112475SJoe Perches			if (!defined $space_after || $space_after ne " ") {
25533705ce5bSJoe Perches				if (WARN("BAD_SIGN_OFF",
25543705ce5bSJoe Perches					 "Use a single space after $ucfirst_sign_off\n" . $herecurr) &&
25553705ce5bSJoe Perches				    $fix) {
2556194f66fcSJoe Perches					$fixed[$fixlinenr] =
25573705ce5bSJoe Perches					    "$ucfirst_sign_off $email";
25583705ce5bSJoe Perches				}
255920112475SJoe Perches			}
256020112475SJoe Perches
256120112475SJoe Perches			my ($email_name, $email_address, $comment) = parse_email($email);
256220112475SJoe Perches			my $suggested_email = format_email(($email_name, $email_address));
256320112475SJoe Perches			if ($suggested_email eq "") {
2564000d1cc1SJoe Perches				ERROR("BAD_SIGN_OFF",
2565000d1cc1SJoe Perches				      "Unrecognized email address: '$email'\n" . $herecurr);
256620112475SJoe Perches			} else {
256720112475SJoe Perches				my $dequoted = $suggested_email;
256820112475SJoe Perches				$dequoted =~ s/^"//;
256920112475SJoe Perches				$dequoted =~ s/" </ </;
257020112475SJoe Perches				# Don't force email to have quotes
257120112475SJoe Perches				# Allow just an angle bracketed address
257220112475SJoe Perches				if ("$dequoted$comment" ne $email &&
257320112475SJoe Perches				    "<$email_address>$comment" ne $email &&
257420112475SJoe Perches				    "$suggested_email$comment" ne $email) {
2575000d1cc1SJoe Perches					WARN("BAD_SIGN_OFF",
2576000d1cc1SJoe Perches					     "email address '$email' might be better as '$suggested_email$comment'\n" . $herecurr);
257720112475SJoe Perches				}
25780a920b5bSAndy Whitcroft			}
25797e51f197SJoe Perches
25807e51f197SJoe Perches# Check for duplicate signatures
25817e51f197SJoe Perches			my $sig_nospace = $line;
25827e51f197SJoe Perches			$sig_nospace =~ s/\s//g;
25837e51f197SJoe Perches			$sig_nospace = lc($sig_nospace);
25847e51f197SJoe Perches			if (defined $signatures{$sig_nospace}) {
25857e51f197SJoe Perches				WARN("BAD_SIGN_OFF",
25867e51f197SJoe Perches				     "Duplicate signature\n" . $herecurr);
25877e51f197SJoe Perches			} else {
25887e51f197SJoe Perches				$signatures{$sig_nospace} = 1;
25897e51f197SJoe Perches			}
25900a920b5bSAndy Whitcroft		}
25910a920b5bSAndy Whitcroft
2592a2fe16b9SJoe Perches# Check email subject for common tools that don't need to be mentioned
2593a2fe16b9SJoe Perches		if ($in_header_lines &&
2594a2fe16b9SJoe Perches		    $line =~ /^Subject:.*\b(?:checkpatch|sparse|smatch)\b[^:]/i) {
2595a2fe16b9SJoe Perches			WARN("EMAIL_SUBJECT",
2596a2fe16b9SJoe Perches			     "A patch subject line should describe the change not the tool that found it\n" . $herecurr);
2597a2fe16b9SJoe Perches		}
2598a2fe16b9SJoe Perches
25999b3189ebSJoe Perches# Check for old stable address
26009b3189ebSJoe Perches		if ($line =~ /^\s*cc:\s*.*<?\bstable\@kernel\.org\b>?.*$/i) {
26019b3189ebSJoe Perches			ERROR("STABLE_ADDRESS",
26029b3189ebSJoe Perches			      "The 'stable' address should be 'stable\@vger.kernel.org'\n" . $herecurr);
26039b3189ebSJoe Perches		}
26049b3189ebSJoe Perches
26057ebd05efSChristopher Covington# Check for unwanted Gerrit info
26067ebd05efSChristopher Covington		if ($in_commit_log && $line =~ /^\s*change-id:/i) {
26077ebd05efSChristopher Covington			ERROR("GERRIT_CHANGE_ID",
26087ebd05efSChristopher Covington			      "Remove Gerrit Change-Id's before submitting upstream.\n" . $herecurr);
26097ebd05efSChristopher Covington		}
26107ebd05efSChristopher Covington
2611369c8dd3SJoe Perches# Check if the commit log is in a possible stack dump
2612369c8dd3SJoe Perches		if ($in_commit_log && !$commit_log_possible_stack_dump &&
2613369c8dd3SJoe Perches		    ($line =~ /^\s*(?:WARNING:|BUG:)/ ||
2614369c8dd3SJoe Perches		     $line =~ /^\s*\[\s*\d+\.\d{6,6}\s*\]/ ||
2615369c8dd3SJoe Perches					# timestamp
2616369c8dd3SJoe Perches		     $line =~ /^\s*\[\<[0-9a-fA-F]{8,}\>\]/)) {
2617369c8dd3SJoe Perches					# stack dump address
2618369c8dd3SJoe Perches			$commit_log_possible_stack_dump = 1;
2619369c8dd3SJoe Perches		}
2620369c8dd3SJoe Perches
26212a076f40SJoe Perches# Check for line lengths > 75 in commit log, warn once
26222a076f40SJoe Perches		if ($in_commit_log && !$commit_log_long_line &&
2623bf4daf12SJoe Perches		    length($line) > 75 &&
2624bf4daf12SJoe Perches		    !($line =~ /^\s*[a-zA-Z0-9_\/\.]+\s+\|\s+\d+/ ||
2625bf4daf12SJoe Perches					# file delta changes
2626bf4daf12SJoe Perches		      $line =~ /^\s*(?:[\w\.\-]+\/)++[\w\.\-]+:/ ||
2627bf4daf12SJoe Perches					# filename then :
2628bf4daf12SJoe Perches		      $line =~ /^\s*(?:Fixes:|Link:)/i ||
2629bf4daf12SJoe Perches					# A Fixes: or Link: line
2630bf4daf12SJoe Perches		      $commit_log_possible_stack_dump)) {
26312a076f40SJoe Perches			WARN("COMMIT_LOG_LONG_LINE",
26322a076f40SJoe Perches			     "Possible unwrapped commit description (prefer a maximum 75 chars per line)\n" . $herecurr);
26332a076f40SJoe Perches			$commit_log_long_line = 1;
26342a076f40SJoe Perches		}
26352a076f40SJoe Perches
2636bf4daf12SJoe Perches# Reset possible stack dump if a blank line is found
2637bf4daf12SJoe Perches		if ($in_commit_log && $commit_log_possible_stack_dump &&
2638bf4daf12SJoe Perches		    $line =~ /^\s*$/) {
2639bf4daf12SJoe Perches			$commit_log_possible_stack_dump = 0;
2640bf4daf12SJoe Perches		}
2641bf4daf12SJoe Perches
26420d7835fcSJoe Perches# Check for git id commit length and improperly formed commit descriptions
2643369c8dd3SJoe Perches		if ($in_commit_log && !$commit_log_possible_stack_dump &&
2644aab38f51SJoe Perches		    $line !~ /^\s*(?:Link|Patchwork|http|https|BugLink):/i &&
2645e882dbfcSWei Wang		    $line !~ /^This reverts commit [0-9a-f]{7,40}/ &&
2646fe043ea1SJoe Perches		    ($line =~ /\bcommit\s+[0-9a-f]{5,}\b/i ||
2647aab38f51SJoe Perches		     ($line =~ /(?:\s|^)[0-9a-f]{12,40}(?:[\s"'\(\[]|$)/i &&
2648369c8dd3SJoe Perches		      $line !~ /[\<\[][0-9a-f]{12,40}[\>\]]/i &&
2649bf4daf12SJoe Perches		      $line !~ /\bfixes:\s*[0-9a-f]{12,40}/i))) {
2650fe043ea1SJoe Perches			my $init_char = "c";
2651fe043ea1SJoe Perches			my $orig_commit = "";
26520d7835fcSJoe Perches			my $short = 1;
26530d7835fcSJoe Perches			my $long = 0;
26540d7835fcSJoe Perches			my $case = 1;
26550d7835fcSJoe Perches			my $space = 1;
26560d7835fcSJoe Perches			my $hasdesc = 0;
265719c146a6SJoe Perches			my $hasparens = 0;
26580d7835fcSJoe Perches			my $id = '0123456789ab';
26590d7835fcSJoe Perches			my $orig_desc = "commit description";
26600d7835fcSJoe Perches			my $description = "";
26610d7835fcSJoe Perches
2662fe043ea1SJoe Perches			if ($line =~ /\b(c)ommit\s+([0-9a-f]{5,})\b/i) {
2663fe043ea1SJoe Perches				$init_char = $1;
2664fe043ea1SJoe Perches				$orig_commit = lc($2);
2665fe043ea1SJoe Perches			} elsif ($line =~ /\b([0-9a-f]{12,40})\b/i) {
2666fe043ea1SJoe Perches				$orig_commit = lc($1);
2667fe043ea1SJoe Perches			}
2668fe043ea1SJoe Perches
26690d7835fcSJoe Perches			$short = 0 if ($line =~ /\bcommit\s+[0-9a-f]{12,40}/i);
26700d7835fcSJoe Perches			$long = 1 if ($line =~ /\bcommit\s+[0-9a-f]{41,}/i);
26710d7835fcSJoe Perches			$space = 0 if ($line =~ /\bcommit [0-9a-f]/i);
26720d7835fcSJoe Perches			$case = 0 if ($line =~ /\b[Cc]ommit\s+[0-9a-f]{5,40}[^A-F]/);
26730d7835fcSJoe Perches			if ($line =~ /\bcommit\s+[0-9a-f]{5,}\s+\("([^"]+)"\)/i) {
26740d7835fcSJoe Perches				$orig_desc = $1;
267519c146a6SJoe Perches				$hasparens = 1;
26760d7835fcSJoe Perches			} elsif ($line =~ /\bcommit\s+[0-9a-f]{5,}\s*$/i &&
26770d7835fcSJoe Perches				 defined $rawlines[$linenr] &&
26780d7835fcSJoe Perches				 $rawlines[$linenr] =~ /^\s*\("([^"]+)"\)/) {
26790d7835fcSJoe Perches				$orig_desc = $1;
268019c146a6SJoe Perches				$hasparens = 1;
2681b671fde0SJoe Perches			} elsif ($line =~ /\bcommit\s+[0-9a-f]{5,}\s+\("[^"]+$/i &&
2682b671fde0SJoe Perches				 defined $rawlines[$linenr] &&
2683b671fde0SJoe Perches				 $rawlines[$linenr] =~ /^\s*[^"]+"\)/) {
2684b671fde0SJoe Perches				$line =~ /\bcommit\s+[0-9a-f]{5,}\s+\("([^"]+)$/i;
2685b671fde0SJoe Perches				$orig_desc = $1;
2686b671fde0SJoe Perches				$rawlines[$linenr] =~ /^\s*([^"]+)"\)/;
2687b671fde0SJoe Perches				$orig_desc .= " " . $1;
268819c146a6SJoe Perches				$hasparens = 1;
26890d7835fcSJoe Perches			}
26900d7835fcSJoe Perches
26910d7835fcSJoe Perches			($id, $description) = git_commit_info($orig_commit,
26920d7835fcSJoe Perches							      $id, $orig_desc);
26930d7835fcSJoe Perches
2694948b133aSHeinrich Schuchardt			if (defined($id) &&
2695948b133aSHeinrich Schuchardt			   ($short || $long || $space || $case || ($orig_desc ne $description) || !$hasparens)) {
2696d311cd44SJoe Perches				ERROR("GIT_COMMIT_ID",
26970d7835fcSJoe Perches				      "Please use git commit description style 'commit <12+ chars of sha1> (\"<title line>\")' - ie: '${init_char}ommit $id (\"$description\")'\n" . $herecurr);
26980d7835fcSJoe Perches			}
2699d311cd44SJoe Perches		}
2700d311cd44SJoe Perches
270113f1937eSJoe Perches# Check for added, moved or deleted files
270213f1937eSJoe Perches		if (!$reported_maintainer_file && !$in_commit_log &&
270313f1937eSJoe Perches		    ($line =~ /^(?:new|deleted) file mode\s*\d+\s*$/ ||
270413f1937eSJoe Perches		     $line =~ /^rename (?:from|to) [\w\/\.\-]+\s*$/ ||
270513f1937eSJoe Perches		     ($line =~ /\{\s*([\w\/\.\-]*)\s*\=\>\s*([\w\/\.\-]*)\s*\}/ &&
270613f1937eSJoe Perches		      (defined($1) || defined($2))))) {
2707a82603a8SAndrew Jeffery			$is_patch = 1;
270813f1937eSJoe Perches			$reported_maintainer_file = 1;
270913f1937eSJoe Perches			WARN("FILE_PATH_CHANGES",
271013f1937eSJoe Perches			     "added, moved or deleted file(s), does MAINTAINERS need updating?\n" . $herecurr);
271113f1937eSJoe Perches		}
271213f1937eSJoe Perches
271300df344fSAndy Whitcroft# Check for wrappage within a valid hunk of the file
27148905a67cSAndy Whitcroft		if ($realcnt != 0 && $line !~ m{^(?:\+|-| |\\ No newline|$)}) {
2715000d1cc1SJoe Perches			ERROR("CORRUPTED_PATCH",
2716000d1cc1SJoe Perches			      "patch seems to be corrupt (line wrapped?)\n" .
27176c72ffaaSAndy Whitcroft				$herecurr) if (!$emitted_corrupt++);
2718de7d4f0eSAndy Whitcroft		}
2719de7d4f0eSAndy Whitcroft
2720de7d4f0eSAndy Whitcroft# UTF-8 regex found at http://www.w3.org/International/questions/qa-forms-utf-8.en.php
2721de7d4f0eSAndy Whitcroft		if (($realfile =~ /^$/ || $line =~ /^\+/) &&
2722171ae1a4SAndy Whitcroft		    $rawline !~ m/^$UTF8*$/) {
2723171ae1a4SAndy Whitcroft			my ($utf8_prefix) = ($rawline =~ /^($UTF8*)/);
2724171ae1a4SAndy Whitcroft
2725171ae1a4SAndy Whitcroft			my $blank = copy_spacing($rawline);
2726171ae1a4SAndy Whitcroft			my $ptr = substr($blank, 0, length($utf8_prefix)) . "^";
2727171ae1a4SAndy Whitcroft			my $hereptr = "$hereline$ptr\n";
2728171ae1a4SAndy Whitcroft
272934d99219SJoe Perches			CHK("INVALID_UTF8",
2730000d1cc1SJoe Perches			    "Invalid UTF-8, patch and commit message should be encoded in UTF-8\n" . $hereptr);
273100df344fSAndy Whitcroft		}
27320a920b5bSAndy Whitcroft
273315662b3eSJoe Perches# Check if it's the start of a commit log
273415662b3eSJoe Perches# (not a header line and we haven't seen the patch filename)
273515662b3eSJoe Perches		if ($in_header_lines && $realfile =~ /^$/ &&
2736eb3a58deSJoe Perches		    !($rawline =~ /^\s+(?:\S|$)/ ||
2737eb3a58deSJoe Perches		      $rawline =~ /^(?:commit\b|from\b|[\w-]+:)/i)) {
273815662b3eSJoe Perches			$in_header_lines = 0;
273915662b3eSJoe Perches			$in_commit_log = 1;
2740ed43c4e5SAllen Hubbe			$has_commit_log = 1;
274115662b3eSJoe Perches		}
274215662b3eSJoe Perches
2743fa64205dSPasi Savanainen# Check if there is UTF-8 in a commit log when a mail header has explicitly
2744fa64205dSPasi Savanainen# declined it, i.e defined some charset where it is missing.
2745fa64205dSPasi Savanainen		if ($in_header_lines &&
2746fa64205dSPasi Savanainen		    $rawline =~ /^Content-Type:.+charset="(.+)".*$/ &&
2747fa64205dSPasi Savanainen		    $1 !~ /utf-8/i) {
2748fa64205dSPasi Savanainen			$non_utf8_charset = 1;
2749fa64205dSPasi Savanainen		}
2750fa64205dSPasi Savanainen
2751fa64205dSPasi Savanainen		if ($in_commit_log && $non_utf8_charset && $realfile =~ /^$/ &&
275215662b3eSJoe Perches		    $rawline =~ /$NON_ASCII_UTF8/) {
2753fa64205dSPasi Savanainen			WARN("UTF8_BEFORE_PATCH",
275415662b3eSJoe Perches			    "8-bit UTF-8 used in possible commit log\n" . $herecurr);
275515662b3eSJoe Perches		}
275615662b3eSJoe Perches
2757d6430f71SJoe Perches# Check for absolute kernel paths in commit message
2758d6430f71SJoe Perches		if ($tree && $in_commit_log) {
2759d6430f71SJoe Perches			while ($line =~ m{(?:^|\s)(/\S*)}g) {
2760d6430f71SJoe Perches				my $file = $1;
2761d6430f71SJoe Perches
2762d6430f71SJoe Perches				if ($file =~ m{^(.*?)(?::\d+)+:?$} &&
2763d6430f71SJoe Perches				    check_absolute_file($1, $herecurr)) {
2764d6430f71SJoe Perches					#
2765d6430f71SJoe Perches				} else {
2766d6430f71SJoe Perches					check_absolute_file($file, $herecurr);
2767d6430f71SJoe Perches				}
2768d6430f71SJoe Perches			}
2769d6430f71SJoe Perches		}
2770d6430f71SJoe Perches
277166b47b4aSKees Cook# Check for various typo / spelling mistakes
277266d7a382SJoe Perches		if (defined($misspellings) &&
277366d7a382SJoe Perches		    ($in_commit_log || $line =~ /^(?:\+|Subject:)/i)) {
2774ebfd7d62SJoe Perches			while ($rawline =~ /(?:^|[^a-z@])($misspellings)(?:\b|$|[^a-z@])/gi) {
277566b47b4aSKees Cook				my $typo = $1;
277666b47b4aSKees Cook				my $typo_fix = $spelling_fix{lc($typo)};
277766b47b4aSKees Cook				$typo_fix = ucfirst($typo_fix) if ($typo =~ /^[A-Z]/);
277866b47b4aSKees Cook				$typo_fix = uc($typo_fix) if ($typo =~ /^[A-Z]+$/);
27790675a8fbSJean Delvare				my $msg_level = \&WARN;
27800675a8fbSJean Delvare				$msg_level = \&CHK if ($file);
27810675a8fbSJean Delvare				if (&{$msg_level}("TYPO_SPELLING",
278266b47b4aSKees Cook						  "'$typo' may be misspelled - perhaps '$typo_fix'?\n" . $herecurr) &&
278366b47b4aSKees Cook				    $fix) {
278466b47b4aSKees Cook					$fixed[$fixlinenr] =~ s/(^|[^A-Za-z@])($typo)($|[^A-Za-z@])/$1$typo_fix$3/;
278566b47b4aSKees Cook				}
278666b47b4aSKees Cook			}
278766b47b4aSKees Cook		}
278866b47b4aSKees Cook
278930670854SAndy Whitcroft# ignore non-hunk lines and lines being removed
279030670854SAndy Whitcroft		next if (!$hunk_line || $line =~ /^-/);
279100df344fSAndy Whitcroft
27920a920b5bSAndy Whitcroft#trailing whitespace
27939c0ca6f9SAndy Whitcroft		if ($line =~ /^\+.*\015/) {
2794c2fdda0dSAndy Whitcroft			my $herevet = "$here\n" . cat_vet($rawline) . "\n";
2795d5e616fcSJoe Perches			if (ERROR("DOS_LINE_ENDINGS",
2796d5e616fcSJoe Perches				  "DOS line endings\n" . $herevet) &&
2797d5e616fcSJoe Perches			    $fix) {
2798194f66fcSJoe Perches				$fixed[$fixlinenr] =~ s/[\s\015]+$//;
2799d5e616fcSJoe Perches			}
2800c2fdda0dSAndy Whitcroft		} elsif ($rawline =~ /^\+.*\S\s+$/ || $rawline =~ /^\+\s+$/) {
2801c2fdda0dSAndy Whitcroft			my $herevet = "$here\n" . cat_vet($rawline) . "\n";
28023705ce5bSJoe Perches			if (ERROR("TRAILING_WHITESPACE",
28033705ce5bSJoe Perches				  "trailing whitespace\n" . $herevet) &&
28043705ce5bSJoe Perches			    $fix) {
2805194f66fcSJoe Perches				$fixed[$fixlinenr] =~ s/\s+$//;
28063705ce5bSJoe Perches			}
28073705ce5bSJoe Perches
2808d2c0a235SAndy Whitcroft			$rpt_cleaners = 1;
28090a920b5bSAndy Whitcroft		}
28105368df20SAndy Whitcroft
28114783f894SJosh Triplett# Check for FSF mailing addresses.
2812109d8cb2SAlexander Duyck		if ($rawline =~ /\bwrite to the Free/i ||
28131bde561eSMatthew Wilcox		    $rawline =~ /\b675\s+Mass\s+Ave/i ||
28143e2232f2SJoe Perches		    $rawline =~ /\b59\s+Temple\s+Pl/i ||
28153e2232f2SJoe Perches		    $rawline =~ /\b51\s+Franklin\s+St/i) {
28164783f894SJosh Triplett			my $herevet = "$here\n" . cat_vet($rawline) . "\n";
28170675a8fbSJean Delvare			my $msg_level = \&ERROR;
28180675a8fbSJean Delvare			$msg_level = \&CHK if ($file);
28190675a8fbSJean Delvare			&{$msg_level}("FSF_MAILING_ADDRESS",
28204783f894SJosh 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)
28214783f894SJosh Triplett		}
28224783f894SJosh Triplett
28233354957aSAndi Kleen# check for Kconfig help text having a real description
28249fe287d7SAndy Whitcroft# Only applies when adding the entry originally, after that we do not have
28259fe287d7SAndy Whitcroft# sufficient context to determine whether it is indeed long enough.
28263354957aSAndi Kleen		if ($realfile =~ /Kconfig/ &&
2827678ae162SUlf Magnusson		    # 'choice' is usually the last thing on the line (though
2828678ae162SUlf Magnusson		    # Kconfig supports named choices), so use a word boundary
2829678ae162SUlf Magnusson		    # (\b) rather than a whitespace character (\s)
2830678ae162SUlf Magnusson		    $line =~ /^\+\s*(?:config|menuconfig|choice)\b/) {
28313354957aSAndi Kleen			my $length = 0;
28329fe287d7SAndy Whitcroft			my $cnt = $realcnt;
28339fe287d7SAndy Whitcroft			my $ln = $linenr + 1;
28349fe287d7SAndy Whitcroft			my $f;
2835a1385803SAndy Whitcroft			my $is_start = 0;
28369fe287d7SAndy Whitcroft			my $is_end = 0;
2837a1385803SAndy Whitcroft			for (; $cnt > 0 && defined $lines[$ln - 1]; $ln++) {
28389fe287d7SAndy Whitcroft				$f = $lines[$ln - 1];
28399fe287d7SAndy Whitcroft				$cnt-- if ($lines[$ln - 1] !~ /^-/);
28409fe287d7SAndy Whitcroft				$is_end = $lines[$ln - 1] =~ /^\+/;
28419fe287d7SAndy Whitcroft
28429fe287d7SAndy Whitcroft				next if ($f =~ /^-/);
28438d73e0e7SJoe Perches				last if (!$file && $f =~ /^\@\@/);
2844a1385803SAndy Whitcroft
284586adf1a0SUlf Magnusson				if ($lines[$ln - 1] =~ /^\+\s*(?:bool|tristate|prompt)\s*["']/) {
2846a1385803SAndy Whitcroft					$is_start = 1;
284784af7a61SUlf Magnusson				} elsif ($lines[$ln - 1] =~ /^\+\s*(?:help|---help---)\s*$/) {
284884af7a61SUlf Magnusson					if ($lines[$ln - 1] =~ "---help---") {
284984af7a61SUlf Magnusson						WARN("CONFIG_DESCRIPTION",
285084af7a61SUlf Magnusson						     "prefer 'help' over '---help---' for new help texts\n" . $herecurr);
285184af7a61SUlf Magnusson					}
2852a1385803SAndy Whitcroft					$length = -1;
2853a1385803SAndy Whitcroft				}
2854a1385803SAndy Whitcroft
28559fe287d7SAndy Whitcroft				$f =~ s/^.//;
28563354957aSAndi Kleen				$f =~ s/#.*//;
28573354957aSAndi Kleen				$f =~ s/^\s+//;
28583354957aSAndi Kleen				next if ($f =~ /^$/);
2859678ae162SUlf Magnusson
2860678ae162SUlf Magnusson				# This only checks context lines in the patch
2861678ae162SUlf Magnusson				# and so hopefully shouldn't trigger false
2862678ae162SUlf Magnusson				# positives, even though some of these are
2863678ae162SUlf Magnusson				# common words in help texts
2864678ae162SUlf Magnusson				if ($f =~ /^\s*(?:config|menuconfig|choice|endchoice|
2865678ae162SUlf Magnusson						  if|endif|menu|endmenu|source)\b/x) {
28669fe287d7SAndy Whitcroft					$is_end = 1;
28679fe287d7SAndy Whitcroft					last;
28689fe287d7SAndy Whitcroft				}
28693354957aSAndi Kleen				$length++;
28703354957aSAndi Kleen			}
287156193274SVadim Bendebury			if ($is_start && $is_end && $length < $min_conf_desc_length) {
2872000d1cc1SJoe Perches				WARN("CONFIG_DESCRIPTION",
287356193274SVadim Bendebury				     "please write a paragraph that describes the config symbol fully\n" . $herecurr);
287456193274SVadim Bendebury			}
2875a1385803SAndy Whitcroft			#print "is_start<$is_start> is_end<$is_end> length<$length>\n";
28763354957aSAndi Kleen		}
28773354957aSAndi Kleen
2878628f91a2SJoe Perches# check for MAINTAINERS entries that don't have the right form
2879628f91a2SJoe Perches		if ($realfile =~ /^MAINTAINERS$/ &&
2880628f91a2SJoe Perches		    $rawline =~ /^\+[A-Z]:/ &&
2881628f91a2SJoe Perches		    $rawline !~ /^\+[A-Z]:\t\S/) {
2882628f91a2SJoe Perches			if (WARN("MAINTAINERS_STYLE",
2883628f91a2SJoe Perches				 "MAINTAINERS entries use one tab after TYPE:\n" . $herecurr) &&
2884628f91a2SJoe Perches			    $fix) {
2885628f91a2SJoe Perches				$fixed[$fixlinenr] =~ s/^(\+[A-Z]):\s*/$1:\t/;
2886628f91a2SJoe Perches			}
2887628f91a2SJoe Perches		}
2888628f91a2SJoe Perches
2889327953e9SChristoph Jaeger# discourage the use of boolean for type definition attributes of Kconfig options
2890327953e9SChristoph Jaeger		if ($realfile =~ /Kconfig/ &&
2891327953e9SChristoph Jaeger		    $line =~ /^\+\s*\bboolean\b/) {
2892327953e9SChristoph Jaeger			WARN("CONFIG_TYPE_BOOLEAN",
2893327953e9SChristoph Jaeger			     "Use of boolean is deprecated, please use bool instead.\n" . $herecurr);
2894327953e9SChristoph Jaeger		}
2895327953e9SChristoph Jaeger
2896c68e5878SArnaud Lacombe		if (($realfile =~ /Makefile.*/ || $realfile =~ /Kbuild.*/) &&
2897c68e5878SArnaud Lacombe		    ($line =~ /\+(EXTRA_[A-Z]+FLAGS).*/)) {
2898c68e5878SArnaud Lacombe			my $flag = $1;
2899c68e5878SArnaud Lacombe			my $replacement = {
2900c68e5878SArnaud Lacombe				'EXTRA_AFLAGS' =>   'asflags-y',
2901c68e5878SArnaud Lacombe				'EXTRA_CFLAGS' =>   'ccflags-y',
2902c68e5878SArnaud Lacombe				'EXTRA_CPPFLAGS' => 'cppflags-y',
2903c68e5878SArnaud Lacombe				'EXTRA_LDFLAGS' =>  'ldflags-y',
2904c68e5878SArnaud Lacombe			};
2905c68e5878SArnaud Lacombe
2906c68e5878SArnaud Lacombe			WARN("DEPRECATED_VARIABLE",
2907c68e5878SArnaud Lacombe			     "Use of $flag is deprecated, please use \`$replacement->{$flag} instead.\n" . $herecurr) if ($replacement->{$flag});
2908c68e5878SArnaud Lacombe		}
2909c68e5878SArnaud Lacombe
2910bff5da43SRob Herring# check for DT compatible documentation
29117dd05b38SFlorian Vaussard		if (defined $root &&
29127dd05b38SFlorian Vaussard			(($realfile =~ /\.dtsi?$/ && $line =~ /^\+\s*compatible\s*=\s*\"/) ||
29137dd05b38SFlorian Vaussard			 ($realfile =~ /\.[ch]$/ && $line =~ /^\+.*\.compatible\s*=\s*\"/))) {
29147dd05b38SFlorian Vaussard
2915bff5da43SRob Herring			my @compats = $rawline =~ /\"([a-zA-Z0-9\-\,\.\+_]+)\"/g;
2916bff5da43SRob Herring
2917cc93319bSFlorian Vaussard			my $dt_path = $root . "/Documentation/devicetree/bindings/";
2918cc93319bSFlorian Vaussard			my $vp_file = $dt_path . "vendor-prefixes.txt";
2919cc93319bSFlorian Vaussard
2920bff5da43SRob Herring			foreach my $compat (@compats) {
2921bff5da43SRob Herring				my $compat2 = $compat;
2922185d566bSRob Herring				$compat2 =~ s/\,[a-zA-Z0-9]*\-/\,<\.\*>\-/;
2923185d566bSRob Herring				my $compat3 = $compat;
2924185d566bSRob Herring				$compat3 =~ s/\,([a-z]*)[0-9]*\-/\,$1<\.\*>\-/;
2925185d566bSRob Herring				`grep -Erq "$compat|$compat2|$compat3" $dt_path`;
2926bff5da43SRob Herring				if ( $? >> 8 ) {
2927bff5da43SRob Herring					WARN("UNDOCUMENTED_DT_STRING",
2928bff5da43SRob Herring					     "DT compatible string \"$compat\" appears un-documented -- check $dt_path\n" . $herecurr);
2929bff5da43SRob Herring				}
2930bff5da43SRob Herring
29314fbf32a6SFlorian Vaussard				next if $compat !~ /^([a-zA-Z0-9\-]+)\,/;
29324fbf32a6SFlorian Vaussard				my $vendor = $1;
2933cc93319bSFlorian Vaussard				`grep -Eq "^$vendor\\b" $vp_file`;
2934bff5da43SRob Herring				if ( $? >> 8 ) {
2935bff5da43SRob Herring					WARN("UNDOCUMENTED_DT_STRING",
2936cc93319bSFlorian Vaussard					     "DT compatible string vendor \"$vendor\" appears un-documented -- check $vp_file\n" . $herecurr);
2937bff5da43SRob Herring				}
2938bff5da43SRob Herring			}
2939bff5da43SRob Herring		}
2940bff5da43SRob Herring
29419f3a8992SRob Herring# check for using SPDX license tag at beginning of files
29429f3a8992SRob Herring		if ($realline == $checklicenseline) {
29439f3a8992SRob Herring			if ($rawline =~ /^[ \+]\s*\#\!\s*\//) {
29449f3a8992SRob Herring				$checklicenseline = 2;
29459f3a8992SRob Herring			} elsif ($rawline =~ /^\+/) {
29469f3a8992SRob Herring				my $comment = "";
29479f3a8992SRob Herring				if ($realfile =~ /\.(h|s|S)$/) {
29489f3a8992SRob Herring					$comment = '/*';
29499f3a8992SRob Herring				} elsif ($realfile =~ /\.(c|dts|dtsi)$/) {
29509f3a8992SRob Herring					$comment = '//';
29519f3a8992SRob Herring				} elsif (($checklicenseline == 2) || $realfile =~ /\.(sh|pl|py|awk|tc)$/) {
29529f3a8992SRob Herring					$comment = '#';
29539f3a8992SRob Herring				} elsif ($realfile =~ /\.rst$/) {
29549f3a8992SRob Herring					$comment = '..';
29559f3a8992SRob Herring				}
29569f3a8992SRob Herring
29579f3a8992SRob Herring				if ($comment !~ /^$/ &&
29589f3a8992SRob Herring				    $rawline !~ /^\+\Q$comment\E SPDX-License-Identifier: /) {
29599f3a8992SRob Herring					WARN("SPDX_LICENSE_TAG",
29609f3a8992SRob Herring					     "Missing or malformed SPDX-License-Identifier tag in line $checklicenseline\n" . $herecurr);
29619f3a8992SRob Herring				}
29629f3a8992SRob Herring			}
29639f3a8992SRob Herring		}
29649f3a8992SRob Herring
29655368df20SAndy Whitcroft# check we are in a valid source file if not then ignore this hunk
2966d6430f71SJoe Perches		next if ($realfile !~ /\.(h|c|s|S|sh|dtsi|dts)$/);
29675368df20SAndy Whitcroft
296847e0c88bSJoe Perches# line length limit (with some exclusions)
296947e0c88bSJoe Perches#
297047e0c88bSJoe Perches# There are a few types of lines that may extend beyond $max_line_length:
297147e0c88bSJoe Perches#	logging functions like pr_info that end in a string
297247e0c88bSJoe Perches#	lines with a single string
297347e0c88bSJoe Perches#	#defines that are a single string
29742e4bbbc5SAndreas Brauchli#	lines with an RFC3986 like URL
297547e0c88bSJoe Perches#
297647e0c88bSJoe Perches# There are 3 different line length message types:
2977ab1ecabfSJean Delvare# LONG_LINE_COMMENT	a comment starts before but extends beyond $max_line_length
297847e0c88bSJoe Perches# LONG_LINE_STRING	a string starts before but extends beyond $max_line_length
297947e0c88bSJoe Perches# LONG_LINE		all other lines longer than $max_line_length
298047e0c88bSJoe Perches#
298147e0c88bSJoe Perches# if LONG_LINE is ignored, the other 2 types are also ignored
298247e0c88bSJoe Perches#
298347e0c88bSJoe Perches
2984b4749e96SJoe Perches		if ($line =~ /^\+/ && $length > $max_line_length) {
298547e0c88bSJoe Perches			my $msg_type = "LONG_LINE";
298647e0c88bSJoe Perches
298747e0c88bSJoe Perches			# Check the allowed long line types first
298847e0c88bSJoe Perches
298947e0c88bSJoe Perches			# logging functions that end in a string that starts
299047e0c88bSJoe Perches			# before $max_line_length
299147e0c88bSJoe Perches			if ($line =~ /^\+\s*$logFunctions\s*\(\s*(?:(?:KERN_\S+\s*|[^"]*))?($String\s*(?:|,|\)\s*;)\s*)$/ &&
299247e0c88bSJoe Perches			    length(expand_tabs(substr($line, 1, length($line) - length($1) - 1))) <= $max_line_length) {
299347e0c88bSJoe Perches				$msg_type = "";
299447e0c88bSJoe Perches
299547e0c88bSJoe Perches			# lines with only strings (w/ possible termination)
299647e0c88bSJoe Perches			# #defines with only strings
299747e0c88bSJoe Perches			} elsif ($line =~ /^\+\s*$String\s*(?:\s*|,|\)\s*;)\s*$/ ||
299847e0c88bSJoe Perches				 $line =~ /^\+\s*#\s*define\s+\w+\s+$String$/) {
299947e0c88bSJoe Perches				$msg_type = "";
300047e0c88bSJoe Perches
3001cc147506SJoe Perches			# More special cases
3002cc147506SJoe Perches			} elsif ($line =~ /^\+.*\bEFI_GUID\s*\(/ ||
3003cc147506SJoe Perches				 $line =~ /^\+\s*(?:\w+)?\s*DEFINE_PER_CPU/) {
3004d560a5f8SJoe Perches				$msg_type = "";
3005d560a5f8SJoe Perches
30062e4bbbc5SAndreas Brauchli			# URL ($rawline is used in case the URL is in a comment)
30072e4bbbc5SAndreas Brauchli			} elsif ($rawline =~ /^\+.*\b[a-z][\w\.\+\-]*:\/\/\S+/i) {
30082e4bbbc5SAndreas Brauchli				$msg_type = "";
30092e4bbbc5SAndreas Brauchli
301047e0c88bSJoe Perches			# Otherwise set the alternate message types
301147e0c88bSJoe Perches
301247e0c88bSJoe Perches			# a comment starts before $max_line_length
301347e0c88bSJoe Perches			} elsif ($line =~ /($;[\s$;]*)$/ &&
301447e0c88bSJoe Perches				 length(expand_tabs(substr($line, 1, length($line) - length($1) - 1))) <= $max_line_length) {
301547e0c88bSJoe Perches				$msg_type = "LONG_LINE_COMMENT"
301647e0c88bSJoe Perches
301747e0c88bSJoe Perches			# a quoted string starts before $max_line_length
301847e0c88bSJoe Perches			} elsif ($sline =~ /\s*($String(?:\s*(?:\\|,\s*|\)\s*;\s*))?)$/ &&
301947e0c88bSJoe Perches				 length(expand_tabs(substr($line, 1, length($line) - length($1) - 1))) <= $max_line_length) {
302047e0c88bSJoe Perches				$msg_type = "LONG_LINE_STRING"
302147e0c88bSJoe Perches			}
302247e0c88bSJoe Perches
302347e0c88bSJoe Perches			if ($msg_type ne "" &&
302447e0c88bSJoe Perches			    (show_type("LONG_LINE") || show_type($msg_type))) {
302547e0c88bSJoe Perches				WARN($msg_type,
30266cd7f386SJoe Perches				     "line over $max_line_length characters\n" . $herecurr);
30270a920b5bSAndy Whitcroft			}
302847e0c88bSJoe Perches		}
30290a920b5bSAndy Whitcroft
30308905a67cSAndy Whitcroft# check for adding lines without a newline.
30318905a67cSAndy Whitcroft		if ($line =~ /^\+/ && defined $lines[$linenr] && $lines[$linenr] =~ /^\\ No newline at end of file/) {
3032000d1cc1SJoe Perches			WARN("MISSING_EOF_NEWLINE",
3033000d1cc1SJoe Perches			     "adding a line without newline at end of file\n" . $herecurr);
30348905a67cSAndy Whitcroft		}
30358905a67cSAndy Whitcroft
3036b9ea10d6SAndy Whitcroft# check we are in a valid source file C or perl if not then ignore this hunk
3037de4c924cSGeert Uytterhoeven		next if ($realfile !~ /\.(h|c|pl|dtsi|dts)$/);
30380a920b5bSAndy Whitcroft
30390a920b5bSAndy Whitcroft# at the beginning of a line any tabs must come first and anything
30400a920b5bSAndy Whitcroft# more than 8 must use tabs.
3041c2fdda0dSAndy Whitcroft		if ($rawline =~ /^\+\s* \t\s*\S/ ||
3042c2fdda0dSAndy Whitcroft		    $rawline =~ /^\+\s*        \s*/) {
3043c2fdda0dSAndy Whitcroft			my $herevet = "$here\n" . cat_vet($rawline) . "\n";
3044d2c0a235SAndy Whitcroft			$rpt_cleaners = 1;
30453705ce5bSJoe Perches			if (ERROR("CODE_INDENT",
30463705ce5bSJoe Perches				  "code indent should use tabs where possible\n" . $herevet) &&
30473705ce5bSJoe Perches			    $fix) {
3048194f66fcSJoe Perches				$fixed[$fixlinenr] =~ s/^\+([ \t]+)/"\+" . tabify($1)/e;
30493705ce5bSJoe Perches			}
30500a920b5bSAndy Whitcroft		}
30510a920b5bSAndy Whitcroft
305208e44365SAlberto Panizzo# check for space before tabs.
305308e44365SAlberto Panizzo		if ($rawline =~ /^\+/ && $rawline =~ / \t/) {
305408e44365SAlberto Panizzo			my $herevet = "$here\n" . cat_vet($rawline) . "\n";
30553705ce5bSJoe Perches			if (WARN("SPACE_BEFORE_TAB",
30563705ce5bSJoe Perches				"please, no space before tabs\n" . $herevet) &&
30573705ce5bSJoe Perches			    $fix) {
3058194f66fcSJoe Perches				while ($fixed[$fixlinenr] =~
3059d2207ccbSJoe Perches					   s/(^\+.*) {8,8}\t/$1\t\t/) {}
3060194f66fcSJoe Perches				while ($fixed[$fixlinenr] =~
3061c76f4cb3SJoe Perches					   s/(^\+.*) +\t/$1\t/) {}
30623705ce5bSJoe Perches			}
306308e44365SAlberto Panizzo		}
306408e44365SAlberto Panizzo
3065d1fe9c09SJoe Perches# check for && or || at the start of a line
3066d1fe9c09SJoe Perches		if ($rawline =~ /^\+\s*(&&|\|\|)/) {
3067d1fe9c09SJoe Perches			CHK("LOGICAL_CONTINUATIONS",
3068d1fe9c09SJoe Perches			    "Logical continuations should be on the previous line\n" . $hereprev);
3069d1fe9c09SJoe Perches		}
3070d1fe9c09SJoe Perches
3071a91e8994SJoe Perches# check indentation starts on a tab stop
3072a91e8994SJoe Perches		if ($^V && $^V ge 5.10.0 &&
3073bd49111fSJoe Perches		    $sline =~ /^\+\t+( +)(?:$c90_Keywords\b|\{\s*$|\}\s*(?:else\b|while\b|\s*$)|$Declare\s*$Ident\s*[;=])/) {
3074a91e8994SJoe Perches			my $indent = length($1);
3075a91e8994SJoe Perches			if ($indent % 8) {
3076a91e8994SJoe Perches				if (WARN("TABSTOP",
3077a91e8994SJoe Perches					 "Statements should start on a tabstop\n" . $herecurr) &&
3078a91e8994SJoe Perches				    $fix) {
3079a91e8994SJoe Perches					$fixed[$fixlinenr] =~ s@(^\+\t+) +@$1 . "\t" x ($indent/8)@e;
3080a91e8994SJoe Perches				}
3081a91e8994SJoe Perches			}
3082a91e8994SJoe Perches		}
3083a91e8994SJoe Perches
3084d1fe9c09SJoe Perches# check multi-line statement indentation matches previous line
3085d1fe9c09SJoe Perches		if ($^V && $^V ge 5.10.0 &&
3086fd71f632SJoe Perches		    $prevline =~ /^\+([ \t]*)((?:$c90_Keywords(?:\s+if)\s*)|(?:$Declare\s*)?(?:$Ident|\(\s*\*\s*$Ident\s*\))\s*|(?:\*\s*)*$Lval\s*=\s*$Ident\s*)\(.*(\&\&|\|\||,)\s*$/) {
3087d1fe9c09SJoe Perches			$prevline =~ /^\+(\t*)(.*)$/;
3088d1fe9c09SJoe Perches			my $oldindent = $1;
3089d1fe9c09SJoe Perches			my $rest = $2;
3090d1fe9c09SJoe Perches
3091d1fe9c09SJoe Perches			my $pos = pos_last_openparen($rest);
3092d1fe9c09SJoe Perches			if ($pos >= 0) {
3093b34a26f3SJoe Perches				$line =~ /^(\+| )([ \t]*)/;
3094b34a26f3SJoe Perches				my $newindent = $2;
3095d1fe9c09SJoe Perches
3096d1fe9c09SJoe Perches				my $goodtabindent = $oldindent .
3097d1fe9c09SJoe Perches					"\t" x ($pos / 8) .
3098d1fe9c09SJoe Perches					" "  x ($pos % 8);
3099d1fe9c09SJoe Perches				my $goodspaceindent = $oldindent . " "  x $pos;
3100d1fe9c09SJoe Perches
3101d1fe9c09SJoe Perches				if ($newindent ne $goodtabindent &&
3102d1fe9c09SJoe Perches				    $newindent ne $goodspaceindent) {
31033705ce5bSJoe Perches
31043705ce5bSJoe Perches					if (CHK("PARENTHESIS_ALIGNMENT",
31053705ce5bSJoe Perches						"Alignment should match open parenthesis\n" . $hereprev) &&
31063705ce5bSJoe Perches					    $fix && $line =~ /^\+/) {
3107194f66fcSJoe Perches						$fixed[$fixlinenr] =~
31083705ce5bSJoe Perches						    s/^\+[ \t]*/\+$goodtabindent/;
31093705ce5bSJoe Perches					}
3110d1fe9c09SJoe Perches				}
3111d1fe9c09SJoe Perches			}
3112d1fe9c09SJoe Perches		}
3113d1fe9c09SJoe Perches
31146ab3a970SJoe Perches# check for space after cast like "(int) foo" or "(struct foo) bar"
31156ab3a970SJoe Perches# avoid checking a few false positives:
31166ab3a970SJoe Perches#   "sizeof(<type>)" or "__alignof__(<type>)"
31176ab3a970SJoe Perches#   function pointer declarations like "(*foo)(int) = bar;"
31186ab3a970SJoe Perches#   structure definitions like "(struct foo) { 0 };"
31196ab3a970SJoe Perches#   multiline macros that define functions
31206ab3a970SJoe Perches#   known attributes or the __attribute__ keyword
31216ab3a970SJoe Perches		if ($line =~ /^\+(.*)\(\s*$Type\s*\)([ \t]++)((?![={]|\\$|$Attribute|__attribute__))/ &&
31226ab3a970SJoe Perches		    (!defined($1) || $1 !~ /\b(?:sizeof|__alignof__)\s*$/)) {
31233705ce5bSJoe Perches			if (CHK("SPACING",
3124f27c95dbSJoe Perches				"No space is necessary after a cast\n" . $herecurr) &&
31253705ce5bSJoe Perches			    $fix) {
3126194f66fcSJoe Perches				$fixed[$fixlinenr] =~
3127f27c95dbSJoe Perches				    s/(\(\s*$Type\s*\))[ \t]+/$1/;
31283705ce5bSJoe Perches			}
3129aad4f614SJoe Perches		}
3130aad4f614SJoe Perches
313186406b1cSJoe Perches# Block comment styles
313286406b1cSJoe Perches# Networking with an initial /*
313305880600SJoe Perches		if ($realfile =~ m@^(drivers/net/|net/)@ &&
3134fdb4bcd6SJoe Perches		    $prevrawline =~ /^\+[ \t]*\/\*[ \t]*$/ &&
313585ad978cSJoe Perches		    $rawline =~ /^\+[ \t]*\*/ &&
313685ad978cSJoe Perches		    $realline > 2) {
313705880600SJoe Perches			WARN("NETWORKING_BLOCK_COMMENT_STYLE",
313805880600SJoe Perches			     "networking block comments don't use an empty /* line, use /* Comment...\n" . $hereprev);
313905880600SJoe Perches		}
314005880600SJoe Perches
314186406b1cSJoe Perches# Block comments use * on subsequent lines
314286406b1cSJoe Perches		if ($prevline =~ /$;[ \t]*$/ &&			#ends in comment
314386406b1cSJoe Perches		    $prevrawline =~ /^\+.*?\/\*/ &&		#starting /*
3144a605e32eSJoe Perches		    $prevrawline !~ /\*\/[ \t]*$/ &&		#no trailing */
314561135e96SJoe Perches		    $rawline =~ /^\+/ &&			#line is new
3146a605e32eSJoe Perches		    $rawline !~ /^\+[ \t]*\*/) {		#no leading *
314786406b1cSJoe Perches			WARN("BLOCK_COMMENT_STYLE",
314886406b1cSJoe Perches			     "Block comments use * on subsequent lines\n" . $hereprev);
3149a605e32eSJoe Perches		}
3150a605e32eSJoe Perches
315186406b1cSJoe Perches# Block comments use */ on trailing lines
315286406b1cSJoe Perches		if ($rawline !~ m@^\+[ \t]*\*/[ \t]*$@ &&	#trailing */
3153c24f9f19SJoe Perches		    $rawline !~ m@^\+.*/\*.*\*/[ \t]*$@ &&	#inline /*...*/
3154c24f9f19SJoe Perches		    $rawline !~ m@^\+.*\*{2,}/[ \t]*$@ &&	#trailing **/
3155c24f9f19SJoe Perches		    $rawline =~ m@^\+[ \t]*.+\*\/[ \t]*$@) {	#non blank */
315686406b1cSJoe Perches			WARN("BLOCK_COMMENT_STYLE",
315786406b1cSJoe Perches			     "Block comments use a trailing */ on a separate line\n" . $herecurr);
315805880600SJoe Perches		}
315905880600SJoe Perches
316008eb9b80SJoe Perches# Block comment * alignment
316108eb9b80SJoe Perches		if ($prevline =~ /$;[ \t]*$/ &&			#ends in comment
3162af207524SJoe Perches		    $line =~ /^\+[ \t]*$;/ &&			#leading comment
3163af207524SJoe Perches		    $rawline =~ /^\+[ \t]*\*/ &&		#leading *
3164af207524SJoe Perches		    (($prevrawline =~ /^\+.*?\/\*/ &&		#leading /*
316508eb9b80SJoe Perches		      $prevrawline !~ /\*\/[ \t]*$/) ||		#no trailing */
3166af207524SJoe Perches		     $prevrawline =~ /^\+[ \t]*\*/)) {		#leading *
3167af207524SJoe Perches			my $oldindent;
316808eb9b80SJoe Perches			$prevrawline =~ m@^\+([ \t]*/?)\*@;
3169af207524SJoe Perches			if (defined($1)) {
3170af207524SJoe Perches				$oldindent = expand_tabs($1);
3171af207524SJoe Perches			} else {
3172af207524SJoe Perches				$prevrawline =~ m@^\+(.*/?)\*@;
3173af207524SJoe Perches				$oldindent = expand_tabs($1);
3174af207524SJoe Perches			}
317508eb9b80SJoe Perches			$rawline =~ m@^\+([ \t]*)\*@;
317608eb9b80SJoe Perches			my $newindent = $1;
317708eb9b80SJoe Perches			$newindent = expand_tabs($newindent);
3178af207524SJoe Perches			if (length($oldindent) ne length($newindent)) {
317908eb9b80SJoe Perches				WARN("BLOCK_COMMENT_STYLE",
318008eb9b80SJoe Perches				     "Block comments should align the * on each line\n" . $hereprev);
318108eb9b80SJoe Perches			}
318208eb9b80SJoe Perches		}
318308eb9b80SJoe Perches
31847f619191SJoe Perches# check for missing blank lines after struct/union declarations
31857f619191SJoe Perches# with exceptions for various attributes and macros
31867f619191SJoe Perches		if ($prevline =~ /^[\+ ]};?\s*$/ &&
31877f619191SJoe Perches		    $line =~ /^\+/ &&
31887f619191SJoe Perches		    !($line =~ /^\+\s*$/ ||
31897f619191SJoe Perches		      $line =~ /^\+\s*EXPORT_SYMBOL/ ||
31907f619191SJoe Perches		      $line =~ /^\+\s*MODULE_/i ||
31917f619191SJoe Perches		      $line =~ /^\+\s*\#\s*(?:end|elif|else)/ ||
31927f619191SJoe Perches		      $line =~ /^\+[a-z_]*init/ ||
31937f619191SJoe Perches		      $line =~ /^\+\s*(?:static\s+)?[A-Z_]*ATTR/ ||
31947f619191SJoe Perches		      $line =~ /^\+\s*DECLARE/ ||
31950bc989ffSMasahiro Yamada		      $line =~ /^\+\s*builtin_[\w_]*driver/ ||
31967f619191SJoe Perches		      $line =~ /^\+\s*__setup/)) {
3197d752fcc8SJoe Perches			if (CHK("LINE_SPACING",
3198d752fcc8SJoe Perches				"Please use a blank line after function/struct/union/enum declarations\n" . $hereprev) &&
3199d752fcc8SJoe Perches			    $fix) {
3200f2d7e4d4SJoe Perches				fix_insert_line($fixlinenr, "\+");
3201d752fcc8SJoe Perches			}
32027f619191SJoe Perches		}
32037f619191SJoe Perches
3204365dd4eaSJoe Perches# check for multiple consecutive blank lines
3205365dd4eaSJoe Perches		if ($prevline =~ /^[\+ ]\s*$/ &&
3206365dd4eaSJoe Perches		    $line =~ /^\+\s*$/ &&
3207365dd4eaSJoe Perches		    $last_blank_line != ($linenr - 1)) {
3208d752fcc8SJoe Perches			if (CHK("LINE_SPACING",
3209d752fcc8SJoe Perches				"Please don't use multiple blank lines\n" . $hereprev) &&
3210d752fcc8SJoe Perches			    $fix) {
3211f2d7e4d4SJoe Perches				fix_delete_line($fixlinenr, $rawline);
3212d752fcc8SJoe Perches			}
3213d752fcc8SJoe Perches
3214365dd4eaSJoe Perches			$last_blank_line = $linenr;
3215365dd4eaSJoe Perches		}
3216365dd4eaSJoe Perches
32173b617e3bSJoe Perches# check for missing blank lines after declarations
32183f7bac03SJoe Perches		if ($sline =~ /^\+\s+\S/ &&			#Not at char 1
32193f7bac03SJoe Perches			# actual declarations
32203f7bac03SJoe Perches		    ($prevline =~ /^\+\s+$Declare\s*$Ident\s*[=,;:\[]/ ||
32215a4e1fd3SJoe Perches			# function pointer declarations
32225a4e1fd3SJoe Perches		     $prevline =~ /^\+\s+$Declare\s*\(\s*\*\s*$Ident\s*\)\s*[=,;:\[\(]/ ||
32233f7bac03SJoe Perches			# foo bar; where foo is some local typedef or #define
32243f7bac03SJoe Perches		     $prevline =~ /^\+\s+$Ident(?:\s+|\s*\*\s*)$Ident\s*[=,;\[]/ ||
32253f7bac03SJoe Perches			# known declaration macros
32263f7bac03SJoe Perches		     $prevline =~ /^\+\s+$declaration_macros/) &&
32273f7bac03SJoe Perches			# for "else if" which can look like "$Ident $Ident"
32283f7bac03SJoe Perches		    !($prevline =~ /^\+\s+$c90_Keywords\b/ ||
32293f7bac03SJoe Perches			# other possible extensions of declaration lines
32303f7bac03SJoe Perches		      $prevline =~ /(?:$Compare|$Assignment|$Operators)\s*$/ ||
32313f7bac03SJoe Perches			# not starting a section or a macro "\" extended line
32323f7bac03SJoe Perches		      $prevline =~ /(?:\{\s*|\\)$/) &&
32333f7bac03SJoe Perches			# looks like a declaration
32343f7bac03SJoe Perches		    !($sline =~ /^\+\s+$Declare\s*$Ident\s*[=,;:\[]/ ||
32355a4e1fd3SJoe Perches			# function pointer declarations
32365a4e1fd3SJoe Perches		      $sline =~ /^\+\s+$Declare\s*\(\s*\*\s*$Ident\s*\)\s*[=,;:\[\(]/ ||
32373f7bac03SJoe Perches			# foo bar; where foo is some local typedef or #define
32383f7bac03SJoe Perches		      $sline =~ /^\+\s+$Ident(?:\s+|\s*\*\s*)$Ident\s*[=,;\[]/ ||
32393f7bac03SJoe Perches			# known declaration macros
32403f7bac03SJoe Perches		      $sline =~ /^\+\s+$declaration_macros/ ||
32413f7bac03SJoe Perches			# start of struct or union or enum
32423b617e3bSJoe Perches		      $sline =~ /^\+\s+(?:union|struct|enum|typedef)\b/ ||
32433f7bac03SJoe Perches			# start or end of block or continuation of declaration
32443f7bac03SJoe Perches		      $sline =~ /^\+\s+(?:$|[\{\}\.\#\"\?\:\(\[])/ ||
32453f7bac03SJoe Perches			# bitfield continuation
32463f7bac03SJoe Perches		      $sline =~ /^\+\s+$Ident\s*:\s*\d+\s*[,;]/ ||
32473f7bac03SJoe Perches			# other possible extensions of declaration lines
32483f7bac03SJoe Perches		      $sline =~ /^\+\s+\(?\s*(?:$Compare|$Assignment|$Operators)/) &&
32493f7bac03SJoe Perches			# indentation of previous and current line are the same
32503f7bac03SJoe Perches		    (($prevline =~ /\+(\s+)\S/) && $sline =~ /^\+$1\S/)) {
3251d752fcc8SJoe Perches			if (WARN("LINE_SPACING",
3252d752fcc8SJoe Perches				 "Missing a blank line after declarations\n" . $hereprev) &&
3253d752fcc8SJoe Perches			    $fix) {
3254f2d7e4d4SJoe Perches				fix_insert_line($fixlinenr, "\+");
3255d752fcc8SJoe Perches			}
32563b617e3bSJoe Perches		}
32573b617e3bSJoe Perches
32585f7ddae6SRaffaele Recalcati# check for spaces at the beginning of a line.
32596b4c5bebSAndy Whitcroft# Exceptions:
32606b4c5bebSAndy Whitcroft#  1) within comments
32616b4c5bebSAndy Whitcroft#  2) indented preprocessor commands
32626b4c5bebSAndy Whitcroft#  3) hanging labels
32633705ce5bSJoe Perches		if ($rawline =~ /^\+ / && $line !~ /^\+ *(?:$;|#|$Ident:)/)  {
32645f7ddae6SRaffaele Recalcati			my $herevet = "$here\n" . cat_vet($rawline) . "\n";
32653705ce5bSJoe Perches			if (WARN("LEADING_SPACE",
32663705ce5bSJoe Perches				 "please, no spaces at the start of a line\n" . $herevet) &&
32673705ce5bSJoe Perches			    $fix) {
3268194f66fcSJoe Perches				$fixed[$fixlinenr] =~ s/^\+([ \t]+)/"\+" . tabify($1)/e;
32693705ce5bSJoe Perches			}
32705f7ddae6SRaffaele Recalcati		}
32715f7ddae6SRaffaele Recalcati
3272b9ea10d6SAndy Whitcroft# check we are in a valid C source file if not then ignore this hunk
3273b9ea10d6SAndy Whitcroft		next if ($realfile !~ /\.(h|c)$/);
3274b9ea10d6SAndy Whitcroft
32755751a24eSJoe Perches# check for unusual line ending [ or (
32765751a24eSJoe Perches		if ($line =~ /^\+.*([\[\(])\s*$/) {
32775751a24eSJoe Perches			CHK("OPEN_ENDED_LINE",
32785751a24eSJoe Perches			    "Lines should not end with a '$1'\n" . $herecurr);
32795751a24eSJoe Perches		}
32805751a24eSJoe Perches
32814dbed76fSJoe Perches# check if this appears to be the start function declaration, save the name
32824dbed76fSJoe Perches		if ($sline =~ /^\+\{\s*$/ &&
32834dbed76fSJoe Perches		    $prevline =~ /^\+(?:(?:(?:$Storage|$Inline)\s*)*\s*$Type\s*)?($Ident)\(/) {
32844dbed76fSJoe Perches			$context_function = $1;
32854dbed76fSJoe Perches		}
32864dbed76fSJoe Perches
32874dbed76fSJoe Perches# check if this appears to be the end of function declaration
32884dbed76fSJoe Perches		if ($sline =~ /^\+\}\s*$/) {
32894dbed76fSJoe Perches			undef $context_function;
32904dbed76fSJoe Perches		}
32914dbed76fSJoe Perches
3292032a4c0fSJoe Perches# check indentation of any line with a bare else
3293840080a0SJoe Perches# (but not if it is a multiple line "if (foo) return bar; else return baz;")
3294032a4c0fSJoe Perches# if the previous line is a break or return and is indented 1 tab more...
3295032a4c0fSJoe Perches		if ($sline =~ /^\+([\t]+)(?:}[ \t]*)?else(?:[ \t]*{)?\s*$/) {
3296032a4c0fSJoe Perches			my $tabs = length($1) + 1;
3297840080a0SJoe Perches			if ($prevline =~ /^\+\t{$tabs,$tabs}break\b/ ||
3298840080a0SJoe Perches			    ($prevline =~ /^\+\t{$tabs,$tabs}return\b/ &&
3299840080a0SJoe Perches			     defined $lines[$linenr] &&
3300840080a0SJoe Perches			     $lines[$linenr] !~ /^[ \+]\t{$tabs,$tabs}return/)) {
3301032a4c0fSJoe Perches				WARN("UNNECESSARY_ELSE",
3302032a4c0fSJoe Perches				     "else is not generally useful after a break or return\n" . $hereprev);
3303032a4c0fSJoe Perches			}
3304032a4c0fSJoe Perches		}
3305032a4c0fSJoe Perches
3306c00df19aSJoe Perches# check indentation of a line with a break;
3307c00df19aSJoe Perches# if the previous line is a goto or return and is indented the same # of tabs
3308c00df19aSJoe Perches		if ($sline =~ /^\+([\t]+)break\s*;\s*$/) {
3309c00df19aSJoe Perches			my $tabs = $1;
3310c00df19aSJoe Perches			if ($prevline =~ /^\+$tabs(?:goto|return)\b/) {
3311c00df19aSJoe Perches				WARN("UNNECESSARY_BREAK",
3312c00df19aSJoe Perches				     "break is not useful after a goto or return\n" . $hereprev);
3313c00df19aSJoe Perches			}
3314c00df19aSJoe Perches		}
3315c00df19aSJoe Perches
3316c2fdda0dSAndy Whitcroft# check for RCS/CVS revision markers
3317cf655043SAndy Whitcroft		if ($rawline =~ /^\+.*\$(Revision|Log|Id)(?:\$|)/) {
3318000d1cc1SJoe Perches			WARN("CVS_KEYWORD",
3319000d1cc1SJoe Perches			     "CVS style keyword markers, these will _not_ be updated\n". $herecurr);
3320c2fdda0dSAndy Whitcroft		}
332122f2a2efSAndy Whitcroft
332256e77d70SJoe Perches# check for old HOTPLUG __dev<foo> section markings
332356e77d70SJoe Perches		if ($line =~ /\b(__dev(init|exit)(data|const|))\b/) {
332456e77d70SJoe Perches			WARN("HOTPLUG_SECTION",
332556e77d70SJoe Perches			     "Using $1 is unnecessary\n" . $herecurr);
332656e77d70SJoe Perches		}
332756e77d70SJoe Perches
33289c0ca6f9SAndy Whitcroft# Check for potential 'bare' types
33292b474a1aSAndy Whitcroft		my ($stat, $cond, $line_nr_next, $remain_next, $off_next,
33302b474a1aSAndy Whitcroft		    $realline_next);
33313e469cdcSAndy Whitcroft#print "LINE<$line>\n";
3332ca819864SJoe Perches		if ($linenr > $suppress_statement &&
33331b5539b1SJoe Perches		    $realcnt && $sline =~ /.\s*\S/) {
3334170d3a22SAndy Whitcroft			($stat, $cond, $line_nr_next, $remain_next, $off_next) =
3335f5fe35ddSAndy Whitcroft				ctx_statement_block($linenr, $realcnt, 0);
3336171ae1a4SAndy Whitcroft			$stat =~ s/\n./\n /g;
3337171ae1a4SAndy Whitcroft			$cond =~ s/\n./\n /g;
3338171ae1a4SAndy Whitcroft
33393e469cdcSAndy Whitcroft#print "linenr<$linenr> <$stat>\n";
33403e469cdcSAndy Whitcroft			# If this statement has no statement boundaries within
33413e469cdcSAndy Whitcroft			# it there is no point in retrying a statement scan
33423e469cdcSAndy Whitcroft			# until we hit end of it.
33433e469cdcSAndy Whitcroft			my $frag = $stat; $frag =~ s/;+\s*$//;
33443e469cdcSAndy Whitcroft			if ($frag !~ /(?:{|;)/) {
33453e469cdcSAndy Whitcroft#print "skip<$line_nr_next>\n";
33463e469cdcSAndy Whitcroft				$suppress_statement = $line_nr_next;
33473e469cdcSAndy Whitcroft			}
3348f74bd194SAndy Whitcroft
33492b474a1aSAndy Whitcroft			# Find the real next line.
33502b474a1aSAndy Whitcroft			$realline_next = $line_nr_next;
33512b474a1aSAndy Whitcroft			if (defined $realline_next &&
33522b474a1aSAndy Whitcroft			    (!defined $lines[$realline_next - 1] ||
33532b474a1aSAndy Whitcroft			     substr($lines[$realline_next - 1], $off_next) =~ /^\s*$/)) {
33542b474a1aSAndy Whitcroft				$realline_next++;
33552b474a1aSAndy Whitcroft			}
33562b474a1aSAndy Whitcroft
3357171ae1a4SAndy Whitcroft			my $s = $stat;
3358171ae1a4SAndy Whitcroft			$s =~ s/{.*$//s;
3359cf655043SAndy Whitcroft
3360c2fdda0dSAndy Whitcroft			# Ignore goto labels.
3361171ae1a4SAndy Whitcroft			if ($s =~ /$Ident:\*$/s) {
3362c2fdda0dSAndy Whitcroft
3363c2fdda0dSAndy Whitcroft			# Ignore functions being called
3364171ae1a4SAndy Whitcroft			} elsif ($s =~ /^.\s*$Ident\s*\(/s) {
3365c2fdda0dSAndy Whitcroft
3366463f2864SAndy Whitcroft			} elsif ($s =~ /^.\s*else\b/s) {
3367463f2864SAndy Whitcroft
3368c45dcabdSAndy Whitcroft			# declarations always start with types
3369d2506586SAndy 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) {
3370c45dcabdSAndy Whitcroft				my $type = $1;
3371c45dcabdSAndy Whitcroft				$type =~ s/\s+/ /g;
3372c45dcabdSAndy Whitcroft				possible($type, "A:" . $s);
3373c45dcabdSAndy Whitcroft
33746c72ffaaSAndy Whitcroft			# definitions in global scope can only start with types
3375a6a84062SAndy Whitcroft			} elsif ($s =~ /^.(?:$Storage\s+)?(?:$Inline\s+)?(?:const\s+)?($Ident)\b\s*(?!:)/s) {
3376c45dcabdSAndy Whitcroft				possible($1, "B:" . $s);
3377c2fdda0dSAndy Whitcroft			}
33788905a67cSAndy Whitcroft
33796c72ffaaSAndy Whitcroft			# any (foo ... *) is a pointer cast, and foo is a type
338065863862SAndy Whitcroft			while ($s =~ /\(($Ident)(?:\s+$Sparse)*[\s\*]+\s*\)/sg) {
3381c45dcabdSAndy Whitcroft				possible($1, "C:" . $s);
33829c0ca6f9SAndy Whitcroft			}
33838905a67cSAndy Whitcroft
33848905a67cSAndy Whitcroft			# Check for any sort of function declaration.
33858905a67cSAndy Whitcroft			# int foo(something bar, other baz);
33868905a67cSAndy Whitcroft			# void (*store_gdt)(x86_descr_ptr *);
3387171ae1a4SAndy Whitcroft			if ($prev_values eq 'E' && $s =~ /^(.(?:typedef\s*)?(?:(?:$Storage|$Inline)\s*)*\s*$Type\s*(?:\b$Ident|\(\*\s*$Ident\))\s*)\(/s) {
33888905a67cSAndy Whitcroft				my ($name_len) = length($1);
33898905a67cSAndy Whitcroft
3390cf655043SAndy Whitcroft				my $ctx = $s;
3391773647a0SAndy Whitcroft				substr($ctx, 0, $name_len + 1, '');
33928905a67cSAndy Whitcroft				$ctx =~ s/\)[^\)]*$//;
3393cf655043SAndy Whitcroft
33948905a67cSAndy Whitcroft				for my $arg (split(/\s*,\s*/, $ctx)) {
3395c45dcabdSAndy Whitcroft					if ($arg =~ /^(?:const\s+)?($Ident)(?:\s+$Sparse)*\s*\**\s*(:?\b$Ident)?$/s || $arg =~ /^($Ident)$/s) {
33968905a67cSAndy Whitcroft
3397c45dcabdSAndy Whitcroft						possible($1, "D:" . $s);
33988905a67cSAndy Whitcroft					}
33998905a67cSAndy Whitcroft				}
34008905a67cSAndy Whitcroft			}
34018905a67cSAndy Whitcroft
34029c0ca6f9SAndy Whitcroft		}
34039c0ca6f9SAndy Whitcroft
340400df344fSAndy Whitcroft#
340500df344fSAndy Whitcroft# Checks which may be anchored in the context.
340600df344fSAndy Whitcroft#
340700df344fSAndy Whitcroft
340800df344fSAndy Whitcroft# Check for switch () and associated case and default
340900df344fSAndy Whitcroft# statements should be at the same indent.
341000df344fSAndy Whitcroft		if ($line=~/\bswitch\s*\(.*\)/) {
341100df344fSAndy Whitcroft			my $err = '';
341200df344fSAndy Whitcroft			my $sep = '';
341300df344fSAndy Whitcroft			my @ctx = ctx_block_outer($linenr, $realcnt);
341400df344fSAndy Whitcroft			shift(@ctx);
341500df344fSAndy Whitcroft			for my $ctx (@ctx) {
341600df344fSAndy Whitcroft				my ($clen, $cindent) = line_stats($ctx);
341700df344fSAndy Whitcroft				if ($ctx =~ /^\+\s*(case\s+|default:)/ &&
341800df344fSAndy Whitcroft							$indent != $cindent) {
341900df344fSAndy Whitcroft					$err .= "$sep$ctx\n";
342000df344fSAndy Whitcroft					$sep = '';
342100df344fSAndy Whitcroft				} else {
342200df344fSAndy Whitcroft					$sep = "[...]\n";
342300df344fSAndy Whitcroft				}
342400df344fSAndy Whitcroft			}
342500df344fSAndy Whitcroft			if ($err ne '') {
3426000d1cc1SJoe Perches				ERROR("SWITCH_CASE_INDENT_LEVEL",
3427000d1cc1SJoe Perches				      "switch and case should be at the same indent\n$hereline$err");
3428de7d4f0eSAndy Whitcroft			}
3429de7d4f0eSAndy Whitcroft		}
3430de7d4f0eSAndy Whitcroft
3431de7d4f0eSAndy Whitcroft# if/while/etc brace do not go on next line, unless defining a do while loop,
3432de7d4f0eSAndy Whitcroft# or if that brace on the next line is for something else
34330fe3dc2bSJoe Perches		if ($line =~ /(.*)\b((?:if|while|for|switch|(?:[a-z_]+|)for_each[a-z_]+)\s*\(|do\b|else\b)/ && $line !~ /^.\s*\#/) {
3434773647a0SAndy Whitcroft			my $pre_ctx = "$1$2";
3435773647a0SAndy Whitcroft
34369c0ca6f9SAndy Whitcroft			my ($level, @ctx) = ctx_statement_level($linenr, $realcnt, 0);
34378eef05ddSJoe Perches
34388eef05ddSJoe Perches			if ($line =~ /^\+\t{6,}/) {
34398eef05ddSJoe Perches				WARN("DEEP_INDENTATION",
34408eef05ddSJoe Perches				     "Too many leading tabs - consider code refactoring\n" . $herecurr);
34418eef05ddSJoe Perches			}
34428eef05ddSJoe Perches
3443de7d4f0eSAndy Whitcroft			my $ctx_cnt = $realcnt - $#ctx - 1;
3444de7d4f0eSAndy Whitcroft			my $ctx = join("\n", @ctx);
3445de7d4f0eSAndy Whitcroft
3446548596d5SAndy Whitcroft			my $ctx_ln = $linenr;
3447548596d5SAndy Whitcroft			my $ctx_skip = $realcnt;
3448de7d4f0eSAndy Whitcroft
3449548596d5SAndy Whitcroft			while ($ctx_skip > $ctx_cnt || ($ctx_skip == $ctx_cnt &&
3450548596d5SAndy Whitcroft					defined $lines[$ctx_ln - 1] &&
3451548596d5SAndy Whitcroft					$lines[$ctx_ln - 1] =~ /^-/)) {
3452548596d5SAndy Whitcroft				##print "SKIP<$ctx_skip> CNT<$ctx_cnt>\n";
3453548596d5SAndy Whitcroft				$ctx_skip-- if (!defined $lines[$ctx_ln - 1] || $lines[$ctx_ln - 1] !~ /^-/);
3454773647a0SAndy Whitcroft				$ctx_ln++;
3455773647a0SAndy Whitcroft			}
3456548596d5SAndy Whitcroft
345753210168SAndy Whitcroft			#print "realcnt<$realcnt> ctx_cnt<$ctx_cnt>\n";
345853210168SAndy Whitcroft			#print "pre<$pre_ctx>\nline<$line>\nctx<$ctx>\nnext<$lines[$ctx_ln - 1]>\n";
3459773647a0SAndy Whitcroft
3460773647a0SAndy Whitcroft			if ($ctx !~ /{\s*/ && defined($lines[$ctx_ln - 1]) && $lines[$ctx_ln - 1] =~ /^\+\s*{/) {
3461000d1cc1SJoe Perches				ERROR("OPEN_BRACE",
3462000d1cc1SJoe Perches				      "that open brace { should be on the previous line\n" .
346301464f30SAndy Whitcroft					"$here\n$ctx\n$rawlines[$ctx_ln - 1]\n");
346400df344fSAndy Whitcroft			}
3465773647a0SAndy Whitcroft			if ($level == 0 && $pre_ctx !~ /}\s*while\s*\($/ &&
3466773647a0SAndy Whitcroft			    $ctx =~ /\)\s*\;\s*$/ &&
3467773647a0SAndy Whitcroft			    defined $lines[$ctx_ln - 1])
3468773647a0SAndy Whitcroft			{
34699c0ca6f9SAndy Whitcroft				my ($nlength, $nindent) = line_stats($lines[$ctx_ln - 1]);
34709c0ca6f9SAndy Whitcroft				if ($nindent > $indent) {
3471000d1cc1SJoe Perches					WARN("TRAILING_SEMICOLON",
3472000d1cc1SJoe Perches					     "trailing semicolon indicates no statements, indent implies otherwise\n" .
347301464f30SAndy Whitcroft						"$here\n$ctx\n$rawlines[$ctx_ln - 1]\n");
34749c0ca6f9SAndy Whitcroft				}
34759c0ca6f9SAndy Whitcroft			}
347600df344fSAndy Whitcroft		}
347700df344fSAndy Whitcroft
34784d001e4dSAndy Whitcroft# Check relative indent for conditionals and blocks.
3479f6950a73SJoe Perches		if ($line =~ /\b(?:(?:if|while|for|(?:[a-z_]+|)for_each[a-z_]+)\s*\(|(?:do|else)\b)/ && $line !~ /^.\s*#/ && $line !~ /\}\s*while\s*/) {
34803e469cdcSAndy Whitcroft			($stat, $cond, $line_nr_next, $remain_next, $off_next) =
34813e469cdcSAndy Whitcroft				ctx_statement_block($linenr, $realcnt, 0)
34823e469cdcSAndy Whitcroft					if (!defined $stat);
34834d001e4dSAndy Whitcroft			my ($s, $c) = ($stat, $cond);
34844d001e4dSAndy Whitcroft
34854d001e4dSAndy Whitcroft			substr($s, 0, length($c), '');
34864d001e4dSAndy Whitcroft
34879f5af480SJoe Perches			# remove inline comments
34889f5af480SJoe Perches			$s =~ s/$;/ /g;
34899f5af480SJoe Perches			$c =~ s/$;/ /g;
34904d001e4dSAndy Whitcroft
34914d001e4dSAndy Whitcroft			# Find out how long the conditional actually is.
34926f779c18SAndy Whitcroft			my @newlines = ($c =~ /\n/gs);
34936f779c18SAndy Whitcroft			my $cond_lines = 1 + $#newlines;
34944d001e4dSAndy Whitcroft
34959f5af480SJoe Perches			# Make sure we remove the line prefixes as we have
34969f5af480SJoe Perches			# none on the first line, and are going to readd them
34979f5af480SJoe Perches			# where necessary.
34989f5af480SJoe Perches			$s =~ s/\n./\n/gs;
34999f5af480SJoe Perches			while ($s =~ /\n\s+\\\n/) {
35009f5af480SJoe Perches				$cond_lines += $s =~ s/\n\s+\\\n/\n/g;
35019f5af480SJoe Perches			}
35029f5af480SJoe Perches
35034d001e4dSAndy Whitcroft			# We want to check the first line inside the block
35044d001e4dSAndy Whitcroft			# starting at the end of the conditional, so remove:
35054d001e4dSAndy Whitcroft			#  1) any blank line termination
35064d001e4dSAndy Whitcroft			#  2) any opening brace { on end of the line
35074d001e4dSAndy Whitcroft			#  3) any do (...) {
35084d001e4dSAndy Whitcroft			my $continuation = 0;
35094d001e4dSAndy Whitcroft			my $check = 0;
35104d001e4dSAndy Whitcroft			$s =~ s/^.*\bdo\b//;
35114d001e4dSAndy Whitcroft			$s =~ s/^\s*{//;
35124d001e4dSAndy Whitcroft			if ($s =~ s/^\s*\\//) {
35134d001e4dSAndy Whitcroft				$continuation = 1;
35144d001e4dSAndy Whitcroft			}
35159bd49efeSAndy Whitcroft			if ($s =~ s/^\s*?\n//) {
35164d001e4dSAndy Whitcroft				$check = 1;
35174d001e4dSAndy Whitcroft				$cond_lines++;
35184d001e4dSAndy Whitcroft			}
35194d001e4dSAndy Whitcroft
35204d001e4dSAndy Whitcroft			# Also ignore a loop construct at the end of a
35214d001e4dSAndy Whitcroft			# preprocessor statement.
35224d001e4dSAndy Whitcroft			if (($prevline =~ /^.\s*#\s*define\s/ ||
35234d001e4dSAndy Whitcroft			    $prevline =~ /\\\s*$/) && $continuation == 0) {
35244d001e4dSAndy Whitcroft				$check = 0;
35254d001e4dSAndy Whitcroft			}
35264d001e4dSAndy Whitcroft
35279bd49efeSAndy Whitcroft			my $cond_ptr = -1;
3528740504c6SAndy Whitcroft			$continuation = 0;
35299bd49efeSAndy Whitcroft			while ($cond_ptr != $cond_lines) {
35309bd49efeSAndy Whitcroft				$cond_ptr = $cond_lines;
35314d001e4dSAndy Whitcroft
3532f16fa28fSAndy Whitcroft				# If we see an #else/#elif then the code
3533f16fa28fSAndy Whitcroft				# is not linear.
3534f16fa28fSAndy Whitcroft				if ($s =~ /^\s*\#\s*(?:else|elif)/) {
3535f16fa28fSAndy Whitcroft					$check = 0;
3536f16fa28fSAndy Whitcroft				}
3537f16fa28fSAndy Whitcroft
35389bd49efeSAndy Whitcroft				# Ignore:
35399bd49efeSAndy Whitcroft				#  1) blank lines, they should be at 0,
35409bd49efeSAndy Whitcroft				#  2) preprocessor lines, and
35419bd49efeSAndy Whitcroft				#  3) labels.
3542740504c6SAndy Whitcroft				if ($continuation ||
3543740504c6SAndy Whitcroft				    $s =~ /^\s*?\n/ ||
35449bd49efeSAndy Whitcroft				    $s =~ /^\s*#\s*?/ ||
35459bd49efeSAndy Whitcroft				    $s =~ /^\s*$Ident\s*:/) {
3546740504c6SAndy Whitcroft					$continuation = ($s =~ /^.*?\\\n/) ? 1 : 0;
354730dad6ebSAndy Whitcroft					if ($s =~ s/^.*?\n//) {
35489bd49efeSAndy Whitcroft						$cond_lines++;
35499bd49efeSAndy Whitcroft					}
35504d001e4dSAndy Whitcroft				}
355130dad6ebSAndy Whitcroft			}
35524d001e4dSAndy Whitcroft
35534d001e4dSAndy Whitcroft			my (undef, $sindent) = line_stats("+" . $s);
35544d001e4dSAndy Whitcroft			my $stat_real = raw_line($linenr, $cond_lines);
35554d001e4dSAndy Whitcroft
35564d001e4dSAndy Whitcroft			# Check if either of these lines are modified, else
35574d001e4dSAndy Whitcroft			# this is not this patch's fault.
35584d001e4dSAndy Whitcroft			if (!defined($stat_real) ||
35594d001e4dSAndy Whitcroft			    $stat !~ /^\+/ && $stat_real !~ /^\+/) {
35604d001e4dSAndy Whitcroft				$check = 0;
35614d001e4dSAndy Whitcroft			}
35624d001e4dSAndy Whitcroft			if (defined($stat_real) && $cond_lines > 1) {
35634d001e4dSAndy Whitcroft				$stat_real = "[...]\n$stat_real";
35644d001e4dSAndy Whitcroft			}
35654d001e4dSAndy Whitcroft
35669bd49efeSAndy 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";
35674d001e4dSAndy Whitcroft
35689f5af480SJoe Perches			if ($check && $s ne '' &&
35699f5af480SJoe Perches			    (($sindent % 8) != 0 ||
35709f5af480SJoe Perches			     ($sindent < $indent) ||
3571f6950a73SJoe Perches			     ($sindent == $indent &&
3572f6950a73SJoe Perches			      ($s !~ /^\s*(?:\}|\{|else\b)/)) ||
35739f5af480SJoe Perches			     ($sindent > $indent + 8))) {
3574000d1cc1SJoe Perches				WARN("SUSPECT_CODE_INDENT",
3575000d1cc1SJoe Perches				     "suspect code indent for conditional statements ($indent, $sindent)\n" . $herecurr . "$stat_real\n");
35764d001e4dSAndy Whitcroft			}
35774d001e4dSAndy Whitcroft		}
35784d001e4dSAndy Whitcroft
35796c72ffaaSAndy Whitcroft		# Track the 'values' across context and added lines.
35806c72ffaaSAndy Whitcroft		my $opline = $line; $opline =~ s/^./ /;
35811f65f947SAndy Whitcroft		my ($curr_values, $curr_vars) =
35821f65f947SAndy Whitcroft				annotate_values($opline . "\n", $prev_values);
35836c72ffaaSAndy Whitcroft		$curr_values = $prev_values . $curr_values;
3584c2fdda0dSAndy Whitcroft		if ($dbg_values) {
3585c2fdda0dSAndy Whitcroft			my $outline = $opline; $outline =~ s/\t/ /g;
3586cf655043SAndy Whitcroft			print "$linenr > .$outline\n";
3587cf655043SAndy Whitcroft			print "$linenr > $curr_values\n";
35881f65f947SAndy Whitcroft			print "$linenr >  $curr_vars\n";
3589c2fdda0dSAndy Whitcroft		}
35906c72ffaaSAndy Whitcroft		$prev_values = substr($curr_values, -1);
35916c72ffaaSAndy Whitcroft
359200df344fSAndy Whitcroft#ignore lines not being added
35933705ce5bSJoe Perches		next if ($line =~ /^[^\+]/);
359400df344fSAndy Whitcroft
359511ca40a0SJoe Perches# check for dereferences that span multiple lines
359611ca40a0SJoe Perches		if ($prevline =~ /^\+.*$Lval\s*(?:\.|->)\s*$/ &&
359711ca40a0SJoe Perches		    $line =~ /^\+\s*(?!\#\s*(?!define\s+|if))\s*$Lval/) {
359811ca40a0SJoe Perches			$prevline =~ /($Lval\s*(?:\.|->))\s*$/;
359911ca40a0SJoe Perches			my $ref = $1;
360011ca40a0SJoe Perches			$line =~ /^.\s*($Lval)/;
360111ca40a0SJoe Perches			$ref .= $1;
360211ca40a0SJoe Perches			$ref =~ s/\s//g;
360311ca40a0SJoe Perches			WARN("MULTILINE_DEREFERENCE",
360411ca40a0SJoe Perches			     "Avoid multiple line dereference - prefer '$ref'\n" . $hereprev);
360511ca40a0SJoe Perches		}
360611ca40a0SJoe Perches
3607a1ce18e4SJoe Perches# check for declarations of signed or unsigned without int
3608c8447115SJoe Perches		while ($line =~ m{\b($Declare)\s*(?!char\b|short\b|int\b|long\b)\s*($Ident)?\s*[=,;\[\)\(]}g) {
3609a1ce18e4SJoe Perches			my $type = $1;
3610a1ce18e4SJoe Perches			my $var = $2;
3611207a8e84SJoe Perches			$var = "" if (!defined $var);
3612207a8e84SJoe Perches			if ($type =~ /^(?:(?:$Storage|$Inline|$Attribute)\s+)*((?:un)?signed)((?:\s*\*)*)\s*$/) {
3613a1ce18e4SJoe Perches				my $sign = $1;
3614a1ce18e4SJoe Perches				my $pointer = $2;
3615a1ce18e4SJoe Perches
3616a1ce18e4SJoe Perches				$pointer = "" if (!defined $pointer);
3617a1ce18e4SJoe Perches
3618a1ce18e4SJoe Perches				if (WARN("UNSPECIFIED_INT",
3619a1ce18e4SJoe Perches					 "Prefer '" . trim($sign) . " int" . rtrim($pointer) . "' to bare use of '$sign" . rtrim($pointer) . "'\n" . $herecurr) &&
3620a1ce18e4SJoe Perches				    $fix) {
3621a1ce18e4SJoe Perches					my $decl = trim($sign) . " int ";
3622207a8e84SJoe Perches					my $comp_pointer = $pointer;
3623207a8e84SJoe Perches					$comp_pointer =~ s/\s//g;
3624207a8e84SJoe Perches					$decl .= $comp_pointer;
3625207a8e84SJoe Perches					$decl = rtrim($decl) if ($var eq "");
3626207a8e84SJoe Perches					$fixed[$fixlinenr] =~ s@\b$sign\s*\Q$pointer\E\s*$var\b@$decl$var@;
3627a1ce18e4SJoe Perches				}
3628a1ce18e4SJoe Perches			}
3629a1ce18e4SJoe Perches		}
3630a1ce18e4SJoe Perches
3631653d4876SAndy Whitcroft# TEST: allow direct testing of the type matcher.
36327429c690SAndy Whitcroft		if ($dbg_type) {
36337429c690SAndy Whitcroft			if ($line =~ /^.\s*$Declare\s*$/) {
3634000d1cc1SJoe Perches				ERROR("TEST_TYPE",
3635000d1cc1SJoe Perches				      "TEST: is type\n" . $herecurr);
36367429c690SAndy Whitcroft			} elsif ($dbg_type > 1 && $line =~ /^.+($Declare)/) {
3637000d1cc1SJoe Perches				ERROR("TEST_NOT_TYPE",
3638000d1cc1SJoe Perches				      "TEST: is not type ($1 is)\n". $herecurr);
36397429c690SAndy Whitcroft			}
3640653d4876SAndy Whitcroft			next;
3641653d4876SAndy Whitcroft		}
3642a1ef277eSAndy Whitcroft# TEST: allow direct testing of the attribute matcher.
3643a1ef277eSAndy Whitcroft		if ($dbg_attr) {
36449360b0e5SAndy Whitcroft			if ($line =~ /^.\s*$Modifier\s*$/) {
3645000d1cc1SJoe Perches				ERROR("TEST_ATTR",
3646000d1cc1SJoe Perches				      "TEST: is attr\n" . $herecurr);
36479360b0e5SAndy Whitcroft			} elsif ($dbg_attr > 1 && $line =~ /^.+($Modifier)/) {
3648000d1cc1SJoe Perches				ERROR("TEST_NOT_ATTR",
3649000d1cc1SJoe Perches				      "TEST: is not attr ($1 is)\n". $herecurr);
3650a1ef277eSAndy Whitcroft			}
3651a1ef277eSAndy Whitcroft			next;
3652a1ef277eSAndy Whitcroft		}
3653653d4876SAndy Whitcroft
3654f0a594c1SAndy Whitcroft# check for initialisation to aggregates open brace on the next line
365599423c20SAndy Whitcroft		if ($line =~ /^.\s*{/ &&
365699423c20SAndy Whitcroft		    $prevline =~ /(?:^|[^=])=\s*$/) {
3657d752fcc8SJoe Perches			if (ERROR("OPEN_BRACE",
3658d752fcc8SJoe Perches				  "that open brace { should be on the previous line\n" . $hereprev) &&
3659f2d7e4d4SJoe Perches			    $fix && $prevline =~ /^\+/ && $line =~ /^\+/) {
3660f2d7e4d4SJoe Perches				fix_delete_line($fixlinenr - 1, $prevrawline);
3661f2d7e4d4SJoe Perches				fix_delete_line($fixlinenr, $rawline);
3662d752fcc8SJoe Perches				my $fixedline = $prevrawline;
3663d752fcc8SJoe Perches				$fixedline =~ s/\s*=\s*$/ = {/;
3664f2d7e4d4SJoe Perches				fix_insert_line($fixlinenr, $fixedline);
3665d752fcc8SJoe Perches				$fixedline = $line;
36668d81ae05SCyril Bur				$fixedline =~ s/^(.\s*)\{\s*/$1/;
3667f2d7e4d4SJoe Perches				fix_insert_line($fixlinenr, $fixedline);
3668d752fcc8SJoe Perches			}
3669f0a594c1SAndy Whitcroft		}
3670f0a594c1SAndy Whitcroft
367100df344fSAndy Whitcroft#
367200df344fSAndy Whitcroft# Checks which are anchored on the added line.
367300df344fSAndy Whitcroft#
367400df344fSAndy Whitcroft
3675653d4876SAndy Whitcroft# check for malformed paths in #include statements (uses RAW line)
3676c45dcabdSAndy Whitcroft		if ($rawline =~ m{^.\s*\#\s*include\s+[<"](.*)[">]}) {
3677653d4876SAndy Whitcroft			my $path = $1;
3678653d4876SAndy Whitcroft			if ($path =~ m{//}) {
3679000d1cc1SJoe Perches				ERROR("MALFORMED_INCLUDE",
3680495e9d84SJoe Perches				      "malformed #include filename\n" . $herecurr);
3681495e9d84SJoe Perches			}
3682495e9d84SJoe Perches			if ($path =~ "^uapi/" && $realfile =~ m@\binclude/uapi/@) {
3683495e9d84SJoe Perches				ERROR("UAPI_INCLUDE",
3684495e9d84SJoe Perches				      "No #include in ...include/uapi/... should use a uapi/ path prefix\n" . $herecurr);
3685653d4876SAndy Whitcroft			}
3686653d4876SAndy Whitcroft		}
3687653d4876SAndy Whitcroft
368800df344fSAndy Whitcroft# no C99 // comments
368900df344fSAndy Whitcroft		if ($line =~ m{//}) {
36903705ce5bSJoe Perches			if (ERROR("C99_COMMENTS",
36913705ce5bSJoe Perches				  "do not use C99 // comments\n" . $herecurr) &&
36923705ce5bSJoe Perches			    $fix) {
3693194f66fcSJoe Perches				my $line = $fixed[$fixlinenr];
36943705ce5bSJoe Perches				if ($line =~ /\/\/(.*)$/) {
36953705ce5bSJoe Perches					my $comment = trim($1);
3696194f66fcSJoe Perches					$fixed[$fixlinenr] =~ s@\/\/(.*)$@/\* $comment \*/@;
36973705ce5bSJoe Perches				}
36983705ce5bSJoe Perches			}
369900df344fSAndy Whitcroft		}
370000df344fSAndy Whitcroft		# Remove C99 comments.
37010a920b5bSAndy Whitcroft		$line =~ s@//.*@@;
37026c72ffaaSAndy Whitcroft		$opline =~ s@//.*@@;
37030a920b5bSAndy Whitcroft
37042b474a1aSAndy Whitcroft# EXPORT_SYMBOL should immediately follow the thing it is exporting, consider
37052b474a1aSAndy Whitcroft# the whole statement.
37062b474a1aSAndy Whitcroft#print "APW <$lines[$realline_next - 1]>\n";
37072b474a1aSAndy Whitcroft		if (defined $realline_next &&
37082b474a1aSAndy Whitcroft		    exists $lines[$realline_next - 1] &&
37092b474a1aSAndy Whitcroft		    !defined $suppress_export{$realline_next} &&
37102b474a1aSAndy Whitcroft		    ($lines[$realline_next - 1] =~ /EXPORT_SYMBOL.*\((.*)\)/ ||
37112b474a1aSAndy Whitcroft		     $lines[$realline_next - 1] =~ /EXPORT_UNUSED_SYMBOL.*\((.*)\)/)) {
37123cbf62dfSAndy Whitcroft			# Handle definitions which produce identifiers with
37133cbf62dfSAndy Whitcroft			# a prefix:
37143cbf62dfSAndy Whitcroft			#   XXX(foo);
37153cbf62dfSAndy Whitcroft			#   EXPORT_SYMBOL(something_foo);
3716653d4876SAndy Whitcroft			my $name = $1;
371787a53877SAndy Whitcroft			if ($stat =~ /^(?:.\s*}\s*\n)?.([A-Z_]+)\s*\(\s*($Ident)/ &&
37183cbf62dfSAndy Whitcroft			    $name =~ /^${Ident}_$2/) {
37193cbf62dfSAndy Whitcroft#print "FOO C name<$name>\n";
37203cbf62dfSAndy Whitcroft				$suppress_export{$realline_next} = 1;
37213cbf62dfSAndy Whitcroft
37223cbf62dfSAndy Whitcroft			} elsif ($stat !~ /(?:
37232b474a1aSAndy Whitcroft				\n.}\s*$|
372448012058SAndy Whitcroft				^.DEFINE_$Ident\(\Q$name\E\)|
372548012058SAndy Whitcroft				^.DECLARE_$Ident\(\Q$name\E\)|
372648012058SAndy Whitcroft				^.LIST_HEAD\(\Q$name\E\)|
37272b474a1aSAndy Whitcroft				^.(?:$Storage\s+)?$Type\s*\(\s*\*\s*\Q$name\E\s*\)\s*\(|
37282b474a1aSAndy Whitcroft				\b\Q$name\E(?:\s+$Attribute)*\s*(?:;|=|\[|\()
372948012058SAndy Whitcroft			    )/x) {
37302b474a1aSAndy Whitcroft#print "FOO A<$lines[$realline_next - 1]> stat<$stat> name<$name>\n";
37312b474a1aSAndy Whitcroft				$suppress_export{$realline_next} = 2;
37322b474a1aSAndy Whitcroft			} else {
37332b474a1aSAndy Whitcroft				$suppress_export{$realline_next} = 1;
37340a920b5bSAndy Whitcroft			}
37350a920b5bSAndy Whitcroft		}
37362b474a1aSAndy Whitcroft		if (!defined $suppress_export{$linenr} &&
37372b474a1aSAndy Whitcroft		    $prevline =~ /^.\s*$/ &&
37382b474a1aSAndy Whitcroft		    ($line =~ /EXPORT_SYMBOL.*\((.*)\)/ ||
37392b474a1aSAndy Whitcroft		     $line =~ /EXPORT_UNUSED_SYMBOL.*\((.*)\)/)) {
37402b474a1aSAndy Whitcroft#print "FOO B <$lines[$linenr - 1]>\n";
37412b474a1aSAndy Whitcroft			$suppress_export{$linenr} = 2;
37422b474a1aSAndy Whitcroft		}
37432b474a1aSAndy Whitcroft		if (defined $suppress_export{$linenr} &&
37442b474a1aSAndy Whitcroft		    $suppress_export{$linenr} == 2) {
3745000d1cc1SJoe Perches			WARN("EXPORT_SYMBOL",
3746000d1cc1SJoe Perches			     "EXPORT_SYMBOL(foo); should immediately follow its function/variable\n" . $herecurr);
37472b474a1aSAndy Whitcroft		}
37480a920b5bSAndy Whitcroft
37495150bda4SJoe Eloff# check for global initialisers.
37506d32f7a3SJoe Perches		if ($line =~ /^\+$Type\s*$Ident(?:\s+$Modifier)*\s*=\s*($zero_initializer)\s*;/) {
3751d5e616fcSJoe Perches			if (ERROR("GLOBAL_INITIALISERS",
37526d32f7a3SJoe Perches				  "do not initialise globals to $1\n" . $herecurr) &&
3753d5e616fcSJoe Perches			    $fix) {
37546d32f7a3SJoe Perches				$fixed[$fixlinenr] =~ s/(^.$Type\s*$Ident(?:\s+$Modifier)*)\s*=\s*$zero_initializer\s*;/$1;/;
3755d5e616fcSJoe Perches			}
3756f0a594c1SAndy Whitcroft		}
37570a920b5bSAndy Whitcroft# check for static initialisers.
37586d32f7a3SJoe Perches		if ($line =~ /^\+.*\bstatic\s.*=\s*($zero_initializer)\s*;/) {
3759d5e616fcSJoe Perches			if (ERROR("INITIALISED_STATIC",
37606d32f7a3SJoe Perches				  "do not initialise statics to $1\n" .
3761d5e616fcSJoe Perches				      $herecurr) &&
3762d5e616fcSJoe Perches			    $fix) {
37636d32f7a3SJoe Perches				$fixed[$fixlinenr] =~ s/(\bstatic\s.*?)\s*=\s*$zero_initializer\s*;/$1;/;
3764d5e616fcSJoe Perches			}
37650a920b5bSAndy Whitcroft		}
37660a920b5bSAndy Whitcroft
37671813087dSJoe Perches# check for misordered declarations of char/short/int/long with signed/unsigned
37681813087dSJoe Perches		while ($sline =~ m{(\b$TypeMisordered\b)}g) {
37691813087dSJoe Perches			my $tmp = trim($1);
37701813087dSJoe Perches			WARN("MISORDERED_TYPE",
37711813087dSJoe Perches			     "type '$tmp' should be specified in [[un]signed] [short|int|long|long long] order\n" . $herecurr);
37721813087dSJoe Perches		}
37731813087dSJoe Perches
3774cb710ecaSJoe Perches# check for static const char * arrays.
3775cb710ecaSJoe Perches		if ($line =~ /\bstatic\s+const\s+char\s*\*\s*(\w+)\s*\[\s*\]\s*=\s*/) {
3776000d1cc1SJoe Perches			WARN("STATIC_CONST_CHAR_ARRAY",
3777000d1cc1SJoe Perches			     "static const char * array should probably be static const char * const\n" .
3778cb710ecaSJoe Perches				$herecurr);
3779cb710ecaSJoe Perches               }
3780cb710ecaSJoe Perches
3781cb710ecaSJoe Perches# check for static char foo[] = "bar" declarations.
3782cb710ecaSJoe Perches		if ($line =~ /\bstatic\s+char\s+(\w+)\s*\[\s*\]\s*=\s*"/) {
3783000d1cc1SJoe Perches			WARN("STATIC_CONST_CHAR_ARRAY",
3784000d1cc1SJoe Perches			     "static char array declaration should probably be static const char\n" .
3785cb710ecaSJoe Perches				$herecurr);
3786cb710ecaSJoe Perches               }
3787cb710ecaSJoe Perches
3788ab7e23f3SJoe Perches# check for const <foo> const where <foo> is not a pointer or array type
3789ab7e23f3SJoe Perches		if ($sline =~ /\bconst\s+($BasicType)\s+const\b/) {
3790ab7e23f3SJoe Perches			my $found = $1;
3791ab7e23f3SJoe Perches			if ($sline =~ /\bconst\s+\Q$found\E\s+const\b\s*\*/) {
3792ab7e23f3SJoe Perches				WARN("CONST_CONST",
3793ab7e23f3SJoe Perches				     "'const $found const *' should probably be 'const $found * const'\n" . $herecurr);
3794ab7e23f3SJoe Perches			} elsif ($sline !~ /\bconst\s+\Q$found\E\s+const\s+\w+\s*\[/) {
3795ab7e23f3SJoe Perches				WARN("CONST_CONST",
3796ab7e23f3SJoe Perches				     "'const $found const' should probably be 'const $found'\n" . $herecurr);
3797ab7e23f3SJoe Perches			}
3798ab7e23f3SJoe Perches		}
3799ab7e23f3SJoe Perches
38009b0fa60dSJoe Perches# check for non-global char *foo[] = {"bar", ...} declarations.
38019b0fa60dSJoe Perches		if ($line =~ /^.\s+(?:static\s+|const\s+)?char\s+\*\s*\w+\s*\[\s*\]\s*=\s*\{/) {
38029b0fa60dSJoe Perches			WARN("STATIC_CONST_CHAR_ARRAY",
38039b0fa60dSJoe Perches			     "char * array declaration might be better as static const\n" .
38049b0fa60dSJoe Perches				$herecurr);
38059b0fa60dSJoe Perches               }
38069b0fa60dSJoe Perches
3807b598b670SJoe Perches# check for sizeof(foo)/sizeof(foo[0]) that could be ARRAY_SIZE(foo)
3808b598b670SJoe Perches		if ($line =~ m@\bsizeof\s*\(\s*($Lval)\s*\)@) {
3809b598b670SJoe Perches			my $array = $1;
3810b598b670SJoe 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*\))@) {
3811b598b670SJoe Perches				my $array_div = $1;
3812b598b670SJoe Perches				if (WARN("ARRAY_SIZE",
3813b598b670SJoe Perches					 "Prefer ARRAY_SIZE($array)\n" . $herecurr) &&
3814b598b670SJoe Perches				    $fix) {
3815b598b670SJoe Perches					$fixed[$fixlinenr] =~ s/\Q$array_div\E/ARRAY_SIZE($array)/;
3816b598b670SJoe Perches				}
3817b598b670SJoe Perches			}
3818b598b670SJoe Perches		}
3819b598b670SJoe Perches
3820b36190c5SJoe Perches# check for function declarations without arguments like "int foo()"
3821b36190c5SJoe Perches		if ($line =~ /(\b$Type\s+$Ident)\s*\(\s*\)/) {
3822b36190c5SJoe Perches			if (ERROR("FUNCTION_WITHOUT_ARGS",
3823b36190c5SJoe Perches				  "Bad function definition - $1() should probably be $1(void)\n" . $herecurr) &&
3824b36190c5SJoe Perches			    $fix) {
3825194f66fcSJoe Perches				$fixed[$fixlinenr] =~ s/(\b($Type)\s+($Ident))\s*\(\s*\)/$2 $3(void)/;
3826b36190c5SJoe Perches			}
3827b36190c5SJoe Perches		}
3828b36190c5SJoe Perches
3829653d4876SAndy Whitcroft# check for new typedefs, only function parameters and sparse annotations
3830653d4876SAndy Whitcroft# make sense.
3831653d4876SAndy Whitcroft		if ($line =~ /\btypedef\s/ &&
38328054576dSAndy Whitcroft		    $line !~ /\btypedef\s+$Type\s*\(\s*\*?$Ident\s*\)\s*\(/ &&
3833c45dcabdSAndy Whitcroft		    $line !~ /\btypedef\s+$Type\s+$Ident\s*\(/ &&
38348ed22cadSAndy Whitcroft		    $line !~ /\b$typeTypedefs\b/ &&
383546d832f5SMichael S. Tsirkin		    $line !~ /\b__bitwise\b/) {
3836000d1cc1SJoe Perches			WARN("NEW_TYPEDEFS",
3837000d1cc1SJoe Perches			     "do not add new typedefs\n" . $herecurr);
38380a920b5bSAndy Whitcroft		}
38390a920b5bSAndy Whitcroft
38400a920b5bSAndy Whitcroft# * goes on variable not on type
384165863862SAndy Whitcroft		# (char*[ const])
3842bfcb2cc7SAndy Whitcroft		while ($line =~ m{(\($NonptrType(\s*(?:$Modifier\b\s*|\*\s*)+)\))}g) {
3843bfcb2cc7SAndy Whitcroft			#print "AA<$1>\n";
38443705ce5bSJoe Perches			my ($ident, $from, $to) = ($1, $2, $2);
3845d8aaf121SAndy Whitcroft
384665863862SAndy Whitcroft			# Should start with a space.
384765863862SAndy Whitcroft			$to =~ s/^(\S)/ $1/;
384865863862SAndy Whitcroft			# Should not end with a space.
384965863862SAndy Whitcroft			$to =~ s/\s+$//;
385065863862SAndy Whitcroft			# '*'s should not have spaces between.
3851f9a0b3d1SAndy Whitcroft			while ($to =~ s/\*\s+\*/\*\*/) {
385265863862SAndy Whitcroft			}
3853d8aaf121SAndy Whitcroft
38543705ce5bSJoe Perches##			print "1: from<$from> to<$to> ident<$ident>\n";
385565863862SAndy Whitcroft			if ($from ne $to) {
38563705ce5bSJoe Perches				if (ERROR("POINTER_LOCATION",
38573705ce5bSJoe Perches					  "\"(foo$from)\" should be \"(foo$to)\"\n" .  $herecurr) &&
38583705ce5bSJoe Perches				    $fix) {
38593705ce5bSJoe Perches					my $sub_from = $ident;
38603705ce5bSJoe Perches					my $sub_to = $ident;
38613705ce5bSJoe Perches					$sub_to =~ s/\Q$from\E/$to/;
3862194f66fcSJoe Perches					$fixed[$fixlinenr] =~
38633705ce5bSJoe Perches					    s@\Q$sub_from\E@$sub_to@;
38643705ce5bSJoe Perches				}
386565863862SAndy Whitcroft			}
3866bfcb2cc7SAndy Whitcroft		}
3867bfcb2cc7SAndy Whitcroft		while ($line =~ m{(\b$NonptrType(\s*(?:$Modifier\b\s*|\*\s*)+)($Ident))}g) {
3868bfcb2cc7SAndy Whitcroft			#print "BB<$1>\n";
38693705ce5bSJoe Perches			my ($match, $from, $to, $ident) = ($1, $2, $2, $3);
3870d8aaf121SAndy Whitcroft
387165863862SAndy Whitcroft			# Should start with a space.
387265863862SAndy Whitcroft			$to =~ s/^(\S)/ $1/;
387365863862SAndy Whitcroft			# Should not end with a space.
387465863862SAndy Whitcroft			$to =~ s/\s+$//;
387565863862SAndy Whitcroft			# '*'s should not have spaces between.
3876f9a0b3d1SAndy Whitcroft			while ($to =~ s/\*\s+\*/\*\*/) {
387765863862SAndy Whitcroft			}
387865863862SAndy Whitcroft			# Modifiers should have spaces.
387965863862SAndy Whitcroft			$to =~ s/(\b$Modifier$)/$1 /;
388065863862SAndy Whitcroft
38813705ce5bSJoe Perches##			print "2: from<$from> to<$to> ident<$ident>\n";
3882667026e7SAndy Whitcroft			if ($from ne $to && $ident !~ /^$Modifier$/) {
38833705ce5bSJoe Perches				if (ERROR("POINTER_LOCATION",
38843705ce5bSJoe Perches					  "\"foo${from}bar\" should be \"foo${to}bar\"\n" .  $herecurr) &&
38853705ce5bSJoe Perches				    $fix) {
38863705ce5bSJoe Perches
38873705ce5bSJoe Perches					my $sub_from = $match;
38883705ce5bSJoe Perches					my $sub_to = $match;
38893705ce5bSJoe Perches					$sub_to =~ s/\Q$from\E/$to/;
3890194f66fcSJoe Perches					$fixed[$fixlinenr] =~
38913705ce5bSJoe Perches					    s@\Q$sub_from\E@$sub_to@;
38923705ce5bSJoe Perches				}
389365863862SAndy Whitcroft			}
38940a920b5bSAndy Whitcroft		}
38950a920b5bSAndy Whitcroft
38969d3e3c70SJoe Perches# avoid BUG() or BUG_ON()
38979d3e3c70SJoe Perches		if ($line =~ /\b(?:BUG|BUG_ON)\b/) {
38980675a8fbSJean Delvare			my $msg_level = \&WARN;
38990675a8fbSJean Delvare			$msg_level = \&CHK if ($file);
39000675a8fbSJean Delvare			&{$msg_level}("AVOID_BUG",
39019d3e3c70SJoe Perches				      "Avoid crashing the kernel - try using WARN_ON & recovery code rather than BUG() or BUG_ON()\n" . $herecurr);
39029d3e3c70SJoe Perches		}
39030a920b5bSAndy Whitcroft
39049d3e3c70SJoe Perches# avoid LINUX_VERSION_CODE
39058905a67cSAndy Whitcroft		if ($line =~ /\bLINUX_VERSION_CODE\b/) {
3906000d1cc1SJoe Perches			WARN("LINUX_VERSION_CODE",
3907000d1cc1SJoe Perches			     "LINUX_VERSION_CODE should be avoided, code should be for the version to which it is merged\n" . $herecurr);
39088905a67cSAndy Whitcroft		}
39098905a67cSAndy Whitcroft
391017441227SJoe Perches# check for uses of printk_ratelimit
391117441227SJoe Perches		if ($line =~ /\bprintk_ratelimit\s*\(/) {
3912000d1cc1SJoe Perches			WARN("PRINTK_RATELIMITED",
3913000d1cc1SJoe Perches			     "Prefer printk_ratelimited or pr_<level>_ratelimited to printk_ratelimit\n" . $herecurr);
391417441227SJoe Perches		}
391517441227SJoe Perches
3916eeef5733SJoe Perches# printk should use KERN_* levels
3917eeef5733SJoe Perches		if ($line =~ /\bprintk\s*\(\s*(?!KERN_[A-Z]+\b)/) {
3918000d1cc1SJoe Perches			WARN("PRINTK_WITHOUT_KERN_LEVEL",
3919eeef5733SJoe Perches			     "printk() should include KERN_<LEVEL> facility level\n" . $herecurr);
392000df344fSAndy Whitcroft		}
39210a920b5bSAndy Whitcroft
3922243f3803SJoe Perches		if ($line =~ /\bprintk\s*\(\s*KERN_([A-Z]+)/) {
3923243f3803SJoe Perches			my $orig = $1;
3924243f3803SJoe Perches			my $level = lc($orig);
3925243f3803SJoe Perches			$level = "warn" if ($level eq "warning");
39268f26b837SJoe Perches			my $level2 = $level;
39278f26b837SJoe Perches			$level2 = "dbg" if ($level eq "debug");
3928243f3803SJoe Perches			WARN("PREFER_PR_LEVEL",
3929daa8b059SYogesh Chaudhari			     "Prefer [subsystem eg: netdev]_$level2([subsystem]dev, ... then dev_$level2(dev, ... then pr_$level(...  to printk(KERN_$orig ...\n" . $herecurr);
3930243f3803SJoe Perches		}
3931243f3803SJoe Perches
3932243f3803SJoe Perches		if ($line =~ /\bpr_warning\s*\(/) {
3933d5e616fcSJoe Perches			if (WARN("PREFER_PR_LEVEL",
3934d5e616fcSJoe Perches				 "Prefer pr_warn(... to pr_warning(...\n" . $herecurr) &&
3935d5e616fcSJoe Perches			    $fix) {
3936194f66fcSJoe Perches				$fixed[$fixlinenr] =~
3937d5e616fcSJoe Perches				    s/\bpr_warning\b/pr_warn/;
3938d5e616fcSJoe Perches			}
3939243f3803SJoe Perches		}
3940243f3803SJoe Perches
3941dc139313SJoe Perches		if ($line =~ /\bdev_printk\s*\(\s*KERN_([A-Z]+)/) {
3942dc139313SJoe Perches			my $orig = $1;
3943dc139313SJoe Perches			my $level = lc($orig);
3944dc139313SJoe Perches			$level = "warn" if ($level eq "warning");
3945dc139313SJoe Perches			$level = "dbg" if ($level eq "debug");
3946dc139313SJoe Perches			WARN("PREFER_DEV_LEVEL",
3947dc139313SJoe Perches			     "Prefer dev_$level(... to dev_printk(KERN_$orig, ...\n" . $herecurr);
3948dc139313SJoe Perches		}
3949dc139313SJoe Perches
395091c9afafSAndy Lutomirski# ENOSYS means "bad syscall nr" and nothing else.  This will have a small
395191c9afafSAndy Lutomirski# number of false positives, but assembly files are not checked, so at
395291c9afafSAndy Lutomirski# least the arch entry code will not trigger this warning.
395391c9afafSAndy Lutomirski		if ($line =~ /\bENOSYS\b/) {
395491c9afafSAndy Lutomirski			WARN("ENOSYS",
395591c9afafSAndy Lutomirski			     "ENOSYS means 'invalid syscall nr' and nothing else\n" . $herecurr);
395691c9afafSAndy Lutomirski		}
395791c9afafSAndy Lutomirski
3958653d4876SAndy Whitcroft# function brace can't be on same line, except for #defines of do while,
3959653d4876SAndy Whitcroft# or if closed on same line
39602d453e3bSJoe Perches		if ($^V && $^V ge 5.10.0 &&
39612d453e3bSJoe Perches		    $sline =~ /$Type\s*$Ident\s*$balanced_parens\s*\{/ &&
39622d453e3bSJoe Perches		    $sline !~ /\#\s*define\b.*do\s*\{/ &&
39632d453e3bSJoe Perches		    $sline !~ /}/) {
39648d182478SJoe Perches			if (ERROR("OPEN_BRACE",
39652d453e3bSJoe Perches				  "open brace '{' following function definitions go on the next line\n" . $herecurr) &&
39668d182478SJoe Perches			    $fix) {
39678d182478SJoe Perches				fix_delete_line($fixlinenr, $rawline);
39688d182478SJoe Perches				my $fixed_line = $rawline;
39698d182478SJoe Perches				$fixed_line =~ /(^..*$Type\s*$Ident\(.*\)\s*){(.*)$/;
39708d182478SJoe Perches				my $line1 = $1;
39718d182478SJoe Perches				my $line2 = $2;
39728d182478SJoe Perches				fix_insert_line($fixlinenr, ltrim($line1));
39738d182478SJoe Perches				fix_insert_line($fixlinenr, "\+{");
39748d182478SJoe Perches				if ($line2 !~ /^\s*$/) {
39758d182478SJoe Perches					fix_insert_line($fixlinenr, "\+\t" . trim($line2));
39768d182478SJoe Perches				}
39778d182478SJoe Perches			}
39780a920b5bSAndy Whitcroft		}
3979653d4876SAndy Whitcroft
39808905a67cSAndy Whitcroft# open braces for enum, union and struct go on the same line.
39818905a67cSAndy Whitcroft		if ($line =~ /^.\s*{/ &&
39828905a67cSAndy Whitcroft		    $prevline =~ /^.\s*(?:typedef\s+)?(enum|union|struct)(?:\s+$Ident)?\s*$/) {
39838d182478SJoe Perches			if (ERROR("OPEN_BRACE",
39848d182478SJoe Perches				  "open brace '{' following $1 go on the same line\n" . $hereprev) &&
39858d182478SJoe Perches			    $fix && $prevline =~ /^\+/ && $line =~ /^\+/) {
39868d182478SJoe Perches				fix_delete_line($fixlinenr - 1, $prevrawline);
39878d182478SJoe Perches				fix_delete_line($fixlinenr, $rawline);
39888d182478SJoe Perches				my $fixedline = rtrim($prevrawline) . " {";
39898d182478SJoe Perches				fix_insert_line($fixlinenr, $fixedline);
39908d182478SJoe Perches				$fixedline = $rawline;
39918d81ae05SCyril Bur				$fixedline =~ s/^(.\s*)\{\s*/$1\t/;
39928d182478SJoe Perches				if ($fixedline !~ /^\+\s*$/) {
39938d182478SJoe Perches					fix_insert_line($fixlinenr, $fixedline);
39948d182478SJoe Perches				}
39958d182478SJoe Perches			}
39968905a67cSAndy Whitcroft		}
39978905a67cSAndy Whitcroft
39980c73b4ebSAndy Whitcroft# missing space after union, struct or enum definition
39993705ce5bSJoe Perches		if ($line =~ /^.\s*(?:typedef\s+)?(enum|union|struct)(?:\s+$Ident){1,2}[=\{]/) {
40003705ce5bSJoe Perches			if (WARN("SPACING",
40013705ce5bSJoe Perches				 "missing space after $1 definition\n" . $herecurr) &&
40023705ce5bSJoe Perches			    $fix) {
4003194f66fcSJoe Perches				$fixed[$fixlinenr] =~
40043705ce5bSJoe Perches				    s/^(.\s*(?:typedef\s+)?(?:enum|union|struct)(?:\s+$Ident){1,2})([=\{])/$1 $2/;
40053705ce5bSJoe Perches			}
40060c73b4ebSAndy Whitcroft		}
40070c73b4ebSAndy Whitcroft
400831070b5dSJoe Perches# Function pointer declarations
400931070b5dSJoe Perches# check spacing between type, funcptr, and args
401031070b5dSJoe Perches# canonical declaration is "type (*funcptr)(args...)"
401191f72e9cSJoe Perches		if ($line =~ /^.\s*($Declare)\((\s*)\*(\s*)($Ident)(\s*)\)(\s*)\(/) {
401231070b5dSJoe Perches			my $declare = $1;
401331070b5dSJoe Perches			my $pre_pointer_space = $2;
401431070b5dSJoe Perches			my $post_pointer_space = $3;
401531070b5dSJoe Perches			my $funcname = $4;
401631070b5dSJoe Perches			my $post_funcname_space = $5;
401731070b5dSJoe Perches			my $pre_args_space = $6;
401831070b5dSJoe Perches
401991f72e9cSJoe Perches# the $Declare variable will capture all spaces after the type
402091f72e9cSJoe Perches# so check it for a missing trailing missing space but pointer return types
402191f72e9cSJoe Perches# don't need a space so don't warn for those.
402291f72e9cSJoe Perches			my $post_declare_space = "";
402391f72e9cSJoe Perches			if ($declare =~ /(\s+)$/) {
402491f72e9cSJoe Perches				$post_declare_space = $1;
402591f72e9cSJoe Perches				$declare = rtrim($declare);
402691f72e9cSJoe Perches			}
402791f72e9cSJoe Perches			if ($declare !~ /\*$/ && $post_declare_space =~ /^$/) {
402831070b5dSJoe Perches				WARN("SPACING",
402931070b5dSJoe Perches				     "missing space after return type\n" . $herecurr);
403091f72e9cSJoe Perches				$post_declare_space = " ";
403131070b5dSJoe Perches			}
403231070b5dSJoe Perches
403331070b5dSJoe Perches# unnecessary space "type  (*funcptr)(args...)"
403491f72e9cSJoe Perches# This test is not currently implemented because these declarations are
403591f72e9cSJoe Perches# equivalent to
403691f72e9cSJoe Perches#	int  foo(int bar, ...)
403791f72e9cSJoe Perches# and this is form shouldn't/doesn't generate a checkpatch warning.
403891f72e9cSJoe Perches#
403991f72e9cSJoe Perches#			elsif ($declare =~ /\s{2,}$/) {
404091f72e9cSJoe Perches#				WARN("SPACING",
404191f72e9cSJoe Perches#				     "Multiple spaces after return type\n" . $herecurr);
404291f72e9cSJoe Perches#			}
404331070b5dSJoe Perches
404431070b5dSJoe Perches# unnecessary space "type ( *funcptr)(args...)"
404531070b5dSJoe Perches			if (defined $pre_pointer_space &&
404631070b5dSJoe Perches			    $pre_pointer_space =~ /^\s/) {
404731070b5dSJoe Perches				WARN("SPACING",
404831070b5dSJoe Perches				     "Unnecessary space after function pointer open parenthesis\n" . $herecurr);
404931070b5dSJoe Perches			}
405031070b5dSJoe Perches
405131070b5dSJoe Perches# unnecessary space "type (* funcptr)(args...)"
405231070b5dSJoe Perches			if (defined $post_pointer_space &&
405331070b5dSJoe Perches			    $post_pointer_space =~ /^\s/) {
405431070b5dSJoe Perches				WARN("SPACING",
405531070b5dSJoe Perches				     "Unnecessary space before function pointer name\n" . $herecurr);
405631070b5dSJoe Perches			}
405731070b5dSJoe Perches
405831070b5dSJoe Perches# unnecessary space "type (*funcptr )(args...)"
405931070b5dSJoe Perches			if (defined $post_funcname_space &&
406031070b5dSJoe Perches			    $post_funcname_space =~ /^\s/) {
406131070b5dSJoe Perches				WARN("SPACING",
406231070b5dSJoe Perches				     "Unnecessary space after function pointer name\n" . $herecurr);
406331070b5dSJoe Perches			}
406431070b5dSJoe Perches
406531070b5dSJoe Perches# unnecessary space "type (*funcptr) (args...)"
406631070b5dSJoe Perches			if (defined $pre_args_space &&
406731070b5dSJoe Perches			    $pre_args_space =~ /^\s/) {
406831070b5dSJoe Perches				WARN("SPACING",
406931070b5dSJoe Perches				     "Unnecessary space before function pointer arguments\n" . $herecurr);
407031070b5dSJoe Perches			}
407131070b5dSJoe Perches
407231070b5dSJoe Perches			if (show_type("SPACING") && $fix) {
4073194f66fcSJoe Perches				$fixed[$fixlinenr] =~
407491f72e9cSJoe Perches				    s/^(.\s*)$Declare\s*\(\s*\*\s*$Ident\s*\)\s*\(/$1 . $declare . $post_declare_space . '(*' . $funcname . ')('/ex;
407531070b5dSJoe Perches			}
407631070b5dSJoe Perches		}
407731070b5dSJoe Perches
40788d31cfceSAndy Whitcroft# check for spacing round square brackets; allowed:
40798d31cfceSAndy Whitcroft#  1. with a type on the left -- int [] a;
4080fe2a7dbcSAndy Whitcroft#  2. at the beginning of a line for slice initialisers -- [0...10] = 5,
4081fe2a7dbcSAndy Whitcroft#  3. inside a curly brace -- = { [0...10] = 5 }
40828d31cfceSAndy Whitcroft		while ($line =~ /(.*?\s)\[/g) {
40838d31cfceSAndy Whitcroft			my ($where, $prefix) = ($-[1], $1);
40848d31cfceSAndy Whitcroft			if ($prefix !~ /$Type\s+$/ &&
4085fe2a7dbcSAndy Whitcroft			    ($where != 0 || $prefix !~ /^.\s+$/) &&
4086daebc534SAndy Whitcroft			    $prefix !~ /[{,]\s+$/) {
40873705ce5bSJoe Perches				if (ERROR("BRACKET_SPACE",
40883705ce5bSJoe Perches					  "space prohibited before open square bracket '['\n" . $herecurr) &&
40893705ce5bSJoe Perches				    $fix) {
4090194f66fcSJoe Perches				    $fixed[$fixlinenr] =~
40913705ce5bSJoe Perches					s/^(\+.*?)\s+\[/$1\[/;
40923705ce5bSJoe Perches				}
40938d31cfceSAndy Whitcroft			}
40948d31cfceSAndy Whitcroft		}
40958d31cfceSAndy Whitcroft
4096f0a594c1SAndy Whitcroft# check for spaces between functions and their parentheses.
40976c72ffaaSAndy Whitcroft		while ($line =~ /($Ident)\s+\(/g) {
4098c2fdda0dSAndy Whitcroft			my $name = $1;
4099773647a0SAndy Whitcroft			my $ctx_before = substr($line, 0, $-[1]);
4100773647a0SAndy Whitcroft			my $ctx = "$ctx_before$name";
4101c2fdda0dSAndy Whitcroft
4102c2fdda0dSAndy Whitcroft			# Ignore those directives where spaces _are_ permitted.
4103773647a0SAndy Whitcroft			if ($name =~ /^(?:
4104773647a0SAndy Whitcroft				if|for|while|switch|return|case|
4105773647a0SAndy Whitcroft				volatile|__volatile__|
4106773647a0SAndy Whitcroft				__attribute__|format|__extension__|
4107773647a0SAndy Whitcroft				asm|__asm__)$/x)
4108773647a0SAndy Whitcroft			{
4109c2fdda0dSAndy Whitcroft			# cpp #define statements have non-optional spaces, ie
4110c2fdda0dSAndy Whitcroft			# if there is a space between the name and the open
4111c2fdda0dSAndy Whitcroft			# parenthesis it is simply not a parameter group.
4112c45dcabdSAndy Whitcroft			} elsif ($ctx_before =~ /^.\s*\#\s*define\s*$/) {
4113773647a0SAndy Whitcroft
4114773647a0SAndy Whitcroft			# cpp #elif statement condition may start with a (
4115c45dcabdSAndy Whitcroft			} elsif ($ctx =~ /^.\s*\#\s*elif\s*$/) {
4116c2fdda0dSAndy Whitcroft
4117c2fdda0dSAndy Whitcroft			# If this whole things ends with a type its most
4118c2fdda0dSAndy Whitcroft			# likely a typedef for a function.
4119773647a0SAndy Whitcroft			} elsif ($ctx =~ /$Type$/) {
4120c2fdda0dSAndy Whitcroft
4121c2fdda0dSAndy Whitcroft			} else {
41223705ce5bSJoe Perches				if (WARN("SPACING",
41233705ce5bSJoe Perches					 "space prohibited between function name and open parenthesis '('\n" . $herecurr) &&
41243705ce5bSJoe Perches					     $fix) {
4125194f66fcSJoe Perches					$fixed[$fixlinenr] =~
41263705ce5bSJoe Perches					    s/\b$name\s+\(/$name\(/;
41273705ce5bSJoe Perches				}
4128f0a594c1SAndy Whitcroft			}
41296c72ffaaSAndy Whitcroft		}
41309a4cad4eSEric Nelson
4131653d4876SAndy Whitcroft# Check operator spacing.
41320a920b5bSAndy Whitcroft		if (!($line=~/\#\s*include/)) {
41333705ce5bSJoe Perches			my $fixed_line = "";
41343705ce5bSJoe Perches			my $line_fixed = 0;
41353705ce5bSJoe Perches
41369c0ca6f9SAndy Whitcroft			my $ops = qr{
41379c0ca6f9SAndy Whitcroft				<<=|>>=|<=|>=|==|!=|
41389c0ca6f9SAndy Whitcroft				\+=|-=|\*=|\/=|%=|\^=|\|=|&=|
41399c0ca6f9SAndy Whitcroft				=>|->|<<|>>|<|>|=|!|~|
41401f65f947SAndy Whitcroft				&&|\|\||,|\^|\+\+|--|&|\||\+|-|\*|\/|%|
414184731623SJoe Perches				\?:|\?|:
41429c0ca6f9SAndy Whitcroft			}x;
4143cf655043SAndy Whitcroft			my @elements = split(/($ops|;)/, $opline);
41443705ce5bSJoe Perches
41453705ce5bSJoe Perches##			print("element count: <" . $#elements . ">\n");
41463705ce5bSJoe Perches##			foreach my $el (@elements) {
41473705ce5bSJoe Perches##				print("el: <$el>\n");
41483705ce5bSJoe Perches##			}
41493705ce5bSJoe Perches
41503705ce5bSJoe Perches			my @fix_elements = ();
415100df344fSAndy Whitcroft			my $off = 0;
41526c72ffaaSAndy Whitcroft
41533705ce5bSJoe Perches			foreach my $el (@elements) {
41543705ce5bSJoe Perches				push(@fix_elements, substr($rawline, $off, length($el)));
41553705ce5bSJoe Perches				$off += length($el);
41563705ce5bSJoe Perches			}
41573705ce5bSJoe Perches
41583705ce5bSJoe Perches			$off = 0;
41593705ce5bSJoe Perches
41606c72ffaaSAndy Whitcroft			my $blank = copy_spacing($opline);
4161b34c648bSJoe Perches			my $last_after = -1;
41626c72ffaaSAndy Whitcroft
41630a920b5bSAndy Whitcroft			for (my $n = 0; $n < $#elements; $n += 2) {
41643705ce5bSJoe Perches
41653705ce5bSJoe Perches				my $good = $fix_elements[$n] . $fix_elements[$n + 1];
41663705ce5bSJoe Perches
41673705ce5bSJoe Perches##				print("n: <$n> good: <$good>\n");
41683705ce5bSJoe Perches
41694a0df2efSAndy Whitcroft				$off += length($elements[$n]);
41704a0df2efSAndy Whitcroft
417125985edcSLucas De Marchi				# Pick up the preceding and succeeding characters.
4172773647a0SAndy Whitcroft				my $ca = substr($opline, 0, $off);
4173773647a0SAndy Whitcroft				my $cc = '';
4174773647a0SAndy Whitcroft				if (length($opline) >= ($off + length($elements[$n + 1]))) {
4175773647a0SAndy Whitcroft					$cc = substr($opline, $off + length($elements[$n + 1]));
4176773647a0SAndy Whitcroft				}
4177773647a0SAndy Whitcroft				my $cb = "$ca$;$cc";
4178773647a0SAndy Whitcroft
41794a0df2efSAndy Whitcroft				my $a = '';
41804a0df2efSAndy Whitcroft				$a = 'V' if ($elements[$n] ne '');
41814a0df2efSAndy Whitcroft				$a = 'W' if ($elements[$n] =~ /\s$/);
4182cf655043SAndy Whitcroft				$a = 'C' if ($elements[$n] =~ /$;$/);
41834a0df2efSAndy Whitcroft				$a = 'B' if ($elements[$n] =~ /(\[|\()$/);
41844a0df2efSAndy Whitcroft				$a = 'O' if ($elements[$n] eq '');
4185773647a0SAndy Whitcroft				$a = 'E' if ($ca =~ /^\s*$/);
41864a0df2efSAndy Whitcroft
41870a920b5bSAndy Whitcroft				my $op = $elements[$n + 1];
41884a0df2efSAndy Whitcroft
41894a0df2efSAndy Whitcroft				my $c = '';
41900a920b5bSAndy Whitcroft				if (defined $elements[$n + 2]) {
41914a0df2efSAndy Whitcroft					$c = 'V' if ($elements[$n + 2] ne '');
41924a0df2efSAndy Whitcroft					$c = 'W' if ($elements[$n + 2] =~ /^\s/);
4193cf655043SAndy Whitcroft					$c = 'C' if ($elements[$n + 2] =~ /^$;/);
41944a0df2efSAndy Whitcroft					$c = 'B' if ($elements[$n + 2] =~ /^(\)|\]|;)/);
41954a0df2efSAndy Whitcroft					$c = 'O' if ($elements[$n + 2] eq '');
41968b1b3378SAndy Whitcroft					$c = 'E' if ($elements[$n + 2] =~ /^\s*\\$/);
41974a0df2efSAndy Whitcroft				} else {
41984a0df2efSAndy Whitcroft					$c = 'E';
41990a920b5bSAndy Whitcroft				}
42000a920b5bSAndy Whitcroft
42014a0df2efSAndy Whitcroft				my $ctx = "${a}x${c}";
42024a0df2efSAndy Whitcroft
42034a0df2efSAndy Whitcroft				my $at = "(ctx:$ctx)";
42044a0df2efSAndy Whitcroft
42056c72ffaaSAndy Whitcroft				my $ptr = substr($blank, 0, $off) . "^";
4206de7d4f0eSAndy Whitcroft				my $hereptr = "$hereline$ptr\n";
42070a920b5bSAndy Whitcroft
420874048ed8SAndy Whitcroft				# Pull out the value of this operator.
42096c72ffaaSAndy Whitcroft				my $op_type = substr($curr_values, $off + 1, 1);
42100a920b5bSAndy Whitcroft
42111f65f947SAndy Whitcroft				# Get the full operator variant.
42121f65f947SAndy Whitcroft				my $opv = $op . substr($curr_vars, $off, 1);
42131f65f947SAndy Whitcroft
421413214adfSAndy Whitcroft				# Ignore operators passed as parameters.
421513214adfSAndy Whitcroft				if ($op_type ne 'V' &&
4216d7fe8065SSam Bobroff				    $ca =~ /\s$/ && $cc =~ /^\s*[,\)]/) {
421713214adfSAndy Whitcroft
4218cf655043SAndy Whitcroft#				# Ignore comments
4219cf655043SAndy Whitcroft#				} elsif ($op =~ /^$;+$/) {
422013214adfSAndy Whitcroft
4221d8aaf121SAndy Whitcroft				# ; should have either the end of line or a space or \ after it
422213214adfSAndy Whitcroft				} elsif ($op eq ';') {
4223cf655043SAndy Whitcroft					if ($ctx !~ /.x[WEBC]/ &&
4224cf655043SAndy Whitcroft					    $cc !~ /^\\/ && $cc !~ /^;/) {
42253705ce5bSJoe Perches						if (ERROR("SPACING",
42263705ce5bSJoe Perches							  "space required after that '$op' $at\n" . $hereptr)) {
4227b34c648bSJoe Perches							$good = $fix_elements[$n] . trim($fix_elements[$n + 1]) . " ";
42283705ce5bSJoe Perches							$line_fixed = 1;
42293705ce5bSJoe Perches						}
4230d8aaf121SAndy Whitcroft					}
4231d8aaf121SAndy Whitcroft
4232d8aaf121SAndy Whitcroft				# // is a comment
4233d8aaf121SAndy Whitcroft				} elsif ($op eq '//') {
42340a920b5bSAndy Whitcroft
4235b00e4814SJoe Perches				#   :   when part of a bitfield
4236b00e4814SJoe Perches				} elsif ($opv eq ':B') {
4237b00e4814SJoe Perches					# skip the bitfield test for now
4238b00e4814SJoe Perches
42391f65f947SAndy Whitcroft				# No spaces for:
42401f65f947SAndy Whitcroft				#   ->
4241b00e4814SJoe Perches				} elsif ($op eq '->') {
42424a0df2efSAndy Whitcroft					if ($ctx =~ /Wx.|.xW/) {
42433705ce5bSJoe Perches						if (ERROR("SPACING",
42443705ce5bSJoe Perches							  "spaces prohibited around that '$op' $at\n" . $hereptr)) {
4245b34c648bSJoe Perches							$good = rtrim($fix_elements[$n]) . trim($fix_elements[$n + 1]);
42463705ce5bSJoe Perches							if (defined $fix_elements[$n + 2]) {
42473705ce5bSJoe Perches								$fix_elements[$n + 2] =~ s/^\s+//;
42483705ce5bSJoe Perches							}
4249b34c648bSJoe Perches							$line_fixed = 1;
42503705ce5bSJoe Perches						}
42510a920b5bSAndy Whitcroft					}
42520a920b5bSAndy Whitcroft
42532381097bSJoe Perches				# , must not have a space before and must have a space on the right.
42540a920b5bSAndy Whitcroft				} elsif ($op eq ',') {
42552381097bSJoe Perches					my $rtrim_before = 0;
42562381097bSJoe Perches					my $space_after = 0;
42572381097bSJoe Perches					if ($ctx =~ /Wx./) {
42582381097bSJoe Perches						if (ERROR("SPACING",
42592381097bSJoe Perches							  "space prohibited before that '$op' $at\n" . $hereptr)) {
42602381097bSJoe Perches							$line_fixed = 1;
42612381097bSJoe Perches							$rtrim_before = 1;
42622381097bSJoe Perches						}
42632381097bSJoe Perches					}
4264cf655043SAndy Whitcroft					if ($ctx !~ /.x[WEC]/ && $cc !~ /^}/) {
42653705ce5bSJoe Perches						if (ERROR("SPACING",
42663705ce5bSJoe Perches							  "space required after that '$op' $at\n" . $hereptr)) {
42673705ce5bSJoe Perches							$line_fixed = 1;
4268b34c648bSJoe Perches							$last_after = $n;
42692381097bSJoe Perches							$space_after = 1;
42702381097bSJoe Perches						}
42712381097bSJoe Perches					}
42722381097bSJoe Perches					if ($rtrim_before || $space_after) {
42732381097bSJoe Perches						if ($rtrim_before) {
42742381097bSJoe Perches							$good = rtrim($fix_elements[$n]) . trim($fix_elements[$n + 1]);
42752381097bSJoe Perches						} else {
42762381097bSJoe Perches							$good = $fix_elements[$n] . trim($fix_elements[$n + 1]);
42772381097bSJoe Perches						}
42782381097bSJoe Perches						if ($space_after) {
42792381097bSJoe Perches							$good .= " ";
42803705ce5bSJoe Perches						}
42810a920b5bSAndy Whitcroft					}
42820a920b5bSAndy Whitcroft
42839c0ca6f9SAndy Whitcroft				# '*' as part of a type definition -- reported already.
428474048ed8SAndy Whitcroft				} elsif ($opv eq '*_') {
42859c0ca6f9SAndy Whitcroft					#warn "'*' is part of type\n";
42869c0ca6f9SAndy Whitcroft
42879c0ca6f9SAndy Whitcroft				# unary operators should have a space before and
42889c0ca6f9SAndy Whitcroft				# none after.  May be left adjacent to another
42899c0ca6f9SAndy Whitcroft				# unary operator, or a cast
42909c0ca6f9SAndy Whitcroft				} elsif ($op eq '!' || $op eq '~' ||
429174048ed8SAndy Whitcroft					 $opv eq '*U' || $opv eq '-U' ||
42920d413866SAndy Whitcroft					 $opv eq '&U' || $opv eq '&&U') {
4293cf655043SAndy Whitcroft					if ($ctx !~ /[WEBC]x./ && $ca !~ /(?:\)|!|~|\*|-|\&|\||\+\+|\-\-|\{)$/) {
42943705ce5bSJoe Perches						if (ERROR("SPACING",
42953705ce5bSJoe Perches							  "space required before that '$op' $at\n" . $hereptr)) {
4296b34c648bSJoe Perches							if ($n != $last_after + 2) {
4297b34c648bSJoe Perches								$good = $fix_elements[$n] . " " . ltrim($fix_elements[$n + 1]);
42983705ce5bSJoe Perches								$line_fixed = 1;
42993705ce5bSJoe Perches							}
43000a920b5bSAndy Whitcroft						}
4301b34c648bSJoe Perches					}
4302a3340b35SAndy Whitcroft					if ($op eq '*' && $cc =~/\s*$Modifier\b/) {
4303171ae1a4SAndy Whitcroft						# A unary '*' may be const
4304171ae1a4SAndy Whitcroft
4305171ae1a4SAndy Whitcroft					} elsif ($ctx =~ /.xW/) {
43063705ce5bSJoe Perches						if (ERROR("SPACING",
43073705ce5bSJoe Perches							  "space prohibited after that '$op' $at\n" . $hereptr)) {
4308b34c648bSJoe Perches							$good = $fix_elements[$n] . rtrim($fix_elements[$n + 1]);
43093705ce5bSJoe Perches							if (defined $fix_elements[$n + 2]) {
43103705ce5bSJoe Perches								$fix_elements[$n + 2] =~ s/^\s+//;
43113705ce5bSJoe Perches							}
4312b34c648bSJoe Perches							$line_fixed = 1;
43133705ce5bSJoe Perches						}
43140a920b5bSAndy Whitcroft					}
43150a920b5bSAndy Whitcroft
43160a920b5bSAndy Whitcroft				# unary ++ and unary -- are allowed no space on one side.
43170a920b5bSAndy Whitcroft				} elsif ($op eq '++' or $op eq '--') {
4318773647a0SAndy Whitcroft					if ($ctx !~ /[WEOBC]x[^W]/ && $ctx !~ /[^W]x[WOBEC]/) {
43193705ce5bSJoe Perches						if (ERROR("SPACING",
43203705ce5bSJoe Perches							  "space required one side of that '$op' $at\n" . $hereptr)) {
4321b34c648bSJoe Perches							$good = $fix_elements[$n] . trim($fix_elements[$n + 1]) . " ";
43223705ce5bSJoe Perches							$line_fixed = 1;
43233705ce5bSJoe Perches						}
43240a920b5bSAndy Whitcroft					}
4325773647a0SAndy Whitcroft					if ($ctx =~ /Wx[BE]/ ||
4326773647a0SAndy Whitcroft					    ($ctx =~ /Wx./ && $cc =~ /^;/)) {
43273705ce5bSJoe Perches						if (ERROR("SPACING",
43283705ce5bSJoe Perches							  "space prohibited before that '$op' $at\n" . $hereptr)) {
4329b34c648bSJoe Perches							$good = rtrim($fix_elements[$n]) . trim($fix_elements[$n + 1]);
43303705ce5bSJoe Perches							$line_fixed = 1;
43313705ce5bSJoe Perches						}
4332653d4876SAndy Whitcroft					}
4333773647a0SAndy Whitcroft					if ($ctx =~ /ExW/) {
43343705ce5bSJoe Perches						if (ERROR("SPACING",
43353705ce5bSJoe Perches							  "space prohibited after that '$op' $at\n" . $hereptr)) {
4336b34c648bSJoe Perches							$good = $fix_elements[$n] . trim($fix_elements[$n + 1]);
43373705ce5bSJoe Perches							if (defined $fix_elements[$n + 2]) {
43383705ce5bSJoe Perches								$fix_elements[$n + 2] =~ s/^\s+//;
4339773647a0SAndy Whitcroft							}
4340b34c648bSJoe Perches							$line_fixed = 1;
43413705ce5bSJoe Perches						}
43423705ce5bSJoe Perches					}
43430a920b5bSAndy Whitcroft
43440a920b5bSAndy Whitcroft				# << and >> may either have or not have spaces both sides
43459c0ca6f9SAndy Whitcroft				} elsif ($op eq '<<' or $op eq '>>' or
43469c0ca6f9SAndy Whitcroft					 $op eq '&' or $op eq '^' or $op eq '|' or
43479c0ca6f9SAndy Whitcroft					 $op eq '+' or $op eq '-' or
4348c2fdda0dSAndy Whitcroft					 $op eq '*' or $op eq '/' or
4349c2fdda0dSAndy Whitcroft					 $op eq '%')
43500a920b5bSAndy Whitcroft				{
4351d2e025f3SJoe Perches					if ($check) {
4352d2e025f3SJoe Perches						if (defined $fix_elements[$n + 2] && $ctx !~ /[EW]x[EW]/) {
4353d2e025f3SJoe Perches							if (CHK("SPACING",
4354d2e025f3SJoe Perches								"spaces preferred around that '$op' $at\n" . $hereptr)) {
4355d2e025f3SJoe Perches								$good = rtrim($fix_elements[$n]) . " " . trim($fix_elements[$n + 1]) . " ";
4356d2e025f3SJoe Perches								$fix_elements[$n + 2] =~ s/^\s+//;
4357d2e025f3SJoe Perches								$line_fixed = 1;
4358d2e025f3SJoe Perches							}
4359d2e025f3SJoe Perches						} elsif (!defined $fix_elements[$n + 2] && $ctx !~ /Wx[OE]/) {
4360d2e025f3SJoe Perches							if (CHK("SPACING",
4361d2e025f3SJoe Perches								"space preferred before that '$op' $at\n" . $hereptr)) {
4362d2e025f3SJoe Perches								$good = rtrim($fix_elements[$n]) . " " . trim($fix_elements[$n + 1]);
4363d2e025f3SJoe Perches								$line_fixed = 1;
4364d2e025f3SJoe Perches							}
4365d2e025f3SJoe Perches						}
4366d2e025f3SJoe Perches					} elsif ($ctx =~ /Wx[^WCE]|[^WCE]xW/) {
43673705ce5bSJoe Perches						if (ERROR("SPACING",
43683705ce5bSJoe Perches							  "need consistent spacing around '$op' $at\n" . $hereptr)) {
4369b34c648bSJoe Perches							$good = rtrim($fix_elements[$n]) . " " . trim($fix_elements[$n + 1]) . " ";
4370b34c648bSJoe Perches							if (defined $fix_elements[$n + 2]) {
4371b34c648bSJoe Perches								$fix_elements[$n + 2] =~ s/^\s+//;
4372b34c648bSJoe Perches							}
43733705ce5bSJoe Perches							$line_fixed = 1;
43743705ce5bSJoe Perches						}
43750a920b5bSAndy Whitcroft					}
43760a920b5bSAndy Whitcroft
43771f65f947SAndy Whitcroft				# A colon needs no spaces before when it is
43781f65f947SAndy Whitcroft				# terminating a case value or a label.
43791f65f947SAndy Whitcroft				} elsif ($opv eq ':C' || $opv eq ':L') {
43801f65f947SAndy Whitcroft					if ($ctx =~ /Wx./) {
43813705ce5bSJoe Perches						if (ERROR("SPACING",
43823705ce5bSJoe Perches							  "space prohibited before that '$op' $at\n" . $hereptr)) {
4383b34c648bSJoe Perches							$good = rtrim($fix_elements[$n]) . trim($fix_elements[$n + 1]);
43843705ce5bSJoe Perches							$line_fixed = 1;
43853705ce5bSJoe Perches						}
43861f65f947SAndy Whitcroft					}
43871f65f947SAndy Whitcroft
43880a920b5bSAndy Whitcroft				# All the others need spaces both sides.
4389cf655043SAndy Whitcroft				} elsif ($ctx !~ /[EWC]x[CWE]/) {
43901f65f947SAndy Whitcroft					my $ok = 0;
43911f65f947SAndy Whitcroft
439222f2a2efSAndy Whitcroft					# Ignore email addresses <foo@bar>
43931f65f947SAndy Whitcroft					if (($op eq '<' &&
43941f65f947SAndy Whitcroft					     $cc =~ /^\S+\@\S+>/) ||
43951f65f947SAndy Whitcroft					    ($op eq '>' &&
43961f65f947SAndy Whitcroft					     $ca =~ /<\S+\@\S+$/))
43971f65f947SAndy Whitcroft					{
43981f65f947SAndy Whitcroft					    	$ok = 1;
43991f65f947SAndy Whitcroft					}
44001f65f947SAndy Whitcroft
4401e0df7e1fSJoe Perches					# for asm volatile statements
4402e0df7e1fSJoe Perches					# ignore a colon with another
4403e0df7e1fSJoe Perches					# colon immediately before or after
4404e0df7e1fSJoe Perches					if (($op eq ':') &&
4405e0df7e1fSJoe Perches					    ($ca =~ /:$/ || $cc =~ /^:/)) {
4406e0df7e1fSJoe Perches						$ok = 1;
4407e0df7e1fSJoe Perches					}
4408e0df7e1fSJoe Perches
440984731623SJoe Perches					# messages are ERROR, but ?: are CHK
44101f65f947SAndy Whitcroft					if ($ok == 0) {
44110675a8fbSJean Delvare						my $msg_level = \&ERROR;
44120675a8fbSJean Delvare						$msg_level = \&CHK if (($op eq '?:' || $op eq '?' || $op eq ':') && $ctx =~ /VxV/);
441384731623SJoe Perches
44140675a8fbSJean Delvare						if (&{$msg_level}("SPACING",
44153705ce5bSJoe Perches								  "spaces required around that '$op' $at\n" . $hereptr)) {
4416b34c648bSJoe Perches							$good = rtrim($fix_elements[$n]) . " " . trim($fix_elements[$n + 1]) . " ";
4417b34c648bSJoe Perches							if (defined $fix_elements[$n + 2]) {
4418b34c648bSJoe Perches								$fix_elements[$n + 2] =~ s/^\s+//;
4419b34c648bSJoe Perches							}
44203705ce5bSJoe Perches							$line_fixed = 1;
44213705ce5bSJoe Perches						}
44220a920b5bSAndy Whitcroft					}
442322f2a2efSAndy Whitcroft				}
44244a0df2efSAndy Whitcroft				$off += length($elements[$n + 1]);
44253705ce5bSJoe Perches
44263705ce5bSJoe Perches##				print("n: <$n> GOOD: <$good>\n");
44273705ce5bSJoe Perches
44283705ce5bSJoe Perches				$fixed_line = $fixed_line . $good;
44290a920b5bSAndy Whitcroft			}
44303705ce5bSJoe Perches
44313705ce5bSJoe Perches			if (($#elements % 2) == 0) {
44323705ce5bSJoe Perches				$fixed_line = $fixed_line . $fix_elements[$#elements];
44333705ce5bSJoe Perches			}
44343705ce5bSJoe Perches
4435194f66fcSJoe Perches			if ($fix && $line_fixed && $fixed_line ne $fixed[$fixlinenr]) {
4436194f66fcSJoe Perches				$fixed[$fixlinenr] = $fixed_line;
44373705ce5bSJoe Perches			}
44383705ce5bSJoe Perches
44393705ce5bSJoe Perches
44400a920b5bSAndy Whitcroft		}
44410a920b5bSAndy Whitcroft
4442786b6326SJoe Perches# check for whitespace before a non-naked semicolon
4443d2e248e7SJoe Perches		if ($line =~ /^\+.*\S\s+;\s*$/) {
4444786b6326SJoe Perches			if (WARN("SPACING",
4445786b6326SJoe Perches				 "space prohibited before semicolon\n" . $herecurr) &&
4446786b6326SJoe Perches			    $fix) {
4447194f66fcSJoe Perches				1 while $fixed[$fixlinenr] =~
4448786b6326SJoe Perches				    s/^(\+.*\S)\s+;/$1;/;
4449786b6326SJoe Perches			}
4450786b6326SJoe Perches		}
4451786b6326SJoe Perches
4452f0a594c1SAndy Whitcroft# check for multiple assignments
4453f0a594c1SAndy Whitcroft		if ($line =~ /^.\s*$Lval\s*=\s*$Lval\s*=(?!=)/) {
4454000d1cc1SJoe Perches			CHK("MULTIPLE_ASSIGNMENTS",
4455000d1cc1SJoe Perches			    "multiple assignments should be avoided\n" . $herecurr);
4456f0a594c1SAndy Whitcroft		}
4457f0a594c1SAndy Whitcroft
445822f2a2efSAndy Whitcroft## # check for multiple declarations, allowing for a function declaration
445922f2a2efSAndy Whitcroft## # continuation.
446022f2a2efSAndy Whitcroft## 		if ($line =~ /^.\s*$Type\s+$Ident(?:\s*=[^,{]*)?\s*,\s*$Ident.*/ &&
446122f2a2efSAndy Whitcroft## 		    $line !~ /^.\s*$Type\s+$Ident(?:\s*=[^,{]*)?\s*,\s*$Type\s*$Ident.*/) {
446222f2a2efSAndy Whitcroft##
446322f2a2efSAndy Whitcroft## 			# Remove any bracketed sections to ensure we do not
446422f2a2efSAndy Whitcroft## 			# falsly report the parameters of functions.
446522f2a2efSAndy Whitcroft## 			my $ln = $line;
446622f2a2efSAndy Whitcroft## 			while ($ln =~ s/\([^\(\)]*\)//g) {
446722f2a2efSAndy Whitcroft## 			}
446822f2a2efSAndy Whitcroft## 			if ($ln =~ /,/) {
4469000d1cc1SJoe Perches## 				WARN("MULTIPLE_DECLARATION",
4470000d1cc1SJoe Perches##				     "declaring multiple variables together should be avoided\n" . $herecurr);
447122f2a2efSAndy Whitcroft## 			}
447222f2a2efSAndy Whitcroft## 		}
4473f0a594c1SAndy Whitcroft
44740a920b5bSAndy Whitcroft#need space before brace following if, while, etc
44756b8c69e4SGeyslan G. Bem		if (($line =~ /\(.*\)\{/ && $line !~ /\($Type\)\{/) ||
44764e5d56bdSEddie Kovsky		    $line =~ /do\{/) {
44773705ce5bSJoe Perches			if (ERROR("SPACING",
44783705ce5bSJoe Perches				  "space required before the open brace '{'\n" . $herecurr) &&
44793705ce5bSJoe Perches			    $fix) {
44808d81ae05SCyril Bur				$fixed[$fixlinenr] =~ s/^(\+.*(?:do|\)))\{/$1 {/;
44813705ce5bSJoe Perches			}
4482de7d4f0eSAndy Whitcroft		}
4483de7d4f0eSAndy Whitcroft
4484c4a62ef9SJoe Perches## # check for blank lines before declarations
4485c4a62ef9SJoe Perches##		if ($line =~ /^.\t+$Type\s+$Ident(?:\s*=.*)?;/ &&
4486c4a62ef9SJoe Perches##		    $prevrawline =~ /^.\s*$/) {
4487c4a62ef9SJoe Perches##			WARN("SPACING",
4488c4a62ef9SJoe Perches##			     "No blank lines before declarations\n" . $hereprev);
4489c4a62ef9SJoe Perches##		}
4490c4a62ef9SJoe Perches##
4491c4a62ef9SJoe Perches
4492de7d4f0eSAndy Whitcroft# closing brace should have a space following it when it has anything
4493de7d4f0eSAndy Whitcroft# on the line
4494de7d4f0eSAndy Whitcroft		if ($line =~ /}(?!(?:,|;|\)))\S/) {
4495d5e616fcSJoe Perches			if (ERROR("SPACING",
4496d5e616fcSJoe Perches				  "space required after that close brace '}'\n" . $herecurr) &&
4497d5e616fcSJoe Perches			    $fix) {
4498194f66fcSJoe Perches				$fixed[$fixlinenr] =~
4499d5e616fcSJoe Perches				    s/}((?!(?:,|;|\)))\S)/} $1/;
4500d5e616fcSJoe Perches			}
45010a920b5bSAndy Whitcroft		}
45020a920b5bSAndy Whitcroft
450322f2a2efSAndy Whitcroft# check spacing on square brackets
450422f2a2efSAndy Whitcroft		if ($line =~ /\[\s/ && $line !~ /\[\s*$/) {
45053705ce5bSJoe Perches			if (ERROR("SPACING",
45063705ce5bSJoe Perches				  "space prohibited after that open square bracket '['\n" . $herecurr) &&
45073705ce5bSJoe Perches			    $fix) {
4508194f66fcSJoe Perches				$fixed[$fixlinenr] =~
45093705ce5bSJoe Perches				    s/\[\s+/\[/;
45103705ce5bSJoe Perches			}
451122f2a2efSAndy Whitcroft		}
451222f2a2efSAndy Whitcroft		if ($line =~ /\s\]/) {
45133705ce5bSJoe Perches			if (ERROR("SPACING",
45143705ce5bSJoe Perches				  "space prohibited before that close square bracket ']'\n" . $herecurr) &&
45153705ce5bSJoe Perches			    $fix) {
4516194f66fcSJoe Perches				$fixed[$fixlinenr] =~
45173705ce5bSJoe Perches				    s/\s+\]/\]/;
45183705ce5bSJoe Perches			}
451922f2a2efSAndy Whitcroft		}
452022f2a2efSAndy Whitcroft
4521c45dcabdSAndy Whitcroft# check spacing on parentheses
45229c0ca6f9SAndy Whitcroft		if ($line =~ /\(\s/ && $line !~ /\(\s*(?:\\)?$/ &&
45239c0ca6f9SAndy Whitcroft		    $line !~ /for\s*\(\s+;/) {
45243705ce5bSJoe Perches			if (ERROR("SPACING",
45253705ce5bSJoe Perches				  "space prohibited after that open parenthesis '('\n" . $herecurr) &&
45263705ce5bSJoe Perches			    $fix) {
4527194f66fcSJoe Perches				$fixed[$fixlinenr] =~
45283705ce5bSJoe Perches				    s/\(\s+/\(/;
45293705ce5bSJoe Perches			}
453022f2a2efSAndy Whitcroft		}
453113214adfSAndy Whitcroft		if ($line =~ /(\s+)\)/ && $line !~ /^.\s*\)/ &&
4532c45dcabdSAndy Whitcroft		    $line !~ /for\s*\(.*;\s+\)/ &&
4533c45dcabdSAndy Whitcroft		    $line !~ /:\s+\)/) {
45343705ce5bSJoe Perches			if (ERROR("SPACING",
45353705ce5bSJoe Perches				  "space prohibited before that close parenthesis ')'\n" . $herecurr) &&
45363705ce5bSJoe Perches			    $fix) {
4537194f66fcSJoe Perches				$fixed[$fixlinenr] =~
45383705ce5bSJoe Perches				    s/\s+\)/\)/;
45393705ce5bSJoe Perches			}
454022f2a2efSAndy Whitcroft		}
454122f2a2efSAndy Whitcroft
4542e2826fd0SJoe Perches# check unnecessary parentheses around addressof/dereference single $Lvals
4543e2826fd0SJoe Perches# ie: &(foo->bar) should be &foo->bar and *(foo->bar) should be *foo->bar
4544e2826fd0SJoe Perches
4545e2826fd0SJoe Perches		while ($line =~ /(?:[^&]&\s*|\*)\(\s*($Ident\s*(?:$Member\s*)+)\s*\)/g) {
4546ea4acbb1SJoe Perches			my $var = $1;
4547ea4acbb1SJoe Perches			if (CHK("UNNECESSARY_PARENTHESES",
4548ea4acbb1SJoe Perches				"Unnecessary parentheses around $var\n" . $herecurr) &&
4549ea4acbb1SJoe Perches			    $fix) {
4550ea4acbb1SJoe Perches				$fixed[$fixlinenr] =~ s/\(\s*\Q$var\E\s*\)/$var/;
4551ea4acbb1SJoe Perches			}
4552ea4acbb1SJoe Perches		}
4553ea4acbb1SJoe Perches
4554ea4acbb1SJoe Perches# check for unnecessary parentheses around function pointer uses
4555ea4acbb1SJoe Perches# ie: (foo->bar)(); should be foo->bar();
4556ea4acbb1SJoe Perches# but not "if (foo->bar) (" to avoid some false positives
4557ea4acbb1SJoe Perches		if ($line =~ /(\bif\s*|)(\(\s*$Ident\s*(?:$Member\s*)+\))[ \t]*\(/ && $1 !~ /^if/) {
4558ea4acbb1SJoe Perches			my $var = $2;
4559ea4acbb1SJoe Perches			if (CHK("UNNECESSARY_PARENTHESES",
4560ea4acbb1SJoe Perches				"Unnecessary parentheses around function pointer $var\n" . $herecurr) &&
4561ea4acbb1SJoe Perches			    $fix) {
4562ea4acbb1SJoe Perches				my $var2 = deparenthesize($var);
4563ea4acbb1SJoe Perches				$var2 =~ s/\s//g;
4564ea4acbb1SJoe Perches				$fixed[$fixlinenr] =~ s/\Q$var\E/$var2/;
4565ea4acbb1SJoe Perches			}
4566e2826fd0SJoe Perches		}
4567e2826fd0SJoe Perches
456863b7c73eSJoe Perches# check for unnecessary parentheses around comparisons in if uses
4569a032aa4cSJoe Perches# when !drivers/staging or command-line uses --strict
4570a032aa4cSJoe Perches		if (($realfile !~ m@^(?:drivers/staging/)@ || $check_orig) &&
4571a032aa4cSJoe Perches		    $^V && $^V ge 5.10.0 && defined($stat) &&
457263b7c73eSJoe Perches		    $stat =~ /(^.\s*if\s*($balanced_parens))/) {
457363b7c73eSJoe Perches			my $if_stat = $1;
457463b7c73eSJoe Perches			my $test = substr($2, 1, -1);
457563b7c73eSJoe Perches			my $herectx;
457663b7c73eSJoe Perches			while ($test =~ /(?:^|[^\w\&\!\~])+\s*\(\s*([\&\!\~]?\s*$Lval\s*(?:$Compare\s*$FuncArg)?)\s*\)/g) {
457763b7c73eSJoe Perches				my $match = $1;
457863b7c73eSJoe Perches				# avoid parentheses around potential macro args
457963b7c73eSJoe Perches				next if ($match =~ /^\s*\w+\s*$/);
458063b7c73eSJoe Perches				if (!defined($herectx)) {
458163b7c73eSJoe Perches					$herectx = $here . "\n";
458263b7c73eSJoe Perches					my $cnt = statement_rawlines($if_stat);
458363b7c73eSJoe Perches					for (my $n = 0; $n < $cnt; $n++) {
458463b7c73eSJoe Perches						my $rl = raw_line($linenr, $n);
458563b7c73eSJoe Perches						$herectx .=  $rl . "\n";
458663b7c73eSJoe Perches						last if $rl =~ /^[ \+].*\{/;
458763b7c73eSJoe Perches					}
458863b7c73eSJoe Perches				}
458963b7c73eSJoe Perches				CHK("UNNECESSARY_PARENTHESES",
459063b7c73eSJoe Perches				    "Unnecessary parentheses around '$match'\n" . $herectx);
459163b7c73eSJoe Perches			}
459263b7c73eSJoe Perches		}
459363b7c73eSJoe Perches
45940a920b5bSAndy Whitcroft#goto labels aren't indented, allow a single space however
45954a0df2efSAndy Whitcroft		if ($line=~/^.\s+[A-Za-z\d_]+:(?![0-9]+)/ and
45960a920b5bSAndy Whitcroft		   !($line=~/^. [A-Za-z\d_]+:/) and !($line=~/^.\s+default:/)) {
45973705ce5bSJoe Perches			if (WARN("INDENTED_LABEL",
45983705ce5bSJoe Perches				 "labels should not be indented\n" . $herecurr) &&
45993705ce5bSJoe Perches			    $fix) {
4600194f66fcSJoe Perches				$fixed[$fixlinenr] =~
46013705ce5bSJoe Perches				    s/^(.)\s+/$1/;
46023705ce5bSJoe Perches			}
46030a920b5bSAndy Whitcroft		}
46040a920b5bSAndy Whitcroft
46055b9553abSJoe Perches# return is not a function
4606507e5141SJoe Perches		if (defined($stat) && $stat =~ /^.\s*return(\s*)\(/s) {
4607c45dcabdSAndy Whitcroft			my $spacing = $1;
4608507e5141SJoe Perches			if ($^V && $^V ge 5.10.0 &&
46095b9553abSJoe Perches			    $stat =~ /^.\s*return\s*($balanced_parens)\s*;\s*$/) {
46105b9553abSJoe Perches				my $value = $1;
46115b9553abSJoe Perches				$value = deparenthesize($value);
46125b9553abSJoe Perches				if ($value =~ m/^\s*$FuncArg\s*(?:\?|$)/) {
4613000d1cc1SJoe Perches					ERROR("RETURN_PARENTHESES",
4614000d1cc1SJoe Perches					      "return is not a function, parentheses are not required\n" . $herecurr);
46155b9553abSJoe Perches				}
4616c45dcabdSAndy Whitcroft			} elsif ($spacing !~ /\s+/) {
4617000d1cc1SJoe Perches				ERROR("SPACING",
4618000d1cc1SJoe Perches				      "space required before the open parenthesis '('\n" . $herecurr);
4619c45dcabdSAndy Whitcroft			}
4620c45dcabdSAndy Whitcroft		}
4621507e5141SJoe Perches
4622b43ae21bSJoe Perches# unnecessary return in a void function
4623b43ae21bSJoe Perches# at end-of-function, with the previous line a single leading tab, then return;
4624b43ae21bSJoe Perches# and the line before that not a goto label target like "out:"
4625b43ae21bSJoe Perches		if ($sline =~ /^[ \+]}\s*$/ &&
4626b43ae21bSJoe Perches		    $prevline =~ /^\+\treturn\s*;\s*$/ &&
4627b43ae21bSJoe Perches		    $linenr >= 3 &&
4628b43ae21bSJoe Perches		    $lines[$linenr - 3] =~ /^[ +]/ &&
4629b43ae21bSJoe Perches		    $lines[$linenr - 3] !~ /^[ +]\s*$Ident\s*:/) {
46309819cf25SJoe Perches			WARN("RETURN_VOID",
4631b43ae21bSJoe Perches			     "void function return statements are not generally useful\n" . $hereprev);
46329819cf25SJoe Perches               }
46339819cf25SJoe Perches
4634189248d8SJoe Perches# if statements using unnecessary parentheses - ie: if ((foo == bar))
4635189248d8SJoe Perches		if ($^V && $^V ge 5.10.0 &&
4636189248d8SJoe Perches		    $line =~ /\bif\s*((?:\(\s*){2,})/) {
4637189248d8SJoe Perches			my $openparens = $1;
4638189248d8SJoe Perches			my $count = $openparens =~ tr@\(@\(@;
4639189248d8SJoe Perches			my $msg = "";
4640189248d8SJoe Perches			if ($line =~ /\bif\s*(?:\(\s*){$count,$count}$LvalOrFunc\s*($Compare)\s*$LvalOrFunc(?:\s*\)){$count,$count}/) {
4641189248d8SJoe Perches				my $comp = $4;	#Not $1 because of $LvalOrFunc
4642189248d8SJoe Perches				$msg = " - maybe == should be = ?" if ($comp eq "==");
4643189248d8SJoe Perches				WARN("UNNECESSARY_PARENTHESES",
4644189248d8SJoe Perches				     "Unnecessary parentheses$msg\n" . $herecurr);
4645189248d8SJoe Perches			}
4646189248d8SJoe Perches		}
4647189248d8SJoe Perches
4648c5595fa2SJoe Perches# comparisons with a constant or upper case identifier on the left
4649c5595fa2SJoe Perches#	avoid cases like "foo + BAR < baz"
4650c5595fa2SJoe Perches#	only fix matches surrounded by parentheses to avoid incorrect
4651c5595fa2SJoe Perches#	conversions like "FOO < baz() + 5" being "misfixed" to "baz() > FOO + 5"
4652c5595fa2SJoe Perches		if ($^V && $^V ge 5.10.0 &&
4653c5595fa2SJoe Perches		    $line =~ /^\+(.*)\b($Constant|[A-Z_][A-Z0-9_]*)\s*($Compare)\s*($LvalOrFunc)/) {
4654c5595fa2SJoe Perches			my $lead = $1;
4655c5595fa2SJoe Perches			my $const = $2;
4656c5595fa2SJoe Perches			my $comp = $3;
4657c5595fa2SJoe Perches			my $to = $4;
4658c5595fa2SJoe Perches			my $newcomp = $comp;
4659f39e1769SJoe Perches			if ($lead !~ /(?:$Operators|\.)\s*$/ &&
4660c5595fa2SJoe Perches			    $to !~ /^(?:Constant|[A-Z_][A-Z0-9_]*)$/ &&
4661c5595fa2SJoe Perches			    WARN("CONSTANT_COMPARISON",
4662c5595fa2SJoe Perches				 "Comparisons should place the constant on the right side of the test\n" . $herecurr) &&
4663c5595fa2SJoe Perches			    $fix) {
4664c5595fa2SJoe Perches				if ($comp eq "<") {
4665c5595fa2SJoe Perches					$newcomp = ">";
4666c5595fa2SJoe Perches				} elsif ($comp eq "<=") {
4667c5595fa2SJoe Perches					$newcomp = ">=";
4668c5595fa2SJoe Perches				} elsif ($comp eq ">") {
4669c5595fa2SJoe Perches					$newcomp = "<";
4670c5595fa2SJoe Perches				} elsif ($comp eq ">=") {
4671c5595fa2SJoe Perches					$newcomp = "<=";
4672c5595fa2SJoe Perches				}
4673c5595fa2SJoe Perches				$fixed[$fixlinenr] =~ s/\(\s*\Q$const\E\s*$Compare\s*\Q$to\E\s*\)/($to $newcomp $const)/;
4674c5595fa2SJoe Perches			}
4675c5595fa2SJoe Perches		}
4676c5595fa2SJoe Perches
4677f34e4a4fSJoe Perches# Return of what appears to be an errno should normally be negative
4678f34e4a4fSJoe Perches		if ($sline =~ /\breturn(?:\s*\(+\s*|\s+)(E[A-Z]+)(?:\s*\)+\s*|\s*)[;:,]/) {
467953a3c448SAndy Whitcroft			my $name = $1;
468053a3c448SAndy Whitcroft			if ($name ne 'EOF' && $name ne 'ERROR') {
4681000d1cc1SJoe Perches				WARN("USE_NEGATIVE_ERRNO",
4682f34e4a4fSJoe Perches				     "return of an errno should typically be negative (ie: return -$1)\n" . $herecurr);
468353a3c448SAndy Whitcroft			}
468453a3c448SAndy Whitcroft		}
4685c45dcabdSAndy Whitcroft
46860a920b5bSAndy Whitcroft# Need a space before open parenthesis after if, while etc
46874a0df2efSAndy Whitcroft		if ($line =~ /\b(if|while|for|switch)\(/) {
46883705ce5bSJoe Perches			if (ERROR("SPACING",
46893705ce5bSJoe Perches				  "space required before the open parenthesis '('\n" . $herecurr) &&
46903705ce5bSJoe Perches			    $fix) {
4691194f66fcSJoe Perches				$fixed[$fixlinenr] =~
46923705ce5bSJoe Perches				    s/\b(if|while|for|switch)\(/$1 \(/;
46933705ce5bSJoe Perches			}
46940a920b5bSAndy Whitcroft		}
46950a920b5bSAndy Whitcroft
4696f5fe35ddSAndy Whitcroft# Check for illegal assignment in if conditional -- and check for trailing
4697f5fe35ddSAndy Whitcroft# statements after the conditional.
4698170d3a22SAndy Whitcroft		if ($line =~ /do\s*(?!{)/) {
46993e469cdcSAndy Whitcroft			($stat, $cond, $line_nr_next, $remain_next, $off_next) =
47003e469cdcSAndy Whitcroft				ctx_statement_block($linenr, $realcnt, 0)
47013e469cdcSAndy Whitcroft					if (!defined $stat);
4702170d3a22SAndy Whitcroft			my ($stat_next) = ctx_statement_block($line_nr_next,
4703170d3a22SAndy Whitcroft						$remain_next, $off_next);
4704170d3a22SAndy Whitcroft			$stat_next =~ s/\n./\n /g;
4705170d3a22SAndy Whitcroft			##print "stat<$stat> stat_next<$stat_next>\n";
4706170d3a22SAndy Whitcroft
4707170d3a22SAndy Whitcroft			if ($stat_next =~ /^\s*while\b/) {
4708170d3a22SAndy Whitcroft				# If the statement carries leading newlines,
4709170d3a22SAndy Whitcroft				# then count those as offsets.
4710170d3a22SAndy Whitcroft				my ($whitespace) =
4711170d3a22SAndy Whitcroft					($stat_next =~ /^((?:\s*\n[+-])*\s*)/s);
4712170d3a22SAndy Whitcroft				my $offset =
4713170d3a22SAndy Whitcroft					statement_rawlines($whitespace) - 1;
4714170d3a22SAndy Whitcroft
4715170d3a22SAndy Whitcroft				$suppress_whiletrailers{$line_nr_next +
4716170d3a22SAndy Whitcroft								$offset} = 1;
4717170d3a22SAndy Whitcroft			}
4718170d3a22SAndy Whitcroft		}
4719170d3a22SAndy Whitcroft		if (!defined $suppress_whiletrailers{$linenr} &&
4720c11230f4SJoe Perches		    defined($stat) && defined($cond) &&
4721170d3a22SAndy Whitcroft		    $line =~ /\b(?:if|while|for)\s*\(/ && $line !~ /^.\s*#/) {
4722171ae1a4SAndy Whitcroft			my ($s, $c) = ($stat, $cond);
47238905a67cSAndy Whitcroft
4724b53c8e10SAndy Whitcroft			if ($c =~ /\bif\s*\(.*[^<>!=]=[^=].*/s) {
4725000d1cc1SJoe Perches				ERROR("ASSIGN_IN_IF",
4726000d1cc1SJoe Perches				      "do not use assignment in if condition\n" . $herecurr);
47278905a67cSAndy Whitcroft			}
47288905a67cSAndy Whitcroft
47298905a67cSAndy Whitcroft			# Find out what is on the end of the line after the
47308905a67cSAndy Whitcroft			# conditional.
4731773647a0SAndy Whitcroft			substr($s, 0, length($c), '');
47328905a67cSAndy Whitcroft			$s =~ s/\n.*//g;
473313214adfSAndy Whitcroft			$s =~ s/$;//g; 	# Remove any comments
473453210168SAndy Whitcroft			if (length($c) && $s !~ /^\s*{?\s*\\*\s*$/ &&
473553210168SAndy Whitcroft			    $c !~ /}\s*while\s*/)
4736773647a0SAndy Whitcroft			{
4737bb44ad39SAndy Whitcroft				# Find out how long the conditional actually is.
4738bb44ad39SAndy Whitcroft				my @newlines = ($c =~ /\n/gs);
4739bb44ad39SAndy Whitcroft				my $cond_lines = 1 + $#newlines;
474042bdf74cSHidetoshi Seto				my $stat_real = '';
4741bb44ad39SAndy Whitcroft
474242bdf74cSHidetoshi Seto				$stat_real = raw_line($linenr, $cond_lines)
474342bdf74cSHidetoshi Seto							. "\n" if ($cond_lines);
4744bb44ad39SAndy Whitcroft				if (defined($stat_real) && $cond_lines > 1) {
4745bb44ad39SAndy Whitcroft					$stat_real = "[...]\n$stat_real";
4746bb44ad39SAndy Whitcroft				}
4747bb44ad39SAndy Whitcroft
4748000d1cc1SJoe Perches				ERROR("TRAILING_STATEMENTS",
4749000d1cc1SJoe Perches				      "trailing statements should be on next line\n" . $herecurr . $stat_real);
47508905a67cSAndy Whitcroft			}
47518905a67cSAndy Whitcroft		}
47528905a67cSAndy Whitcroft
475313214adfSAndy Whitcroft# Check for bitwise tests written as boolean
475413214adfSAndy Whitcroft		if ($line =~ /
475513214adfSAndy Whitcroft			(?:
475613214adfSAndy Whitcroft				(?:\[|\(|\&\&|\|\|)
475713214adfSAndy Whitcroft				\s*0[xX][0-9]+\s*
475813214adfSAndy Whitcroft				(?:\&\&|\|\|)
475913214adfSAndy Whitcroft			|
476013214adfSAndy Whitcroft				(?:\&\&|\|\|)
476113214adfSAndy Whitcroft				\s*0[xX][0-9]+\s*
476213214adfSAndy Whitcroft				(?:\&\&|\|\||\)|\])
476313214adfSAndy Whitcroft			)/x)
476413214adfSAndy Whitcroft		{
4765000d1cc1SJoe Perches			WARN("HEXADECIMAL_BOOLEAN_TEST",
4766000d1cc1SJoe Perches			     "boolean test with hexadecimal, perhaps just 1 \& or \|?\n" . $herecurr);
476713214adfSAndy Whitcroft		}
476813214adfSAndy Whitcroft
47698905a67cSAndy Whitcroft# if and else should not have general statements after it
477013214adfSAndy Whitcroft		if ($line =~ /^.\s*(?:}\s*)?else\b(.*)/) {
477113214adfSAndy Whitcroft			my $s = $1;
477213214adfSAndy Whitcroft			$s =~ s/$;//g; 	# Remove any comments
477313214adfSAndy Whitcroft			if ($s !~ /^\s*(?:\sif|(?:{|)\s*\\?\s*$)/) {
4774000d1cc1SJoe Perches				ERROR("TRAILING_STATEMENTS",
4775000d1cc1SJoe Perches				      "trailing statements should be on next line\n" . $herecurr);
47760a920b5bSAndy Whitcroft			}
477713214adfSAndy Whitcroft		}
477839667782SAndy Whitcroft# if should not continue a brace
477939667782SAndy Whitcroft		if ($line =~ /}\s*if\b/) {
4780000d1cc1SJoe Perches			ERROR("TRAILING_STATEMENTS",
4781048b123fSRasmus Villemoes			      "trailing statements should be on next line (or did you mean 'else if'?)\n" .
478239667782SAndy Whitcroft				$herecurr);
478339667782SAndy Whitcroft		}
4784a1080bf8SAndy Whitcroft# case and default should not have general statements after them
4785a1080bf8SAndy Whitcroft		if ($line =~ /^.\s*(?:case\s*.*|default\s*):/g &&
4786a1080bf8SAndy Whitcroft		    $line !~ /\G(?:
47873fef12d6SAndy Whitcroft			(?:\s*$;*)(?:\s*{)?(?:\s*$;*)(?:\s*\\)?\s*$|
4788a1080bf8SAndy Whitcroft			\s*return\s+
4789a1080bf8SAndy Whitcroft		    )/xg)
4790a1080bf8SAndy Whitcroft		{
4791000d1cc1SJoe Perches			ERROR("TRAILING_STATEMENTS",
4792000d1cc1SJoe Perches			      "trailing statements should be on next line\n" . $herecurr);
4793a1080bf8SAndy Whitcroft		}
47940a920b5bSAndy Whitcroft
47950a920b5bSAndy Whitcroft		# Check for }<nl>else {, these must be at the same
47960a920b5bSAndy Whitcroft		# indent level to be relevant to each other.
47978b8856f4SJoe Perches		if ($prevline=~/}\s*$/ and $line=~/^.\s*else\s*/ &&
47980a920b5bSAndy Whitcroft		    $previndent == $indent) {
47998b8856f4SJoe Perches			if (ERROR("ELSE_AFTER_BRACE",
48008b8856f4SJoe Perches				  "else should follow close brace '}'\n" . $hereprev) &&
48018b8856f4SJoe Perches			    $fix && $prevline =~ /^\+/ && $line =~ /^\+/) {
48028b8856f4SJoe Perches				fix_delete_line($fixlinenr - 1, $prevrawline);
48038b8856f4SJoe Perches				fix_delete_line($fixlinenr, $rawline);
48048b8856f4SJoe Perches				my $fixedline = $prevrawline;
48058b8856f4SJoe Perches				$fixedline =~ s/}\s*$//;
48068b8856f4SJoe Perches				if ($fixedline !~ /^\+\s*$/) {
48078b8856f4SJoe Perches					fix_insert_line($fixlinenr, $fixedline);
48088b8856f4SJoe Perches				}
48098b8856f4SJoe Perches				$fixedline = $rawline;
48108b8856f4SJoe Perches				$fixedline =~ s/^(.\s*)else/$1} else/;
48118b8856f4SJoe Perches				fix_insert_line($fixlinenr, $fixedline);
48128b8856f4SJoe Perches			}
48130a920b5bSAndy Whitcroft		}
48140a920b5bSAndy Whitcroft
48158b8856f4SJoe Perches		if ($prevline=~/}\s*$/ and $line=~/^.\s*while\s*/ &&
4816c2fdda0dSAndy Whitcroft		    $previndent == $indent) {
4817c2fdda0dSAndy Whitcroft			my ($s, $c) = ctx_statement_block($linenr, $realcnt, 0);
4818c2fdda0dSAndy Whitcroft
4819c2fdda0dSAndy Whitcroft			# Find out what is on the end of the line after the
4820c2fdda0dSAndy Whitcroft			# conditional.
4821773647a0SAndy Whitcroft			substr($s, 0, length($c), '');
4822c2fdda0dSAndy Whitcroft			$s =~ s/\n.*//g;
4823c2fdda0dSAndy Whitcroft
4824c2fdda0dSAndy Whitcroft			if ($s =~ /^\s*;/) {
48258b8856f4SJoe Perches				if (ERROR("WHILE_AFTER_BRACE",
48268b8856f4SJoe Perches					  "while should follow close brace '}'\n" . $hereprev) &&
48278b8856f4SJoe Perches				    $fix && $prevline =~ /^\+/ && $line =~ /^\+/) {
48288b8856f4SJoe Perches					fix_delete_line($fixlinenr - 1, $prevrawline);
48298b8856f4SJoe Perches					fix_delete_line($fixlinenr, $rawline);
48308b8856f4SJoe Perches					my $fixedline = $prevrawline;
48318b8856f4SJoe Perches					my $trailing = $rawline;
48328b8856f4SJoe Perches					$trailing =~ s/^\+//;
48338b8856f4SJoe Perches					$trailing = trim($trailing);
48348b8856f4SJoe Perches					$fixedline =~ s/}\s*$/} $trailing/;
48358b8856f4SJoe Perches					fix_insert_line($fixlinenr, $fixedline);
48368b8856f4SJoe Perches				}
4837c2fdda0dSAndy Whitcroft			}
4838c2fdda0dSAndy Whitcroft		}
4839c2fdda0dSAndy Whitcroft
484095e2c602SJoe Perches#Specific variable tests
4841323c1260SJoe Perches		while ($line =~ m{($Constant|$Lval)}g) {
4842323c1260SJoe Perches			my $var = $1;
484395e2c602SJoe Perches
484495e2c602SJoe Perches#gcc binary extension
484595e2c602SJoe Perches			if ($var =~ /^$Binary$/) {
4846d5e616fcSJoe Perches				if (WARN("GCC_BINARY_CONSTANT",
4847d5e616fcSJoe Perches					 "Avoid gcc v4.3+ binary constant extension: <$var>\n" . $herecurr) &&
4848d5e616fcSJoe Perches				    $fix) {
4849d5e616fcSJoe Perches					my $hexval = sprintf("0x%x", oct($var));
4850194f66fcSJoe Perches					$fixed[$fixlinenr] =~
4851d5e616fcSJoe Perches					    s/\b$var\b/$hexval/;
4852d5e616fcSJoe Perches				}
485395e2c602SJoe Perches			}
485495e2c602SJoe Perches
485595e2c602SJoe Perches#CamelCase
4856807bd26cSJoe Perches			if ($var !~ /^$Constant$/ &&
4857be79794bSJoe Perches			    $var =~ /[A-Z][a-z]|[a-z][A-Z]/ &&
485822735ce8SJoe Perches#Ignore Page<foo> variants
4859807bd26cSJoe Perches			    $var !~ /^(?:Clear|Set|TestClear|TestSet|)Page[A-Z]/ &&
486022735ce8SJoe Perches#Ignore SI style variants like nS, mV and dB (ie: max_uV, regulator_min_uA_show)
4861f5123576SJulius Werner			    $var !~ /^(?:[a-z_]*?)_?[a-z][A-Z](?:_[a-z_]+)?$/ &&
4862f5123576SJulius Werner#Ignore some three character SI units explicitly, like MiB and KHz
4863f5123576SJulius Werner			    $var !~ /^(?:[a-z_]*?)_?(?:[KMGT]iB|[KMGT]?Hz)(?:_[a-z_]+)?$/) {
48647e781f67SJoe Perches				while ($var =~ m{($Ident)}g) {
48657e781f67SJoe Perches					my $word = $1;
48667e781f67SJoe Perches					next if ($word !~ /[A-Z][a-z]|[a-z][A-Z]/);
4867d8b07710SJoe Perches					if ($check) {
4868d8b07710SJoe Perches						seed_camelcase_includes();
4869d8b07710SJoe Perches						if (!$file && !$camelcase_file_seeded) {
4870d8b07710SJoe Perches							seed_camelcase_file($realfile);
4871d8b07710SJoe Perches							$camelcase_file_seeded = 1;
4872d8b07710SJoe Perches						}
4873d8b07710SJoe Perches					}
48747e781f67SJoe Perches					if (!defined $camelcase{$word}) {
48757e781f67SJoe Perches						$camelcase{$word} = 1;
4876be79794bSJoe Perches						CHK("CAMELCASE",
48777e781f67SJoe Perches						    "Avoid CamelCase: <$word>\n" . $herecurr);
48787e781f67SJoe Perches					}
4879323c1260SJoe Perches				}
4880323c1260SJoe Perches			}
48813445686aSJoe Perches		}
48820a920b5bSAndy Whitcroft
48830a920b5bSAndy Whitcroft#no spaces allowed after \ in define
4884d5e616fcSJoe Perches		if ($line =~ /\#\s*define.*\\\s+$/) {
4885d5e616fcSJoe Perches			if (WARN("WHITESPACE_AFTER_LINE_CONTINUATION",
4886d5e616fcSJoe Perches				 "Whitespace after \\ makes next lines useless\n" . $herecurr) &&
4887d5e616fcSJoe Perches			    $fix) {
4888194f66fcSJoe Perches				$fixed[$fixlinenr] =~ s/\s+$//;
4889d5e616fcSJoe Perches			}
48900a920b5bSAndy Whitcroft		}
48910a920b5bSAndy Whitcroft
48920e212e0aSFabian Frederick# warn if <asm/foo.h> is #included and <linux/foo.h> is available and includes
48930e212e0aSFabian Frederick# itself <asm/foo.h> (uses RAW line)
4894c45dcabdSAndy Whitcroft		if ($tree && $rawline =~ m{^.\s*\#\s*include\s*\<asm\/(.*)\.h\>}) {
4895e09dec48SAndy Whitcroft			my $file = "$1.h";
4896e09dec48SAndy Whitcroft			my $checkfile = "include/linux/$file";
4897e09dec48SAndy Whitcroft			if (-f "$root/$checkfile" &&
4898e09dec48SAndy Whitcroft			    $realfile ne $checkfile &&
48997840a94cSWolfram Sang			    $1 !~ /$allowed_asm_includes/)
4900c45dcabdSAndy Whitcroft			{
49010e212e0aSFabian Frederick				my $asminclude = `grep -Ec "#include\\s+<asm/$file>" $root/$checkfile`;
49020e212e0aSFabian Frederick				if ($asminclude > 0) {
4903e09dec48SAndy Whitcroft					if ($realfile =~ m{^arch/}) {
4904000d1cc1SJoe Perches						CHK("ARCH_INCLUDE_LINUX",
4905000d1cc1SJoe Perches						    "Consider using #include <linux/$file> instead of <asm/$file>\n" . $herecurr);
4906e09dec48SAndy Whitcroft					} else {
4907000d1cc1SJoe Perches						WARN("INCLUDE_LINUX",
4908000d1cc1SJoe Perches						     "Use #include <linux/$file> instead of <asm/$file>\n" . $herecurr);
4909e09dec48SAndy Whitcroft					}
49100a920b5bSAndy Whitcroft				}
49110a920b5bSAndy Whitcroft			}
49120e212e0aSFabian Frederick		}
49130a920b5bSAndy Whitcroft
4914653d4876SAndy Whitcroft# multi-statement macros should be enclosed in a do while loop, grab the
4915653d4876SAndy Whitcroft# first statement and ensure its the whole macro if its not enclosed
4916cf655043SAndy Whitcroft# in a known good container
4917b8f96a31SAndy Whitcroft		if ($realfile !~ m@/vmlinux.lds.h$@ &&
4918b8f96a31SAndy Whitcroft		    $line =~ /^.\s*\#\s*define\s*$Ident(\()?/) {
4919d8aaf121SAndy Whitcroft			my $ln = $linenr;
4920d8aaf121SAndy Whitcroft			my $cnt = $realcnt;
4921c45dcabdSAndy Whitcroft			my ($off, $dstat, $dcond, $rest);
4922c45dcabdSAndy Whitcroft			my $ctx = '';
492308a2843eSJoe Perches			my $has_flow_statement = 0;
492408a2843eSJoe Perches			my $has_arg_concat = 0;
4925c45dcabdSAndy Whitcroft			($dstat, $dcond, $ln, $cnt, $off) =
4926f74bd194SAndy Whitcroft				ctx_statement_block($linenr, $realcnt, 0);
4927f74bd194SAndy Whitcroft			$ctx = $dstat;
4928c45dcabdSAndy Whitcroft			#print "dstat<$dstat> dcond<$dcond> cnt<$cnt> off<$off>\n";
4929a3bb97a7SAndy Whitcroft			#print "LINE<$lines[$ln-1]> len<" . length($lines[$ln-1]) . "\n";
4930c45dcabdSAndy Whitcroft
493108a2843eSJoe Perches			$has_flow_statement = 1 if ($ctx =~ /\b(goto|return)\b/);
493262e15a6dSJoe Perches			$has_arg_concat = 1 if ($ctx =~ /\#\#/ && $ctx !~ /\#\#\s*(?:__VA_ARGS__|args)\b/);
493308a2843eSJoe Perches
4934f59b64bfSJoe Perches			$dstat =~ s/^.\s*\#\s*define\s+$Ident(\([^\)]*\))?\s*//;
4935f59b64bfSJoe Perches			my $define_args = $1;
4936f59b64bfSJoe Perches			my $define_stmt = $dstat;
4937f59b64bfSJoe Perches			my @def_args = ();
4938f59b64bfSJoe Perches
4939f59b64bfSJoe Perches			if (defined $define_args && $define_args ne "") {
4940f59b64bfSJoe Perches				$define_args = substr($define_args, 1, length($define_args) - 2);
4941f59b64bfSJoe Perches				$define_args =~ s/\s*//g;
4942f59b64bfSJoe Perches				@def_args = split(",", $define_args);
4943f59b64bfSJoe Perches			}
4944f59b64bfSJoe Perches
4945292f1a9bSAndy Whitcroft			$dstat =~ s/$;//g;
4946c45dcabdSAndy Whitcroft			$dstat =~ s/\\\n.//g;
4947c45dcabdSAndy Whitcroft			$dstat =~ s/^\s*//s;
4948c45dcabdSAndy Whitcroft			$dstat =~ s/\s*$//s;
4949c45dcabdSAndy Whitcroft
4950c45dcabdSAndy Whitcroft			# Flatten any parentheses and braces
4951bf30d6edSAndy Whitcroft			while ($dstat =~ s/\([^\(\)]*\)/1/ ||
4952bf30d6edSAndy Whitcroft			       $dstat =~ s/\{[^\{\}]*\}/1/ ||
49536b10df42SVladimir Zapolskiy			       $dstat =~ s/.\[[^\[\]]*\]/1/)
4954bf30d6edSAndy Whitcroft			{
4955c45dcabdSAndy Whitcroft			}
4956c45dcabdSAndy Whitcroft
4957e45bab8eSAndy Whitcroft			# Flatten any obvious string concatentation.
495833acb54aSJoe Perches			while ($dstat =~ s/($String)\s*$Ident/$1/ ||
495933acb54aSJoe Perches			       $dstat =~ s/$Ident\s*($String)/$1/)
4960e45bab8eSAndy Whitcroft			{
4961e45bab8eSAndy Whitcroft			}
4962e45bab8eSAndy Whitcroft
496342e15293SJoe Perches			# Make asm volatile uses seem like a generic function
496442e15293SJoe Perches			$dstat =~ s/\b_*asm_*\s+_*volatile_*\b/asm_volatile/g;
496542e15293SJoe Perches
4966c45dcabdSAndy Whitcroft			my $exceptions = qr{
4967c45dcabdSAndy Whitcroft				$Declare|
4968c45dcabdSAndy Whitcroft				module_param_named|
4969a0a0a7a9SKees Cook				MODULE_PARM_DESC|
4970c45dcabdSAndy Whitcroft				DECLARE_PER_CPU|
4971c45dcabdSAndy Whitcroft				DEFINE_PER_CPU|
4972383099fdSAndy Whitcroft				__typeof__\(|
497322fd2d3eSStefani Seibold				union|
497422fd2d3eSStefani Seibold				struct|
4975ea71a0a0SAndy Whitcroft				\.$Ident\s*=\s*|
49766b10df42SVladimir Zapolskiy				^\"|\"$|
49776b10df42SVladimir Zapolskiy				^\[
4978c45dcabdSAndy Whitcroft			}x;
49795eaa20b9SAndy Whitcroft			#print "REST<$rest> dstat<$dstat> ctx<$ctx>\n";
4980f59b64bfSJoe Perches
4981f59b64bfSJoe Perches			$ctx =~ s/\n*$//;
4982f59b64bfSJoe Perches			my $stmt_cnt = statement_rawlines($ctx);
4983e3d95a2aSTobin C. Harding			my $herectx = get_stat_here($linenr, $stmt_cnt, $here);
4984f59b64bfSJoe Perches
4985f74bd194SAndy Whitcroft			if ($dstat ne '' &&
4986f74bd194SAndy Whitcroft			    $dstat !~ /^(?:$Ident|-?$Constant),$/ &&			# 10, // foo(),
4987f74bd194SAndy Whitcroft			    $dstat !~ /^(?:$Ident|-?$Constant);$/ &&			# foo();
49883cc4b1c3SJoe Perches			    $dstat !~ /^[!~-]?(?:$Lval|$Constant)$/ &&		# 10 // foo() // !foo // ~foo // -foo // foo->bar // foo.bar->baz
4989356fd398SJoe Perches			    $dstat !~ /^'X'$/ && $dstat !~ /^'XX'$/ &&			# character constants
4990f74bd194SAndy Whitcroft			    $dstat !~ /$exceptions/ &&
4991f74bd194SAndy Whitcroft			    $dstat !~ /^\.$Ident\s*=/ &&				# .foo =
4992e942e2c3SJoe Perches			    $dstat !~ /^(?:\#\s*$Ident|\#\s*$Constant)\s*$/ &&		# stringification #foo
499372f115f9SAndy Whitcroft			    $dstat !~ /^do\s*$Constant\s*while\s*$Constant;?$/ &&	# do {...} while (...); // do {...} while (...)
4994f74bd194SAndy Whitcroft			    $dstat !~ /^for\s*$Constant$/ &&				# for (...)
4995f74bd194SAndy Whitcroft			    $dstat !~ /^for\s*$Constant\s+(?:$Ident|-?$Constant)$/ &&	# for (...) bar()
4996f74bd194SAndy Whitcroft			    $dstat !~ /^do\s*{/ &&					# do {...
49974e5d56bdSEddie Kovsky			    $dstat !~ /^\(\{/ &&						# ({...
4998f95a7e6aSJoe Perches			    $ctx !~ /^.\s*#\s*define\s+TRACE_(?:SYSTEM|INCLUDE_FILE|INCLUDE_PATH)\b/)
4999c45dcabdSAndy Whitcroft			{
5000e795556aSJoe Perches				if ($dstat =~ /^\s*if\b/) {
5001e795556aSJoe Perches					ERROR("MULTISTATEMENT_MACRO_USE_DO_WHILE",
5002e795556aSJoe Perches					      "Macros starting with if should be enclosed by a do - while loop to avoid possible if/else logic defects\n" . "$herectx");
5003e795556aSJoe Perches				} elsif ($dstat =~ /;/) {
5004f74bd194SAndy Whitcroft					ERROR("MULTISTATEMENT_MACRO_USE_DO_WHILE",
5005f74bd194SAndy Whitcroft					      "Macros with multiple statements should be enclosed in a do - while loop\n" . "$herectx");
5006f74bd194SAndy Whitcroft				} else {
5007000d1cc1SJoe Perches					ERROR("COMPLEX_MACRO",
5008388982b5SAndrew Morton					      "Macros with complex values should be enclosed in parentheses\n" . "$herectx");
5009d8aaf121SAndy Whitcroft				}
5010f59b64bfSJoe Perches
5011f59b64bfSJoe Perches			}
50125207649bSJoe Perches
50135207649bSJoe Perches			# Make $define_stmt single line, comment-free, etc
50145207649bSJoe Perches			my @stmt_array = split('\n', $define_stmt);
50155207649bSJoe Perches			my $first = 1;
50165207649bSJoe Perches			$define_stmt = "";
50175207649bSJoe Perches			foreach my $l (@stmt_array) {
50185207649bSJoe Perches				$l =~ s/\\$//;
50195207649bSJoe Perches				if ($first) {
50205207649bSJoe Perches					$define_stmt = $l;
50215207649bSJoe Perches					$first = 0;
50225207649bSJoe Perches				} elsif ($l =~ /^[\+ ]/) {
50235207649bSJoe Perches					$define_stmt .= substr($l, 1);
50245207649bSJoe Perches				}
50255207649bSJoe Perches			}
50265207649bSJoe Perches			$define_stmt =~ s/$;//g;
50275207649bSJoe Perches			$define_stmt =~ s/\s+/ /g;
50285207649bSJoe Perches			$define_stmt = trim($define_stmt);
50295207649bSJoe Perches
5030f59b64bfSJoe Perches# check if any macro arguments are reused (ignore '...' and 'type')
5031f59b64bfSJoe Perches			foreach my $arg (@def_args) {
5032f59b64bfSJoe Perches			        next if ($arg =~ /\.\.\./);
50339192d41aSJoe Perches			        next if ($arg =~ /^type$/i);
50347fe528a2SJoe Perches				my $tmp_stmt = $define_stmt;
50357fe528a2SJoe Perches				$tmp_stmt =~ s/\b(typeof|__typeof__|__builtin\w+|typecheck\s*\(\s*$Type\s*,|\#+)\s*\(*\s*$arg\s*\)*\b//g;
50367fe528a2SJoe Perches				$tmp_stmt =~ s/\#+\s*$arg\b//g;
50377fe528a2SJoe Perches				$tmp_stmt =~ s/\b$arg\s*\#\#//g;
50387fe528a2SJoe Perches				my $use_cnt = $tmp_stmt =~ s/\b$arg\b//g;
5039f59b64bfSJoe Perches				if ($use_cnt > 1) {
5040f59b64bfSJoe Perches					CHK("MACRO_ARG_REUSE",
5041f59b64bfSJoe Perches					    "Macro argument reuse '$arg' - possible side-effects?\n" . "$herectx");
5042f59b64bfSJoe Perches				    }
50439192d41aSJoe Perches# check if any macro arguments may have other precedence issues
50447fe528a2SJoe Perches				if ($tmp_stmt =~ m/($Operators)?\s*\b$arg\b\s*($Operators)?/m &&
50459192d41aSJoe Perches				    ((defined($1) && $1 ne ',') ||
50469192d41aSJoe Perches				     (defined($2) && $2 ne ','))) {
50479192d41aSJoe Perches					CHK("MACRO_ARG_PRECEDENCE",
50489192d41aSJoe Perches					    "Macro argument '$arg' may be better as '($arg)' to avoid precedence issues\n" . "$herectx");
50499192d41aSJoe Perches				}
50500a920b5bSAndy Whitcroft			}
50515023d347SJoe Perches
505208a2843eSJoe Perches# check for macros with flow control, but without ## concatenation
505308a2843eSJoe Perches# ## concatenation is commonly a macro that defines a function so ignore those
505408a2843eSJoe Perches			if ($has_flow_statement && !$has_arg_concat) {
505508a2843eSJoe Perches				my $cnt = statement_rawlines($ctx);
5056e3d95a2aSTobin C. Harding				my $herectx = get_stat_here($linenr, $cnt, $here);
505708a2843eSJoe Perches
505808a2843eSJoe Perches				WARN("MACRO_WITH_FLOW_CONTROL",
505908a2843eSJoe Perches				     "Macros with flow control statements should be avoided\n" . "$herectx");
506008a2843eSJoe Perches			}
506108a2843eSJoe Perches
5062481eb486SJoe Perches# check for line continuations outside of #defines, preprocessor #, and asm
50635023d347SJoe Perches
50645023d347SJoe Perches		} else {
50655023d347SJoe Perches			if ($prevline !~ /^..*\\$/ &&
5066481eb486SJoe Perches			    $line !~ /^\+\s*\#.*\\$/ &&		# preprocessor
5067481eb486SJoe Perches			    $line !~ /^\+.*\b(__asm__|asm)\b.*\\$/ &&	# asm
50685023d347SJoe Perches			    $line =~ /^\+.*\\$/) {
50695023d347SJoe Perches				WARN("LINE_CONTINUATIONS",
50705023d347SJoe Perches				     "Avoid unnecessary line continuations\n" . $herecurr);
50715023d347SJoe Perches			}
5072653d4876SAndy Whitcroft		}
50730a920b5bSAndy Whitcroft
5074b13edf7fSJoe Perches# do {} while (0) macro tests:
5075b13edf7fSJoe Perches# single-statement macros do not need to be enclosed in do while (0) loop,
5076b13edf7fSJoe Perches# macro should not end with a semicolon
5077b13edf7fSJoe Perches		if ($^V && $^V ge 5.10.0 &&
5078b13edf7fSJoe Perches		    $realfile !~ m@/vmlinux.lds.h$@ &&
5079b13edf7fSJoe Perches		    $line =~ /^.\s*\#\s*define\s+$Ident(\()?/) {
5080b13edf7fSJoe Perches			my $ln = $linenr;
5081b13edf7fSJoe Perches			my $cnt = $realcnt;
5082b13edf7fSJoe Perches			my ($off, $dstat, $dcond, $rest);
5083b13edf7fSJoe Perches			my $ctx = '';
5084b13edf7fSJoe Perches			($dstat, $dcond, $ln, $cnt, $off) =
5085b13edf7fSJoe Perches				ctx_statement_block($linenr, $realcnt, 0);
5086b13edf7fSJoe Perches			$ctx = $dstat;
5087b13edf7fSJoe Perches
5088b13edf7fSJoe Perches			$dstat =~ s/\\\n.//g;
50891b36b201SJoe Perches			$dstat =~ s/$;/ /g;
5090b13edf7fSJoe Perches
5091b13edf7fSJoe Perches			if ($dstat =~ /^\+\s*#\s*define\s+$Ident\s*${balanced_parens}\s*do\s*{(.*)\s*}\s*while\s*\(\s*0\s*\)\s*([;\s]*)\s*$/) {
5092b13edf7fSJoe Perches				my $stmts = $2;
5093b13edf7fSJoe Perches				my $semis = $3;
5094b13edf7fSJoe Perches
5095b13edf7fSJoe Perches				$ctx =~ s/\n*$//;
5096b13edf7fSJoe Perches				my $cnt = statement_rawlines($ctx);
5097e3d95a2aSTobin C. Harding				my $herectx = get_stat_here($linenr, $cnt, $here);
5098b13edf7fSJoe Perches
5099ac8e97f8SJoe Perches				if (($stmts =~ tr/;/;/) == 1 &&
5100ac8e97f8SJoe Perches				    $stmts !~ /^\s*(if|while|for|switch)\b/) {
5101b13edf7fSJoe Perches					WARN("SINGLE_STATEMENT_DO_WHILE_MACRO",
5102b13edf7fSJoe Perches					     "Single statement macros should not use a do {} while (0) loop\n" . "$herectx");
5103b13edf7fSJoe Perches				}
5104b13edf7fSJoe Perches				if (defined $semis && $semis ne "") {
5105b13edf7fSJoe Perches					WARN("DO_WHILE_MACRO_WITH_TRAILING_SEMICOLON",
5106b13edf7fSJoe Perches					     "do {} while (0) macros should not be semicolon terminated\n" . "$herectx");
5107b13edf7fSJoe Perches				}
5108f5ef95b1SJoe Perches			} elsif ($dstat =~ /^\+\s*#\s*define\s+$Ident.*;\s*$/) {
5109f5ef95b1SJoe Perches				$ctx =~ s/\n*$//;
5110f5ef95b1SJoe Perches				my $cnt = statement_rawlines($ctx);
5111e3d95a2aSTobin C. Harding				my $herectx = get_stat_here($linenr, $cnt, $here);
5112f5ef95b1SJoe Perches
5113f5ef95b1SJoe Perches				WARN("TRAILING_SEMICOLON",
5114f5ef95b1SJoe Perches				     "macros should not use a trailing semicolon\n" . "$herectx");
5115b13edf7fSJoe Perches			}
5116b13edf7fSJoe Perches		}
5117b13edf7fSJoe Perches
5118080ba929SMike Frysinger# make sure symbols are always wrapped with VMLINUX_SYMBOL() ...
5119080ba929SMike Frysinger# all assignments may have only one of the following with an assignment:
5120080ba929SMike Frysinger#	.
5121080ba929SMike Frysinger#	ALIGN(...)
5122080ba929SMike Frysinger#	VMLINUX_SYMBOL(...)
5123080ba929SMike Frysinger		if ($realfile eq 'vmlinux.lds.h' && $line =~ /(?:(?:^|\s)$Ident\s*=|=\s*$Ident(?:\s|$))/) {
5124000d1cc1SJoe Perches			WARN("MISSING_VMLINUX_SYMBOL",
5125000d1cc1SJoe Perches			     "vmlinux.lds.h needs VMLINUX_SYMBOL() around C-visible symbols\n" . $herecurr);
5126080ba929SMike Frysinger		}
5127080ba929SMike Frysinger
5128f0a594c1SAndy Whitcroft# check for redundant bracing round if etc
512913214adfSAndy Whitcroft		if ($line =~ /(^.*)\bif\b/ && $1 !~ /else\s*$/) {
513013214adfSAndy Whitcroft			my ($level, $endln, @chunks) =
5131cf655043SAndy Whitcroft				ctx_statement_full($linenr, $realcnt, 1);
513213214adfSAndy Whitcroft			#print "chunks<$#chunks> linenr<$linenr> endln<$endln> level<$level>\n";
5133cf655043SAndy Whitcroft			#print "APW: <<$chunks[1][0]>><<$chunks[1][1]>>\n";
5134cf655043SAndy Whitcroft			if ($#chunks > 0 && $level == 0) {
5135aad4f614SJoe Perches				my @allowed = ();
5136aad4f614SJoe Perches				my $allow = 0;
513713214adfSAndy Whitcroft				my $seen = 0;
5138773647a0SAndy Whitcroft				my $herectx = $here . "\n";
5139cf655043SAndy Whitcroft				my $ln = $linenr - 1;
514013214adfSAndy Whitcroft				for my $chunk (@chunks) {
514113214adfSAndy Whitcroft					my ($cond, $block) = @{$chunk};
514213214adfSAndy Whitcroft
5143773647a0SAndy Whitcroft					# If the condition carries leading newlines, then count those as offsets.
5144773647a0SAndy Whitcroft					my ($whitespace) = ($cond =~ /^((?:\s*\n[+-])*\s*)/s);
5145773647a0SAndy Whitcroft					my $offset = statement_rawlines($whitespace) - 1;
5146773647a0SAndy Whitcroft
5147aad4f614SJoe Perches					$allowed[$allow] = 0;
5148773647a0SAndy Whitcroft					#print "COND<$cond> whitespace<$whitespace> offset<$offset>\n";
5149773647a0SAndy Whitcroft
5150773647a0SAndy Whitcroft					# We have looked at and allowed this specific line.
5151773647a0SAndy Whitcroft					$suppress_ifbraces{$ln + $offset} = 1;
5152773647a0SAndy Whitcroft
5153773647a0SAndy Whitcroft					$herectx .= "$rawlines[$ln + $offset]\n[...]\n";
5154cf655043SAndy Whitcroft					$ln += statement_rawlines($block) - 1;
5155cf655043SAndy Whitcroft
5156773647a0SAndy Whitcroft					substr($block, 0, length($cond), '');
515713214adfSAndy Whitcroft
515813214adfSAndy Whitcroft					$seen++ if ($block =~ /^\s*{/);
515913214adfSAndy Whitcroft
5160aad4f614SJoe Perches					#print "cond<$cond> block<$block> allowed<$allowed[$allow]>\n";
5161cf655043SAndy Whitcroft					if (statement_lines($cond) > 1) {
5162cf655043SAndy Whitcroft						#print "APW: ALLOWED: cond<$cond>\n";
5163aad4f614SJoe Perches						$allowed[$allow] = 1;
516413214adfSAndy Whitcroft					}
516513214adfSAndy Whitcroft					if ($block =~/\b(?:if|for|while)\b/) {
5166cf655043SAndy Whitcroft						#print "APW: ALLOWED: block<$block>\n";
5167aad4f614SJoe Perches						$allowed[$allow] = 1;
516813214adfSAndy Whitcroft					}
5169cf655043SAndy Whitcroft					if (statement_block_size($block) > 1) {
5170cf655043SAndy Whitcroft						#print "APW: ALLOWED: lines block<$block>\n";
5171aad4f614SJoe Perches						$allowed[$allow] = 1;
517213214adfSAndy Whitcroft					}
5173aad4f614SJoe Perches					$allow++;
517413214adfSAndy Whitcroft				}
5175aad4f614SJoe Perches				if ($seen) {
5176aad4f614SJoe Perches					my $sum_allowed = 0;
5177aad4f614SJoe Perches					foreach (@allowed) {
5178aad4f614SJoe Perches						$sum_allowed += $_;
5179aad4f614SJoe Perches					}
5180aad4f614SJoe Perches					if ($sum_allowed == 0) {
5181000d1cc1SJoe Perches						WARN("BRACES",
5182000d1cc1SJoe Perches						     "braces {} are not necessary for any arm of this statement\n" . $herectx);
5183aad4f614SJoe Perches					} elsif ($sum_allowed != $allow &&
5184aad4f614SJoe Perches						 $seen != $allow) {
5185aad4f614SJoe Perches						CHK("BRACES",
5186aad4f614SJoe Perches						    "braces {} should be used on all arms of this statement\n" . $herectx);
5187aad4f614SJoe Perches					}
518813214adfSAndy Whitcroft				}
518913214adfSAndy Whitcroft			}
519013214adfSAndy Whitcroft		}
5191773647a0SAndy Whitcroft		if (!defined $suppress_ifbraces{$linenr - 1} &&
519213214adfSAndy Whitcroft					$line =~ /\b(if|while|for|else)\b/) {
5193cf655043SAndy Whitcroft			my $allowed = 0;
5194f0a594c1SAndy Whitcroft
5195cf655043SAndy Whitcroft			# Check the pre-context.
5196cf655043SAndy Whitcroft			if (substr($line, 0, $-[0]) =~ /(\}\s*)$/) {
5197cf655043SAndy Whitcroft				#print "APW: ALLOWED: pre<$1>\n";
5198cf655043SAndy Whitcroft				$allowed = 1;
5199f0a594c1SAndy Whitcroft			}
5200773647a0SAndy Whitcroft
5201773647a0SAndy Whitcroft			my ($level, $endln, @chunks) =
5202773647a0SAndy Whitcroft				ctx_statement_full($linenr, $realcnt, $-[0]);
5203773647a0SAndy Whitcroft
5204cf655043SAndy Whitcroft			# Check the condition.
5205cf655043SAndy Whitcroft			my ($cond, $block) = @{$chunks[0]};
5206773647a0SAndy Whitcroft			#print "CHECKING<$linenr> cond<$cond> block<$block>\n";
5207cf655043SAndy Whitcroft			if (defined $cond) {
5208773647a0SAndy Whitcroft				substr($block, 0, length($cond), '');
5209cf655043SAndy Whitcroft			}
5210cf655043SAndy Whitcroft			if (statement_lines($cond) > 1) {
5211cf655043SAndy Whitcroft				#print "APW: ALLOWED: cond<$cond>\n";
5212cf655043SAndy Whitcroft				$allowed = 1;
5213cf655043SAndy Whitcroft			}
5214cf655043SAndy Whitcroft			if ($block =~/\b(?:if|for|while)\b/) {
5215cf655043SAndy Whitcroft				#print "APW: ALLOWED: block<$block>\n";
5216cf655043SAndy Whitcroft				$allowed = 1;
5217cf655043SAndy Whitcroft			}
5218cf655043SAndy Whitcroft			if (statement_block_size($block) > 1) {
5219cf655043SAndy Whitcroft				#print "APW: ALLOWED: lines block<$block>\n";
5220cf655043SAndy Whitcroft				$allowed = 1;
5221cf655043SAndy Whitcroft			}
5222cf655043SAndy Whitcroft			# Check the post-context.
5223cf655043SAndy Whitcroft			if (defined $chunks[1]) {
5224cf655043SAndy Whitcroft				my ($cond, $block) = @{$chunks[1]};
5225cf655043SAndy Whitcroft				if (defined $cond) {
5226773647a0SAndy Whitcroft					substr($block, 0, length($cond), '');
5227cf655043SAndy Whitcroft				}
5228cf655043SAndy Whitcroft				if ($block =~ /^\s*\{/) {
5229cf655043SAndy Whitcroft					#print "APW: ALLOWED: chunk-1 block<$block>\n";
5230cf655043SAndy Whitcroft					$allowed = 1;
5231cf655043SAndy Whitcroft				}
5232cf655043SAndy Whitcroft			}
5233cf655043SAndy Whitcroft			if ($level == 0 && $block =~ /^\s*\{/ && !$allowed) {
5234f055663cSAndy Whitcroft				my $cnt = statement_rawlines($block);
5235e3d95a2aSTobin C. Harding				my $herectx = get_stat_here($linenr, $cnt, $here);
5236cf655043SAndy Whitcroft
5237000d1cc1SJoe Perches				WARN("BRACES",
5238000d1cc1SJoe Perches				     "braces {} are not necessary for single statement blocks\n" . $herectx);
5239f0a594c1SAndy Whitcroft			}
5240f0a594c1SAndy Whitcroft		}
5241f0a594c1SAndy Whitcroft
5242e4c5babdSJoe Perches# check for single line unbalanced braces
524395330473SSven Eckelmann		if ($sline =~ /^.\s*\}\s*else\s*$/ ||
524495330473SSven Eckelmann		    $sline =~ /^.\s*else\s*\{\s*$/) {
5245e4c5babdSJoe Perches			CHK("BRACES", "Unbalanced braces around else statement\n" . $herecurr);
5246e4c5babdSJoe Perches		}
5247e4c5babdSJoe Perches
52480979ae66SJoe Perches# check for unnecessary blank lines around braces
524977b9a53aSJoe Perches		if (($line =~ /^.\s*}\s*$/ && $prevrawline =~ /^.\s*$/)) {
5250f8e58219SJoe Perches			if (CHK("BRACES",
5251f8e58219SJoe Perches				"Blank lines aren't necessary before a close brace '}'\n" . $hereprev) &&
5252f8e58219SJoe Perches			    $fix && $prevrawline =~ /^\+/) {
5253f8e58219SJoe Perches				fix_delete_line($fixlinenr - 1, $prevrawline);
5254f8e58219SJoe Perches			}
52550979ae66SJoe Perches		}
525677b9a53aSJoe Perches		if (($rawline =~ /^.\s*$/ && $prevline =~ /^..*{\s*$/)) {
5257f8e58219SJoe Perches			if (CHK("BRACES",
5258f8e58219SJoe Perches				"Blank lines aren't necessary after an open brace '{'\n" . $hereprev) &&
5259f8e58219SJoe Perches			    $fix) {
5260f8e58219SJoe Perches				fix_delete_line($fixlinenr, $rawline);
5261f8e58219SJoe Perches			}
52620979ae66SJoe Perches		}
52630979ae66SJoe Perches
52644a0df2efSAndy Whitcroft# no volatiles please
52656c72ffaaSAndy Whitcroft		my $asm_volatile = qr{\b(__asm__|asm)\s+(__volatile__|volatile)\b};
52666c72ffaaSAndy Whitcroft		if ($line =~ /\bvolatile\b/ && $line !~ /$asm_volatile/) {
5267000d1cc1SJoe Perches			WARN("VOLATILE",
52688c27ceffSMauro Carvalho Chehab			     "Use of volatile is usually wrong: see Documentation/process/volatile-considered-harmful.rst\n" . $herecurr);
52694a0df2efSAndy Whitcroft		}
52704a0df2efSAndy Whitcroft
52715e4f6ba5SJoe Perches# Check for user-visible strings broken across lines, which breaks the ability
52725e4f6ba5SJoe Perches# to grep for the string.  Make exceptions when the previous string ends in a
52735e4f6ba5SJoe Perches# newline (multiple lines in one string constant) or '\t', '\r', ';', or '{'
52745e4f6ba5SJoe Perches# (common in inline assembly) or is a octal \123 or hexadecimal \xaf value
527533acb54aSJoe Perches		if ($line =~ /^\+\s*$String/ &&
52765e4f6ba5SJoe Perches		    $prevline =~ /"\s*$/ &&
52775e4f6ba5SJoe Perches		    $prevrawline !~ /(?:\\(?:[ntr]|[0-7]{1,3}|x[0-9a-fA-F]{1,2})|;\s*|\{\s*)"\s*$/) {
52785e4f6ba5SJoe Perches			if (WARN("SPLIT_STRING",
52795e4f6ba5SJoe Perches				 "quoted string split across lines\n" . $hereprev) &&
52805e4f6ba5SJoe Perches				     $fix &&
52815e4f6ba5SJoe Perches				     $prevrawline =~ /^\+.*"\s*$/ &&
52825e4f6ba5SJoe Perches				     $last_coalesced_string_linenr != $linenr - 1) {
52835e4f6ba5SJoe Perches				my $extracted_string = get_quoted_string($line, $rawline);
52845e4f6ba5SJoe Perches				my $comma_close = "";
52855e4f6ba5SJoe Perches				if ($rawline =~ /\Q$extracted_string\E(\s*\)\s*;\s*$|\s*,\s*)/) {
52865e4f6ba5SJoe Perches					$comma_close = $1;
52875e4f6ba5SJoe Perches				}
52885e4f6ba5SJoe Perches
52895e4f6ba5SJoe Perches				fix_delete_line($fixlinenr - 1, $prevrawline);
52905e4f6ba5SJoe Perches				fix_delete_line($fixlinenr, $rawline);
52915e4f6ba5SJoe Perches				my $fixedline = $prevrawline;
52925e4f6ba5SJoe Perches				$fixedline =~ s/"\s*$//;
52935e4f6ba5SJoe Perches				$fixedline .= substr($extracted_string, 1) . trim($comma_close);
52945e4f6ba5SJoe Perches				fix_insert_line($fixlinenr - 1, $fixedline);
52955e4f6ba5SJoe Perches				$fixedline = $rawline;
52965e4f6ba5SJoe Perches				$fixedline =~ s/\Q$extracted_string\E\Q$comma_close\E//;
52975e4f6ba5SJoe Perches				if ($fixedline !~ /\+\s*$/) {
52985e4f6ba5SJoe Perches					fix_insert_line($fixlinenr, $fixedline);
52995e4f6ba5SJoe Perches				}
53005e4f6ba5SJoe Perches				$last_coalesced_string_linenr = $linenr;
53015e4f6ba5SJoe Perches			}
53025e4f6ba5SJoe Perches		}
53035e4f6ba5SJoe Perches
53045e4f6ba5SJoe Perches# check for missing a space in a string concatenation
53055e4f6ba5SJoe Perches		if ($prevrawline =~ /[^\\]\w"$/ && $rawline =~ /^\+[\t ]+"\w/) {
53065e4f6ba5SJoe Perches			WARN('MISSING_SPACE',
53075e4f6ba5SJoe Perches			     "break quoted strings at a space character\n" . $hereprev);
53085e4f6ba5SJoe Perches		}
53095e4f6ba5SJoe Perches
531077cb8546SJoe Perches# check for an embedded function name in a string when the function is known
5311e4b7d309SJoe Perches# This does not work very well for -f --file checking as it depends on patch
5312e4b7d309SJoe Perches# context providing the function name or a single line form for in-file
5313e4b7d309SJoe Perches# function declarations
531477cb8546SJoe Perches		if ($line =~ /^\+.*$String/ &&
531577cb8546SJoe Perches		    defined($context_function) &&
5316e4b7d309SJoe Perches		    get_quoted_string($line, $rawline) =~ /\b$context_function\b/ &&
5317e4b7d309SJoe Perches		    length(get_quoted_string($line, $rawline)) != (length($context_function) + 2)) {
531877cb8546SJoe Perches			WARN("EMBEDDED_FUNCTION_NAME",
5319e4b7d309SJoe Perches			     "Prefer using '\"%s...\", __func__' to using '$context_function', this function's name, in a string\n" . $herecurr);
532077cb8546SJoe Perches		}
532177cb8546SJoe Perches
53225e4f6ba5SJoe Perches# check for spaces before a quoted newline
53235e4f6ba5SJoe Perches		if ($rawline =~ /^.*\".*\s\\n/) {
53245e4f6ba5SJoe Perches			if (WARN("QUOTED_WHITESPACE_BEFORE_NEWLINE",
53255e4f6ba5SJoe Perches				 "unnecessary whitespace before a quoted newline\n" . $herecurr) &&
53265e4f6ba5SJoe Perches			    $fix) {
53275e4f6ba5SJoe Perches				$fixed[$fixlinenr] =~ s/^(\+.*\".*)\s+\\n/$1\\n/;
53285e4f6ba5SJoe Perches			}
53295e4f6ba5SJoe Perches
53305e4f6ba5SJoe Perches		}
53315e4f6ba5SJoe Perches
5332f17dba4fSJoe Perches# concatenated string without spaces between elements
533333acb54aSJoe Perches		if ($line =~ /$String[A-Z_]/ || $line =~ /[A-Za-z0-9_]$String/) {
5334f17dba4fSJoe Perches			CHK("CONCATENATED_STRING",
5335f17dba4fSJoe Perches			    "Concatenated strings should use spaces between elements\n" . $herecurr);
5336f17dba4fSJoe Perches		}
5337f17dba4fSJoe Perches
533890ad30e5SJoe Perches# uncoalesced string fragments
533933acb54aSJoe Perches		if ($line =~ /$String\s*"/) {
534090ad30e5SJoe Perches			WARN("STRING_FRAGMENTS",
534190ad30e5SJoe Perches			     "Consecutive strings are generally better as a single string\n" . $herecurr);
534290ad30e5SJoe Perches		}
534390ad30e5SJoe Perches
5344522b837cSAlexey Dobriyan# check for non-standard and hex prefixed decimal printf formats
5345522b837cSAlexey Dobriyan		my $show_L = 1;	#don't show the same defect twice
5346522b837cSAlexey Dobriyan		my $show_Z = 1;
53475e4f6ba5SJoe Perches		while ($line =~ /(?:^|")([X\t]*)(?:"|$)/g) {
5348522b837cSAlexey Dobriyan			my $string = substr($rawline, $-[1], $+[1] - $-[1]);
53495e4f6ba5SJoe Perches			$string =~ s/%%/__/g;
5350522b837cSAlexey Dobriyan			# check for %L
5351522b837cSAlexey Dobriyan			if ($show_L && $string =~ /%[\*\d\.\$]*L([diouxX])/) {
53525e4f6ba5SJoe Perches				WARN("PRINTF_L",
5353522b837cSAlexey Dobriyan				     "\%L$1 is non-standard C, use %ll$1\n" . $herecurr);
5354522b837cSAlexey Dobriyan				$show_L = 0;
53555e4f6ba5SJoe Perches			}
5356522b837cSAlexey Dobriyan			# check for %Z
5357522b837cSAlexey Dobriyan			if ($show_Z && $string =~ /%[\*\d\.\$]*Z([diouxX])/) {
5358522b837cSAlexey Dobriyan				WARN("PRINTF_Z",
5359522b837cSAlexey Dobriyan				     "%Z$1 is non-standard C, use %z$1\n" . $herecurr);
5360522b837cSAlexey Dobriyan				$show_Z = 0;
5361522b837cSAlexey Dobriyan			}
5362522b837cSAlexey Dobriyan			# check for 0x<decimal>
5363522b837cSAlexey Dobriyan			if ($string =~ /0x%[\*\d\.\$\Llzth]*[diou]/) {
5364522b837cSAlexey Dobriyan				ERROR("PRINTF_0XDECIMAL",
53656e300757SJoe Perches				      "Prefixing 0x with decimal output is defective\n" . $herecurr);
53666e300757SJoe Perches			}
53675e4f6ba5SJoe Perches		}
53685e4f6ba5SJoe Perches
53695e4f6ba5SJoe Perches# check for line continuations in quoted strings with odd counts of "
53703f7f335dSJoe Perches		if ($rawline =~ /\\$/ && $sline =~ tr/"/"/ % 2) {
53715e4f6ba5SJoe Perches			WARN("LINE_CONTINUATIONS",
53725e4f6ba5SJoe Perches			     "Avoid line continuations in quoted strings\n" . $herecurr);
53735e4f6ba5SJoe Perches		}
53745e4f6ba5SJoe Perches
537500df344fSAndy Whitcroft# warn about #if 0
5376c45dcabdSAndy Whitcroft		if ($line =~ /^.\s*\#\s*if\s+0\b/) {
5377000d1cc1SJoe Perches			CHK("REDUNDANT_CODE",
5378000d1cc1SJoe Perches			    "if this code is redundant consider removing it\n" .
5379de7d4f0eSAndy Whitcroft				$herecurr);
53804a0df2efSAndy Whitcroft		}
53814a0df2efSAndy Whitcroft
538203df4b51SAndy Whitcroft# check for needless "if (<foo>) fn(<foo>)" uses
538303df4b51SAndy Whitcroft		if ($prevline =~ /\bif\s*\(\s*($Lval)\s*\)/) {
5384100425deSJoe Perches			my $tested = quotemeta($1);
5385100425deSJoe Perches			my $expr = '\s*\(\s*' . $tested . '\s*\)\s*;';
5386100425deSJoe Perches			if ($line =~ /\b(kfree|usb_free_urb|debugfs_remove(?:_recursive)?|(?:kmem_cache|mempool|dma_pool)_destroy)$expr/) {
5387100425deSJoe Perches				my $func = $1;
5388100425deSJoe Perches				if (WARN('NEEDLESS_IF',
5389100425deSJoe Perches					 "$func(NULL) is safe and this check is probably not required\n" . $hereprev) &&
5390100425deSJoe Perches				    $fix) {
5391100425deSJoe Perches					my $do_fix = 1;
5392100425deSJoe Perches					my $leading_tabs = "";
5393100425deSJoe Perches					my $new_leading_tabs = "";
5394100425deSJoe Perches					if ($lines[$linenr - 2] =~ /^\+(\t*)if\s*\(\s*$tested\s*\)\s*$/) {
5395100425deSJoe Perches						$leading_tabs = $1;
5396100425deSJoe Perches					} else {
5397100425deSJoe Perches						$do_fix = 0;
5398100425deSJoe Perches					}
5399100425deSJoe Perches					if ($lines[$linenr - 1] =~ /^\+(\t+)$func\s*\(\s*$tested\s*\)\s*;\s*$/) {
5400100425deSJoe Perches						$new_leading_tabs = $1;
5401100425deSJoe Perches						if (length($leading_tabs) + 1 ne length($new_leading_tabs)) {
5402100425deSJoe Perches							$do_fix = 0;
5403100425deSJoe Perches						}
5404100425deSJoe Perches					} else {
5405100425deSJoe Perches						$do_fix = 0;
5406100425deSJoe Perches					}
5407100425deSJoe Perches					if ($do_fix) {
5408100425deSJoe Perches						fix_delete_line($fixlinenr - 1, $prevrawline);
5409100425deSJoe Perches						$fixed[$fixlinenr] =~ s/^\+$new_leading_tabs/\+$leading_tabs/;
5410100425deSJoe Perches					}
5411100425deSJoe Perches				}
54124c432a8fSGreg Kroah-Hartman			}
54134c432a8fSGreg Kroah-Hartman		}
5414f0a594c1SAndy Whitcroft
5415ebfdc409SJoe Perches# check for unnecessary "Out of Memory" messages
5416ebfdc409SJoe Perches		if ($line =~ /^\+.*\b$logFunctions\s*\(/ &&
5417ebfdc409SJoe Perches		    $prevline =~ /^[ \+]\s*if\s*\(\s*(\!\s*|NULL\s*==\s*)?($Lval)(\s*==\s*NULL\s*)?\s*\)/ &&
5418ebfdc409SJoe Perches		    (defined $1 || defined $3) &&
5419ebfdc409SJoe Perches		    $linenr > 3) {
5420ebfdc409SJoe Perches			my $testval = $2;
5421ebfdc409SJoe Perches			my $testline = $lines[$linenr - 3];
5422ebfdc409SJoe Perches
5423ebfdc409SJoe Perches			my ($s, $c) = ctx_statement_block($linenr - 3, $realcnt, 0);
5424ebfdc409SJoe Perches#			print("line: <$line>\nprevline: <$prevline>\ns: <$s>\nc: <$c>\n\n\n");
5425ebfdc409SJoe Perches
5426fb0d0e08SJoe Perches			if ($s =~ /(?:^|\n)[ \+]\s*(?:$Type\s*)?\Q$testval\E\s*=\s*(?:\([^\)]*\)\s*)?\s*(?:devm_)?(?:[kv][czm]alloc(?:_node|_array)?\b|kstrdup|kmemdup|(?:dev_)?alloc_skb)/) {
5427ebfdc409SJoe Perches				WARN("OOM_MESSAGE",
5428ebfdc409SJoe Perches				     "Possible unnecessary 'out of memory' message\n" . $hereprev);
5429ebfdc409SJoe Perches			}
5430ebfdc409SJoe Perches		}
5431ebfdc409SJoe Perches
5432f78d98f6SJoe Perches# check for logging functions with KERN_<LEVEL>
5433dcaf1123SPaolo Bonzini		if ($line !~ /printk(?:_ratelimited|_once)?\s*\(/ &&
5434f78d98f6SJoe Perches		    $line =~ /\b$logFunctions\s*\(.*\b(KERN_[A-Z]+)\b/) {
5435f78d98f6SJoe Perches			my $level = $1;
5436f78d98f6SJoe Perches			if (WARN("UNNECESSARY_KERN_LEVEL",
5437f78d98f6SJoe Perches				 "Possible unnecessary $level\n" . $herecurr) &&
5438f78d98f6SJoe Perches			    $fix) {
5439f78d98f6SJoe Perches				$fixed[$fixlinenr] =~ s/\s*$level\s*//;
5440f78d98f6SJoe Perches			}
5441f78d98f6SJoe Perches		}
5442f78d98f6SJoe Perches
544345c55e92SJoe Perches# check for logging continuations
544445c55e92SJoe Perches		if ($line =~ /\bprintk\s*\(\s*KERN_CONT\b|\bpr_cont\s*\(/) {
544545c55e92SJoe Perches			WARN("LOGGING_CONTINUATION",
544645c55e92SJoe Perches			     "Avoid logging continuation uses where feasible\n" . $herecurr);
544745c55e92SJoe Perches		}
544845c55e92SJoe Perches
5449abb08a53SJoe Perches# check for mask then right shift without a parentheses
5450abb08a53SJoe Perches		if ($^V && $^V ge 5.10.0 &&
5451abb08a53SJoe Perches		    $line =~ /$LvalOrFunc\s*\&\s*($LvalOrFunc)\s*>>/ &&
5452abb08a53SJoe Perches		    $4 !~ /^\&/) { # $LvalOrFunc may be &foo, ignore if so
5453abb08a53SJoe Perches			WARN("MASK_THEN_SHIFT",
5454abb08a53SJoe Perches			     "Possible precedence defect with mask then right shift - may need parentheses\n" . $herecurr);
5455abb08a53SJoe Perches		}
5456abb08a53SJoe Perches
5457b75ac618SJoe Perches# check for pointer comparisons to NULL
5458b75ac618SJoe Perches		if ($^V && $^V ge 5.10.0) {
5459b75ac618SJoe Perches			while ($line =~ /\b$LvalOrFunc\s*(==|\!=)\s*NULL\b/g) {
5460b75ac618SJoe Perches				my $val = $1;
5461b75ac618SJoe Perches				my $equal = "!";
5462b75ac618SJoe Perches				$equal = "" if ($4 eq "!=");
5463b75ac618SJoe Perches				if (CHK("COMPARISON_TO_NULL",
5464b75ac618SJoe Perches					"Comparison to NULL could be written \"${equal}${val}\"\n" . $herecurr) &&
5465b75ac618SJoe Perches					    $fix) {
5466b75ac618SJoe Perches					$fixed[$fixlinenr] =~ s/\b\Q$val\E\s*(?:==|\!=)\s*NULL\b/$equal$val/;
5467b75ac618SJoe Perches				}
5468b75ac618SJoe Perches			}
5469b75ac618SJoe Perches		}
5470b75ac618SJoe Perches
54718716de38SJoe Perches# check for bad placement of section $InitAttribute (e.g.: __initdata)
54728716de38SJoe Perches		if ($line =~ /(\b$InitAttribute\b)/) {
54738716de38SJoe Perches			my $attr = $1;
54748716de38SJoe Perches			if ($line =~ /^\+\s*static\s+(?:const\s+)?(?:$attr\s+)?($NonptrTypeWithAttr)\s+(?:$attr\s+)?($Ident(?:\[[^]]*\])?)\s*[=;]/) {
54758716de38SJoe Perches				my $ptr = $1;
54768716de38SJoe Perches				my $var = $2;
54778716de38SJoe Perches				if ((($ptr =~ /\b(union|struct)\s+$attr\b/ &&
54788716de38SJoe Perches				      ERROR("MISPLACED_INIT",
54798716de38SJoe Perches					    "$attr should be placed after $var\n" . $herecurr)) ||
54808716de38SJoe Perches				     ($ptr !~ /\b(union|struct)\s+$attr\b/ &&
54818716de38SJoe Perches				      WARN("MISPLACED_INIT",
54828716de38SJoe Perches					   "$attr should be placed after $var\n" . $herecurr))) &&
54838716de38SJoe Perches				    $fix) {
5484194f66fcSJoe 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;
54858716de38SJoe Perches				}
54868716de38SJoe Perches			}
54878716de38SJoe Perches		}
54888716de38SJoe Perches
5489e970b884SJoe Perches# check for $InitAttributeData (ie: __initdata) with const
5490e970b884SJoe Perches		if ($line =~ /\bconst\b/ && $line =~ /($InitAttributeData)/) {
5491e970b884SJoe Perches			my $attr = $1;
5492e970b884SJoe Perches			$attr =~ /($InitAttributePrefix)(.*)/;
5493e970b884SJoe Perches			my $attr_prefix = $1;
5494e970b884SJoe Perches			my $attr_type = $2;
5495e970b884SJoe Perches			if (ERROR("INIT_ATTRIBUTE",
5496e970b884SJoe Perches				  "Use of const init definition must use ${attr_prefix}initconst\n" . $herecurr) &&
5497e970b884SJoe Perches			    $fix) {
5498194f66fcSJoe Perches				$fixed[$fixlinenr] =~
5499e970b884SJoe Perches				    s/$InitAttributeData/${attr_prefix}initconst/;
5500e970b884SJoe Perches			}
5501e970b884SJoe Perches		}
5502e970b884SJoe Perches
5503e970b884SJoe Perches# check for $InitAttributeConst (ie: __initconst) without const
5504e970b884SJoe Perches		if ($line !~ /\bconst\b/ && $line =~ /($InitAttributeConst)/) {
5505e970b884SJoe Perches			my $attr = $1;
5506e970b884SJoe Perches			if (ERROR("INIT_ATTRIBUTE",
5507e970b884SJoe Perches				  "Use of $attr requires a separate use of const\n" . $herecurr) &&
5508e970b884SJoe Perches			    $fix) {
5509194f66fcSJoe Perches				my $lead = $fixed[$fixlinenr] =~
5510e970b884SJoe Perches				    /(^\+\s*(?:static\s+))/;
5511e970b884SJoe Perches				$lead = rtrim($1);
5512e970b884SJoe Perches				$lead = "$lead " if ($lead !~ /^\+$/);
5513e970b884SJoe Perches				$lead = "${lead}const ";
5514194f66fcSJoe Perches				$fixed[$fixlinenr] =~ s/(^\+\s*(?:static\s+))/$lead/;
5515e970b884SJoe Perches			}
5516e970b884SJoe Perches		}
5517e970b884SJoe Perches
5518c17893c7SJoe Perches# check for __read_mostly with const non-pointer (should just be const)
5519c17893c7SJoe Perches		if ($line =~ /\b__read_mostly\b/ &&
5520c17893c7SJoe Perches		    $line =~ /($Type)\s*$Ident/ && $1 !~ /\*\s*$/ && $1 =~ /\bconst\b/) {
5521c17893c7SJoe Perches			if (ERROR("CONST_READ_MOSTLY",
5522c17893c7SJoe Perches				  "Invalid use of __read_mostly with const type\n" . $herecurr) &&
5523c17893c7SJoe Perches			    $fix) {
5524c17893c7SJoe Perches				$fixed[$fixlinenr] =~ s/\s+__read_mostly\b//;
5525c17893c7SJoe Perches			}
5526c17893c7SJoe Perches		}
5527c17893c7SJoe Perches
5528fbdb8138SJoe Perches# don't use __constant_<foo> functions outside of include/uapi/
5529fbdb8138SJoe Perches		if ($realfile !~ m@^include/uapi/@ &&
5530fbdb8138SJoe Perches		    $line =~ /(__constant_(?:htons|ntohs|[bl]e(?:16|32|64)_to_cpu|cpu_to_[bl]e(?:16|32|64)))\s*\(/) {
5531fbdb8138SJoe Perches			my $constant_func = $1;
5532fbdb8138SJoe Perches			my $func = $constant_func;
5533fbdb8138SJoe Perches			$func =~ s/^__constant_//;
5534fbdb8138SJoe Perches			if (WARN("CONSTANT_CONVERSION",
5535fbdb8138SJoe Perches				 "$constant_func should be $func\n" . $herecurr) &&
5536fbdb8138SJoe Perches			    $fix) {
5537194f66fcSJoe Perches				$fixed[$fixlinenr] =~ s/\b$constant_func\b/$func/g;
5538fbdb8138SJoe Perches			}
5539fbdb8138SJoe Perches		}
5540fbdb8138SJoe Perches
55411a15a250SPatrick Pannuto# prefer usleep_range over udelay
554237581c28SBruce Allan		if ($line =~ /\budelay\s*\(\s*(\d+)\s*\)/) {
554343c1d77cSJoe Perches			my $delay = $1;
55441a15a250SPatrick Pannuto			# ignore udelay's < 10, however
554543c1d77cSJoe Perches			if (! ($delay < 10) ) {
5546000d1cc1SJoe Perches				CHK("USLEEP_RANGE",
554743c1d77cSJoe Perches				    "usleep_range is preferred over udelay; see Documentation/timers/timers-howto.txt\n" . $herecurr);
554843c1d77cSJoe Perches			}
554943c1d77cSJoe Perches			if ($delay > 2000) {
555043c1d77cSJoe Perches				WARN("LONG_UDELAY",
555143c1d77cSJoe Perches				     "long udelay - prefer mdelay; see arch/arm/include/asm/delay.h\n" . $herecurr);
55521a15a250SPatrick Pannuto			}
55531a15a250SPatrick Pannuto		}
55541a15a250SPatrick Pannuto
555509ef8725SPatrick Pannuto# warn about unexpectedly long msleep's
555609ef8725SPatrick Pannuto		if ($line =~ /\bmsleep\s*\((\d+)\);/) {
555709ef8725SPatrick Pannuto			if ($1 < 20) {
5558000d1cc1SJoe Perches				WARN("MSLEEP",
555943c1d77cSJoe Perches				     "msleep < 20ms can sleep for up to 20ms; see Documentation/timers/timers-howto.txt\n" . $herecurr);
556009ef8725SPatrick Pannuto			}
556109ef8725SPatrick Pannuto		}
556209ef8725SPatrick Pannuto
556336ec1939SJoe Perches# check for comparisons of jiffies
556436ec1939SJoe Perches		if ($line =~ /\bjiffies\s*$Compare|$Compare\s*jiffies\b/) {
556536ec1939SJoe Perches			WARN("JIFFIES_COMPARISON",
556636ec1939SJoe Perches			     "Comparing jiffies is almost always wrong; prefer time_after, time_before and friends\n" . $herecurr);
556736ec1939SJoe Perches		}
556836ec1939SJoe Perches
55699d7a34a5SJoe Perches# check for comparisons of get_jiffies_64()
55709d7a34a5SJoe Perches		if ($line =~ /\bget_jiffies_64\s*\(\s*\)\s*$Compare|$Compare\s*get_jiffies_64\s*\(\s*\)/) {
55719d7a34a5SJoe Perches			WARN("JIFFIES_COMPARISON",
55729d7a34a5SJoe Perches			     "Comparing get_jiffies_64() is almost always wrong; prefer time_after64, time_before64 and friends\n" . $herecurr);
55739d7a34a5SJoe Perches		}
55749d7a34a5SJoe Perches
557500df344fSAndy Whitcroft# warn about #ifdefs in C files
5576c45dcabdSAndy Whitcroft#		if ($line =~ /^.\s*\#\s*if(|n)def/ && ($realfile =~ /\.c$/)) {
557700df344fSAndy Whitcroft#			print "#ifdef in C files should be avoided\n";
557800df344fSAndy Whitcroft#			print "$herecurr";
557900df344fSAndy Whitcroft#			$clean = 0;
558000df344fSAndy Whitcroft#		}
558100df344fSAndy Whitcroft
558222f2a2efSAndy Whitcroft# warn about spacing in #ifdefs
5583c45dcabdSAndy Whitcroft		if ($line =~ /^.\s*\#\s*(ifdef|ifndef|elif)\s\s+/) {
55843705ce5bSJoe Perches			if (ERROR("SPACING",
55853705ce5bSJoe Perches				  "exactly one space required after that #$1\n" . $herecurr) &&
55863705ce5bSJoe Perches			    $fix) {
5587194f66fcSJoe Perches				$fixed[$fixlinenr] =~
55883705ce5bSJoe Perches				    s/^(.\s*\#\s*(ifdef|ifndef|elif))\s{2,}/$1 /;
55893705ce5bSJoe Perches			}
55903705ce5bSJoe Perches
559122f2a2efSAndy Whitcroft		}
559222f2a2efSAndy Whitcroft
55934a0df2efSAndy Whitcroft# check for spinlock_t definitions without a comment.
5594171ae1a4SAndy Whitcroft		if ($line =~ /^.\s*(struct\s+mutex|spinlock_t)\s+\S+;/ ||
5595171ae1a4SAndy Whitcroft		    $line =~ /^.\s*(DEFINE_MUTEX)\s*\(/) {
55964a0df2efSAndy Whitcroft			my $which = $1;
55974a0df2efSAndy Whitcroft			if (!ctx_has_comment($first_line, $linenr)) {
5598000d1cc1SJoe Perches				CHK("UNCOMMENTED_DEFINITION",
5599000d1cc1SJoe Perches				    "$1 definition without comment\n" . $herecurr);
56004a0df2efSAndy Whitcroft			}
56014a0df2efSAndy Whitcroft		}
56024a0df2efSAndy Whitcroft# check for memory barriers without a comment.
5603402c2553SMichael S. Tsirkin
5604402c2553SMichael S. Tsirkin		my $barriers = qr{
5605402c2553SMichael S. Tsirkin			mb|
5606402c2553SMichael S. Tsirkin			rmb|
5607402c2553SMichael S. Tsirkin			wmb|
5608402c2553SMichael S. Tsirkin			read_barrier_depends
5609402c2553SMichael S. Tsirkin		}x;
5610402c2553SMichael S. Tsirkin		my $barrier_stems = qr{
5611402c2553SMichael S. Tsirkin			mb__before_atomic|
5612402c2553SMichael S. Tsirkin			mb__after_atomic|
5613402c2553SMichael S. Tsirkin			store_release|
5614402c2553SMichael S. Tsirkin			load_acquire|
5615402c2553SMichael S. Tsirkin			store_mb|
5616402c2553SMichael S. Tsirkin			(?:$barriers)
5617402c2553SMichael S. Tsirkin		}x;
5618402c2553SMichael S. Tsirkin		my $all_barriers = qr{
5619402c2553SMichael S. Tsirkin			(?:$barriers)|
562043e361f2SMichael S. Tsirkin			smp_(?:$barrier_stems)|
562143e361f2SMichael S. Tsirkin			virt_(?:$barrier_stems)
5622402c2553SMichael S. Tsirkin		}x;
5623402c2553SMichael S. Tsirkin
5624402c2553SMichael S. Tsirkin		if ($line =~ /\b(?:$all_barriers)\s*\(/) {
56254a0df2efSAndy Whitcroft			if (!ctx_has_comment($first_line, $linenr)) {
5626c1fd7bb9SJoe Perches				WARN("MEMORY_BARRIER",
5627000d1cc1SJoe Perches				     "memory barrier without comment\n" . $herecurr);
56284a0df2efSAndy Whitcroft			}
56294a0df2efSAndy Whitcroft		}
56303ad81779SPaul E. McKenney
5631f4073b0fSMichael S. Tsirkin		my $underscore_smp_barriers = qr{__smp_(?:$barrier_stems)}x;
5632f4073b0fSMichael S. Tsirkin
5633f4073b0fSMichael S. Tsirkin		if ($realfile !~ m@^include/asm-generic/@ &&
5634f4073b0fSMichael S. Tsirkin		    $realfile !~ m@/barrier\.h$@ &&
5635f4073b0fSMichael S. Tsirkin		    $line =~ m/\b(?:$underscore_smp_barriers)\s*\(/ &&
5636f4073b0fSMichael S. Tsirkin		    $line !~ m/^.\s*\#\s*define\s+(?:$underscore_smp_barriers)\s*\(/) {
5637f4073b0fSMichael S. Tsirkin			WARN("MEMORY_BARRIER",
5638f4073b0fSMichael S. Tsirkin			     "__smp memory barriers shouldn't be used outside barrier.h and asm-generic\n" . $herecurr);
5639f4073b0fSMichael S. Tsirkin		}
5640f4073b0fSMichael S. Tsirkin
5641cb426e99SJoe Perches# check for waitqueue_active without a comment.
5642cb426e99SJoe Perches		if ($line =~ /\bwaitqueue_active\s*\(/) {
5643cb426e99SJoe Perches			if (!ctx_has_comment($first_line, $linenr)) {
5644cb426e99SJoe Perches				WARN("WAITQUEUE_ACTIVE",
5645cb426e99SJoe Perches				     "waitqueue_active without comment\n" . $herecurr);
5646cb426e99SJoe Perches			}
5647cb426e99SJoe Perches		}
56483ad81779SPaul E. McKenney
564991db2592SPaul E. McKenney# check for smp_read_barrier_depends and read_barrier_depends
565091db2592SPaul E. McKenney		if (!$file && $line =~ /\b(smp_|)read_barrier_depends\s*\(/) {
565191db2592SPaul E. McKenney			WARN("READ_BARRIER_DEPENDS",
565291db2592SPaul E. McKenney			     "$1read_barrier_depends should only be used in READ_ONCE or DEC Alpha code\n" . $herecurr);
565391db2592SPaul E. McKenney		}
565491db2592SPaul E. McKenney
56554a0df2efSAndy Whitcroft# check of hardware specific defines
5656c45dcabdSAndy Whitcroft		if ($line =~ m@^.\s*\#\s*if.*\b(__i386__|__powerpc64__|__sun__|__s390x__)\b@ && $realfile !~ m@include/asm-@) {
5657000d1cc1SJoe Perches			CHK("ARCH_DEFINES",
5658000d1cc1SJoe Perches			    "architecture specific defines should be avoided\n" .  $herecurr);
56590a920b5bSAndy Whitcroft		}
5660653d4876SAndy Whitcroft
5661596ed45bSJoe Perches# check that the storage class is not after a type
5662596ed45bSJoe Perches		if ($line =~ /\b($Type)\s+($Storage)\b/) {
5663000d1cc1SJoe Perches			WARN("STORAGE_CLASS",
5664596ed45bSJoe Perches			     "storage class '$2' should be located before type '$1'\n" . $herecurr);
5665596ed45bSJoe Perches		}
5666596ed45bSJoe Perches# Check that the storage class is at the beginning of a declaration
5667596ed45bSJoe Perches		if ($line =~ /\b$Storage\b/ &&
5668596ed45bSJoe Perches		    $line !~ /^.\s*$Storage/ &&
5669596ed45bSJoe Perches		    $line =~ /^.\s*(.+?)\$Storage\s/ &&
5670596ed45bSJoe Perches		    $1 !~ /[\,\)]\s*$/) {
5671596ed45bSJoe Perches			WARN("STORAGE_CLASS",
5672596ed45bSJoe Perches			     "storage class should be at the beginning of the declaration\n" . $herecurr);
5673d4977c78STobias Klauser		}
5674d4977c78STobias Klauser
5675de7d4f0eSAndy Whitcroft# check the location of the inline attribute, that it is between
5676de7d4f0eSAndy Whitcroft# storage class and type.
56779c0ca6f9SAndy Whitcroft		if ($line =~ /\b$Type\s+$Inline\b/ ||
56789c0ca6f9SAndy Whitcroft		    $line =~ /\b$Inline\s+$Storage\b/) {
5679000d1cc1SJoe Perches			ERROR("INLINE_LOCATION",
5680000d1cc1SJoe Perches			      "inline keyword should sit between storage class and type\n" . $herecurr);
5681de7d4f0eSAndy Whitcroft		}
5682de7d4f0eSAndy Whitcroft
56838905a67cSAndy Whitcroft# Check for __inline__ and __inline, prefer inline
56842b7ab453SJoe Perches		if ($realfile !~ m@\binclude/uapi/@ &&
56852b7ab453SJoe Perches		    $line =~ /\b(__inline__|__inline)\b/) {
5686d5e616fcSJoe Perches			if (WARN("INLINE",
5687d5e616fcSJoe Perches				 "plain inline is preferred over $1\n" . $herecurr) &&
5688d5e616fcSJoe Perches			    $fix) {
5689194f66fcSJoe Perches				$fixed[$fixlinenr] =~ s/\b(__inline__|__inline)\b/inline/;
5690d5e616fcSJoe Perches
5691d5e616fcSJoe Perches			}
56928905a67cSAndy Whitcroft		}
56938905a67cSAndy Whitcroft
56943d130fd0SJoe Perches# Check for __attribute__ packed, prefer __packed
56952b7ab453SJoe Perches		if ($realfile !~ m@\binclude/uapi/@ &&
56962b7ab453SJoe Perches		    $line =~ /\b__attribute__\s*\(\s*\(.*\bpacked\b/) {
5697000d1cc1SJoe Perches			WARN("PREFER_PACKED",
5698000d1cc1SJoe Perches			     "__packed is preferred over __attribute__((packed))\n" . $herecurr);
56993d130fd0SJoe Perches		}
57003d130fd0SJoe Perches
570139b7e287SJoe Perches# Check for __attribute__ aligned, prefer __aligned
57022b7ab453SJoe Perches		if ($realfile !~ m@\binclude/uapi/@ &&
57032b7ab453SJoe Perches		    $line =~ /\b__attribute__\s*\(\s*\(.*aligned/) {
5704000d1cc1SJoe Perches			WARN("PREFER_ALIGNED",
5705000d1cc1SJoe Perches			     "__aligned(size) is preferred over __attribute__((aligned(size)))\n" . $herecurr);
570639b7e287SJoe Perches		}
570739b7e287SJoe Perches
57085f14d3bdSJoe Perches# Check for __attribute__ format(printf, prefer __printf
57092b7ab453SJoe Perches		if ($realfile !~ m@\binclude/uapi/@ &&
57102b7ab453SJoe Perches		    $line =~ /\b__attribute__\s*\(\s*\(\s*format\s*\(\s*printf/) {
5711d5e616fcSJoe Perches			if (WARN("PREFER_PRINTF",
5712d5e616fcSJoe Perches				 "__printf(string-index, first-to-check) is preferred over __attribute__((format(printf, string-index, first-to-check)))\n" . $herecurr) &&
5713d5e616fcSJoe Perches			    $fix) {
5714194f66fcSJoe Perches				$fixed[$fixlinenr] =~ s/\b__attribute__\s*\(\s*\(\s*format\s*\(\s*printf\s*,\s*(.*)\)\s*\)\s*\)/"__printf(" . trim($1) . ")"/ex;
5715d5e616fcSJoe Perches
5716d5e616fcSJoe Perches			}
57175f14d3bdSJoe Perches		}
57185f14d3bdSJoe Perches
57196061d949SJoe Perches# Check for __attribute__ format(scanf, prefer __scanf
57202b7ab453SJoe Perches		if ($realfile !~ m@\binclude/uapi/@ &&
57212b7ab453SJoe Perches		    $line =~ /\b__attribute__\s*\(\s*\(\s*format\s*\(\s*scanf\b/) {
5722d5e616fcSJoe Perches			if (WARN("PREFER_SCANF",
5723d5e616fcSJoe Perches				 "__scanf(string-index, first-to-check) is preferred over __attribute__((format(scanf, string-index, first-to-check)))\n" . $herecurr) &&
5724d5e616fcSJoe Perches			    $fix) {
5725194f66fcSJoe Perches				$fixed[$fixlinenr] =~ s/\b__attribute__\s*\(\s*\(\s*format\s*\(\s*scanf\s*,\s*(.*)\)\s*\)\s*\)/"__scanf(" . trim($1) . ")"/ex;
5726d5e616fcSJoe Perches			}
57276061d949SJoe Perches		}
57286061d949SJoe Perches
5729619a908aSJoe Perches# Check for __attribute__ weak, or __weak declarations (may have link issues)
5730619a908aSJoe Perches		if ($^V && $^V ge 5.10.0 &&
5731619a908aSJoe Perches		    $line =~ /(?:$Declare|$DeclareMisordered)\s*$Ident\s*$balanced_parens\s*(?:$Attribute)?\s*;/ &&
5732619a908aSJoe Perches		    ($line =~ /\b__attribute__\s*\(\s*\(.*\bweak\b/ ||
5733619a908aSJoe Perches		     $line =~ /\b__weak\b/)) {
5734619a908aSJoe Perches			ERROR("WEAK_DECLARATION",
5735619a908aSJoe Perches			      "Using weak declarations can have unintended link defects\n" . $herecurr);
5736619a908aSJoe Perches		}
5737619a908aSJoe Perches
5738fd39f904STomas Winkler# check for c99 types like uint8_t used outside of uapi/ and tools/
5739e6176fa4SJoe Perches		if ($realfile !~ m@\binclude/uapi/@ &&
5740fd39f904STomas Winkler		    $realfile !~ m@\btools/@ &&
5741e6176fa4SJoe Perches		    $line =~ /\b($Declare)\s*$Ident\s*[=;,\[]/) {
5742e6176fa4SJoe Perches			my $type = $1;
5743e6176fa4SJoe Perches			if ($type =~ /\b($typeC99Typedefs)\b/) {
5744e6176fa4SJoe Perches				$type = $1;
5745e6176fa4SJoe Perches				my $kernel_type = 'u';
5746e6176fa4SJoe Perches				$kernel_type = 's' if ($type =~ /^_*[si]/);
5747e6176fa4SJoe Perches				$type =~ /(\d+)/;
5748e6176fa4SJoe Perches				$kernel_type .= $1;
5749e6176fa4SJoe Perches				if (CHK("PREFER_KERNEL_TYPES",
5750e6176fa4SJoe Perches					"Prefer kernel type '$kernel_type' over '$type'\n" . $herecurr) &&
5751e6176fa4SJoe Perches				    $fix) {
5752e6176fa4SJoe Perches					$fixed[$fixlinenr] =~ s/\b$type\b/$kernel_type/;
5753e6176fa4SJoe Perches				}
5754e6176fa4SJoe Perches			}
5755e6176fa4SJoe Perches		}
5756e6176fa4SJoe Perches
5757938224b5SJoe Perches# check for cast of C90 native int or longer types constants
5758938224b5SJoe Perches		if ($line =~ /(\(\s*$C90_int_types\s*\)\s*)($Constant)\b/) {
5759938224b5SJoe Perches			my $cast = $1;
5760938224b5SJoe Perches			my $const = $2;
5761938224b5SJoe Perches			if (WARN("TYPECAST_INT_CONSTANT",
5762938224b5SJoe Perches				 "Unnecessary typecast of c90 int constant\n" . $herecurr) &&
5763938224b5SJoe Perches			    $fix) {
5764938224b5SJoe Perches				my $suffix = "";
5765938224b5SJoe Perches				my $newconst = $const;
5766938224b5SJoe Perches				$newconst =~ s/${Int_type}$//;
5767938224b5SJoe Perches				$suffix .= 'U' if ($cast =~ /\bunsigned\b/);
5768938224b5SJoe Perches				if ($cast =~ /\blong\s+long\b/) {
5769938224b5SJoe Perches					$suffix .= 'LL';
5770938224b5SJoe Perches				} elsif ($cast =~ /\blong\b/) {
5771938224b5SJoe Perches					$suffix .= 'L';
5772938224b5SJoe Perches				}
5773938224b5SJoe Perches				$fixed[$fixlinenr] =~ s/\Q$cast\E$const\b/$newconst$suffix/;
5774938224b5SJoe Perches			}
5775938224b5SJoe Perches		}
5776938224b5SJoe Perches
57778f53a9b8SJoe Perches# check for sizeof(&)
57788f53a9b8SJoe Perches		if ($line =~ /\bsizeof\s*\(\s*\&/) {
5779000d1cc1SJoe Perches			WARN("SIZEOF_ADDRESS",
5780000d1cc1SJoe Perches			     "sizeof(& should be avoided\n" . $herecurr);
57818f53a9b8SJoe Perches		}
57828f53a9b8SJoe Perches
578366c80b60SJoe Perches# check for sizeof without parenthesis
578466c80b60SJoe Perches		if ($line =~ /\bsizeof\s+((?:\*\s*|)$Lval|$Type(?:\s+$Lval|))/) {
5785d5e616fcSJoe Perches			if (WARN("SIZEOF_PARENTHESIS",
5786d5e616fcSJoe Perches				 "sizeof $1 should be sizeof($1)\n" . $herecurr) &&
5787d5e616fcSJoe Perches			    $fix) {
5788194f66fcSJoe Perches				$fixed[$fixlinenr] =~ s/\bsizeof\s+((?:\*\s*|)$Lval|$Type(?:\s+$Lval|))/"sizeof(" . trim($1) . ")"/ex;
5789d5e616fcSJoe Perches			}
579066c80b60SJoe Perches		}
579166c80b60SJoe Perches
579288982feaSJoe Perches# check for struct spinlock declarations
579388982feaSJoe Perches		if ($line =~ /^.\s*\bstruct\s+spinlock\s+\w+\s*;/) {
579488982feaSJoe Perches			WARN("USE_SPINLOCK_T",
579588982feaSJoe Perches			     "struct spinlock should be spinlock_t\n" . $herecurr);
579688982feaSJoe Perches		}
579788982feaSJoe Perches
5798a6962d72SJoe Perches# check for seq_printf uses that could be seq_puts
579906668727SJoe Perches		if ($sline =~ /\bseq_printf\s*\(.*"\s*\)\s*;\s*$/) {
5800a6962d72SJoe Perches			my $fmt = get_quoted_string($line, $rawline);
5801caac1d5fSHeba Aamer			$fmt =~ s/%%//g;
5802caac1d5fSHeba Aamer			if ($fmt !~ /%/) {
5803d5e616fcSJoe Perches				if (WARN("PREFER_SEQ_PUTS",
5804d5e616fcSJoe Perches					 "Prefer seq_puts to seq_printf\n" . $herecurr) &&
5805d5e616fcSJoe Perches				    $fix) {
5806194f66fcSJoe Perches					$fixed[$fixlinenr] =~ s/\bseq_printf\b/seq_puts/;
5807d5e616fcSJoe Perches				}
5808a6962d72SJoe Perches			}
5809a6962d72SJoe Perches		}
5810a6962d72SJoe Perches
58110b523769SJoe Perches# check for vsprintf extension %p<foo> misuses
58120b523769SJoe Perches		if ($^V && $^V ge 5.10.0 &&
58130b523769SJoe Perches		    defined $stat &&
58140b523769SJoe Perches		    $stat =~ /^\+(?![^\{]*\{\s*).*\b(\w+)\s*\(.*$String\s*,/s &&
58150b523769SJoe Perches		    $1 !~ /^_*volatile_*$/) {
5816e3c6bc95STobin C. Harding			my $specifier;
5817e3c6bc95STobin C. Harding			my $extension;
5818e3c6bc95STobin C. Harding			my $bad_specifier = "";
5819e3c6bc95STobin C. Harding			my $stat_real;
5820e3c6bc95STobin C. Harding
58210b523769SJoe Perches			my $lc = $stat =~ tr@\n@@;
58220b523769SJoe Perches			$lc = $lc + $linenr;
58230b523769SJoe Perches		        for (my $count = $linenr; $count <= $lc; $count++) {
58240b523769SJoe Perches				my $fmt = get_quoted_string($lines[$count - 1], raw_line($count, 0));
58250b523769SJoe Perches				$fmt =~ s/%%//g;
5826e3c6bc95STobin C. Harding
5827e3c6bc95STobin C. Harding				while ($fmt =~ /(\%[\*\d\.]*p(\w))/g) {
5828e3c6bc95STobin C. Harding					$specifier = $1;
5829e3c6bc95STobin C. Harding					$extension = $2;
5830e3c6bc95STobin C. Harding					if ($extension !~ /[SsBKRraEhMmIiUDdgVCbGNOx]/) {
5831e3c6bc95STobin C. Harding						$bad_specifier = $specifier;
58320b523769SJoe Perches						last;
58330b523769SJoe Perches					}
5834e3c6bc95STobin C. Harding					if ($extension eq "x" && !defined($stat_real)) {
5835e3c6bc95STobin C. Harding						if (!defined($stat_real)) {
5836e3c6bc95STobin C. Harding							$stat_real = get_stat_real($linenr, $lc);
58370b523769SJoe Perches						}
5838e3c6bc95STobin C. Harding						WARN("VSPRINTF_SPECIFIER_PX",
5839e3c6bc95STobin 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");
5840e3c6bc95STobin C. Harding					}
5841e3c6bc95STobin C. Harding				}
5842e3c6bc95STobin C. Harding				if ($bad_specifier ne "") {
58432a9f9d85STobin C. Harding					my $stat_real = get_stat_real($linenr, $lc);
58441df7338aSSergey Senozhatsky					my $ext_type = "Invalid";
58451df7338aSSergey Senozhatsky					my $use = "";
5846e3c6bc95STobin C. Harding					if ($bad_specifier =~ /p[Ff]/) {
58471df7338aSSergey Senozhatsky						$ext_type = "Deprecated";
58481df7338aSSergey Senozhatsky						$use = " - use %pS instead";
5849e3c6bc95STobin C. Harding						$use =~ s/pS/ps/ if ($bad_specifier =~ /pf/);
58501df7338aSSergey Senozhatsky					}
58512a9f9d85STobin C. Harding
58520b523769SJoe Perches					WARN("VSPRINTF_POINTER_EXTENSION",
5853e3c6bc95STobin C. Harding					     "$ext_type vsprintf pointer extension '$bad_specifier'$use\n" . "$here\n$stat_real\n");
5854e3c6bc95STobin C. Harding				}
58550b523769SJoe Perches			}
58560b523769SJoe Perches		}
58570b523769SJoe Perches
5858554e165cSAndy Whitcroft# Check for misused memsets
5859d1fe9c09SJoe Perches		if ($^V && $^V ge 5.10.0 &&
5860d1fe9c09SJoe Perches		    defined $stat &&
58619e20a853SMateusz Kulikowski		    $stat =~ /^\+(?:.*?)\bmemset\s*\(\s*$FuncArg\s*,\s*$FuncArg\s*\,\s*$FuncArg\s*\)/) {
5862554e165cSAndy Whitcroft
5863d7c76ba7SJoe Perches			my $ms_addr = $2;
5864d1fe9c09SJoe Perches			my $ms_val = $7;
5865d1fe9c09SJoe Perches			my $ms_size = $12;
5866d7c76ba7SJoe Perches
5867554e165cSAndy Whitcroft			if ($ms_size =~ /^(0x|)0$/i) {
5868554e165cSAndy Whitcroft				ERROR("MEMSET",
5869d7c76ba7SJoe Perches				      "memset to 0's uses 0 as the 2nd argument, not the 3rd\n" . "$here\n$stat\n");
5870554e165cSAndy Whitcroft			} elsif ($ms_size =~ /^(0x|)1$/i) {
5871554e165cSAndy Whitcroft				WARN("MEMSET",
5872d7c76ba7SJoe Perches				     "single byte memset is suspicious. Swapped 2nd/3rd argument?\n" . "$here\n$stat\n");
5873d7c76ba7SJoe Perches			}
5874d7c76ba7SJoe Perches		}
5875d7c76ba7SJoe Perches
587698a9bba5SJoe Perches# Check for memcpy(foo, bar, ETH_ALEN) that could be ether_addr_copy(foo, bar)
5877f333195dSJoe Perches#		if ($^V && $^V ge 5.10.0 &&
5878f333195dSJoe Perches#		    defined $stat &&
5879f333195dSJoe Perches#		    $stat =~ /^\+(?:.*?)\bmemcpy\s*\(\s*$FuncArg\s*,\s*$FuncArg\s*\,\s*ETH_ALEN\s*\)/) {
5880f333195dSJoe Perches#			if (WARN("PREFER_ETHER_ADDR_COPY",
5881f333195dSJoe Perches#				 "Prefer ether_addr_copy() over memcpy() if the Ethernet addresses are __aligned(2)\n" . "$here\n$stat\n") &&
5882f333195dSJoe Perches#			    $fix) {
5883f333195dSJoe Perches#				$fixed[$fixlinenr] =~ s/\bmemcpy\s*\(\s*$FuncArg\s*,\s*$FuncArg\s*\,\s*ETH_ALEN\s*\)/ether_addr_copy($2, $7)/;
5884f333195dSJoe Perches#			}
5885f333195dSJoe Perches#		}
588698a9bba5SJoe Perches
5887b6117d17SMateusz Kulikowski# Check for memcmp(foo, bar, ETH_ALEN) that could be ether_addr_equal*(foo, bar)
5888f333195dSJoe Perches#		if ($^V && $^V ge 5.10.0 &&
5889f333195dSJoe Perches#		    defined $stat &&
5890f333195dSJoe Perches#		    $stat =~ /^\+(?:.*?)\bmemcmp\s*\(\s*$FuncArg\s*,\s*$FuncArg\s*\,\s*ETH_ALEN\s*\)/) {
5891f333195dSJoe Perches#			WARN("PREFER_ETHER_ADDR_EQUAL",
5892f333195dSJoe Perches#			     "Prefer ether_addr_equal() or ether_addr_equal_unaligned() over memcmp()\n" . "$here\n$stat\n")
5893f333195dSJoe Perches#		}
5894b6117d17SMateusz Kulikowski
58958617cd09SMateusz Kulikowski# check for memset(foo, 0x0, ETH_ALEN) that could be eth_zero_addr
58968617cd09SMateusz Kulikowski# check for memset(foo, 0xFF, ETH_ALEN) that could be eth_broadcast_addr
5897f333195dSJoe Perches#		if ($^V && $^V ge 5.10.0 &&
5898f333195dSJoe Perches#		    defined $stat &&
5899f333195dSJoe Perches#		    $stat =~ /^\+(?:.*?)\bmemset\s*\(\s*$FuncArg\s*,\s*$FuncArg\s*\,\s*ETH_ALEN\s*\)/) {
5900f333195dSJoe Perches#
5901f333195dSJoe Perches#			my $ms_val = $7;
5902f333195dSJoe Perches#
5903f333195dSJoe Perches#			if ($ms_val =~ /^(?:0x|)0+$/i) {
5904f333195dSJoe Perches#				if (WARN("PREFER_ETH_ZERO_ADDR",
5905f333195dSJoe Perches#					 "Prefer eth_zero_addr over memset()\n" . "$here\n$stat\n") &&
5906f333195dSJoe Perches#				    $fix) {
5907f333195dSJoe Perches#					$fixed[$fixlinenr] =~ s/\bmemset\s*\(\s*$FuncArg\s*,\s*$FuncArg\s*,\s*ETH_ALEN\s*\)/eth_zero_addr($2)/;
5908f333195dSJoe Perches#				}
5909f333195dSJoe Perches#			} elsif ($ms_val =~ /^(?:0xff|255)$/i) {
5910f333195dSJoe Perches#				if (WARN("PREFER_ETH_BROADCAST_ADDR",
5911f333195dSJoe Perches#					 "Prefer eth_broadcast_addr() over memset()\n" . "$here\n$stat\n") &&
5912f333195dSJoe Perches#				    $fix) {
5913f333195dSJoe Perches#					$fixed[$fixlinenr] =~ s/\bmemset\s*\(\s*$FuncArg\s*,\s*$FuncArg\s*,\s*ETH_ALEN\s*\)/eth_broadcast_addr($2)/;
5914f333195dSJoe Perches#				}
5915f333195dSJoe Perches#			}
5916f333195dSJoe Perches#		}
59178617cd09SMateusz Kulikowski
5918d7c76ba7SJoe Perches# typecasts on min/max could be min_t/max_t
5919d1fe9c09SJoe Perches		if ($^V && $^V ge 5.10.0 &&
5920d1fe9c09SJoe Perches		    defined $stat &&
5921d7c76ba7SJoe Perches		    $stat =~ /^\+(?:.*?)\b(min|max)\s*\(\s*$FuncArg\s*,\s*$FuncArg\s*\)/) {
5922d1fe9c09SJoe Perches			if (defined $2 || defined $7) {
5923d7c76ba7SJoe Perches				my $call = $1;
5924d7c76ba7SJoe Perches				my $cast1 = deparenthesize($2);
5925d7c76ba7SJoe Perches				my $arg1 = $3;
5926d1fe9c09SJoe Perches				my $cast2 = deparenthesize($7);
5927d1fe9c09SJoe Perches				my $arg2 = $8;
5928d7c76ba7SJoe Perches				my $cast;
5929d7c76ba7SJoe Perches
5930d1fe9c09SJoe Perches				if ($cast1 ne "" && $cast2 ne "" && $cast1 ne $cast2) {
5931d7c76ba7SJoe Perches					$cast = "$cast1 or $cast2";
5932d7c76ba7SJoe Perches				} elsif ($cast1 ne "") {
5933d7c76ba7SJoe Perches					$cast = $cast1;
5934d7c76ba7SJoe Perches				} else {
5935d7c76ba7SJoe Perches					$cast = $cast2;
5936d7c76ba7SJoe Perches				}
5937d7c76ba7SJoe Perches				WARN("MINMAX",
5938d7c76ba7SJoe Perches				     "$call() should probably be ${call}_t($cast, $arg1, $arg2)\n" . "$here\n$stat\n");
5939554e165cSAndy Whitcroft			}
5940554e165cSAndy Whitcroft		}
5941554e165cSAndy Whitcroft
59424a273195SJoe Perches# check usleep_range arguments
59434a273195SJoe Perches		if ($^V && $^V ge 5.10.0 &&
59444a273195SJoe Perches		    defined $stat &&
59454a273195SJoe Perches		    $stat =~ /^\+(?:.*?)\busleep_range\s*\(\s*($FuncArg)\s*,\s*($FuncArg)\s*\)/) {
59464a273195SJoe Perches			my $min = $1;
59474a273195SJoe Perches			my $max = $7;
59484a273195SJoe Perches			if ($min eq $max) {
59494a273195SJoe Perches				WARN("USLEEP_RANGE",
59504a273195SJoe Perches				     "usleep_range should not use min == max args; see Documentation/timers/timers-howto.txt\n" . "$here\n$stat\n");
59514a273195SJoe Perches			} elsif ($min =~ /^\d+$/ && $max =~ /^\d+$/ &&
59524a273195SJoe Perches				 $min > $max) {
59534a273195SJoe Perches				WARN("USLEEP_RANGE",
59544a273195SJoe Perches				     "usleep_range args reversed, use min then max; see Documentation/timers/timers-howto.txt\n" . "$here\n$stat\n");
59554a273195SJoe Perches			}
59564a273195SJoe Perches		}
59574a273195SJoe Perches
5958823b794cSJoe Perches# check for naked sscanf
5959823b794cSJoe Perches		if ($^V && $^V ge 5.10.0 &&
5960823b794cSJoe Perches		    defined $stat &&
59616c8bd707SJoe Perches		    $line =~ /\bsscanf\b/ &&
5962823b794cSJoe Perches		    ($stat !~ /$Ident\s*=\s*sscanf\s*$balanced_parens/ &&
5963823b794cSJoe Perches		     $stat !~ /\bsscanf\s*$balanced_parens\s*(?:$Compare)/ &&
5964823b794cSJoe Perches		     $stat !~ /(?:$Compare)\s*\bsscanf\s*$balanced_parens/)) {
5965823b794cSJoe Perches			my $lc = $stat =~ tr@\n@@;
5966823b794cSJoe Perches			$lc = $lc + $linenr;
59672a9f9d85STobin C. Harding			my $stat_real = get_stat_real($linenr, $lc);
5968823b794cSJoe Perches			WARN("NAKED_SSCANF",
5969823b794cSJoe Perches			     "unchecked sscanf return value\n" . "$here\n$stat_real\n");
5970823b794cSJoe Perches		}
5971823b794cSJoe Perches
5972afc819abSJoe Perches# check for simple sscanf that should be kstrto<foo>
5973afc819abSJoe Perches		if ($^V && $^V ge 5.10.0 &&
5974afc819abSJoe Perches		    defined $stat &&
5975afc819abSJoe Perches		    $line =~ /\bsscanf\b/) {
5976afc819abSJoe Perches			my $lc = $stat =~ tr@\n@@;
5977afc819abSJoe Perches			$lc = $lc + $linenr;
59782a9f9d85STobin C. Harding			my $stat_real = get_stat_real($linenr, $lc);
5979afc819abSJoe Perches			if ($stat_real =~ /\bsscanf\b\s*\(\s*$FuncArg\s*,\s*("[^"]+")/) {
5980afc819abSJoe Perches				my $format = $6;
5981afc819abSJoe Perches				my $count = $format =~ tr@%@%@;
5982afc819abSJoe Perches				if ($count == 1 &&
5983afc819abSJoe Perches				    $format =~ /^"\%(?i:ll[udxi]|[udxi]ll|ll|[hl]h?[udxi]|[udxi][hl]h?|[hl]h?|[udxi])"$/) {
5984afc819abSJoe Perches					WARN("SSCANF_TO_KSTRTO",
5985afc819abSJoe Perches					     "Prefer kstrto<type> to single variable sscanf\n" . "$here\n$stat_real\n");
5986afc819abSJoe Perches				}
5987afc819abSJoe Perches			}
5988afc819abSJoe Perches		}
5989afc819abSJoe Perches
599070dc8a48SJoe Perches# check for new externs in .h files.
599170dc8a48SJoe Perches		if ($realfile =~ /\.h$/ &&
599270dc8a48SJoe Perches		    $line =~ /^\+\s*(extern\s+)$Type\s*$Ident\s*\(/s) {
5993d1d85780SJoe Perches			if (CHK("AVOID_EXTERNS",
599470dc8a48SJoe Perches				"extern prototypes should be avoided in .h files\n" . $herecurr) &&
599570dc8a48SJoe Perches			    $fix) {
5996194f66fcSJoe Perches				$fixed[$fixlinenr] =~ s/(.*)\bextern\b\s*(.*)/$1$2/;
599770dc8a48SJoe Perches			}
599870dc8a48SJoe Perches		}
599970dc8a48SJoe Perches
6000de7d4f0eSAndy Whitcroft# check for new externs in .c files.
6001171ae1a4SAndy Whitcroft		if ($realfile =~ /\.c$/ && defined $stat &&
6002c45dcabdSAndy Whitcroft		    $stat =~ /^.\s*(?:extern\s+)?$Type\s+($Ident)(\s*)\(/s)
6003171ae1a4SAndy Whitcroft		{
6004c45dcabdSAndy Whitcroft			my $function_name = $1;
6005c45dcabdSAndy Whitcroft			my $paren_space = $2;
6006171ae1a4SAndy Whitcroft
6007171ae1a4SAndy Whitcroft			my $s = $stat;
6008171ae1a4SAndy Whitcroft			if (defined $cond) {
6009171ae1a4SAndy Whitcroft				substr($s, 0, length($cond), '');
6010171ae1a4SAndy Whitcroft			}
6011c45dcabdSAndy Whitcroft			if ($s =~ /^\s*;/ &&
6012c45dcabdSAndy Whitcroft			    $function_name ne 'uninitialized_var')
6013c45dcabdSAndy Whitcroft			{
6014000d1cc1SJoe Perches				WARN("AVOID_EXTERNS",
6015000d1cc1SJoe Perches				     "externs should be avoided in .c files\n" .  $herecurr);
6016de7d4f0eSAndy Whitcroft			}
6017de7d4f0eSAndy Whitcroft
6018171ae1a4SAndy Whitcroft			if ($paren_space =~ /\n/) {
6019000d1cc1SJoe Perches				WARN("FUNCTION_ARGUMENTS",
6020000d1cc1SJoe Perches				     "arguments for function declarations should follow identifier\n" . $herecurr);
6021171ae1a4SAndy Whitcroft			}
60229c9ba34eSAndy Whitcroft
60239c9ba34eSAndy Whitcroft		} elsif ($realfile =~ /\.c$/ && defined $stat &&
60249c9ba34eSAndy Whitcroft		    $stat =~ /^.\s*extern\s+/)
60259c9ba34eSAndy Whitcroft		{
6026000d1cc1SJoe Perches			WARN("AVOID_EXTERNS",
6027000d1cc1SJoe Perches			     "externs should be avoided in .c files\n" .  $herecurr);
6028171ae1a4SAndy Whitcroft		}
6029171ae1a4SAndy Whitcroft
6030a0ad7596SJoe Perches# check for function declarations that have arguments without identifier names
6031a0ad7596SJoe Perches		if (defined $stat &&
603225bdda2bSMiles Chen		    $stat =~ /^.\s*(?:extern\s+)?$Type\s*(?:$Ident|\(\s*\*\s*$Ident\s*\))\s*\(\s*([^{]+)\s*\)\s*;/s &&
6033ca0d8929SJoe Perches		    $1 ne "void") {
6034ca0d8929SJoe Perches			my $args = trim($1);
6035ca0d8929SJoe Perches			while ($args =~ m/\s*($Type\s*(?:$Ident|\(\s*\*\s*$Ident?\s*\)\s*$balanced_parens)?)/g) {
6036ca0d8929SJoe Perches				my $arg = trim($1);
6037ca0d8929SJoe Perches				if ($arg =~ /^$Type$/ && $arg !~ /enum\s+$Ident$/) {
6038ca0d8929SJoe Perches					WARN("FUNCTION_ARGUMENTS",
6039ca0d8929SJoe Perches					     "function definition argument '$arg' should also have an identifier name\n" . $herecurr);
6040ca0d8929SJoe Perches				}
6041ca0d8929SJoe Perches			}
6042ca0d8929SJoe Perches		}
6043ca0d8929SJoe Perches
6044a0ad7596SJoe Perches# check for function definitions
6045a0ad7596SJoe Perches		if ($^V && $^V ge 5.10.0 &&
6046a0ad7596SJoe Perches		    defined $stat &&
6047a0ad7596SJoe Perches		    $stat =~ /^.\s*(?:$Storage\s+)?$Type\s*($Ident)\s*$balanced_parens\s*{/s) {
6048a0ad7596SJoe Perches			$context_function = $1;
6049a0ad7596SJoe Perches
6050a0ad7596SJoe Perches# check for multiline function definition with misplaced open brace
6051a0ad7596SJoe Perches			my $ok = 0;
6052a0ad7596SJoe Perches			my $cnt = statement_rawlines($stat);
6053a0ad7596SJoe Perches			my $herectx = $here . "\n";
6054a0ad7596SJoe Perches			for (my $n = 0; $n < $cnt; $n++) {
6055a0ad7596SJoe Perches				my $rl = raw_line($linenr, $n);
6056a0ad7596SJoe Perches				$herectx .=  $rl . "\n";
6057a0ad7596SJoe Perches				$ok = 1 if ($rl =~ /^[ \+]\{/);
6058a0ad7596SJoe Perches				$ok = 1 if ($rl =~ /\{/ && $n == 0);
6059a0ad7596SJoe Perches				last if $rl =~ /^[ \+].*\{/;
6060a0ad7596SJoe Perches			}
6061a0ad7596SJoe Perches			if (!$ok) {
6062a0ad7596SJoe Perches				ERROR("OPEN_BRACE",
6063a0ad7596SJoe Perches				      "open brace '{' following function definitions go on the next line\n" . $herectx);
6064a0ad7596SJoe Perches			}
6065a0ad7596SJoe Perches		}
6066a0ad7596SJoe Perches
6067de7d4f0eSAndy Whitcroft# checks for new __setup's
6068de7d4f0eSAndy Whitcroft		if ($rawline =~ /\b__setup\("([^"]*)"/) {
6069de7d4f0eSAndy Whitcroft			my $name = $1;
6070de7d4f0eSAndy Whitcroft
6071de7d4f0eSAndy Whitcroft			if (!grep(/$name/, @setup_docs)) {
6072000d1cc1SJoe Perches				CHK("UNDOCUMENTED_SETUP",
60738c27ceffSMauro Carvalho Chehab				    "__setup appears un-documented -- check Documentation/admin-guide/kernel-parameters.rst\n" . $herecurr);
6074de7d4f0eSAndy Whitcroft			}
6075653d4876SAndy Whitcroft		}
60769c0ca6f9SAndy Whitcroft
60779c0ca6f9SAndy Whitcroft# check for pointless casting of kmalloc return
6078caf2a54fSJoe Perches		if ($line =~ /\*\s*\)\s*[kv][czm]alloc(_node){0,1}\b/) {
6079000d1cc1SJoe Perches			WARN("UNNECESSARY_CASTS",
6080000d1cc1SJoe Perches			     "unnecessary cast may hide bugs, see http://c-faq.com/malloc/mallocnocast.html\n" . $herecurr);
60819c0ca6f9SAndy Whitcroft		}
608213214adfSAndy Whitcroft
6083a640d25cSJoe Perches# alloc style
6084a640d25cSJoe Perches# p = alloc(sizeof(struct foo), ...) should be p = alloc(sizeof(*p), ...)
6085a640d25cSJoe Perches		if ($^V && $^V ge 5.10.0 &&
6086a640d25cSJoe Perches		    $line =~ /\b($Lval)\s*\=\s*(?:$balanced_parens)?\s*([kv][mz]alloc(?:_node)?)\s*\(\s*(sizeof\s*\(\s*struct\s+$Lval\s*\))/) {
6087a640d25cSJoe Perches			CHK("ALLOC_SIZEOF_STRUCT",
6088a640d25cSJoe Perches			    "Prefer $3(sizeof(*$1)...) over $3($4...)\n" . $herecurr);
6089a640d25cSJoe Perches		}
6090a640d25cSJoe Perches
609160a55369SJoe Perches# check for k[mz]alloc with multiplies that could be kmalloc_array/kcalloc
609260a55369SJoe Perches		if ($^V && $^V ge 5.10.0 &&
60931b4a2ed4SJoe Perches		    defined $stat &&
60941b4a2ed4SJoe Perches		    $stat =~ /^\+\s*($Lval)\s*\=\s*(?:$balanced_parens)?\s*(k[mz]alloc)\s*\(\s*($FuncArg)\s*\*\s*($FuncArg)\s*,/) {
609560a55369SJoe Perches			my $oldfunc = $3;
609660a55369SJoe Perches			my $a1 = $4;
609760a55369SJoe Perches			my $a2 = $10;
609860a55369SJoe Perches			my $newfunc = "kmalloc_array";
609960a55369SJoe Perches			$newfunc = "kcalloc" if ($oldfunc eq "kzalloc");
610060a55369SJoe Perches			my $r1 = $a1;
610160a55369SJoe Perches			my $r2 = $a2;
610260a55369SJoe Perches			if ($a1 =~ /^sizeof\s*\S/) {
610360a55369SJoe Perches				$r1 = $a2;
610460a55369SJoe Perches				$r2 = $a1;
610560a55369SJoe Perches			}
6106e367455aSJoe Perches			if ($r1 !~ /^sizeof\b/ && $r2 =~ /^sizeof\s*\S/ &&
6107e367455aSJoe Perches			    !($r1 =~ /^$Constant$/ || $r1 =~ /^[A-Z_][A-Z0-9_]*$/)) {
61081b4a2ed4SJoe Perches				my $cnt = statement_rawlines($stat);
6109e3d95a2aSTobin C. Harding				my $herectx = get_stat_here($linenr, $cnt, $here);
6110e3d95a2aSTobin C. Harding
6111e367455aSJoe Perches				if (WARN("ALLOC_WITH_MULTIPLY",
61121b4a2ed4SJoe Perches					 "Prefer $newfunc over $oldfunc with multiply\n" . $herectx) &&
61131b4a2ed4SJoe Perches				    $cnt == 1 &&
6114e367455aSJoe Perches				    $fix) {
6115194f66fcSJoe 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;
611660a55369SJoe Perches				}
611760a55369SJoe Perches			}
611860a55369SJoe Perches		}
611960a55369SJoe Perches
6120972fdea2SJoe Perches# check for krealloc arg reuse
6121972fdea2SJoe Perches		if ($^V && $^V ge 5.10.0 &&
6122972fdea2SJoe Perches		    $line =~ /\b($Lval)\s*\=\s*(?:$balanced_parens)?\s*krealloc\s*\(\s*\1\s*,/) {
6123972fdea2SJoe Perches			WARN("KREALLOC_ARG_REUSE",
6124972fdea2SJoe Perches			     "Reusing the krealloc arg is almost always a bug\n" . $herecurr);
6125972fdea2SJoe Perches		}
6126972fdea2SJoe Perches
61275ce59ae0SJoe Perches# check for alloc argument mismatch
61285ce59ae0SJoe Perches		if ($line =~ /\b(kcalloc|kmalloc_array)\s*\(\s*sizeof\b/) {
61295ce59ae0SJoe Perches			WARN("ALLOC_ARRAY_ARGS",
61305ce59ae0SJoe Perches			     "$1 uses number as first arg, sizeof is generally wrong\n" . $herecurr);
61315ce59ae0SJoe Perches		}
61325ce59ae0SJoe Perches
6133caf2a54fSJoe Perches# check for multiple semicolons
6134caf2a54fSJoe Perches		if ($line =~ /;\s*;\s*$/) {
6135d5e616fcSJoe Perches			if (WARN("ONE_SEMICOLON",
6136d5e616fcSJoe Perches				 "Statements terminations use 1 semicolon\n" . $herecurr) &&
6137d5e616fcSJoe Perches			    $fix) {
6138194f66fcSJoe Perches				$fixed[$fixlinenr] =~ s/(\s*;\s*){2,}$/;/g;
6139d5e616fcSJoe Perches			}
6140d1e2ad07SJoe Perches		}
6141d1e2ad07SJoe Perches
6142cec3aaa5STomas Winkler# check for #defines like: 1 << <digit> that could be BIT(digit), it is not exported to uapi
6143cec3aaa5STomas Winkler		if ($realfile !~ m@^include/uapi/@ &&
6144cec3aaa5STomas Winkler		    $line =~ /#\s*define\s+\w+\s+\(?\s*1\s*([ulUL]*)\s*\<\<\s*(?:\d+|$Ident)\s*\)?/) {
61450ab90191SJoe Perches			my $ull = "";
61460ab90191SJoe Perches			$ull = "_ULL" if (defined($1) && $1 =~ /ll/i);
61470ab90191SJoe Perches			if (CHK("BIT_MACRO",
61480ab90191SJoe Perches				"Prefer using the BIT$ull macro\n" . $herecurr) &&
61490ab90191SJoe Perches			    $fix) {
61500ab90191SJoe Perches				$fixed[$fixlinenr] =~ s/\(?\s*1\s*[ulUL]*\s*<<\s*(\d+|$Ident)\s*\)?/BIT${ull}($1)/;
61510ab90191SJoe Perches			}
61520ab90191SJoe Perches		}
61530ab90191SJoe Perches
61542d632745SJoe Perches# check for #if defined CONFIG_<FOO> || defined CONFIG_<FOO>_MODULE
61552d632745SJoe Perches		if ($line =~ /^\+\s*#\s*if\s+defined(?:\s*\(?\s*|\s+)(CONFIG_[A-Z_]+)\s*\)?\s*\|\|\s*defined(?:\s*\(?\s*|\s+)\1_MODULE\s*\)?\s*$/) {
61562d632745SJoe Perches			my $config = $1;
61572d632745SJoe Perches			if (WARN("PREFER_IS_ENABLED",
61582d632745SJoe Perches				 "Prefer IS_ENABLED(<FOO>) to CONFIG_<FOO> || CONFIG_<FOO>_MODULE\n" . $herecurr) &&
61592d632745SJoe Perches			    $fix) {
61602d632745SJoe Perches				$fixed[$fixlinenr] = "\+#if IS_ENABLED($config)";
61612d632745SJoe Perches			}
61622d632745SJoe Perches		}
61632d632745SJoe Perches
6164e81f239bSJoe Perches# check for case / default statements not preceded by break/fallthrough/switch
6165c34c09a8SJoe Perches		if ($line =~ /^.\s*(?:case\s+(?:$Ident|$Constant)\s*|default):/) {
6166c34c09a8SJoe Perches			my $has_break = 0;
6167c34c09a8SJoe Perches			my $has_statement = 0;
6168c34c09a8SJoe Perches			my $count = 0;
6169c34c09a8SJoe Perches			my $prevline = $linenr;
6170e81f239bSJoe Perches			while ($prevline > 1 && ($file || $count < 3) && !$has_break) {
6171c34c09a8SJoe Perches				$prevline--;
6172c34c09a8SJoe Perches				my $rline = $rawlines[$prevline - 1];
6173c34c09a8SJoe Perches				my $fline = $lines[$prevline - 1];
6174c34c09a8SJoe Perches				last if ($fline =~ /^\@\@/);
6175c34c09a8SJoe Perches				next if ($fline =~ /^\-/);
6176c34c09a8SJoe Perches				next if ($fline =~ /^.(?:\s*(?:case\s+(?:$Ident|$Constant)[\s$;]*|default):[\s$;]*)*$/);
6177c34c09a8SJoe Perches				$has_break = 1 if ($rline =~ /fall[\s_-]*(through|thru)/i);
6178c34c09a8SJoe Perches				next if ($fline =~ /^.[\s$;]*$/);
6179c34c09a8SJoe Perches				$has_statement = 1;
6180c34c09a8SJoe Perches				$count++;
6181258f79d5SHeinrich Schuchardt				$has_break = 1 if ($fline =~ /\bswitch\b|\b(?:break\s*;[\s$;]*$|exit\s*\(\b|return\b|goto\b|continue\b)/);
6182c34c09a8SJoe Perches			}
6183c34c09a8SJoe Perches			if (!$has_break && $has_statement) {
6184c34c09a8SJoe Perches				WARN("MISSING_BREAK",
6185224236d9SAndrew Morton				     "Possible switch case/default not preceded by break or fallthrough comment\n" . $herecurr);
6186c34c09a8SJoe Perches			}
6187c34c09a8SJoe Perches		}
6188c34c09a8SJoe Perches
6189d1e2ad07SJoe Perches# check for switch/default statements without a break;
6190d1e2ad07SJoe Perches		if ($^V && $^V ge 5.10.0 &&
6191d1e2ad07SJoe Perches		    defined $stat &&
6192d1e2ad07SJoe Perches		    $stat =~ /^\+[$;\s]*(?:case[$;\s]+\w+[$;\s]*:[$;\s]*|)*[$;\s]*\bdefault[$;\s]*:[$;\s]*;/g) {
6193d1e2ad07SJoe Perches			my $cnt = statement_rawlines($stat);
6194e3d95a2aSTobin C. Harding			my $herectx = get_stat_here($linenr, $cnt, $here);
6195e3d95a2aSTobin C. Harding
6196d1e2ad07SJoe Perches			WARN("DEFAULT_NO_BREAK",
6197d1e2ad07SJoe Perches			     "switch default: should use break\n" . $herectx);
6198caf2a54fSJoe Perches		}
6199caf2a54fSJoe Perches
620013214adfSAndy Whitcroft# check for gcc specific __FUNCTION__
6201d5e616fcSJoe Perches		if ($line =~ /\b__FUNCTION__\b/) {
6202d5e616fcSJoe Perches			if (WARN("USE_FUNC",
6203d5e616fcSJoe Perches				 "__func__ should be used instead of gcc specific __FUNCTION__\n"  . $herecurr) &&
6204d5e616fcSJoe Perches			    $fix) {
6205194f66fcSJoe Perches				$fixed[$fixlinenr] =~ s/\b__FUNCTION__\b/__func__/g;
6206d5e616fcSJoe Perches			}
620713214adfSAndy Whitcroft		}
6208773647a0SAndy Whitcroft
620962ec818fSJoe Perches# check for uses of __DATE__, __TIME__, __TIMESTAMP__
621062ec818fSJoe Perches		while ($line =~ /\b(__(?:DATE|TIME|TIMESTAMP)__)\b/g) {
621162ec818fSJoe Perches			ERROR("DATE_TIME",
621262ec818fSJoe Perches			      "Use of the '$1' macro makes the build non-deterministic\n" . $herecurr);
621362ec818fSJoe Perches		}
621462ec818fSJoe Perches
62152c92488aSJoe Perches# check for use of yield()
62162c92488aSJoe Perches		if ($line =~ /\byield\s*\(\s*\)/) {
62172c92488aSJoe Perches			WARN("YIELD",
62182c92488aSJoe Perches			     "Using yield() is generally wrong. See yield() kernel-doc (sched/core.c)\n"  . $herecurr);
62192c92488aSJoe Perches		}
62202c92488aSJoe Perches
6221179f8f40SJoe Perches# check for comparisons against true and false
6222179f8f40SJoe Perches		if ($line =~ /\+\s*(.*?)\b(true|false|$Lval)\s*(==|\!=)\s*(true|false|$Lval)\b(.*)$/i) {
6223179f8f40SJoe Perches			my $lead = $1;
6224179f8f40SJoe Perches			my $arg = $2;
6225179f8f40SJoe Perches			my $test = $3;
6226179f8f40SJoe Perches			my $otype = $4;
6227179f8f40SJoe Perches			my $trail = $5;
6228179f8f40SJoe Perches			my $op = "!";
6229179f8f40SJoe Perches
6230179f8f40SJoe Perches			($arg, $otype) = ($otype, $arg) if ($arg =~ /^(?:true|false)$/i);
6231179f8f40SJoe Perches
6232179f8f40SJoe Perches			my $type = lc($otype);
6233179f8f40SJoe Perches			if ($type =~ /^(?:true|false)$/) {
6234179f8f40SJoe Perches				if (("$test" eq "==" && "$type" eq "true") ||
6235179f8f40SJoe Perches				    ("$test" eq "!=" && "$type" eq "false")) {
6236179f8f40SJoe Perches					$op = "";
6237179f8f40SJoe Perches				}
6238179f8f40SJoe Perches
6239179f8f40SJoe Perches				CHK("BOOL_COMPARISON",
6240179f8f40SJoe Perches				    "Using comparison to $otype is error prone\n" . $herecurr);
6241179f8f40SJoe Perches
6242179f8f40SJoe Perches## maybe suggesting a correct construct would better
6243179f8f40SJoe Perches##				    "Using comparison to $otype is error prone.  Perhaps use '${lead}${op}${arg}${trail}'\n" . $herecurr);
6244179f8f40SJoe Perches
6245179f8f40SJoe Perches			}
6246179f8f40SJoe Perches		}
6247179f8f40SJoe Perches
62484882720bSThomas Gleixner# check for semaphores initialized locked
62494882720bSThomas Gleixner		if ($line =~ /^.\s*sema_init.+,\W?0\W?\)/) {
6250000d1cc1SJoe Perches			WARN("CONSIDER_COMPLETION",
6251000d1cc1SJoe Perches			     "consider using a completion\n" . $herecurr);
6252773647a0SAndy Whitcroft		}
62536712d858SJoe Perches
625467d0a075SJoe Perches# recommend kstrto* over simple_strto* and strict_strto*
625567d0a075SJoe Perches		if ($line =~ /\b((simple|strict)_(strto(l|ll|ul|ull)))\s*\(/) {
6256000d1cc1SJoe Perches			WARN("CONSIDER_KSTRTO",
625767d0a075SJoe Perches			     "$1 is obsolete, use k$3 instead\n" . $herecurr);
6258773647a0SAndy Whitcroft		}
62596712d858SJoe Perches
6260ae3ccc46SFabian Frederick# check for __initcall(), use device_initcall() explicitly or more appropriate function please
6261f3db6639SMichael Ellerman		if ($line =~ /^.\s*__initcall\s*\(/) {
6262000d1cc1SJoe Perches			WARN("USE_DEVICE_INITCALL",
6263ae3ccc46SFabian Frederick			     "please use device_initcall() or more appropriate function instead of __initcall() (see include/linux/init.h)\n" . $herecurr);
6264f3db6639SMichael Ellerman		}
62656712d858SJoe Perches
62660f3c5aabSJoe Perches# check for various structs that are normally const (ops, kgdb, device_tree)
6267d9190e4eSJoe Perches# and avoid what seem like struct definitions 'struct foo {'
62686903ffb2SAndy Whitcroft		if ($line !~ /\bconst\b/ &&
6269d9190e4eSJoe Perches		    $line =~ /\bstruct\s+($const_structs)\b(?!\s*\{)/) {
6270000d1cc1SJoe Perches			WARN("CONST_STRUCT",
6271d9190e4eSJoe Perches			     "struct $1 should normally be const\n" . $herecurr);
62722b6db5cbSAndy Whitcroft		}
6273773647a0SAndy Whitcroft
6274773647a0SAndy Whitcroft# use of NR_CPUS is usually wrong
6275773647a0SAndy Whitcroft# ignore definitions of NR_CPUS and usage to define arrays as likely right
6276773647a0SAndy Whitcroft		if ($line =~ /\bNR_CPUS\b/ &&
6277c45dcabdSAndy Whitcroft		    $line !~ /^.\s*\s*#\s*if\b.*\bNR_CPUS\b/ &&
6278c45dcabdSAndy Whitcroft		    $line !~ /^.\s*\s*#\s*define\b.*\bNR_CPUS\b/ &&
6279171ae1a4SAndy Whitcroft		    $line !~ /^.\s*$Declare\s.*\[[^\]]*NR_CPUS[^\]]*\]/ &&
6280171ae1a4SAndy Whitcroft		    $line !~ /\[[^\]]*\.\.\.[^\]]*NR_CPUS[^\]]*\]/ &&
6281171ae1a4SAndy Whitcroft		    $line !~ /\[[^\]]*NR_CPUS[^\]]*\.\.\.[^\]]*\]/)
6282773647a0SAndy Whitcroft		{
6283000d1cc1SJoe Perches			WARN("NR_CPUS",
6284000d1cc1SJoe Perches			     "usage of NR_CPUS is often wrong - consider using cpu_possible(), num_possible_cpus(), for_each_possible_cpu(), etc\n" . $herecurr);
6285773647a0SAndy Whitcroft		}
62869c9ba34eSAndy Whitcroft
628752ea8506SJoe Perches# Use of __ARCH_HAS_<FOO> or ARCH_HAVE_<BAR> is wrong.
628852ea8506SJoe Perches		if ($line =~ /\+\s*#\s*define\s+((?:__)?ARCH_(?:HAS|HAVE)\w*)\b/) {
628952ea8506SJoe Perches			ERROR("DEFINE_ARCH_HAS",
629052ea8506SJoe Perches			      "#define of '$1' is wrong - use Kconfig variables or standard guards instead\n" . $herecurr);
629152ea8506SJoe Perches		}
629252ea8506SJoe Perches
6293acd9362cSJoe Perches# likely/unlikely comparisons similar to "(likely(foo) > 0)"
6294acd9362cSJoe Perches		if ($^V && $^V ge 5.10.0 &&
6295acd9362cSJoe Perches		    $line =~ /\b((?:un)?likely)\s*\(\s*$FuncArg\s*\)\s*$Compare/) {
6296acd9362cSJoe Perches			WARN("LIKELY_MISUSE",
6297acd9362cSJoe Perches			     "Using $1 should generally have parentheses around the comparison\n" . $herecurr);
6298acd9362cSJoe Perches		}
6299acd9362cSJoe Perches
6300691d77b6SAndy Whitcroft# whine mightly about in_atomic
6301691d77b6SAndy Whitcroft		if ($line =~ /\bin_atomic\s*\(/) {
6302691d77b6SAndy Whitcroft			if ($realfile =~ m@^drivers/@) {
6303000d1cc1SJoe Perches				ERROR("IN_ATOMIC",
6304000d1cc1SJoe Perches				      "do not use in_atomic in drivers\n" . $herecurr);
6305f4a87736SAndy Whitcroft			} elsif ($realfile !~ m@^kernel/@) {
6306000d1cc1SJoe Perches				WARN("IN_ATOMIC",
6307000d1cc1SJoe Perches				     "use of in_atomic() is incorrect outside core kernel code\n" . $herecurr);
6308691d77b6SAndy Whitcroft			}
6309691d77b6SAndy Whitcroft		}
63101704f47bSPeter Zijlstra
63110f5225b0SPeter Zijlstra# check for mutex_trylock_recursive usage
63120f5225b0SPeter Zijlstra		if ($line =~ /mutex_trylock_recursive/) {
63130f5225b0SPeter Zijlstra			ERROR("LOCKING",
63140f5225b0SPeter Zijlstra			      "recursive locking is bad, do not use this ever.\n" . $herecurr);
63150f5225b0SPeter Zijlstra		}
63160f5225b0SPeter Zijlstra
63171704f47bSPeter Zijlstra# check for lockdep_set_novalidate_class
63181704f47bSPeter Zijlstra		if ($line =~ /^.\s*lockdep_set_novalidate_class\s*\(/ ||
63191704f47bSPeter Zijlstra		    $line =~ /__lockdep_no_validate__\s*\)/ ) {
63201704f47bSPeter Zijlstra			if ($realfile !~ m@^kernel/lockdep@ &&
63211704f47bSPeter Zijlstra			    $realfile !~ m@^include/linux/lockdep@ &&
63221704f47bSPeter Zijlstra			    $realfile !~ m@^drivers/base/core@) {
6323000d1cc1SJoe Perches				ERROR("LOCKDEP",
6324000d1cc1SJoe Perches				      "lockdep_no_validate class is reserved for device->mutex.\n" . $herecurr);
63251704f47bSPeter Zijlstra			}
63261704f47bSPeter Zijlstra		}
632788f8831cSDave Jones
6328b392c64fSJoe Perches		if ($line =~ /debugfs_create_\w+.*\b$mode_perms_world_writable\b/ ||
6329b392c64fSJoe Perches		    $line =~ /DEVICE_ATTR.*\b$mode_perms_world_writable\b/) {
6330000d1cc1SJoe Perches			WARN("EXPORTED_WORLD_WRITABLE",
6331000d1cc1SJoe Perches			     "Exporting world writable files is usually an error. Consider more restrictive permissions.\n" . $herecurr);
633288f8831cSDave Jones		}
63332435880fSJoe Perches
633400180468SJoe Perches# check for DEVICE_ATTR uses that could be DEVICE_ATTR_<FOO>
633500180468SJoe Perches# and whether or not function naming is typical and if
633600180468SJoe Perches# DEVICE_ATTR permissions uses are unusual too
633700180468SJoe Perches		if ($^V && $^V ge 5.10.0 &&
633800180468SJoe Perches		    defined $stat &&
633900180468SJoe 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*\)/) {
634000180468SJoe Perches			my $var = $1;
634100180468SJoe Perches			my $perms = $2;
634200180468SJoe Perches			my $show = $3;
634300180468SJoe Perches			my $store = $4;
634400180468SJoe Perches			my $octal_perms = perms_to_octal($perms);
634500180468SJoe Perches			if ($show =~ /^${var}_show$/ &&
634600180468SJoe Perches			    $store =~ /^${var}_store$/ &&
634700180468SJoe Perches			    $octal_perms eq "0644") {
634800180468SJoe Perches				if (WARN("DEVICE_ATTR_RW",
634900180468SJoe Perches					 "Use DEVICE_ATTR_RW\n" . $herecurr) &&
635000180468SJoe Perches				    $fix) {
635100180468SJoe 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})/;
635200180468SJoe Perches				}
635300180468SJoe Perches			} elsif ($show =~ /^${var}_show$/ &&
635400180468SJoe Perches				 $store =~ /^NULL$/ &&
635500180468SJoe Perches				 $octal_perms eq "0444") {
635600180468SJoe Perches				if (WARN("DEVICE_ATTR_RO",
635700180468SJoe Perches					 "Use DEVICE_ATTR_RO\n" . $herecurr) &&
635800180468SJoe Perches				    $fix) {
635900180468SJoe 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})/;
636000180468SJoe Perches				}
636100180468SJoe Perches			} elsif ($show =~ /^NULL$/ &&
636200180468SJoe Perches				 $store =~ /^${var}_store$/ &&
636300180468SJoe Perches				 $octal_perms eq "0200") {
636400180468SJoe Perches				if (WARN("DEVICE_ATTR_WO",
636500180468SJoe Perches					 "Use DEVICE_ATTR_WO\n" . $herecurr) &&
636600180468SJoe Perches				    $fix) {
636700180468SJoe 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})/;
636800180468SJoe Perches				}
636900180468SJoe Perches			} elsif ($octal_perms eq "0644" ||
637000180468SJoe Perches				 $octal_perms eq "0444" ||
637100180468SJoe Perches				 $octal_perms eq "0200") {
637200180468SJoe Perches				my $newshow = "$show";
637300180468SJoe Perches				$newshow = "${var}_show" if ($show ne "NULL" && $show ne "${var}_show");
637400180468SJoe Perches				my $newstore = $store;
637500180468SJoe Perches				$newstore = "${var}_store" if ($store ne "NULL" && $store ne "${var}_store");
637600180468SJoe Perches				my $rename = "";
637700180468SJoe Perches				if ($show ne $newshow) {
637800180468SJoe Perches					$rename .= " '$show' to '$newshow'";
637900180468SJoe Perches				}
638000180468SJoe Perches				if ($store ne $newstore) {
638100180468SJoe Perches					$rename .= " '$store' to '$newstore'";
638200180468SJoe Perches				}
638300180468SJoe Perches				WARN("DEVICE_ATTR_FUNCTIONS",
638400180468SJoe Perches				     "Consider renaming function(s)$rename\n" . $herecurr);
638500180468SJoe Perches			} else {
638600180468SJoe Perches				WARN("DEVICE_ATTR_PERMS",
638700180468SJoe Perches				     "DEVICE_ATTR unusual permissions '$perms' used\n" . $herecurr);
638800180468SJoe Perches			}
638900180468SJoe Perches		}
639000180468SJoe Perches
6391515a235eSJoe Perches# Mode permission misuses where it seems decimal should be octal
6392515a235eSJoe Perches# This uses a shortcut match to avoid unnecessary uses of a slow foreach loop
639373121534SJoe Perches# o Ignore module_param*(...) uses with a decimal 0 permission as that has a
639473121534SJoe Perches#   specific definition of not visible in sysfs.
639573121534SJoe Perches# o Ignore proc_create*(...) uses with a decimal 0 permission as that means
639673121534SJoe Perches#   use the default permissions
6397515a235eSJoe Perches		if ($^V && $^V ge 5.10.0 &&
6398459cf0aeSJoe Perches		    defined $stat &&
6399515a235eSJoe Perches		    $line =~ /$mode_perms_search/) {
64002435880fSJoe Perches			foreach my $entry (@mode_permission_funcs) {
64012435880fSJoe Perches				my $func = $entry->[0];
64022435880fSJoe Perches				my $arg_pos = $entry->[1];
64032435880fSJoe Perches
6404459cf0aeSJoe Perches				my $lc = $stat =~ tr@\n@@;
6405459cf0aeSJoe Perches				$lc = $lc + $linenr;
64062a9f9d85STobin C. Harding				my $stat_real = get_stat_real($linenr, $lc);
6407459cf0aeSJoe Perches
64082435880fSJoe Perches				my $skip_args = "";
64092435880fSJoe Perches				if ($arg_pos > 1) {
64102435880fSJoe Perches					$arg_pos--;
64112435880fSJoe Perches					$skip_args = "(?:\\s*$FuncArg\\s*,\\s*){$arg_pos,$arg_pos}";
64122435880fSJoe Perches				}
6413f90774e1SJoe Perches				my $test = "\\b$func\\s*\\(${skip_args}($FuncArg(?:\\|\\s*$FuncArg)*)\\s*[,\\)]";
6414459cf0aeSJoe Perches				if ($stat =~ /$test/) {
64152435880fSJoe Perches					my $val = $1;
64162435880fSJoe Perches					$val = $6 if ($skip_args ne "");
641773121534SJoe Perches					if (!($func =~ /^(?:module_param|proc_create)/ && $val eq "0") &&
641873121534SJoe Perches					    (($val =~ /^$Int$/ && $val !~ /^$Octal$/) ||
641973121534SJoe Perches					     ($val =~ /^$Octal$/ && length($val) ne 4))) {
64202435880fSJoe Perches						ERROR("NON_OCTAL_PERMISSIONS",
6421459cf0aeSJoe Perches						      "Use 4 digit octal (0777) not decimal permissions\n" . "$here\n" . $stat_real);
6422f90774e1SJoe Perches					}
6423f90774e1SJoe Perches					if ($val =~ /^$Octal$/ && (oct($val) & 02)) {
6424c0a5c898SJoe Perches						ERROR("EXPORTED_WORLD_WRITABLE",
6425459cf0aeSJoe Perches						      "Exporting writable files is usually an error. Consider more restrictive permissions.\n" . "$here\n" . $stat_real);
64262435880fSJoe Perches					}
6427459cf0aeSJoe Perches				}
6428459cf0aeSJoe Perches			}
6429459cf0aeSJoe Perches		}
6430459cf0aeSJoe Perches
6431459cf0aeSJoe Perches# check for uses of S_<PERMS> that could be octal for readability
643200180468SJoe Perches		if ($line =~ /\b($multi_mode_perms_string_search)\b/) {
643300180468SJoe Perches			my $oval = $1;
643400180468SJoe Perches			my $octal = perms_to_octal($oval);
6435f90774e1SJoe Perches			if (WARN("SYMBOLIC_PERMS",
6436459cf0aeSJoe Perches				 "Symbolic permissions '$oval' are not preferred. Consider using octal permissions '$octal'.\n" . $herecurr) &&
6437f90774e1SJoe Perches			    $fix) {
643800180468SJoe Perches				$fixed[$fixlinenr] =~ s/\Q$oval\E/$octal/;
64392435880fSJoe Perches			}
644013214adfSAndy Whitcroft		}
64415a6d20ceSBjorn Andersson
64425a6d20ceSBjorn Andersson# validate content of MODULE_LICENSE against list from include/linux/module.h
64435a6d20ceSBjorn Andersson		if ($line =~ /\bMODULE_LICENSE\s*\(\s*($String)\s*\)/) {
64445a6d20ceSBjorn Andersson			my $extracted_string = get_quoted_string($line, $rawline);
64455a6d20ceSBjorn Andersson			my $valid_licenses = qr{
64465a6d20ceSBjorn Andersson						GPL|
64475a6d20ceSBjorn Andersson						GPL\ v2|
64485a6d20ceSBjorn Andersson						GPL\ and\ additional\ rights|
64495a6d20ceSBjorn Andersson						Dual\ BSD/GPL|
64505a6d20ceSBjorn Andersson						Dual\ MIT/GPL|
64515a6d20ceSBjorn Andersson						Dual\ MPL/GPL|
64525a6d20ceSBjorn Andersson						Proprietary
64535a6d20ceSBjorn Andersson					}x;
64545a6d20ceSBjorn Andersson			if ($extracted_string !~ /^"(?:$valid_licenses)"$/x) {
64555a6d20ceSBjorn Andersson				WARN("MODULE_LICENSE",
64565a6d20ceSBjorn Andersson				     "unknown module license " . $extracted_string . "\n" . $herecurr);
64575a6d20ceSBjorn Andersson			}
64585a6d20ceSBjorn Andersson		}
6459515a235eSJoe Perches	}
646013214adfSAndy Whitcroft
646113214adfSAndy Whitcroft	# If we have no input at all, then there is nothing to report on
646213214adfSAndy Whitcroft	# so just keep quiet.
646313214adfSAndy Whitcroft	if ($#rawlines == -1) {
646413214adfSAndy Whitcroft		exit(0);
64650a920b5bSAndy Whitcroft	}
64660a920b5bSAndy Whitcroft
64678905a67cSAndy Whitcroft	# In mailback mode only produce a report in the negative, for
64688905a67cSAndy Whitcroft	# things that appear to be patches.
64698905a67cSAndy Whitcroft	if ($mailback && ($clean == 1 || !$is_patch)) {
64708905a67cSAndy Whitcroft		exit(0);
64718905a67cSAndy Whitcroft	}
64728905a67cSAndy Whitcroft
64738905a67cSAndy Whitcroft	# This is not a patch, and we are are in 'no-patch' mode so
64748905a67cSAndy Whitcroft	# just keep quiet.
64758905a67cSAndy Whitcroft	if (!$chk_patch && !$is_patch) {
64768905a67cSAndy Whitcroft		exit(0);
64778905a67cSAndy Whitcroft	}
64788905a67cSAndy Whitcroft
6479a08ffbefSStafford Horne	if (!$is_patch && $filename !~ /cover-letter\.patch$/) {
6480000d1cc1SJoe Perches		ERROR("NOT_UNIFIED_DIFF",
6481000d1cc1SJoe Perches		      "Does not appear to be a unified-diff format patch\n");
64820a920b5bSAndy Whitcroft	}
6483ed43c4e5SAllen Hubbe	if ($is_patch && $has_commit_log && $chk_signoff && $signoff == 0) {
6484000d1cc1SJoe Perches		ERROR("MISSING_SIGN_OFF",
6485000d1cc1SJoe Perches		      "Missing Signed-off-by: line(s)\n");
64860a920b5bSAndy Whitcroft	}
64870a920b5bSAndy Whitcroft
6488f0a594c1SAndy Whitcroft	print report_dump();
648913214adfSAndy Whitcroft	if ($summary && !($clean == 1 && $quiet == 1)) {
649013214adfSAndy Whitcroft		print "$filename " if ($summary_file);
64916c72ffaaSAndy Whitcroft		print "total: $cnt_error errors, $cnt_warn warnings, " .
64926c72ffaaSAndy Whitcroft			(($check)? "$cnt_chk checks, " : "") .
64936c72ffaaSAndy Whitcroft			"$cnt_lines lines checked\n";
64946c72ffaaSAndy Whitcroft	}
64958905a67cSAndy Whitcroft
6496d2c0a235SAndy Whitcroft	if ($quiet == 0) {
6497ef212196SJoe Perches		# If there were any defects found and not already fixing them
6498ef212196SJoe Perches		if (!$clean and !$fix) {
6499ef212196SJoe Perches			print << "EOM"
6500ef212196SJoe Perches
6501ef212196SJoe PerchesNOTE: For some of the reported defects, checkpatch may be able to
6502ef212196SJoe Perches      mechanically convert to the typical style using --fix or --fix-inplace.
6503ef212196SJoe PerchesEOM
6504ef212196SJoe Perches		}
6505d2c0a235SAndy Whitcroft		# If there were whitespace errors which cleanpatch can fix
6506d2c0a235SAndy Whitcroft		# then suggest that.
6507d2c0a235SAndy Whitcroft		if ($rpt_cleaners) {
6508b0781216SMike Frysinger			$rpt_cleaners = 0;
6509d8469f16SJoe Perches			print << "EOM"
6510d8469f16SJoe Perches
6511d8469f16SJoe PerchesNOTE: Whitespace errors detected.
6512d8469f16SJoe Perches      You may wish to use scripts/cleanpatch or scripts/cleanfile
6513d8469f16SJoe PerchesEOM
6514d2c0a235SAndy Whitcroft		}
6515d2c0a235SAndy Whitcroft	}
6516d2c0a235SAndy Whitcroft
6517d752fcc8SJoe Perches	if ($clean == 0 && $fix &&
6518d752fcc8SJoe Perches	    ("@rawlines" ne "@fixed" ||
6519d752fcc8SJoe Perches	     $#fixed_inserted >= 0 || $#fixed_deleted >= 0)) {
65209624b8d6SJoe Perches		my $newfile = $filename;
65219624b8d6SJoe Perches		$newfile .= ".EXPERIMENTAL-checkpatch-fixes" if (!$fix_inplace);
65223705ce5bSJoe Perches		my $linecount = 0;
65233705ce5bSJoe Perches		my $f;
65243705ce5bSJoe Perches
6525d752fcc8SJoe Perches		@fixed = fix_inserted_deleted_lines(\@fixed, \@fixed_inserted, \@fixed_deleted);
6526d752fcc8SJoe Perches
65273705ce5bSJoe Perches		open($f, '>', $newfile)
65283705ce5bSJoe Perches		    or die "$P: Can't open $newfile for write\n";
65293705ce5bSJoe Perches		foreach my $fixed_line (@fixed) {
65303705ce5bSJoe Perches			$linecount++;
65313705ce5bSJoe Perches			if ($file) {
65323705ce5bSJoe Perches				if ($linecount > 3) {
65333705ce5bSJoe Perches					$fixed_line =~ s/^\+//;
65343705ce5bSJoe Perches					print $f $fixed_line . "\n";
65353705ce5bSJoe Perches				}
65363705ce5bSJoe Perches			} else {
65373705ce5bSJoe Perches				print $f $fixed_line . "\n";
65383705ce5bSJoe Perches			}
65393705ce5bSJoe Perches		}
65403705ce5bSJoe Perches		close($f);
65413705ce5bSJoe Perches
65423705ce5bSJoe Perches		if (!$quiet) {
65433705ce5bSJoe Perches			print << "EOM";
6544d8469f16SJoe Perches
65453705ce5bSJoe PerchesWrote EXPERIMENTAL --fix correction(s) to '$newfile'
65463705ce5bSJoe Perches
65473705ce5bSJoe PerchesDo _NOT_ trust the results written to this file.
65483705ce5bSJoe PerchesDo _NOT_ submit these changes without inspecting them for correctness.
65493705ce5bSJoe Perches
65503705ce5bSJoe PerchesThis EXPERIMENTAL file is simply a convenience to help rewrite patches.
65513705ce5bSJoe PerchesNo warranties, expressed or implied...
65523705ce5bSJoe PerchesEOM
65533705ce5bSJoe Perches		}
65543705ce5bSJoe Perches	}
65553705ce5bSJoe Perches
6556d8469f16SJoe Perches	if ($quiet == 0) {
6557d8469f16SJoe Perches		print "\n";
6558d8469f16SJoe Perches		if ($clean == 1) {
6559d8469f16SJoe Perches			print "$vname has no obvious style problems and is ready for submission.\n";
6560d8469f16SJoe Perches		} else {
6561d8469f16SJoe Perches			print "$vname has style problems, please review.\n";
65620a920b5bSAndy Whitcroft		}
65630a920b5bSAndy Whitcroft	}
65640a920b5bSAndy Whitcroft	return $clean;
65650a920b5bSAndy Whitcroft}
6566