cachepc-linux

Fork of AMDESE/linux with modifications for CachePC side-channel attack
git clone https://git.sinitax.com/sinitax/cachepc-linux
Log | Files | Refs | README | LICENSE | sfeed.txt

checkpatch.pl (231042B)


      1#!/usr/bin/env perl
      2# SPDX-License-Identifier: GPL-2.0
      3#
      4# (c) 2001, Dave Jones. (the file handling bit)
      5# (c) 2005, Joel Schopp <jschopp@austin.ibm.com> (the ugly bit)
      6# (c) 2007,2008, Andy Whitcroft <apw@uk.ibm.com> (new conditions, test suite)
      7# (c) 2008-2010 Andy Whitcroft <apw@canonical.com>
      8# (c) 2010-2018 Joe Perches <joe@perches.com>
      9
     10use strict;
     11use warnings;
     12use POSIX;
     13use File::Basename;
     14use Cwd 'abs_path';
     15use Term::ANSIColor qw(:constants);
     16use Encode qw(decode encode);
     17
     18my $P = $0;
     19my $D = dirname(abs_path($P));
     20
     21my $V = '0.32';
     22
     23use Getopt::Long qw(:config no_auto_abbrev);
     24
     25my $quiet = 0;
     26my $verbose = 0;
     27my %verbose_messages = ();
     28my %verbose_emitted = ();
     29my $tree = 1;
     30my $chk_signoff = 1;
     31my $chk_patch = 1;
     32my $tst_only;
     33my $emacs = 0;
     34my $terse = 0;
     35my $showfile = 0;
     36my $file = 0;
     37my $git = 0;
     38my %git_commits = ();
     39my $check = 0;
     40my $check_orig = 0;
     41my $summary = 1;
     42my $mailback = 0;
     43my $summary_file = 0;
     44my $show_types = 0;
     45my $list_types = 0;
     46my $fix = 0;
     47my $fix_inplace = 0;
     48my $root;
     49my $gitroot = $ENV{'GIT_DIR'};
     50$gitroot = ".git" if !defined($gitroot);
     51my %debug;
     52my %camelcase = ();
     53my %use_type = ();
     54my @use = ();
     55my %ignore_type = ();
     56my @ignore = ();
     57my $help = 0;
     58my $configuration_file = ".checkpatch.conf";
     59my $max_line_length = 100;
     60my $ignore_perl_version = 0;
     61my $minimum_perl_version = 5.10.0;
     62my $min_conf_desc_length = 4;
     63my $spelling_file = "$D/spelling.txt";
     64my $codespell = 0;
     65my $codespellfile = "/usr/share/codespell/dictionary.txt";
     66my $user_codespellfile = "";
     67my $conststructsfile = "$D/const_structs.checkpatch";
     68my $docsfile = "$D/../Documentation/dev-tools/checkpatch.rst";
     69my $typedefsfile;
     70my $color = "auto";
     71my $allow_c99_comments = 1; # Can be overridden by --ignore C99_COMMENT_TOLERANCE
     72# git output parsing needs US English output, so first set backtick child process LANGUAGE
     73my $git_command ='export LANGUAGE=en_US.UTF-8; git';
     74my $tabsize = 8;
     75my ${CONFIG_} = "CONFIG_";
     76
     77sub help {
     78	my ($exitcode) = @_;
     79
     80	print << "EOM";
     81Usage: $P [OPTION]... [FILE]...
     82Version: $V
     83
     84Options:
     85  -q, --quiet                quiet
     86  -v, --verbose              verbose mode
     87  --no-tree                  run without a kernel tree
     88  --no-signoff               do not check for 'Signed-off-by' line
     89  --patch                    treat FILE as patchfile (default)
     90  --emacs                    emacs compile window format
     91  --terse                    one line per report
     92  --showfile                 emit diffed file position, not input file position
     93  -g, --git                  treat FILE as a single commit or git revision range
     94                             single git commit with:
     95                               <rev>
     96                               <rev>^
     97                               <rev>~n
     98                             multiple git commits with:
     99                               <rev1>..<rev2>
    100                               <rev1>...<rev2>
    101                               <rev>-<count>
    102                             git merges are ignored
    103  -f, --file                 treat FILE as regular source file
    104  --subjective, --strict     enable more subjective tests
    105  --list-types               list the possible message types
    106  --types TYPE(,TYPE2...)    show only these comma separated message types
    107  --ignore TYPE(,TYPE2...)   ignore various comma separated message types
    108  --show-types               show the specific message type in the output
    109  --max-line-length=n        set the maximum line length, (default $max_line_length)
    110                             if exceeded, warn on patches
    111                             requires --strict for use with --file
    112  --min-conf-desc-length=n   set the min description length, if shorter, warn
    113  --tab-size=n               set the number of spaces for tab (default $tabsize)
    114  --root=PATH                PATH to the kernel tree root
    115  --no-summary               suppress the per-file summary
    116  --mailback                 only produce a report in case of warnings/errors
    117  --summary-file             include the filename in summary
    118  --debug KEY=[0|1]          turn on/off debugging of KEY, where KEY is one of
    119                             'values', 'possible', 'type', and 'attr' (default
    120                             is all off)
    121  --test-only=WORD           report only warnings/errors containing WORD
    122                             literally
    123  --fix                      EXPERIMENTAL - may create horrible results
    124                             If correctable single-line errors exist, create
    125                             "<inputfile>.EXPERIMENTAL-checkpatch-fixes"
    126                             with potential errors corrected to the preferred
    127                             checkpatch style
    128  --fix-inplace              EXPERIMENTAL - may create horrible results
    129                             Is the same as --fix, but overwrites the input
    130                             file.  It's your fault if there's no backup or git
    131  --ignore-perl-version      override checking of perl version.  expect
    132                             runtime errors.
    133  --codespell                Use the codespell dictionary for spelling/typos
    134                             (default:$codespellfile)
    135  --codespellfile            Use this codespell dictionary
    136  --typedefsfile             Read additional types from this file
    137  --color[=WHEN]             Use colors 'always', 'never', or only when output
    138                             is a terminal ('auto'). Default is 'auto'.
    139  --kconfig-prefix=WORD      use WORD as a prefix for Kconfig symbols (default
    140                             ${CONFIG_})
    141  -h, --help, --version      display this help and exit
    142
    143When FILE is - read standard input.
    144EOM
    145
    146	exit($exitcode);
    147}
    148
    149sub uniq {
    150	my %seen;
    151	return grep { !$seen{$_}++ } @_;
    152}
    153
    154sub list_types {
    155	my ($exitcode) = @_;
    156
    157	my $count = 0;
    158
    159	local $/ = undef;
    160
    161	open(my $script, '<', abs_path($P)) or
    162	    die "$P: Can't read '$P' $!\n";
    163
    164	my $text = <$script>;
    165	close($script);
    166
    167	my %types = ();
    168	# Also catch when type or level is passed through a variable
    169	while ($text =~ /(?:(\bCHK|\bWARN|\bERROR|&\{\$msg_level})\s*\(|\$msg_type\s*=)\s*"([^"]+)"/g) {
    170		if (defined($1)) {
    171			if (exists($types{$2})) {
    172				$types{$2} .= ",$1" if ($types{$2} ne $1);
    173			} else {
    174				$types{$2} = $1;
    175			}
    176		} else {
    177			$types{$2} = "UNDETERMINED";
    178		}
    179	}
    180
    181	print("#\tMessage type\n\n");
    182	if ($color) {
    183		print(" ( Color coding: ");
    184		print(RED . "ERROR" . RESET);
    185		print(" | ");
    186		print(YELLOW . "WARNING" . RESET);
    187		print(" | ");
    188		print(GREEN . "CHECK" . RESET);
    189		print(" | ");
    190		print("Multiple levels / Undetermined");
    191		print(" )\n\n");
    192	}
    193
    194	foreach my $type (sort keys %types) {
    195		my $orig_type = $type;
    196		if ($color) {
    197			my $level = $types{$type};
    198			if ($level eq "ERROR") {
    199				$type = RED . $type . RESET;
    200			} elsif ($level eq "WARN") {
    201				$type = YELLOW . $type . RESET;
    202			} elsif ($level eq "CHK") {
    203				$type = GREEN . $type . RESET;
    204			}
    205		}
    206		print(++$count . "\t" . $type . "\n");
    207		if ($verbose && exists($verbose_messages{$orig_type})) {
    208			my $message = $verbose_messages{$orig_type};
    209			$message =~ s/\n/\n\t/g;
    210			print("\t" . $message . "\n\n");
    211		}
    212	}
    213
    214	exit($exitcode);
    215}
    216
    217my $conf = which_conf($configuration_file);
    218if (-f $conf) {
    219	my @conf_args;
    220	open(my $conffile, '<', "$conf")
    221	    or warn "$P: Can't find a readable $configuration_file file $!\n";
    222
    223	while (<$conffile>) {
    224		my $line = $_;
    225
    226		$line =~ s/\s*\n?$//g;
    227		$line =~ s/^\s*//g;
    228		$line =~ s/\s+/ /g;
    229
    230		next if ($line =~ m/^\s*#/);
    231		next if ($line =~ m/^\s*$/);
    232
    233		my @words = split(" ", $line);
    234		foreach my $word (@words) {
    235			last if ($word =~ m/^#/);
    236			push (@conf_args, $word);
    237		}
    238	}
    239	close($conffile);
    240	unshift(@ARGV, @conf_args) if @conf_args;
    241}
    242
    243sub load_docs {
    244	open(my $docs, '<', "$docsfile")
    245	    or warn "$P: Can't read the documentation file $docsfile $!\n";
    246
    247	my $type = '';
    248	my $desc = '';
    249	my $in_desc = 0;
    250
    251	while (<$docs>) {
    252		chomp;
    253		my $line = $_;
    254		$line =~ s/\s+$//;
    255
    256		if ($line =~ /^\s*\*\*(.+)\*\*$/) {
    257			if ($desc ne '') {
    258				$verbose_messages{$type} = trim($desc);
    259			}
    260			$type = $1;
    261			$desc = '';
    262			$in_desc = 1;
    263		} elsif ($in_desc) {
    264			if ($line =~ /^(?:\s{4,}|$)/) {
    265				$line =~ s/^\s{4}//;
    266				$desc .= $line;
    267				$desc .= "\n";
    268			} else {
    269				$verbose_messages{$type} = trim($desc);
    270				$type = '';
    271				$desc = '';
    272				$in_desc = 0;
    273			}
    274		}
    275	}
    276
    277	if ($desc ne '') {
    278		$verbose_messages{$type} = trim($desc);
    279	}
    280	close($docs);
    281}
    282
    283# Perl's Getopt::Long allows options to take optional arguments after a space.
    284# Prevent --color by itself from consuming other arguments
    285foreach (@ARGV) {
    286	if ($_ eq "--color" || $_ eq "-color") {
    287		$_ = "--color=$color";
    288	}
    289}
    290
    291GetOptions(
    292	'q|quiet+'	=> \$quiet,
    293	'v|verbose!'	=> \$verbose,
    294	'tree!'		=> \$tree,
    295	'signoff!'	=> \$chk_signoff,
    296	'patch!'	=> \$chk_patch,
    297	'emacs!'	=> \$emacs,
    298	'terse!'	=> \$terse,
    299	'showfile!'	=> \$showfile,
    300	'f|file!'	=> \$file,
    301	'g|git!'	=> \$git,
    302	'subjective!'	=> \$check,
    303	'strict!'	=> \$check,
    304	'ignore=s'	=> \@ignore,
    305	'types=s'	=> \@use,
    306	'show-types!'	=> \$show_types,
    307	'list-types!'	=> \$list_types,
    308	'max-line-length=i' => \$max_line_length,
    309	'min-conf-desc-length=i' => \$min_conf_desc_length,
    310	'tab-size=i'	=> \$tabsize,
    311	'root=s'	=> \$root,
    312	'summary!'	=> \$summary,
    313	'mailback!'	=> \$mailback,
    314	'summary-file!'	=> \$summary_file,
    315	'fix!'		=> \$fix,
    316	'fix-inplace!'	=> \$fix_inplace,
    317	'ignore-perl-version!' => \$ignore_perl_version,
    318	'debug=s'	=> \%debug,
    319	'test-only=s'	=> \$tst_only,
    320	'codespell!'	=> \$codespell,
    321	'codespellfile=s'	=> \$user_codespellfile,
    322	'typedefsfile=s'	=> \$typedefsfile,
    323	'color=s'	=> \$color,
    324	'no-color'	=> \$color,	#keep old behaviors of -nocolor
    325	'nocolor'	=> \$color,	#keep old behaviors of -nocolor
    326	'kconfig-prefix=s'	=> \${CONFIG_},
    327	'h|help'	=> \$help,
    328	'version'	=> \$help
    329) or $help = 2;
    330
    331if ($user_codespellfile) {
    332	# Use the user provided codespell file unconditionally
    333	$codespellfile = $user_codespellfile;
    334} elsif (!(-f $codespellfile)) {
    335	# If /usr/share/codespell/dictionary.txt is not present, try to find it
    336	# under codespell's install directory: <codespell_root>/data/dictionary.txt
    337	if (($codespell || $help) && which("python3") ne "") {
    338		my $python_codespell_dict = << "EOF";
    339
    340import os.path as op
    341import codespell_lib
    342codespell_dir = op.dirname(codespell_lib.__file__)
    343codespell_file = op.join(codespell_dir, 'data', 'dictionary.txt')
    344print(codespell_file, end='')
    345EOF
    346
    347		my $codespell_dict = `python3 -c "$python_codespell_dict" 2> /dev/null`;
    348		$codespellfile = $codespell_dict if (-f $codespell_dict);
    349	}
    350}
    351
    352# $help is 1 if either -h, --help or --version is passed as option - exitcode: 0
    353# $help is 2 if invalid option is passed - exitcode: 1
    354help($help - 1) if ($help);
    355
    356die "$P: --git cannot be used with --file or --fix\n" if ($git && ($file || $fix));
    357die "$P: --verbose cannot be used with --terse\n" if ($verbose && $terse);
    358
    359if ($color =~ /^[01]$/) {
    360	$color = !$color;
    361} elsif ($color =~ /^always$/i) {
    362	$color = 1;
    363} elsif ($color =~ /^never$/i) {
    364	$color = 0;
    365} elsif ($color =~ /^auto$/i) {
    366	$color = (-t STDOUT);
    367} else {
    368	die "$P: Invalid color mode: $color\n";
    369}
    370
    371load_docs() if ($verbose);
    372list_types(0) if ($list_types);
    373
    374$fix = 1 if ($fix_inplace);
    375$check_orig = $check;
    376
    377my $exit = 0;
    378
    379my $perl_version_ok = 1;
    380if ($^V && $^V lt $minimum_perl_version) {
    381	$perl_version_ok = 0;
    382	printf "$P: requires at least perl version %vd\n", $minimum_perl_version;
    383	exit(1) if (!$ignore_perl_version);
    384}
    385
    386#if no filenames are given, push '-' to read patch from stdin
    387if ($#ARGV < 0) {
    388	push(@ARGV, '-');
    389}
    390
    391# skip TAB size 1 to avoid additional checks on $tabsize - 1
    392die "$P: Invalid TAB size: $tabsize\n" if ($tabsize < 2);
    393
    394sub hash_save_array_words {
    395	my ($hashRef, $arrayRef) = @_;
    396
    397	my @array = split(/,/, join(',', @$arrayRef));
    398	foreach my $word (@array) {
    399		$word =~ s/\s*\n?$//g;
    400		$word =~ s/^\s*//g;
    401		$word =~ s/\s+/ /g;
    402		$word =~ tr/[a-z]/[A-Z]/;
    403
    404		next if ($word =~ m/^\s*#/);
    405		next if ($word =~ m/^\s*$/);
    406
    407		$hashRef->{$word}++;
    408	}
    409}
    410
    411sub hash_show_words {
    412	my ($hashRef, $prefix) = @_;
    413
    414	if (keys %$hashRef) {
    415		print "\nNOTE: $prefix message types:";
    416		foreach my $word (sort keys %$hashRef) {
    417			print " $word";
    418		}
    419		print "\n";
    420	}
    421}
    422
    423hash_save_array_words(\%ignore_type, \@ignore);
    424hash_save_array_words(\%use_type, \@use);
    425
    426my $dbg_values = 0;
    427my $dbg_possible = 0;
    428my $dbg_type = 0;
    429my $dbg_attr = 0;
    430for my $key (keys %debug) {
    431	## no critic
    432	eval "\${dbg_$key} = '$debug{$key}';";
    433	die "$@" if ($@);
    434}
    435
    436my $rpt_cleaners = 0;
    437
    438if ($terse) {
    439	$emacs = 1;
    440	$quiet++;
    441}
    442
    443if ($tree) {
    444	if (defined $root) {
    445		if (!top_of_kernel_tree($root)) {
    446			die "$P: $root: --root does not point at a valid tree\n";
    447		}
    448	} else {
    449		if (top_of_kernel_tree('.')) {
    450			$root = '.';
    451		} elsif ($0 =~ m@(.*)/scripts/[^/]*$@ &&
    452						top_of_kernel_tree($1)) {
    453			$root = $1;
    454		}
    455	}
    456
    457	if (!defined $root) {
    458		print "Must be run from the top-level dir. of a kernel tree\n";
    459		exit(2);
    460	}
    461}
    462
    463my $emitted_corrupt = 0;
    464
    465our $Ident	= qr{
    466			[A-Za-z_][A-Za-z\d_]*
    467			(?:\s*\#\#\s*[A-Za-z_][A-Za-z\d_]*)*
    468		}x;
    469our $Storage	= qr{extern|static|asmlinkage};
    470our $Sparse	= qr{
    471			__user|
    472			__kernel|
    473			__force|
    474			__iomem|
    475			__must_check|
    476			__kprobes|
    477			__ref|
    478			__refconst|
    479			__refdata|
    480			__rcu|
    481			__private
    482		}x;
    483our $InitAttributePrefix = qr{__(?:mem|cpu|dev|net_|)};
    484our $InitAttributeData = qr{$InitAttributePrefix(?:initdata\b)};
    485our $InitAttributeConst = qr{$InitAttributePrefix(?:initconst\b)};
    486our $InitAttributeInit = qr{$InitAttributePrefix(?:init\b)};
    487our $InitAttribute = qr{$InitAttributeData|$InitAttributeConst|$InitAttributeInit};
    488
    489# Notes to $Attribute:
    490# We need \b after 'init' otherwise 'initconst' will cause a false positive in a check
    491our $Attribute	= qr{
    492			const|
    493			volatile|
    494			__percpu|
    495			__nocast|
    496			__safe|
    497			__bitwise|
    498			__packed__|
    499			__packed2__|
    500			__naked|
    501			__maybe_unused|
    502			__always_unused|
    503			__noreturn|
    504			__used|
    505			__cold|
    506			__pure|
    507			__noclone|
    508			__deprecated|
    509			__read_mostly|
    510			__ro_after_init|
    511			__kprobes|
    512			$InitAttribute|
    513			____cacheline_aligned|
    514			____cacheline_aligned_in_smp|
    515			____cacheline_internodealigned_in_smp|
    516			__weak|
    517			__alloc_size\s*\(\s*\d+\s*(?:,\s*\d+\s*)?\)
    518		  }x;
    519our $Modifier;
    520our $Inline	= qr{inline|__always_inline|noinline|__inline|__inline__};
    521our $Member	= qr{->$Ident|\.$Ident|\[[^]]*\]};
    522our $Lval	= qr{$Ident(?:$Member)*};
    523
    524our $Int_type	= qr{(?i)llu|ull|ll|lu|ul|l|u};
    525our $Binary	= qr{(?i)0b[01]+$Int_type?};
    526our $Hex	= qr{(?i)0x[0-9a-f]+$Int_type?};
    527our $Int	= qr{[0-9]+$Int_type?};
    528our $Octal	= qr{0[0-7]+$Int_type?};
    529our $String	= qr{(?:\b[Lu])?"[X\t]*"};
    530our $Float_hex	= qr{(?i)0x[0-9a-f]+p-?[0-9]+[fl]?};
    531our $Float_dec	= qr{(?i)(?:[0-9]+\.[0-9]*|[0-9]*\.[0-9]+)(?:e-?[0-9]+)?[fl]?};
    532our $Float_int	= qr{(?i)[0-9]+e-?[0-9]+[fl]?};
    533our $Float	= qr{$Float_hex|$Float_dec|$Float_int};
    534our $Constant	= qr{$Float|$Binary|$Octal|$Hex|$Int};
    535our $Assignment	= qr{\*\=|/=|%=|\+=|-=|<<=|>>=|&=|\^=|\|=|=};
    536our $Compare    = qr{<=|>=|==|!=|<|(?<!-)>};
    537our $Arithmetic = qr{\+|-|\*|\/|%};
    538our $Operators	= qr{
    539			<=|>=|==|!=|
    540			=>|->|<<|>>|<|>|!|~|
    541			&&|\|\||,|\^|\+\+|--|&|\||$Arithmetic
    542		  }x;
    543
    544our $c90_Keywords = qr{do|for|while|if|else|return|goto|continue|switch|default|case|break}x;
    545
    546our $BasicType;
    547our $NonptrType;
    548our $NonptrTypeMisordered;
    549our $NonptrTypeWithAttr;
    550our $Type;
    551our $TypeMisordered;
    552our $Declare;
    553our $DeclareMisordered;
    554
    555our $NON_ASCII_UTF8	= qr{
    556	[\xC2-\xDF][\x80-\xBF]               # non-overlong 2-byte
    557	|  \xE0[\xA0-\xBF][\x80-\xBF]        # excluding overlongs
    558	| [\xE1-\xEC\xEE\xEF][\x80-\xBF]{2}  # straight 3-byte
    559	|  \xED[\x80-\x9F][\x80-\xBF]        # excluding surrogates
    560	|  \xF0[\x90-\xBF][\x80-\xBF]{2}     # planes 1-3
    561	| [\xF1-\xF3][\x80-\xBF]{3}          # planes 4-15
    562	|  \xF4[\x80-\x8F][\x80-\xBF]{2}     # plane 16
    563}x;
    564
    565our $UTF8	= qr{
    566	[\x09\x0A\x0D\x20-\x7E]              # ASCII
    567	| $NON_ASCII_UTF8
    568}x;
    569
    570our $typeC99Typedefs = qr{(?:__)?(?:[us]_?)?int_?(?:8|16|32|64)_t};
    571our $typeOtherOSTypedefs = qr{(?x:
    572	u_(?:char|short|int|long) |          # bsd
    573	u(?:nchar|short|int|long)            # sysv
    574)};
    575our $typeKernelTypedefs = qr{(?x:
    576	(?:__)?(?:u|s|be|le)(?:8|16|32|64)|
    577	atomic_t
    578)};
    579our $typeTypedefs = qr{(?x:
    580	$typeC99Typedefs\b|
    581	$typeOtherOSTypedefs\b|
    582	$typeKernelTypedefs\b
    583)};
    584
    585our $zero_initializer = qr{(?:(?:0[xX])?0+$Int_type?|NULL|false)\b};
    586
    587our $logFunctions = qr{(?x:
    588	printk(?:_ratelimited|_once|_deferred_once|_deferred|)|
    589	(?:[a-z0-9]+_){1,2}(?:printk|emerg|alert|crit|err|warning|warn|notice|info|debug|dbg|vdbg|devel|cont|WARN)(?:_ratelimited|_once|)|
    590	TP_printk|
    591	WARN(?:_RATELIMIT|_ONCE|)|
    592	panic|
    593	MODULE_[A-Z_]+|
    594	seq_vprintf|seq_printf|seq_puts
    595)};
    596
    597our $allocFunctions = qr{(?x:
    598	(?:(?:devm_)?
    599		(?:kv|k|v)[czm]alloc(?:_array)?(?:_node)? |
    600		kstrdup(?:_const)? |
    601		kmemdup(?:_nul)?) |
    602	(?:\w+)?alloc_skb(?:_ip_align)? |
    603				# dev_alloc_skb/netdev_alloc_skb, et al
    604	dma_alloc_coherent
    605)};
    606
    607our $signature_tags = qr{(?xi:
    608	Signed-off-by:|
    609	Co-developed-by:|
    610	Acked-by:|
    611	Tested-by:|
    612	Reviewed-by:|
    613	Reported-by:|
    614	Suggested-by:|
    615	To:|
    616	Cc:
    617)};
    618
    619our $tracing_logging_tags = qr{(?xi:
    620	[=-]*> |
    621	<[=-]* |
    622	\[ |
    623	\] |
    624	start |
    625	called |
    626	entered |
    627	entry |
    628	enter |
    629	in |
    630	inside |
    631	here |
    632	begin |
    633	exit |
    634	end |
    635	done |
    636	leave |
    637	completed |
    638	out |
    639	return |
    640	[\.\!:\s]*
    641)};
    642
    643sub edit_distance_min {
    644	my (@arr) = @_;
    645	my $len = scalar @arr;
    646	if ((scalar @arr) < 1) {
    647		# if underflow, return
    648		return;
    649	}
    650	my $min = $arr[0];
    651	for my $i (0 .. ($len-1)) {
    652		if ($arr[$i] < $min) {
    653			$min = $arr[$i];
    654		}
    655	}
    656	return $min;
    657}
    658
    659sub get_edit_distance {
    660	my ($str1, $str2) = @_;
    661	$str1 = lc($str1);
    662	$str2 = lc($str2);
    663	$str1 =~ s/-//g;
    664	$str2 =~ s/-//g;
    665	my $len1 = length($str1);
    666	my $len2 = length($str2);
    667	# two dimensional array storing minimum edit distance
    668	my @distance;
    669	for my $i (0 .. $len1) {
    670		for my $j (0 .. $len2) {
    671			if ($i == 0) {
    672				$distance[$i][$j] = $j;
    673			} elsif ($j == 0) {
    674				$distance[$i][$j] = $i;
    675			} elsif (substr($str1, $i-1, 1) eq substr($str2, $j-1, 1)) {
    676				$distance[$i][$j] = $distance[$i - 1][$j - 1];
    677			} else {
    678				my $dist1 = $distance[$i][$j - 1]; #insert distance
    679				my $dist2 = $distance[$i - 1][$j]; # remove
    680				my $dist3 = $distance[$i - 1][$j - 1]; #replace
    681				$distance[$i][$j] = 1 + edit_distance_min($dist1, $dist2, $dist3);
    682			}
    683		}
    684	}
    685	return $distance[$len1][$len2];
    686}
    687
    688sub find_standard_signature {
    689	my ($sign_off) = @_;
    690	my @standard_signature_tags = (
    691		'Signed-off-by:', 'Co-developed-by:', 'Acked-by:', 'Tested-by:',
    692		'Reviewed-by:', 'Reported-by:', 'Suggested-by:'
    693	);
    694	foreach my $signature (@standard_signature_tags) {
    695		return $signature if (get_edit_distance($sign_off, $signature) <= 2);
    696	}
    697
    698	return "";
    699}
    700
    701our @typeListMisordered = (
    702	qr{char\s+(?:un)?signed},
    703	qr{int\s+(?:(?:un)?signed\s+)?short\s},
    704	qr{int\s+short(?:\s+(?:un)?signed)},
    705	qr{short\s+int(?:\s+(?:un)?signed)},
    706	qr{(?:un)?signed\s+int\s+short},
    707	qr{short\s+(?:un)?signed},
    708	qr{long\s+int\s+(?:un)?signed},
    709	qr{int\s+long\s+(?:un)?signed},
    710	qr{long\s+(?:un)?signed\s+int},
    711	qr{int\s+(?:un)?signed\s+long},
    712	qr{int\s+(?:un)?signed},
    713	qr{int\s+long\s+long\s+(?:un)?signed},
    714	qr{long\s+long\s+int\s+(?:un)?signed},
    715	qr{long\s+long\s+(?:un)?signed\s+int},
    716	qr{long\s+long\s+(?:un)?signed},
    717	qr{long\s+(?:un)?signed},
    718);
    719
    720our @typeList = (
    721	qr{void},
    722	qr{(?:(?:un)?signed\s+)?char},
    723	qr{(?:(?:un)?signed\s+)?short\s+int},
    724	qr{(?:(?:un)?signed\s+)?short},
    725	qr{(?:(?:un)?signed\s+)?int},
    726	qr{(?:(?:un)?signed\s+)?long\s+int},
    727	qr{(?:(?:un)?signed\s+)?long\s+long\s+int},
    728	qr{(?:(?:un)?signed\s+)?long\s+long},
    729	qr{(?:(?:un)?signed\s+)?long},
    730	qr{(?:un)?signed},
    731	qr{float},
    732	qr{double},
    733	qr{bool},
    734	qr{struct\s+$Ident},
    735	qr{union\s+$Ident},
    736	qr{enum\s+$Ident},
    737	qr{${Ident}_t},
    738	qr{${Ident}_handler},
    739	qr{${Ident}_handler_fn},
    740	@typeListMisordered,
    741);
    742
    743our $C90_int_types = qr{(?x:
    744	long\s+long\s+int\s+(?:un)?signed|
    745	long\s+long\s+(?:un)?signed\s+int|
    746	long\s+long\s+(?:un)?signed|
    747	(?:(?:un)?signed\s+)?long\s+long\s+int|
    748	(?:(?:un)?signed\s+)?long\s+long|
    749	int\s+long\s+long\s+(?:un)?signed|
    750	int\s+(?:(?:un)?signed\s+)?long\s+long|
    751
    752	long\s+int\s+(?:un)?signed|
    753	long\s+(?:un)?signed\s+int|
    754	long\s+(?:un)?signed|
    755	(?:(?:un)?signed\s+)?long\s+int|
    756	(?:(?:un)?signed\s+)?long|
    757	int\s+long\s+(?:un)?signed|
    758	int\s+(?:(?:un)?signed\s+)?long|
    759
    760	int\s+(?:un)?signed|
    761	(?:(?:un)?signed\s+)?int
    762)};
    763
    764our @typeListFile = ();
    765our @typeListWithAttr = (
    766	@typeList,
    767	qr{struct\s+$InitAttribute\s+$Ident},
    768	qr{union\s+$InitAttribute\s+$Ident},
    769);
    770
    771our @modifierList = (
    772	qr{fastcall},
    773);
    774our @modifierListFile = ();
    775
    776our @mode_permission_funcs = (
    777	["module_param", 3],
    778	["module_param_(?:array|named|string)", 4],
    779	["module_param_array_named", 5],
    780	["debugfs_create_(?:file|u8|u16|u32|u64|x8|x16|x32|x64|size_t|atomic_t|bool|blob|regset32|u32_array)", 2],
    781	["proc_create(?:_data|)", 2],
    782	["(?:CLASS|DEVICE|SENSOR|SENSOR_DEVICE|IIO_DEVICE)_ATTR", 2],
    783	["IIO_DEV_ATTR_[A-Z_]+", 1],
    784	["SENSOR_(?:DEVICE_|)ATTR_2", 2],
    785	["SENSOR_TEMPLATE(?:_2|)", 3],
    786	["__ATTR", 2],
    787);
    788
    789my $word_pattern = '\b[A-Z]?[a-z]{2,}\b';
    790
    791#Create a search pattern for all these functions to speed up a loop below
    792our $mode_perms_search = "";
    793foreach my $entry (@mode_permission_funcs) {
    794	$mode_perms_search .= '|' if ($mode_perms_search ne "");
    795	$mode_perms_search .= $entry->[0];
    796}
    797$mode_perms_search = "(?:${mode_perms_search})";
    798
    799our %deprecated_apis = (
    800	"synchronize_rcu_bh"			=> "synchronize_rcu",
    801	"synchronize_rcu_bh_expedited"		=> "synchronize_rcu_expedited",
    802	"call_rcu_bh"				=> "call_rcu",
    803	"rcu_barrier_bh"			=> "rcu_barrier",
    804	"synchronize_sched"			=> "synchronize_rcu",
    805	"synchronize_sched_expedited"		=> "synchronize_rcu_expedited",
    806	"call_rcu_sched"			=> "call_rcu",
    807	"rcu_barrier_sched"			=> "rcu_barrier",
    808	"get_state_synchronize_sched"		=> "get_state_synchronize_rcu",
    809	"cond_synchronize_sched"		=> "cond_synchronize_rcu",
    810);
    811
    812#Create a search pattern for all these strings to speed up a loop below
    813our $deprecated_apis_search = "";
    814foreach my $entry (keys %deprecated_apis) {
    815	$deprecated_apis_search .= '|' if ($deprecated_apis_search ne "");
    816	$deprecated_apis_search .= $entry;
    817}
    818$deprecated_apis_search = "(?:${deprecated_apis_search})";
    819
    820our $mode_perms_world_writable = qr{
    821	S_IWUGO		|
    822	S_IWOTH		|
    823	S_IRWXUGO	|
    824	S_IALLUGO	|
    825	0[0-7][0-7][2367]
    826}x;
    827
    828our %mode_permission_string_types = (
    829	"S_IRWXU" => 0700,
    830	"S_IRUSR" => 0400,
    831	"S_IWUSR" => 0200,
    832	"S_IXUSR" => 0100,
    833	"S_IRWXG" => 0070,
    834	"S_IRGRP" => 0040,
    835	"S_IWGRP" => 0020,
    836	"S_IXGRP" => 0010,
    837	"S_IRWXO" => 0007,
    838	"S_IROTH" => 0004,
    839	"S_IWOTH" => 0002,
    840	"S_IXOTH" => 0001,
    841	"S_IRWXUGO" => 0777,
    842	"S_IRUGO" => 0444,
    843	"S_IWUGO" => 0222,
    844	"S_IXUGO" => 0111,
    845);
    846
    847#Create a search pattern for all these strings to speed up a loop below
    848our $mode_perms_string_search = "";
    849foreach my $entry (keys %mode_permission_string_types) {
    850	$mode_perms_string_search .= '|' if ($mode_perms_string_search ne "");
    851	$mode_perms_string_search .= $entry;
    852}
    853our $single_mode_perms_string_search = "(?:${mode_perms_string_search})";
    854our $multi_mode_perms_string_search = qr{
    855	${single_mode_perms_string_search}
    856	(?:\s*\|\s*${single_mode_perms_string_search})*
    857}x;
    858
    859sub perms_to_octal {
    860	my ($string) = @_;
    861
    862	return trim($string) if ($string =~ /^\s*0[0-7]{3,3}\s*$/);
    863
    864	my $val = "";
    865	my $oval = "";
    866	my $to = 0;
    867	my $curpos = 0;
    868	my $lastpos = 0;
    869	while ($string =~ /\b(($single_mode_perms_string_search)\b(?:\s*\|\s*)?\s*)/g) {
    870		$curpos = pos($string);
    871		my $match = $2;
    872		my $omatch = $1;
    873		last if ($lastpos > 0 && ($curpos - length($omatch) != $lastpos));
    874		$lastpos = $curpos;
    875		$to |= $mode_permission_string_types{$match};
    876		$val .= '\s*\|\s*' if ($val ne "");
    877		$val .= $match;
    878		$oval .= $omatch;
    879	}
    880	$oval =~ s/^\s*\|\s*//;
    881	$oval =~ s/\s*\|\s*$//;
    882	return sprintf("%04o", $to);
    883}
    884
    885our $allowed_asm_includes = qr{(?x:
    886	irq|
    887	memory|
    888	time|
    889	reboot
    890)};
    891# memory.h: ARM has a custom one
    892
    893# Load common spelling mistakes and build regular expression list.
    894my $misspellings;
    895my %spelling_fix;
    896
    897if (open(my $spelling, '<', $spelling_file)) {
    898	while (<$spelling>) {
    899		my $line = $_;
    900
    901		$line =~ s/\s*\n?$//g;
    902		$line =~ s/^\s*//g;
    903
    904		next if ($line =~ m/^\s*#/);
    905		next if ($line =~ m/^\s*$/);
    906
    907		my ($suspect, $fix) = split(/\|\|/, $line);
    908
    909		$spelling_fix{$suspect} = $fix;
    910	}
    911	close($spelling);
    912} else {
    913	warn "No typos will be found - file '$spelling_file': $!\n";
    914}
    915
    916if ($codespell) {
    917	if (open(my $spelling, '<', $codespellfile)) {
    918		while (<$spelling>) {
    919			my $line = $_;
    920
    921			$line =~ s/\s*\n?$//g;
    922			$line =~ s/^\s*//g;
    923
    924			next if ($line =~ m/^\s*#/);
    925			next if ($line =~ m/^\s*$/);
    926			next if ($line =~ m/, disabled/i);
    927
    928			$line =~ s/,.*$//;
    929
    930			my ($suspect, $fix) = split(/->/, $line);
    931
    932			$spelling_fix{$suspect} = $fix;
    933		}
    934		close($spelling);
    935	} else {
    936		warn "No codespell typos will be found - file '$codespellfile': $!\n";
    937	}
    938}
    939
    940$misspellings = join("|", sort keys %spelling_fix) if keys %spelling_fix;
    941
    942sub read_words {
    943	my ($wordsRef, $file) = @_;
    944
    945	if (open(my $words, '<', $file)) {
    946		while (<$words>) {
    947			my $line = $_;
    948
    949			$line =~ s/\s*\n?$//g;
    950			$line =~ s/^\s*//g;
    951
    952			next if ($line =~ m/^\s*#/);
    953			next if ($line =~ m/^\s*$/);
    954			if ($line =~ /\s/) {
    955				print("$file: '$line' invalid - ignored\n");
    956				next;
    957			}
    958
    959			$$wordsRef .= '|' if (defined $$wordsRef);
    960			$$wordsRef .= $line;
    961		}
    962		close($file);
    963		return 1;
    964	}
    965
    966	return 0;
    967}
    968
    969my $const_structs;
    970if (show_type("CONST_STRUCT")) {
    971	read_words(\$const_structs, $conststructsfile)
    972	    or warn "No structs that should be const will be found - file '$conststructsfile': $!\n";
    973}
    974
    975if (defined($typedefsfile)) {
    976	my $typeOtherTypedefs;
    977	read_words(\$typeOtherTypedefs, $typedefsfile)
    978	    or warn "No additional types will be considered - file '$typedefsfile': $!\n";
    979	$typeTypedefs .= '|' . $typeOtherTypedefs if (defined $typeOtherTypedefs);
    980}
    981
    982sub build_types {
    983	my $mods = "(?x:  \n" . join("|\n  ", (@modifierList, @modifierListFile)) . "\n)";
    984	my $all = "(?x:  \n" . join("|\n  ", (@typeList, @typeListFile)) . "\n)";
    985	my $Misordered = "(?x:  \n" . join("|\n  ", @typeListMisordered) . "\n)";
    986	my $allWithAttr = "(?x:  \n" . join("|\n  ", @typeListWithAttr) . "\n)";
    987	$Modifier	= qr{(?:$Attribute|$Sparse|$mods)};
    988	$BasicType	= qr{
    989				(?:$typeTypedefs\b)|
    990				(?:${all}\b)
    991		}x;
    992	$NonptrType	= qr{
    993			(?:$Modifier\s+|const\s+)*
    994			(?:
    995				(?:typeof|__typeof__)\s*\([^\)]*\)|
    996				(?:$typeTypedefs\b)|
    997				(?:${all}\b)
    998			)
    999			(?:\s+$Modifier|\s+const)*
   1000		  }x;
   1001	$NonptrTypeMisordered	= qr{
   1002			(?:$Modifier\s+|const\s+)*
   1003			(?:
   1004				(?:${Misordered}\b)
   1005			)
   1006			(?:\s+$Modifier|\s+const)*
   1007		  }x;
   1008	$NonptrTypeWithAttr	= qr{
   1009			(?:$Modifier\s+|const\s+)*
   1010			(?:
   1011				(?:typeof|__typeof__)\s*\([^\)]*\)|
   1012				(?:$typeTypedefs\b)|
   1013				(?:${allWithAttr}\b)
   1014			)
   1015			(?:\s+$Modifier|\s+const)*
   1016		  }x;
   1017	$Type	= qr{
   1018			$NonptrType
   1019			(?:(?:\s|\*|\[\])+\s*const|(?:\s|\*\s*(?:const\s*)?|\[\])+|(?:\s*\[\s*\])+){0,4}
   1020			(?:\s+$Inline|\s+$Modifier)*
   1021		  }x;
   1022	$TypeMisordered	= qr{
   1023			$NonptrTypeMisordered
   1024			(?:(?:\s|\*|\[\])+\s*const|(?:\s|\*\s*(?:const\s*)?|\[\])+|(?:\s*\[\s*\])+){0,4}
   1025			(?:\s+$Inline|\s+$Modifier)*
   1026		  }x;
   1027	$Declare	= qr{(?:$Storage\s+(?:$Inline\s+)?)?$Type};
   1028	$DeclareMisordered	= qr{(?:$Storage\s+(?:$Inline\s+)?)?$TypeMisordered};
   1029}
   1030build_types();
   1031
   1032our $Typecast	= qr{\s*(\(\s*$NonptrType\s*\)){0,1}\s*};
   1033
   1034# Using $balanced_parens, $LvalOrFunc, or $FuncArg
   1035# requires at least perl version v5.10.0
   1036# Any use must be runtime checked with $^V
   1037
   1038our $balanced_parens = qr/(\((?:[^\(\)]++|(?-1))*\))/;
   1039our $LvalOrFunc	= qr{((?:[\&\*]\s*)?$Lval)\s*($balanced_parens{0,1})\s*};
   1040our $FuncArg = qr{$Typecast{0,1}($LvalOrFunc|$Constant|$String)};
   1041
   1042our $declaration_macros = qr{(?x:
   1043	(?:$Storage\s+)?(?:[A-Z_][A-Z0-9]*_){0,2}(?:DEFINE|DECLARE)(?:_[A-Z0-9]+){1,6}\s*\(|
   1044	(?:$Storage\s+)?[HLP]?LIST_HEAD\s*\(|
   1045	(?:SKCIPHER_REQUEST|SHASH_DESC|AHASH_REQUEST)_ON_STACK\s*\(
   1046)};
   1047
   1048our %allow_repeated_words = (
   1049	add => '',
   1050	added => '',
   1051	bad => '',
   1052	be => '',
   1053);
   1054
   1055sub deparenthesize {
   1056	my ($string) = @_;
   1057	return "" if (!defined($string));
   1058
   1059	while ($string =~ /^\s*\(.*\)\s*$/) {
   1060		$string =~ s@^\s*\(\s*@@;
   1061		$string =~ s@\s*\)\s*$@@;
   1062	}
   1063
   1064	$string =~ s@\s+@ @g;
   1065
   1066	return $string;
   1067}
   1068
   1069sub seed_camelcase_file {
   1070	my ($file) = @_;
   1071
   1072	return if (!(-f $file));
   1073
   1074	local $/;
   1075
   1076	open(my $include_file, '<', "$file")
   1077	    or warn "$P: Can't read '$file' $!\n";
   1078	my $text = <$include_file>;
   1079	close($include_file);
   1080
   1081	my @lines = split('\n', $text);
   1082
   1083	foreach my $line (@lines) {
   1084		next if ($line !~ /(?:[A-Z][a-z]|[a-z][A-Z])/);
   1085		if ($line =~ /^[ \t]*(?:#[ \t]*define|typedef\s+$Type)\s+(\w*(?:[A-Z][a-z]|[a-z][A-Z])\w*)/) {
   1086			$camelcase{$1} = 1;
   1087		} elsif ($line =~ /^\s*$Declare\s+(\w*(?:[A-Z][a-z]|[a-z][A-Z])\w*)\s*[\(\[,;]/) {
   1088			$camelcase{$1} = 1;
   1089		} elsif ($line =~ /^\s*(?:union|struct|enum)\s+(\w*(?:[A-Z][a-z]|[a-z][A-Z])\w*)\s*[;\{]/) {
   1090			$camelcase{$1} = 1;
   1091		}
   1092	}
   1093}
   1094
   1095our %maintained_status = ();
   1096
   1097sub is_maintained_obsolete {
   1098	my ($filename) = @_;
   1099
   1100	return 0 if (!$tree || !(-e "$root/scripts/get_maintainer.pl"));
   1101
   1102	if (!exists($maintained_status{$filename})) {
   1103		$maintained_status{$filename} = `perl $root/scripts/get_maintainer.pl --status --nom --nol --nogit --nogit-fallback -f $filename 2>&1`;
   1104	}
   1105
   1106	return $maintained_status{$filename} =~ /obsolete/i;
   1107}
   1108
   1109sub is_SPDX_License_valid {
   1110	my ($license) = @_;
   1111
   1112	return 1 if (!$tree || which("python3") eq "" || !(-x "$root/scripts/spdxcheck.py") || !(-e "$gitroot"));
   1113
   1114	my $root_path = abs_path($root);
   1115	my $status = `cd "$root_path"; echo "$license" | scripts/spdxcheck.py -`;
   1116	return 0 if ($status ne "");
   1117	return 1;
   1118}
   1119
   1120my $camelcase_seeded = 0;
   1121sub seed_camelcase_includes {
   1122	return if ($camelcase_seeded);
   1123
   1124	my $files;
   1125	my $camelcase_cache = "";
   1126	my @include_files = ();
   1127
   1128	$camelcase_seeded = 1;
   1129
   1130	if (-e "$gitroot") {
   1131		my $git_last_include_commit = `${git_command} log --no-merges --pretty=format:"%h%n" -1 -- include`;
   1132		chomp $git_last_include_commit;
   1133		$camelcase_cache = ".checkpatch-camelcase.git.$git_last_include_commit";
   1134	} else {
   1135		my $last_mod_date = 0;
   1136		$files = `find $root/include -name "*.h"`;
   1137		@include_files = split('\n', $files);
   1138		foreach my $file (@include_files) {
   1139			my $date = POSIX::strftime("%Y%m%d%H%M",
   1140						   localtime((stat $file)[9]));
   1141			$last_mod_date = $date if ($last_mod_date < $date);
   1142		}
   1143		$camelcase_cache = ".checkpatch-camelcase.date.$last_mod_date";
   1144	}
   1145
   1146	if ($camelcase_cache ne "" && -f $camelcase_cache) {
   1147		open(my $camelcase_file, '<', "$camelcase_cache")
   1148		    or warn "$P: Can't read '$camelcase_cache' $!\n";
   1149		while (<$camelcase_file>) {
   1150			chomp;
   1151			$camelcase{$_} = 1;
   1152		}
   1153		close($camelcase_file);
   1154
   1155		return;
   1156	}
   1157
   1158	if (-e "$gitroot") {
   1159		$files = `${git_command} ls-files "include/*.h"`;
   1160		@include_files = split('\n', $files);
   1161	}
   1162
   1163	foreach my $file (@include_files) {
   1164		seed_camelcase_file($file);
   1165	}
   1166
   1167	if ($camelcase_cache ne "") {
   1168		unlink glob ".checkpatch-camelcase.*";
   1169		open(my $camelcase_file, '>', "$camelcase_cache")
   1170		    or warn "$P: Can't write '$camelcase_cache' $!\n";
   1171		foreach (sort { lc($a) cmp lc($b) } keys(%camelcase)) {
   1172			print $camelcase_file ("$_\n");
   1173		}
   1174		close($camelcase_file);
   1175	}
   1176}
   1177
   1178sub git_is_single_file {
   1179	my ($filename) = @_;
   1180
   1181	return 0 if ((which("git") eq "") || !(-e "$gitroot"));
   1182
   1183	my $output = `${git_command} ls-files -- $filename 2>/dev/null`;
   1184	my $count = $output =~ tr/\n//;
   1185	return $count eq 1 && $output =~ m{^${filename}$};
   1186}
   1187
   1188sub git_commit_info {
   1189	my ($commit, $id, $desc) = @_;
   1190
   1191	return ($id, $desc) if ((which("git") eq "") || !(-e "$gitroot"));
   1192
   1193	my $output = `${git_command} log --no-color --format='%H %s' -1 $commit 2>&1`;
   1194	$output =~ s/^\s*//gm;
   1195	my @lines = split("\n", $output);
   1196
   1197	return ($id, $desc) if ($#lines < 0);
   1198
   1199	if ($lines[0] =~ /^error: short SHA1 $commit is ambiguous/) {
   1200# Maybe one day convert this block of bash into something that returns
   1201# all matching commit ids, but it's very slow...
   1202#
   1203#		echo "checking commits $1..."
   1204#		git rev-list --remotes | grep -i "^$1" |
   1205#		while read line ; do
   1206#		    git log --format='%H %s' -1 $line |
   1207#		    echo "commit $(cut -c 1-12,41-)"
   1208#		done
   1209	} elsif ($lines[0] =~ /^fatal: ambiguous argument '$commit': unknown revision or path not in the working tree\./ ||
   1210		 $lines[0] =~ /^fatal: bad object $commit/) {
   1211		$id = undef;
   1212	} else {
   1213		$id = substr($lines[0], 0, 12);
   1214		$desc = substr($lines[0], 41);
   1215	}
   1216
   1217	return ($id, $desc);
   1218}
   1219
   1220$chk_signoff = 0 if ($file);
   1221
   1222my @rawlines = ();
   1223my @lines = ();
   1224my @fixed = ();
   1225my @fixed_inserted = ();
   1226my @fixed_deleted = ();
   1227my $fixlinenr = -1;
   1228
   1229# If input is git commits, extract all commits from the commit expressions.
   1230# For example, HEAD-3 means we need check 'HEAD, HEAD~1, HEAD~2'.
   1231die "$P: No git repository found\n" if ($git && !-e "$gitroot");
   1232
   1233if ($git) {
   1234	my @commits = ();
   1235	foreach my $commit_expr (@ARGV) {
   1236		my $git_range;
   1237		if ($commit_expr =~ m/^(.*)-(\d+)$/) {
   1238			$git_range = "-$2 $1";
   1239		} elsif ($commit_expr =~ m/\.\./) {
   1240			$git_range = "$commit_expr";
   1241		} else {
   1242			$git_range = "-1 $commit_expr";
   1243		}
   1244		my $lines = `${git_command} log --no-color --no-merges --pretty=format:'%H %s' $git_range`;
   1245		foreach my $line (split(/\n/, $lines)) {
   1246			$line =~ /^([0-9a-fA-F]{40,40}) (.*)$/;
   1247			next if (!defined($1) || !defined($2));
   1248			my $sha1 = $1;
   1249			my $subject = $2;
   1250			unshift(@commits, $sha1);
   1251			$git_commits{$sha1} = $subject;
   1252		}
   1253	}
   1254	die "$P: no git commits after extraction!\n" if (@commits == 0);
   1255	@ARGV = @commits;
   1256}
   1257
   1258my $vname;
   1259$allow_c99_comments = !defined $ignore_type{"C99_COMMENT_TOLERANCE"};
   1260for my $filename (@ARGV) {
   1261	my $FILE;
   1262	my $is_git_file = git_is_single_file($filename);
   1263	my $oldfile = $file;
   1264	$file = 1 if ($is_git_file);
   1265	if ($git) {
   1266		open($FILE, '-|', "git format-patch -M --stdout -1 $filename") ||
   1267			die "$P: $filename: git format-patch failed - $!\n";
   1268	} elsif ($file) {
   1269		open($FILE, '-|', "diff -u /dev/null $filename") ||
   1270			die "$P: $filename: diff failed - $!\n";
   1271	} elsif ($filename eq '-') {
   1272		open($FILE, '<&STDIN');
   1273	} else {
   1274		open($FILE, '<', "$filename") ||
   1275			die "$P: $filename: open failed - $!\n";
   1276	}
   1277	if ($filename eq '-') {
   1278		$vname = 'Your patch';
   1279	} elsif ($git) {
   1280		$vname = "Commit " . substr($filename, 0, 12) . ' ("' . $git_commits{$filename} . '")';
   1281	} else {
   1282		$vname = $filename;
   1283	}
   1284	while (<$FILE>) {
   1285		chomp;
   1286		push(@rawlines, $_);
   1287		$vname = qq("$1") if ($filename eq '-' && $_ =~ m/^Subject:\s+(.+)/i);
   1288	}
   1289	close($FILE);
   1290
   1291	if ($#ARGV > 0 && $quiet == 0) {
   1292		print '-' x length($vname) . "\n";
   1293		print "$vname\n";
   1294		print '-' x length($vname) . "\n";
   1295	}
   1296
   1297	if (!process($filename)) {
   1298		$exit = 1;
   1299	}
   1300	@rawlines = ();
   1301	@lines = ();
   1302	@fixed = ();
   1303	@fixed_inserted = ();
   1304	@fixed_deleted = ();
   1305	$fixlinenr = -1;
   1306	@modifierListFile = ();
   1307	@typeListFile = ();
   1308	build_types();
   1309	$file = $oldfile if ($is_git_file);
   1310}
   1311
   1312if (!$quiet) {
   1313	hash_show_words(\%use_type, "Used");
   1314	hash_show_words(\%ignore_type, "Ignored");
   1315
   1316	if (!$perl_version_ok) {
   1317		print << "EOM"
   1318
   1319NOTE: perl $^V is not modern enough to detect all possible issues.
   1320      An upgrade to at least perl $minimum_perl_version is suggested.
   1321EOM
   1322	}
   1323	if ($exit) {
   1324		print << "EOM"
   1325
   1326NOTE: If any of the errors are false positives, please report
   1327      them to the maintainer, see CHECKPATCH in MAINTAINERS.
   1328EOM
   1329	}
   1330}
   1331
   1332exit($exit);
   1333
   1334sub top_of_kernel_tree {
   1335	my ($root) = @_;
   1336
   1337	my @tree_check = (
   1338		"COPYING", "CREDITS", "Kbuild", "MAINTAINERS", "Makefile",
   1339		"README", "Documentation", "arch", "include", "drivers",
   1340		"fs", "init", "ipc", "kernel", "lib", "scripts",
   1341	);
   1342
   1343	foreach my $check (@tree_check) {
   1344		if (! -e $root . '/' . $check) {
   1345			return 0;
   1346		}
   1347	}
   1348	return 1;
   1349}
   1350
   1351sub parse_email {
   1352	my ($formatted_email) = @_;
   1353
   1354	my $name = "";
   1355	my $quoted = "";
   1356	my $name_comment = "";
   1357	my $address = "";
   1358	my $comment = "";
   1359
   1360	if ($formatted_email =~ /^(.*)<(\S+\@\S+)>(.*)$/) {
   1361		$name = $1;
   1362		$address = $2;
   1363		$comment = $3 if defined $3;
   1364	} elsif ($formatted_email =~ /^\s*<(\S+\@\S+)>(.*)$/) {
   1365		$address = $1;
   1366		$comment = $2 if defined $2;
   1367	} elsif ($formatted_email =~ /(\S+\@\S+)(.*)$/) {
   1368		$address = $1;
   1369		$comment = $2 if defined $2;
   1370		$formatted_email =~ s/\Q$address\E.*$//;
   1371		$name = $formatted_email;
   1372		$name = trim($name);
   1373		$name =~ s/^\"|\"$//g;
   1374		# If there's a name left after stripping spaces and
   1375		# leading quotes, and the address doesn't have both
   1376		# leading and trailing angle brackets, the address
   1377		# is invalid. ie:
   1378		#   "joe smith joe@smith.com" bad
   1379		#   "joe smith <joe@smith.com" bad
   1380		if ($name ne "" && $address !~ /^<[^>]+>$/) {
   1381			$name = "";
   1382			$address = "";
   1383			$comment = "";
   1384		}
   1385	}
   1386
   1387	# Extract comments from names excluding quoted parts
   1388	# "John D. (Doe)" - Do not extract
   1389	if ($name =~ s/\"(.+)\"//) {
   1390		$quoted = $1;
   1391	}
   1392	while ($name =~ s/\s*($balanced_parens)\s*/ /) {
   1393		$name_comment .= trim($1);
   1394	}
   1395	$name =~ s/^[ \"]+|[ \"]+$//g;
   1396	$name = trim("$quoted $name");
   1397
   1398	$address = trim($address);
   1399	$address =~ s/^\<|\>$//g;
   1400	$comment = trim($comment);
   1401
   1402	if ($name =~ /[^\w \-]/i) { ##has "must quote" chars
   1403		$name =~ s/(?<!\\)"/\\"/g; ##escape quotes
   1404		$name = "\"$name\"";
   1405	}
   1406
   1407	return ($name, $name_comment, $address, $comment);
   1408}
   1409
   1410sub format_email {
   1411	my ($name, $name_comment, $address, $comment) = @_;
   1412
   1413	my $formatted_email;
   1414
   1415	$name =~ s/^[ \"]+|[ \"]+$//g;
   1416	$address = trim($address);
   1417	$address =~ s/(?:\.|\,|\")+$//; ##trailing commas, dots or quotes
   1418
   1419	if ($name =~ /[^\w \-]/i) { ##has "must quote" chars
   1420		$name =~ s/(?<!\\)"/\\"/g; ##escape quotes
   1421		$name = "\"$name\"";
   1422	}
   1423
   1424	$name_comment = trim($name_comment);
   1425	$name_comment = " $name_comment" if ($name_comment ne "");
   1426	$comment = trim($comment);
   1427	$comment = " $comment" if ($comment ne "");
   1428
   1429	if ("$name" eq "") {
   1430		$formatted_email = "$address";
   1431	} else {
   1432		$formatted_email = "$name$name_comment <$address>";
   1433	}
   1434	$formatted_email .= "$comment";
   1435	return $formatted_email;
   1436}
   1437
   1438sub reformat_email {
   1439	my ($email) = @_;
   1440
   1441	my ($email_name, $name_comment, $email_address, $comment) = parse_email($email);
   1442	return format_email($email_name, $name_comment, $email_address, $comment);
   1443}
   1444
   1445sub same_email_addresses {
   1446	my ($email1, $email2) = @_;
   1447
   1448	my ($email1_name, $name1_comment, $email1_address, $comment1) = parse_email($email1);
   1449	my ($email2_name, $name2_comment, $email2_address, $comment2) = parse_email($email2);
   1450
   1451	return $email1_name eq $email2_name &&
   1452	       $email1_address eq $email2_address &&
   1453	       $name1_comment eq $name2_comment &&
   1454	       $comment1 eq $comment2;
   1455}
   1456
   1457sub which {
   1458	my ($bin) = @_;
   1459
   1460	foreach my $path (split(/:/, $ENV{PATH})) {
   1461		if (-e "$path/$bin") {
   1462			return "$path/$bin";
   1463		}
   1464	}
   1465
   1466	return "";
   1467}
   1468
   1469sub which_conf {
   1470	my ($conf) = @_;
   1471
   1472	foreach my $path (split(/:/, ".:$ENV{HOME}:.scripts")) {
   1473		if (-e "$path/$conf") {
   1474			return "$path/$conf";
   1475		}
   1476	}
   1477
   1478	return "";
   1479}
   1480
   1481sub expand_tabs {
   1482	my ($str) = @_;
   1483
   1484	my $res = '';
   1485	my $n = 0;
   1486	for my $c (split(//, $str)) {
   1487		if ($c eq "\t") {
   1488			$res .= ' ';
   1489			$n++;
   1490			for (; ($n % $tabsize) != 0; $n++) {
   1491				$res .= ' ';
   1492			}
   1493			next;
   1494		}
   1495		$res .= $c;
   1496		$n++;
   1497	}
   1498
   1499	return $res;
   1500}
   1501sub copy_spacing {
   1502	(my $res = shift) =~ tr/\t/ /c;
   1503	return $res;
   1504}
   1505
   1506sub line_stats {
   1507	my ($line) = @_;
   1508
   1509	# Drop the diff line leader and expand tabs
   1510	$line =~ s/^.//;
   1511	$line = expand_tabs($line);
   1512
   1513	# Pick the indent from the front of the line.
   1514	my ($white) = ($line =~ /^(\s*)/);
   1515
   1516	return (length($line), length($white));
   1517}
   1518
   1519my $sanitise_quote = '';
   1520
   1521sub sanitise_line_reset {
   1522	my ($in_comment) = @_;
   1523
   1524	if ($in_comment) {
   1525		$sanitise_quote = '*/';
   1526	} else {
   1527		$sanitise_quote = '';
   1528	}
   1529}
   1530sub sanitise_line {
   1531	my ($line) = @_;
   1532
   1533	my $res = '';
   1534	my $l = '';
   1535
   1536	my $qlen = 0;
   1537	my $off = 0;
   1538	my $c;
   1539
   1540	# Always copy over the diff marker.
   1541	$res = substr($line, 0, 1);
   1542
   1543	for ($off = 1; $off < length($line); $off++) {
   1544		$c = substr($line, $off, 1);
   1545
   1546		# Comments we are whacking completely including the begin
   1547		# and end, all to $;.
   1548		if ($sanitise_quote eq '' && substr($line, $off, 2) eq '/*') {
   1549			$sanitise_quote = '*/';
   1550
   1551			substr($res, $off, 2, "$;$;");
   1552			$off++;
   1553			next;
   1554		}
   1555		if ($sanitise_quote eq '*/' && substr($line, $off, 2) eq '*/') {
   1556			$sanitise_quote = '';
   1557			substr($res, $off, 2, "$;$;");
   1558			$off++;
   1559			next;
   1560		}
   1561		if ($sanitise_quote eq '' && substr($line, $off, 2) eq '//') {
   1562			$sanitise_quote = '//';
   1563
   1564			substr($res, $off, 2, $sanitise_quote);
   1565			$off++;
   1566			next;
   1567		}
   1568
   1569		# A \ in a string means ignore the next character.
   1570		if (($sanitise_quote eq "'" || $sanitise_quote eq '"') &&
   1571		    $c eq "\\") {
   1572			substr($res, $off, 2, 'XX');
   1573			$off++;
   1574			next;
   1575		}
   1576		# Regular quotes.
   1577		if ($c eq "'" || $c eq '"') {
   1578			if ($sanitise_quote eq '') {
   1579				$sanitise_quote = $c;
   1580
   1581				substr($res, $off, 1, $c);
   1582				next;
   1583			} elsif ($sanitise_quote eq $c) {
   1584				$sanitise_quote = '';
   1585			}
   1586		}
   1587
   1588		#print "c<$c> SQ<$sanitise_quote>\n";
   1589		if ($off != 0 && $sanitise_quote eq '*/' && $c ne "\t") {
   1590			substr($res, $off, 1, $;);
   1591		} elsif ($off != 0 && $sanitise_quote eq '//' && $c ne "\t") {
   1592			substr($res, $off, 1, $;);
   1593		} elsif ($off != 0 && $sanitise_quote && $c ne "\t") {
   1594			substr($res, $off, 1, 'X');
   1595		} else {
   1596			substr($res, $off, 1, $c);
   1597		}
   1598	}
   1599
   1600	if ($sanitise_quote eq '//') {
   1601		$sanitise_quote = '';
   1602	}
   1603
   1604	# The pathname on a #include may be surrounded by '<' and '>'.
   1605	if ($res =~ /^.\s*\#\s*include\s+\<(.*)\>/) {
   1606		my $clean = 'X' x length($1);
   1607		$res =~ s@\<.*\>@<$clean>@;
   1608
   1609	# The whole of a #error is a string.
   1610	} elsif ($res =~ /^.\s*\#\s*(?:error|warning)\s+(.*)\b/) {
   1611		my $clean = 'X' x length($1);
   1612		$res =~ s@(\#\s*(?:error|warning)\s+).*@$1$clean@;
   1613	}
   1614
   1615	if ($allow_c99_comments && $res =~ m@(//.*$)@) {
   1616		my $match = $1;
   1617		$res =~ s/\Q$match\E/"$;" x length($match)/e;
   1618	}
   1619
   1620	return $res;
   1621}
   1622
   1623sub get_quoted_string {
   1624	my ($line, $rawline) = @_;
   1625
   1626	return "" if (!defined($line) || !defined($rawline));
   1627	return "" if ($line !~ m/($String)/g);
   1628	return substr($rawline, $-[0], $+[0] - $-[0]);
   1629}
   1630
   1631sub ctx_statement_block {
   1632	my ($linenr, $remain, $off) = @_;
   1633	my $line = $linenr - 1;
   1634	my $blk = '';
   1635	my $soff = $off;
   1636	my $coff = $off - 1;
   1637	my $coff_set = 0;
   1638
   1639	my $loff = 0;
   1640
   1641	my $type = '';
   1642	my $level = 0;
   1643	my @stack = ();
   1644	my $p;
   1645	my $c;
   1646	my $len = 0;
   1647
   1648	my $remainder;
   1649	while (1) {
   1650		@stack = (['', 0]) if ($#stack == -1);
   1651
   1652		#warn "CSB: blk<$blk> remain<$remain>\n";
   1653		# If we are about to drop off the end, pull in more
   1654		# context.
   1655		if ($off >= $len) {
   1656			for (; $remain > 0; $line++) {
   1657				last if (!defined $lines[$line]);
   1658				next if ($lines[$line] =~ /^-/);
   1659				$remain--;
   1660				$loff = $len;
   1661				$blk .= $lines[$line] . "\n";
   1662				$len = length($blk);
   1663				$line++;
   1664				last;
   1665			}
   1666			# Bail if there is no further context.
   1667			#warn "CSB: blk<$blk> off<$off> len<$len>\n";
   1668			if ($off >= $len) {
   1669				last;
   1670			}
   1671			if ($level == 0 && substr($blk, $off) =~ /^.\s*#\s*define/) {
   1672				$level++;
   1673				$type = '#';
   1674			}
   1675		}
   1676		$p = $c;
   1677		$c = substr($blk, $off, 1);
   1678		$remainder = substr($blk, $off);
   1679
   1680		#warn "CSB: c<$c> type<$type> level<$level> remainder<$remainder> coff_set<$coff_set>\n";
   1681
   1682		# Handle nested #if/#else.
   1683		if ($remainder =~ /^#\s*(?:ifndef|ifdef|if)\s/) {
   1684			push(@stack, [ $type, $level ]);
   1685		} elsif ($remainder =~ /^#\s*(?:else|elif)\b/) {
   1686			($type, $level) = @{$stack[$#stack - 1]};
   1687		} elsif ($remainder =~ /^#\s*endif\b/) {
   1688			($type, $level) = @{pop(@stack)};
   1689		}
   1690
   1691		# Statement ends at the ';' or a close '}' at the
   1692		# outermost level.
   1693		if ($level == 0 && $c eq ';') {
   1694			last;
   1695		}
   1696
   1697		# An else is really a conditional as long as its not else if
   1698		if ($level == 0 && $coff_set == 0 &&
   1699				(!defined($p) || $p =~ /(?:\s|\}|\+)/) &&
   1700				$remainder =~ /^(else)(?:\s|{)/ &&
   1701				$remainder !~ /^else\s+if\b/) {
   1702			$coff = $off + length($1) - 1;
   1703			$coff_set = 1;
   1704			#warn "CSB: mark coff<$coff> soff<$soff> 1<$1>\n";
   1705			#warn "[" . substr($blk, $soff, $coff - $soff + 1) . "]\n";
   1706		}
   1707
   1708		if (($type eq '' || $type eq '(') && $c eq '(') {
   1709			$level++;
   1710			$type = '(';
   1711		}
   1712		if ($type eq '(' && $c eq ')') {
   1713			$level--;
   1714			$type = ($level != 0)? '(' : '';
   1715
   1716			if ($level == 0 && $coff < $soff) {
   1717				$coff = $off;
   1718				$coff_set = 1;
   1719				#warn "CSB: mark coff<$coff>\n";
   1720			}
   1721		}
   1722		if (($type eq '' || $type eq '{') && $c eq '{') {
   1723			$level++;
   1724			$type = '{';
   1725		}
   1726		if ($type eq '{' && $c eq '}') {
   1727			$level--;
   1728			$type = ($level != 0)? '{' : '';
   1729
   1730			if ($level == 0) {
   1731				if (substr($blk, $off + 1, 1) eq ';') {
   1732					$off++;
   1733				}
   1734				last;
   1735			}
   1736		}
   1737		# Preprocessor commands end at the newline unless escaped.
   1738		if ($type eq '#' && $c eq "\n" && $p ne "\\") {
   1739			$level--;
   1740			$type = '';
   1741			$off++;
   1742			last;
   1743		}
   1744		$off++;
   1745	}
   1746	# We are truly at the end, so shuffle to the next line.
   1747	if ($off == $len) {
   1748		$loff = $len + 1;
   1749		$line++;
   1750		$remain--;
   1751	}
   1752
   1753	my $statement = substr($blk, $soff, $off - $soff + 1);
   1754	my $condition = substr($blk, $soff, $coff - $soff + 1);
   1755
   1756	#warn "STATEMENT<$statement>\n";
   1757	#warn "CONDITION<$condition>\n";
   1758
   1759	#print "coff<$coff> soff<$off> loff<$loff>\n";
   1760
   1761	return ($statement, $condition,
   1762			$line, $remain + 1, $off - $loff + 1, $level);
   1763}
   1764
   1765sub statement_lines {
   1766	my ($stmt) = @_;
   1767
   1768	# Strip the diff line prefixes and rip blank lines at start and end.
   1769	$stmt =~ s/(^|\n)./$1/g;
   1770	$stmt =~ s/^\s*//;
   1771	$stmt =~ s/\s*$//;
   1772
   1773	my @stmt_lines = ($stmt =~ /\n/g);
   1774
   1775	return $#stmt_lines + 2;
   1776}
   1777
   1778sub statement_rawlines {
   1779	my ($stmt) = @_;
   1780
   1781	my @stmt_lines = ($stmt =~ /\n/g);
   1782
   1783	return $#stmt_lines + 2;
   1784}
   1785
   1786sub statement_block_size {
   1787	my ($stmt) = @_;
   1788
   1789	$stmt =~ s/(^|\n)./$1/g;
   1790	$stmt =~ s/^\s*{//;
   1791	$stmt =~ s/}\s*$//;
   1792	$stmt =~ s/^\s*//;
   1793	$stmt =~ s/\s*$//;
   1794
   1795	my @stmt_lines = ($stmt =~ /\n/g);
   1796	my @stmt_statements = ($stmt =~ /;/g);
   1797
   1798	my $stmt_lines = $#stmt_lines + 2;
   1799	my $stmt_statements = $#stmt_statements + 1;
   1800
   1801	if ($stmt_lines > $stmt_statements) {
   1802		return $stmt_lines;
   1803	} else {
   1804		return $stmt_statements;
   1805	}
   1806}
   1807
   1808sub ctx_statement_full {
   1809	my ($linenr, $remain, $off) = @_;
   1810	my ($statement, $condition, $level);
   1811
   1812	my (@chunks);
   1813
   1814	# Grab the first conditional/block pair.
   1815	($statement, $condition, $linenr, $remain, $off, $level) =
   1816				ctx_statement_block($linenr, $remain, $off);
   1817	#print "F: c<$condition> s<$statement> remain<$remain>\n";
   1818	push(@chunks, [ $condition, $statement ]);
   1819	if (!($remain > 0 && $condition =~ /^\s*(?:\n[+-])?\s*(?:if|else|do)\b/s)) {
   1820		return ($level, $linenr, @chunks);
   1821	}
   1822
   1823	# Pull in the following conditional/block pairs and see if they
   1824	# could continue the statement.
   1825	for (;;) {
   1826		($statement, $condition, $linenr, $remain, $off, $level) =
   1827				ctx_statement_block($linenr, $remain, $off);
   1828		#print "C: c<$condition> s<$statement> remain<$remain>\n";
   1829		last if (!($remain > 0 && $condition =~ /^(?:\s*\n[+-])*\s*(?:else|do)\b/s));
   1830		#print "C: push\n";
   1831		push(@chunks, [ $condition, $statement ]);
   1832	}
   1833
   1834	return ($level, $linenr, @chunks);
   1835}
   1836
   1837sub ctx_block_get {
   1838	my ($linenr, $remain, $outer, $open, $close, $off) = @_;
   1839	my $line;
   1840	my $start = $linenr - 1;
   1841	my $blk = '';
   1842	my @o;
   1843	my @c;
   1844	my @res = ();
   1845
   1846	my $level = 0;
   1847	my @stack = ($level);
   1848	for ($line = $start; $remain > 0; $line++) {
   1849		next if ($rawlines[$line] =~ /^-/);
   1850		$remain--;
   1851
   1852		$blk .= $rawlines[$line];
   1853
   1854		# Handle nested #if/#else.
   1855		if ($lines[$line] =~ /^.\s*#\s*(?:ifndef|ifdef|if)\s/) {
   1856			push(@stack, $level);
   1857		} elsif ($lines[$line] =~ /^.\s*#\s*(?:else|elif)\b/) {
   1858			$level = $stack[$#stack - 1];
   1859		} elsif ($lines[$line] =~ /^.\s*#\s*endif\b/) {
   1860			$level = pop(@stack);
   1861		}
   1862
   1863		foreach my $c (split(//, $lines[$line])) {
   1864			##print "C<$c>L<$level><$open$close>O<$off>\n";
   1865			if ($off > 0) {
   1866				$off--;
   1867				next;
   1868			}
   1869
   1870			if ($c eq $close && $level > 0) {
   1871				$level--;
   1872				last if ($level == 0);
   1873			} elsif ($c eq $open) {
   1874				$level++;
   1875			}
   1876		}
   1877
   1878		if (!$outer || $level <= 1) {
   1879			push(@res, $rawlines[$line]);
   1880		}
   1881
   1882		last if ($level == 0);
   1883	}
   1884
   1885	return ($level, @res);
   1886}
   1887sub ctx_block_outer {
   1888	my ($linenr, $remain) = @_;
   1889
   1890	my ($level, @r) = ctx_block_get($linenr, $remain, 1, '{', '}', 0);
   1891	return @r;
   1892}
   1893sub ctx_block {
   1894	my ($linenr, $remain) = @_;
   1895
   1896	my ($level, @r) = ctx_block_get($linenr, $remain, 0, '{', '}', 0);
   1897	return @r;
   1898}
   1899sub ctx_statement {
   1900	my ($linenr, $remain, $off) = @_;
   1901
   1902	my ($level, @r) = ctx_block_get($linenr, $remain, 0, '(', ')', $off);
   1903	return @r;
   1904}
   1905sub ctx_block_level {
   1906	my ($linenr, $remain) = @_;
   1907
   1908	return ctx_block_get($linenr, $remain, 0, '{', '}', 0);
   1909}
   1910sub ctx_statement_level {
   1911	my ($linenr, $remain, $off) = @_;
   1912
   1913	return ctx_block_get($linenr, $remain, 0, '(', ')', $off);
   1914}
   1915
   1916sub ctx_locate_comment {
   1917	my ($first_line, $end_line) = @_;
   1918
   1919	# If c99 comment on the current line, or the line before or after
   1920	my ($current_comment) = ($rawlines[$end_line - 1] =~ m@^\+.*(//.*$)@);
   1921	return $current_comment if (defined $current_comment);
   1922	($current_comment) = ($rawlines[$end_line - 2] =~ m@^[\+ ].*(//.*$)@);
   1923	return $current_comment if (defined $current_comment);
   1924	($current_comment) = ($rawlines[$end_line] =~ m@^[\+ ].*(//.*$)@);
   1925	return $current_comment if (defined $current_comment);
   1926
   1927	# Catch a comment on the end of the line itself.
   1928	($current_comment) = ($rawlines[$end_line - 1] =~ m@.*(/\*.*\*/)\s*(?:\\\s*)?$@);
   1929	return $current_comment if (defined $current_comment);
   1930
   1931	# Look through the context and try and figure out if there is a
   1932	# comment.
   1933	my $in_comment = 0;
   1934	$current_comment = '';
   1935	for (my $linenr = $first_line; $linenr < $end_line; $linenr++) {
   1936		my $line = $rawlines[$linenr - 1];
   1937		#warn "           $line\n";
   1938		if ($linenr == $first_line and $line =~ m@^.\s*\*@) {
   1939			$in_comment = 1;
   1940		}
   1941		if ($line =~ m@/\*@) {
   1942			$in_comment = 1;
   1943		}
   1944		if (!$in_comment && $current_comment ne '') {
   1945			$current_comment = '';
   1946		}
   1947		$current_comment .= $line . "\n" if ($in_comment);
   1948		if ($line =~ m@\*/@) {
   1949			$in_comment = 0;
   1950		}
   1951	}
   1952
   1953	chomp($current_comment);
   1954	return($current_comment);
   1955}
   1956sub ctx_has_comment {
   1957	my ($first_line, $end_line) = @_;
   1958	my $cmt = ctx_locate_comment($first_line, $end_line);
   1959
   1960	##print "LINE: $rawlines[$end_line - 1 ]\n";
   1961	##print "CMMT: $cmt\n";
   1962
   1963	return ($cmt ne '');
   1964}
   1965
   1966sub raw_line {
   1967	my ($linenr, $cnt) = @_;
   1968
   1969	my $offset = $linenr - 1;
   1970	$cnt++;
   1971
   1972	my $line;
   1973	while ($cnt) {
   1974		$line = $rawlines[$offset++];
   1975		next if (defined($line) && $line =~ /^-/);
   1976		$cnt--;
   1977	}
   1978
   1979	return $line;
   1980}
   1981
   1982sub get_stat_real {
   1983	my ($linenr, $lc) = @_;
   1984
   1985	my $stat_real = raw_line($linenr, 0);
   1986	for (my $count = $linenr + 1; $count <= $lc; $count++) {
   1987		$stat_real = $stat_real . "\n" . raw_line($count, 0);
   1988	}
   1989
   1990	return $stat_real;
   1991}
   1992
   1993sub get_stat_here {
   1994	my ($linenr, $cnt, $here) = @_;
   1995
   1996	my $herectx = $here . "\n";
   1997	for (my $n = 0; $n < $cnt; $n++) {
   1998		$herectx .= raw_line($linenr, $n) . "\n";
   1999	}
   2000
   2001	return $herectx;
   2002}
   2003
   2004sub cat_vet {
   2005	my ($vet) = @_;
   2006	my ($res, $coded);
   2007
   2008	$res = '';
   2009	while ($vet =~ /([^[:cntrl:]]*)([[:cntrl:]]|$)/g) {
   2010		$res .= $1;
   2011		if ($2 ne '') {
   2012			$coded = sprintf("^%c", unpack('C', $2) + 64);
   2013			$res .= $coded;
   2014		}
   2015	}
   2016	$res =~ s/$/\$/;
   2017
   2018	return $res;
   2019}
   2020
   2021my $av_preprocessor = 0;
   2022my $av_pending;
   2023my @av_paren_type;
   2024my $av_pend_colon;
   2025
   2026sub annotate_reset {
   2027	$av_preprocessor = 0;
   2028	$av_pending = '_';
   2029	@av_paren_type = ('E');
   2030	$av_pend_colon = 'O';
   2031}
   2032
   2033sub annotate_values {
   2034	my ($stream, $type) = @_;
   2035
   2036	my $res;
   2037	my $var = '_' x length($stream);
   2038	my $cur = $stream;
   2039
   2040	print "$stream\n" if ($dbg_values > 1);
   2041
   2042	while (length($cur)) {
   2043		@av_paren_type = ('E') if ($#av_paren_type < 0);
   2044		print " <" . join('', @av_paren_type) .
   2045				"> <$type> <$av_pending>" if ($dbg_values > 1);
   2046		if ($cur =~ /^(\s+)/o) {
   2047			print "WS($1)\n" if ($dbg_values > 1);
   2048			if ($1 =~ /\n/ && $av_preprocessor) {
   2049				$type = pop(@av_paren_type);
   2050				$av_preprocessor = 0;
   2051			}
   2052
   2053		} elsif ($cur =~ /^(\(\s*$Type\s*)\)/ && $av_pending eq '_') {
   2054			print "CAST($1)\n" if ($dbg_values > 1);
   2055			push(@av_paren_type, $type);
   2056			$type = 'c';
   2057
   2058		} elsif ($cur =~ /^($Type)\s*(?:$Ident|,|\)|\(|\s*$)/) {
   2059			print "DECLARE($1)\n" if ($dbg_values > 1);
   2060			$type = 'T';
   2061
   2062		} elsif ($cur =~ /^($Modifier)\s*/) {
   2063			print "MODIFIER($1)\n" if ($dbg_values > 1);
   2064			$type = 'T';
   2065
   2066		} elsif ($cur =~ /^(\#\s*define\s*$Ident)(\(?)/o) {
   2067			print "DEFINE($1,$2)\n" if ($dbg_values > 1);
   2068			$av_preprocessor = 1;
   2069			push(@av_paren_type, $type);
   2070			if ($2 ne '') {
   2071				$av_pending = 'N';
   2072			}
   2073			$type = 'E';
   2074
   2075		} elsif ($cur =~ /^(\#\s*(?:undef\s*$Ident|include\b))/o) {
   2076			print "UNDEF($1)\n" if ($dbg_values > 1);
   2077			$av_preprocessor = 1;
   2078			push(@av_paren_type, $type);
   2079
   2080		} elsif ($cur =~ /^(\#\s*(?:ifdef|ifndef|if))/o) {
   2081			print "PRE_START($1)\n" if ($dbg_values > 1);
   2082			$av_preprocessor = 1;
   2083
   2084			push(@av_paren_type, $type);
   2085			push(@av_paren_type, $type);
   2086			$type = 'E';
   2087
   2088		} elsif ($cur =~ /^(\#\s*(?:else|elif))/o) {
   2089			print "PRE_RESTART($1)\n" if ($dbg_values > 1);
   2090			$av_preprocessor = 1;
   2091
   2092			push(@av_paren_type, $av_paren_type[$#av_paren_type]);
   2093
   2094			$type = 'E';
   2095
   2096		} elsif ($cur =~ /^(\#\s*(?:endif))/o) {
   2097			print "PRE_END($1)\n" if ($dbg_values > 1);
   2098
   2099			$av_preprocessor = 1;
   2100
   2101			# Assume all arms of the conditional end as this
   2102			# one does, and continue as if the #endif was not here.
   2103			pop(@av_paren_type);
   2104			push(@av_paren_type, $type);
   2105			$type = 'E';
   2106
   2107		} elsif ($cur =~ /^(\\\n)/o) {
   2108			print "PRECONT($1)\n" if ($dbg_values > 1);
   2109
   2110		} elsif ($cur =~ /^(__attribute__)\s*\(?/o) {
   2111			print "ATTR($1)\n" if ($dbg_values > 1);
   2112			$av_pending = $type;
   2113			$type = 'N';
   2114
   2115		} elsif ($cur =~ /^(sizeof)\s*(\()?/o) {
   2116			print "SIZEOF($1)\n" if ($dbg_values > 1);
   2117			if (defined $2) {
   2118				$av_pending = 'V';
   2119			}
   2120			$type = 'N';
   2121
   2122		} elsif ($cur =~ /^(if|while|for)\b/o) {
   2123			print "COND($1)\n" if ($dbg_values > 1);
   2124			$av_pending = 'E';
   2125			$type = 'N';
   2126
   2127		} elsif ($cur =~/^(case)/o) {
   2128			print "CASE($1)\n" if ($dbg_values > 1);
   2129			$av_pend_colon = 'C';
   2130			$type = 'N';
   2131
   2132		} elsif ($cur =~/^(return|else|goto|typeof|__typeof__)\b/o) {
   2133			print "KEYWORD($1)\n" if ($dbg_values > 1);
   2134			$type = 'N';
   2135
   2136		} elsif ($cur =~ /^(\()/o) {
   2137			print "PAREN('$1')\n" if ($dbg_values > 1);
   2138			push(@av_paren_type, $av_pending);
   2139			$av_pending = '_';
   2140			$type = 'N';
   2141
   2142		} elsif ($cur =~ /^(\))/o) {
   2143			my $new_type = pop(@av_paren_type);
   2144			if ($new_type ne '_') {
   2145				$type = $new_type;
   2146				print "PAREN('$1') -> $type\n"
   2147							if ($dbg_values > 1);
   2148			} else {
   2149				print "PAREN('$1')\n" if ($dbg_values > 1);
   2150			}
   2151
   2152		} elsif ($cur =~ /^($Ident)\s*\(/o) {
   2153			print "FUNC($1)\n" if ($dbg_values > 1);
   2154			$type = 'V';
   2155			$av_pending = 'V';
   2156
   2157		} elsif ($cur =~ /^($Ident\s*):(?:\s*\d+\s*(,|=|;))?/) {
   2158			if (defined $2 && $type eq 'C' || $type eq 'T') {
   2159				$av_pend_colon = 'B';
   2160			} elsif ($type eq 'E') {
   2161				$av_pend_colon = 'L';
   2162			}
   2163			print "IDENT_COLON($1,$type>$av_pend_colon)\n" if ($dbg_values > 1);
   2164			$type = 'V';
   2165
   2166		} elsif ($cur =~ /^($Ident|$Constant)/o) {
   2167			print "IDENT($1)\n" if ($dbg_values > 1);
   2168			$type = 'V';
   2169
   2170		} elsif ($cur =~ /^($Assignment)/o) {
   2171			print "ASSIGN($1)\n" if ($dbg_values > 1);
   2172			$type = 'N';
   2173
   2174		} elsif ($cur =~/^(;|{|})/) {
   2175			print "END($1)\n" if ($dbg_values > 1);
   2176			$type = 'E';
   2177			$av_pend_colon = 'O';
   2178
   2179		} elsif ($cur =~/^(,)/) {
   2180			print "COMMA($1)\n" if ($dbg_values > 1);
   2181			$type = 'C';
   2182
   2183		} elsif ($cur =~ /^(\?)/o) {
   2184			print "QUESTION($1)\n" if ($dbg_values > 1);
   2185			$type = 'N';
   2186
   2187		} elsif ($cur =~ /^(:)/o) {
   2188			print "COLON($1,$av_pend_colon)\n" if ($dbg_values > 1);
   2189
   2190			substr($var, length($res), 1, $av_pend_colon);
   2191			if ($av_pend_colon eq 'C' || $av_pend_colon eq 'L') {
   2192				$type = 'E';
   2193			} else {
   2194				$type = 'N';
   2195			}
   2196			$av_pend_colon = 'O';
   2197
   2198		} elsif ($cur =~ /^(\[)/o) {
   2199			print "CLOSE($1)\n" if ($dbg_values > 1);
   2200			$type = 'N';
   2201
   2202		} elsif ($cur =~ /^(-(?![->])|\+(?!\+)|\*|\&\&|\&)/o) {
   2203			my $variant;
   2204
   2205			print "OPV($1)\n" if ($dbg_values > 1);
   2206			if ($type eq 'V') {
   2207				$variant = 'B';
   2208			} else {
   2209				$variant = 'U';
   2210			}
   2211
   2212			substr($var, length($res), 1, $variant);
   2213			$type = 'N';
   2214
   2215		} elsif ($cur =~ /^($Operators)/o) {
   2216			print "OP($1)\n" if ($dbg_values > 1);
   2217			if ($1 ne '++' && $1 ne '--') {
   2218				$type = 'N';
   2219			}
   2220
   2221		} elsif ($cur =~ /(^.)/o) {
   2222			print "C($1)\n" if ($dbg_values > 1);
   2223		}
   2224		if (defined $1) {
   2225			$cur = substr($cur, length($1));
   2226			$res .= $type x length($1);
   2227		}
   2228	}
   2229
   2230	return ($res, $var);
   2231}
   2232
   2233sub possible {
   2234	my ($possible, $line) = @_;
   2235	my $notPermitted = qr{(?:
   2236		^(?:
   2237			$Modifier|
   2238			$Storage|
   2239			$Type|
   2240			DEFINE_\S+
   2241		)$|
   2242		^(?:
   2243			goto|
   2244			return|
   2245			case|
   2246			else|
   2247			asm|__asm__|
   2248			do|
   2249			\#|
   2250			\#\#|
   2251		)(?:\s|$)|
   2252		^(?:typedef|struct|enum)\b
   2253	    )}x;
   2254	warn "CHECK<$possible> ($line)\n" if ($dbg_possible > 2);
   2255	if ($possible !~ $notPermitted) {
   2256		# Check for modifiers.
   2257		$possible =~ s/\s*$Storage\s*//g;
   2258		$possible =~ s/\s*$Sparse\s*//g;
   2259		if ($possible =~ /^\s*$/) {
   2260
   2261		} elsif ($possible =~ /\s/) {
   2262			$possible =~ s/\s*$Type\s*//g;
   2263			for my $modifier (split(' ', $possible)) {
   2264				if ($modifier !~ $notPermitted) {
   2265					warn "MODIFIER: $modifier ($possible) ($line)\n" if ($dbg_possible);
   2266					push(@modifierListFile, $modifier);
   2267				}
   2268			}
   2269
   2270		} else {
   2271			warn "POSSIBLE: $possible ($line)\n" if ($dbg_possible);
   2272			push(@typeListFile, $possible);
   2273		}
   2274		build_types();
   2275	} else {
   2276		warn "NOTPOSS: $possible ($line)\n" if ($dbg_possible > 1);
   2277	}
   2278}
   2279
   2280my $prefix = '';
   2281
   2282sub show_type {
   2283	my ($type) = @_;
   2284
   2285	$type =~ tr/[a-z]/[A-Z]/;
   2286
   2287	return defined $use_type{$type} if (scalar keys %use_type > 0);
   2288
   2289	return !defined $ignore_type{$type};
   2290}
   2291
   2292sub report {
   2293	my ($level, $type, $msg) = @_;
   2294
   2295	if (!show_type($type) ||
   2296	    (defined $tst_only && $msg !~ /\Q$tst_only\E/)) {
   2297		return 0;
   2298	}
   2299	my $output = '';
   2300	if ($color) {
   2301		if ($level eq 'ERROR') {
   2302			$output .= RED;
   2303		} elsif ($level eq 'WARNING') {
   2304			$output .= YELLOW;
   2305		} else {
   2306			$output .= GREEN;
   2307		}
   2308	}
   2309	$output .= $prefix . $level . ':';
   2310	if ($show_types) {
   2311		$output .= BLUE if ($color);
   2312		$output .= "$type:";
   2313	}
   2314	$output .= RESET if ($color);
   2315	$output .= ' ' . $msg . "\n";
   2316
   2317	if ($showfile) {
   2318		my @lines = split("\n", $output, -1);
   2319		splice(@lines, 1, 1);
   2320		$output = join("\n", @lines);
   2321	}
   2322
   2323	if ($terse) {
   2324		$output = (split('\n', $output))[0] . "\n";
   2325	}
   2326
   2327	if ($verbose && exists($verbose_messages{$type}) &&
   2328	    !exists($verbose_emitted{$type})) {
   2329		$output .= $verbose_messages{$type} . "\n\n";
   2330		$verbose_emitted{$type} = 1;
   2331	}
   2332
   2333	push(our @report, $output);
   2334
   2335	return 1;
   2336}
   2337
   2338sub report_dump {
   2339	our @report;
   2340}
   2341
   2342sub fixup_current_range {
   2343	my ($lineRef, $offset, $length) = @_;
   2344
   2345	if ($$lineRef =~ /^\@\@ -\d+,\d+ \+(\d+),(\d+) \@\@/) {
   2346		my $o = $1;
   2347		my $l = $2;
   2348		my $no = $o + $offset;
   2349		my $nl = $l + $length;
   2350		$$lineRef =~ s/\+$o,$l \@\@/\+$no,$nl \@\@/;
   2351	}
   2352}
   2353
   2354sub fix_inserted_deleted_lines {
   2355	my ($linesRef, $insertedRef, $deletedRef) = @_;
   2356
   2357	my $range_last_linenr = 0;
   2358	my $delta_offset = 0;
   2359
   2360	my $old_linenr = 0;
   2361	my $new_linenr = 0;
   2362
   2363	my $next_insert = 0;
   2364	my $next_delete = 0;
   2365
   2366	my @lines = ();
   2367
   2368	my $inserted = @{$insertedRef}[$next_insert++];
   2369	my $deleted = @{$deletedRef}[$next_delete++];
   2370
   2371	foreach my $old_line (@{$linesRef}) {
   2372		my $save_line = 1;
   2373		my $line = $old_line;	#don't modify the array
   2374		if ($line =~ /^(?:\+\+\+|\-\-\-)\s+\S+/) {	#new filename
   2375			$delta_offset = 0;
   2376		} elsif ($line =~ /^\@\@ -\d+,\d+ \+\d+,\d+ \@\@/) {	#new hunk
   2377			$range_last_linenr = $new_linenr;
   2378			fixup_current_range(\$line, $delta_offset, 0);
   2379		}
   2380
   2381		while (defined($deleted) && ${$deleted}{'LINENR'} == $old_linenr) {
   2382			$deleted = @{$deletedRef}[$next_delete++];
   2383			$save_line = 0;
   2384			fixup_current_range(\$lines[$range_last_linenr], $delta_offset--, -1);
   2385		}
   2386
   2387		while (defined($inserted) && ${$inserted}{'LINENR'} == $old_linenr) {
   2388			push(@lines, ${$inserted}{'LINE'});
   2389			$inserted = @{$insertedRef}[$next_insert++];
   2390			$new_linenr++;
   2391			fixup_current_range(\$lines[$range_last_linenr], $delta_offset++, 1);
   2392		}
   2393
   2394		if ($save_line) {
   2395			push(@lines, $line);
   2396			$new_linenr++;
   2397		}
   2398
   2399		$old_linenr++;
   2400	}
   2401
   2402	return @lines;
   2403}
   2404
   2405sub fix_insert_line {
   2406	my ($linenr, $line) = @_;
   2407
   2408	my $inserted = {
   2409		LINENR => $linenr,
   2410		LINE => $line,
   2411	};
   2412	push(@fixed_inserted, $inserted);
   2413}
   2414
   2415sub fix_delete_line {
   2416	my ($linenr, $line) = @_;
   2417
   2418	my $deleted = {
   2419		LINENR => $linenr,
   2420		LINE => $line,
   2421	};
   2422
   2423	push(@fixed_deleted, $deleted);
   2424}
   2425
   2426sub ERROR {
   2427	my ($type, $msg) = @_;
   2428
   2429	if (report("ERROR", $type, $msg)) {
   2430		our $clean = 0;
   2431		our $cnt_error++;
   2432		return 1;
   2433	}
   2434	return 0;
   2435}
   2436sub WARN {
   2437	my ($type, $msg) = @_;
   2438
   2439	if (report("WARNING", $type, $msg)) {
   2440		our $clean = 0;
   2441		our $cnt_warn++;
   2442		return 1;
   2443	}
   2444	return 0;
   2445}
   2446sub CHK {
   2447	my ($type, $msg) = @_;
   2448
   2449	if ($check && report("CHECK", $type, $msg)) {
   2450		our $clean = 0;
   2451		our $cnt_chk++;
   2452		return 1;
   2453	}
   2454	return 0;
   2455}
   2456
   2457sub check_absolute_file {
   2458	my ($absolute, $herecurr) = @_;
   2459	my $file = $absolute;
   2460
   2461	##print "absolute<$absolute>\n";
   2462
   2463	# See if any suffix of this path is a path within the tree.
   2464	while ($file =~ s@^[^/]*/@@) {
   2465		if (-f "$root/$file") {
   2466			##print "file<$file>\n";
   2467			last;
   2468		}
   2469	}
   2470	if (! -f _)  {
   2471		return 0;
   2472	}
   2473
   2474	# It is, so see if the prefix is acceptable.
   2475	my $prefix = $absolute;
   2476	substr($prefix, -length($file)) = '';
   2477
   2478	##print "prefix<$prefix>\n";
   2479	if ($prefix ne ".../") {
   2480		WARN("USE_RELATIVE_PATH",
   2481		     "use relative pathname instead of absolute in changelog text\n" . $herecurr);
   2482	}
   2483}
   2484
   2485sub trim {
   2486	my ($string) = @_;
   2487
   2488	$string =~ s/^\s+|\s+$//g;
   2489
   2490	return $string;
   2491}
   2492
   2493sub ltrim {
   2494	my ($string) = @_;
   2495
   2496	$string =~ s/^\s+//;
   2497
   2498	return $string;
   2499}
   2500
   2501sub rtrim {
   2502	my ($string) = @_;
   2503
   2504	$string =~ s/\s+$//;
   2505
   2506	return $string;
   2507}
   2508
   2509sub string_find_replace {
   2510	my ($string, $find, $replace) = @_;
   2511
   2512	$string =~ s/$find/$replace/g;
   2513
   2514	return $string;
   2515}
   2516
   2517sub tabify {
   2518	my ($leading) = @_;
   2519
   2520	my $source_indent = $tabsize;
   2521	my $max_spaces_before_tab = $source_indent - 1;
   2522	my $spaces_to_tab = " " x $source_indent;
   2523
   2524	#convert leading spaces to tabs
   2525	1 while $leading =~ s@^([\t]*)$spaces_to_tab@$1\t@g;
   2526	#Remove spaces before a tab
   2527	1 while $leading =~ s@^([\t]*)( {1,$max_spaces_before_tab})\t@$1\t@g;
   2528
   2529	return "$leading";
   2530}
   2531
   2532sub pos_last_openparen {
   2533	my ($line) = @_;
   2534
   2535	my $pos = 0;
   2536
   2537	my $opens = $line =~ tr/\(/\(/;
   2538	my $closes = $line =~ tr/\)/\)/;
   2539
   2540	my $last_openparen = 0;
   2541
   2542	if (($opens == 0) || ($closes >= $opens)) {
   2543		return -1;
   2544	}
   2545
   2546	my $len = length($line);
   2547
   2548	for ($pos = 0; $pos < $len; $pos++) {
   2549		my $string = substr($line, $pos);
   2550		if ($string =~ /^($FuncArg|$balanced_parens)/) {
   2551			$pos += length($1) - 1;
   2552		} elsif (substr($line, $pos, 1) eq '(') {
   2553			$last_openparen = $pos;
   2554		} elsif (index($string, '(') == -1) {
   2555			last;
   2556		}
   2557	}
   2558
   2559	return length(expand_tabs(substr($line, 0, $last_openparen))) + 1;
   2560}
   2561
   2562sub get_raw_comment {
   2563	my ($line, $rawline) = @_;
   2564	my $comment = '';
   2565
   2566	for my $i (0 .. (length($line) - 1)) {
   2567		if (substr($line, $i, 1) eq "$;") {
   2568			$comment .= substr($rawline, $i, 1);
   2569		}
   2570	}
   2571
   2572	return $comment;
   2573}
   2574
   2575sub exclude_global_initialisers {
   2576	my ($realfile) = @_;
   2577
   2578	# Do not check for BPF programs (tools/testing/selftests/bpf/progs/*.c, samples/bpf/*_kern.c, *.bpf.c).
   2579	return $realfile =~ m@^tools/testing/selftests/bpf/progs/.*\.c$@ ||
   2580		$realfile =~ m@^samples/bpf/.*_kern\.c$@ ||
   2581		$realfile =~ m@/bpf/.*\.bpf\.c$@;
   2582}
   2583
   2584sub process {
   2585	my $filename = shift;
   2586
   2587	my $linenr=0;
   2588	my $prevline="";
   2589	my $prevrawline="";
   2590	my $stashline="";
   2591	my $stashrawline="";
   2592
   2593	my $length;
   2594	my $indent;
   2595	my $previndent=0;
   2596	my $stashindent=0;
   2597
   2598	our $clean = 1;
   2599	my $signoff = 0;
   2600	my $author = '';
   2601	my $authorsignoff = 0;
   2602	my $author_sob = '';
   2603	my $is_patch = 0;
   2604	my $is_binding_patch = -1;
   2605	my $in_header_lines = $file ? 0 : 1;
   2606	my $in_commit_log = 0;		#Scanning lines before patch
   2607	my $has_patch_separator = 0;	#Found a --- line
   2608	my $has_commit_log = 0;		#Encountered lines before patch
   2609	my $commit_log_lines = 0;	#Number of commit log lines
   2610	my $commit_log_possible_stack_dump = 0;
   2611	my $commit_log_long_line = 0;
   2612	my $commit_log_has_diff = 0;
   2613	my $reported_maintainer_file = 0;
   2614	my $non_utf8_charset = 0;
   2615
   2616	my $last_git_commit_id_linenr = -1;
   2617
   2618	my $last_blank_line = 0;
   2619	my $last_coalesced_string_linenr = -1;
   2620
   2621	our @report = ();
   2622	our $cnt_lines = 0;
   2623	our $cnt_error = 0;
   2624	our $cnt_warn = 0;
   2625	our $cnt_chk = 0;
   2626
   2627	# Trace the real file/line as we go.
   2628	my $realfile = '';
   2629	my $realline = 0;
   2630	my $realcnt = 0;
   2631	my $here = '';
   2632	my $context_function;		#undef'd unless there's a known function
   2633	my $in_comment = 0;
   2634	my $comment_edge = 0;
   2635	my $first_line = 0;
   2636	my $p1_prefix = '';
   2637
   2638	my $prev_values = 'E';
   2639
   2640	# suppression flags
   2641	my %suppress_ifbraces;
   2642	my %suppress_whiletrailers;
   2643	my %suppress_export;
   2644	my $suppress_statement = 0;
   2645
   2646	my %signatures = ();
   2647
   2648	# Pre-scan the patch sanitizing the lines.
   2649	# Pre-scan the patch looking for any __setup documentation.
   2650	#
   2651	my @setup_docs = ();
   2652	my $setup_docs = 0;
   2653
   2654	my $camelcase_file_seeded = 0;
   2655
   2656	my $checklicenseline = 1;
   2657
   2658	sanitise_line_reset();
   2659	my $line;
   2660	foreach my $rawline (@rawlines) {
   2661		$linenr++;
   2662		$line = $rawline;
   2663
   2664		push(@fixed, $rawline) if ($fix);
   2665
   2666		if ($rawline=~/^\+\+\+\s+(\S+)/) {
   2667			$setup_docs = 0;
   2668			if ($1 =~ m@Documentation/admin-guide/kernel-parameters.txt$@) {
   2669				$setup_docs = 1;
   2670			}
   2671			#next;
   2672		}
   2673		if ($rawline =~ /^\@\@ -\d+(?:,\d+)? \+(\d+)(,(\d+))? \@\@/) {
   2674			$realline=$1-1;
   2675			if (defined $2) {
   2676				$realcnt=$3+1;
   2677			} else {
   2678				$realcnt=1+1;
   2679			}
   2680			$in_comment = 0;
   2681
   2682			# Guestimate if this is a continuing comment.  Run
   2683			# the context looking for a comment "edge".  If this
   2684			# edge is a close comment then we must be in a comment
   2685			# at context start.
   2686			my $edge;
   2687			my $cnt = $realcnt;
   2688			for (my $ln = $linenr + 1; $cnt > 0; $ln++) {
   2689				next if (defined $rawlines[$ln - 1] &&
   2690					 $rawlines[$ln - 1] =~ /^-/);
   2691				$cnt--;
   2692				#print "RAW<$rawlines[$ln - 1]>\n";
   2693				last if (!defined $rawlines[$ln - 1]);
   2694				if ($rawlines[$ln - 1] =~ m@(/\*|\*/)@ &&
   2695				    $rawlines[$ln - 1] !~ m@"[^"]*(?:/\*|\*/)[^"]*"@) {
   2696					($edge) = $1;
   2697					last;
   2698				}
   2699			}
   2700			if (defined $edge && $edge eq '*/') {
   2701				$in_comment = 1;
   2702			}
   2703
   2704			# Guestimate if this is a continuing comment.  If this
   2705			# is the start of a diff block and this line starts
   2706			# ' *' then it is very likely a comment.
   2707			if (!defined $edge &&
   2708			    $rawlines[$linenr] =~ m@^.\s*(?:\*\*+| \*)(?:\s|$)@)
   2709			{
   2710				$in_comment = 1;
   2711			}
   2712
   2713			##print "COMMENT:$in_comment edge<$edge> $rawline\n";
   2714			sanitise_line_reset($in_comment);
   2715
   2716		} elsif ($realcnt && $rawline =~ /^(?:\+| |$)/) {
   2717			# Standardise the strings and chars within the input to
   2718			# simplify matching -- only bother with positive lines.
   2719			$line = sanitise_line($rawline);
   2720		}
   2721		push(@lines, $line);
   2722
   2723		if ($realcnt > 1) {
   2724			$realcnt-- if ($line =~ /^(?:\+| |$)/);
   2725		} else {
   2726			$realcnt = 0;
   2727		}
   2728
   2729		#print "==>$rawline\n";
   2730		#print "-->$line\n";
   2731
   2732		if ($setup_docs && $line =~ /^\+/) {
   2733			push(@setup_docs, $line);
   2734		}
   2735	}
   2736
   2737	$prefix = '';
   2738
   2739	$realcnt = 0;
   2740	$linenr = 0;
   2741	$fixlinenr = -1;
   2742	foreach my $line (@lines) {
   2743		$linenr++;
   2744		$fixlinenr++;
   2745		my $sline = $line;	#copy of $line
   2746		$sline =~ s/$;/ /g;	#with comments as spaces
   2747
   2748		my $rawline = $rawlines[$linenr - 1];
   2749		my $raw_comment = get_raw_comment($line, $rawline);
   2750
   2751# check if it's a mode change, rename or start of a patch
   2752		if (!$in_commit_log &&
   2753		    ($line =~ /^ mode change [0-7]+ => [0-7]+ \S+\s*$/ ||
   2754		    ($line =~ /^rename (?:from|to) \S+\s*$/ ||
   2755		     $line =~ /^diff --git a\/[\w\/\.\_\-]+ b\/\S+\s*$/))) {
   2756			$is_patch = 1;
   2757		}
   2758
   2759#extract the line range in the file after the patch is applied
   2760		if (!$in_commit_log &&
   2761		    $line =~ /^\@\@ -\d+(?:,\d+)? \+(\d+)(,(\d+))? \@\@(.*)/) {
   2762			my $context = $4;
   2763			$is_patch = 1;
   2764			$first_line = $linenr + 1;
   2765			$realline=$1-1;
   2766			if (defined $2) {
   2767				$realcnt=$3+1;
   2768			} else {
   2769				$realcnt=1+1;
   2770			}
   2771			annotate_reset();
   2772			$prev_values = 'E';
   2773
   2774			%suppress_ifbraces = ();
   2775			%suppress_whiletrailers = ();
   2776			%suppress_export = ();
   2777			$suppress_statement = 0;
   2778			if ($context =~ /\b(\w+)\s*\(/) {
   2779				$context_function = $1;
   2780			} else {
   2781				undef $context_function;
   2782			}
   2783			next;
   2784
   2785# track the line number as we move through the hunk, note that
   2786# new versions of GNU diff omit the leading space on completely
   2787# blank context lines so we need to count that too.
   2788		} elsif ($line =~ /^( |\+|$)/) {
   2789			$realline++;
   2790			$realcnt-- if ($realcnt != 0);
   2791
   2792			# Measure the line length and indent.
   2793			($length, $indent) = line_stats($rawline);
   2794
   2795			# Track the previous line.
   2796			($prevline, $stashline) = ($stashline, $line);
   2797			($previndent, $stashindent) = ($stashindent, $indent);
   2798			($prevrawline, $stashrawline) = ($stashrawline, $rawline);
   2799
   2800			#warn "line<$line>\n";
   2801
   2802		} elsif ($realcnt == 1) {
   2803			$realcnt--;
   2804		}
   2805
   2806		my $hunk_line = ($realcnt != 0);
   2807
   2808		$here = "#$linenr: " if (!$file);
   2809		$here = "#$realline: " if ($file);
   2810
   2811		my $found_file = 0;
   2812		# extract the filename as it passes
   2813		if ($line =~ /^diff --git.*?(\S+)$/) {
   2814			$realfile = $1;
   2815			$realfile =~ s@^([^/]*)/@@ if (!$file);
   2816			$in_commit_log = 0;
   2817			$found_file = 1;
   2818		} elsif ($line =~ /^\+\+\+\s+(\S+)/) {
   2819			$realfile = $1;
   2820			$realfile =~ s@^([^/]*)/@@ if (!$file);
   2821			$in_commit_log = 0;
   2822
   2823			$p1_prefix = $1;
   2824			if (!$file && $tree && $p1_prefix ne '' &&
   2825			    -e "$root/$p1_prefix") {
   2826				WARN("PATCH_PREFIX",
   2827				     "patch prefix '$p1_prefix' exists, appears to be a -p0 patch\n");
   2828			}
   2829
   2830			if ($realfile =~ m@^include/asm/@) {
   2831				ERROR("MODIFIED_INCLUDE_ASM",
   2832				      "do not modify files in include/asm, change architecture specific files in include/asm-<architecture>\n" . "$here$rawline\n");
   2833			}
   2834			$found_file = 1;
   2835		}
   2836
   2837#make up the handle for any error we report on this line
   2838		if ($showfile) {
   2839			$prefix = "$realfile:$realline: "
   2840		} elsif ($emacs) {
   2841			if ($file) {
   2842				$prefix = "$filename:$realline: ";
   2843			} else {
   2844				$prefix = "$filename:$linenr: ";
   2845			}
   2846		}
   2847
   2848		if ($found_file) {
   2849			if (is_maintained_obsolete($realfile)) {
   2850				WARN("OBSOLETE",
   2851				     "$realfile is marked as 'obsolete' in the MAINTAINERS hierarchy.  No unnecessary modifications please.\n");
   2852			}
   2853			if ($realfile =~ m@^(?:drivers/net/|net/|drivers/staging/)@) {
   2854				$check = 1;
   2855			} else {
   2856				$check = $check_orig;
   2857			}
   2858			$checklicenseline = 1;
   2859
   2860			if ($realfile !~ /^MAINTAINERS/) {
   2861				my $last_binding_patch = $is_binding_patch;
   2862
   2863				$is_binding_patch = () = $realfile =~ m@^(?:Documentation/devicetree/|include/dt-bindings/)@;
   2864
   2865				if (($last_binding_patch != -1) &&
   2866				    ($last_binding_patch ^ $is_binding_patch)) {
   2867					WARN("DT_SPLIT_BINDING_PATCH",
   2868					     "DT binding docs and includes should be a separate patch. See: Documentation/devicetree/bindings/submitting-patches.rst\n");
   2869				}
   2870			}
   2871
   2872			next;
   2873		}
   2874
   2875		$here .= "FILE: $realfile:$realline:" if ($realcnt != 0);
   2876
   2877		my $hereline = "$here\n$rawline\n";
   2878		my $herecurr = "$here\n$rawline\n";
   2879		my $hereprev = "$here\n$prevrawline\n$rawline\n";
   2880
   2881		$cnt_lines++ if ($realcnt != 0);
   2882
   2883# Verify the existence of a commit log if appropriate
   2884# 2 is used because a $signature is counted in $commit_log_lines
   2885		if ($in_commit_log) {
   2886			if ($line !~ /^\s*$/) {
   2887				$commit_log_lines++;	#could be a $signature
   2888			}
   2889		} elsif ($has_commit_log && $commit_log_lines < 2) {
   2890			WARN("COMMIT_MESSAGE",
   2891			     "Missing commit description - Add an appropriate one\n");
   2892			$commit_log_lines = 2;	#warn only once
   2893		}
   2894
   2895# Check if the commit log has what seems like a diff which can confuse patch
   2896		if ($in_commit_log && !$commit_log_has_diff &&
   2897		    (($line =~ m@^\s+diff\b.*a/([\w/]+)@ &&
   2898		      $line =~ m@^\s+diff\b.*a/[\w/]+\s+b/$1\b@) ||
   2899		     $line =~ m@^\s*(?:\-\-\-\s+a/|\+\+\+\s+b/)@ ||
   2900		     $line =~ m/^\s*\@\@ \-\d+,\d+ \+\d+,\d+ \@\@/)) {
   2901			ERROR("DIFF_IN_COMMIT_MSG",
   2902			      "Avoid using diff content in the commit message - patch(1) might not work\n" . $herecurr);
   2903			$commit_log_has_diff = 1;
   2904		}
   2905
   2906# Check for incorrect file permissions
   2907		if ($line =~ /^new (file )?mode.*[7531]\d{0,2}$/) {
   2908			my $permhere = $here . "FILE: $realfile\n";
   2909			if ($realfile !~ m@scripts/@ &&
   2910			    $realfile !~ /\.(py|pl|awk|sh)$/) {
   2911				ERROR("EXECUTE_PERMISSIONS",
   2912				      "do not set execute permissions for source files\n" . $permhere);
   2913			}
   2914		}
   2915
   2916# Check the patch for a From:
   2917		if (decode("MIME-Header", $line) =~ /^From:\s*(.*)/) {
   2918			$author = $1;
   2919			my $curline = $linenr;
   2920			while(defined($rawlines[$curline]) && ($rawlines[$curline++] =~ /^[ \t]\s*(.*)/)) {
   2921				$author .= $1;
   2922			}
   2923			$author = encode("utf8", $author) if ($line =~ /=\?utf-8\?/i);
   2924			$author =~ s/"//g;
   2925			$author = reformat_email($author);
   2926		}
   2927
   2928# Check the patch for a signoff:
   2929		if ($line =~ /^\s*signed-off-by:\s*(.*)/i) {
   2930			$signoff++;
   2931			$in_commit_log = 0;
   2932			if ($author ne ''  && $authorsignoff != 1) {
   2933				if (same_email_addresses($1, $author)) {
   2934					$authorsignoff = 1;
   2935				} else {
   2936					my $ctx = $1;
   2937					my ($email_name, $email_comment, $email_address, $comment1) = parse_email($ctx);
   2938					my ($author_name, $author_comment, $author_address, $comment2) = parse_email($author);
   2939
   2940					if (lc $email_address eq lc $author_address && $email_name eq $author_name) {
   2941						$author_sob = $ctx;
   2942						$authorsignoff = 2;
   2943					} elsif (lc $email_address eq lc $author_address) {
   2944						$author_sob = $ctx;
   2945						$authorsignoff = 3;
   2946					} elsif ($email_name eq $author_name) {
   2947						$author_sob = $ctx;
   2948						$authorsignoff = 4;
   2949
   2950						my $address1 = $email_address;
   2951						my $address2 = $author_address;
   2952
   2953						if ($address1 =~ /(\S+)\+\S+(\@.*)/) {
   2954							$address1 = "$1$2";
   2955						}
   2956						if ($address2 =~ /(\S+)\+\S+(\@.*)/) {
   2957							$address2 = "$1$2";
   2958						}
   2959						if ($address1 eq $address2) {
   2960							$authorsignoff = 5;
   2961						}
   2962					}
   2963				}
   2964			}
   2965		}
   2966
   2967# Check for patch separator
   2968		if ($line =~ /^---$/) {
   2969			$has_patch_separator = 1;
   2970			$in_commit_log = 0;
   2971		}
   2972
   2973# Check if MAINTAINERS is being updated.  If so, there's probably no need to
   2974# emit the "does MAINTAINERS need updating?" message on file add/move/delete
   2975		if ($line =~ /^\s*MAINTAINERS\s*\|/) {
   2976			$reported_maintainer_file = 1;
   2977		}
   2978
   2979# Check signature styles
   2980		if (!$in_header_lines &&
   2981		    $line =~ /^(\s*)([a-z0-9_-]+by:|$signature_tags)(\s*)(.*)/i) {
   2982			my $space_before = $1;
   2983			my $sign_off = $2;
   2984			my $space_after = $3;
   2985			my $email = $4;
   2986			my $ucfirst_sign_off = ucfirst(lc($sign_off));
   2987
   2988			if ($sign_off !~ /$signature_tags/) {
   2989				my $suggested_signature = find_standard_signature($sign_off);
   2990				if ($suggested_signature eq "") {
   2991					WARN("BAD_SIGN_OFF",
   2992					     "Non-standard signature: $sign_off\n" . $herecurr);
   2993				} else {
   2994					if (WARN("BAD_SIGN_OFF",
   2995						 "Non-standard signature: '$sign_off' - perhaps '$suggested_signature'?\n" . $herecurr) &&
   2996					    $fix) {
   2997						$fixed[$fixlinenr] =~ s/$sign_off/$suggested_signature/;
   2998					}
   2999				}
   3000			}
   3001			if (defined $space_before && $space_before ne "") {
   3002				if (WARN("BAD_SIGN_OFF",
   3003					 "Do not use whitespace before $ucfirst_sign_off\n" . $herecurr) &&
   3004				    $fix) {
   3005					$fixed[$fixlinenr] =
   3006					    "$ucfirst_sign_off $email";
   3007				}
   3008			}
   3009			if ($sign_off =~ /-by:$/i && $sign_off ne $ucfirst_sign_off) {
   3010				if (WARN("BAD_SIGN_OFF",
   3011					 "'$ucfirst_sign_off' is the preferred signature form\n" . $herecurr) &&
   3012				    $fix) {
   3013					$fixed[$fixlinenr] =
   3014					    "$ucfirst_sign_off $email";
   3015				}
   3016
   3017			}
   3018			if (!defined $space_after || $space_after ne " ") {
   3019				if (WARN("BAD_SIGN_OFF",
   3020					 "Use a single space after $ucfirst_sign_off\n" . $herecurr) &&
   3021				    $fix) {
   3022					$fixed[$fixlinenr] =
   3023					    "$ucfirst_sign_off $email";
   3024				}
   3025			}
   3026
   3027			my ($email_name, $name_comment, $email_address, $comment) = parse_email($email);
   3028			my $suggested_email = format_email(($email_name, $name_comment, $email_address, $comment));
   3029			if ($suggested_email eq "") {
   3030				ERROR("BAD_SIGN_OFF",
   3031				      "Unrecognized email address: '$email'\n" . $herecurr);
   3032			} else {
   3033				my $dequoted = $suggested_email;
   3034				$dequoted =~ s/^"//;
   3035				$dequoted =~ s/" </ </;
   3036				# Don't force email to have quotes
   3037				# Allow just an angle bracketed address
   3038				if (!same_email_addresses($email, $suggested_email)) {
   3039					if (WARN("BAD_SIGN_OFF",
   3040						 "email address '$email' might be better as '$suggested_email'\n" . $herecurr) &&
   3041					    $fix) {
   3042						$fixed[$fixlinenr] =~ s/\Q$email\E/$suggested_email/;
   3043					}
   3044				}
   3045
   3046				# Address part shouldn't have comments
   3047				my $stripped_address = $email_address;
   3048				$stripped_address =~ s/\([^\(\)]*\)//g;
   3049				if ($email_address ne $stripped_address) {
   3050					if (WARN("BAD_SIGN_OFF",
   3051						 "address part of email should not have comments: '$email_address'\n" . $herecurr) &&
   3052					    $fix) {
   3053						$fixed[$fixlinenr] =~ s/\Q$email_address\E/$stripped_address/;
   3054					}
   3055				}
   3056
   3057				# Only one name comment should be allowed
   3058				my $comment_count = () = $name_comment =~ /\([^\)]+\)/g;
   3059				if ($comment_count > 1) {
   3060					WARN("BAD_SIGN_OFF",
   3061					     "Use a single name comment in email: '$email'\n" . $herecurr);
   3062				}
   3063
   3064
   3065				# stable@vger.kernel.org or stable@kernel.org shouldn't
   3066				# have an email name. In addition comments should strictly
   3067				# begin with a #
   3068				if ($email =~ /^.*stable\@(?:vger\.)?kernel\.org/i) {
   3069					if (($comment ne "" && $comment !~ /^#.+/) ||
   3070					    ($email_name ne "")) {
   3071						my $cur_name = $email_name;
   3072						my $new_comment = $comment;
   3073						$cur_name =~ s/[a-zA-Z\s\-\"]+//g;
   3074
   3075						# Remove brackets enclosing comment text
   3076						# and # from start of comments to get comment text
   3077						$new_comment =~ s/^\((.*)\)$/$1/;
   3078						$new_comment =~ s/^\[(.*)\]$/$1/;
   3079						$new_comment =~ s/^[\s\#]+|\s+$//g;
   3080
   3081						$new_comment = trim("$new_comment $cur_name") if ($cur_name ne $new_comment);
   3082						$new_comment = " # $new_comment" if ($new_comment ne "");
   3083						my $new_email = "$email_address$new_comment";
   3084
   3085						if (WARN("BAD_STABLE_ADDRESS_STYLE",
   3086							 "Invalid email format for stable: '$email', prefer '$new_email'\n" . $herecurr) &&
   3087						    $fix) {
   3088							$fixed[$fixlinenr] =~ s/\Q$email\E/$new_email/;
   3089						}
   3090					}
   3091				} elsif ($comment ne "" && $comment !~ /^(?:#.+|\(.+\))$/) {
   3092					my $new_comment = $comment;
   3093
   3094					# Extract comment text from within brackets or
   3095					# c89 style /*...*/ comments
   3096					$new_comment =~ s/^\[(.*)\]$/$1/;
   3097					$new_comment =~ s/^\/\*(.*)\*\/$/$1/;
   3098
   3099					$new_comment = trim($new_comment);
   3100					$new_comment =~ s/^[^\w]$//; # Single lettered comment with non word character is usually a typo
   3101					$new_comment = "($new_comment)" if ($new_comment ne "");
   3102					my $new_email = format_email($email_name, $name_comment, $email_address, $new_comment);
   3103
   3104					if (WARN("BAD_SIGN_OFF",
   3105						 "Unexpected content after email: '$email', should be: '$new_email'\n" . $herecurr) &&
   3106					    $fix) {
   3107						$fixed[$fixlinenr] =~ s/\Q$email\E/$new_email/;
   3108					}
   3109				}
   3110			}
   3111
   3112# Check for duplicate signatures
   3113			my $sig_nospace = $line;
   3114			$sig_nospace =~ s/\s//g;
   3115			$sig_nospace = lc($sig_nospace);
   3116			if (defined $signatures{$sig_nospace}) {
   3117				WARN("BAD_SIGN_OFF",
   3118				     "Duplicate signature\n" . $herecurr);
   3119			} else {
   3120				$signatures{$sig_nospace} = 1;
   3121			}
   3122
   3123# Check Co-developed-by: immediately followed by Signed-off-by: with same name and email
   3124			if ($sign_off =~ /^co-developed-by:$/i) {
   3125				if ($email eq $author) {
   3126					WARN("BAD_SIGN_OFF",
   3127					      "Co-developed-by: should not be used to attribute nominal patch author '$author'\n" . "$here\n" . $rawline);
   3128				}
   3129				if (!defined $lines[$linenr]) {
   3130					WARN("BAD_SIGN_OFF",
   3131					     "Co-developed-by: must be immediately followed by Signed-off-by:\n" . "$here\n" . $rawline);
   3132				} elsif ($rawlines[$linenr] !~ /^\s*signed-off-by:\s*(.*)/i) {
   3133					WARN("BAD_SIGN_OFF",
   3134					     "Co-developed-by: must be immediately followed by Signed-off-by:\n" . "$here\n" . $rawline . "\n" .$rawlines[$linenr]);
   3135				} elsif ($1 ne $email) {
   3136					WARN("BAD_SIGN_OFF",
   3137					     "Co-developed-by and Signed-off-by: name/email do not match \n" . "$here\n" . $rawline . "\n" .$rawlines[$linenr]);
   3138				}
   3139			}
   3140		}
   3141
   3142# Check email subject for common tools that don't need to be mentioned
   3143		if ($in_header_lines &&
   3144		    $line =~ /^Subject:.*\b(?:checkpatch|sparse|smatch)\b[^:]/i) {
   3145			WARN("EMAIL_SUBJECT",
   3146			     "A patch subject line should describe the change not the tool that found it\n" . $herecurr);
   3147		}
   3148
   3149# Check for Gerrit Change-Ids not in any patch context
   3150		if ($realfile eq '' && !$has_patch_separator && $line =~ /^\s*change-id:/i) {
   3151			if (ERROR("GERRIT_CHANGE_ID",
   3152			          "Remove Gerrit Change-Id's before submitting upstream\n" . $herecurr) &&
   3153			    $fix) {
   3154				fix_delete_line($fixlinenr, $rawline);
   3155			}
   3156		}
   3157
   3158# Check if the commit log is in a possible stack dump
   3159		if ($in_commit_log && !$commit_log_possible_stack_dump &&
   3160		    ($line =~ /^\s*(?:WARNING:|BUG:)/ ||
   3161		     $line =~ /^\s*\[\s*\d+\.\d{6,6}\s*\]/ ||
   3162					# timestamp
   3163		     $line =~ /^\s*\[\<[0-9a-fA-F]{8,}\>\]/) ||
   3164		     $line =~ /^(?:\s+\w+:\s+[0-9a-fA-F]+){3,3}/ ||
   3165		     $line =~ /^\s*\#\d+\s*\[[0-9a-fA-F]+\]\s*\w+ at [0-9a-fA-F]+/) {
   3166					# stack dump address styles
   3167			$commit_log_possible_stack_dump = 1;
   3168		}
   3169
   3170# Check for line lengths > 75 in commit log, warn once
   3171		if ($in_commit_log && !$commit_log_long_line &&
   3172		    length($line) > 75 &&
   3173		    !($line =~ /^\s*[a-zA-Z0-9_\/\.]+\s+\|\s+\d+/ ||
   3174					# file delta changes
   3175		      $line =~ /^\s*(?:[\w\.\-\+]*\/)++[\w\.\-\+]+:/ ||
   3176					# filename then :
   3177		      $line =~ /^\s*(?:Fixes:|Link:|$signature_tags)/i ||
   3178					# A Fixes: or Link: line or signature tag line
   3179		      $commit_log_possible_stack_dump)) {
   3180			WARN("COMMIT_LOG_LONG_LINE",
   3181			     "Possible unwrapped commit description (prefer a maximum 75 chars per line)\n" . $herecurr);
   3182			$commit_log_long_line = 1;
   3183		}
   3184
   3185# Reset possible stack dump if a blank line is found
   3186		if ($in_commit_log && $commit_log_possible_stack_dump &&
   3187		    $line =~ /^\s*$/) {
   3188			$commit_log_possible_stack_dump = 0;
   3189		}
   3190
   3191# Check for lines starting with a #
   3192		if ($in_commit_log && $line =~ /^#/) {
   3193			if (WARN("COMMIT_COMMENT_SYMBOL",
   3194				 "Commit log lines starting with '#' are dropped by git as comments\n" . $herecurr) &&
   3195			    $fix) {
   3196				$fixed[$fixlinenr] =~ s/^/ /;
   3197			}
   3198		}
   3199
   3200# Check for git id commit length and improperly formed commit descriptions
   3201# A correctly formed commit description is:
   3202#    commit <SHA-1 hash length 12+ chars> ("Complete commit subject")
   3203# with the commit subject '("' prefix and '")' suffix
   3204# This is a fairly compilicated block as it tests for what appears to be
   3205# bare SHA-1 hash with  minimum length of 5.  It also avoids several types of
   3206# possible SHA-1 matches.
   3207# A commit match can span multiple lines so this block attempts to find a
   3208# complete typical commit on a maximum of 3 lines
   3209		if ($perl_version_ok &&
   3210		    $in_commit_log && !$commit_log_possible_stack_dump &&
   3211		    $line !~ /^\s*(?:Link|Patchwork|http|https|BugLink|base-commit):/i &&
   3212		    $line !~ /^This reverts commit [0-9a-f]{7,40}/ &&
   3213		    (($line =~ /\bcommit\s+[0-9a-f]{5,}\b/i ||
   3214		      ($line =~ /\bcommit\s*$/i && defined($rawlines[$linenr]) && $rawlines[$linenr] =~ /^\s*[0-9a-f]{5,}\b/i)) ||
   3215		     ($line =~ /(?:\s|^)[0-9a-f]{12,40}(?:[\s"'\(\[]|$)/i &&
   3216		      $line !~ /[\<\[][0-9a-f]{12,40}[\>\]]/i &&
   3217		      $line !~ /\bfixes:\s*[0-9a-f]{12,40}/i))) {
   3218			my $init_char = "c";
   3219			my $orig_commit = "";
   3220			my $short = 1;
   3221			my $long = 0;
   3222			my $case = 1;
   3223			my $space = 1;
   3224			my $id = '0123456789ab';
   3225			my $orig_desc = "commit description";
   3226			my $description = "";
   3227			my $herectx = $herecurr;
   3228			my $has_parens = 0;
   3229			my $has_quotes = 0;
   3230
   3231			my $input = $line;
   3232			if ($line =~ /(?:\bcommit\s+[0-9a-f]{5,}|\bcommit\s*$)/i) {
   3233				for (my $n = 0; $n < 2; $n++) {
   3234					if ($input =~ /\bcommit\s+[0-9a-f]{5,}\s*($balanced_parens)/i) {
   3235						$orig_desc = $1;
   3236						$has_parens = 1;
   3237						# Always strip leading/trailing parens then double quotes if existing
   3238						$orig_desc = substr($orig_desc, 1, -1);
   3239						if ($orig_desc =~ /^".*"$/) {
   3240							$orig_desc = substr($orig_desc, 1, -1);
   3241							$has_quotes = 1;
   3242						}
   3243						last;
   3244					}
   3245					last if ($#lines < $linenr + $n);
   3246					$input .= " " . trim($rawlines[$linenr + $n]);
   3247					$herectx .= "$rawlines[$linenr + $n]\n";
   3248				}
   3249				$herectx = $herecurr if (!$has_parens);
   3250			}
   3251
   3252			if ($input =~ /\b(c)ommit\s+([0-9a-f]{5,})\b/i) {
   3253				$init_char = $1;
   3254				$orig_commit = lc($2);
   3255				$short = 0 if ($input =~ /\bcommit\s+[0-9a-f]{12,40}/i);
   3256				$long = 1 if ($input =~ /\bcommit\s+[0-9a-f]{41,}/i);
   3257				$space = 0 if ($input =~ /\bcommit [0-9a-f]/i);
   3258				$case = 0 if ($input =~ /\b[Cc]ommit\s+[0-9a-f]{5,40}[^A-F]/);
   3259			} elsif ($input =~ /\b([0-9a-f]{12,40})\b/i) {
   3260				$orig_commit = lc($1);
   3261			}
   3262
   3263			($id, $description) = git_commit_info($orig_commit,
   3264							      $id, $orig_desc);
   3265
   3266			if (defined($id) &&
   3267			    ($short || $long || $space || $case || ($orig_desc ne $description) || !$has_quotes) &&
   3268			    $last_git_commit_id_linenr != $linenr - 1) {
   3269				ERROR("GIT_COMMIT_ID",
   3270				      "Please use git commit description style 'commit <12+ chars of sha1> (\"<title line>\")' - ie: '${init_char}ommit $id (\"$description\")'\n" . $herectx);
   3271			}
   3272			#don't report the next line if this line ends in commit and the sha1 hash is the next line
   3273			$last_git_commit_id_linenr = $linenr if ($line =~ /\bcommit\s*$/i);
   3274		}
   3275
   3276# Check for added, moved or deleted files
   3277		if (!$reported_maintainer_file && !$in_commit_log &&
   3278		    ($line =~ /^(?:new|deleted) file mode\s*\d+\s*$/ ||
   3279		     $line =~ /^rename (?:from|to) [\w\/\.\-]+\s*$/ ||
   3280		     ($line =~ /\{\s*([\w\/\.\-]*)\s*\=\>\s*([\w\/\.\-]*)\s*\}/ &&
   3281		      (defined($1) || defined($2))))) {
   3282			$is_patch = 1;
   3283			$reported_maintainer_file = 1;
   3284			WARN("FILE_PATH_CHANGES",
   3285			     "added, moved or deleted file(s), does MAINTAINERS need updating?\n" . $herecurr);
   3286		}
   3287
   3288# Check for adding new DT bindings not in schema format
   3289		if (!$in_commit_log &&
   3290		    ($line =~ /^new file mode\s*\d+\s*$/) &&
   3291		    ($realfile =~ m@^Documentation/devicetree/bindings/.*\.txt$@)) {
   3292			WARN("DT_SCHEMA_BINDING_PATCH",
   3293			     "DT bindings should be in DT schema format. See: Documentation/devicetree/bindings/writing-schema.rst\n");
   3294		}
   3295
   3296# Check for wrappage within a valid hunk of the file
   3297		if ($realcnt != 0 && $line !~ m{^(?:\+|-| |\\ No newline|$)}) {
   3298			ERROR("CORRUPTED_PATCH",
   3299			      "patch seems to be corrupt (line wrapped?)\n" .
   3300				$herecurr) if (!$emitted_corrupt++);
   3301		}
   3302
   3303# UTF-8 regex found at http://www.w3.org/International/questions/qa-forms-utf-8.en.php
   3304		if (($realfile =~ /^$/ || $line =~ /^\+/) &&
   3305		    $rawline !~ m/^$UTF8*$/) {
   3306			my ($utf8_prefix) = ($rawline =~ /^($UTF8*)/);
   3307
   3308			my $blank = copy_spacing($rawline);
   3309			my $ptr = substr($blank, 0, length($utf8_prefix)) . "^";
   3310			my $hereptr = "$hereline$ptr\n";
   3311
   3312			CHK("INVALID_UTF8",
   3313			    "Invalid UTF-8, patch and commit message should be encoded in UTF-8\n" . $hereptr);
   3314		}
   3315
   3316# Check if it's the start of a commit log
   3317# (not a header line and we haven't seen the patch filename)
   3318		if ($in_header_lines && $realfile =~ /^$/ &&
   3319		    !($rawline =~ /^\s+(?:\S|$)/ ||
   3320		      $rawline =~ /^(?:commit\b|from\b|[\w-]+:)/i)) {
   3321			$in_header_lines = 0;
   3322			$in_commit_log = 1;
   3323			$has_commit_log = 1;
   3324		}
   3325
   3326# Check if there is UTF-8 in a commit log when a mail header has explicitly
   3327# declined it, i.e defined some charset where it is missing.
   3328		if ($in_header_lines &&
   3329		    $rawline =~ /^Content-Type:.+charset="(.+)".*$/ &&
   3330		    $1 !~ /utf-8/i) {
   3331			$non_utf8_charset = 1;
   3332		}
   3333
   3334		if ($in_commit_log && $non_utf8_charset && $realfile =~ /^$/ &&
   3335		    $rawline =~ /$NON_ASCII_UTF8/) {
   3336			WARN("UTF8_BEFORE_PATCH",
   3337			    "8-bit UTF-8 used in possible commit log\n" . $herecurr);
   3338		}
   3339
   3340# Check for absolute kernel paths in commit message
   3341		if ($tree && $in_commit_log) {
   3342			while ($line =~ m{(?:^|\s)(/\S*)}g) {
   3343				my $file = $1;
   3344
   3345				if ($file =~ m{^(.*?)(?::\d+)+:?$} &&
   3346				    check_absolute_file($1, $herecurr)) {
   3347					#
   3348				} else {
   3349					check_absolute_file($file, $herecurr);
   3350				}
   3351			}
   3352		}
   3353
   3354# Check for various typo / spelling mistakes
   3355		if (defined($misspellings) &&
   3356		    ($in_commit_log || $line =~ /^(?:\+|Subject:)/i)) {
   3357			while ($rawline =~ /(?:^|[^\w\-'`])($misspellings)(?:[^\w\-'`]|$)/gi) {
   3358				my $typo = $1;
   3359				my $blank = copy_spacing($rawline);
   3360				my $ptr = substr($blank, 0, $-[1]) . "^" x length($typo);
   3361				my $hereptr = "$hereline$ptr\n";
   3362				my $typo_fix = $spelling_fix{lc($typo)};
   3363				$typo_fix = ucfirst($typo_fix) if ($typo =~ /^[A-Z]/);
   3364				$typo_fix = uc($typo_fix) if ($typo =~ /^[A-Z]+$/);
   3365				my $msg_level = \&WARN;
   3366				$msg_level = \&CHK if ($file);
   3367				if (&{$msg_level}("TYPO_SPELLING",
   3368						  "'$typo' may be misspelled - perhaps '$typo_fix'?\n" . $hereptr) &&
   3369				    $fix) {
   3370					$fixed[$fixlinenr] =~ s/(^|[^A-Za-z@])($typo)($|[^A-Za-z@])/$1$typo_fix$3/;
   3371				}
   3372			}
   3373		}
   3374
   3375# check for invalid commit id
   3376		if ($in_commit_log && $line =~ /(^fixes:|\bcommit)\s+([0-9a-f]{6,40})\b/i) {
   3377			my $id;
   3378			my $description;
   3379			($id, $description) = git_commit_info($2, undef, undef);
   3380			if (!defined($id)) {
   3381				WARN("UNKNOWN_COMMIT_ID",
   3382				     "Unknown commit id '$2', maybe rebased or not pulled?\n" . $herecurr);
   3383			}
   3384		}
   3385
   3386# check for repeated words separated by a single space
   3387# avoid false positive from list command eg, '-rw-r--r-- 1 root root'
   3388		if (($rawline =~ /^\+/ || $in_commit_log) &&
   3389		    $rawline !~ /[bcCdDlMnpPs\?-][rwxsStT-]{9}/) {
   3390			pos($rawline) = 1 if (!$in_commit_log);
   3391			while ($rawline =~ /\b($word_pattern) (?=($word_pattern))/g) {
   3392
   3393				my $first = $1;
   3394				my $second = $2;
   3395				my $start_pos = $-[1];
   3396				my $end_pos = $+[2];
   3397				if ($first =~ /(?:struct|union|enum)/) {
   3398					pos($rawline) += length($first) + length($second) + 1;
   3399					next;
   3400				}
   3401
   3402				next if (lc($first) ne lc($second));
   3403				next if ($first eq 'long');
   3404
   3405				# check for character before and after the word matches
   3406				my $start_char = '';
   3407				my $end_char = '';
   3408				$start_char = substr($rawline, $start_pos - 1, 1) if ($start_pos > ($in_commit_log ? 0 : 1));
   3409				$end_char = substr($rawline, $end_pos, 1) if ($end_pos < length($rawline));
   3410
   3411				next if ($start_char =~ /^\S$/);
   3412				next if (index(" \t.,;?!", $end_char) == -1);
   3413
   3414				# avoid repeating hex occurrences like 'ff ff fe 09 ...'
   3415				if ($first =~ /\b[0-9a-f]{2,}\b/i) {
   3416					next if (!exists($allow_repeated_words{lc($first)}));
   3417				}
   3418
   3419				if (WARN("REPEATED_WORD",
   3420					 "Possible repeated word: '$first'\n" . $herecurr) &&
   3421				    $fix) {
   3422					$fixed[$fixlinenr] =~ s/\b$first $second\b/$first/;
   3423				}
   3424			}
   3425
   3426			# if it's a repeated word on consecutive lines in a comment block
   3427			if ($prevline =~ /$;+\s*$/ &&
   3428			    $prevrawline =~ /($word_pattern)\s*$/) {
   3429				my $last_word = $1;
   3430				if ($rawline =~ /^\+\s*\*\s*$last_word /) {
   3431					if (WARN("REPEATED_WORD",
   3432						 "Possible repeated word: '$last_word'\n" . $hereprev) &&
   3433					    $fix) {
   3434						$fixed[$fixlinenr] =~ s/(\+\s*\*\s*)$last_word /$1/;
   3435					}
   3436				}
   3437			}
   3438		}
   3439
   3440# ignore non-hunk lines and lines being removed
   3441		next if (!$hunk_line || $line =~ /^-/);
   3442
   3443#trailing whitespace
   3444		if ($line =~ /^\+.*\015/) {
   3445			my $herevet = "$here\n" . cat_vet($rawline) . "\n";
   3446			if (ERROR("DOS_LINE_ENDINGS",
   3447				  "DOS line endings\n" . $herevet) &&
   3448			    $fix) {
   3449				$fixed[$fixlinenr] =~ s/[\s\015]+$//;
   3450			}
   3451		} elsif ($rawline =~ /^\+.*\S\s+$/ || $rawline =~ /^\+\s+$/) {
   3452			my $herevet = "$here\n" . cat_vet($rawline) . "\n";
   3453			if (ERROR("TRAILING_WHITESPACE",
   3454				  "trailing whitespace\n" . $herevet) &&
   3455			    $fix) {
   3456				$fixed[$fixlinenr] =~ s/\s+$//;
   3457			}
   3458
   3459			$rpt_cleaners = 1;
   3460		}
   3461
   3462# Check for FSF mailing addresses.
   3463		if ($rawline =~ /\bwrite to the Free/i ||
   3464		    $rawline =~ /\b675\s+Mass\s+Ave/i ||
   3465		    $rawline =~ /\b59\s+Temple\s+Pl/i ||
   3466		    $rawline =~ /\b51\s+Franklin\s+St/i) {
   3467			my $herevet = "$here\n" . cat_vet($rawline) . "\n";
   3468			my $msg_level = \&ERROR;
   3469			$msg_level = \&CHK if ($file);
   3470			&{$msg_level}("FSF_MAILING_ADDRESS",
   3471				      "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)
   3472		}
   3473
   3474# check for Kconfig help text having a real description
   3475# Only applies when adding the entry originally, after that we do not have
   3476# sufficient context to determine whether it is indeed long enough.
   3477		if ($realfile =~ /Kconfig/ &&
   3478		    # 'choice' is usually the last thing on the line (though
   3479		    # Kconfig supports named choices), so use a word boundary
   3480		    # (\b) rather than a whitespace character (\s)
   3481		    $line =~ /^\+\s*(?:config|menuconfig|choice)\b/) {
   3482			my $ln = $linenr;
   3483			my $needs_help = 0;
   3484			my $has_help = 0;
   3485			my $help_length = 0;
   3486			while (defined $lines[$ln]) {
   3487				my $f = $lines[$ln++];
   3488
   3489				next if ($f =~ /^-/);
   3490				last if ($f !~ /^[\+ ]/);	# !patch context
   3491
   3492				if ($f =~ /^\+\s*(?:bool|tristate|prompt)\s*["']/) {
   3493					$needs_help = 1;
   3494					next;
   3495				}
   3496				if ($f =~ /^\+\s*help\s*$/) {
   3497					$has_help = 1;
   3498					next;
   3499				}
   3500
   3501				$f =~ s/^.//;	# strip patch context [+ ]
   3502				$f =~ s/#.*//;	# strip # directives
   3503				$f =~ s/^\s+//;	# strip leading blanks
   3504				next if ($f =~ /^$/);	# skip blank lines
   3505
   3506				# At the end of this Kconfig block:
   3507				# This only checks context lines in the patch
   3508				# and so hopefully shouldn't trigger false
   3509				# positives, even though some of these are
   3510				# common words in help texts
   3511				if ($f =~ /^(?:config|menuconfig|choice|endchoice|
   3512					       if|endif|menu|endmenu|source)\b/x) {
   3513					last;
   3514				}
   3515				$help_length++ if ($has_help);
   3516			}
   3517			if ($needs_help &&
   3518			    $help_length < $min_conf_desc_length) {
   3519				my $stat_real = get_stat_real($linenr, $ln - 1);
   3520				WARN("CONFIG_DESCRIPTION",
   3521				     "please write a help paragraph that fully describes the config symbol\n" . "$here\n$stat_real\n");
   3522			}
   3523		}
   3524
   3525# check MAINTAINERS entries
   3526		if ($realfile =~ /^MAINTAINERS$/) {
   3527# check MAINTAINERS entries for the right form
   3528			if ($rawline =~ /^\+[A-Z]:/ &&
   3529			    $rawline !~ /^\+[A-Z]:\t\S/) {
   3530				if (WARN("MAINTAINERS_STYLE",
   3531					 "MAINTAINERS entries use one tab after TYPE:\n" . $herecurr) &&
   3532				    $fix) {
   3533					$fixed[$fixlinenr] =~ s/^(\+[A-Z]):\s*/$1:\t/;
   3534				}
   3535			}
   3536# check MAINTAINERS entries for the right ordering too
   3537			my $preferred_order = 'MRLSWQBCPTFXNK';
   3538			if ($rawline =~ /^\+[A-Z]:/ &&
   3539			    $prevrawline =~ /^[\+ ][A-Z]:/) {
   3540				$rawline =~ /^\+([A-Z]):\s*(.*)/;
   3541				my $cur = $1;
   3542				my $curval = $2;
   3543				$prevrawline =~ /^[\+ ]([A-Z]):\s*(.*)/;
   3544				my $prev = $1;
   3545				my $prevval = $2;
   3546				my $curindex = index($preferred_order, $cur);
   3547				my $previndex = index($preferred_order, $prev);
   3548				if ($curindex < 0) {
   3549					WARN("MAINTAINERS_STYLE",
   3550					     "Unknown MAINTAINERS entry type: '$cur'\n" . $herecurr);
   3551				} else {
   3552					if ($previndex >= 0 && $curindex < $previndex) {
   3553						WARN("MAINTAINERS_STYLE",
   3554						     "Misordered MAINTAINERS entry - list '$cur:' before '$prev:'\n" . $hereprev);
   3555					} elsif ((($prev eq 'F' && $cur eq 'F') ||
   3556						  ($prev eq 'X' && $cur eq 'X')) &&
   3557						 ($prevval cmp $curval) > 0) {
   3558						WARN("MAINTAINERS_STYLE",
   3559						     "Misordered MAINTAINERS entry - list file patterns in alphabetic order\n" . $hereprev);
   3560					}
   3561				}
   3562			}
   3563		}
   3564
   3565		if (($realfile =~ /Makefile.*/ || $realfile =~ /Kbuild.*/) &&
   3566		    ($line =~ /\+(EXTRA_[A-Z]+FLAGS).*/)) {
   3567			my $flag = $1;
   3568			my $replacement = {
   3569				'EXTRA_AFLAGS' =>   'asflags-y',
   3570				'EXTRA_CFLAGS' =>   'ccflags-y',
   3571				'EXTRA_CPPFLAGS' => 'cppflags-y',
   3572				'EXTRA_LDFLAGS' =>  'ldflags-y',
   3573			};
   3574
   3575			WARN("DEPRECATED_VARIABLE",
   3576			     "Use of $flag is deprecated, please use \`$replacement->{$flag} instead.\n" . $herecurr) if ($replacement->{$flag});
   3577		}
   3578
   3579# check for DT compatible documentation
   3580		if (defined $root &&
   3581			(($realfile =~ /\.dtsi?$/ && $line =~ /^\+\s*compatible\s*=\s*\"/) ||
   3582			 ($realfile =~ /\.[ch]$/ && $line =~ /^\+.*\.compatible\s*=\s*\"/))) {
   3583
   3584			my @compats = $rawline =~ /\"([a-zA-Z0-9\-\,\.\+_]+)\"/g;
   3585
   3586			my $dt_path = $root . "/Documentation/devicetree/bindings/";
   3587			my $vp_file = $dt_path . "vendor-prefixes.yaml";
   3588
   3589			foreach my $compat (@compats) {
   3590				my $compat2 = $compat;
   3591				$compat2 =~ s/\,[a-zA-Z0-9]*\-/\,<\.\*>\-/;
   3592				my $compat3 = $compat;
   3593				$compat3 =~ s/\,([a-z]*)[0-9]*\-/\,$1<\.\*>\-/;
   3594				`grep -Erq "$compat|$compat2|$compat3" $dt_path`;
   3595				if ( $? >> 8 ) {
   3596					WARN("UNDOCUMENTED_DT_STRING",
   3597					     "DT compatible string \"$compat\" appears un-documented -- check $dt_path\n" . $herecurr);
   3598				}
   3599
   3600				next if $compat !~ /^([a-zA-Z0-9\-]+)\,/;
   3601				my $vendor = $1;
   3602				`grep -Eq "\\"\\^\Q$vendor\E,\\.\\*\\":" $vp_file`;
   3603				if ( $? >> 8 ) {
   3604					WARN("UNDOCUMENTED_DT_STRING",
   3605					     "DT compatible string vendor \"$vendor\" appears un-documented -- check $vp_file\n" . $herecurr);
   3606				}
   3607			}
   3608		}
   3609
   3610# check for using SPDX license tag at beginning of files
   3611		if ($realline == $checklicenseline) {
   3612			if ($rawline =~ /^[ \+]\s*\#\!\s*\//) {
   3613				$checklicenseline = 2;
   3614			} elsif ($rawline =~ /^\+/) {
   3615				my $comment = "";
   3616				if ($realfile =~ /\.(h|s|S)$/) {
   3617					$comment = '/*';
   3618				} elsif ($realfile =~ /\.(c|dts|dtsi)$/) {
   3619					$comment = '//';
   3620				} elsif (($checklicenseline == 2) || $realfile =~ /\.(sh|pl|py|awk|tc|yaml)$/) {
   3621					$comment = '#';
   3622				} elsif ($realfile =~ /\.rst$/) {
   3623					$comment = '..';
   3624				}
   3625
   3626# check SPDX comment style for .[chsS] files
   3627				if ($realfile =~ /\.[chsS]$/ &&
   3628				    $rawline =~ /SPDX-License-Identifier:/ &&
   3629				    $rawline !~ m@^\+\s*\Q$comment\E\s*@) {
   3630					WARN("SPDX_LICENSE_TAG",
   3631					     "Improper SPDX comment style for '$realfile', please use '$comment' instead\n" . $herecurr);
   3632				}
   3633
   3634				if ($comment !~ /^$/ &&
   3635				    $rawline !~ m@^\+\Q$comment\E SPDX-License-Identifier: @) {
   3636					WARN("SPDX_LICENSE_TAG",
   3637					     "Missing or malformed SPDX-License-Identifier tag in line $checklicenseline\n" . $herecurr);
   3638				} elsif ($rawline =~ /(SPDX-License-Identifier: .*)/) {
   3639					my $spdx_license = $1;
   3640					if (!is_SPDX_License_valid($spdx_license)) {
   3641						WARN("SPDX_LICENSE_TAG",
   3642						     "'$spdx_license' is not supported in LICENSES/...\n" . $herecurr);
   3643					}
   3644					if ($realfile =~ m@^Documentation/devicetree/bindings/@ &&
   3645					    not $spdx_license =~ /GPL-2\.0.*BSD-2-Clause/) {
   3646						my $msg_level = \&WARN;
   3647						$msg_level = \&CHK if ($file);
   3648						if (&{$msg_level}("SPDX_LICENSE_TAG",
   3649
   3650								  "DT binding documents should be licensed (GPL-2.0-only OR BSD-2-Clause)\n" . $herecurr) &&
   3651						    $fix) {
   3652							$fixed[$fixlinenr] =~ s/SPDX-License-Identifier: .*/SPDX-License-Identifier: (GPL-2.0-only OR BSD-2-Clause)/;
   3653						}
   3654					}
   3655				}
   3656			}
   3657		}
   3658
   3659# check for embedded filenames
   3660		if ($rawline =~ /^\+.*\Q$realfile\E/) {
   3661			WARN("EMBEDDED_FILENAME",
   3662			     "It's generally not useful to have the filename in the file\n" . $herecurr);
   3663		}
   3664
   3665# check we are in a valid source file if not then ignore this hunk
   3666		next if ($realfile !~ /\.(h|c|s|S|sh|dtsi|dts)$/);
   3667
   3668# check for using SPDX-License-Identifier on the wrong line number
   3669		if ($realline != $checklicenseline &&
   3670		    $rawline =~ /\bSPDX-License-Identifier:/ &&
   3671		    substr($line, @-, @+ - @-) eq "$;" x (@+ - @-)) {
   3672			WARN("SPDX_LICENSE_TAG",
   3673			     "Misplaced SPDX-License-Identifier tag - use line $checklicenseline instead\n" . $herecurr);
   3674		}
   3675
   3676# line length limit (with some exclusions)
   3677#
   3678# There are a few types of lines that may extend beyond $max_line_length:
   3679#	logging functions like pr_info that end in a string
   3680#	lines with a single string
   3681#	#defines that are a single string
   3682#	lines with an RFC3986 like URL
   3683#
   3684# There are 3 different line length message types:
   3685# LONG_LINE_COMMENT	a comment starts before but extends beyond $max_line_length
   3686# LONG_LINE_STRING	a string starts before but extends beyond $max_line_length
   3687# LONG_LINE		all other lines longer than $max_line_length
   3688#
   3689# if LONG_LINE is ignored, the other 2 types are also ignored
   3690#
   3691
   3692		if ($line =~ /^\+/ && $length > $max_line_length) {
   3693			my $msg_type = "LONG_LINE";
   3694
   3695			# Check the allowed long line types first
   3696
   3697			# logging functions that end in a string that starts
   3698			# before $max_line_length
   3699			if ($line =~ /^\+\s*$logFunctions\s*\(\s*(?:(?:KERN_\S+\s*|[^"]*))?($String\s*(?:|,|\)\s*;)\s*)$/ &&
   3700			    length(expand_tabs(substr($line, 1, length($line) - length($1) - 1))) <= $max_line_length) {
   3701				$msg_type = "";
   3702
   3703			# lines with only strings (w/ possible termination)
   3704			# #defines with only strings
   3705			} elsif ($line =~ /^\+\s*$String\s*(?:\s*|,|\)\s*;)\s*$/ ||
   3706				 $line =~ /^\+\s*#\s*define\s+\w+\s+$String$/) {
   3707				$msg_type = "";
   3708
   3709			# More special cases
   3710			} elsif ($line =~ /^\+.*\bEFI_GUID\s*\(/ ||
   3711				 $line =~ /^\+\s*(?:\w+)?\s*DEFINE_PER_CPU/) {
   3712				$msg_type = "";
   3713
   3714			# URL ($rawline is used in case the URL is in a comment)
   3715			} elsif ($rawline =~ /^\+.*\b[a-z][\w\.\+\-]*:\/\/\S+/i) {
   3716				$msg_type = "";
   3717
   3718			# Otherwise set the alternate message types
   3719
   3720			# a comment starts before $max_line_length
   3721			} elsif ($line =~ /($;[\s$;]*)$/ &&
   3722				 length(expand_tabs(substr($line, 1, length($line) - length($1) - 1))) <= $max_line_length) {
   3723				$msg_type = "LONG_LINE_COMMENT"
   3724
   3725			# a quoted string starts before $max_line_length
   3726			} elsif ($sline =~ /\s*($String(?:\s*(?:\\|,\s*|\)\s*;\s*))?)$/ &&
   3727				 length(expand_tabs(substr($line, 1, length($line) - length($1) - 1))) <= $max_line_length) {
   3728				$msg_type = "LONG_LINE_STRING"
   3729			}
   3730
   3731			if ($msg_type ne "" &&
   3732			    (show_type("LONG_LINE") || show_type($msg_type))) {
   3733				my $msg_level = \&WARN;
   3734				$msg_level = \&CHK if ($file);
   3735				&{$msg_level}($msg_type,
   3736					      "line length of $length exceeds $max_line_length columns\n" . $herecurr);
   3737			}
   3738		}
   3739
   3740# check for adding lines without a newline.
   3741		if ($line =~ /^\+/ && defined $lines[$linenr] && $lines[$linenr] =~ /^\\ No newline at end of file/) {
   3742			if (WARN("MISSING_EOF_NEWLINE",
   3743			         "adding a line without newline at end of file\n" . $herecurr) &&
   3744			    $fix) {
   3745				fix_delete_line($fixlinenr+1, "No newline at end of file");
   3746			}
   3747		}
   3748
   3749# check for .L prefix local symbols in .S files
   3750		if ($realfile =~ /\.S$/ &&
   3751		    $line =~ /^\+\s*(?:[A-Z]+_)?SYM_[A-Z]+_(?:START|END)(?:_[A-Z_]+)?\s*\(\s*\.L/) {
   3752			WARN("AVOID_L_PREFIX",
   3753			     "Avoid using '.L' prefixed local symbol names for denoting a range of code via 'SYM_*_START/END' annotations; see Documentation/asm-annotations.rst\n" . $herecurr);
   3754		}
   3755
   3756# check we are in a valid source file C or perl if not then ignore this hunk
   3757		next if ($realfile !~ /\.(h|c|pl|dtsi|dts)$/);
   3758
   3759# at the beginning of a line any tabs must come first and anything
   3760# more than $tabsize must use tabs.
   3761		if ($rawline =~ /^\+\s* \t\s*\S/ ||
   3762		    $rawline =~ /^\+\s*        \s*/) {
   3763			my $herevet = "$here\n" . cat_vet($rawline) . "\n";
   3764			$rpt_cleaners = 1;
   3765			if (ERROR("CODE_INDENT",
   3766				  "code indent should use tabs where possible\n" . $herevet) &&
   3767			    $fix) {
   3768				$fixed[$fixlinenr] =~ s/^\+([ \t]+)/"\+" . tabify($1)/e;
   3769			}
   3770		}
   3771
   3772# check for space before tabs.
   3773		if ($rawline =~ /^\+/ && $rawline =~ / \t/) {
   3774			my $herevet = "$here\n" . cat_vet($rawline) . "\n";
   3775			if (WARN("SPACE_BEFORE_TAB",
   3776				"please, no space before tabs\n" . $herevet) &&
   3777			    $fix) {
   3778				while ($fixed[$fixlinenr] =~
   3779					   s/(^\+.*) {$tabsize,$tabsize}\t/$1\t\t/) {}
   3780				while ($fixed[$fixlinenr] =~
   3781					   s/(^\+.*) +\t/$1\t/) {}
   3782			}
   3783		}
   3784
   3785# check for assignments on the start of a line
   3786		if ($sline =~ /^\+\s+($Assignment)[^=]/) {
   3787			my $operator = $1;
   3788			if (CHK("ASSIGNMENT_CONTINUATIONS",
   3789				"Assignment operator '$1' should be on the previous line\n" . $hereprev) &&
   3790			    $fix && $prevrawline =~ /^\+/) {
   3791				# add assignment operator to the previous line, remove from current line
   3792				$fixed[$fixlinenr - 1] .= " $operator";
   3793				$fixed[$fixlinenr] =~ s/\Q$operator\E\s*//;
   3794			}
   3795		}
   3796
   3797# check for && or || at the start of a line
   3798		if ($rawline =~ /^\+\s*(&&|\|\|)/) {
   3799			my $operator = $1;
   3800			if (CHK("LOGICAL_CONTINUATIONS",
   3801				"Logical continuations should be on the previous line\n" . $hereprev) &&
   3802			    $fix && $prevrawline =~ /^\+/) {
   3803				# insert logical operator at last non-comment, non-whitepsace char on previous line
   3804				$prevline =~ /[\s$;]*$/;
   3805				my $line_end = substr($prevrawline, $-[0]);
   3806				$fixed[$fixlinenr - 1] =~ s/\Q$line_end\E$/ $operator$line_end/;
   3807				$fixed[$fixlinenr] =~ s/\Q$operator\E\s*//;
   3808			}
   3809		}
   3810
   3811# check indentation starts on a tab stop
   3812		if ($perl_version_ok &&
   3813		    $sline =~ /^\+\t+( +)(?:$c90_Keywords\b|\{\s*$|\}\s*(?:else\b|while\b|\s*$)|$Declare\s*$Ident\s*[;=])/) {
   3814			my $indent = length($1);
   3815			if ($indent % $tabsize) {
   3816				if (WARN("TABSTOP",
   3817					 "Statements should start on a tabstop\n" . $herecurr) &&
   3818				    $fix) {
   3819					$fixed[$fixlinenr] =~ s@(^\+\t+) +@$1 . "\t" x ($indent/$tabsize)@e;
   3820				}
   3821			}
   3822		}
   3823
   3824# check multi-line statement indentation matches previous line
   3825		if ($perl_version_ok &&
   3826		    $prevline =~ /^\+([ \t]*)((?:$c90_Keywords(?:\s+if)\s*)|(?:$Declare\s*)?(?:$Ident|\(\s*\*\s*$Ident\s*\))\s*|(?:\*\s*)*$Lval\s*=\s*$Ident\s*)\(.*(\&\&|\|\||,)\s*$/) {
   3827			$prevline =~ /^\+(\t*)(.*)$/;
   3828			my $oldindent = $1;
   3829			my $rest = $2;
   3830
   3831			my $pos = pos_last_openparen($rest);
   3832			if ($pos >= 0) {
   3833				$line =~ /^(\+| )([ \t]*)/;
   3834				my $newindent = $2;
   3835
   3836				my $goodtabindent = $oldindent .
   3837					"\t" x ($pos / $tabsize) .
   3838					" "  x ($pos % $tabsize);
   3839				my $goodspaceindent = $oldindent . " "  x $pos;
   3840
   3841				if ($newindent ne $goodtabindent &&
   3842				    $newindent ne $goodspaceindent) {
   3843
   3844					if (CHK("PARENTHESIS_ALIGNMENT",
   3845						"Alignment should match open parenthesis\n" . $hereprev) &&
   3846					    $fix && $line =~ /^\+/) {
   3847						$fixed[$fixlinenr] =~
   3848						    s/^\+[ \t]*/\+$goodtabindent/;
   3849					}
   3850				}
   3851			}
   3852		}
   3853
   3854# check for space after cast like "(int) foo" or "(struct foo) bar"
   3855# avoid checking a few false positives:
   3856#   "sizeof(<type>)" or "__alignof__(<type>)"
   3857#   function pointer declarations like "(*foo)(int) = bar;"
   3858#   structure definitions like "(struct foo) { 0 };"
   3859#   multiline macros that define functions
   3860#   known attributes or the __attribute__ keyword
   3861		if ($line =~ /^\+(.*)\(\s*$Type\s*\)([ \t]++)((?![={]|\\$|$Attribute|__attribute__))/ &&
   3862		    (!defined($1) || $1 !~ /\b(?:sizeof|__alignof__)\s*$/)) {
   3863			if (CHK("SPACING",
   3864				"No space is necessary after a cast\n" . $herecurr) &&
   3865			    $fix) {
   3866				$fixed[$fixlinenr] =~
   3867				    s/(\(\s*$Type\s*\))[ \t]+/$1/;
   3868			}
   3869		}
   3870
   3871# Block comment styles
   3872# Networking with an initial /*
   3873		if ($realfile =~ m@^(drivers/net/|net/)@ &&
   3874		    $prevrawline =~ /^\+[ \t]*\/\*[ \t]*$/ &&
   3875		    $rawline =~ /^\+[ \t]*\*/ &&
   3876		    $realline > 3) { # Do not warn about the initial copyright comment block after SPDX-License-Identifier
   3877			WARN("NETWORKING_BLOCK_COMMENT_STYLE",
   3878			     "networking block comments don't use an empty /* line, use /* Comment...\n" . $hereprev);
   3879		}
   3880
   3881# Block comments use * on subsequent lines
   3882		if ($prevline =~ /$;[ \t]*$/ &&			#ends in comment
   3883		    $prevrawline =~ /^\+.*?\/\*/ &&		#starting /*
   3884		    $prevrawline !~ /\*\/[ \t]*$/ &&		#no trailing */
   3885		    $rawline =~ /^\+/ &&			#line is new
   3886		    $rawline !~ /^\+[ \t]*\*/) {		#no leading *
   3887			WARN("BLOCK_COMMENT_STYLE",
   3888			     "Block comments use * on subsequent lines\n" . $hereprev);
   3889		}
   3890
   3891# Block comments use */ on trailing lines
   3892		if ($rawline !~ m@^\+[ \t]*\*/[ \t]*$@ &&	#trailing */
   3893		    $rawline !~ m@^\+.*/\*.*\*/[ \t]*$@ &&	#inline /*...*/
   3894		    $rawline !~ m@^\+.*\*{2,}/[ \t]*$@ &&	#trailing **/
   3895		    $rawline =~ m@^\+[ \t]*.+\*\/[ \t]*$@) {	#non blank */
   3896			WARN("BLOCK_COMMENT_STYLE",
   3897			     "Block comments use a trailing */ on a separate line\n" . $herecurr);
   3898		}
   3899
   3900# Block comment * alignment
   3901		if ($prevline =~ /$;[ \t]*$/ &&			#ends in comment
   3902		    $line =~ /^\+[ \t]*$;/ &&			#leading comment
   3903		    $rawline =~ /^\+[ \t]*\*/ &&		#leading *
   3904		    (($prevrawline =~ /^\+.*?\/\*/ &&		#leading /*
   3905		      $prevrawline !~ /\*\/[ \t]*$/) ||		#no trailing */
   3906		     $prevrawline =~ /^\+[ \t]*\*/)) {		#leading *
   3907			my $oldindent;
   3908			$prevrawline =~ m@^\+([ \t]*/?)\*@;
   3909			if (defined($1)) {
   3910				$oldindent = expand_tabs($1);
   3911			} else {
   3912				$prevrawline =~ m@^\+(.*/?)\*@;
   3913				$oldindent = expand_tabs($1);
   3914			}
   3915			$rawline =~ m@^\+([ \t]*)\*@;
   3916			my $newindent = $1;
   3917			$newindent = expand_tabs($newindent);
   3918			if (length($oldindent) ne length($newindent)) {
   3919				WARN("BLOCK_COMMENT_STYLE",
   3920				     "Block comments should align the * on each line\n" . $hereprev);
   3921			}
   3922		}
   3923
   3924# check for missing blank lines after struct/union declarations
   3925# with exceptions for various attributes and macros
   3926		if ($prevline =~ /^[\+ ]};?\s*$/ &&
   3927		    $line =~ /^\+/ &&
   3928		    !($line =~ /^\+\s*$/ ||
   3929		      $line =~ /^\+\s*(?:EXPORT_SYMBOL|early_param)/ ||
   3930		      $line =~ /^\+\s*MODULE_/i ||
   3931		      $line =~ /^\+\s*\#\s*(?:end|elif|else)/ ||
   3932		      $line =~ /^\+[a-z_]*init/ ||
   3933		      $line =~ /^\+\s*(?:static\s+)?[A-Z_]*ATTR/ ||
   3934		      $line =~ /^\+\s*DECLARE/ ||
   3935		      $line =~ /^\+\s*builtin_[\w_]*driver/ ||
   3936		      $line =~ /^\+\s*__setup/)) {
   3937			if (CHK("LINE_SPACING",
   3938				"Please use a blank line after function/struct/union/enum declarations\n" . $hereprev) &&
   3939			    $fix) {
   3940				fix_insert_line($fixlinenr, "\+");
   3941			}
   3942		}
   3943
   3944# check for multiple consecutive blank lines
   3945		if ($prevline =~ /^[\+ ]\s*$/ &&
   3946		    $line =~ /^\+\s*$/ &&
   3947		    $last_blank_line != ($linenr - 1)) {
   3948			if (CHK("LINE_SPACING",
   3949				"Please don't use multiple blank lines\n" . $hereprev) &&
   3950			    $fix) {
   3951				fix_delete_line($fixlinenr, $rawline);
   3952			}
   3953
   3954			$last_blank_line = $linenr;
   3955		}
   3956
   3957# check for missing blank lines after declarations
   3958# (declarations must have the same indentation and not be at the start of line)
   3959		if (($prevline =~ /\+(\s+)\S/) && $sline =~ /^\+$1\S/) {
   3960			# use temporaries
   3961			my $sl = $sline;
   3962			my $pl = $prevline;
   3963			# remove $Attribute/$Sparse uses to simplify comparisons
   3964			$sl =~ s/\b(?:$Attribute|$Sparse)\b//g;
   3965			$pl =~ s/\b(?:$Attribute|$Sparse)\b//g;
   3966			if (($pl =~ /^\+\s+$Declare\s*$Ident\s*[=,;:\[]/ ||
   3967			# function pointer declarations
   3968			     $pl =~ /^\+\s+$Declare\s*\(\s*\*\s*$Ident\s*\)\s*[=,;:\[\(]/ ||
   3969			# foo bar; where foo is some local typedef or #define
   3970			     $pl =~ /^\+\s+$Ident(?:\s+|\s*\*\s*)$Ident\s*[=,;\[]/ ||
   3971			# known declaration macros
   3972			     $pl =~ /^\+\s+$declaration_macros/) &&
   3973			# for "else if" which can look like "$Ident $Ident"
   3974			    !($pl =~ /^\+\s+$c90_Keywords\b/ ||
   3975			# other possible extensions of declaration lines
   3976			      $pl =~ /(?:$Compare|$Assignment|$Operators)\s*$/ ||
   3977			# not starting a section or a macro "\" extended line
   3978			      $pl =~ /(?:\{\s*|\\)$/) &&
   3979			# looks like a declaration
   3980			    !($sl =~ /^\+\s+$Declare\s*$Ident\s*[=,;:\[]/ ||
   3981			# function pointer declarations
   3982			      $sl =~ /^\+\s+$Declare\s*\(\s*\*\s*$Ident\s*\)\s*[=,;:\[\(]/ ||
   3983			# foo bar; where foo is some local typedef or #define
   3984			      $sl =~ /^\+\s+$Ident(?:\s+|\s*\*\s*)$Ident\s*[=,;\[]/ ||
   3985			# known declaration macros
   3986			      $sl =~ /^\+\s+$declaration_macros/ ||
   3987			# start of struct or union or enum
   3988			      $sl =~ /^\+\s+(?:static\s+)?(?:const\s+)?(?:union|struct|enum|typedef)\b/ ||
   3989			# start or end of block or continuation of declaration
   3990			      $sl =~ /^\+\s+(?:$|[\{\}\.\#\"\?\:\(\[])/ ||
   3991			# bitfield continuation
   3992			      $sl =~ /^\+\s+$Ident\s*:\s*\d+\s*[,;]/ ||
   3993			# other possible extensions of declaration lines
   3994			      $sl =~ /^\+\s+\(?\s*(?:$Compare|$Assignment|$Operators)/)) {
   3995				if (WARN("LINE_SPACING",
   3996					 "Missing a blank line after declarations\n" . $hereprev) &&
   3997				    $fix) {
   3998					fix_insert_line($fixlinenr, "\+");
   3999				}
   4000			}
   4001		}
   4002
   4003# check for spaces at the beginning of a line.
   4004# Exceptions:
   4005#  1) within comments
   4006#  2) indented preprocessor commands
   4007#  3) hanging labels
   4008		if ($rawline =~ /^\+ / && $line !~ /^\+ *(?:$;|#|$Ident:)/)  {
   4009			my $herevet = "$here\n" . cat_vet($rawline) . "\n";
   4010			if (WARN("LEADING_SPACE",
   4011				 "please, no spaces at the start of a line\n" . $herevet) &&
   4012			    $fix) {
   4013				$fixed[$fixlinenr] =~ s/^\+([ \t]+)/"\+" . tabify($1)/e;
   4014			}
   4015		}
   4016
   4017# check we are in a valid C source file if not then ignore this hunk
   4018		next if ($realfile !~ /\.(h|c)$/);
   4019
   4020# check for unusual line ending [ or (
   4021		if ($line =~ /^\+.*([\[\(])\s*$/) {
   4022			CHK("OPEN_ENDED_LINE",
   4023			    "Lines should not end with a '$1'\n" . $herecurr);
   4024		}
   4025
   4026# check if this appears to be the start function declaration, save the name
   4027		if ($sline =~ /^\+\{\s*$/ &&
   4028		    $prevline =~ /^\+(?:(?:(?:$Storage|$Inline)\s*)*\s*$Type\s*)?($Ident)\(/) {
   4029			$context_function = $1;
   4030		}
   4031
   4032# check if this appears to be the end of function declaration
   4033		if ($sline =~ /^\+\}\s*$/) {
   4034			undef $context_function;
   4035		}
   4036
   4037# check indentation of any line with a bare else
   4038# (but not if it is a multiple line "if (foo) return bar; else return baz;")
   4039# if the previous line is a break or return and is indented 1 tab more...
   4040		if ($sline =~ /^\+([\t]+)(?:}[ \t]*)?else(?:[ \t]*{)?\s*$/) {
   4041			my $tabs = length($1) + 1;
   4042			if ($prevline =~ /^\+\t{$tabs,$tabs}break\b/ ||
   4043			    ($prevline =~ /^\+\t{$tabs,$tabs}return\b/ &&
   4044			     defined $lines[$linenr] &&
   4045			     $lines[$linenr] !~ /^[ \+]\t{$tabs,$tabs}return/)) {
   4046				WARN("UNNECESSARY_ELSE",
   4047				     "else is not generally useful after a break or return\n" . $hereprev);
   4048			}
   4049		}
   4050
   4051# check indentation of a line with a break;
   4052# if the previous line is a goto, return or break
   4053# and is indented the same # of tabs
   4054		if ($sline =~ /^\+([\t]+)break\s*;\s*$/) {
   4055			my $tabs = $1;
   4056			if ($prevline =~ /^\+$tabs(goto|return|break)\b/) {
   4057				if (WARN("UNNECESSARY_BREAK",
   4058					 "break is not useful after a $1\n" . $hereprev) &&
   4059				    $fix) {
   4060					fix_delete_line($fixlinenr, $rawline);
   4061				}
   4062			}
   4063		}
   4064
   4065# check for RCS/CVS revision markers
   4066		if ($rawline =~ /^\+.*\$(Revision|Log|Id)(?:\$|)/) {
   4067			WARN("CVS_KEYWORD",
   4068			     "CVS style keyword markers, these will _not_ be updated\n". $herecurr);
   4069		}
   4070
   4071# check for old HOTPLUG __dev<foo> section markings
   4072		if ($line =~ /\b(__dev(init|exit)(data|const|))\b/) {
   4073			WARN("HOTPLUG_SECTION",
   4074			     "Using $1 is unnecessary\n" . $herecurr);
   4075		}
   4076
   4077# Check for potential 'bare' types
   4078		my ($stat, $cond, $line_nr_next, $remain_next, $off_next,
   4079		    $realline_next);
   4080#print "LINE<$line>\n";
   4081		if ($linenr > $suppress_statement &&
   4082		    $realcnt && $sline =~ /.\s*\S/) {
   4083			($stat, $cond, $line_nr_next, $remain_next, $off_next) =
   4084				ctx_statement_block($linenr, $realcnt, 0);
   4085			$stat =~ s/\n./\n /g;
   4086			$cond =~ s/\n./\n /g;
   4087
   4088#print "linenr<$linenr> <$stat>\n";
   4089			# If this statement has no statement boundaries within
   4090			# it there is no point in retrying a statement scan
   4091			# until we hit end of it.
   4092			my $frag = $stat; $frag =~ s/;+\s*$//;
   4093			if ($frag !~ /(?:{|;)/) {
   4094#print "skip<$line_nr_next>\n";
   4095				$suppress_statement = $line_nr_next;
   4096			}
   4097
   4098			# Find the real next line.
   4099			$realline_next = $line_nr_next;
   4100			if (defined $realline_next &&
   4101			    (!defined $lines[$realline_next - 1] ||
   4102			     substr($lines[$realline_next - 1], $off_next) =~ /^\s*$/)) {
   4103				$realline_next++;
   4104			}
   4105
   4106			my $s = $stat;
   4107			$s =~ s/{.*$//s;
   4108
   4109			# Ignore goto labels.
   4110			if ($s =~ /$Ident:\*$/s) {
   4111
   4112			# Ignore functions being called
   4113			} elsif ($s =~ /^.\s*$Ident\s*\(/s) {
   4114
   4115			} elsif ($s =~ /^.\s*else\b/s) {
   4116
   4117			# declarations always start with types
   4118			} 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) {
   4119				my $type = $1;
   4120				$type =~ s/\s+/ /g;
   4121				possible($type, "A:" . $s);
   4122
   4123			# definitions in global scope can only start with types
   4124			} elsif ($s =~ /^.(?:$Storage\s+)?(?:$Inline\s+)?(?:const\s+)?($Ident)\b\s*(?!:)/s) {
   4125				possible($1, "B:" . $s);
   4126			}
   4127
   4128			# any (foo ... *) is a pointer cast, and foo is a type
   4129			while ($s =~ /\(($Ident)(?:\s+$Sparse)*[\s\*]+\s*\)/sg) {
   4130				possible($1, "C:" . $s);
   4131			}
   4132
   4133			# Check for any sort of function declaration.
   4134			# int foo(something bar, other baz);
   4135			# void (*store_gdt)(x86_descr_ptr *);
   4136			if ($prev_values eq 'E' && $s =~ /^(.(?:typedef\s*)?(?:(?:$Storage|$Inline)\s*)*\s*$Type\s*(?:\b$Ident|\(\*\s*$Ident\))\s*)\(/s) {
   4137				my ($name_len) = length($1);
   4138
   4139				my $ctx = $s;
   4140				substr($ctx, 0, $name_len + 1, '');
   4141				$ctx =~ s/\)[^\)]*$//;
   4142
   4143				for my $arg (split(/\s*,\s*/, $ctx)) {
   4144					if ($arg =~ /^(?:const\s+)?($Ident)(?:\s+$Sparse)*\s*\**\s*(:?\b$Ident)?$/s || $arg =~ /^($Ident)$/s) {
   4145
   4146						possible($1, "D:" . $s);
   4147					}
   4148				}
   4149			}
   4150
   4151		}
   4152
   4153#
   4154# Checks which may be anchored in the context.
   4155#
   4156
   4157# Check for switch () and associated case and default
   4158# statements should be at the same indent.
   4159		if ($line=~/\bswitch\s*\(.*\)/) {
   4160			my $err = '';
   4161			my $sep = '';
   4162			my @ctx = ctx_block_outer($linenr, $realcnt);
   4163			shift(@ctx);
   4164			for my $ctx (@ctx) {
   4165				my ($clen, $cindent) = line_stats($ctx);
   4166				if ($ctx =~ /^\+\s*(case\s+|default:)/ &&
   4167							$indent != $cindent) {
   4168					$err .= "$sep$ctx\n";
   4169					$sep = '';
   4170				} else {
   4171					$sep = "[...]\n";
   4172				}
   4173			}
   4174			if ($err ne '') {
   4175				ERROR("SWITCH_CASE_INDENT_LEVEL",
   4176				      "switch and case should be at the same indent\n$hereline$err");
   4177			}
   4178		}
   4179
   4180# if/while/etc brace do not go on next line, unless defining a do while loop,
   4181# or if that brace on the next line is for something else
   4182		if ($line =~ /(.*)\b((?:if|while|for|switch|(?:[a-z_]+|)for_each[a-z_]+)\s*\(|do\b|else\b)/ && $line !~ /^.\s*\#/) {
   4183			my $pre_ctx = "$1$2";
   4184
   4185			my ($level, @ctx) = ctx_statement_level($linenr, $realcnt, 0);
   4186
   4187			if ($line =~ /^\+\t{6,}/) {
   4188				WARN("DEEP_INDENTATION",
   4189				     "Too many leading tabs - consider code refactoring\n" . $herecurr);
   4190			}
   4191
   4192			my $ctx_cnt = $realcnt - $#ctx - 1;
   4193			my $ctx = join("\n", @ctx);
   4194
   4195			my $ctx_ln = $linenr;
   4196			my $ctx_skip = $realcnt;
   4197
   4198			while ($ctx_skip > $ctx_cnt || ($ctx_skip == $ctx_cnt &&
   4199					defined $lines[$ctx_ln - 1] &&
   4200					$lines[$ctx_ln - 1] =~ /^-/)) {
   4201				##print "SKIP<$ctx_skip> CNT<$ctx_cnt>\n";
   4202				$ctx_skip-- if (!defined $lines[$ctx_ln - 1] || $lines[$ctx_ln - 1] !~ /^-/);
   4203				$ctx_ln++;
   4204			}
   4205
   4206			#print "realcnt<$realcnt> ctx_cnt<$ctx_cnt>\n";
   4207			#print "pre<$pre_ctx>\nline<$line>\nctx<$ctx>\nnext<$lines[$ctx_ln - 1]>\n";
   4208
   4209			if ($ctx !~ /{\s*/ && defined($lines[$ctx_ln - 1]) && $lines[$ctx_ln - 1] =~ /^\+\s*{/) {
   4210				ERROR("OPEN_BRACE",
   4211				      "that open brace { should be on the previous line\n" .
   4212					"$here\n$ctx\n$rawlines[$ctx_ln - 1]\n");
   4213			}
   4214			if ($level == 0 && $pre_ctx !~ /}\s*while\s*\($/ &&
   4215			    $ctx =~ /\)\s*\;\s*$/ &&
   4216			    defined $lines[$ctx_ln - 1])
   4217			{
   4218				my ($nlength, $nindent) = line_stats($lines[$ctx_ln - 1]);
   4219				if ($nindent > $indent) {
   4220					WARN("TRAILING_SEMICOLON",
   4221					     "trailing semicolon indicates no statements, indent implies otherwise\n" .
   4222						"$here\n$ctx\n$rawlines[$ctx_ln - 1]\n");
   4223				}
   4224			}
   4225		}
   4226
   4227# Check relative indent for conditionals and blocks.
   4228		if ($line =~ /\b(?:(?:if|while|for|(?:[a-z_]+|)for_each[a-z_]+)\s*\(|(?:do|else)\b)/ && $line !~ /^.\s*#/ && $line !~ /\}\s*while\s*/) {
   4229			($stat, $cond, $line_nr_next, $remain_next, $off_next) =
   4230				ctx_statement_block($linenr, $realcnt, 0)
   4231					if (!defined $stat);
   4232			my ($s, $c) = ($stat, $cond);
   4233
   4234			substr($s, 0, length($c), '');
   4235
   4236			# remove inline comments
   4237			$s =~ s/$;/ /g;
   4238			$c =~ s/$;/ /g;
   4239
   4240			# Find out how long the conditional actually is.
   4241			my @newlines = ($c =~ /\n/gs);
   4242			my $cond_lines = 1 + $#newlines;
   4243
   4244			# Make sure we remove the line prefixes as we have
   4245			# none on the first line, and are going to readd them
   4246			# where necessary.
   4247			$s =~ s/\n./\n/gs;
   4248			while ($s =~ /\n\s+\\\n/) {
   4249				$cond_lines += $s =~ s/\n\s+\\\n/\n/g;
   4250			}
   4251
   4252			# We want to check the first line inside the block
   4253			# starting at the end of the conditional, so remove:
   4254			#  1) any blank line termination
   4255			#  2) any opening brace { on end of the line
   4256			#  3) any do (...) {
   4257			my $continuation = 0;
   4258			my $check = 0;
   4259			$s =~ s/^.*\bdo\b//;
   4260			$s =~ s/^\s*{//;
   4261			if ($s =~ s/^\s*\\//) {
   4262				$continuation = 1;
   4263			}
   4264			if ($s =~ s/^\s*?\n//) {
   4265				$check = 1;
   4266				$cond_lines++;
   4267			}
   4268
   4269			# Also ignore a loop construct at the end of a
   4270			# preprocessor statement.
   4271			if (($prevline =~ /^.\s*#\s*define\s/ ||
   4272			    $prevline =~ /\\\s*$/) && $continuation == 0) {
   4273				$check = 0;
   4274			}
   4275
   4276			my $cond_ptr = -1;
   4277			$continuation = 0;
   4278			while ($cond_ptr != $cond_lines) {
   4279				$cond_ptr = $cond_lines;
   4280
   4281				# If we see an #else/#elif then the code
   4282				# is not linear.
   4283				if ($s =~ /^\s*\#\s*(?:else|elif)/) {
   4284					$check = 0;
   4285				}
   4286
   4287				# Ignore:
   4288				#  1) blank lines, they should be at 0,
   4289				#  2) preprocessor lines, and
   4290				#  3) labels.
   4291				if ($continuation ||
   4292				    $s =~ /^\s*?\n/ ||
   4293				    $s =~ /^\s*#\s*?/ ||
   4294				    $s =~ /^\s*$Ident\s*:/) {
   4295					$continuation = ($s =~ /^.*?\\\n/) ? 1 : 0;
   4296					if ($s =~ s/^.*?\n//) {
   4297						$cond_lines++;
   4298					}
   4299				}
   4300			}
   4301
   4302			my (undef, $sindent) = line_stats("+" . $s);
   4303			my $stat_real = raw_line($linenr, $cond_lines);
   4304
   4305			# Check if either of these lines are modified, else
   4306			# this is not this patch's fault.
   4307			if (!defined($stat_real) ||
   4308			    $stat !~ /^\+/ && $stat_real !~ /^\+/) {
   4309				$check = 0;
   4310			}
   4311			if (defined($stat_real) && $cond_lines > 1) {
   4312				$stat_real = "[...]\n$stat_real";
   4313			}
   4314
   4315			#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";
   4316
   4317			if ($check && $s ne '' &&
   4318			    (($sindent % $tabsize) != 0 ||
   4319			     ($sindent < $indent) ||
   4320			     ($sindent == $indent &&
   4321			      ($s !~ /^\s*(?:\}|\{|else\b)/)) ||
   4322			     ($sindent > $indent + $tabsize))) {
   4323				WARN("SUSPECT_CODE_INDENT",
   4324				     "suspect code indent for conditional statements ($indent, $sindent)\n" . $herecurr . "$stat_real\n");
   4325			}
   4326		}
   4327
   4328		# Track the 'values' across context and added lines.
   4329		my $opline = $line; $opline =~ s/^./ /;
   4330		my ($curr_values, $curr_vars) =
   4331				annotate_values($opline . "\n", $prev_values);
   4332		$curr_values = $prev_values . $curr_values;
   4333		if ($dbg_values) {
   4334			my $outline = $opline; $outline =~ s/\t/ /g;
   4335			print "$linenr > .$outline\n";
   4336			print "$linenr > $curr_values\n";
   4337			print "$linenr >  $curr_vars\n";
   4338		}
   4339		$prev_values = substr($curr_values, -1);
   4340
   4341#ignore lines not being added
   4342		next if ($line =~ /^[^\+]/);
   4343
   4344# check for self assignments used to avoid compiler warnings
   4345# e.g.:	int foo = foo, *bar = NULL;
   4346#	struct foo bar = *(&(bar));
   4347		if ($line =~ /^\+\s*(?:$Declare)?([A-Za-z_][A-Za-z\d_]*)\s*=/) {
   4348			my $var = $1;
   4349			if ($line =~ /^\+\s*(?:$Declare)?$var\s*=\s*(?:$var|\*\s*\(?\s*&\s*\(?\s*$var\s*\)?\s*\)?)\s*[;,]/) {
   4350				WARN("SELF_ASSIGNMENT",
   4351				     "Do not use self-assignments to avoid compiler warnings\n" . $herecurr);
   4352			}
   4353		}
   4354
   4355# check for dereferences that span multiple lines
   4356		if ($prevline =~ /^\+.*$Lval\s*(?:\.|->)\s*$/ &&
   4357		    $line =~ /^\+\s*(?!\#\s*(?!define\s+|if))\s*$Lval/) {
   4358			$prevline =~ /($Lval\s*(?:\.|->))\s*$/;
   4359			my $ref = $1;
   4360			$line =~ /^.\s*($Lval)/;
   4361			$ref .= $1;
   4362			$ref =~ s/\s//g;
   4363			WARN("MULTILINE_DEREFERENCE",
   4364			     "Avoid multiple line dereference - prefer '$ref'\n" . $hereprev);
   4365		}
   4366
   4367# check for declarations of signed or unsigned without int
   4368		while ($line =~ m{\b($Declare)\s*(?!char\b|short\b|int\b|long\b)\s*($Ident)?\s*[=,;\[\)\(]}g) {
   4369			my $type = $1;
   4370			my $var = $2;
   4371			$var = "" if (!defined $var);
   4372			if ($type =~ /^(?:(?:$Storage|$Inline|$Attribute)\s+)*((?:un)?signed)((?:\s*\*)*)\s*$/) {
   4373				my $sign = $1;
   4374				my $pointer = $2;
   4375
   4376				$pointer = "" if (!defined $pointer);
   4377
   4378				if (WARN("UNSPECIFIED_INT",
   4379					 "Prefer '" . trim($sign) . " int" . rtrim($pointer) . "' to bare use of '$sign" . rtrim($pointer) . "'\n" . $herecurr) &&
   4380				    $fix) {
   4381					my $decl = trim($sign) . " int ";
   4382					my $comp_pointer = $pointer;
   4383					$comp_pointer =~ s/\s//g;
   4384					$decl .= $comp_pointer;
   4385					$decl = rtrim($decl) if ($var eq "");
   4386					$fixed[$fixlinenr] =~ s@\b$sign\s*\Q$pointer\E\s*$var\b@$decl$var@;
   4387				}
   4388			}
   4389		}
   4390
   4391# TEST: allow direct testing of the type matcher.
   4392		if ($dbg_type) {
   4393			if ($line =~ /^.\s*$Declare\s*$/) {
   4394				ERROR("TEST_TYPE",
   4395				      "TEST: is type\n" . $herecurr);
   4396			} elsif ($dbg_type > 1 && $line =~ /^.+($Declare)/) {
   4397				ERROR("TEST_NOT_TYPE",
   4398				      "TEST: is not type ($1 is)\n". $herecurr);
   4399			}
   4400			next;
   4401		}
   4402# TEST: allow direct testing of the attribute matcher.
   4403		if ($dbg_attr) {
   4404			if ($line =~ /^.\s*$Modifier\s*$/) {
   4405				ERROR("TEST_ATTR",
   4406				      "TEST: is attr\n" . $herecurr);
   4407			} elsif ($dbg_attr > 1 && $line =~ /^.+($Modifier)/) {
   4408				ERROR("TEST_NOT_ATTR",
   4409				      "TEST: is not attr ($1 is)\n". $herecurr);
   4410			}
   4411			next;
   4412		}
   4413
   4414# check for initialisation to aggregates open brace on the next line
   4415		if ($line =~ /^.\s*{/ &&
   4416		    $prevline =~ /(?:^|[^=])=\s*$/) {
   4417			if (ERROR("OPEN_BRACE",
   4418				  "that open brace { should be on the previous line\n" . $hereprev) &&
   4419			    $fix && $prevline =~ /^\+/ && $line =~ /^\+/) {
   4420				fix_delete_line($fixlinenr - 1, $prevrawline);
   4421				fix_delete_line($fixlinenr, $rawline);
   4422				my $fixedline = $prevrawline;
   4423				$fixedline =~ s/\s*=\s*$/ = {/;
   4424				fix_insert_line($fixlinenr, $fixedline);
   4425				$fixedline = $line;
   4426				$fixedline =~ s/^(.\s*)\{\s*/$1/;
   4427				fix_insert_line($fixlinenr, $fixedline);
   4428			}
   4429		}
   4430
   4431#
   4432# Checks which are anchored on the added line.
   4433#
   4434
   4435# check for malformed paths in #include statements (uses RAW line)
   4436		if ($rawline =~ m{^.\s*\#\s*include\s+[<"](.*)[">]}) {
   4437			my $path = $1;
   4438			if ($path =~ m{//}) {
   4439				ERROR("MALFORMED_INCLUDE",
   4440				      "malformed #include filename\n" . $herecurr);
   4441			}
   4442			if ($path =~ "^uapi/" && $realfile =~ m@\binclude/uapi/@) {
   4443				ERROR("UAPI_INCLUDE",
   4444				      "No #include in ...include/uapi/... should use a uapi/ path prefix\n" . $herecurr);
   4445			}
   4446		}
   4447
   4448# no C99 // comments
   4449		if ($line =~ m{//}) {
   4450			if (ERROR("C99_COMMENTS",
   4451				  "do not use C99 // comments\n" . $herecurr) &&
   4452			    $fix) {
   4453				my $line = $fixed[$fixlinenr];
   4454				if ($line =~ /\/\/(.*)$/) {
   4455					my $comment = trim($1);
   4456					$fixed[$fixlinenr] =~ s@\/\/(.*)$@/\* $comment \*/@;
   4457				}
   4458			}
   4459		}
   4460		# Remove C99 comments.
   4461		$line =~ s@//.*@@;
   4462		$opline =~ s@//.*@@;
   4463
   4464# EXPORT_SYMBOL should immediately follow the thing it is exporting, consider
   4465# the whole statement.
   4466#print "APW <$lines[$realline_next - 1]>\n";
   4467		if (defined $realline_next &&
   4468		    exists $lines[$realline_next - 1] &&
   4469		    !defined $suppress_export{$realline_next} &&
   4470		    ($lines[$realline_next - 1] =~ /EXPORT_SYMBOL.*\((.*)\)/)) {
   4471			# Handle definitions which produce identifiers with
   4472			# a prefix:
   4473			#   XXX(foo);
   4474			#   EXPORT_SYMBOL(something_foo);
   4475			my $name = $1;
   4476			$name =~ s/^\s*($Ident).*/$1/;
   4477			if ($stat =~ /^(?:.\s*}\s*\n)?.([A-Z_]+)\s*\(\s*($Ident)/ &&
   4478			    $name =~ /^${Ident}_$2/) {
   4479#print "FOO C name<$name>\n";
   4480				$suppress_export{$realline_next} = 1;
   4481
   4482			} elsif ($stat !~ /(?:
   4483				\n.}\s*$|
   4484				^.DEFINE_$Ident\(\Q$name\E\)|
   4485				^.DECLARE_$Ident\(\Q$name\E\)|
   4486				^.LIST_HEAD\(\Q$name\E\)|
   4487				^.(?:$Storage\s+)?$Type\s*\(\s*\*\s*\Q$name\E\s*\)\s*\(|
   4488				\b\Q$name\E(?:\s+$Attribute)*\s*(?:;|=|\[|\()
   4489			    )/x) {
   4490#print "FOO A<$lines[$realline_next - 1]> stat<$stat> name<$name>\n";
   4491				$suppress_export{$realline_next} = 2;
   4492			} else {
   4493				$suppress_export{$realline_next} = 1;
   4494			}
   4495		}
   4496		if (!defined $suppress_export{$linenr} &&
   4497		    $prevline =~ /^.\s*$/ &&
   4498		    ($line =~ /EXPORT_SYMBOL.*\((.*)\)/)) {
   4499#print "FOO B <$lines[$linenr - 1]>\n";
   4500			$suppress_export{$linenr} = 2;
   4501		}
   4502		if (defined $suppress_export{$linenr} &&
   4503		    $suppress_export{$linenr} == 2) {
   4504			WARN("EXPORT_SYMBOL",
   4505			     "EXPORT_SYMBOL(foo); should immediately follow its function/variable\n" . $herecurr);
   4506		}
   4507
   4508# check for global initialisers.
   4509		if ($line =~ /^\+$Type\s*$Ident(?:\s+$Modifier)*\s*=\s*($zero_initializer)\s*;/ &&
   4510		    !exclude_global_initialisers($realfile)) {
   4511			if (ERROR("GLOBAL_INITIALISERS",
   4512				  "do not initialise globals to $1\n" . $herecurr) &&
   4513			    $fix) {
   4514				$fixed[$fixlinenr] =~ s/(^.$Type\s*$Ident(?:\s+$Modifier)*)\s*=\s*$zero_initializer\s*;/$1;/;
   4515			}
   4516		}
   4517# check for static initialisers.
   4518		if ($line =~ /^\+.*\bstatic\s.*=\s*($zero_initializer)\s*;/) {
   4519			if (ERROR("INITIALISED_STATIC",
   4520				  "do not initialise statics to $1\n" .
   4521				      $herecurr) &&
   4522			    $fix) {
   4523				$fixed[$fixlinenr] =~ s/(\bstatic\s.*?)\s*=\s*$zero_initializer\s*;/$1;/;
   4524			}
   4525		}
   4526
   4527# check for misordered declarations of char/short/int/long with signed/unsigned
   4528		while ($sline =~ m{(\b$TypeMisordered\b)}g) {
   4529			my $tmp = trim($1);
   4530			WARN("MISORDERED_TYPE",
   4531			     "type '$tmp' should be specified in [[un]signed] [short|int|long|long long] order\n" . $herecurr);
   4532		}
   4533
   4534# check for unnecessary <signed> int declarations of short/long/long long
   4535		while ($sline =~ m{\b($TypeMisordered(\s*\*)*|$C90_int_types)\b}g) {
   4536			my $type = trim($1);
   4537			next if ($type !~ /\bint\b/);
   4538			next if ($type !~ /\b(?:short|long\s+long|long)\b/);
   4539			my $new_type = $type;
   4540			$new_type =~ s/\b\s*int\s*\b/ /;
   4541			$new_type =~ s/\b\s*(?:un)?signed\b\s*/ /;
   4542			$new_type =~ s/^const\s+//;
   4543			$new_type = "unsigned $new_type" if ($type =~ /\bunsigned\b/);
   4544			$new_type = "const $new_type" if ($type =~ /^const\b/);
   4545			$new_type =~ s/\s+/ /g;
   4546			$new_type = trim($new_type);
   4547			if (WARN("UNNECESSARY_INT",
   4548				 "Prefer '$new_type' over '$type' as the int is unnecessary\n" . $herecurr) &&
   4549			    $fix) {
   4550				$fixed[$fixlinenr] =~ s/\b\Q$type\E\b/$new_type/;
   4551			}
   4552		}
   4553
   4554# check for static const char * arrays.
   4555		if ($line =~ /\bstatic\s+const\s+char\s*\*\s*(\w+)\s*\[\s*\]\s*=\s*/) {
   4556			WARN("STATIC_CONST_CHAR_ARRAY",
   4557			     "static const char * array should probably be static const char * const\n" .
   4558				$herecurr);
   4559		}
   4560
   4561# check for initialized const char arrays that should be static const
   4562		if ($line =~ /^\+\s*const\s+(char|unsigned\s+char|_*u8|(?:[us]_)?int8_t)\s+\w+\s*\[\s*(?:\w+\s*)?\]\s*=\s*"/) {
   4563			if (WARN("STATIC_CONST_CHAR_ARRAY",
   4564				 "const array should probably be static const\n" . $herecurr) &&
   4565			    $fix) {
   4566				$fixed[$fixlinenr] =~ s/(^.\s*)const\b/${1}static const/;
   4567			}
   4568		}
   4569
   4570# check for static char foo[] = "bar" declarations.
   4571		if ($line =~ /\bstatic\s+char\s+(\w+)\s*\[\s*\]\s*=\s*"/) {
   4572			WARN("STATIC_CONST_CHAR_ARRAY",
   4573			     "static char array declaration should probably be static const char\n" .
   4574				$herecurr);
   4575		}
   4576
   4577# check for const <foo> const where <foo> is not a pointer or array type
   4578		if ($sline =~ /\bconst\s+($BasicType)\s+const\b/) {
   4579			my $found = $1;
   4580			if ($sline =~ /\bconst\s+\Q$found\E\s+const\b\s*\*/) {
   4581				WARN("CONST_CONST",
   4582				     "'const $found const *' should probably be 'const $found * const'\n" . $herecurr);
   4583			} elsif ($sline !~ /\bconst\s+\Q$found\E\s+const\s+\w+\s*\[/) {
   4584				WARN("CONST_CONST",
   4585				     "'const $found const' should probably be 'const $found'\n" . $herecurr);
   4586			}
   4587		}
   4588
   4589# check for const static or static <non ptr type> const declarations
   4590# prefer 'static const <foo>' over 'const static <foo>' and 'static <foo> const'
   4591		if ($sline =~ /^\+\s*const\s+static\s+($Type)\b/ ||
   4592		    $sline =~ /^\+\s*static\s+($BasicType)\s+const\b/) {
   4593			if (WARN("STATIC_CONST",
   4594				 "Move const after static - use 'static const $1'\n" . $herecurr) &&
   4595			    $fix) {
   4596				$fixed[$fixlinenr] =~ s/\bconst\s+static\b/static const/;
   4597				$fixed[$fixlinenr] =~ s/\bstatic\s+($BasicType)\s+const\b/static const $1/;
   4598			}
   4599		}
   4600
   4601# check for non-global char *foo[] = {"bar", ...} declarations.
   4602		if ($line =~ /^.\s+(?:static\s+|const\s+)?char\s+\*\s*\w+\s*\[\s*\]\s*=\s*\{/) {
   4603			WARN("STATIC_CONST_CHAR_ARRAY",
   4604			     "char * array declaration might be better as static const\n" .
   4605				$herecurr);
   4606		}
   4607
   4608# check for sizeof(foo)/sizeof(foo[0]) that could be ARRAY_SIZE(foo)
   4609		if ($line =~ m@\bsizeof\s*\(\s*($Lval)\s*\)@) {
   4610			my $array = $1;
   4611			if ($line =~ m@\b(sizeof\s*\(\s*\Q$array\E\s*\)\s*/\s*sizeof\s*\(\s*\Q$array\E\s*\[\s*0\s*\]\s*\))@) {
   4612				my $array_div = $1;
   4613				if (WARN("ARRAY_SIZE",
   4614					 "Prefer ARRAY_SIZE($array)\n" . $herecurr) &&
   4615				    $fix) {
   4616					$fixed[$fixlinenr] =~ s/\Q$array_div\E/ARRAY_SIZE($array)/;
   4617				}
   4618			}
   4619		}
   4620
   4621# check for function declarations without arguments like "int foo()"
   4622		if ($line =~ /(\b$Type\s*$Ident)\s*\(\s*\)/) {
   4623			if (ERROR("FUNCTION_WITHOUT_ARGS",
   4624				  "Bad function definition - $1() should probably be $1(void)\n" . $herecurr) &&
   4625			    $fix) {
   4626				$fixed[$fixlinenr] =~ s/(\b($Type)\s+($Ident))\s*\(\s*\)/$2 $3(void)/;
   4627			}
   4628		}
   4629
   4630# check for new typedefs, only function parameters and sparse annotations
   4631# make sense.
   4632		if ($line =~ /\btypedef\s/ &&
   4633		    $line !~ /\btypedef\s+$Type\s*\(\s*\*?$Ident\s*\)\s*\(/ &&
   4634		    $line !~ /\btypedef\s+$Type\s+$Ident\s*\(/ &&
   4635		    $line !~ /\b$typeTypedefs\b/ &&
   4636		    $line !~ /\b__bitwise\b/) {
   4637			WARN("NEW_TYPEDEFS",
   4638			     "do not add new typedefs\n" . $herecurr);
   4639		}
   4640
   4641# * goes on variable not on type
   4642		# (char*[ const])
   4643		while ($line =~ m{(\($NonptrType(\s*(?:$Modifier\b\s*|\*\s*)+)\))}g) {
   4644			#print "AA<$1>\n";
   4645			my ($ident, $from, $to) = ($1, $2, $2);
   4646
   4647			# Should start with a space.
   4648			$to =~ s/^(\S)/ $1/;
   4649			# Should not end with a space.
   4650			$to =~ s/\s+$//;
   4651			# '*'s should not have spaces between.
   4652			while ($to =~ s/\*\s+\*/\*\*/) {
   4653			}
   4654
   4655##			print "1: from<$from> to<$to> ident<$ident>\n";
   4656			if ($from ne $to) {
   4657				if (ERROR("POINTER_LOCATION",
   4658					  "\"(foo$from)\" should be \"(foo$to)\"\n" .  $herecurr) &&
   4659				    $fix) {
   4660					my $sub_from = $ident;
   4661					my $sub_to = $ident;
   4662					$sub_to =~ s/\Q$from\E/$to/;
   4663					$fixed[$fixlinenr] =~
   4664					    s@\Q$sub_from\E@$sub_to@;
   4665				}
   4666			}
   4667		}
   4668		while ($line =~ m{(\b$NonptrType(\s*(?:$Modifier\b\s*|\*\s*)+)($Ident))}g) {
   4669			#print "BB<$1>\n";
   4670			my ($match, $from, $to, $ident) = ($1, $2, $2, $3);
   4671
   4672			# Should start with a space.
   4673			$to =~ s/^(\S)/ $1/;
   4674			# Should not end with a space.
   4675			$to =~ s/\s+$//;
   4676			# '*'s should not have spaces between.
   4677			while ($to =~ s/\*\s+\*/\*\*/) {
   4678			}
   4679			# Modifiers should have spaces.
   4680			$to =~ s/(\b$Modifier$)/$1 /;
   4681
   4682##			print "2: from<$from> to<$to> ident<$ident>\n";
   4683			if ($from ne $to && $ident !~ /^$Modifier$/) {
   4684				if (ERROR("POINTER_LOCATION",
   4685					  "\"foo${from}bar\" should be \"foo${to}bar\"\n" .  $herecurr) &&
   4686				    $fix) {
   4687
   4688					my $sub_from = $match;
   4689					my $sub_to = $match;
   4690					$sub_to =~ s/\Q$from\E/$to/;
   4691					$fixed[$fixlinenr] =~
   4692					    s@\Q$sub_from\E@$sub_to@;
   4693				}
   4694			}
   4695		}
   4696
   4697# avoid BUG() or BUG_ON()
   4698		if ($line =~ /\b(?:BUG|BUG_ON)\b/) {
   4699			my $msg_level = \&WARN;
   4700			$msg_level = \&CHK if ($file);
   4701			&{$msg_level}("AVOID_BUG",
   4702				      "Avoid crashing the kernel - try using WARN_ON & recovery code rather than BUG() or BUG_ON()\n" . $herecurr);
   4703		}
   4704
   4705# avoid LINUX_VERSION_CODE
   4706		if ($line =~ /\bLINUX_VERSION_CODE\b/) {
   4707			WARN("LINUX_VERSION_CODE",
   4708			     "LINUX_VERSION_CODE should be avoided, code should be for the version to which it is merged\n" . $herecurr);
   4709		}
   4710
   4711# check for uses of printk_ratelimit
   4712		if ($line =~ /\bprintk_ratelimit\s*\(/) {
   4713			WARN("PRINTK_RATELIMITED",
   4714			     "Prefer printk_ratelimited or pr_<level>_ratelimited to printk_ratelimit\n" . $herecurr);
   4715		}
   4716
   4717# printk should use KERN_* levels
   4718		if ($line =~ /\bprintk\s*\(\s*(?!KERN_[A-Z]+\b)/) {
   4719			WARN("PRINTK_WITHOUT_KERN_LEVEL",
   4720			     "printk() should include KERN_<LEVEL> facility level\n" . $herecurr);
   4721		}
   4722
   4723# prefer variants of (subsystem|netdev|dev|pr)_<level> to printk(KERN_<LEVEL>
   4724		if ($line =~ /\b(printk(_once|_ratelimited)?)\s*\(\s*KERN_([A-Z]+)/) {
   4725			my $printk = $1;
   4726			my $modifier = $2;
   4727			my $orig = $3;
   4728			$modifier = "" if (!defined($modifier));
   4729			my $level = lc($orig);
   4730			$level = "warn" if ($level eq "warning");
   4731			my $level2 = $level;
   4732			$level2 = "dbg" if ($level eq "debug");
   4733			$level .= $modifier;
   4734			$level2 .= $modifier;
   4735			WARN("PREFER_PR_LEVEL",
   4736			     "Prefer [subsystem eg: netdev]_$level2([subsystem]dev, ... then dev_$level2(dev, ... then pr_$level(...  to $printk(KERN_$orig ...\n" . $herecurr);
   4737		}
   4738
   4739# prefer dev_<level> to dev_printk(KERN_<LEVEL>
   4740		if ($line =~ /\bdev_printk\s*\(\s*KERN_([A-Z]+)/) {
   4741			my $orig = $1;
   4742			my $level = lc($orig);
   4743			$level = "warn" if ($level eq "warning");
   4744			$level = "dbg" if ($level eq "debug");
   4745			WARN("PREFER_DEV_LEVEL",
   4746			     "Prefer dev_$level(... to dev_printk(KERN_$orig, ...\n" . $herecurr);
   4747		}
   4748
   4749# trace_printk should not be used in production code.
   4750		if ($line =~ /\b(trace_printk|trace_puts|ftrace_vprintk)\s*\(/) {
   4751			WARN("TRACE_PRINTK",
   4752			     "Do not use $1() in production code (this can be ignored if built only with a debug config option)\n" . $herecurr);
   4753		}
   4754
   4755# ENOSYS means "bad syscall nr" and nothing else.  This will have a small
   4756# number of false positives, but assembly files are not checked, so at
   4757# least the arch entry code will not trigger this warning.
   4758		if ($line =~ /\bENOSYS\b/) {
   4759			WARN("ENOSYS",
   4760			     "ENOSYS means 'invalid syscall nr' and nothing else\n" . $herecurr);
   4761		}
   4762
   4763# ENOTSUPP is not a standard error code and should be avoided in new patches.
   4764# Folks usually mean EOPNOTSUPP (also called ENOTSUP), when they type ENOTSUPP.
   4765# Similarly to ENOSYS warning a small number of false positives is expected.
   4766		if (!$file && $line =~ /\bENOTSUPP\b/) {
   4767			if (WARN("ENOTSUPP",
   4768				 "ENOTSUPP is not a SUSV4 error code, prefer EOPNOTSUPP\n" . $herecurr) &&
   4769			    $fix) {
   4770				$fixed[$fixlinenr] =~ s/\bENOTSUPP\b/EOPNOTSUPP/;
   4771			}
   4772		}
   4773
   4774# function brace can't be on same line, except for #defines of do while,
   4775# or if closed on same line
   4776		if ($perl_version_ok &&
   4777		    $sline =~ /$Type\s*$Ident\s*$balanced_parens\s*\{/ &&
   4778		    $sline !~ /\#\s*define\b.*do\s*\{/ &&
   4779		    $sline !~ /}/) {
   4780			if (ERROR("OPEN_BRACE",
   4781				  "open brace '{' following function definitions go on the next line\n" . $herecurr) &&
   4782			    $fix) {
   4783				fix_delete_line($fixlinenr, $rawline);
   4784				my $fixed_line = $rawline;
   4785				$fixed_line =~ /(^..*$Type\s*$Ident\(.*\)\s*)\{(.*)$/;
   4786				my $line1 = $1;
   4787				my $line2 = $2;
   4788				fix_insert_line($fixlinenr, ltrim($line1));
   4789				fix_insert_line($fixlinenr, "\+{");
   4790				if ($line2 !~ /^\s*$/) {
   4791					fix_insert_line($fixlinenr, "\+\t" . trim($line2));
   4792				}
   4793			}
   4794		}
   4795
   4796# open braces for enum, union and struct go on the same line.
   4797		if ($line =~ /^.\s*{/ &&
   4798		    $prevline =~ /^.\s*(?:typedef\s+)?(enum|union|struct)(?:\s+$Ident)?\s*$/) {
   4799			if (ERROR("OPEN_BRACE",
   4800				  "open brace '{' following $1 go on the same line\n" . $hereprev) &&
   4801			    $fix && $prevline =~ /^\+/ && $line =~ /^\+/) {
   4802				fix_delete_line($fixlinenr - 1, $prevrawline);
   4803				fix_delete_line($fixlinenr, $rawline);
   4804				my $fixedline = rtrim($prevrawline) . " {";
   4805				fix_insert_line($fixlinenr, $fixedline);
   4806				$fixedline = $rawline;
   4807				$fixedline =~ s/^(.\s*)\{\s*/$1\t/;
   4808				if ($fixedline !~ /^\+\s*$/) {
   4809					fix_insert_line($fixlinenr, $fixedline);
   4810				}
   4811			}
   4812		}
   4813
   4814# missing space after union, struct or enum definition
   4815		if ($line =~ /^.\s*(?:typedef\s+)?(enum|union|struct)(?:\s+$Ident){1,2}[=\{]/) {
   4816			if (WARN("SPACING",
   4817				 "missing space after $1 definition\n" . $herecurr) &&
   4818			    $fix) {
   4819				$fixed[$fixlinenr] =~
   4820				    s/^(.\s*(?:typedef\s+)?(?:enum|union|struct)(?:\s+$Ident){1,2})([=\{])/$1 $2/;
   4821			}
   4822		}
   4823
   4824# Function pointer declarations
   4825# check spacing between type, funcptr, and args
   4826# canonical declaration is "type (*funcptr)(args...)"
   4827		if ($line =~ /^.\s*($Declare)\((\s*)\*(\s*)($Ident)(\s*)\)(\s*)\(/) {
   4828			my $declare = $1;
   4829			my $pre_pointer_space = $2;
   4830			my $post_pointer_space = $3;
   4831			my $funcname = $4;
   4832			my $post_funcname_space = $5;
   4833			my $pre_args_space = $6;
   4834
   4835# the $Declare variable will capture all spaces after the type
   4836# so check it for a missing trailing missing space but pointer return types
   4837# don't need a space so don't warn for those.
   4838			my $post_declare_space = "";
   4839			if ($declare =~ /(\s+)$/) {
   4840				$post_declare_space = $1;
   4841				$declare = rtrim($declare);
   4842			}
   4843			if ($declare !~ /\*$/ && $post_declare_space =~ /^$/) {
   4844				WARN("SPACING",
   4845				     "missing space after return type\n" . $herecurr);
   4846				$post_declare_space = " ";
   4847			}
   4848
   4849# unnecessary space "type  (*funcptr)(args...)"
   4850# This test is not currently implemented because these declarations are
   4851# equivalent to
   4852#	int  foo(int bar, ...)
   4853# and this is form shouldn't/doesn't generate a checkpatch warning.
   4854#
   4855#			elsif ($declare =~ /\s{2,}$/) {
   4856#				WARN("SPACING",
   4857#				     "Multiple spaces after return type\n" . $herecurr);
   4858#			}
   4859
   4860# unnecessary space "type ( *funcptr)(args...)"
   4861			if (defined $pre_pointer_space &&
   4862			    $pre_pointer_space =~ /^\s/) {
   4863				WARN("SPACING",
   4864				     "Unnecessary space after function pointer open parenthesis\n" . $herecurr);
   4865			}
   4866
   4867# unnecessary space "type (* funcptr)(args...)"
   4868			if (defined $post_pointer_space &&
   4869			    $post_pointer_space =~ /^\s/) {
   4870				WARN("SPACING",
   4871				     "Unnecessary space before function pointer name\n" . $herecurr);
   4872			}
   4873
   4874# unnecessary space "type (*funcptr )(args...)"
   4875			if (defined $post_funcname_space &&
   4876			    $post_funcname_space =~ /^\s/) {
   4877				WARN("SPACING",
   4878				     "Unnecessary space after function pointer name\n" . $herecurr);
   4879			}
   4880
   4881# unnecessary space "type (*funcptr) (args...)"
   4882			if (defined $pre_args_space &&
   4883			    $pre_args_space =~ /^\s/) {
   4884				WARN("SPACING",
   4885				     "Unnecessary space before function pointer arguments\n" . $herecurr);
   4886			}
   4887
   4888			if (show_type("SPACING") && $fix) {
   4889				$fixed[$fixlinenr] =~
   4890				    s/^(.\s*)$Declare\s*\(\s*\*\s*$Ident\s*\)\s*\(/$1 . $declare . $post_declare_space . '(*' . $funcname . ')('/ex;
   4891			}
   4892		}
   4893
   4894# check for spacing round square brackets; allowed:
   4895#  1. with a type on the left -- int [] a;
   4896#  2. at the beginning of a line for slice initialisers -- [0...10] = 5,
   4897#  3. inside a curly brace -- = { [0...10] = 5 }
   4898		while ($line =~ /(.*?\s)\[/g) {
   4899			my ($where, $prefix) = ($-[1], $1);
   4900			if ($prefix !~ /$Type\s+$/ &&
   4901			    ($where != 0 || $prefix !~ /^.\s+$/) &&
   4902			    $prefix !~ /[{,:]\s+$/) {
   4903				if (ERROR("BRACKET_SPACE",
   4904					  "space prohibited before open square bracket '['\n" . $herecurr) &&
   4905				    $fix) {
   4906				    $fixed[$fixlinenr] =~
   4907					s/^(\+.*?)\s+\[/$1\[/;
   4908				}
   4909			}
   4910		}
   4911
   4912# check for spaces between functions and their parentheses.
   4913		while ($line =~ /($Ident)\s+\(/g) {
   4914			my $name = $1;
   4915			my $ctx_before = substr($line, 0, $-[1]);
   4916			my $ctx = "$ctx_before$name";
   4917
   4918			# Ignore those directives where spaces _are_ permitted.
   4919			if ($name =~ /^(?:
   4920				if|for|while|switch|return|case|
   4921				volatile|__volatile__|
   4922				__attribute__|format|__extension__|
   4923				asm|__asm__)$/x)
   4924			{
   4925			# cpp #define statements have non-optional spaces, ie
   4926			# if there is a space between the name and the open
   4927			# parenthesis it is simply not a parameter group.
   4928			} elsif ($ctx_before =~ /^.\s*\#\s*define\s*$/) {
   4929
   4930			# cpp #elif statement condition may start with a (
   4931			} elsif ($ctx =~ /^.\s*\#\s*elif\s*$/) {
   4932
   4933			# If this whole things ends with a type its most
   4934			# likely a typedef for a function.
   4935			} elsif ($ctx =~ /$Type$/) {
   4936
   4937			} else {
   4938				if (WARN("SPACING",
   4939					 "space prohibited between function name and open parenthesis '('\n" . $herecurr) &&
   4940					     $fix) {
   4941					$fixed[$fixlinenr] =~
   4942					    s/\b$name\s+\(/$name\(/;
   4943				}
   4944			}
   4945		}
   4946
   4947# Check operator spacing.
   4948		if (!($line=~/\#\s*include/)) {
   4949			my $fixed_line = "";
   4950			my $line_fixed = 0;
   4951
   4952			my $ops = qr{
   4953				<<=|>>=|<=|>=|==|!=|
   4954				\+=|-=|\*=|\/=|%=|\^=|\|=|&=|
   4955				=>|->|<<|>>|<|>|=|!|~|
   4956				&&|\|\||,|\^|\+\+|--|&|\||\+|-|\*|\/|%|
   4957				\?:|\?|:
   4958			}x;
   4959			my @elements = split(/($ops|;)/, $opline);
   4960
   4961##			print("element count: <" . $#elements . ">\n");
   4962##			foreach my $el (@elements) {
   4963##				print("el: <$el>\n");
   4964##			}
   4965
   4966			my @fix_elements = ();
   4967			my $off = 0;
   4968
   4969			foreach my $el (@elements) {
   4970				push(@fix_elements, substr($rawline, $off, length($el)));
   4971				$off += length($el);
   4972			}
   4973
   4974			$off = 0;
   4975
   4976			my $blank = copy_spacing($opline);
   4977			my $last_after = -1;
   4978
   4979			for (my $n = 0; $n < $#elements; $n += 2) {
   4980
   4981				my $good = $fix_elements[$n] . $fix_elements[$n + 1];
   4982
   4983##				print("n: <$n> good: <$good>\n");
   4984
   4985				$off += length($elements[$n]);
   4986
   4987				# Pick up the preceding and succeeding characters.
   4988				my $ca = substr($opline, 0, $off);
   4989				my $cc = '';
   4990				if (length($opline) >= ($off + length($elements[$n + 1]))) {
   4991					$cc = substr($opline, $off + length($elements[$n + 1]));
   4992				}
   4993				my $cb = "$ca$;$cc";
   4994
   4995				my $a = '';
   4996				$a = 'V' if ($elements[$n] ne '');
   4997				$a = 'W' if ($elements[$n] =~ /\s$/);
   4998				$a = 'C' if ($elements[$n] =~ /$;$/);
   4999				$a = 'B' if ($elements[$n] =~ /(\[|\()$/);
   5000				$a = 'O' if ($elements[$n] eq '');
   5001				$a = 'E' if ($ca =~ /^\s*$/);
   5002
   5003				my $op = $elements[$n + 1];
   5004
   5005				my $c = '';
   5006				if (defined $elements[$n + 2]) {
   5007					$c = 'V' if ($elements[$n + 2] ne '');
   5008					$c = 'W' if ($elements[$n + 2] =~ /^\s/);
   5009					$c = 'C' if ($elements[$n + 2] =~ /^$;/);
   5010					$c = 'B' if ($elements[$n + 2] =~ /^(\)|\]|;)/);
   5011					$c = 'O' if ($elements[$n + 2] eq '');
   5012					$c = 'E' if ($elements[$n + 2] =~ /^\s*\\$/);
   5013				} else {
   5014					$c = 'E';
   5015				}
   5016
   5017				my $ctx = "${a}x${c}";
   5018
   5019				my $at = "(ctx:$ctx)";
   5020
   5021				my $ptr = substr($blank, 0, $off) . "^";
   5022				my $hereptr = "$hereline$ptr\n";
   5023
   5024				# Pull out the value of this operator.
   5025				my $op_type = substr($curr_values, $off + 1, 1);
   5026
   5027				# Get the full operator variant.
   5028				my $opv = $op . substr($curr_vars, $off, 1);
   5029
   5030				# Ignore operators passed as parameters.
   5031				if ($op_type ne 'V' &&
   5032				    $ca =~ /\s$/ && $cc =~ /^\s*[,\)]/) {
   5033
   5034#				# Ignore comments
   5035#				} elsif ($op =~ /^$;+$/) {
   5036
   5037				# ; should have either the end of line or a space or \ after it
   5038				} elsif ($op eq ';') {
   5039					if ($ctx !~ /.x[WEBC]/ &&
   5040					    $cc !~ /^\\/ && $cc !~ /^;/) {
   5041						if (ERROR("SPACING",
   5042							  "space required after that '$op' $at\n" . $hereptr)) {
   5043							$good = $fix_elements[$n] . trim($fix_elements[$n + 1]) . " ";
   5044							$line_fixed = 1;
   5045						}
   5046					}
   5047
   5048				# // is a comment
   5049				} elsif ($op eq '//') {
   5050
   5051				#   :   when part of a bitfield
   5052				} elsif ($opv eq ':B') {
   5053					# skip the bitfield test for now
   5054
   5055				# No spaces for:
   5056				#   ->
   5057				} elsif ($op eq '->') {
   5058					if ($ctx =~ /Wx.|.xW/) {
   5059						if (ERROR("SPACING",
   5060							  "spaces prohibited around that '$op' $at\n" . $hereptr)) {
   5061							$good = rtrim($fix_elements[$n]) . trim($fix_elements[$n + 1]);
   5062							if (defined $fix_elements[$n + 2]) {
   5063								$fix_elements[$n + 2] =~ s/^\s+//;
   5064							}
   5065							$line_fixed = 1;
   5066						}
   5067					}
   5068
   5069				# , must not have a space before and must have a space on the right.
   5070				} elsif ($op eq ',') {
   5071					my $rtrim_before = 0;
   5072					my $space_after = 0;
   5073					if ($ctx =~ /Wx./) {
   5074						if (ERROR("SPACING",
   5075							  "space prohibited before that '$op' $at\n" . $hereptr)) {
   5076							$line_fixed = 1;
   5077							$rtrim_before = 1;
   5078						}
   5079					}
   5080					if ($ctx !~ /.x[WEC]/ && $cc !~ /^}/) {
   5081						if (ERROR("SPACING",
   5082							  "space required after that '$op' $at\n" . $hereptr)) {
   5083							$line_fixed = 1;
   5084							$last_after = $n;
   5085							$space_after = 1;
   5086						}
   5087					}
   5088					if ($rtrim_before || $space_after) {
   5089						if ($rtrim_before) {
   5090							$good = rtrim($fix_elements[$n]) . trim($fix_elements[$n + 1]);
   5091						} else {
   5092							$good = $fix_elements[$n] . trim($fix_elements[$n + 1]);
   5093						}
   5094						if ($space_after) {
   5095							$good .= " ";
   5096						}
   5097					}
   5098
   5099				# '*' as part of a type definition -- reported already.
   5100				} elsif ($opv eq '*_') {
   5101					#warn "'*' is part of type\n";
   5102
   5103				# unary operators should have a space before and
   5104				# none after.  May be left adjacent to another
   5105				# unary operator, or a cast
   5106				} elsif ($op eq '!' || $op eq '~' ||
   5107					 $opv eq '*U' || $opv eq '-U' ||
   5108					 $opv eq '&U' || $opv eq '&&U') {
   5109					if ($ctx !~ /[WEBC]x./ && $ca !~ /(?:\)|!|~|\*|-|\&|\||\+\+|\-\-|\{)$/) {
   5110						if (ERROR("SPACING",
   5111							  "space required before that '$op' $at\n" . $hereptr)) {
   5112							if ($n != $last_after + 2) {
   5113								$good = $fix_elements[$n] . " " . ltrim($fix_elements[$n + 1]);
   5114								$line_fixed = 1;
   5115							}
   5116						}
   5117					}
   5118					if ($op eq '*' && $cc =~/\s*$Modifier\b/) {
   5119						# A unary '*' may be const
   5120
   5121					} elsif ($ctx =~ /.xW/) {
   5122						if (ERROR("SPACING",
   5123							  "space prohibited after that '$op' $at\n" . $hereptr)) {
   5124							$good = $fix_elements[$n] . rtrim($fix_elements[$n + 1]);
   5125							if (defined $fix_elements[$n + 2]) {
   5126								$fix_elements[$n + 2] =~ s/^\s+//;
   5127							}
   5128							$line_fixed = 1;
   5129						}
   5130					}
   5131
   5132				# unary ++ and unary -- are allowed no space on one side.
   5133				} elsif ($op eq '++' or $op eq '--') {
   5134					if ($ctx !~ /[WEOBC]x[^W]/ && $ctx !~ /[^W]x[WOBEC]/) {
   5135						if (ERROR("SPACING",
   5136							  "space required one side of that '$op' $at\n" . $hereptr)) {
   5137							$good = $fix_elements[$n] . trim($fix_elements[$n + 1]) . " ";
   5138							$line_fixed = 1;
   5139						}
   5140					}
   5141					if ($ctx =~ /Wx[BE]/ ||
   5142					    ($ctx =~ /Wx./ && $cc =~ /^;/)) {
   5143						if (ERROR("SPACING",
   5144							  "space prohibited before that '$op' $at\n" . $hereptr)) {
   5145							$good = rtrim($fix_elements[$n]) . trim($fix_elements[$n + 1]);
   5146							$line_fixed = 1;
   5147						}
   5148					}
   5149					if ($ctx =~ /ExW/) {
   5150						if (ERROR("SPACING",
   5151							  "space prohibited after that '$op' $at\n" . $hereptr)) {
   5152							$good = $fix_elements[$n] . trim($fix_elements[$n + 1]);
   5153							if (defined $fix_elements[$n + 2]) {
   5154								$fix_elements[$n + 2] =~ s/^\s+//;
   5155							}
   5156							$line_fixed = 1;
   5157						}
   5158					}
   5159
   5160				# << and >> may either have or not have spaces both sides
   5161				} elsif ($op eq '<<' or $op eq '>>' or
   5162					 $op eq '&' or $op eq '^' or $op eq '|' or
   5163					 $op eq '+' or $op eq '-' or
   5164					 $op eq '*' or $op eq '/' or
   5165					 $op eq '%')
   5166				{
   5167					if ($check) {
   5168						if (defined $fix_elements[$n + 2] && $ctx !~ /[EW]x[EW]/) {
   5169							if (CHK("SPACING",
   5170								"spaces preferred around that '$op' $at\n" . $hereptr)) {
   5171								$good = rtrim($fix_elements[$n]) . " " . trim($fix_elements[$n + 1]) . " ";
   5172								$fix_elements[$n + 2] =~ s/^\s+//;
   5173								$line_fixed = 1;
   5174							}
   5175						} elsif (!defined $fix_elements[$n + 2] && $ctx !~ /Wx[OE]/) {
   5176							if (CHK("SPACING",
   5177								"space preferred before that '$op' $at\n" . $hereptr)) {
   5178								$good = rtrim($fix_elements[$n]) . " " . trim($fix_elements[$n + 1]);
   5179								$line_fixed = 1;
   5180							}
   5181						}
   5182					} elsif ($ctx =~ /Wx[^WCE]|[^WCE]xW/) {
   5183						if (ERROR("SPACING",
   5184							  "need consistent spacing around '$op' $at\n" . $hereptr)) {
   5185							$good = rtrim($fix_elements[$n]) . " " . trim($fix_elements[$n + 1]) . " ";
   5186							if (defined $fix_elements[$n + 2]) {
   5187								$fix_elements[$n + 2] =~ s/^\s+//;
   5188							}
   5189							$line_fixed = 1;
   5190						}
   5191					}
   5192
   5193				# A colon needs no spaces before when it is
   5194				# terminating a case value or a label.
   5195				} elsif ($opv eq ':C' || $opv eq ':L') {
   5196					if ($ctx =~ /Wx./ and $realfile !~ m@.*\.lds\.h$@) {
   5197						if (ERROR("SPACING",
   5198							  "space prohibited before that '$op' $at\n" . $hereptr)) {
   5199							$good = rtrim($fix_elements[$n]) . trim($fix_elements[$n + 1]);
   5200							$line_fixed = 1;
   5201						}
   5202					}
   5203
   5204				# All the others need spaces both sides.
   5205				} elsif ($ctx !~ /[EWC]x[CWE]/) {
   5206					my $ok = 0;
   5207
   5208					# Ignore email addresses <foo@bar>
   5209					if (($op eq '<' &&
   5210					     $cc =~ /^\S+\@\S+>/) ||
   5211					    ($op eq '>' &&
   5212					     $ca =~ /<\S+\@\S+$/))
   5213					{
   5214						$ok = 1;
   5215					}
   5216
   5217					# for asm volatile statements
   5218					# ignore a colon with another
   5219					# colon immediately before or after
   5220					if (($op eq ':') &&
   5221					    ($ca =~ /:$/ || $cc =~ /^:/)) {
   5222						$ok = 1;
   5223					}
   5224
   5225					# messages are ERROR, but ?: are CHK
   5226					if ($ok == 0) {
   5227						my $msg_level = \&ERROR;
   5228						$msg_level = \&CHK if (($op eq '?:' || $op eq '?' || $op eq ':') && $ctx =~ /VxV/);
   5229
   5230						if (&{$msg_level}("SPACING",
   5231								  "spaces required around that '$op' $at\n" . $hereptr)) {
   5232							$good = rtrim($fix_elements[$n]) . " " . trim($fix_elements[$n + 1]) . " ";
   5233							if (defined $fix_elements[$n + 2]) {
   5234								$fix_elements[$n + 2] =~ s/^\s+//;
   5235							}
   5236							$line_fixed = 1;
   5237						}
   5238					}
   5239				}
   5240				$off += length($elements[$n + 1]);
   5241
   5242##				print("n: <$n> GOOD: <$good>\n");
   5243
   5244				$fixed_line = $fixed_line . $good;
   5245			}
   5246
   5247			if (($#elements % 2) == 0) {
   5248				$fixed_line = $fixed_line . $fix_elements[$#elements];
   5249			}
   5250
   5251			if ($fix && $line_fixed && $fixed_line ne $fixed[$fixlinenr]) {
   5252				$fixed[$fixlinenr] = $fixed_line;
   5253			}
   5254
   5255
   5256		}
   5257
   5258# check for whitespace before a non-naked semicolon
   5259		if ($line =~ /^\+.*\S\s+;\s*$/) {
   5260			if (WARN("SPACING",
   5261				 "space prohibited before semicolon\n" . $herecurr) &&
   5262			    $fix) {
   5263				1 while $fixed[$fixlinenr] =~
   5264				    s/^(\+.*\S)\s+;/$1;/;
   5265			}
   5266		}
   5267
   5268# check for multiple assignments
   5269		if ($line =~ /^.\s*$Lval\s*=\s*$Lval\s*=(?!=)/) {
   5270			CHK("MULTIPLE_ASSIGNMENTS",
   5271			    "multiple assignments should be avoided\n" . $herecurr);
   5272		}
   5273
   5274## # check for multiple declarations, allowing for a function declaration
   5275## # continuation.
   5276## 		if ($line =~ /^.\s*$Type\s+$Ident(?:\s*=[^,{]*)?\s*,\s*$Ident.*/ &&
   5277## 		    $line !~ /^.\s*$Type\s+$Ident(?:\s*=[^,{]*)?\s*,\s*$Type\s*$Ident.*/) {
   5278##
   5279## 			# Remove any bracketed sections to ensure we do not
   5280## 			# falsely report the parameters of functions.
   5281## 			my $ln = $line;
   5282## 			while ($ln =~ s/\([^\(\)]*\)//g) {
   5283## 			}
   5284## 			if ($ln =~ /,/) {
   5285## 				WARN("MULTIPLE_DECLARATION",
   5286##				     "declaring multiple variables together should be avoided\n" . $herecurr);
   5287## 			}
   5288## 		}
   5289
   5290#need space before brace following if, while, etc
   5291		if (($line =~ /\(.*\)\{/ && $line !~ /\($Type\)\{/) ||
   5292		    $line =~ /\b(?:else|do)\{/) {
   5293			if (ERROR("SPACING",
   5294				  "space required before the open brace '{'\n" . $herecurr) &&
   5295			    $fix) {
   5296				$fixed[$fixlinenr] =~ s/^(\+.*(?:do|else|\)))\{/$1 {/;
   5297			}
   5298		}
   5299
   5300## # check for blank lines before declarations
   5301##		if ($line =~ /^.\t+$Type\s+$Ident(?:\s*=.*)?;/ &&
   5302##		    $prevrawline =~ /^.\s*$/) {
   5303##			WARN("SPACING",
   5304##			     "No blank lines before declarations\n" . $hereprev);
   5305##		}
   5306##
   5307
   5308# closing brace should have a space following it when it has anything
   5309# on the line
   5310		if ($line =~ /}(?!(?:,|;|\)|\}))\S/) {
   5311			if (ERROR("SPACING",
   5312				  "space required after that close brace '}'\n" . $herecurr) &&
   5313			    $fix) {
   5314				$fixed[$fixlinenr] =~
   5315				    s/}((?!(?:,|;|\)))\S)/} $1/;
   5316			}
   5317		}
   5318
   5319# check spacing on square brackets
   5320		if ($line =~ /\[\s/ && $line !~ /\[\s*$/) {
   5321			if (ERROR("SPACING",
   5322				  "space prohibited after that open square bracket '['\n" . $herecurr) &&
   5323			    $fix) {
   5324				$fixed[$fixlinenr] =~
   5325				    s/\[\s+/\[/;
   5326			}
   5327		}
   5328		if ($line =~ /\s\]/) {
   5329			if (ERROR("SPACING",
   5330				  "space prohibited before that close square bracket ']'\n" . $herecurr) &&
   5331			    $fix) {
   5332				$fixed[$fixlinenr] =~
   5333				    s/\s+\]/\]/;
   5334			}
   5335		}
   5336
   5337# check spacing on parentheses
   5338		if ($line =~ /\(\s/ && $line !~ /\(\s*(?:\\)?$/ &&
   5339		    $line !~ /for\s*\(\s+;/) {
   5340			if (ERROR("SPACING",
   5341				  "space prohibited after that open parenthesis '('\n" . $herecurr) &&
   5342			    $fix) {
   5343				$fixed[$fixlinenr] =~
   5344				    s/\(\s+/\(/;
   5345			}
   5346		}
   5347		if ($line =~ /(\s+)\)/ && $line !~ /^.\s*\)/ &&
   5348		    $line !~ /for\s*\(.*;\s+\)/ &&
   5349		    $line !~ /:\s+\)/) {
   5350			if (ERROR("SPACING",
   5351				  "space prohibited before that close parenthesis ')'\n" . $herecurr) &&
   5352			    $fix) {
   5353				$fixed[$fixlinenr] =~
   5354				    s/\s+\)/\)/;
   5355			}
   5356		}
   5357
   5358# check unnecessary parentheses around addressof/dereference single $Lvals
   5359# ie: &(foo->bar) should be &foo->bar and *(foo->bar) should be *foo->bar
   5360
   5361		while ($line =~ /(?:[^&]&\s*|\*)\(\s*($Ident\s*(?:$Member\s*)+)\s*\)/g) {
   5362			my $var = $1;
   5363			if (CHK("UNNECESSARY_PARENTHESES",
   5364				"Unnecessary parentheses around $var\n" . $herecurr) &&
   5365			    $fix) {
   5366				$fixed[$fixlinenr] =~ s/\(\s*\Q$var\E\s*\)/$var/;
   5367			}
   5368		}
   5369
   5370# check for unnecessary parentheses around function pointer uses
   5371# ie: (foo->bar)(); should be foo->bar();
   5372# but not "if (foo->bar) (" to avoid some false positives
   5373		if ($line =~ /(\bif\s*|)(\(\s*$Ident\s*(?:$Member\s*)+\))[ \t]*\(/ && $1 !~ /^if/) {
   5374			my $var = $2;
   5375			if (CHK("UNNECESSARY_PARENTHESES",
   5376				"Unnecessary parentheses around function pointer $var\n" . $herecurr) &&
   5377			    $fix) {
   5378				my $var2 = deparenthesize($var);
   5379				$var2 =~ s/\s//g;
   5380				$fixed[$fixlinenr] =~ s/\Q$var\E/$var2/;
   5381			}
   5382		}
   5383
   5384# check for unnecessary parentheses around comparisons in if uses
   5385# when !drivers/staging or command-line uses --strict
   5386		if (($realfile !~ m@^(?:drivers/staging/)@ || $check_orig) &&
   5387		    $perl_version_ok && defined($stat) &&
   5388		    $stat =~ /(^.\s*if\s*($balanced_parens))/) {
   5389			my $if_stat = $1;
   5390			my $test = substr($2, 1, -1);
   5391			my $herectx;
   5392			while ($test =~ /(?:^|[^\w\&\!\~])+\s*\(\s*([\&\!\~]?\s*$Lval\s*(?:$Compare\s*$FuncArg)?)\s*\)/g) {
   5393				my $match = $1;
   5394				# avoid parentheses around potential macro args
   5395				next if ($match =~ /^\s*\w+\s*$/);
   5396				if (!defined($herectx)) {
   5397					$herectx = $here . "\n";
   5398					my $cnt = statement_rawlines($if_stat);
   5399					for (my $n = 0; $n < $cnt; $n++) {
   5400						my $rl = raw_line($linenr, $n);
   5401						$herectx .=  $rl . "\n";
   5402						last if $rl =~ /^[ \+].*\{/;
   5403					}
   5404				}
   5405				CHK("UNNECESSARY_PARENTHESES",
   5406				    "Unnecessary parentheses around '$match'\n" . $herectx);
   5407			}
   5408		}
   5409
   5410# check that goto labels aren't indented (allow a single space indentation)
   5411# and ignore bitfield definitions like foo:1
   5412# Strictly, labels can have whitespace after the identifier and before the :
   5413# but this is not allowed here as many ?: uses would appear to be labels
   5414		if ($sline =~ /^.\s+[A-Za-z_][A-Za-z\d_]*:(?!\s*\d+)/ &&
   5415		    $sline !~ /^. [A-Za-z\d_][A-Za-z\d_]*:/ &&
   5416		    $sline !~ /^.\s+default:/) {
   5417			if (WARN("INDENTED_LABEL",
   5418				 "labels should not be indented\n" . $herecurr) &&
   5419			    $fix) {
   5420				$fixed[$fixlinenr] =~
   5421				    s/^(.)\s+/$1/;
   5422			}
   5423		}
   5424
   5425# check if a statement with a comma should be two statements like:
   5426#	foo = bar(),	/* comma should be semicolon */
   5427#	bar = baz();
   5428		if (defined($stat) &&
   5429		    $stat =~ /^\+\s*(?:$Lval\s*$Assignment\s*)?$FuncArg\s*,\s*(?:$Lval\s*$Assignment\s*)?$FuncArg\s*;\s*$/) {
   5430			my $cnt = statement_rawlines($stat);
   5431			my $herectx = get_stat_here($linenr, $cnt, $here);
   5432			WARN("SUSPECT_COMMA_SEMICOLON",
   5433			     "Possible comma where semicolon could be used\n" . $herectx);
   5434		}
   5435
   5436# return is not a function
   5437		if (defined($stat) && $stat =~ /^.\s*return(\s*)\(/s) {
   5438			my $spacing = $1;
   5439			if ($perl_version_ok &&
   5440			    $stat =~ /^.\s*return\s*($balanced_parens)\s*;\s*$/) {
   5441				my $value = $1;
   5442				$value = deparenthesize($value);
   5443				if ($value =~ m/^\s*$FuncArg\s*(?:\?|$)/) {
   5444					ERROR("RETURN_PARENTHESES",
   5445					      "return is not a function, parentheses are not required\n" . $herecurr);
   5446				}
   5447			} elsif ($spacing !~ /\s+/) {
   5448				ERROR("SPACING",
   5449				      "space required before the open parenthesis '('\n" . $herecurr);
   5450			}
   5451		}
   5452
   5453# unnecessary return in a void function
   5454# at end-of-function, with the previous line a single leading tab, then return;
   5455# and the line before that not a goto label target like "out:"
   5456		if ($sline =~ /^[ \+]}\s*$/ &&
   5457		    $prevline =~ /^\+\treturn\s*;\s*$/ &&
   5458		    $linenr >= 3 &&
   5459		    $lines[$linenr - 3] =~ /^[ +]/ &&
   5460		    $lines[$linenr - 3] !~ /^[ +]\s*$Ident\s*:/) {
   5461			WARN("RETURN_VOID",
   5462			     "void function return statements are not generally useful\n" . $hereprev);
   5463		}
   5464
   5465# if statements using unnecessary parentheses - ie: if ((foo == bar))
   5466		if ($perl_version_ok &&
   5467		    $line =~ /\bif\s*((?:\(\s*){2,})/) {
   5468			my $openparens = $1;
   5469			my $count = $openparens =~ tr@\(@\(@;
   5470			my $msg = "";
   5471			if ($line =~ /\bif\s*(?:\(\s*){$count,$count}$LvalOrFunc\s*($Compare)\s*$LvalOrFunc(?:\s*\)){$count,$count}/) {
   5472				my $comp = $4;	#Not $1 because of $LvalOrFunc
   5473				$msg = " - maybe == should be = ?" if ($comp eq "==");
   5474				WARN("UNNECESSARY_PARENTHESES",
   5475				     "Unnecessary parentheses$msg\n" . $herecurr);
   5476			}
   5477		}
   5478
   5479# comparisons with a constant or upper case identifier on the left
   5480#	avoid cases like "foo + BAR < baz"
   5481#	only fix matches surrounded by parentheses to avoid incorrect
   5482#	conversions like "FOO < baz() + 5" being "misfixed" to "baz() > FOO + 5"
   5483		if ($perl_version_ok &&
   5484		    $line =~ /^\+(.*)\b($Constant|[A-Z_][A-Z0-9_]*)\s*($Compare)\s*($LvalOrFunc)/) {
   5485			my $lead = $1;
   5486			my $const = $2;
   5487			my $comp = $3;
   5488			my $to = $4;
   5489			my $newcomp = $comp;
   5490			if ($lead !~ /(?:$Operators|\.)\s*$/ &&
   5491			    $to !~ /^(?:Constant|[A-Z_][A-Z0-9_]*)$/ &&
   5492			    WARN("CONSTANT_COMPARISON",
   5493				 "Comparisons should place the constant on the right side of the test\n" . $herecurr) &&
   5494			    $fix) {
   5495				if ($comp eq "<") {
   5496					$newcomp = ">";
   5497				} elsif ($comp eq "<=") {
   5498					$newcomp = ">=";
   5499				} elsif ($comp eq ">") {
   5500					$newcomp = "<";
   5501				} elsif ($comp eq ">=") {
   5502					$newcomp = "<=";
   5503				}
   5504				$fixed[$fixlinenr] =~ s/\(\s*\Q$const\E\s*$Compare\s*\Q$to\E\s*\)/($to $newcomp $const)/;
   5505			}
   5506		}
   5507
   5508# Return of what appears to be an errno should normally be negative
   5509		if ($sline =~ /\breturn(?:\s*\(+\s*|\s+)(E[A-Z]+)(?:\s*\)+\s*|\s*)[;:,]/) {
   5510			my $name = $1;
   5511			if ($name ne 'EOF' && $name ne 'ERROR' && $name !~ /^EPOLL/) {
   5512				WARN("USE_NEGATIVE_ERRNO",
   5513				     "return of an errno should typically be negative (ie: return -$1)\n" . $herecurr);
   5514			}
   5515		}
   5516
   5517# Need a space before open parenthesis after if, while etc
   5518		if ($line =~ /\b(if|while|for|switch)\(/) {
   5519			if (ERROR("SPACING",
   5520				  "space required before the open parenthesis '('\n" . $herecurr) &&
   5521			    $fix) {
   5522				$fixed[$fixlinenr] =~
   5523				    s/\b(if|while|for|switch)\(/$1 \(/;
   5524			}
   5525		}
   5526
   5527# Check for illegal assignment in if conditional -- and check for trailing
   5528# statements after the conditional.
   5529		if ($line =~ /do\s*(?!{)/) {
   5530			($stat, $cond, $line_nr_next, $remain_next, $off_next) =
   5531				ctx_statement_block($linenr, $realcnt, 0)
   5532					if (!defined $stat);
   5533			my ($stat_next) = ctx_statement_block($line_nr_next,
   5534						$remain_next, $off_next);
   5535			$stat_next =~ s/\n./\n /g;
   5536			##print "stat<$stat> stat_next<$stat_next>\n";
   5537
   5538			if ($stat_next =~ /^\s*while\b/) {
   5539				# If the statement carries leading newlines,
   5540				# then count those as offsets.
   5541				my ($whitespace) =
   5542					($stat_next =~ /^((?:\s*\n[+-])*\s*)/s);
   5543				my $offset =
   5544					statement_rawlines($whitespace) - 1;
   5545
   5546				$suppress_whiletrailers{$line_nr_next +
   5547								$offset} = 1;
   5548			}
   5549		}
   5550		if (!defined $suppress_whiletrailers{$linenr} &&
   5551		    defined($stat) && defined($cond) &&
   5552		    $line =~ /\b(?:if|while|for)\s*\(/ && $line !~ /^.\s*#/) {
   5553			my ($s, $c) = ($stat, $cond);
   5554			my $fixed_assign_in_if = 0;
   5555
   5556			if ($c =~ /\bif\s*\(.*[^<>!=]=[^=].*/s) {
   5557				if (ERROR("ASSIGN_IN_IF",
   5558					  "do not use assignment in if condition\n" . $herecurr) &&
   5559				    $fix && $perl_version_ok) {
   5560					if ($rawline =~ /^\+(\s+)if\s*\(\s*(\!)?\s*\(\s*(($Lval)\s*=\s*$LvalOrFunc)\s*\)\s*(?:($Compare)\s*($FuncArg))?\s*\)\s*(\{)?\s*$/) {
   5561						my $space = $1;
   5562						my $not = $2;
   5563						my $statement = $3;
   5564						my $assigned = $4;
   5565						my $test = $8;
   5566						my $against = $9;
   5567						my $brace = $15;
   5568						fix_delete_line($fixlinenr, $rawline);
   5569						fix_insert_line($fixlinenr, "$space$statement;");
   5570						my $newline = "${space}if (";
   5571						$newline .= '!' if defined($not);
   5572						$newline .= '(' if (defined $not && defined($test) && defined($against));
   5573						$newline .= "$assigned";
   5574						$newline .= " $test $against" if (defined($test) && defined($against));
   5575						$newline .= ')' if (defined $not && defined($test) && defined($against));
   5576						$newline .= ')';
   5577						$newline .= " {" if (defined($brace));
   5578						fix_insert_line($fixlinenr + 1, $newline);
   5579						$fixed_assign_in_if = 1;
   5580					}
   5581				}
   5582			}
   5583
   5584			# Find out what is on the end of the line after the
   5585			# conditional.
   5586			substr($s, 0, length($c), '');
   5587			$s =~ s/\n.*//g;
   5588			$s =~ s/$;//g;	# Remove any comments
   5589			if (length($c) && $s !~ /^\s*{?\s*\\*\s*$/ &&
   5590			    $c !~ /}\s*while\s*/)
   5591			{
   5592				# Find out how long the conditional actually is.
   5593				my @newlines = ($c =~ /\n/gs);
   5594				my $cond_lines = 1 + $#newlines;
   5595				my $stat_real = '';
   5596
   5597				$stat_real = raw_line($linenr, $cond_lines)
   5598							. "\n" if ($cond_lines);
   5599				if (defined($stat_real) && $cond_lines > 1) {
   5600					$stat_real = "[...]\n$stat_real";
   5601				}
   5602
   5603				if (ERROR("TRAILING_STATEMENTS",
   5604					  "trailing statements should be on next line\n" . $herecurr . $stat_real) &&
   5605				    !$fixed_assign_in_if &&
   5606				    $cond_lines == 0 &&
   5607				    $fix && $perl_version_ok &&
   5608				    $fixed[$fixlinenr] =~ /^\+(\s*)((?:if|while|for)\s*$balanced_parens)\s*(.*)$/) {
   5609					my $indent = $1;
   5610					my $test = $2;
   5611					my $rest = rtrim($4);
   5612					if ($rest =~ /;$/) {
   5613						$fixed[$fixlinenr] = "\+$indent$test";
   5614						fix_insert_line($fixlinenr + 1, "$indent\t$rest");
   5615					}
   5616				}
   5617			}
   5618		}
   5619
   5620# Check for bitwise tests written as boolean
   5621		if ($line =~ /
   5622			(?:
   5623				(?:\[|\(|\&\&|\|\|)
   5624				\s*0[xX][0-9]+\s*
   5625				(?:\&\&|\|\|)
   5626			|
   5627				(?:\&\&|\|\|)
   5628				\s*0[xX][0-9]+\s*
   5629				(?:\&\&|\|\||\)|\])
   5630			)/x)
   5631		{
   5632			WARN("HEXADECIMAL_BOOLEAN_TEST",
   5633			     "boolean test with hexadecimal, perhaps just 1 \& or \|?\n" . $herecurr);
   5634		}
   5635
   5636# if and else should not have general statements after it
   5637		if ($line =~ /^.\s*(?:}\s*)?else\b(.*)/) {
   5638			my $s = $1;
   5639			$s =~ s/$;//g;	# Remove any comments
   5640			if ($s !~ /^\s*(?:\sif|(?:{|)\s*\\?\s*$)/) {
   5641				ERROR("TRAILING_STATEMENTS",
   5642				      "trailing statements should be on next line\n" . $herecurr);
   5643			}
   5644		}
   5645# if should not continue a brace
   5646		if ($line =~ /}\s*if\b/) {
   5647			ERROR("TRAILING_STATEMENTS",
   5648			      "trailing statements should be on next line (or did you mean 'else if'?)\n" .
   5649				$herecurr);
   5650		}
   5651# case and default should not have general statements after them
   5652		if ($line =~ /^.\s*(?:case\s*.*|default\s*):/g &&
   5653		    $line !~ /\G(?:
   5654			(?:\s*$;*)(?:\s*{)?(?:\s*$;*)(?:\s*\\)?\s*$|
   5655			\s*return\s+
   5656		    )/xg)
   5657		{
   5658			ERROR("TRAILING_STATEMENTS",
   5659			      "trailing statements should be on next line\n" . $herecurr);
   5660		}
   5661
   5662		# Check for }<nl>else {, these must be at the same
   5663		# indent level to be relevant to each other.
   5664		if ($prevline=~/}\s*$/ and $line=~/^.\s*else\s*/ &&
   5665		    $previndent == $indent) {
   5666			if (ERROR("ELSE_AFTER_BRACE",
   5667				  "else should follow close brace '}'\n" . $hereprev) &&
   5668			    $fix && $prevline =~ /^\+/ && $line =~ /^\+/) {
   5669				fix_delete_line($fixlinenr - 1, $prevrawline);
   5670				fix_delete_line($fixlinenr, $rawline);
   5671				my $fixedline = $prevrawline;
   5672				$fixedline =~ s/}\s*$//;
   5673				if ($fixedline !~ /^\+\s*$/) {
   5674					fix_insert_line($fixlinenr, $fixedline);
   5675				}
   5676				$fixedline = $rawline;
   5677				$fixedline =~ s/^(.\s*)else/$1} else/;
   5678				fix_insert_line($fixlinenr, $fixedline);
   5679			}
   5680		}
   5681
   5682		if ($prevline=~/}\s*$/ and $line=~/^.\s*while\s*/ &&
   5683		    $previndent == $indent) {
   5684			my ($s, $c) = ctx_statement_block($linenr, $realcnt, 0);
   5685
   5686			# Find out what is on the end of the line after the
   5687			# conditional.
   5688			substr($s, 0, length($c), '');
   5689			$s =~ s/\n.*//g;
   5690
   5691			if ($s =~ /^\s*;/) {
   5692				if (ERROR("WHILE_AFTER_BRACE",
   5693					  "while should follow close brace '}'\n" . $hereprev) &&
   5694				    $fix && $prevline =~ /^\+/ && $line =~ /^\+/) {
   5695					fix_delete_line($fixlinenr - 1, $prevrawline);
   5696					fix_delete_line($fixlinenr, $rawline);
   5697					my $fixedline = $prevrawline;
   5698					my $trailing = $rawline;
   5699					$trailing =~ s/^\+//;
   5700					$trailing = trim($trailing);
   5701					$fixedline =~ s/}\s*$/} $trailing/;
   5702					fix_insert_line($fixlinenr, $fixedline);
   5703				}
   5704			}
   5705		}
   5706
   5707#Specific variable tests
   5708		while ($line =~ m{($Constant|$Lval)}g) {
   5709			my $var = $1;
   5710
   5711#CamelCase
   5712			if ($var !~ /^$Constant$/ &&
   5713			    $var =~ /[A-Z][a-z]|[a-z][A-Z]/ &&
   5714#Ignore some autogenerated defines and enum values
   5715			    $var !~ /^(?:[A-Z]+_){1,5}[A-Z]{1,3}[a-z]/ &&
   5716#Ignore Page<foo> variants
   5717			    $var !~ /^(?:Clear|Set|TestClear|TestSet|)Page[A-Z]/ &&
   5718#Ignore SI style variants like nS, mV and dB
   5719#(ie: max_uV, regulator_min_uA_show, RANGE_mA_VALUE)
   5720			    $var !~ /^(?:[a-z0-9_]*|[A-Z0-9_]*)?_?[a-z][A-Z](?:_[a-z0-9_]+|_[A-Z0-9_]+)?$/ &&
   5721#Ignore some three character SI units explicitly, like MiB and KHz
   5722			    $var !~ /^(?:[a-z_]*?)_?(?:[KMGT]iB|[KMGT]?Hz)(?:_[a-z_]+)?$/) {
   5723				while ($var =~ m{($Ident)}g) {
   5724					my $word = $1;
   5725					next if ($word !~ /[A-Z][a-z]|[a-z][A-Z]/);
   5726					if ($check) {
   5727						seed_camelcase_includes();
   5728						if (!$file && !$camelcase_file_seeded) {
   5729							seed_camelcase_file($realfile);
   5730							$camelcase_file_seeded = 1;
   5731						}
   5732					}
   5733					if (!defined $camelcase{$word}) {
   5734						$camelcase{$word} = 1;
   5735						CHK("CAMELCASE",
   5736						    "Avoid CamelCase: <$word>\n" . $herecurr);
   5737					}
   5738				}
   5739			}
   5740		}
   5741
   5742#no spaces allowed after \ in define
   5743		if ($line =~ /\#\s*define.*\\\s+$/) {
   5744			if (WARN("WHITESPACE_AFTER_LINE_CONTINUATION",
   5745				 "Whitespace after \\ makes next lines useless\n" . $herecurr) &&
   5746			    $fix) {
   5747				$fixed[$fixlinenr] =~ s/\s+$//;
   5748			}
   5749		}
   5750
   5751# warn if <asm/foo.h> is #included and <linux/foo.h> is available and includes
   5752# itself <asm/foo.h> (uses RAW line)
   5753		if ($tree && $rawline =~ m{^.\s*\#\s*include\s*\<asm\/(.*)\.h\>}) {
   5754			my $file = "$1.h";
   5755			my $checkfile = "include/linux/$file";
   5756			if (-f "$root/$checkfile" &&
   5757			    $realfile ne $checkfile &&
   5758			    $1 !~ /$allowed_asm_includes/)
   5759			{
   5760				my $asminclude = `grep -Ec "#include\\s+<asm/$file>" $root/$checkfile`;
   5761				if ($asminclude > 0) {
   5762					if ($realfile =~ m{^arch/}) {
   5763						CHK("ARCH_INCLUDE_LINUX",
   5764						    "Consider using #include <linux/$file> instead of <asm/$file>\n" . $herecurr);
   5765					} else {
   5766						WARN("INCLUDE_LINUX",
   5767						     "Use #include <linux/$file> instead of <asm/$file>\n" . $herecurr);
   5768					}
   5769				}
   5770			}
   5771		}
   5772
   5773# multi-statement macros should be enclosed in a do while loop, grab the
   5774# first statement and ensure its the whole macro if its not enclosed
   5775# in a known good container
   5776		if ($realfile !~ m@/vmlinux.lds.h$@ &&
   5777		    $line =~ /^.\s*\#\s*define\s*$Ident(\()?/) {
   5778			my $ln = $linenr;
   5779			my $cnt = $realcnt;
   5780			my ($off, $dstat, $dcond, $rest);
   5781			my $ctx = '';
   5782			my $has_flow_statement = 0;
   5783			my $has_arg_concat = 0;
   5784			($dstat, $dcond, $ln, $cnt, $off) =
   5785				ctx_statement_block($linenr, $realcnt, 0);
   5786			$ctx = $dstat;
   5787			#print "dstat<$dstat> dcond<$dcond> cnt<$cnt> off<$off>\n";
   5788			#print "LINE<$lines[$ln-1]> len<" . length($lines[$ln-1]) . "\n";
   5789
   5790			$has_flow_statement = 1 if ($ctx =~ /\b(goto|return)\b/);
   5791			$has_arg_concat = 1 if ($ctx =~ /\#\#/ && $ctx !~ /\#\#\s*(?:__VA_ARGS__|args)\b/);
   5792
   5793			$dstat =~ s/^.\s*\#\s*define\s+$Ident(\([^\)]*\))?\s*//;
   5794			my $define_args = $1;
   5795			my $define_stmt = $dstat;
   5796			my @def_args = ();
   5797
   5798			if (defined $define_args && $define_args ne "") {
   5799				$define_args = substr($define_args, 1, length($define_args) - 2);
   5800				$define_args =~ s/\s*//g;
   5801				$define_args =~ s/\\\+?//g;
   5802				@def_args = split(",", $define_args);
   5803			}
   5804
   5805			$dstat =~ s/$;//g;
   5806			$dstat =~ s/\\\n.//g;
   5807			$dstat =~ s/^\s*//s;
   5808			$dstat =~ s/\s*$//s;
   5809
   5810			# Flatten any parentheses and braces
   5811			while ($dstat =~ s/\([^\(\)]*\)/1u/ ||
   5812			       $dstat =~ s/\{[^\{\}]*\}/1u/ ||
   5813			       $dstat =~ s/.\[[^\[\]]*\]/1u/)
   5814			{
   5815			}
   5816
   5817			# Flatten any obvious string concatenation.
   5818			while ($dstat =~ s/($String)\s*$Ident/$1/ ||
   5819			       $dstat =~ s/$Ident\s*($String)/$1/)
   5820			{
   5821			}
   5822
   5823			# Make asm volatile uses seem like a generic function
   5824			$dstat =~ s/\b_*asm_*\s+_*volatile_*\b/asm_volatile/g;
   5825
   5826			my $exceptions = qr{
   5827				$Declare|
   5828				module_param_named|
   5829				MODULE_PARM_DESC|
   5830				DECLARE_PER_CPU|
   5831				DEFINE_PER_CPU|
   5832				__typeof__\(|
   5833				union|
   5834				struct|
   5835				\.$Ident\s*=\s*|
   5836				^\"|\"$|
   5837				^\[
   5838			}x;
   5839			#print "REST<$rest> dstat<$dstat> ctx<$ctx>\n";
   5840
   5841			$ctx =~ s/\n*$//;
   5842			my $stmt_cnt = statement_rawlines($ctx);
   5843			my $herectx = get_stat_here($linenr, $stmt_cnt, $here);
   5844
   5845			if ($dstat ne '' &&
   5846			    $dstat !~ /^(?:$Ident|-?$Constant),$/ &&			# 10, // foo(),
   5847			    $dstat !~ /^(?:$Ident|-?$Constant);$/ &&			# foo();
   5848			    $dstat !~ /^[!~-]?(?:$Lval|$Constant)$/ &&		# 10 // foo() // !foo // ~foo // -foo // foo->bar // foo.bar->baz
   5849			    $dstat !~ /^'X'$/ && $dstat !~ /^'XX'$/ &&			# character constants
   5850			    $dstat !~ /$exceptions/ &&
   5851			    $dstat !~ /^\.$Ident\s*=/ &&				# .foo =
   5852			    $dstat !~ /^(?:\#\s*$Ident|\#\s*$Constant)\s*$/ &&		# stringification #foo
   5853			    $dstat !~ /^do\s*$Constant\s*while\s*$Constant;?$/ &&	# do {...} while (...); // do {...} while (...)
   5854			    $dstat !~ /^while\s*$Constant\s*$Constant\s*$/ &&		# while (...) {...}
   5855			    $dstat !~ /^for\s*$Constant$/ &&				# for (...)
   5856			    $dstat !~ /^for\s*$Constant\s+(?:$Ident|-?$Constant)$/ &&	# for (...) bar()
   5857			    $dstat !~ /^do\s*{/ &&					# do {...
   5858			    $dstat !~ /^\(\{/ &&						# ({...
   5859			    $ctx !~ /^.\s*#\s*define\s+TRACE_(?:SYSTEM|INCLUDE_FILE|INCLUDE_PATH)\b/)
   5860			{
   5861				if ($dstat =~ /^\s*if\b/) {
   5862					ERROR("MULTISTATEMENT_MACRO_USE_DO_WHILE",
   5863					      "Macros starting with if should be enclosed by a do - while loop to avoid possible if/else logic defects\n" . "$herectx");
   5864				} elsif ($dstat =~ /;/) {
   5865					ERROR("MULTISTATEMENT_MACRO_USE_DO_WHILE",
   5866					      "Macros with multiple statements should be enclosed in a do - while loop\n" . "$herectx");
   5867				} else {
   5868					ERROR("COMPLEX_MACRO",
   5869					      "Macros with complex values should be enclosed in parentheses\n" . "$herectx");
   5870				}
   5871
   5872			}
   5873
   5874			# Make $define_stmt single line, comment-free, etc
   5875			my @stmt_array = split('\n', $define_stmt);
   5876			my $first = 1;
   5877			$define_stmt = "";
   5878			foreach my $l (@stmt_array) {
   5879				$l =~ s/\\$//;
   5880				if ($first) {
   5881					$define_stmt = $l;
   5882					$first = 0;
   5883				} elsif ($l =~ /^[\+ ]/) {
   5884					$define_stmt .= substr($l, 1);
   5885				}
   5886			}
   5887			$define_stmt =~ s/$;//g;
   5888			$define_stmt =~ s/\s+/ /g;
   5889			$define_stmt = trim($define_stmt);
   5890
   5891# check if any macro arguments are reused (ignore '...' and 'type')
   5892			foreach my $arg (@def_args) {
   5893			        next if ($arg =~ /\.\.\./);
   5894			        next if ($arg =~ /^type$/i);
   5895				my $tmp_stmt = $define_stmt;
   5896				$tmp_stmt =~ s/\b(__must_be_array|offsetof|sizeof|sizeof_field|__stringify|typeof|__typeof__|__builtin\w+|typecheck\s*\(\s*$Type\s*,|\#+)\s*\(*\s*$arg\s*\)*\b//g;
   5897				$tmp_stmt =~ s/\#+\s*$arg\b//g;
   5898				$tmp_stmt =~ s/\b$arg\s*\#\#//g;
   5899				my $use_cnt = () = $tmp_stmt =~ /\b$arg\b/g;
   5900				if ($use_cnt > 1) {
   5901					CHK("MACRO_ARG_REUSE",
   5902					    "Macro argument reuse '$arg' - possible side-effects?\n" . "$herectx");
   5903				    }
   5904# check if any macro arguments may have other precedence issues
   5905				if ($tmp_stmt =~ m/($Operators)?\s*\b$arg\b\s*($Operators)?/m &&
   5906				    ((defined($1) && $1 ne ',') ||
   5907				     (defined($2) && $2 ne ','))) {
   5908					CHK("MACRO_ARG_PRECEDENCE",
   5909					    "Macro argument '$arg' may be better as '($arg)' to avoid precedence issues\n" . "$herectx");
   5910				}
   5911			}
   5912
   5913# check for macros with flow control, but without ## concatenation
   5914# ## concatenation is commonly a macro that defines a function so ignore those
   5915			if ($has_flow_statement && !$has_arg_concat) {
   5916				my $cnt = statement_rawlines($ctx);
   5917				my $herectx = get_stat_here($linenr, $cnt, $here);
   5918
   5919				WARN("MACRO_WITH_FLOW_CONTROL",
   5920				     "Macros with flow control statements should be avoided\n" . "$herectx");
   5921			}
   5922
   5923# check for line continuations outside of #defines, preprocessor #, and asm
   5924
   5925		} else {
   5926			if ($prevline !~ /^..*\\$/ &&
   5927			    $line !~ /^\+\s*\#.*\\$/ &&		# preprocessor
   5928			    $line !~ /^\+.*\b(__asm__|asm)\b.*\\$/ &&	# asm
   5929			    $line =~ /^\+.*\\$/) {
   5930				WARN("LINE_CONTINUATIONS",
   5931				     "Avoid unnecessary line continuations\n" . $herecurr);
   5932			}
   5933		}
   5934
   5935# do {} while (0) macro tests:
   5936# single-statement macros do not need to be enclosed in do while (0) loop,
   5937# macro should not end with a semicolon
   5938		if ($perl_version_ok &&
   5939		    $realfile !~ m@/vmlinux.lds.h$@ &&
   5940		    $line =~ /^.\s*\#\s*define\s+$Ident(\()?/) {
   5941			my $ln = $linenr;
   5942			my $cnt = $realcnt;
   5943			my ($off, $dstat, $dcond, $rest);
   5944			my $ctx = '';
   5945			($dstat, $dcond, $ln, $cnt, $off) =
   5946				ctx_statement_block($linenr, $realcnt, 0);
   5947			$ctx = $dstat;
   5948
   5949			$dstat =~ s/\\\n.//g;
   5950			$dstat =~ s/$;/ /g;
   5951
   5952			if ($dstat =~ /^\+\s*#\s*define\s+$Ident\s*${balanced_parens}\s*do\s*{(.*)\s*}\s*while\s*\(\s*0\s*\)\s*([;\s]*)\s*$/) {
   5953				my $stmts = $2;
   5954				my $semis = $3;
   5955
   5956				$ctx =~ s/\n*$//;
   5957				my $cnt = statement_rawlines($ctx);
   5958				my $herectx = get_stat_here($linenr, $cnt, $here);
   5959
   5960				if (($stmts =~ tr/;/;/) == 1 &&
   5961				    $stmts !~ /^\s*(if|while|for|switch)\b/) {
   5962					WARN("SINGLE_STATEMENT_DO_WHILE_MACRO",
   5963					     "Single statement macros should not use a do {} while (0) loop\n" . "$herectx");
   5964				}
   5965				if (defined $semis && $semis ne "") {
   5966					WARN("DO_WHILE_MACRO_WITH_TRAILING_SEMICOLON",
   5967					     "do {} while (0) macros should not be semicolon terminated\n" . "$herectx");
   5968				}
   5969			} elsif ($dstat =~ /^\+\s*#\s*define\s+$Ident.*;\s*$/) {
   5970				$ctx =~ s/\n*$//;
   5971				my $cnt = statement_rawlines($ctx);
   5972				my $herectx = get_stat_here($linenr, $cnt, $here);
   5973
   5974				WARN("TRAILING_SEMICOLON",
   5975				     "macros should not use a trailing semicolon\n" . "$herectx");
   5976			}
   5977		}
   5978
   5979# check for redundant bracing round if etc
   5980		if ($line =~ /(^.*)\bif\b/ && $1 !~ /else\s*$/) {
   5981			my ($level, $endln, @chunks) =
   5982				ctx_statement_full($linenr, $realcnt, 1);
   5983			#print "chunks<$#chunks> linenr<$linenr> endln<$endln> level<$level>\n";
   5984			#print "APW: <<$chunks[1][0]>><<$chunks[1][1]>>\n";
   5985			if ($#chunks > 0 && $level == 0) {
   5986				my @allowed = ();
   5987				my $allow = 0;
   5988				my $seen = 0;
   5989				my $herectx = $here . "\n";
   5990				my $ln = $linenr - 1;
   5991				for my $chunk (@chunks) {
   5992					my ($cond, $block) = @{$chunk};
   5993
   5994					# If the condition carries leading newlines, then count those as offsets.
   5995					my ($whitespace) = ($cond =~ /^((?:\s*\n[+-])*\s*)/s);
   5996					my $offset = statement_rawlines($whitespace) - 1;
   5997
   5998					$allowed[$allow] = 0;
   5999					#print "COND<$cond> whitespace<$whitespace> offset<$offset>\n";
   6000
   6001					# We have looked at and allowed this specific line.
   6002					$suppress_ifbraces{$ln + $offset} = 1;
   6003
   6004					$herectx .= "$rawlines[$ln + $offset]\n[...]\n";
   6005					$ln += statement_rawlines($block) - 1;
   6006
   6007					substr($block, 0, length($cond), '');
   6008
   6009					$seen++ if ($block =~ /^\s*{/);
   6010
   6011					#print "cond<$cond> block<$block> allowed<$allowed[$allow]>\n";
   6012					if (statement_lines($cond) > 1) {
   6013						#print "APW: ALLOWED: cond<$cond>\n";
   6014						$allowed[$allow] = 1;
   6015					}
   6016					if ($block =~/\b(?:if|for|while)\b/) {
   6017						#print "APW: ALLOWED: block<$block>\n";
   6018						$allowed[$allow] = 1;
   6019					}
   6020					if (statement_block_size($block) > 1) {
   6021						#print "APW: ALLOWED: lines block<$block>\n";
   6022						$allowed[$allow] = 1;
   6023					}
   6024					$allow++;
   6025				}
   6026				if ($seen) {
   6027					my $sum_allowed = 0;
   6028					foreach (@allowed) {
   6029						$sum_allowed += $_;
   6030					}
   6031					if ($sum_allowed == 0) {
   6032						WARN("BRACES",
   6033						     "braces {} are not necessary for any arm of this statement\n" . $herectx);
   6034					} elsif ($sum_allowed != $allow &&
   6035						 $seen != $allow) {
   6036						CHK("BRACES",
   6037						    "braces {} should be used on all arms of this statement\n" . $herectx);
   6038					}
   6039				}
   6040			}
   6041		}
   6042		if (!defined $suppress_ifbraces{$linenr - 1} &&
   6043					$line =~ /\b(if|while|for|else)\b/) {
   6044			my $allowed = 0;
   6045
   6046			# Check the pre-context.
   6047			if (substr($line, 0, $-[0]) =~ /(\}\s*)$/) {
   6048				#print "APW: ALLOWED: pre<$1>\n";
   6049				$allowed = 1;
   6050			}
   6051
   6052			my ($level, $endln, @chunks) =
   6053				ctx_statement_full($linenr, $realcnt, $-[0]);
   6054
   6055			# Check the condition.
   6056			my ($cond, $block) = @{$chunks[0]};
   6057			#print "CHECKING<$linenr> cond<$cond> block<$block>\n";
   6058			if (defined $cond) {
   6059				substr($block, 0, length($cond), '');
   6060			}
   6061			if (statement_lines($cond) > 1) {
   6062				#print "APW: ALLOWED: cond<$cond>\n";
   6063				$allowed = 1;
   6064			}
   6065			if ($block =~/\b(?:if|for|while)\b/) {
   6066				#print "APW: ALLOWED: block<$block>\n";
   6067				$allowed = 1;
   6068			}
   6069			if (statement_block_size($block) > 1) {
   6070				#print "APW: ALLOWED: lines block<$block>\n";
   6071				$allowed = 1;
   6072			}
   6073			# Check the post-context.
   6074			if (defined $chunks[1]) {
   6075				my ($cond, $block) = @{$chunks[1]};
   6076				if (defined $cond) {
   6077					substr($block, 0, length($cond), '');
   6078				}
   6079				if ($block =~ /^\s*\{/) {
   6080					#print "APW: ALLOWED: chunk-1 block<$block>\n";
   6081					$allowed = 1;
   6082				}
   6083			}
   6084			if ($level == 0 && $block =~ /^\s*\{/ && !$allowed) {
   6085				my $cnt = statement_rawlines($block);
   6086				my $herectx = get_stat_here($linenr, $cnt, $here);
   6087
   6088				WARN("BRACES",
   6089				     "braces {} are not necessary for single statement blocks\n" . $herectx);
   6090			}
   6091		}
   6092
   6093# check for single line unbalanced braces
   6094		if ($sline =~ /^.\s*\}\s*else\s*$/ ||
   6095		    $sline =~ /^.\s*else\s*\{\s*$/) {
   6096			CHK("BRACES", "Unbalanced braces around else statement\n" . $herecurr);
   6097		}
   6098
   6099# check for unnecessary blank lines around braces
   6100		if (($line =~ /^.\s*}\s*$/ && $prevrawline =~ /^.\s*$/)) {
   6101			if (CHK("BRACES",
   6102				"Blank lines aren't necessary before a close brace '}'\n" . $hereprev) &&
   6103			    $fix && $prevrawline =~ /^\+/) {
   6104				fix_delete_line($fixlinenr - 1, $prevrawline);
   6105			}
   6106		}
   6107		if (($rawline =~ /^.\s*$/ && $prevline =~ /^..*{\s*$/)) {
   6108			if (CHK("BRACES",
   6109				"Blank lines aren't necessary after an open brace '{'\n" . $hereprev) &&
   6110			    $fix) {
   6111				fix_delete_line($fixlinenr, $rawline);
   6112			}
   6113		}
   6114
   6115# no volatiles please
   6116		my $asm_volatile = qr{\b(__asm__|asm)\s+(__volatile__|volatile)\b};
   6117		if ($line =~ /\bvolatile\b/ && $line !~ /$asm_volatile/) {
   6118			WARN("VOLATILE",
   6119			     "Use of volatile is usually wrong: see Documentation/process/volatile-considered-harmful.rst\n" . $herecurr);
   6120		}
   6121
   6122# Check for user-visible strings broken across lines, which breaks the ability
   6123# to grep for the string.  Make exceptions when the previous string ends in a
   6124# newline (multiple lines in one string constant) or '\t', '\r', ';', or '{'
   6125# (common in inline assembly) or is a octal \123 or hexadecimal \xaf value
   6126		if ($line =~ /^\+\s*$String/ &&
   6127		    $prevline =~ /"\s*$/ &&
   6128		    $prevrawline !~ /(?:\\(?:[ntr]|[0-7]{1,3}|x[0-9a-fA-F]{1,2})|;\s*|\{\s*)"\s*$/) {
   6129			if (WARN("SPLIT_STRING",
   6130				 "quoted string split across lines\n" . $hereprev) &&
   6131				     $fix &&
   6132				     $prevrawline =~ /^\+.*"\s*$/ &&
   6133				     $last_coalesced_string_linenr != $linenr - 1) {
   6134				my $extracted_string = get_quoted_string($line, $rawline);
   6135				my $comma_close = "";
   6136				if ($rawline =~ /\Q$extracted_string\E(\s*\)\s*;\s*$|\s*,\s*)/) {
   6137					$comma_close = $1;
   6138				}
   6139
   6140				fix_delete_line($fixlinenr - 1, $prevrawline);
   6141				fix_delete_line($fixlinenr, $rawline);
   6142				my $fixedline = $prevrawline;
   6143				$fixedline =~ s/"\s*$//;
   6144				$fixedline .= substr($extracted_string, 1) . trim($comma_close);
   6145				fix_insert_line($fixlinenr - 1, $fixedline);
   6146				$fixedline = $rawline;
   6147				$fixedline =~ s/\Q$extracted_string\E\Q$comma_close\E//;
   6148				if ($fixedline !~ /\+\s*$/) {
   6149					fix_insert_line($fixlinenr, $fixedline);
   6150				}
   6151				$last_coalesced_string_linenr = $linenr;
   6152			}
   6153		}
   6154
   6155# check for missing a space in a string concatenation
   6156		if ($prevrawline =~ /[^\\]\w"$/ && $rawline =~ /^\+[\t ]+"\w/) {
   6157			WARN('MISSING_SPACE',
   6158			     "break quoted strings at a space character\n" . $hereprev);
   6159		}
   6160
   6161# check for an embedded function name in a string when the function is known
   6162# This does not work very well for -f --file checking as it depends on patch
   6163# context providing the function name or a single line form for in-file
   6164# function declarations
   6165		if ($line =~ /^\+.*$String/ &&
   6166		    defined($context_function) &&
   6167		    get_quoted_string($line, $rawline) =~ /\b$context_function\b/ &&
   6168		    length(get_quoted_string($line, $rawline)) != (length($context_function) + 2)) {
   6169			WARN("EMBEDDED_FUNCTION_NAME",
   6170			     "Prefer using '\"%s...\", __func__' to using '$context_function', this function's name, in a string\n" . $herecurr);
   6171		}
   6172
   6173# check for unnecessary function tracing like uses
   6174# This does not use $logFunctions because there are many instances like
   6175# 'dprintk(FOO, "%s()\n", __func__);' which do not match $logFunctions
   6176		if ($rawline =~ /^\+.*\([^"]*"$tracing_logging_tags{0,3}%s(?:\s*\(\s*\)\s*)?$tracing_logging_tags{0,3}(?:\\n)?"\s*,\s*__func__\s*\)\s*;/) {
   6177			if (WARN("TRACING_LOGGING",
   6178				 "Unnecessary ftrace-like logging - prefer using ftrace\n" . $herecurr) &&
   6179			    $fix) {
   6180                                fix_delete_line($fixlinenr, $rawline);
   6181			}
   6182		}
   6183
   6184# check for spaces before a quoted newline
   6185		if ($rawline =~ /^.*\".*\s\\n/) {
   6186			if (WARN("QUOTED_WHITESPACE_BEFORE_NEWLINE",
   6187				 "unnecessary whitespace before a quoted newline\n" . $herecurr) &&
   6188			    $fix) {
   6189				$fixed[$fixlinenr] =~ s/^(\+.*\".*)\s+\\n/$1\\n/;
   6190			}
   6191
   6192		}
   6193
   6194# concatenated string without spaces between elements
   6195		if ($line =~ /$String[A-Z_]/ ||
   6196		    ($line =~ /([A-Za-z0-9_]+)$String/ && $1 !~ /^[Lu]$/)) {
   6197			if (CHK("CONCATENATED_STRING",
   6198				"Concatenated strings should use spaces between elements\n" . $herecurr) &&
   6199			    $fix) {
   6200				while ($line =~ /($String)/g) {
   6201					my $extracted_string = substr($rawline, $-[0], $+[0] - $-[0]);
   6202					$fixed[$fixlinenr] =~ s/\Q$extracted_string\E([A-Za-z0-9_])/$extracted_string $1/;
   6203					$fixed[$fixlinenr] =~ s/([A-Za-z0-9_])\Q$extracted_string\E/$1 $extracted_string/;
   6204				}
   6205			}
   6206		}
   6207
   6208# uncoalesced string fragments
   6209		if ($line =~ /$String\s*[Lu]?"/) {
   6210			if (WARN("STRING_FRAGMENTS",
   6211				 "Consecutive strings are generally better as a single string\n" . $herecurr) &&
   6212			    $fix) {
   6213				while ($line =~ /($String)(?=\s*")/g) {
   6214					my $extracted_string = substr($rawline, $-[0], $+[0] - $-[0]);
   6215					$fixed[$fixlinenr] =~ s/\Q$extracted_string\E\s*"/substr($extracted_string, 0, -1)/e;
   6216				}
   6217			}
   6218		}
   6219
   6220# check for non-standard and hex prefixed decimal printf formats
   6221		my $show_L = 1;	#don't show the same defect twice
   6222		my $show_Z = 1;
   6223		while ($line =~ /(?:^|")([X\t]*)(?:"|$)/g) {
   6224			my $string = substr($rawline, $-[1], $+[1] - $-[1]);
   6225			$string =~ s/%%/__/g;
   6226			# check for %L
   6227			if ($show_L && $string =~ /%[\*\d\.\$]*L([diouxX])/) {
   6228				WARN("PRINTF_L",
   6229				     "\%L$1 is non-standard C, use %ll$1\n" . $herecurr);
   6230				$show_L = 0;
   6231			}
   6232			# check for %Z
   6233			if ($show_Z && $string =~ /%[\*\d\.\$]*Z([diouxX])/) {
   6234				WARN("PRINTF_Z",
   6235				     "%Z$1 is non-standard C, use %z$1\n" . $herecurr);
   6236				$show_Z = 0;
   6237			}
   6238			# check for 0x<decimal>
   6239			if ($string =~ /0x%[\*\d\.\$\Llzth]*[diou]/) {
   6240				ERROR("PRINTF_0XDECIMAL",
   6241				      "Prefixing 0x with decimal output is defective\n" . $herecurr);
   6242			}
   6243		}
   6244
   6245# check for line continuations in quoted strings with odd counts of "
   6246		if ($rawline =~ /\\$/ && $sline =~ tr/"/"/ % 2) {
   6247			WARN("LINE_CONTINUATIONS",
   6248			     "Avoid line continuations in quoted strings\n" . $herecurr);
   6249		}
   6250
   6251# warn about #if 0
   6252		if ($line =~ /^.\s*\#\s*if\s+0\b/) {
   6253			WARN("IF_0",
   6254			     "Consider removing the code enclosed by this #if 0 and its #endif\n" . $herecurr);
   6255		}
   6256
   6257# warn about #if 1
   6258		if ($line =~ /^.\s*\#\s*if\s+1\b/) {
   6259			WARN("IF_1",
   6260			     "Consider removing the #if 1 and its #endif\n" . $herecurr);
   6261		}
   6262
   6263# check for needless "if (<foo>) fn(<foo>)" uses
   6264		if ($prevline =~ /\bif\s*\(\s*($Lval)\s*\)/) {
   6265			my $tested = quotemeta($1);
   6266			my $expr = '\s*\(\s*' . $tested . '\s*\)\s*;';
   6267			if ($line =~ /\b(kfree|usb_free_urb|debugfs_remove(?:_recursive)?|(?:kmem_cache|mempool|dma_pool)_destroy)$expr/) {
   6268				my $func = $1;
   6269				if (WARN('NEEDLESS_IF',
   6270					 "$func(NULL) is safe and this check is probably not required\n" . $hereprev) &&
   6271				    $fix) {
   6272					my $do_fix = 1;
   6273					my $leading_tabs = "";
   6274					my $new_leading_tabs = "";
   6275					if ($lines[$linenr - 2] =~ /^\+(\t*)if\s*\(\s*$tested\s*\)\s*$/) {
   6276						$leading_tabs = $1;
   6277					} else {
   6278						$do_fix = 0;
   6279					}
   6280					if ($lines[$linenr - 1] =~ /^\+(\t+)$func\s*\(\s*$tested\s*\)\s*;\s*$/) {
   6281						$new_leading_tabs = $1;
   6282						if (length($leading_tabs) + 1 ne length($new_leading_tabs)) {
   6283							$do_fix = 0;
   6284						}
   6285					} else {
   6286						$do_fix = 0;
   6287					}
   6288					if ($do_fix) {
   6289						fix_delete_line($fixlinenr - 1, $prevrawline);
   6290						$fixed[$fixlinenr] =~ s/^\+$new_leading_tabs/\+$leading_tabs/;
   6291					}
   6292				}
   6293			}
   6294		}
   6295
   6296# check for unnecessary "Out of Memory" messages
   6297		if ($line =~ /^\+.*\b$logFunctions\s*\(/ &&
   6298		    $prevline =~ /^[ \+]\s*if\s*\(\s*(\!\s*|NULL\s*==\s*)?($Lval)(\s*==\s*NULL\s*)?\s*\)/ &&
   6299		    (defined $1 || defined $3) &&
   6300		    $linenr > 3) {
   6301			my $testval = $2;
   6302			my $testline = $lines[$linenr - 3];
   6303
   6304			my ($s, $c) = ctx_statement_block($linenr - 3, $realcnt, 0);
   6305#			print("line: <$line>\nprevline: <$prevline>\ns: <$s>\nc: <$c>\n\n\n");
   6306
   6307			if ($s =~ /(?:^|\n)[ \+]\s*(?:$Type\s*)?\Q$testval\E\s*=\s*(?:\([^\)]*\)\s*)?\s*$allocFunctions\s*\(/ &&
   6308			    $s !~ /\b__GFP_NOWARN\b/ ) {
   6309				WARN("OOM_MESSAGE",
   6310				     "Possible unnecessary 'out of memory' message\n" . $hereprev);
   6311			}
   6312		}
   6313
   6314# check for logging functions with KERN_<LEVEL>
   6315		if ($line !~ /printk(?:_ratelimited|_once)?\s*\(/ &&
   6316		    $line =~ /\b$logFunctions\s*\(.*\b(KERN_[A-Z]+)\b/) {
   6317			my $level = $1;
   6318			if (WARN("UNNECESSARY_KERN_LEVEL",
   6319				 "Possible unnecessary $level\n" . $herecurr) &&
   6320			    $fix) {
   6321				$fixed[$fixlinenr] =~ s/\s*$level\s*//;
   6322			}
   6323		}
   6324
   6325# check for logging continuations
   6326		if ($line =~ /\bprintk\s*\(\s*KERN_CONT\b|\bpr_cont\s*\(/) {
   6327			WARN("LOGGING_CONTINUATION",
   6328			     "Avoid logging continuation uses where feasible\n" . $herecurr);
   6329		}
   6330
   6331# check for unnecessary use of %h[xudi] and %hh[xudi] in logging functions
   6332		if (defined $stat &&
   6333		    $line =~ /\b$logFunctions\s*\(/ &&
   6334		    index($stat, '"') >= 0) {
   6335			my $lc = $stat =~ tr@\n@@;
   6336			$lc = $lc + $linenr;
   6337			my $stat_real = get_stat_real($linenr, $lc);
   6338			pos($stat_real) = index($stat_real, '"');
   6339			while ($stat_real =~ /[^\"%]*(%[\#\d\.\*\-]*(h+)[idux])/g) {
   6340				my $pspec = $1;
   6341				my $h = $2;
   6342				my $lineoff = substr($stat_real, 0, $-[1]) =~ tr@\n@@;
   6343				if (WARN("UNNECESSARY_MODIFIER",
   6344					 "Integer promotion: Using '$h' in '$pspec' is unnecessary\n" . "$here\n$stat_real\n") &&
   6345				    $fix && $fixed[$fixlinenr + $lineoff] =~ /^\+/) {
   6346					my $nspec = $pspec;
   6347					$nspec =~ s/h//g;
   6348					$fixed[$fixlinenr + $lineoff] =~ s/\Q$pspec\E/$nspec/;
   6349				}
   6350			}
   6351		}
   6352
   6353# check for mask then right shift without a parentheses
   6354		if ($perl_version_ok &&
   6355		    $line =~ /$LvalOrFunc\s*\&\s*($LvalOrFunc)\s*>>/ &&
   6356		    $4 !~ /^\&/) { # $LvalOrFunc may be &foo, ignore if so
   6357			WARN("MASK_THEN_SHIFT",
   6358			     "Possible precedence defect with mask then right shift - may need parentheses\n" . $herecurr);
   6359		}
   6360
   6361# check for pointer comparisons to NULL
   6362		if ($perl_version_ok) {
   6363			while ($line =~ /\b$LvalOrFunc\s*(==|\!=)\s*NULL\b/g) {
   6364				my $val = $1;
   6365				my $equal = "!";
   6366				$equal = "" if ($4 eq "!=");
   6367				if (CHK("COMPARISON_TO_NULL",
   6368					"Comparison to NULL could be written \"${equal}${val}\"\n" . $herecurr) &&
   6369					    $fix) {
   6370					$fixed[$fixlinenr] =~ s/\b\Q$val\E\s*(?:==|\!=)\s*NULL\b/$equal$val/;
   6371				}
   6372			}
   6373		}
   6374
   6375# check for bad placement of section $InitAttribute (e.g.: __initdata)
   6376		if ($line =~ /(\b$InitAttribute\b)/) {
   6377			my $attr = $1;
   6378			if ($line =~ /^\+\s*static\s+(?:const\s+)?(?:$attr\s+)?($NonptrTypeWithAttr)\s+(?:$attr\s+)?($Ident(?:\[[^]]*\])?)\s*[=;]/) {
   6379				my $ptr = $1;
   6380				my $var = $2;
   6381				if ((($ptr =~ /\b(union|struct)\s+$attr\b/ &&
   6382				      ERROR("MISPLACED_INIT",
   6383					    "$attr should be placed after $var\n" . $herecurr)) ||
   6384				     ($ptr !~ /\b(union|struct)\s+$attr\b/ &&
   6385				      WARN("MISPLACED_INIT",
   6386					   "$attr should be placed after $var\n" . $herecurr))) &&
   6387				    $fix) {
   6388					$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;
   6389				}
   6390			}
   6391		}
   6392
   6393# check for $InitAttributeData (ie: __initdata) with const
   6394		if ($line =~ /\bconst\b/ && $line =~ /($InitAttributeData)/) {
   6395			my $attr = $1;
   6396			$attr =~ /($InitAttributePrefix)(.*)/;
   6397			my $attr_prefix = $1;
   6398			my $attr_type = $2;
   6399			if (ERROR("INIT_ATTRIBUTE",
   6400				  "Use of const init definition must use ${attr_prefix}initconst\n" . $herecurr) &&
   6401			    $fix) {
   6402				$fixed[$fixlinenr] =~
   6403				    s/$InitAttributeData/${attr_prefix}initconst/;
   6404			}
   6405		}
   6406
   6407# check for $InitAttributeConst (ie: __initconst) without const
   6408		if ($line !~ /\bconst\b/ && $line =~ /($InitAttributeConst)/) {
   6409			my $attr = $1;
   6410			if (ERROR("INIT_ATTRIBUTE",
   6411				  "Use of $attr requires a separate use of const\n" . $herecurr) &&
   6412			    $fix) {
   6413				my $lead = $fixed[$fixlinenr] =~
   6414				    /(^\+\s*(?:static\s+))/;
   6415				$lead = rtrim($1);
   6416				$lead = "$lead " if ($lead !~ /^\+$/);
   6417				$lead = "${lead}const ";
   6418				$fixed[$fixlinenr] =~ s/(^\+\s*(?:static\s+))/$lead/;
   6419			}
   6420		}
   6421
   6422# check for __read_mostly with const non-pointer (should just be const)
   6423		if ($line =~ /\b__read_mostly\b/ &&
   6424		    $line =~ /($Type)\s*$Ident/ && $1 !~ /\*\s*$/ && $1 =~ /\bconst\b/) {
   6425			if (ERROR("CONST_READ_MOSTLY",
   6426				  "Invalid use of __read_mostly with const type\n" . $herecurr) &&
   6427			    $fix) {
   6428				$fixed[$fixlinenr] =~ s/\s+__read_mostly\b//;
   6429			}
   6430		}
   6431
   6432# don't use __constant_<foo> functions outside of include/uapi/
   6433		if ($realfile !~ m@^include/uapi/@ &&
   6434		    $line =~ /(__constant_(?:htons|ntohs|[bl]e(?:16|32|64)_to_cpu|cpu_to_[bl]e(?:16|32|64)))\s*\(/) {
   6435			my $constant_func = $1;
   6436			my $func = $constant_func;
   6437			$func =~ s/^__constant_//;
   6438			if (WARN("CONSTANT_CONVERSION",
   6439				 "$constant_func should be $func\n" . $herecurr) &&
   6440			    $fix) {
   6441				$fixed[$fixlinenr] =~ s/\b$constant_func\b/$func/g;
   6442			}
   6443		}
   6444
   6445# prefer usleep_range over udelay
   6446		if ($line =~ /\budelay\s*\(\s*(\d+)\s*\)/) {
   6447			my $delay = $1;
   6448			# ignore udelay's < 10, however
   6449			if (! ($delay < 10) ) {
   6450				CHK("USLEEP_RANGE",
   6451				    "usleep_range is preferred over udelay; see Documentation/timers/timers-howto.rst\n" . $herecurr);
   6452			}
   6453			if ($delay > 2000) {
   6454				WARN("LONG_UDELAY",
   6455				     "long udelay - prefer mdelay; see arch/arm/include/asm/delay.h\n" . $herecurr);
   6456			}
   6457		}
   6458
   6459# warn about unexpectedly long msleep's
   6460		if ($line =~ /\bmsleep\s*\((\d+)\);/) {
   6461			if ($1 < 20) {
   6462				WARN("MSLEEP",
   6463				     "msleep < 20ms can sleep for up to 20ms; see Documentation/timers/timers-howto.rst\n" . $herecurr);
   6464			}
   6465		}
   6466
   6467# check for comparisons of jiffies
   6468		if ($line =~ /\bjiffies\s*$Compare|$Compare\s*jiffies\b/) {
   6469			WARN("JIFFIES_COMPARISON",
   6470			     "Comparing jiffies is almost always wrong; prefer time_after, time_before and friends\n" . $herecurr);
   6471		}
   6472
   6473# check for comparisons of get_jiffies_64()
   6474		if ($line =~ /\bget_jiffies_64\s*\(\s*\)\s*$Compare|$Compare\s*get_jiffies_64\s*\(\s*\)/) {
   6475			WARN("JIFFIES_COMPARISON",
   6476			     "Comparing get_jiffies_64() is almost always wrong; prefer time_after64, time_before64 and friends\n" . $herecurr);
   6477		}
   6478
   6479# warn about #ifdefs in C files
   6480#		if ($line =~ /^.\s*\#\s*if(|n)def/ && ($realfile =~ /\.c$/)) {
   6481#			print "#ifdef in C files should be avoided\n";
   6482#			print "$herecurr";
   6483#			$clean = 0;
   6484#		}
   6485
   6486# warn about spacing in #ifdefs
   6487		if ($line =~ /^.\s*\#\s*(ifdef|ifndef|elif)\s\s+/) {
   6488			if (ERROR("SPACING",
   6489				  "exactly one space required after that #$1\n" . $herecurr) &&
   6490			    $fix) {
   6491				$fixed[$fixlinenr] =~
   6492				    s/^(.\s*\#\s*(ifdef|ifndef|elif))\s{2,}/$1 /;
   6493			}
   6494
   6495		}
   6496
   6497# check for spinlock_t definitions without a comment.
   6498		if ($line =~ /^.\s*(struct\s+mutex|spinlock_t)\s+\S+;/ ||
   6499		    $line =~ /^.\s*(DEFINE_MUTEX)\s*\(/) {
   6500			my $which = $1;
   6501			if (!ctx_has_comment($first_line, $linenr)) {
   6502				CHK("UNCOMMENTED_DEFINITION",
   6503				    "$1 definition without comment\n" . $herecurr);
   6504			}
   6505		}
   6506# check for memory barriers without a comment.
   6507
   6508		my $barriers = qr{
   6509			mb|
   6510			rmb|
   6511			wmb
   6512		}x;
   6513		my $barrier_stems = qr{
   6514			mb__before_atomic|
   6515			mb__after_atomic|
   6516			store_release|
   6517			load_acquire|
   6518			store_mb|
   6519			(?:$barriers)
   6520		}x;
   6521		my $all_barriers = qr{
   6522			(?:$barriers)|
   6523			smp_(?:$barrier_stems)|
   6524			virt_(?:$barrier_stems)
   6525		}x;
   6526
   6527		if ($line =~ /\b(?:$all_barriers)\s*\(/) {
   6528			if (!ctx_has_comment($first_line, $linenr)) {
   6529				WARN("MEMORY_BARRIER",
   6530				     "memory barrier without comment\n" . $herecurr);
   6531			}
   6532		}
   6533
   6534		my $underscore_smp_barriers = qr{__smp_(?:$barrier_stems)}x;
   6535
   6536		if ($realfile !~ m@^include/asm-generic/@ &&
   6537		    $realfile !~ m@/barrier\.h$@ &&
   6538		    $line =~ m/\b(?:$underscore_smp_barriers)\s*\(/ &&
   6539		    $line !~ m/^.\s*\#\s*define\s+(?:$underscore_smp_barriers)\s*\(/) {
   6540			WARN("MEMORY_BARRIER",
   6541			     "__smp memory barriers shouldn't be used outside barrier.h and asm-generic\n" . $herecurr);
   6542		}
   6543
   6544# check for waitqueue_active without a comment.
   6545		if ($line =~ /\bwaitqueue_active\s*\(/) {
   6546			if (!ctx_has_comment($first_line, $linenr)) {
   6547				WARN("WAITQUEUE_ACTIVE",
   6548				     "waitqueue_active without comment\n" . $herecurr);
   6549			}
   6550		}
   6551
   6552# check for data_race without a comment.
   6553		if ($line =~ /\bdata_race\s*\(/) {
   6554			if (!ctx_has_comment($first_line, $linenr)) {
   6555				WARN("DATA_RACE",
   6556				     "data_race without comment\n" . $herecurr);
   6557			}
   6558		}
   6559
   6560# check of hardware specific defines
   6561		if ($line =~ m@^.\s*\#\s*if.*\b(__i386__|__powerpc64__|__sun__|__s390x__)\b@ && $realfile !~ m@include/asm-@) {
   6562			CHK("ARCH_DEFINES",
   6563			    "architecture specific defines should be avoided\n" .  $herecurr);
   6564		}
   6565
   6566# check that the storage class is not after a type
   6567		if ($line =~ /\b($Type)\s+($Storage)\b/) {
   6568			WARN("STORAGE_CLASS",
   6569			     "storage class '$2' should be located before type '$1'\n" . $herecurr);
   6570		}
   6571# Check that the storage class is at the beginning of a declaration
   6572		if ($line =~ /\b$Storage\b/ &&
   6573		    $line !~ /^.\s*$Storage/ &&
   6574		    $line =~ /^.\s*(.+?)\$Storage\s/ &&
   6575		    $1 !~ /[\,\)]\s*$/) {
   6576			WARN("STORAGE_CLASS",
   6577			     "storage class should be at the beginning of the declaration\n" . $herecurr);
   6578		}
   6579
   6580# check the location of the inline attribute, that it is between
   6581# storage class and type.
   6582		if ($line =~ /\b$Type\s+$Inline\b/ ||
   6583		    $line =~ /\b$Inline\s+$Storage\b/) {
   6584			ERROR("INLINE_LOCATION",
   6585			      "inline keyword should sit between storage class and type\n" . $herecurr);
   6586		}
   6587
   6588# Check for __inline__ and __inline, prefer inline
   6589		if ($realfile !~ m@\binclude/uapi/@ &&
   6590		    $line =~ /\b(__inline__|__inline)\b/) {
   6591			if (WARN("INLINE",
   6592				 "plain inline is preferred over $1\n" . $herecurr) &&
   6593			    $fix) {
   6594				$fixed[$fixlinenr] =~ s/\b(__inline__|__inline)\b/inline/;
   6595
   6596			}
   6597		}
   6598
   6599# Check for compiler attributes
   6600		if ($realfile !~ m@\binclude/uapi/@ &&
   6601		    $rawline =~ /\b__attribute__\s*\(\s*($balanced_parens)\s*\)/) {
   6602			my $attr = $1;
   6603			$attr =~ s/\s*\(\s*(.*)\)\s*/$1/;
   6604
   6605			my %attr_list = (
   6606				"alias"				=> "__alias",
   6607				"aligned"			=> "__aligned",
   6608				"always_inline"			=> "__always_inline",
   6609				"assume_aligned"		=> "__assume_aligned",
   6610				"cold"				=> "__cold",
   6611				"const"				=> "__attribute_const__",
   6612				"copy"				=> "__copy",
   6613				"designated_init"		=> "__designated_init",
   6614				"externally_visible"		=> "__visible",
   6615				"format"			=> "printf|scanf",
   6616				"gnu_inline"			=> "__gnu_inline",
   6617				"malloc"			=> "__malloc",
   6618				"mode"				=> "__mode",
   6619				"no_caller_saved_registers"	=> "__no_caller_saved_registers",
   6620				"noclone"			=> "__noclone",
   6621				"noinline"			=> "noinline",
   6622				"nonstring"			=> "__nonstring",
   6623				"noreturn"			=> "__noreturn",
   6624				"packed"			=> "__packed",
   6625				"pure"				=> "__pure",
   6626				"section"			=> "__section",
   6627				"used"				=> "__used",
   6628				"weak"				=> "__weak"
   6629			);
   6630
   6631			while ($attr =~ /\s*(\w+)\s*(${balanced_parens})?/g) {
   6632				my $orig_attr = $1;
   6633				my $params = '';
   6634				$params = $2 if defined($2);
   6635				my $curr_attr = $orig_attr;
   6636				$curr_attr =~ s/^[\s_]+|[\s_]+$//g;
   6637				if (exists($attr_list{$curr_attr})) {
   6638					my $new = $attr_list{$curr_attr};
   6639					if ($curr_attr eq "format" && $params) {
   6640						$params =~ /^\s*\(\s*(\w+)\s*,\s*(.*)/;
   6641						$new = "__$1\($2";
   6642					} else {
   6643						$new = "$new$params";
   6644					}
   6645					if (WARN("PREFER_DEFINED_ATTRIBUTE_MACRO",
   6646						 "Prefer $new over __attribute__(($orig_attr$params))\n" . $herecurr) &&
   6647					    $fix) {
   6648						my $remove = "\Q$orig_attr\E" . '\s*' . "\Q$params\E" . '(?:\s*,\s*)?';
   6649						$fixed[$fixlinenr] =~ s/$remove//;
   6650						$fixed[$fixlinenr] =~ s/\b__attribute__/$new __attribute__/;
   6651						$fixed[$fixlinenr] =~ s/\}\Q$new\E/} $new/;
   6652						$fixed[$fixlinenr] =~ s/ __attribute__\s*\(\s*\(\s*\)\s*\)//;
   6653					}
   6654				}
   6655			}
   6656
   6657			# Check for __attribute__ unused, prefer __always_unused or __maybe_unused
   6658			if ($attr =~ /^_*unused/) {
   6659				WARN("PREFER_DEFINED_ATTRIBUTE_MACRO",
   6660				     "__always_unused or __maybe_unused is preferred over __attribute__((__unused__))\n" . $herecurr);
   6661			}
   6662		}
   6663
   6664# Check for __attribute__ weak, or __weak declarations (may have link issues)
   6665		if ($perl_version_ok &&
   6666		    $line =~ /(?:$Declare|$DeclareMisordered)\s*$Ident\s*$balanced_parens\s*(?:$Attribute)?\s*;/ &&
   6667		    ($line =~ /\b__attribute__\s*\(\s*\(.*\bweak\b/ ||
   6668		     $line =~ /\b__weak\b/)) {
   6669			ERROR("WEAK_DECLARATION",
   6670			      "Using weak declarations can have unintended link defects\n" . $herecurr);
   6671		}
   6672
   6673# check for c99 types like uint8_t used outside of uapi/ and tools/
   6674		if ($realfile !~ m@\binclude/uapi/@ &&
   6675		    $realfile !~ m@\btools/@ &&
   6676		    $line =~ /\b($Declare)\s*$Ident\s*[=;,\[]/) {
   6677			my $type = $1;
   6678			if ($type =~ /\b($typeC99Typedefs)\b/) {
   6679				$type = $1;
   6680				my $kernel_type = 'u';
   6681				$kernel_type = 's' if ($type =~ /^_*[si]/);
   6682				$type =~ /(\d+)/;
   6683				$kernel_type .= $1;
   6684				if (CHK("PREFER_KERNEL_TYPES",
   6685					"Prefer kernel type '$kernel_type' over '$type'\n" . $herecurr) &&
   6686				    $fix) {
   6687					$fixed[$fixlinenr] =~ s/\b$type\b/$kernel_type/;
   6688				}
   6689			}
   6690		}
   6691
   6692# check for cast of C90 native int or longer types constants
   6693		if ($line =~ /(\(\s*$C90_int_types\s*\)\s*)($Constant)\b/) {
   6694			my $cast = $1;
   6695			my $const = $2;
   6696			my $suffix = "";
   6697			my $newconst = $const;
   6698			$newconst =~ s/${Int_type}$//;
   6699			$suffix .= 'U' if ($cast =~ /\bunsigned\b/);
   6700			if ($cast =~ /\blong\s+long\b/) {
   6701			    $suffix .= 'LL';
   6702			} elsif ($cast =~ /\blong\b/) {
   6703			    $suffix .= 'L';
   6704			}
   6705			if (WARN("TYPECAST_INT_CONSTANT",
   6706				 "Unnecessary typecast of c90 int constant - '$cast$const' could be '$const$suffix'\n" . $herecurr) &&
   6707			    $fix) {
   6708				$fixed[$fixlinenr] =~ s/\Q$cast\E$const\b/$newconst$suffix/;
   6709			}
   6710		}
   6711
   6712# check for sizeof(&)
   6713		if ($line =~ /\bsizeof\s*\(\s*\&/) {
   6714			WARN("SIZEOF_ADDRESS",
   6715			     "sizeof(& should be avoided\n" . $herecurr);
   6716		}
   6717
   6718# check for sizeof without parenthesis
   6719		if ($line =~ /\bsizeof\s+((?:\*\s*|)$Lval|$Type(?:\s+$Lval|))/) {
   6720			if (WARN("SIZEOF_PARENTHESIS",
   6721				 "sizeof $1 should be sizeof($1)\n" . $herecurr) &&
   6722			    $fix) {
   6723				$fixed[$fixlinenr] =~ s/\bsizeof\s+((?:\*\s*|)$Lval|$Type(?:\s+$Lval|))/"sizeof(" . trim($1) . ")"/ex;
   6724			}
   6725		}
   6726
   6727# check for struct spinlock declarations
   6728		if ($line =~ /^.\s*\bstruct\s+spinlock\s+\w+\s*;/) {
   6729			WARN("USE_SPINLOCK_T",
   6730			     "struct spinlock should be spinlock_t\n" . $herecurr);
   6731		}
   6732
   6733# check for seq_printf uses that could be seq_puts
   6734		if ($sline =~ /\bseq_printf\s*\(.*"\s*\)\s*;\s*$/) {
   6735			my $fmt = get_quoted_string($line, $rawline);
   6736			$fmt =~ s/%%//g;
   6737			if ($fmt !~ /%/) {
   6738				if (WARN("PREFER_SEQ_PUTS",
   6739					 "Prefer seq_puts to seq_printf\n" . $herecurr) &&
   6740				    $fix) {
   6741					$fixed[$fixlinenr] =~ s/\bseq_printf\b/seq_puts/;
   6742				}
   6743			}
   6744		}
   6745
   6746# check for vsprintf extension %p<foo> misuses
   6747		if ($perl_version_ok &&
   6748		    defined $stat &&
   6749		    $stat =~ /^\+(?![^\{]*\{\s*).*\b(\w+)\s*\(.*$String\s*,/s &&
   6750		    $1 !~ /^_*volatile_*$/) {
   6751			my $stat_real;
   6752
   6753			my $lc = $stat =~ tr@\n@@;
   6754			$lc = $lc + $linenr;
   6755		        for (my $count = $linenr; $count <= $lc; $count++) {
   6756				my $specifier;
   6757				my $extension;
   6758				my $qualifier;
   6759				my $bad_specifier = "";
   6760				my $fmt = get_quoted_string($lines[$count - 1], raw_line($count, 0));
   6761				$fmt =~ s/%%//g;
   6762
   6763				while ($fmt =~ /(\%[\*\d\.]*p(\w)(\w*))/g) {
   6764					$specifier = $1;
   6765					$extension = $2;
   6766					$qualifier = $3;
   6767					if ($extension !~ /[4SsBKRraEehMmIiUDdgVCbGNOxtf]/ ||
   6768					    ($extension eq "f" &&
   6769					     defined $qualifier && $qualifier !~ /^w/) ||
   6770					    ($extension eq "4" &&
   6771					     defined $qualifier && $qualifier !~ /^cc/)) {
   6772						$bad_specifier = $specifier;
   6773						last;
   6774					}
   6775					if ($extension eq "x" && !defined($stat_real)) {
   6776						if (!defined($stat_real)) {
   6777							$stat_real = get_stat_real($linenr, $lc);
   6778						}
   6779						WARN("VSPRINTF_SPECIFIER_PX",
   6780						     "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");
   6781					}
   6782				}
   6783				if ($bad_specifier ne "") {
   6784					my $stat_real = get_stat_real($linenr, $lc);
   6785					my $ext_type = "Invalid";
   6786					my $use = "";
   6787					if ($bad_specifier =~ /p[Ff]/) {
   6788						$use = " - use %pS instead";
   6789						$use =~ s/pS/ps/ if ($bad_specifier =~ /pf/);
   6790					}
   6791
   6792					WARN("VSPRINTF_POINTER_EXTENSION",
   6793					     "$ext_type vsprintf pointer extension '$bad_specifier'$use\n" . "$here\n$stat_real\n");
   6794				}
   6795			}
   6796		}
   6797
   6798# Check for misused memsets
   6799		if ($perl_version_ok &&
   6800		    defined $stat &&
   6801		    $stat =~ /^\+(?:.*?)\bmemset\s*\(\s*$FuncArg\s*,\s*$FuncArg\s*\,\s*$FuncArg\s*\)/) {
   6802
   6803			my $ms_addr = $2;
   6804			my $ms_val = $7;
   6805			my $ms_size = $12;
   6806
   6807			if ($ms_size =~ /^(0x|)0$/i) {
   6808				ERROR("MEMSET",
   6809				      "memset to 0's uses 0 as the 2nd argument, not the 3rd\n" . "$here\n$stat\n");
   6810			} elsif ($ms_size =~ /^(0x|)1$/i) {
   6811				WARN("MEMSET",
   6812				     "single byte memset is suspicious. Swapped 2nd/3rd argument?\n" . "$here\n$stat\n");
   6813			}
   6814		}
   6815
   6816# Check for memcpy(foo, bar, ETH_ALEN) that could be ether_addr_copy(foo, bar)
   6817#		if ($perl_version_ok &&
   6818#		    defined $stat &&
   6819#		    $stat =~ /^\+(?:.*?)\bmemcpy\s*\(\s*$FuncArg\s*,\s*$FuncArg\s*\,\s*ETH_ALEN\s*\)/) {
   6820#			if (WARN("PREFER_ETHER_ADDR_COPY",
   6821#				 "Prefer ether_addr_copy() over memcpy() if the Ethernet addresses are __aligned(2)\n" . "$here\n$stat\n") &&
   6822#			    $fix) {
   6823#				$fixed[$fixlinenr] =~ s/\bmemcpy\s*\(\s*$FuncArg\s*,\s*$FuncArg\s*\,\s*ETH_ALEN\s*\)/ether_addr_copy($2, $7)/;
   6824#			}
   6825#		}
   6826
   6827# Check for memcmp(foo, bar, ETH_ALEN) that could be ether_addr_equal*(foo, bar)
   6828#		if ($perl_version_ok &&
   6829#		    defined $stat &&
   6830#		    $stat =~ /^\+(?:.*?)\bmemcmp\s*\(\s*$FuncArg\s*,\s*$FuncArg\s*\,\s*ETH_ALEN\s*\)/) {
   6831#			WARN("PREFER_ETHER_ADDR_EQUAL",
   6832#			     "Prefer ether_addr_equal() or ether_addr_equal_unaligned() over memcmp()\n" . "$here\n$stat\n")
   6833#		}
   6834
   6835# check for memset(foo, 0x0, ETH_ALEN) that could be eth_zero_addr
   6836# check for memset(foo, 0xFF, ETH_ALEN) that could be eth_broadcast_addr
   6837#		if ($perl_version_ok &&
   6838#		    defined $stat &&
   6839#		    $stat =~ /^\+(?:.*?)\bmemset\s*\(\s*$FuncArg\s*,\s*$FuncArg\s*\,\s*ETH_ALEN\s*\)/) {
   6840#
   6841#			my $ms_val = $7;
   6842#
   6843#			if ($ms_val =~ /^(?:0x|)0+$/i) {
   6844#				if (WARN("PREFER_ETH_ZERO_ADDR",
   6845#					 "Prefer eth_zero_addr over memset()\n" . "$here\n$stat\n") &&
   6846#				    $fix) {
   6847#					$fixed[$fixlinenr] =~ s/\bmemset\s*\(\s*$FuncArg\s*,\s*$FuncArg\s*,\s*ETH_ALEN\s*\)/eth_zero_addr($2)/;
   6848#				}
   6849#			} elsif ($ms_val =~ /^(?:0xff|255)$/i) {
   6850#				if (WARN("PREFER_ETH_BROADCAST_ADDR",
   6851#					 "Prefer eth_broadcast_addr() over memset()\n" . "$here\n$stat\n") &&
   6852#				    $fix) {
   6853#					$fixed[$fixlinenr] =~ s/\bmemset\s*\(\s*$FuncArg\s*,\s*$FuncArg\s*,\s*ETH_ALEN\s*\)/eth_broadcast_addr($2)/;
   6854#				}
   6855#			}
   6856#		}
   6857
   6858# strlcpy uses that should likely be strscpy
   6859		if ($line =~ /\bstrlcpy\s*\(/) {
   6860			WARN("STRLCPY",
   6861			     "Prefer strscpy over strlcpy - see: https://lore.kernel.org/r/CAHk-=wgfRnXz0W3D37d01q3JFkr_i_uTL=V6A6G1oUZcprmknw\@mail.gmail.com/\n" . $herecurr);
   6862		}
   6863
   6864# typecasts on min/max could be min_t/max_t
   6865		if ($perl_version_ok &&
   6866		    defined $stat &&
   6867		    $stat =~ /^\+(?:.*?)\b(min|max)\s*\(\s*$FuncArg\s*,\s*$FuncArg\s*\)/) {
   6868			if (defined $2 || defined $7) {
   6869				my $call = $1;
   6870				my $cast1 = deparenthesize($2);
   6871				my $arg1 = $3;
   6872				my $cast2 = deparenthesize($7);
   6873				my $arg2 = $8;
   6874				my $cast;
   6875
   6876				if ($cast1 ne "" && $cast2 ne "" && $cast1 ne $cast2) {
   6877					$cast = "$cast1 or $cast2";
   6878				} elsif ($cast1 ne "") {
   6879					$cast = $cast1;
   6880				} else {
   6881					$cast = $cast2;
   6882				}
   6883				WARN("MINMAX",
   6884				     "$call() should probably be ${call}_t($cast, $arg1, $arg2)\n" . "$here\n$stat\n");
   6885			}
   6886		}
   6887
   6888# check usleep_range arguments
   6889		if ($perl_version_ok &&
   6890		    defined $stat &&
   6891		    $stat =~ /^\+(?:.*?)\busleep_range\s*\(\s*($FuncArg)\s*,\s*($FuncArg)\s*\)/) {
   6892			my $min = $1;
   6893			my $max = $7;
   6894			if ($min eq $max) {
   6895				WARN("USLEEP_RANGE",
   6896				     "usleep_range should not use min == max args; see Documentation/timers/timers-howto.rst\n" . "$here\n$stat\n");
   6897			} elsif ($min =~ /^\d+$/ && $max =~ /^\d+$/ &&
   6898				 $min > $max) {
   6899				WARN("USLEEP_RANGE",
   6900				     "usleep_range args reversed, use min then max; see Documentation/timers/timers-howto.rst\n" . "$here\n$stat\n");
   6901			}
   6902		}
   6903
   6904# check for naked sscanf
   6905		if ($perl_version_ok &&
   6906		    defined $stat &&
   6907		    $line =~ /\bsscanf\b/ &&
   6908		    ($stat !~ /$Ident\s*=\s*sscanf\s*$balanced_parens/ &&
   6909		     $stat !~ /\bsscanf\s*$balanced_parens\s*(?:$Compare)/ &&
   6910		     $stat !~ /(?:$Compare)\s*\bsscanf\s*$balanced_parens/)) {
   6911			my $lc = $stat =~ tr@\n@@;
   6912			$lc = $lc + $linenr;
   6913			my $stat_real = get_stat_real($linenr, $lc);
   6914			WARN("NAKED_SSCANF",
   6915			     "unchecked sscanf return value\n" . "$here\n$stat_real\n");
   6916		}
   6917
   6918# check for simple sscanf that should be kstrto<foo>
   6919		if ($perl_version_ok &&
   6920		    defined $stat &&
   6921		    $line =~ /\bsscanf\b/) {
   6922			my $lc = $stat =~ tr@\n@@;
   6923			$lc = $lc + $linenr;
   6924			my $stat_real = get_stat_real($linenr, $lc);
   6925			if ($stat_real =~ /\bsscanf\b\s*\(\s*$FuncArg\s*,\s*("[^"]+")/) {
   6926				my $format = $6;
   6927				my $count = $format =~ tr@%@%@;
   6928				if ($count == 1 &&
   6929				    $format =~ /^"\%(?i:ll[udxi]|[udxi]ll|ll|[hl]h?[udxi]|[udxi][hl]h?|[hl]h?|[udxi])"$/) {
   6930					WARN("SSCANF_TO_KSTRTO",
   6931					     "Prefer kstrto<type> to single variable sscanf\n" . "$here\n$stat_real\n");
   6932				}
   6933			}
   6934		}
   6935
   6936# check for new externs in .h files.
   6937		if ($realfile =~ /\.h$/ &&
   6938		    $line =~ /^\+\s*(extern\s+)$Type\s*$Ident\s*\(/s) {
   6939			if (CHK("AVOID_EXTERNS",
   6940				"extern prototypes should be avoided in .h files\n" . $herecurr) &&
   6941			    $fix) {
   6942				$fixed[$fixlinenr] =~ s/(.*)\bextern\b\s*(.*)/$1$2/;
   6943			}
   6944		}
   6945
   6946# check for new externs in .c files.
   6947		if ($realfile =~ /\.c$/ && defined $stat &&
   6948		    $stat =~ /^.\s*(?:extern\s+)?$Type\s+($Ident)(\s*)\(/s)
   6949		{
   6950			my $function_name = $1;
   6951			my $paren_space = $2;
   6952
   6953			my $s = $stat;
   6954			if (defined $cond) {
   6955				substr($s, 0, length($cond), '');
   6956			}
   6957			if ($s =~ /^\s*;/)
   6958			{
   6959				WARN("AVOID_EXTERNS",
   6960				     "externs should be avoided in .c files\n" .  $herecurr);
   6961			}
   6962
   6963			if ($paren_space =~ /\n/) {
   6964				WARN("FUNCTION_ARGUMENTS",
   6965				     "arguments for function declarations should follow identifier\n" . $herecurr);
   6966			}
   6967
   6968		} elsif ($realfile =~ /\.c$/ && defined $stat &&
   6969		    $stat =~ /^.\s*extern\s+/)
   6970		{
   6971			WARN("AVOID_EXTERNS",
   6972			     "externs should be avoided in .c files\n" .  $herecurr);
   6973		}
   6974
   6975# check for function declarations that have arguments without identifier names
   6976		if (defined $stat &&
   6977		    $stat =~ /^.\s*(?:extern\s+)?$Type\s*(?:$Ident|\(\s*\*\s*$Ident\s*\))\s*\(\s*([^{]+)\s*\)\s*;/s &&
   6978		    $1 ne "void") {
   6979			my $args = trim($1);
   6980			while ($args =~ m/\s*($Type\s*(?:$Ident|\(\s*\*\s*$Ident?\s*\)\s*$balanced_parens)?)/g) {
   6981				my $arg = trim($1);
   6982				if ($arg =~ /^$Type$/ && $arg !~ /enum\s+$Ident$/) {
   6983					WARN("FUNCTION_ARGUMENTS",
   6984					     "function definition argument '$arg' should also have an identifier name\n" . $herecurr);
   6985				}
   6986			}
   6987		}
   6988
   6989# check for function definitions
   6990		if ($perl_version_ok &&
   6991		    defined $stat &&
   6992		    $stat =~ /^.\s*(?:$Storage\s+)?$Type\s*($Ident)\s*$balanced_parens\s*{/s) {
   6993			$context_function = $1;
   6994
   6995# check for multiline function definition with misplaced open brace
   6996			my $ok = 0;
   6997			my $cnt = statement_rawlines($stat);
   6998			my $herectx = $here . "\n";
   6999			for (my $n = 0; $n < $cnt; $n++) {
   7000				my $rl = raw_line($linenr, $n);
   7001				$herectx .=  $rl . "\n";
   7002				$ok = 1 if ($rl =~ /^[ \+]\{/);
   7003				$ok = 1 if ($rl =~ /\{/ && $n == 0);
   7004				last if $rl =~ /^[ \+].*\{/;
   7005			}
   7006			if (!$ok) {
   7007				ERROR("OPEN_BRACE",
   7008				      "open brace '{' following function definitions go on the next line\n" . $herectx);
   7009			}
   7010		}
   7011
   7012# checks for new __setup's
   7013		if ($rawline =~ /\b__setup\("([^"]*)"/) {
   7014			my $name = $1;
   7015
   7016			if (!grep(/$name/, @setup_docs)) {
   7017				CHK("UNDOCUMENTED_SETUP",
   7018				    "__setup appears un-documented -- check Documentation/admin-guide/kernel-parameters.txt\n" . $herecurr);
   7019			}
   7020		}
   7021
   7022# check for pointless casting of alloc functions
   7023		if ($line =~ /\*\s*\)\s*$allocFunctions\b/) {
   7024			WARN("UNNECESSARY_CASTS",
   7025			     "unnecessary cast may hide bugs, see http://c-faq.com/malloc/mallocnocast.html\n" . $herecurr);
   7026		}
   7027
   7028# alloc style
   7029# p = alloc(sizeof(struct foo), ...) should be p = alloc(sizeof(*p), ...)
   7030		if ($perl_version_ok &&
   7031		    $line =~ /\b($Lval)\s*\=\s*(?:$balanced_parens)?\s*((?:kv|k|v)[mz]alloc(?:_node)?)\s*\(\s*(sizeof\s*\(\s*struct\s+$Lval\s*\))/) {
   7032			CHK("ALLOC_SIZEOF_STRUCT",
   7033			    "Prefer $3(sizeof(*$1)...) over $3($4...)\n" . $herecurr);
   7034		}
   7035
   7036# check for (kv|k)[mz]alloc with multiplies that could be kmalloc_array/kvmalloc_array/kvcalloc/kcalloc
   7037		if ($perl_version_ok &&
   7038		    defined $stat &&
   7039		    $stat =~ /^\+\s*($Lval)\s*\=\s*(?:$balanced_parens)?\s*((?:kv|k)[mz]alloc)\s*\(\s*($FuncArg)\s*\*\s*($FuncArg)\s*,/) {
   7040			my $oldfunc = $3;
   7041			my $a1 = $4;
   7042			my $a2 = $10;
   7043			my $newfunc = "kmalloc_array";
   7044			$newfunc = "kvmalloc_array" if ($oldfunc eq "kvmalloc");
   7045			$newfunc = "kvcalloc" if ($oldfunc eq "kvzalloc");
   7046			$newfunc = "kcalloc" if ($oldfunc eq "kzalloc");
   7047			my $r1 = $a1;
   7048			my $r2 = $a2;
   7049			if ($a1 =~ /^sizeof\s*\S/) {
   7050				$r1 = $a2;
   7051				$r2 = $a1;
   7052			}
   7053			if ($r1 !~ /^sizeof\b/ && $r2 =~ /^sizeof\s*\S/ &&
   7054			    !($r1 =~ /^$Constant$/ || $r1 =~ /^[A-Z_][A-Z0-9_]*$/)) {
   7055				my $cnt = statement_rawlines($stat);
   7056				my $herectx = get_stat_here($linenr, $cnt, $here);
   7057
   7058				if (WARN("ALLOC_WITH_MULTIPLY",
   7059					 "Prefer $newfunc over $oldfunc with multiply\n" . $herectx) &&
   7060				    $cnt == 1 &&
   7061				    $fix) {
   7062					$fixed[$fixlinenr] =~ s/\b($Lval)\s*\=\s*(?:$balanced_parens)?\s*((?:kv|k)[mz]alloc)\s*\(\s*($FuncArg)\s*\*\s*($FuncArg)/$1 . ' = ' . "$newfunc(" . trim($r1) . ', ' . trim($r2)/e;
   7063				}
   7064			}
   7065		}
   7066
   7067# check for krealloc arg reuse
   7068		if ($perl_version_ok &&
   7069		    $line =~ /\b($Lval)\s*\=\s*(?:$balanced_parens)?\s*krealloc\s*\(\s*($Lval)\s*,/ &&
   7070		    $1 eq $3) {
   7071			WARN("KREALLOC_ARG_REUSE",
   7072			     "Reusing the krealloc arg is almost always a bug\n" . $herecurr);
   7073		}
   7074
   7075# check for alloc argument mismatch
   7076		if ($line =~ /\b((?:devm_)?(?:kcalloc|kmalloc_array))\s*\(\s*sizeof\b/) {
   7077			WARN("ALLOC_ARRAY_ARGS",
   7078			     "$1 uses number as first arg, sizeof is generally wrong\n" . $herecurr);
   7079		}
   7080
   7081# check for multiple semicolons
   7082		if ($line =~ /;\s*;\s*$/) {
   7083			if (WARN("ONE_SEMICOLON",
   7084				 "Statements terminations use 1 semicolon\n" . $herecurr) &&
   7085			    $fix) {
   7086				$fixed[$fixlinenr] =~ s/(\s*;\s*){2,}$/;/g;
   7087			}
   7088		}
   7089
   7090# check for #defines like: 1 << <digit> that could be BIT(digit), it is not exported to uapi
   7091		if ($realfile !~ m@^include/uapi/@ &&
   7092		    $line =~ /#\s*define\s+\w+\s+\(?\s*1\s*([ulUL]*)\s*\<\<\s*(?:\d+|$Ident)\s*\)?/) {
   7093			my $ull = "";
   7094			$ull = "_ULL" if (defined($1) && $1 =~ /ll/i);
   7095			if (CHK("BIT_MACRO",
   7096				"Prefer using the BIT$ull macro\n" . $herecurr) &&
   7097			    $fix) {
   7098				$fixed[$fixlinenr] =~ s/\(?\s*1\s*[ulUL]*\s*<<\s*(\d+|$Ident)\s*\)?/BIT${ull}($1)/;
   7099			}
   7100		}
   7101
   7102# check for IS_ENABLED() without CONFIG_<FOO> ($rawline for comments too)
   7103		if ($rawline =~ /\bIS_ENABLED\s*\(\s*(\w+)\s*\)/ && $1 !~ /^${CONFIG_}/) {
   7104			WARN("IS_ENABLED_CONFIG",
   7105			     "IS_ENABLED($1) is normally used as IS_ENABLED(${CONFIG_}$1)\n" . $herecurr);
   7106		}
   7107
   7108# check for #if defined CONFIG_<FOO> || defined CONFIG_<FOO>_MODULE
   7109		if ($line =~ /^\+\s*#\s*if\s+defined(?:\s*\(?\s*|\s+)(${CONFIG_}[A-Z_]+)\s*\)?\s*\|\|\s*defined(?:\s*\(?\s*|\s+)\1_MODULE\s*\)?\s*$/) {
   7110			my $config = $1;
   7111			if (WARN("PREFER_IS_ENABLED",
   7112				 "Prefer IS_ENABLED(<FOO>) to ${CONFIG_}<FOO> || ${CONFIG_}<FOO>_MODULE\n" . $herecurr) &&
   7113			    $fix) {
   7114				$fixed[$fixlinenr] = "\+#if IS_ENABLED($config)";
   7115			}
   7116		}
   7117
   7118# check for /* fallthrough */ like comment, prefer fallthrough;
   7119		my @fallthroughs = (
   7120			'fallthrough',
   7121			'@fallthrough@',
   7122			'lint -fallthrough[ \t]*',
   7123			'intentional(?:ly)?[ \t]*fall(?:(?:s | |-)[Tt]|t)hr(?:ough|u|ew)',
   7124			'(?:else,?\s*)?FALL(?:S | |-)?THR(?:OUGH|U|EW)[ \t.!]*(?:-[^\n\r]*)?',
   7125			'Fall(?:(?:s | |-)[Tt]|t)hr(?:ough|u|ew)[ \t.!]*(?:-[^\n\r]*)?',
   7126			'fall(?:s | |-)?thr(?:ough|u|ew)[ \t.!]*(?:-[^\n\r]*)?',
   7127		    );
   7128		if ($raw_comment ne '') {
   7129			foreach my $ft (@fallthroughs) {
   7130				if ($raw_comment =~ /$ft/) {
   7131					my $msg_level = \&WARN;
   7132					$msg_level = \&CHK if ($file);
   7133					&{$msg_level}("PREFER_FALLTHROUGH",
   7134						      "Prefer 'fallthrough;' over fallthrough comment\n" . $herecurr);
   7135					last;
   7136				}
   7137			}
   7138		}
   7139
   7140# check for switch/default statements without a break;
   7141		if ($perl_version_ok &&
   7142		    defined $stat &&
   7143		    $stat =~ /^\+[$;\s]*(?:case[$;\s]+\w+[$;\s]*:[$;\s]*|)*[$;\s]*\bdefault[$;\s]*:[$;\s]*;/g) {
   7144			my $cnt = statement_rawlines($stat);
   7145			my $herectx = get_stat_here($linenr, $cnt, $here);
   7146
   7147			WARN("DEFAULT_NO_BREAK",
   7148			     "switch default: should use break\n" . $herectx);
   7149		}
   7150
   7151# check for gcc specific __FUNCTION__
   7152		if ($line =~ /\b__FUNCTION__\b/) {
   7153			if (WARN("USE_FUNC",
   7154				 "__func__ should be used instead of gcc specific __FUNCTION__\n"  . $herecurr) &&
   7155			    $fix) {
   7156				$fixed[$fixlinenr] =~ s/\b__FUNCTION__\b/__func__/g;
   7157			}
   7158		}
   7159
   7160# check for uses of __DATE__, __TIME__, __TIMESTAMP__
   7161		while ($line =~ /\b(__(?:DATE|TIME|TIMESTAMP)__)\b/g) {
   7162			ERROR("DATE_TIME",
   7163			      "Use of the '$1' macro makes the build non-deterministic\n" . $herecurr);
   7164		}
   7165
   7166# check for use of yield()
   7167		if ($line =~ /\byield\s*\(\s*\)/) {
   7168			WARN("YIELD",
   7169			     "Using yield() is generally wrong. See yield() kernel-doc (sched/core.c)\n"  . $herecurr);
   7170		}
   7171
   7172# check for comparisons against true and false
   7173		if ($line =~ /\+\s*(.*?)\b(true|false|$Lval)\s*(==|\!=)\s*(true|false|$Lval)\b(.*)$/i) {
   7174			my $lead = $1;
   7175			my $arg = $2;
   7176			my $test = $3;
   7177			my $otype = $4;
   7178			my $trail = $5;
   7179			my $op = "!";
   7180
   7181			($arg, $otype) = ($otype, $arg) if ($arg =~ /^(?:true|false)$/i);
   7182
   7183			my $type = lc($otype);
   7184			if ($type =~ /^(?:true|false)$/) {
   7185				if (("$test" eq "==" && "$type" eq "true") ||
   7186				    ("$test" eq "!=" && "$type" eq "false")) {
   7187					$op = "";
   7188				}
   7189
   7190				CHK("BOOL_COMPARISON",
   7191				    "Using comparison to $otype is error prone\n" . $herecurr);
   7192
   7193## maybe suggesting a correct construct would better
   7194##				    "Using comparison to $otype is error prone.  Perhaps use '${lead}${op}${arg}${trail}'\n" . $herecurr);
   7195
   7196			}
   7197		}
   7198
   7199# check for semaphores initialized locked
   7200		if ($line =~ /^.\s*sema_init.+,\W?0\W?\)/) {
   7201			WARN("CONSIDER_COMPLETION",
   7202			     "consider using a completion\n" . $herecurr);
   7203		}
   7204
   7205# recommend kstrto* over simple_strto* and strict_strto*
   7206		if ($line =~ /\b((simple|strict)_(strto(l|ll|ul|ull)))\s*\(/) {
   7207			WARN("CONSIDER_KSTRTO",
   7208			     "$1 is obsolete, use k$3 instead\n" . $herecurr);
   7209		}
   7210
   7211# check for __initcall(), use device_initcall() explicitly or more appropriate function please
   7212		if ($line =~ /^.\s*__initcall\s*\(/) {
   7213			WARN("USE_DEVICE_INITCALL",
   7214			     "please use device_initcall() or more appropriate function instead of __initcall() (see include/linux/init.h)\n" . $herecurr);
   7215		}
   7216
   7217# check for spin_is_locked(), suggest lockdep instead
   7218		if ($line =~ /\bspin_is_locked\(/) {
   7219			WARN("USE_LOCKDEP",
   7220			     "Where possible, use lockdep_assert_held instead of assertions based on spin_is_locked\n" . $herecurr);
   7221		}
   7222
   7223# check for deprecated apis
   7224		if ($line =~ /\b($deprecated_apis_search)\b\s*\(/) {
   7225			my $deprecated_api = $1;
   7226			my $new_api = $deprecated_apis{$deprecated_api};
   7227			WARN("DEPRECATED_API",
   7228			     "Deprecated use of '$deprecated_api', prefer '$new_api' instead\n" . $herecurr);
   7229		}
   7230
   7231# check for various structs that are normally const (ops, kgdb, device_tree)
   7232# and avoid what seem like struct definitions 'struct foo {'
   7233		if (defined($const_structs) &&
   7234		    $line !~ /\bconst\b/ &&
   7235		    $line =~ /\bstruct\s+($const_structs)\b(?!\s*\{)/) {
   7236			WARN("CONST_STRUCT",
   7237			     "struct $1 should normally be const\n" . $herecurr);
   7238		}
   7239
   7240# use of NR_CPUS is usually wrong
   7241# ignore definitions of NR_CPUS and usage to define arrays as likely right
   7242# ignore designated initializers using NR_CPUS
   7243		if ($line =~ /\bNR_CPUS\b/ &&
   7244		    $line !~ /^.\s*\s*#\s*if\b.*\bNR_CPUS\b/ &&
   7245		    $line !~ /^.\s*\s*#\s*define\b.*\bNR_CPUS\b/ &&
   7246		    $line !~ /^.\s*$Declare\s.*\[[^\]]*NR_CPUS[^\]]*\]/ &&
   7247		    $line !~ /\[[^\]]*\.\.\.[^\]]*NR_CPUS[^\]]*\]/ &&
   7248		    $line !~ /\[[^\]]*NR_CPUS[^\]]*\.\.\.[^\]]*\]/ &&
   7249		    $line !~ /^.\s*\.\w+\s*=\s*.*\bNR_CPUS\b/)
   7250		{
   7251			WARN("NR_CPUS",
   7252			     "usage of NR_CPUS is often wrong - consider using cpu_possible(), num_possible_cpus(), for_each_possible_cpu(), etc\n" . $herecurr);
   7253		}
   7254
   7255# Use of __ARCH_HAS_<FOO> or ARCH_HAVE_<BAR> is wrong.
   7256		if ($line =~ /\+\s*#\s*define\s+((?:__)?ARCH_(?:HAS|HAVE)\w*)\b/) {
   7257			ERROR("DEFINE_ARCH_HAS",
   7258			      "#define of '$1' is wrong - use Kconfig variables or standard guards instead\n" . $herecurr);
   7259		}
   7260
   7261# likely/unlikely comparisons similar to "(likely(foo) > 0)"
   7262		if ($perl_version_ok &&
   7263		    $line =~ /\b((?:un)?likely)\s*\(\s*$FuncArg\s*\)\s*$Compare/) {
   7264			WARN("LIKELY_MISUSE",
   7265			     "Using $1 should generally have parentheses around the comparison\n" . $herecurr);
   7266		}
   7267
   7268# return sysfs_emit(foo, fmt, ...) fmt without newline
   7269		if ($line =~ /\breturn\s+sysfs_emit\s*\(\s*$FuncArg\s*,\s*($String)/ &&
   7270		    substr($rawline, $-[6], $+[6] - $-[6]) !~ /\\n"$/) {
   7271			my $offset = $+[6] - 1;
   7272			if (WARN("SYSFS_EMIT",
   7273				 "return sysfs_emit(...) formats should include a terminating newline\n" . $herecurr) &&
   7274			    $fix) {
   7275				substr($fixed[$fixlinenr], $offset, 0) = '\\n';
   7276			}
   7277		}
   7278
   7279# nested likely/unlikely calls
   7280		if ($line =~ /\b(?:(?:un)?likely)\s*\(\s*!?\s*(IS_ERR(?:_OR_NULL|_VALUE)?|WARN)/) {
   7281			WARN("LIKELY_MISUSE",
   7282			     "nested (un)?likely() calls, $1 already uses unlikely() internally\n" . $herecurr);
   7283		}
   7284
   7285# whine mightly about in_atomic
   7286		if ($line =~ /\bin_atomic\s*\(/) {
   7287			if ($realfile =~ m@^drivers/@) {
   7288				ERROR("IN_ATOMIC",
   7289				      "do not use in_atomic in drivers\n" . $herecurr);
   7290			} elsif ($realfile !~ m@^kernel/@) {
   7291				WARN("IN_ATOMIC",
   7292				     "use of in_atomic() is incorrect outside core kernel code\n" . $herecurr);
   7293			}
   7294		}
   7295
   7296# check for lockdep_set_novalidate_class
   7297		if ($line =~ /^.\s*lockdep_set_novalidate_class\s*\(/ ||
   7298		    $line =~ /__lockdep_no_validate__\s*\)/ ) {
   7299			if ($realfile !~ m@^kernel/lockdep@ &&
   7300			    $realfile !~ m@^include/linux/lockdep@ &&
   7301			    $realfile !~ m@^drivers/base/core@) {
   7302				ERROR("LOCKDEP",
   7303				      "lockdep_no_validate class is reserved for device->mutex.\n" . $herecurr);
   7304			}
   7305		}
   7306
   7307		if ($line =~ /debugfs_create_\w+.*\b$mode_perms_world_writable\b/ ||
   7308		    $line =~ /DEVICE_ATTR.*\b$mode_perms_world_writable\b/) {
   7309			WARN("EXPORTED_WORLD_WRITABLE",
   7310			     "Exporting world writable files is usually an error. Consider more restrictive permissions.\n" . $herecurr);
   7311		}
   7312
   7313# check for DEVICE_ATTR uses that could be DEVICE_ATTR_<FOO>
   7314# and whether or not function naming is typical and if
   7315# DEVICE_ATTR permissions uses are unusual too
   7316		if ($perl_version_ok &&
   7317		    defined $stat &&
   7318		    $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*\)/) {
   7319			my $var = $1;
   7320			my $perms = $2;
   7321			my $show = $3;
   7322			my $store = $4;
   7323			my $octal_perms = perms_to_octal($perms);
   7324			if ($show =~ /^${var}_show$/ &&
   7325			    $store =~ /^${var}_store$/ &&
   7326			    $octal_perms eq "0644") {
   7327				if (WARN("DEVICE_ATTR_RW",
   7328					 "Use DEVICE_ATTR_RW\n" . $herecurr) &&
   7329				    $fix) {
   7330					$fixed[$fixlinenr] =~ s/\bDEVICE_ATTR\s*\(\s*$var\s*,\s*\Q$perms\E\s*,\s*$show\s*,\s*$store\s*\)/DEVICE_ATTR_RW(${var})/;
   7331				}
   7332			} elsif ($show =~ /^${var}_show$/ &&
   7333				 $store =~ /^NULL$/ &&
   7334				 $octal_perms eq "0444") {
   7335				if (WARN("DEVICE_ATTR_RO",
   7336					 "Use DEVICE_ATTR_RO\n" . $herecurr) &&
   7337				    $fix) {
   7338					$fixed[$fixlinenr] =~ s/\bDEVICE_ATTR\s*\(\s*$var\s*,\s*\Q$perms\E\s*,\s*$show\s*,\s*NULL\s*\)/DEVICE_ATTR_RO(${var})/;
   7339				}
   7340			} elsif ($show =~ /^NULL$/ &&
   7341				 $store =~ /^${var}_store$/ &&
   7342				 $octal_perms eq "0200") {
   7343				if (WARN("DEVICE_ATTR_WO",
   7344					 "Use DEVICE_ATTR_WO\n" . $herecurr) &&
   7345				    $fix) {
   7346					$fixed[$fixlinenr] =~ s/\bDEVICE_ATTR\s*\(\s*$var\s*,\s*\Q$perms\E\s*,\s*NULL\s*,\s*$store\s*\)/DEVICE_ATTR_WO(${var})/;
   7347				}
   7348			} elsif ($octal_perms eq "0644" ||
   7349				 $octal_perms eq "0444" ||
   7350				 $octal_perms eq "0200") {
   7351				my $newshow = "$show";
   7352				$newshow = "${var}_show" if ($show ne "NULL" && $show ne "${var}_show");
   7353				my $newstore = $store;
   7354				$newstore = "${var}_store" if ($store ne "NULL" && $store ne "${var}_store");
   7355				my $rename = "";
   7356				if ($show ne $newshow) {
   7357					$rename .= " '$show' to '$newshow'";
   7358				}
   7359				if ($store ne $newstore) {
   7360					$rename .= " '$store' to '$newstore'";
   7361				}
   7362				WARN("DEVICE_ATTR_FUNCTIONS",
   7363				     "Consider renaming function(s)$rename\n" . $herecurr);
   7364			} else {
   7365				WARN("DEVICE_ATTR_PERMS",
   7366				     "DEVICE_ATTR unusual permissions '$perms' used\n" . $herecurr);
   7367			}
   7368		}
   7369
   7370# Mode permission misuses where it seems decimal should be octal
   7371# This uses a shortcut match to avoid unnecessary uses of a slow foreach loop
   7372# o Ignore module_param*(...) uses with a decimal 0 permission as that has a
   7373#   specific definition of not visible in sysfs.
   7374# o Ignore proc_create*(...) uses with a decimal 0 permission as that means
   7375#   use the default permissions
   7376		if ($perl_version_ok &&
   7377		    defined $stat &&
   7378		    $line =~ /$mode_perms_search/) {
   7379			foreach my $entry (@mode_permission_funcs) {
   7380				my $func = $entry->[0];
   7381				my $arg_pos = $entry->[1];
   7382
   7383				my $lc = $stat =~ tr@\n@@;
   7384				$lc = $lc + $linenr;
   7385				my $stat_real = get_stat_real($linenr, $lc);
   7386
   7387				my $skip_args = "";
   7388				if ($arg_pos > 1) {
   7389					$arg_pos--;
   7390					$skip_args = "(?:\\s*$FuncArg\\s*,\\s*){$arg_pos,$arg_pos}";
   7391				}
   7392				my $test = "\\b$func\\s*\\(${skip_args}($FuncArg(?:\\|\\s*$FuncArg)*)\\s*[,\\)]";
   7393				if ($stat =~ /$test/) {
   7394					my $val = $1;
   7395					$val = $6 if ($skip_args ne "");
   7396					if (!($func =~ /^(?:module_param|proc_create)/ && $val eq "0") &&
   7397					    (($val =~ /^$Int$/ && $val !~ /^$Octal$/) ||
   7398					     ($val =~ /^$Octal$/ && length($val) ne 4))) {
   7399						ERROR("NON_OCTAL_PERMISSIONS",
   7400						      "Use 4 digit octal (0777) not decimal permissions\n" . "$here\n" . $stat_real);
   7401					}
   7402					if ($val =~ /^$Octal$/ && (oct($val) & 02)) {
   7403						ERROR("EXPORTED_WORLD_WRITABLE",
   7404						      "Exporting writable files is usually an error. Consider more restrictive permissions.\n" . "$here\n" . $stat_real);
   7405					}
   7406				}
   7407			}
   7408		}
   7409
   7410# check for uses of S_<PERMS> that could be octal for readability
   7411		while ($line =~ m{\b($multi_mode_perms_string_search)\b}g) {
   7412			my $oval = $1;
   7413			my $octal = perms_to_octal($oval);
   7414			if (WARN("SYMBOLIC_PERMS",
   7415				 "Symbolic permissions '$oval' are not preferred. Consider using octal permissions '$octal'.\n" . $herecurr) &&
   7416			    $fix) {
   7417				$fixed[$fixlinenr] =~ s/\Q$oval\E/$octal/;
   7418			}
   7419		}
   7420
   7421# validate content of MODULE_LICENSE against list from include/linux/module.h
   7422		if ($line =~ /\bMODULE_LICENSE\s*\(\s*($String)\s*\)/) {
   7423			my $extracted_string = get_quoted_string($line, $rawline);
   7424			my $valid_licenses = qr{
   7425						GPL|
   7426						GPL\ v2|
   7427						GPL\ and\ additional\ rights|
   7428						Dual\ BSD/GPL|
   7429						Dual\ MIT/GPL|
   7430						Dual\ MPL/GPL|
   7431						Proprietary
   7432					}x;
   7433			if ($extracted_string !~ /^"(?:$valid_licenses)"$/x) {
   7434				WARN("MODULE_LICENSE",
   7435				     "unknown module license " . $extracted_string . "\n" . $herecurr);
   7436			}
   7437			if (!$file && $extracted_string eq '"GPL v2"') {
   7438				if (WARN("MODULE_LICENSE",
   7439				     "Prefer \"GPL\" over \"GPL v2\" - see commit bf7fbeeae6db (\"module: Cure the MODULE_LICENSE \"GPL\" vs. \"GPL v2\" bogosity\")\n" . $herecurr) &&
   7440				    $fix) {
   7441					$fixed[$fixlinenr] =~ s/\bMODULE_LICENSE\s*\(\s*"GPL v2"\s*\)/MODULE_LICENSE("GPL")/;
   7442				}
   7443			}
   7444		}
   7445
   7446# check for sysctl duplicate constants
   7447		if ($line =~ /\.extra[12]\s*=\s*&(zero|one|int_max)\b/) {
   7448			WARN("DUPLICATED_SYSCTL_CONST",
   7449				"duplicated sysctl range checking value '$1', consider using the shared one in include/linux/sysctl.h\n" . $herecurr);
   7450		}
   7451	}
   7452
   7453	# If we have no input at all, then there is nothing to report on
   7454	# so just keep quiet.
   7455	if ($#rawlines == -1) {
   7456		exit(0);
   7457	}
   7458
   7459	# In mailback mode only produce a report in the negative, for
   7460	# things that appear to be patches.
   7461	if ($mailback && ($clean == 1 || !$is_patch)) {
   7462		exit(0);
   7463	}
   7464
   7465	# This is not a patch, and we are in 'no-patch' mode so
   7466	# just keep quiet.
   7467	if (!$chk_patch && !$is_patch) {
   7468		exit(0);
   7469	}
   7470
   7471	if (!$is_patch && $filename !~ /cover-letter\.patch$/) {
   7472		ERROR("NOT_UNIFIED_DIFF",
   7473		      "Does not appear to be a unified-diff format patch\n");
   7474	}
   7475	if ($is_patch && $has_commit_log && $chk_signoff) {
   7476		if ($signoff == 0) {
   7477			ERROR("MISSING_SIGN_OFF",
   7478			      "Missing Signed-off-by: line(s)\n");
   7479		} elsif ($authorsignoff != 1) {
   7480			# authorsignoff values:
   7481			# 0 -> missing sign off
   7482			# 1 -> sign off identical
   7483			# 2 -> names and addresses match, comments mismatch
   7484			# 3 -> addresses match, names different
   7485			# 4 -> names match, addresses different
   7486			# 5 -> names match, addresses excluding subaddress details (refer RFC 5233) match
   7487
   7488			my $sob_msg = "'From: $author' != 'Signed-off-by: $author_sob'";
   7489
   7490			if ($authorsignoff == 0) {
   7491				ERROR("NO_AUTHOR_SIGN_OFF",
   7492				      "Missing Signed-off-by: line by nominal patch author '$author'\n");
   7493			} elsif ($authorsignoff == 2) {
   7494				CHK("FROM_SIGN_OFF_MISMATCH",
   7495				    "From:/Signed-off-by: email comments mismatch: $sob_msg\n");
   7496			} elsif ($authorsignoff == 3) {
   7497				WARN("FROM_SIGN_OFF_MISMATCH",
   7498				     "From:/Signed-off-by: email name mismatch: $sob_msg\n");
   7499			} elsif ($authorsignoff == 4) {
   7500				WARN("FROM_SIGN_OFF_MISMATCH",
   7501				     "From:/Signed-off-by: email address mismatch: $sob_msg\n");
   7502			} elsif ($authorsignoff == 5) {
   7503				WARN("FROM_SIGN_OFF_MISMATCH",
   7504				     "From:/Signed-off-by: email subaddress mismatch: $sob_msg\n");
   7505			}
   7506		}
   7507	}
   7508
   7509	print report_dump();
   7510	if ($summary && !($clean == 1 && $quiet == 1)) {
   7511		print "$filename " if ($summary_file);
   7512		print "total: $cnt_error errors, $cnt_warn warnings, " .
   7513			(($check)? "$cnt_chk checks, " : "") .
   7514			"$cnt_lines lines checked\n";
   7515	}
   7516
   7517	if ($quiet == 0) {
   7518		# If there were any defects found and not already fixing them
   7519		if (!$clean and !$fix) {
   7520			print << "EOM"
   7521
   7522NOTE: For some of the reported defects, checkpatch may be able to
   7523      mechanically convert to the typical style using --fix or --fix-inplace.
   7524EOM
   7525		}
   7526		# If there were whitespace errors which cleanpatch can fix
   7527		# then suggest that.
   7528		if ($rpt_cleaners) {
   7529			$rpt_cleaners = 0;
   7530			print << "EOM"
   7531
   7532NOTE: Whitespace errors detected.
   7533      You may wish to use scripts/cleanpatch or scripts/cleanfile
   7534EOM
   7535		}
   7536	}
   7537
   7538	if ($clean == 0 && $fix &&
   7539	    ("@rawlines" ne "@fixed" ||
   7540	     $#fixed_inserted >= 0 || $#fixed_deleted >= 0)) {
   7541		my $newfile = $filename;
   7542		$newfile .= ".EXPERIMENTAL-checkpatch-fixes" if (!$fix_inplace);
   7543		my $linecount = 0;
   7544		my $f;
   7545
   7546		@fixed = fix_inserted_deleted_lines(\@fixed, \@fixed_inserted, \@fixed_deleted);
   7547
   7548		open($f, '>', $newfile)
   7549		    or die "$P: Can't open $newfile for write\n";
   7550		foreach my $fixed_line (@fixed) {
   7551			$linecount++;
   7552			if ($file) {
   7553				if ($linecount > 3) {
   7554					$fixed_line =~ s/^\+//;
   7555					print $f $fixed_line . "\n";
   7556				}
   7557			} else {
   7558				print $f $fixed_line . "\n";
   7559			}
   7560		}
   7561		close($f);
   7562
   7563		if (!$quiet) {
   7564			print << "EOM";
   7565
   7566Wrote EXPERIMENTAL --fix correction(s) to '$newfile'
   7567
   7568Do _NOT_ trust the results written to this file.
   7569Do _NOT_ submit these changes without inspecting them for correctness.
   7570
   7571This EXPERIMENTAL file is simply a convenience to help rewrite patches.
   7572No warranties, expressed or implied...
   7573EOM
   7574		}
   7575	}
   7576
   7577	if ($quiet == 0) {
   7578		print "\n";
   7579		if ($clean == 1) {
   7580			print "$vname has no obvious style problems and is ready for submission.\n";
   7581		} else {
   7582			print "$vname has style problems, please review.\n";
   7583		}
   7584	}
   7585	return $clean;
   7586}