blob: 3642b0d5ad6a2103dcf0c27a7dd83a0857d1899a [file] [log] [blame]
Andy Whitcroft0a920b5b2007-06-01 00:46:48 -07001#!/usr/bin/perl -w
Dave Jonesdbf004d2010-01-12 16:59:52 -05002# (c) 2001, Dave Jones. (the file handling bit)
Andy Whitcroft00df3442007-06-08 13:47:06 -07003# (c) 2005, Joel Schopp <jschopp@austin.ibm.com> (the ugly bit)
Andy Whitcroft2a5a2c22009-01-06 14:41:23 -08004# (c) 2007,2008, Andy Whitcroft <apw@uk.ibm.com> (new conditions, test suite)
Andy Whitcroft015830be2010-10-26 14:23:17 -07005# (c) 2008-2010 Andy Whitcroft <apw@canonical.com>
Andy Whitcroft0a920b5b2007-06-01 00:46:48 -07006# Licensed under the terms of the GNU GPL License version 2
7
8use strict;
Joe Perchesc707a812013-07-08 16:00:43 -07009use POSIX;
Joe Perches36061e32014-12-10 15:51:43 -080010use File::Basename;
11use Cwd 'abs_path';
Andy Whitcroft0a920b5b2007-06-01 00:46:48 -070012
13my $P = $0;
Joe Perches36061e32014-12-10 15:51:43 -080014my $D = dirname(abs_path($P));
Andy Whitcroft0a920b5b2007-06-01 00:46:48 -070015
Joe Perches000d1cc12011-07-25 17:13:25 -070016my $V = '0.32';
Andy Whitcroft0a920b5b2007-06-01 00:46:48 -070017
18use Getopt::Long qw(:config no_auto_abbrev);
19
20my $quiet = 0;
21my $tree = 1;
22my $chk_signoff = 1;
23my $chk_patch = 1;
Andy Whitcroft773647a2008-03-28 14:15:58 -070024my $tst_only;
Andy Whitcroft6c72ffa2007-10-18 03:05:08 -070025my $emacs = 0;
Andy Whitcroft8905a672007-11-28 16:21:06 -080026my $terse = 0;
Andy Whitcroft6c72ffa2007-10-18 03:05:08 -070027my $file = 0;
28my $check = 0;
Joe Perches2ac73b42014-06-04 16:12:05 -070029my $check_orig = 0;
Andy Whitcroft8905a672007-11-28 16:21:06 -080030my $summary = 1;
31my $mailback = 0;
Andy Whitcroft13214ad2008-02-08 04:22:03 -080032my $summary_file = 0;
Joe Perches000d1cc12011-07-25 17:13:25 -070033my $show_types = 0;
Joe Perches3705ce52013-07-03 15:05:31 -070034my $fix = 0;
Joe Perches9624b8d2014-01-23 15:54:44 -080035my $fix_inplace = 0;
Andy Whitcroft6c72ffa2007-10-18 03:05:08 -070036my $root;
Andy Whitcroftc2fdda02008-02-08 04:20:54 -080037my %debug;
Joe Perches34456862013-07-03 15:05:34 -070038my %camelcase = ();
Joe Perches91bfe482013-09-11 14:23:59 -070039my %use_type = ();
40my @use = ();
41my %ignore_type = ();
Joe Perches000d1cc12011-07-25 17:13:25 -070042my @ignore = ();
Hannes Eder77f5b102009-09-21 17:04:37 -070043my $help = 0;
Joe Perches000d1cc12011-07-25 17:13:25 -070044my $configuration_file = ".checkpatch.conf";
Joe Perches6cd7f382012-12-17 16:01:54 -080045my $max_line_length = 80;
Dave Hansend62a2012013-09-11 14:23:56 -070046my $ignore_perl_version = 0;
47my $minimum_perl_version = 5.10.0;
Vadim Bendebury56193272014-10-13 15:51:48 -070048my $min_conf_desc_length = 4;
Kees Cook66b47b42014-10-13 15:51:57 -070049my $spelling_file = "$D/spelling.txt";
Hannes Eder77f5b102009-09-21 17:04:37 -070050
51sub help {
52 my ($exitcode) = @_;
53
54 print << "EOM";
55Usage: $P [OPTION]... [FILE]...
56Version: $V
57
58Options:
59 -q, --quiet quiet
60 --no-tree run without a kernel tree
61 --no-signoff do not check for 'Signed-off-by' line
62 --patch treat FILE as patchfile (default)
63 --emacs emacs compile window format
64 --terse one line per report
65 -f, --file treat FILE as regular source file
66 --subjective, --strict enable more subjective tests
Joe Perches91bfe482013-09-11 14:23:59 -070067 --types TYPE(,TYPE2...) show only these comma separated message types
Joe Perches000d1cc12011-07-25 17:13:25 -070068 --ignore TYPE(,TYPE2...) ignore various comma separated message types
Joe Perches6cd7f382012-12-17 16:01:54 -080069 --max-line-length=n set the maximum line length, if exceeded, warn
Vadim Bendebury56193272014-10-13 15:51:48 -070070 --min-conf-desc-length=n set the min description length, if shorter, warn
Joe Perches000d1cc12011-07-25 17:13:25 -070071 --show-types show the message "types" in the output
Hannes Eder77f5b102009-09-21 17:04:37 -070072 --root=PATH PATH to the kernel tree root
73 --no-summary suppress the per-file summary
74 --mailback only produce a report in case of warnings/errors
75 --summary-file include the filename in summary
76 --debug KEY=[0|1] turn on/off debugging of KEY, where KEY is one of
77 'values', 'possible', 'type', and 'attr' (default
78 is all off)
79 --test-only=WORD report only warnings/errors containing WORD
80 literally
Joe Perches3705ce52013-07-03 15:05:31 -070081 --fix EXPERIMENTAL - may create horrible results
82 If correctable single-line errors exist, create
83 "<inputfile>.EXPERIMENTAL-checkpatch-fixes"
84 with potential errors corrected to the preferred
85 checkpatch style
Joe Perches9624b8d2014-01-23 15:54:44 -080086 --fix-inplace EXPERIMENTAL - may create horrible results
87 Is the same as --fix, but overwrites the input
88 file. It's your fault if there's no backup or git
Dave Hansend62a2012013-09-11 14:23:56 -070089 --ignore-perl-version override checking of perl version. expect
90 runtime errors.
Hannes Eder77f5b102009-09-21 17:04:37 -070091 -h, --help, --version display this help and exit
92
93When FILE is - read standard input.
94EOM
95
96 exit($exitcode);
97}
98
Joe Perches000d1cc12011-07-25 17:13:25 -070099my $conf = which_conf($configuration_file);
100if (-f $conf) {
101 my @conf_args;
102 open(my $conffile, '<', "$conf")
103 or warn "$P: Can't find a readable $configuration_file file $!\n";
104
105 while (<$conffile>) {
106 my $line = $_;
107
108 $line =~ s/\s*\n?$//g;
109 $line =~ s/^\s*//g;
110 $line =~ s/\s+/ /g;
111
112 next if ($line =~ m/^\s*#/);
113 next if ($line =~ m/^\s*$/);
114
115 my @words = split(" ", $line);
116 foreach my $word (@words) {
117 last if ($word =~ m/^#/);
118 push (@conf_args, $word);
119 }
120 }
121 close($conffile);
122 unshift(@ARGV, @conf_args) if @conf_args;
123}
124
Andy Whitcroft0a920b5b2007-06-01 00:46:48 -0700125GetOptions(
Andy Whitcroft6c72ffa2007-10-18 03:05:08 -0700126 'q|quiet+' => \$quiet,
Andy Whitcroft0a920b5b2007-06-01 00:46:48 -0700127 'tree!' => \$tree,
128 'signoff!' => \$chk_signoff,
129 'patch!' => \$chk_patch,
Andy Whitcroft6c72ffa2007-10-18 03:05:08 -0700130 'emacs!' => \$emacs,
Andy Whitcroft8905a672007-11-28 16:21:06 -0800131 'terse!' => \$terse,
Hannes Eder77f5b102009-09-21 17:04:37 -0700132 'f|file!' => \$file,
Andy Whitcroft6c72ffa2007-10-18 03:05:08 -0700133 'subjective!' => \$check,
134 'strict!' => \$check,
Joe Perches000d1cc12011-07-25 17:13:25 -0700135 'ignore=s' => \@ignore,
Joe Perches91bfe482013-09-11 14:23:59 -0700136 'types=s' => \@use,
Joe Perches000d1cc12011-07-25 17:13:25 -0700137 'show-types!' => \$show_types,
Joe Perches6cd7f382012-12-17 16:01:54 -0800138 'max-line-length=i' => \$max_line_length,
Vadim Bendebury56193272014-10-13 15:51:48 -0700139 'min-conf-desc-length=i' => \$min_conf_desc_length,
Andy Whitcroft6c72ffa2007-10-18 03:05:08 -0700140 'root=s' => \$root,
Andy Whitcroft8905a672007-11-28 16:21:06 -0800141 'summary!' => \$summary,
142 'mailback!' => \$mailback,
Andy Whitcroft13214ad2008-02-08 04:22:03 -0800143 'summary-file!' => \$summary_file,
Joe Perches3705ce52013-07-03 15:05:31 -0700144 'fix!' => \$fix,
Joe Perches9624b8d2014-01-23 15:54:44 -0800145 'fix-inplace!' => \$fix_inplace,
Dave Hansend62a2012013-09-11 14:23:56 -0700146 'ignore-perl-version!' => \$ignore_perl_version,
Andy Whitcroftc2fdda02008-02-08 04:20:54 -0800147 'debug=s' => \%debug,
Andy Whitcroft773647a2008-03-28 14:15:58 -0700148 'test-only=s' => \$tst_only,
Hannes Eder77f5b102009-09-21 17:04:37 -0700149 'h|help' => \$help,
150 'version' => \$help
151) or help(1);
152
153help(0) if ($help);
Andy Whitcroft0a920b5b2007-06-01 00:46:48 -0700154
Joe Perches9624b8d2014-01-23 15:54:44 -0800155$fix = 1 if ($fix_inplace);
Joe Perches2ac73b42014-06-04 16:12:05 -0700156$check_orig = $check;
Joe Perches9624b8d2014-01-23 15:54:44 -0800157
Andy Whitcroft0a920b5b2007-06-01 00:46:48 -0700158my $exit = 0;
159
Dave Hansend62a2012013-09-11 14:23:56 -0700160if ($^V && $^V lt $minimum_perl_version) {
161 printf "$P: requires at least perl version %vd\n", $minimum_perl_version;
162 if (!$ignore_perl_version) {
163 exit(1);
164 }
165}
166
Andy Whitcroft0a920b5b2007-06-01 00:46:48 -0700167if ($#ARGV < 0) {
Hannes Eder77f5b102009-09-21 17:04:37 -0700168 print "$P: no input files\n";
Andy Whitcroft0a920b5b2007-06-01 00:46:48 -0700169 exit(1);
170}
171
Joe Perches91bfe482013-09-11 14:23:59 -0700172sub hash_save_array_words {
173 my ($hashRef, $arrayRef) = @_;
Joe Perches000d1cc12011-07-25 17:13:25 -0700174
Joe Perches91bfe482013-09-11 14:23:59 -0700175 my @array = split(/,/, join(',', @$arrayRef));
176 foreach my $word (@array) {
177 $word =~ s/\s*\n?$//g;
178 $word =~ s/^\s*//g;
179 $word =~ s/\s+/ /g;
180 $word =~ tr/[a-z]/[A-Z]/;
Joe Perches000d1cc12011-07-25 17:13:25 -0700181
Joe Perches91bfe482013-09-11 14:23:59 -0700182 next if ($word =~ m/^\s*#/);
183 next if ($word =~ m/^\s*$/);
184
185 $hashRef->{$word}++;
186 }
Joe Perches000d1cc12011-07-25 17:13:25 -0700187}
188
Joe Perches91bfe482013-09-11 14:23:59 -0700189sub hash_show_words {
190 my ($hashRef, $prefix) = @_;
191
Joe Perches58cb3cf2013-09-11 14:24:04 -0700192 if ($quiet == 0 && keys %$hashRef) {
Joe Perches91bfe482013-09-11 14:23:59 -0700193 print "NOTE: $prefix message types:";
Joe Perches58cb3cf2013-09-11 14:24:04 -0700194 foreach my $word (sort keys %$hashRef) {
Joe Perches91bfe482013-09-11 14:23:59 -0700195 print " $word";
196 }
197 print "\n\n";
198 }
199}
200
201hash_save_array_words(\%ignore_type, \@ignore);
202hash_save_array_words(\%use_type, \@use);
203
Andy Whitcroftc2fdda02008-02-08 04:20:54 -0800204my $dbg_values = 0;
205my $dbg_possible = 0;
Andy Whitcroft7429c692008-07-23 21:29:06 -0700206my $dbg_type = 0;
Andy Whitcrofta1ef2772008-10-15 22:02:17 -0700207my $dbg_attr = 0;
Andy Whitcroftc2fdda02008-02-08 04:20:54 -0800208for my $key (keys %debug) {
Andy Whitcroft21caa132009-01-06 14:41:30 -0800209 ## no critic
210 eval "\${dbg_$key} = '$debug{$key}';";
211 die "$@" if ($@);
Andy Whitcroftc2fdda02008-02-08 04:20:54 -0800212}
213
Andy Whitcroftd2c0a232010-10-26 14:23:12 -0700214my $rpt_cleaners = 0;
215
Andy Whitcroft8905a672007-11-28 16:21:06 -0800216if ($terse) {
217 $emacs = 1;
218 $quiet++;
219}
220
Andy Whitcroft6c72ffa2007-10-18 03:05:08 -0700221if ($tree) {
222 if (defined $root) {
223 if (!top_of_kernel_tree($root)) {
224 die "$P: $root: --root does not point at a valid tree\n";
225 }
226 } else {
227 if (top_of_kernel_tree('.')) {
228 $root = '.';
229 } elsif ($0 =~ m@(.*)/scripts/[^/]*$@ &&
230 top_of_kernel_tree($1)) {
231 $root = $1;
232 }
233 }
234
235 if (!defined $root) {
236 print "Must be run from the top-level dir. of a kernel tree\n";
237 exit(2);
238 }
Andy Whitcroft0a920b5b2007-06-01 00:46:48 -0700239}
240
Andy Whitcroft6c72ffa2007-10-18 03:05:08 -0700241my $emitted_corrupt = 0;
242
Andy Whitcroft2ceb5322009-10-26 16:50:14 -0700243our $Ident = qr{
244 [A-Za-z_][A-Za-z\d_]*
245 (?:\s*\#\#\s*[A-Za-z_][A-Za-z\d_]*)*
246 }x;
Andy Whitcroft6c72ffa2007-10-18 03:05:08 -0700247our $Storage = qr{extern|static|asmlinkage};
248our $Sparse = qr{
249 __user|
250 __kernel|
251 __force|
252 __iomem|
253 __must_check|
254 __init_refok|
Andy Whitcroft417495e2009-02-27 14:03:08 -0800255 __kprobes|
Sven Eckelmann165e72a2011-07-25 17:13:23 -0700256 __ref|
257 __rcu
Andy Whitcroft6c72ffa2007-10-18 03:05:08 -0700258 }x;
Joe Perchese970b8842013-11-12 15:10:10 -0800259our $InitAttributePrefix = qr{__(?:mem|cpu|dev|net_|)};
260our $InitAttributeData = qr{$InitAttributePrefix(?:initdata\b)};
261our $InitAttributeConst = qr{$InitAttributePrefix(?:initconst\b)};
262our $InitAttributeInit = qr{$InitAttributePrefix(?:init\b)};
263our $InitAttribute = qr{$InitAttributeData|$InitAttributeConst|$InitAttributeInit};
Joe Perches8716de32013-09-11 14:24:05 -0700264
Wolfram Sang52131292010-03-05 13:43:51 -0800265# Notes to $Attribute:
266# We need \b after 'init' otherwise 'initconst' will cause a false positive in a check
Andy Whitcroft6c72ffa2007-10-18 03:05:08 -0700267our $Attribute = qr{
268 const|
Joe Perches03f1df72010-10-26 14:23:16 -0700269 __percpu|
270 __nocast|
271 __safe|
272 __bitwise__|
273 __packed__|
274 __packed2__|
275 __naked|
276 __maybe_unused|
277 __always_unused|
278 __noreturn|
279 __used|
280 __cold|
Joe Perchese23ef1f2015-02-13 14:38:24 -0800281 __pure|
Joe Perches03f1df72010-10-26 14:23:16 -0700282 __noclone|
283 __deprecated|
Andy Whitcroft6c72ffa2007-10-18 03:05:08 -0700284 __read_mostly|
285 __kprobes|
Joe Perches8716de32013-09-11 14:24:05 -0700286 $InitAttribute|
Andy Whitcroft24e1d812008-10-15 22:02:18 -0700287 ____cacheline_aligned|
288 ____cacheline_aligned_in_smp|
Andy Whitcroft5fe3af12009-01-06 14:41:18 -0800289 ____cacheline_internodealigned_in_smp|
290 __weak
Andy Whitcroft6c72ffa2007-10-18 03:05:08 -0700291 }x;
Andy Whitcroftc45dcab2008-06-05 22:46:01 -0700292our $Modifier;
Joe Perches91cb5192014-04-03 14:49:32 -0700293our $Inline = qr{inline|__always_inline|noinline|__inline|__inline__};
Andy Whitcroft6c72ffa2007-10-18 03:05:08 -0700294our $Member = qr{->$Ident|\.$Ident|\[[^]]*\]};
295our $Lval = qr{$Ident(?:$Member)*};
296
Joe Perches95e2c602013-07-03 15:05:20 -0700297our $Int_type = qr{(?i)llu|ull|ll|lu|ul|l|u};
298our $Binary = qr{(?i)0b[01]+$Int_type?};
299our $Hex = qr{(?i)0x[0-9a-f]+$Int_type?};
300our $Int = qr{[0-9]+$Int_type?};
Joe Perches24358802014-04-03 14:49:13 -0700301our $Octal = qr{0[0-7]+$Int_type?};
Joe Perchesc0a5c892015-02-13 14:38:21 -0800302our $String = qr{"[X\t]*"};
Joe Perches326b1ff2013-02-04 14:28:51 -0800303our $Float_hex = qr{(?i)0x[0-9a-f]+p-?[0-9]+[fl]?};
304our $Float_dec = qr{(?i)(?:[0-9]+\.[0-9]*|[0-9]*\.[0-9]+)(?:e-?[0-9]+)?[fl]?};
305our $Float_int = qr{(?i)[0-9]+e-?[0-9]+[fl]?};
Joe Perches74349bc2012-12-17 16:02:05 -0800306our $Float = qr{$Float_hex|$Float_dec|$Float_int};
Joe Perches24358802014-04-03 14:49:13 -0700307our $Constant = qr{$Float|$Binary|$Octal|$Hex|$Int};
Joe Perches326b1ff2013-02-04 14:28:51 -0800308our $Assignment = qr{\*\=|/=|%=|\+=|-=|<<=|>>=|&=|\^=|\|=|=};
Joe Perches447432f2014-04-03 14:49:17 -0700309our $Compare = qr{<=|>=|==|!=|<|(?<!-)>};
Joe Perches23f780c2013-07-03 15:05:31 -0700310our $Arithmetic = qr{\+|-|\*|\/|%};
Andy Whitcroft6c72ffa2007-10-18 03:05:08 -0700311our $Operators = qr{
312 <=|>=|==|!=|
313 =>|->|<<|>>|<|>|!|~|
Joe Perches23f780c2013-07-03 15:05:31 -0700314 &&|\|\||,|\^|\+\+|--|&|\||$Arithmetic
Andy Whitcroft6c72ffa2007-10-18 03:05:08 -0700315 }x;
316
Joe Perches91cb5192014-04-03 14:49:32 -0700317our $c90_Keywords = qr{do|for|while|if|else|return|goto|continue|switch|default|case|break}x;
318
Andy Whitcroft8905a672007-11-28 16:21:06 -0800319our $NonptrType;
Joe Perches18130872014-08-06 16:11:22 -0700320our $NonptrTypeMisordered;
Joe Perches8716de32013-09-11 14:24:05 -0700321our $NonptrTypeWithAttr;
Andy Whitcroft8905a672007-11-28 16:21:06 -0800322our $Type;
Joe Perches18130872014-08-06 16:11:22 -0700323our $TypeMisordered;
Andy Whitcroft8905a672007-11-28 16:21:06 -0800324our $Declare;
Joe Perches18130872014-08-06 16:11:22 -0700325our $DeclareMisordered;
Andy Whitcroft8905a672007-11-28 16:21:06 -0800326
Joe Perches15662b32011-10-31 17:13:12 -0700327our $NON_ASCII_UTF8 = qr{
328 [\xC2-\xDF][\x80-\xBF] # non-overlong 2-byte
Andy Whitcroft171ae1a2008-04-29 00:59:32 -0700329 | \xE0[\xA0-\xBF][\x80-\xBF] # excluding overlongs
330 | [\xE1-\xEC\xEE\xEF][\x80-\xBF]{2} # straight 3-byte
331 | \xED[\x80-\x9F][\x80-\xBF] # excluding surrogates
332 | \xF0[\x90-\xBF][\x80-\xBF]{2} # planes 1-3
333 | [\xF1-\xF3][\x80-\xBF]{3} # planes 4-15
334 | \xF4[\x80-\x8F][\x80-\xBF]{2} # plane 16
335}x;
336
Joe Perches15662b32011-10-31 17:13:12 -0700337our $UTF8 = qr{
338 [\x09\x0A\x0D\x20-\x7E] # ASCII
339 | $NON_ASCII_UTF8
340}x;
341
Joe Perches021158b2015-02-13 14:38:43 -0800342our $typeOtherOSTypedefs = qr{(?x:
343 u_(?:char|short|int|long) | # bsd
344 u(?:nchar|short|int|long) # sysv
345)};
346
Andy Whitcroft8ed22ca2008-10-15 22:02:32 -0700347our $typeTypedefs = qr{(?x:
Andy Whitcroftfb9e9092009-09-21 17:04:38 -0700348 (?:__)?(?:u|s|be|le)(?:8|16|32|64)|
Andy Whitcroft8ed22ca2008-10-15 22:02:32 -0700349 atomic_t
350)};
351
Joe Perches691e6692010-03-05 13:43:51 -0800352our $logFunctions = qr{(?x:
Joe Perches6e60c022011-07-25 17:13:27 -0700353 printk(?:_ratelimited|_once|)|
Jacob Keller7d0b6592013-07-03 15:05:35 -0700354 (?:[a-z0-9]+_){1,2}(?:printk|emerg|alert|crit|err|warning|warn|notice|info|debug|dbg|vdbg|devel|cont|WARN)(?:_ratelimited|_once|)|
Joe Perches6e60c022011-07-25 17:13:27 -0700355 WARN(?:_RATELIMIT|_ONCE|)|
Joe Perchesb0531722011-05-24 17:13:40 -0700356 panic|
Joe Perches06668722013-11-12 15:10:07 -0800357 MODULE_[A-Z_]+|
358 seq_vprintf|seq_printf|seq_puts
Joe Perches691e6692010-03-05 13:43:51 -0800359)};
360
Joe Perches20112472011-07-25 17:13:23 -0700361our $signature_tags = qr{(?xi:
362 Signed-off-by:|
363 Acked-by:|
364 Tested-by:|
365 Reviewed-by:|
366 Reported-by:|
Mugunthan V N8543ae12013-04-29 16:18:17 -0700367 Suggested-by:|
Joe Perches20112472011-07-25 17:13:23 -0700368 To:|
369 Cc:
370)};
371
Joe Perches18130872014-08-06 16:11:22 -0700372our @typeListMisordered = (
373 qr{char\s+(?:un)?signed},
374 qr{int\s+(?:(?:un)?signed\s+)?short\s},
375 qr{int\s+short(?:\s+(?:un)?signed)},
376 qr{short\s+int(?:\s+(?:un)?signed)},
377 qr{(?:un)?signed\s+int\s+short},
378 qr{short\s+(?:un)?signed},
379 qr{long\s+int\s+(?:un)?signed},
380 qr{int\s+long\s+(?:un)?signed},
381 qr{long\s+(?:un)?signed\s+int},
382 qr{int\s+(?:un)?signed\s+long},
383 qr{int\s+(?:un)?signed},
384 qr{int\s+long\s+long\s+(?:un)?signed},
385 qr{long\s+long\s+int\s+(?:un)?signed},
386 qr{long\s+long\s+(?:un)?signed\s+int},
387 qr{long\s+long\s+(?:un)?signed},
388 qr{long\s+(?:un)?signed},
389);
390
Andy Whitcroft8905a672007-11-28 16:21:06 -0800391our @typeList = (
392 qr{void},
Joe Perches0c773d92014-08-06 16:11:20 -0700393 qr{(?:(?:un)?signed\s+)?char},
394 qr{(?:(?:un)?signed\s+)?short\s+int},
395 qr{(?:(?:un)?signed\s+)?short},
396 qr{(?:(?:un)?signed\s+)?int},
397 qr{(?:(?:un)?signed\s+)?long\s+int},
398 qr{(?:(?:un)?signed\s+)?long\s+long\s+int},
399 qr{(?:(?:un)?signed\s+)?long\s+long},
400 qr{(?:(?:un)?signed\s+)?long},
401 qr{(?:un)?signed},
Andy Whitcroft8905a672007-11-28 16:21:06 -0800402 qr{float},
403 qr{double},
404 qr{bool},
Andy Whitcroft8905a672007-11-28 16:21:06 -0800405 qr{struct\s+$Ident},
406 qr{union\s+$Ident},
407 qr{enum\s+$Ident},
408 qr{${Ident}_t},
409 qr{${Ident}_handler},
410 qr{${Ident}_handler_fn},
Joe Perches18130872014-08-06 16:11:22 -0700411 @typeListMisordered,
Andy Whitcroft8905a672007-11-28 16:21:06 -0800412);
Joe Perches8716de32013-09-11 14:24:05 -0700413our @typeListWithAttr = (
414 @typeList,
415 qr{struct\s+$InitAttribute\s+$Ident},
416 qr{union\s+$InitAttribute\s+$Ident},
417);
418
Andy Whitcroftc45dcab2008-06-05 22:46:01 -0700419our @modifierList = (
420 qr{fastcall},
421);
Andy Whitcroft8905a672007-11-28 16:21:06 -0800422
Joe Perches24358802014-04-03 14:49:13 -0700423our @mode_permission_funcs = (
424 ["module_param", 3],
425 ["module_param_(?:array|named|string)", 4],
426 ["module_param_array_named", 5],
427 ["debugfs_create_(?:file|u8|u16|u32|u64|x8|x16|x32|x64|size_t|atomic_t|bool|blob|regset32|u32_array)", 2],
428 ["proc_create(?:_data|)", 2],
429 ["(?:CLASS|DEVICE|SENSOR)_ATTR", 2],
430);
431
Joe Perches515a2352014-04-03 14:49:24 -0700432#Create a search pattern for all these functions to speed up a loop below
433our $mode_perms_search = "";
434foreach my $entry (@mode_permission_funcs) {
435 $mode_perms_search .= '|' if ($mode_perms_search ne "");
436 $mode_perms_search .= $entry->[0];
437}
438
Wolfram Sang7840a942010-08-09 17:20:57 -0700439our $allowed_asm_includes = qr{(?x:
440 irq|
Sergey Ryazanovcdcee682014-10-13 15:51:44 -0700441 memory|
442 time|
443 reboot
Wolfram Sang7840a942010-08-09 17:20:57 -0700444)};
445# memory.h: ARM has a custom one
446
Kees Cook66b47b42014-10-13 15:51:57 -0700447# Load common spelling mistakes and build regular expression list.
448my $misspellings;
Kees Cook66b47b42014-10-13 15:51:57 -0700449my %spelling_fix;
Kees Cook66b47b42014-10-13 15:51:57 -0700450
Joe Perches36061e32014-12-10 15:51:43 -0800451if (open(my $spelling, '<', $spelling_file)) {
452 my @spelling_list;
453 while (<$spelling>) {
454 my $line = $_;
Kees Cook66b47b42014-10-13 15:51:57 -0700455
Joe Perches36061e32014-12-10 15:51:43 -0800456 $line =~ s/\s*\n?$//g;
457 $line =~ s/^\s*//g;
Kees Cook66b47b42014-10-13 15:51:57 -0700458
Joe Perches36061e32014-12-10 15:51:43 -0800459 next if ($line =~ m/^\s*#/);
460 next if ($line =~ m/^\s*$/);
Kees Cook66b47b42014-10-13 15:51:57 -0700461
Joe Perches36061e32014-12-10 15:51:43 -0800462 my ($suspect, $fix) = split(/\|\|/, $line);
463
464 push(@spelling_list, $suspect);
465 $spelling_fix{$suspect} = $fix;
466 }
467 close($spelling);
468 $misspellings = join("|", @spelling_list);
469} else {
470 warn "No typos will be found - file '$spelling_file': $!\n";
Kees Cook66b47b42014-10-13 15:51:57 -0700471}
Kees Cook66b47b42014-10-13 15:51:57 -0700472
Andy Whitcroft8905a672007-11-28 16:21:06 -0800473sub build_types {
Andy Whitcroftd2172eb2008-07-23 21:29:07 -0700474 my $mods = "(?x: \n" . join("|\n ", @modifierList) . "\n)";
475 my $all = "(?x: \n" . join("|\n ", @typeList) . "\n)";
Joe Perches18130872014-08-06 16:11:22 -0700476 my $Misordered = "(?x: \n" . join("|\n ", @typeListMisordered) . "\n)";
Joe Perches8716de32013-09-11 14:24:05 -0700477 my $allWithAttr = "(?x: \n" . join("|\n ", @typeListWithAttr) . "\n)";
Andy Whitcroftc8cb2ca2008-07-23 21:28:57 -0700478 $Modifier = qr{(?:$Attribute|$Sparse|$mods)};
Andy Whitcroft8905a672007-11-28 16:21:06 -0800479 $NonptrType = qr{
Andy Whitcroftd2172eb2008-07-23 21:29:07 -0700480 (?:$Modifier\s+|const\s+)*
Andy Whitcroftcf655042008-03-04 14:28:20 -0800481 (?:
Andy Whitcroft6b48db22012-01-10 15:10:13 -0800482 (?:typeof|__typeof__)\s*\([^\)]*\)|
Joe Perches021158b2015-02-13 14:38:43 -0800483 (?:$typeOtherOSTypedefs\b)|
Andy Whitcroft8ed22ca2008-10-15 22:02:32 -0700484 (?:$typeTypedefs\b)|
Andy Whitcroftc45dcab2008-06-05 22:46:01 -0700485 (?:${all}\b)
Andy Whitcroftcf655042008-03-04 14:28:20 -0800486 )
Andy Whitcroftc8cb2ca2008-07-23 21:28:57 -0700487 (?:\s+$Modifier|\s+const)*
Andy Whitcroft8905a672007-11-28 16:21:06 -0800488 }x;
Joe Perches18130872014-08-06 16:11:22 -0700489 $NonptrTypeMisordered = qr{
490 (?:$Modifier\s+|const\s+)*
491 (?:
492 (?:${Misordered}\b)
493 )
494 (?:\s+$Modifier|\s+const)*
495 }x;
Joe Perches8716de32013-09-11 14:24:05 -0700496 $NonptrTypeWithAttr = qr{
497 (?:$Modifier\s+|const\s+)*
498 (?:
499 (?:typeof|__typeof__)\s*\([^\)]*\)|
500 (?:$typeTypedefs\b)|
Joe Perches021158b2015-02-13 14:38:43 -0800501 (?:$typeOtherOSTypedefs\b)|
Joe Perches8716de32013-09-11 14:24:05 -0700502 (?:${allWithAttr}\b)
503 )
504 (?:\s+$Modifier|\s+const)*
505 }x;
Andy Whitcroft8905a672007-11-28 16:21:06 -0800506 $Type = qr{
Andy Whitcroftc45dcab2008-06-05 22:46:01 -0700507 $NonptrType
Joe Perches1574a292014-08-06 16:10:50 -0700508 (?:(?:\s|\*|\[\])+\s*const|(?:\s|\*\s*(?:const\s*)?|\[\])+|(?:\s*\[\s*\])+)?
Andy Whitcroftc8cb2ca2008-07-23 21:28:57 -0700509 (?:\s+$Inline|\s+$Modifier)*
Andy Whitcroft8905a672007-11-28 16:21:06 -0800510 }x;
Joe Perches18130872014-08-06 16:11:22 -0700511 $TypeMisordered = qr{
512 $NonptrTypeMisordered
513 (?:(?:\s|\*|\[\])+\s*const|(?:\s|\*\s*(?:const\s*)?|\[\])+|(?:\s*\[\s*\])+)?
514 (?:\s+$Inline|\s+$Modifier)*
515 }x;
Joe Perches91cb5192014-04-03 14:49:32 -0700516 $Declare = qr{(?:$Storage\s+(?:$Inline\s+)?)?$Type};
Joe Perches18130872014-08-06 16:11:22 -0700517 $DeclareMisordered = qr{(?:$Storage\s+(?:$Inline\s+)?)?$TypeMisordered};
Andy Whitcroft8905a672007-11-28 16:21:06 -0800518}
519build_types();
Andy Whitcroft6c72ffa2007-10-18 03:05:08 -0700520
Joe Perches7d2367a2011-07-25 17:13:22 -0700521our $Typecast = qr{\s*(\(\s*$NonptrType\s*\)){0,1}\s*};
Joe Perchesd1fe9c02012-03-23 15:02:16 -0700522
523# Using $balanced_parens, $LvalOrFunc, or $FuncArg
524# requires at least perl version v5.10.0
525# Any use must be runtime checked with $^V
526
527our $balanced_parens = qr/(\((?:[^\(\)]++|(?-1))*\))/;
Joe Perches24358802014-04-03 14:49:13 -0700528our $LvalOrFunc = qr{((?:[\&\*]\s*)?$Lval)\s*($balanced_parens{0,1})\s*};
Joe Perchesc0a5c892015-02-13 14:38:21 -0800529our $FuncArg = qr{$Typecast{0,1}($LvalOrFunc|$Constant|$String)};
Joe Perches7d2367a2011-07-25 17:13:22 -0700530
Joe Perchesf8422302014-08-06 16:11:31 -0700531our $declaration_macros = qr{(?x:
532 (?:$Storage\s+)?(?:[A-Z_][A-Z0-9]*_){0,2}(?:DEFINE|DECLARE)(?:_[A-Z0-9]+){1,2}\s*\(|
533 (?:$Storage\s+)?LIST_HEAD\s*\(|
534 (?:$Storage\s+)?${Type}\s+uninitialized_var\s*\(
535)};
536
Joe Perches7d2367a2011-07-25 17:13:22 -0700537sub deparenthesize {
538 my ($string) = @_;
539 return "" if (!defined($string));
Joe Perches5b9553a2014-04-03 14:49:21 -0700540
541 while ($string =~ /^\s*\(.*\)\s*$/) {
542 $string =~ s@^\s*\(\s*@@;
543 $string =~ s@\s*\)\s*$@@;
544 }
545
Joe Perches7d2367a2011-07-25 17:13:22 -0700546 $string =~ s@\s+@ @g;
Joe Perches5b9553a2014-04-03 14:49:21 -0700547
Joe Perches7d2367a2011-07-25 17:13:22 -0700548 return $string;
549}
550
Joe Perches34456862013-07-03 15:05:34 -0700551sub seed_camelcase_file {
552 my ($file) = @_;
553
554 return if (!(-f $file));
555
556 local $/;
557
558 open(my $include_file, '<', "$file")
559 or warn "$P: Can't read '$file' $!\n";
560 my $text = <$include_file>;
561 close($include_file);
562
563 my @lines = split('\n', $text);
564
565 foreach my $line (@lines) {
566 next if ($line !~ /(?:[A-Z][a-z]|[a-z][A-Z])/);
567 if ($line =~ /^[ \t]*(?:#[ \t]*define|typedef\s+$Type)\s+(\w*(?:[A-Z][a-z]|[a-z][A-Z])\w*)/) {
568 $camelcase{$1} = 1;
Joe Perches11ea5162013-11-12 15:10:08 -0800569 } elsif ($line =~ /^\s*$Declare\s+(\w*(?:[A-Z][a-z]|[a-z][A-Z])\w*)\s*[\(\[,;]/) {
570 $camelcase{$1} = 1;
571 } elsif ($line =~ /^\s*(?:union|struct|enum)\s+(\w*(?:[A-Z][a-z]|[a-z][A-Z])\w*)\s*[;\{]/) {
Joe Perches34456862013-07-03 15:05:34 -0700572 $camelcase{$1} = 1;
573 }
574 }
575}
576
577my $camelcase_seeded = 0;
578sub seed_camelcase_includes {
579 return if ($camelcase_seeded);
580
581 my $files;
Joe Perchesc707a812013-07-08 16:00:43 -0700582 my $camelcase_cache = "";
583 my @include_files = ();
584
585 $camelcase_seeded = 1;
Joe Perches351b2a12013-07-03 15:05:36 -0700586
Richard Genoud3645e322014-02-10 14:25:32 -0800587 if (-e ".git") {
Joe Perches351b2a12013-07-03 15:05:36 -0700588 my $git_last_include_commit = `git log --no-merges --pretty=format:"%h%n" -1 -- include`;
589 chomp $git_last_include_commit;
Joe Perchesc707a812013-07-08 16:00:43 -0700590 $camelcase_cache = ".checkpatch-camelcase.git.$git_last_include_commit";
Joe Perches34456862013-07-03 15:05:34 -0700591 } else {
Joe Perchesc707a812013-07-08 16:00:43 -0700592 my $last_mod_date = 0;
Joe Perches34456862013-07-03 15:05:34 -0700593 $files = `find $root/include -name "*.h"`;
Joe Perchesc707a812013-07-08 16:00:43 -0700594 @include_files = split('\n', $files);
595 foreach my $file (@include_files) {
596 my $date = POSIX::strftime("%Y%m%d%H%M",
597 localtime((stat $file)[9]));
598 $last_mod_date = $date if ($last_mod_date < $date);
599 }
600 $camelcase_cache = ".checkpatch-camelcase.date.$last_mod_date";
Joe Perches34456862013-07-03 15:05:34 -0700601 }
Joe Perchesc707a812013-07-08 16:00:43 -0700602
603 if ($camelcase_cache ne "" && -f $camelcase_cache) {
604 open(my $camelcase_file, '<', "$camelcase_cache")
605 or warn "$P: Can't read '$camelcase_cache' $!\n";
606 while (<$camelcase_file>) {
607 chomp;
608 $camelcase{$_} = 1;
609 }
610 close($camelcase_file);
611
612 return;
613 }
614
Richard Genoud3645e322014-02-10 14:25:32 -0800615 if (-e ".git") {
Joe Perchesc707a812013-07-08 16:00:43 -0700616 $files = `git ls-files "include/*.h"`;
617 @include_files = split('\n', $files);
618 }
619
Joe Perches34456862013-07-03 15:05:34 -0700620 foreach my $file (@include_files) {
621 seed_camelcase_file($file);
622 }
Joe Perches351b2a12013-07-03 15:05:36 -0700623
Joe Perchesc707a812013-07-08 16:00:43 -0700624 if ($camelcase_cache ne "") {
Joe Perches351b2a12013-07-03 15:05:36 -0700625 unlink glob ".checkpatch-camelcase.*";
Joe Perchesc707a812013-07-08 16:00:43 -0700626 open(my $camelcase_file, '>', "$camelcase_cache")
627 or warn "$P: Can't write '$camelcase_cache' $!\n";
Joe Perches351b2a12013-07-03 15:05:36 -0700628 foreach (sort { lc($a) cmp lc($b) } keys(%camelcase)) {
629 print $camelcase_file ("$_\n");
630 }
631 close($camelcase_file);
632 }
Joe Perches34456862013-07-03 15:05:34 -0700633}
634
Joe Perchesd311cd42014-08-06 16:10:57 -0700635sub git_commit_info {
636 my ($commit, $id, $desc) = @_;
637
638 return ($id, $desc) if ((which("git") eq "") || !(-e ".git"));
639
640 my $output = `git log --no-color --format='%H %s' -1 $commit 2>&1`;
641 $output =~ s/^\s*//gm;
642 my @lines = split("\n", $output);
643
Joe Perches0d7835f2015-02-13 14:38:35 -0800644 return ($id, $desc) if ($#lines < 0);
645
Joe Perchesd311cd42014-08-06 16:10:57 -0700646 if ($lines[0] =~ /^error: short SHA1 $commit is ambiguous\./) {
647# Maybe one day convert this block of bash into something that returns
648# all matching commit ids, but it's very slow...
649#
650# echo "checking commits $1..."
651# git rev-list --remotes | grep -i "^$1" |
652# while read line ; do
653# git log --format='%H %s' -1 $line |
654# echo "commit $(cut -c 1-12,41-)"
655# done
656 } elsif ($lines[0] =~ /^fatal: ambiguous argument '$commit': unknown revision or path not in the working tree\./) {
657 } else {
658 $id = substr($lines[0], 0, 12);
659 $desc = substr($lines[0], 41);
660 }
661
662 return ($id, $desc);
663}
664
Andy Whitcroft6c72ffa2007-10-18 03:05:08 -0700665$chk_signoff = 0 if ($file);
666
Andy Whitcroft00df3442007-06-08 13:47:06 -0700667my @rawlines = ();
Andy Whitcroftc2fdda02008-02-08 04:20:54 -0800668my @lines = ();
Joe Perches3705ce52013-07-03 15:05:31 -0700669my @fixed = ();
Joe Perchesd752fcc2014-08-06 16:11:05 -0700670my @fixed_inserted = ();
671my @fixed_deleted = ();
Joe Perches194f66f2014-08-06 16:11:03 -0700672my $fixlinenr = -1;
673
Andy Whitcroftc2fdda02008-02-08 04:20:54 -0800674my $vname;
Andy Whitcroft6c72ffa2007-10-18 03:05:08 -0700675for my $filename (@ARGV) {
Andy Whitcroft21caa132009-01-06 14:41:30 -0800676 my $FILE;
Andy Whitcroft6c72ffa2007-10-18 03:05:08 -0700677 if ($file) {
Andy Whitcroft21caa132009-01-06 14:41:30 -0800678 open($FILE, '-|', "diff -u /dev/null $filename") ||
Andy Whitcroft6c72ffa2007-10-18 03:05:08 -0700679 die "$P: $filename: diff failed - $!\n";
Andy Whitcroft21caa132009-01-06 14:41:30 -0800680 } elsif ($filename eq '-') {
681 open($FILE, '<&STDIN');
Andy Whitcroft6c72ffa2007-10-18 03:05:08 -0700682 } else {
Andy Whitcroft21caa132009-01-06 14:41:30 -0800683 open($FILE, '<', "$filename") ||
Andy Whitcroft6c72ffa2007-10-18 03:05:08 -0700684 die "$P: $filename: open failed - $!\n";
Andy Whitcroft0a920b5b2007-06-01 00:46:48 -0700685 }
Andy Whitcroftc2fdda02008-02-08 04:20:54 -0800686 if ($filename eq '-') {
687 $vname = 'Your patch';
688 } else {
689 $vname = $filename;
690 }
Andy Whitcroft21caa132009-01-06 14:41:30 -0800691 while (<$FILE>) {
Andy Whitcroft6c72ffa2007-10-18 03:05:08 -0700692 chomp;
693 push(@rawlines, $_);
694 }
Andy Whitcroft21caa132009-01-06 14:41:30 -0800695 close($FILE);
Andy Whitcroftc2fdda02008-02-08 04:20:54 -0800696 if (!process($filename)) {
Andy Whitcroft6c72ffa2007-10-18 03:05:08 -0700697 $exit = 1;
698 }
699 @rawlines = ();
Andy Whitcroft13214ad2008-02-08 04:22:03 -0800700 @lines = ();
Joe Perches3705ce52013-07-03 15:05:31 -0700701 @fixed = ();
Joe Perchesd752fcc2014-08-06 16:11:05 -0700702 @fixed_inserted = ();
703 @fixed_deleted = ();
Joe Perches194f66f2014-08-06 16:11:03 -0700704 $fixlinenr = -1;
Andy Whitcroft0a920b5b2007-06-01 00:46:48 -0700705}
706
707exit($exit);
708
709sub top_of_kernel_tree {
Andy Whitcroft6c72ffa2007-10-18 03:05:08 -0700710 my ($root) = @_;
711
712 my @tree_check = (
713 "COPYING", "CREDITS", "Kbuild", "MAINTAINERS", "Makefile",
714 "README", "Documentation", "arch", "include", "drivers",
715 "fs", "init", "ipc", "kernel", "lib", "scripts",
716 );
717
718 foreach my $check (@tree_check) {
719 if (! -e $root . '/' . $check) {
720 return 0;
721 }
Andy Whitcroft0a920b5b2007-06-01 00:46:48 -0700722 }
Andy Whitcroft6c72ffa2007-10-18 03:05:08 -0700723 return 1;
Joe Perches8f26b832012-10-04 17:13:32 -0700724}
Andy Whitcroft0a920b5b2007-06-01 00:46:48 -0700725
Joe Perches20112472011-07-25 17:13:23 -0700726sub parse_email {
727 my ($formatted_email) = @_;
728
729 my $name = "";
730 my $address = "";
731 my $comment = "";
732
733 if ($formatted_email =~ /^(.*)<(\S+\@\S+)>(.*)$/) {
734 $name = $1;
735 $address = $2;
736 $comment = $3 if defined $3;
737 } elsif ($formatted_email =~ /^\s*<(\S+\@\S+)>(.*)$/) {
738 $address = $1;
739 $comment = $2 if defined $2;
740 } elsif ($formatted_email =~ /(\S+\@\S+)(.*)$/) {
741 $address = $1;
742 $comment = $2 if defined $2;
743 $formatted_email =~ s/$address.*$//;
744 $name = $formatted_email;
Joe Perches3705ce52013-07-03 15:05:31 -0700745 $name = trim($name);
Joe Perches20112472011-07-25 17:13:23 -0700746 $name =~ s/^\"|\"$//g;
747 # If there's a name left after stripping spaces and
748 # leading quotes, and the address doesn't have both
749 # leading and trailing angle brackets, the address
750 # is invalid. ie:
751 # "joe smith joe@smith.com" bad
752 # "joe smith <joe@smith.com" bad
753 if ($name ne "" && $address !~ /^<[^>]+>$/) {
754 $name = "";
755 $address = "";
756 $comment = "";
757 }
758 }
759
Joe Perches3705ce52013-07-03 15:05:31 -0700760 $name = trim($name);
Joe Perches20112472011-07-25 17:13:23 -0700761 $name =~ s/^\"|\"$//g;
Joe Perches3705ce52013-07-03 15:05:31 -0700762 $address = trim($address);
Joe Perches20112472011-07-25 17:13:23 -0700763 $address =~ s/^\<|\>$//g;
764
765 if ($name =~ /[^\w \-]/i) { ##has "must quote" chars
766 $name =~ s/(?<!\\)"/\\"/g; ##escape quotes
767 $name = "\"$name\"";
768 }
769
770 return ($name, $address, $comment);
771}
772
773sub format_email {
774 my ($name, $address) = @_;
775
776 my $formatted_email;
777
Joe Perches3705ce52013-07-03 15:05:31 -0700778 $name = trim($name);
Joe Perches20112472011-07-25 17:13:23 -0700779 $name =~ s/^\"|\"$//g;
Joe Perches3705ce52013-07-03 15:05:31 -0700780 $address = trim($address);
Joe Perches20112472011-07-25 17:13:23 -0700781
782 if ($name =~ /[^\w \-]/i) { ##has "must quote" chars
783 $name =~ s/(?<!\\)"/\\"/g; ##escape quotes
784 $name = "\"$name\"";
785 }
786
787 if ("$name" eq "") {
788 $formatted_email = "$address";
789 } else {
790 $formatted_email = "$name <$address>";
791 }
792
793 return $formatted_email;
794}
795
Joe Perchesd311cd42014-08-06 16:10:57 -0700796sub which {
Joe Perchesbd474ca2014-08-06 16:11:10 -0700797 my ($bin) = @_;
Joe Perchesd311cd42014-08-06 16:10:57 -0700798
Joe Perchesbd474ca2014-08-06 16:11:10 -0700799 foreach my $path (split(/:/, $ENV{PATH})) {
800 if (-e "$path/$bin") {
801 return "$path/$bin";
802 }
Joe Perchesd311cd42014-08-06 16:10:57 -0700803 }
Joe Perchesd311cd42014-08-06 16:10:57 -0700804
Joe Perchesbd474ca2014-08-06 16:11:10 -0700805 return "";
Joe Perchesd311cd42014-08-06 16:10:57 -0700806}
807
Joe Perches000d1cc12011-07-25 17:13:25 -0700808sub which_conf {
809 my ($conf) = @_;
810
811 foreach my $path (split(/:/, ".:$ENV{HOME}:.scripts")) {
812 if (-e "$path/$conf") {
813 return "$path/$conf";
814 }
815 }
816
817 return "";
818}
819
Andy Whitcroft0a920b5b2007-06-01 00:46:48 -0700820sub expand_tabs {
821 my ($str) = @_;
822
823 my $res = '';
824 my $n = 0;
825 for my $c (split(//, $str)) {
826 if ($c eq "\t") {
827 $res .= ' ';
828 $n++;
829 for (; ($n % 8) != 0; $n++) {
830 $res .= ' ';
831 }
832 next;
833 }
834 $res .= $c;
835 $n++;
836 }
837
838 return $res;
839}
Andy Whitcroft6c72ffa2007-10-18 03:05:08 -0700840sub copy_spacing {
Andy Whitcroft773647a2008-03-28 14:15:58 -0700841 (my $res = shift) =~ tr/\t/ /c;
Andy Whitcroft6c72ffa2007-10-18 03:05:08 -0700842 return $res;
843}
Andy Whitcroft0a920b5b2007-06-01 00:46:48 -0700844
Andy Whitcroft4a0df2e2007-06-08 13:46:39 -0700845sub line_stats {
846 my ($line) = @_;
847
848 # Drop the diff line leader and expand tabs
849 $line =~ s/^.//;
850 $line = expand_tabs($line);
851
852 # Pick the indent from the front of the line.
853 my ($white) = ($line =~ /^(\s*)/);
854
855 return (length($line), length($white));
856}
857
Andy Whitcroft773647a2008-03-28 14:15:58 -0700858my $sanitise_quote = '';
859
860sub sanitise_line_reset {
861 my ($in_comment) = @_;
862
863 if ($in_comment) {
864 $sanitise_quote = '*/';
865 } else {
866 $sanitise_quote = '';
867 }
868}
Andy Whitcroft00df3442007-06-08 13:47:06 -0700869sub sanitise_line {
870 my ($line) = @_;
871
872 my $res = '';
873 my $l = '';
874
Andy Whitcroftc2fdda02008-02-08 04:20:54 -0800875 my $qlen = 0;
Andy Whitcroft773647a2008-03-28 14:15:58 -0700876 my $off = 0;
877 my $c;
Andy Whitcroft00df3442007-06-08 13:47:06 -0700878
Andy Whitcroft773647a2008-03-28 14:15:58 -0700879 # Always copy over the diff marker.
880 $res = substr($line, 0, 1);
881
882 for ($off = 1; $off < length($line); $off++) {
883 $c = substr($line, $off, 1);
884
885 # Comments we are wacking completly including the begin
886 # and end, all to $;.
887 if ($sanitise_quote eq '' && substr($line, $off, 2) eq '/*') {
888 $sanitise_quote = '*/';
889
890 substr($res, $off, 2, "$;$;");
891 $off++;
892 next;
Andy Whitcroftc2fdda02008-02-08 04:20:54 -0800893 }
Andy Whitcroft81bc0e02008-10-15 22:02:26 -0700894 if ($sanitise_quote eq '*/' && substr($line, $off, 2) eq '*/') {
Andy Whitcroft773647a2008-03-28 14:15:58 -0700895 $sanitise_quote = '';
896 substr($res, $off, 2, "$;$;");
897 $off++;
898 next;
899 }
Daniel Walker113f04a2009-09-21 17:04:35 -0700900 if ($sanitise_quote eq '' && substr($line, $off, 2) eq '//') {
901 $sanitise_quote = '//';
902
903 substr($res, $off, 2, $sanitise_quote);
904 $off++;
905 next;
906 }
Andy Whitcroft773647a2008-03-28 14:15:58 -0700907
908 # A \ in a string means ignore the next character.
909 if (($sanitise_quote eq "'" || $sanitise_quote eq '"') &&
910 $c eq "\\") {
911 substr($res, $off, 2, 'XX');
912 $off++;
913 next;
914 }
915 # Regular quotes.
916 if ($c eq "'" || $c eq '"') {
917 if ($sanitise_quote eq '') {
918 $sanitise_quote = $c;
919
920 substr($res, $off, 1, $c);
Andy Whitcroft00df3442007-06-08 13:47:06 -0700921 next;
Andy Whitcroft773647a2008-03-28 14:15:58 -0700922 } elsif ($sanitise_quote eq $c) {
923 $sanitise_quote = '';
Andy Whitcroft00df3442007-06-08 13:47:06 -0700924 }
925 }
Andy Whitcroft773647a2008-03-28 14:15:58 -0700926
Andy Whitcroftfae17da2009-01-06 14:41:20 -0800927 #print "c<$c> SQ<$sanitise_quote>\n";
Andy Whitcroft773647a2008-03-28 14:15:58 -0700928 if ($off != 0 && $sanitise_quote eq '*/' && $c ne "\t") {
929 substr($res, $off, 1, $;);
Daniel Walker113f04a2009-09-21 17:04:35 -0700930 } elsif ($off != 0 && $sanitise_quote eq '//' && $c ne "\t") {
931 substr($res, $off, 1, $;);
Andy Whitcroft773647a2008-03-28 14:15:58 -0700932 } elsif ($off != 0 && $sanitise_quote && $c ne "\t") {
933 substr($res, $off, 1, 'X');
Andy Whitcroft00df3442007-06-08 13:47:06 -0700934 } else {
Andy Whitcroft773647a2008-03-28 14:15:58 -0700935 substr($res, $off, 1, $c);
Andy Whitcroft00df3442007-06-08 13:47:06 -0700936 }
Andy Whitcroftc2fdda02008-02-08 04:20:54 -0800937 }
938
Daniel Walker113f04a2009-09-21 17:04:35 -0700939 if ($sanitise_quote eq '//') {
940 $sanitise_quote = '';
941 }
942
Andy Whitcroftc2fdda02008-02-08 04:20:54 -0800943 # The pathname on a #include may be surrounded by '<' and '>'.
Andy Whitcroftc45dcab2008-06-05 22:46:01 -0700944 if ($res =~ /^.\s*\#\s*include\s+\<(.*)\>/) {
Andy Whitcroftc2fdda02008-02-08 04:20:54 -0800945 my $clean = 'X' x length($1);
946 $res =~ s@\<.*\>@<$clean>@;
947
948 # The whole of a #error is a string.
Andy Whitcroftc45dcab2008-06-05 22:46:01 -0700949 } elsif ($res =~ /^.\s*\#\s*(?:error|warning)\s+(.*)\b/) {
Andy Whitcroftc2fdda02008-02-08 04:20:54 -0800950 my $clean = 'X' x length($1);
Andy Whitcroftc45dcab2008-06-05 22:46:01 -0700951 $res =~ s@(\#\s*(?:error|warning)\s+).*@$1$clean@;
Andy Whitcroftc2fdda02008-02-08 04:20:54 -0800952 }
953
Andy Whitcroft00df3442007-06-08 13:47:06 -0700954 return $res;
955}
956
Joe Perchesa6962d72013-04-29 16:18:13 -0700957sub get_quoted_string {
958 my ($line, $rawline) = @_;
959
Joe Perches5e4f6ba2014-12-10 15:52:05 -0800960 return "" if ($line !~ m/(\"[X\t]+\")/g);
Joe Perchesa6962d72013-04-29 16:18:13 -0700961 return substr($rawline, $-[0], $+[0] - $-[0]);
962}
963
Andy Whitcroft8905a672007-11-28 16:21:06 -0800964sub ctx_statement_block {
965 my ($linenr, $remain, $off) = @_;
966 my $line = $linenr - 1;
967 my $blk = '';
968 my $soff = $off;
969 my $coff = $off - 1;
Andy Whitcroft773647a2008-03-28 14:15:58 -0700970 my $coff_set = 0;
Andy Whitcroft8905a672007-11-28 16:21:06 -0800971
Andy Whitcroft13214ad2008-02-08 04:22:03 -0800972 my $loff = 0;
973
Andy Whitcroft8905a672007-11-28 16:21:06 -0800974 my $type = '';
975 my $level = 0;
Andy Whitcrofta2750642009-01-15 13:51:04 -0800976 my @stack = ();
Andy Whitcroftcf655042008-03-04 14:28:20 -0800977 my $p;
Andy Whitcroft8905a672007-11-28 16:21:06 -0800978 my $c;
979 my $len = 0;
Andy Whitcroft13214ad2008-02-08 04:22:03 -0800980
981 my $remainder;
Andy Whitcroft8905a672007-11-28 16:21:06 -0800982 while (1) {
Andy Whitcrofta2750642009-01-15 13:51:04 -0800983 @stack = (['', 0]) if ($#stack == -1);
984
Andy Whitcroft773647a2008-03-28 14:15:58 -0700985 #warn "CSB: blk<$blk> remain<$remain>\n";
Andy Whitcroft8905a672007-11-28 16:21:06 -0800986 # If we are about to drop off the end, pull in more
987 # context.
988 if ($off >= $len) {
989 for (; $remain > 0; $line++) {
Andy Whitcroftdea33492008-10-15 22:02:25 -0700990 last if (!defined $lines[$line]);
Andy Whitcroftc2fdda02008-02-08 04:20:54 -0800991 next if ($lines[$line] =~ /^-/);
Andy Whitcroft8905a672007-11-28 16:21:06 -0800992 $remain--;
Andy Whitcroft13214ad2008-02-08 04:22:03 -0800993 $loff = $len;
Andy Whitcroftc2fdda02008-02-08 04:20:54 -0800994 $blk .= $lines[$line] . "\n";
Andy Whitcroft8905a672007-11-28 16:21:06 -0800995 $len = length($blk);
996 $line++;
997 last;
998 }
999 # Bail if there is no further context.
1000 #warn "CSB: blk<$blk> off<$off> len<$len>\n";
Andy Whitcroft13214ad2008-02-08 04:22:03 -08001001 if ($off >= $len) {
Andy Whitcroft8905a672007-11-28 16:21:06 -08001002 last;
1003 }
Andy Whitcroftf74bd192012-01-10 15:09:54 -08001004 if ($level == 0 && substr($blk, $off) =~ /^.\s*#\s*define/) {
1005 $level++;
1006 $type = '#';
1007 }
Andy Whitcroft8905a672007-11-28 16:21:06 -08001008 }
Andy Whitcroftcf655042008-03-04 14:28:20 -08001009 $p = $c;
Andy Whitcroft8905a672007-11-28 16:21:06 -08001010 $c = substr($blk, $off, 1);
Andy Whitcroft13214ad2008-02-08 04:22:03 -08001011 $remainder = substr($blk, $off);
Andy Whitcroft8905a672007-11-28 16:21:06 -08001012
Andy Whitcroft773647a2008-03-28 14:15:58 -07001013 #warn "CSB: c<$c> type<$type> level<$level> remainder<$remainder> coff_set<$coff_set>\n";
Andy Whitcroft4635f4f2009-01-06 14:41:27 -08001014
1015 # Handle nested #if/#else.
1016 if ($remainder =~ /^#\s*(?:ifndef|ifdef|if)\s/) {
1017 push(@stack, [ $type, $level ]);
1018 } elsif ($remainder =~ /^#\s*(?:else|elif)\b/) {
1019 ($type, $level) = @{$stack[$#stack - 1]};
1020 } elsif ($remainder =~ /^#\s*endif\b/) {
1021 ($type, $level) = @{pop(@stack)};
1022 }
1023
Andy Whitcroft8905a672007-11-28 16:21:06 -08001024 # Statement ends at the ';' or a close '}' at the
1025 # outermost level.
1026 if ($level == 0 && $c eq ';') {
1027 last;
1028 }
1029
Andy Whitcroft13214ad2008-02-08 04:22:03 -08001030 # An else is really a conditional as long as its not else if
Andy Whitcroft773647a2008-03-28 14:15:58 -07001031 if ($level == 0 && $coff_set == 0 &&
1032 (!defined($p) || $p =~ /(?:\s|\}|\+)/) &&
1033 $remainder =~ /^(else)(?:\s|{)/ &&
1034 $remainder !~ /^else\s+if\b/) {
1035 $coff = $off + length($1) - 1;
1036 $coff_set = 1;
1037 #warn "CSB: mark coff<$coff> soff<$soff> 1<$1>\n";
1038 #warn "[" . substr($blk, $soff, $coff - $soff + 1) . "]\n";
Andy Whitcroft13214ad2008-02-08 04:22:03 -08001039 }
1040
Andy Whitcroft8905a672007-11-28 16:21:06 -08001041 if (($type eq '' || $type eq '(') && $c eq '(') {
1042 $level++;
1043 $type = '(';
1044 }
1045 if ($type eq '(' && $c eq ')') {
1046 $level--;
1047 $type = ($level != 0)? '(' : '';
1048
1049 if ($level == 0 && $coff < $soff) {
1050 $coff = $off;
Andy Whitcroft773647a2008-03-28 14:15:58 -07001051 $coff_set = 1;
1052 #warn "CSB: mark coff<$coff>\n";
Andy Whitcroft8905a672007-11-28 16:21:06 -08001053 }
1054 }
1055 if (($type eq '' || $type eq '{') && $c eq '{') {
1056 $level++;
1057 $type = '{';
1058 }
1059 if ($type eq '{' && $c eq '}') {
1060 $level--;
1061 $type = ($level != 0)? '{' : '';
1062
1063 if ($level == 0) {
Patrick Pannutob998e002010-08-09 17:21:03 -07001064 if (substr($blk, $off + 1, 1) eq ';') {
1065 $off++;
1066 }
Andy Whitcroft8905a672007-11-28 16:21:06 -08001067 last;
1068 }
1069 }
Andy Whitcroftf74bd192012-01-10 15:09:54 -08001070 # Preprocessor commands end at the newline unless escaped.
1071 if ($type eq '#' && $c eq "\n" && $p ne "\\") {
1072 $level--;
1073 $type = '';
1074 $off++;
1075 last;
1076 }
Andy Whitcroft8905a672007-11-28 16:21:06 -08001077 $off++;
1078 }
Andy Whitcrofta3bb97a2008-07-23 21:29:00 -07001079 # We are truly at the end, so shuffle to the next line.
Andy Whitcroft13214ad2008-02-08 04:22:03 -08001080 if ($off == $len) {
Andy Whitcrofta3bb97a2008-07-23 21:29:00 -07001081 $loff = $len + 1;
Andy Whitcroft13214ad2008-02-08 04:22:03 -08001082 $line++;
1083 $remain--;
1084 }
Andy Whitcroft8905a672007-11-28 16:21:06 -08001085
1086 my $statement = substr($blk, $soff, $off - $soff + 1);
1087 my $condition = substr($blk, $soff, $coff - $soff + 1);
1088
1089 #warn "STATEMENT<$statement>\n";
1090 #warn "CONDITION<$condition>\n";
1091
Andy Whitcroft773647a2008-03-28 14:15:58 -07001092 #print "coff<$coff> soff<$off> loff<$loff>\n";
Andy Whitcroft13214ad2008-02-08 04:22:03 -08001093
1094 return ($statement, $condition,
1095 $line, $remain + 1, $off - $loff + 1, $level);
1096}
1097
Andy Whitcroftcf655042008-03-04 14:28:20 -08001098sub statement_lines {
1099 my ($stmt) = @_;
1100
1101 # Strip the diff line prefixes and rip blank lines at start and end.
1102 $stmt =~ s/(^|\n)./$1/g;
1103 $stmt =~ s/^\s*//;
1104 $stmt =~ s/\s*$//;
1105
1106 my @stmt_lines = ($stmt =~ /\n/g);
1107
1108 return $#stmt_lines + 2;
1109}
1110
1111sub statement_rawlines {
1112 my ($stmt) = @_;
1113
1114 my @stmt_lines = ($stmt =~ /\n/g);
1115
1116 return $#stmt_lines + 2;
1117}
1118
1119sub statement_block_size {
1120 my ($stmt) = @_;
1121
1122 $stmt =~ s/(^|\n)./$1/g;
1123 $stmt =~ s/^\s*{//;
1124 $stmt =~ s/}\s*$//;
1125 $stmt =~ s/^\s*//;
1126 $stmt =~ s/\s*$//;
1127
1128 my @stmt_lines = ($stmt =~ /\n/g);
1129 my @stmt_statements = ($stmt =~ /;/g);
1130
1131 my $stmt_lines = $#stmt_lines + 2;
1132 my $stmt_statements = $#stmt_statements + 1;
1133
1134 if ($stmt_lines > $stmt_statements) {
1135 return $stmt_lines;
1136 } else {
1137 return $stmt_statements;
1138 }
1139}
1140
Andy Whitcroft13214ad2008-02-08 04:22:03 -08001141sub ctx_statement_full {
1142 my ($linenr, $remain, $off) = @_;
1143 my ($statement, $condition, $level);
1144
1145 my (@chunks);
1146
Andy Whitcroftcf655042008-03-04 14:28:20 -08001147 # Grab the first conditional/block pair.
Andy Whitcroft13214ad2008-02-08 04:22:03 -08001148 ($statement, $condition, $linenr, $remain, $off, $level) =
1149 ctx_statement_block($linenr, $remain, $off);
Andy Whitcroft773647a2008-03-28 14:15:58 -07001150 #print "F: c<$condition> s<$statement> remain<$remain>\n";
Andy Whitcroftcf655042008-03-04 14:28:20 -08001151 push(@chunks, [ $condition, $statement ]);
1152 if (!($remain > 0 && $condition =~ /^\s*(?:\n[+-])?\s*(?:if|else|do)\b/s)) {
1153 return ($level, $linenr, @chunks);
1154 }
1155
1156 # Pull in the following conditional/block pairs and see if they
1157 # could continue the statement.
Andy Whitcroft13214ad2008-02-08 04:22:03 -08001158 for (;;) {
Andy Whitcroft13214ad2008-02-08 04:22:03 -08001159 ($statement, $condition, $linenr, $remain, $off, $level) =
1160 ctx_statement_block($linenr, $remain, $off);
Andy Whitcroftcf655042008-03-04 14:28:20 -08001161 #print "C: c<$condition> s<$statement> remain<$remain>\n";
Andy Whitcroft773647a2008-03-28 14:15:58 -07001162 last if (!($remain > 0 && $condition =~ /^(?:\s*\n[+-])*\s*(?:else|do)\b/s));
Andy Whitcroftcf655042008-03-04 14:28:20 -08001163 #print "C: push\n";
1164 push(@chunks, [ $condition, $statement ]);
Andy Whitcroft13214ad2008-02-08 04:22:03 -08001165 }
1166
1167 return ($level, $linenr, @chunks);
Andy Whitcroft8905a672007-11-28 16:21:06 -08001168}
1169
Andy Whitcroft4a0df2e2007-06-08 13:46:39 -07001170sub ctx_block_get {
Andy Whitcroftf0a594c2007-07-19 01:48:34 -07001171 my ($linenr, $remain, $outer, $open, $close, $off) = @_;
Andy Whitcroft4a0df2e2007-06-08 13:46:39 -07001172 my $line;
1173 my $start = $linenr - 1;
Andy Whitcroft4a0df2e2007-06-08 13:46:39 -07001174 my $blk = '';
1175 my @o;
1176 my @c;
1177 my @res = ();
1178
Andy Whitcroftf0a594c2007-07-19 01:48:34 -07001179 my $level = 0;
Andy Whitcroft4635f4f2009-01-06 14:41:27 -08001180 my @stack = ($level);
Andy Whitcroft00df3442007-06-08 13:47:06 -07001181 for ($line = $start; $remain > 0; $line++) {
1182 next if ($rawlines[$line] =~ /^-/);
1183 $remain--;
1184
1185 $blk .= $rawlines[$line];
Andy Whitcroft4635f4f2009-01-06 14:41:27 -08001186
1187 # Handle nested #if/#else.
Andy Whitcroft01464f32010-10-26 14:23:19 -07001188 if ($lines[$line] =~ /^.\s*#\s*(?:ifndef|ifdef|if)\s/) {
Andy Whitcroft4635f4f2009-01-06 14:41:27 -08001189 push(@stack, $level);
Andy Whitcroft01464f32010-10-26 14:23:19 -07001190 } elsif ($lines[$line] =~ /^.\s*#\s*(?:else|elif)\b/) {
Andy Whitcroft4635f4f2009-01-06 14:41:27 -08001191 $level = $stack[$#stack - 1];
Andy Whitcroft01464f32010-10-26 14:23:19 -07001192 } elsif ($lines[$line] =~ /^.\s*#\s*endif\b/) {
Andy Whitcroft4635f4f2009-01-06 14:41:27 -08001193 $level = pop(@stack);
1194 }
1195
Andy Whitcroft01464f32010-10-26 14:23:19 -07001196 foreach my $c (split(//, $lines[$line])) {
Andy Whitcroftf0a594c2007-07-19 01:48:34 -07001197 ##print "C<$c>L<$level><$open$close>O<$off>\n";
1198 if ($off > 0) {
1199 $off--;
1200 next;
1201 }
Andy Whitcroft4a0df2e2007-06-08 13:46:39 -07001202
Andy Whitcroftf0a594c2007-07-19 01:48:34 -07001203 if ($c eq $close && $level > 0) {
1204 $level--;
1205 last if ($level == 0);
1206 } elsif ($c eq $open) {
1207 $level++;
1208 }
1209 }
Andy Whitcroft4a0df2e2007-06-08 13:46:39 -07001210
Andy Whitcroftf0a594c2007-07-19 01:48:34 -07001211 if (!$outer || $level <= 1) {
Andy Whitcroft00df3442007-06-08 13:47:06 -07001212 push(@res, $rawlines[$line]);
Andy Whitcroft4a0df2e2007-06-08 13:46:39 -07001213 }
1214
Andy Whitcroftf0a594c2007-07-19 01:48:34 -07001215 last if ($level == 0);
Andy Whitcroft4a0df2e2007-06-08 13:46:39 -07001216 }
1217
Andy Whitcroftf0a594c2007-07-19 01:48:34 -07001218 return ($level, @res);
Andy Whitcroft4a0df2e2007-06-08 13:46:39 -07001219}
1220sub ctx_block_outer {
1221 my ($linenr, $remain) = @_;
1222
Andy Whitcroftf0a594c2007-07-19 01:48:34 -07001223 my ($level, @r) = ctx_block_get($linenr, $remain, 1, '{', '}', 0);
1224 return @r;
Andy Whitcroft4a0df2e2007-06-08 13:46:39 -07001225}
1226sub ctx_block {
1227 my ($linenr, $remain) = @_;
1228
Andy Whitcroftf0a594c2007-07-19 01:48:34 -07001229 my ($level, @r) = ctx_block_get($linenr, $remain, 0, '{', '}', 0);
1230 return @r;
Andy Whitcroft653d4872007-06-23 17:16:34 -07001231}
1232sub ctx_statement {
Andy Whitcroftf0a594c2007-07-19 01:48:34 -07001233 my ($linenr, $remain, $off) = @_;
1234
1235 my ($level, @r) = ctx_block_get($linenr, $remain, 0, '(', ')', $off);
1236 return @r;
1237}
1238sub ctx_block_level {
Andy Whitcroft653d4872007-06-23 17:16:34 -07001239 my ($linenr, $remain) = @_;
1240
Andy Whitcroftf0a594c2007-07-19 01:48:34 -07001241 return ctx_block_get($linenr, $remain, 0, '{', '}', 0);
Andy Whitcroft4a0df2e2007-06-08 13:46:39 -07001242}
Andy Whitcroft9c0ca6f2007-10-16 23:29:38 -07001243sub ctx_statement_level {
1244 my ($linenr, $remain, $off) = @_;
1245
1246 return ctx_block_get($linenr, $remain, 0, '(', ')', $off);
1247}
Andy Whitcroft4a0df2e2007-06-08 13:46:39 -07001248
1249sub ctx_locate_comment {
1250 my ($first_line, $end_line) = @_;
1251
1252 # Catch a comment on the end of the line itself.
Andy Whitcroftbeae6332008-07-23 21:28:59 -07001253 my ($current_comment) = ($rawlines[$end_line - 1] =~ m@.*(/\*.*\*/)\s*(?:\\\s*)?$@);
Andy Whitcroft4a0df2e2007-06-08 13:46:39 -07001254 return $current_comment if (defined $current_comment);
1255
1256 # Look through the context and try and figure out if there is a
1257 # comment.
1258 my $in_comment = 0;
1259 $current_comment = '';
1260 for (my $linenr = $first_line; $linenr < $end_line; $linenr++) {
Andy Whitcroft00df3442007-06-08 13:47:06 -07001261 my $line = $rawlines[$linenr - 1];
1262 #warn " $line\n";
Andy Whitcroft4a0df2e2007-06-08 13:46:39 -07001263 if ($linenr == $first_line and $line =~ m@^.\s*\*@) {
1264 $in_comment = 1;
1265 }
1266 if ($line =~ m@/\*@) {
1267 $in_comment = 1;
1268 }
1269 if (!$in_comment && $current_comment ne '') {
1270 $current_comment = '';
1271 }
1272 $current_comment .= $line . "\n" if ($in_comment);
1273 if ($line =~ m@\*/@) {
1274 $in_comment = 0;
1275 }
1276 }
1277
1278 chomp($current_comment);
1279 return($current_comment);
1280}
1281sub ctx_has_comment {
1282 my ($first_line, $end_line) = @_;
1283 my $cmt = ctx_locate_comment($first_line, $end_line);
1284
Andy Whitcroft00df3442007-06-08 13:47:06 -07001285 ##print "LINE: $rawlines[$end_line - 1 ]\n";
Andy Whitcroft4a0df2e2007-06-08 13:46:39 -07001286 ##print "CMMT: $cmt\n";
1287
1288 return ($cmt ne '');
1289}
1290
Andy Whitcroft4d001e42008-10-15 22:02:21 -07001291sub raw_line {
1292 my ($linenr, $cnt) = @_;
1293
1294 my $offset = $linenr - 1;
1295 $cnt++;
1296
1297 my $line;
1298 while ($cnt) {
1299 $line = $rawlines[$offset++];
1300 next if (defined($line) && $line =~ /^-/);
1301 $cnt--;
1302 }
1303
1304 return $line;
1305}
1306
Andy Whitcroft0a920b5b2007-06-01 00:46:48 -07001307sub cat_vet {
1308 my ($vet) = @_;
Andy Whitcroft9c0ca6f2007-10-16 23:29:38 -07001309 my ($res, $coded);
Andy Whitcroft0a920b5b2007-06-01 00:46:48 -07001310
Andy Whitcroft9c0ca6f2007-10-16 23:29:38 -07001311 $res = '';
Andy Whitcroft6c72ffa2007-10-18 03:05:08 -07001312 while ($vet =~ /([^[:cntrl:]]*)([[:cntrl:]]|$)/g) {
1313 $res .= $1;
1314 if ($2 ne '') {
1315 $coded = sprintf("^%c", unpack('C', $2) + 64);
1316 $res .= $coded;
1317 }
Andy Whitcroft9c0ca6f2007-10-16 23:29:38 -07001318 }
1319 $res =~ s/$/\$/;
Andy Whitcroft0a920b5b2007-06-01 00:46:48 -07001320
Andy Whitcroft9c0ca6f2007-10-16 23:29:38 -07001321 return $res;
Andy Whitcroft0a920b5b2007-06-01 00:46:48 -07001322}
1323
Andy Whitcroftc2fdda02008-02-08 04:20:54 -08001324my $av_preprocessor = 0;
Andy Whitcroftcf655042008-03-04 14:28:20 -08001325my $av_pending;
Andy Whitcroftc2fdda02008-02-08 04:20:54 -08001326my @av_paren_type;
Andy Whitcroft1f65f942008-07-23 21:29:10 -07001327my $av_pend_colon;
Andy Whitcroftc2fdda02008-02-08 04:20:54 -08001328
1329sub annotate_reset {
1330 $av_preprocessor = 0;
Andy Whitcroftcf655042008-03-04 14:28:20 -08001331 $av_pending = '_';
1332 @av_paren_type = ('E');
Andy Whitcroft1f65f942008-07-23 21:29:10 -07001333 $av_pend_colon = 'O';
Andy Whitcroftc2fdda02008-02-08 04:20:54 -08001334}
1335
Andy Whitcroft6c72ffa2007-10-18 03:05:08 -07001336sub annotate_values {
1337 my ($stream, $type) = @_;
1338
1339 my $res;
Andy Whitcroft1f65f942008-07-23 21:29:10 -07001340 my $var = '_' x length($stream);
Andy Whitcroft6c72ffa2007-10-18 03:05:08 -07001341 my $cur = $stream;
1342
Andy Whitcroftc2fdda02008-02-08 04:20:54 -08001343 print "$stream\n" if ($dbg_values > 1);
Andy Whitcroft6c72ffa2007-10-18 03:05:08 -07001344
Andy Whitcroft6c72ffa2007-10-18 03:05:08 -07001345 while (length($cur)) {
Andy Whitcroft773647a2008-03-28 14:15:58 -07001346 @av_paren_type = ('E') if ($#av_paren_type < 0);
Andy Whitcroftcf655042008-03-04 14:28:20 -08001347 print " <" . join('', @av_paren_type) .
Andy Whitcroft171ae1a2008-04-29 00:59:32 -07001348 "> <$type> <$av_pending>" if ($dbg_values > 1);
Andy Whitcroft6c72ffa2007-10-18 03:05:08 -07001349 if ($cur =~ /^(\s+)/o) {
Andy Whitcroftc2fdda02008-02-08 04:20:54 -08001350 print "WS($1)\n" if ($dbg_values > 1);
1351 if ($1 =~ /\n/ && $av_preprocessor) {
Andy Whitcroftcf655042008-03-04 14:28:20 -08001352 $type = pop(@av_paren_type);
Andy Whitcroftc2fdda02008-02-08 04:20:54 -08001353 $av_preprocessor = 0;
Andy Whitcroft6c72ffa2007-10-18 03:05:08 -07001354 }
1355
Florian Micklerc023e4732011-01-12 16:59:58 -08001356 } elsif ($cur =~ /^(\(\s*$Type\s*)\)/ && $av_pending eq '_') {
Andy Whitcroft9446ef52010-10-26 14:23:13 -07001357 print "CAST($1)\n" if ($dbg_values > 1);
1358 push(@av_paren_type, $type);
Andy Whitcroftaddcdce2012-01-10 15:10:11 -08001359 $type = 'c';
Andy Whitcroft9446ef52010-10-26 14:23:13 -07001360
Andy Whitcrofte91b6e22010-10-26 14:23:11 -07001361 } elsif ($cur =~ /^($Type)\s*(?:$Ident|,|\)|\(|\s*$)/) {
Andy Whitcroftc2fdda02008-02-08 04:20:54 -08001362 print "DECLARE($1)\n" if ($dbg_values > 1);
Andy Whitcroft6c72ffa2007-10-18 03:05:08 -07001363 $type = 'T';
1364
Andy Whitcroft389a2fe2008-07-23 21:29:05 -07001365 } elsif ($cur =~ /^($Modifier)\s*/) {
1366 print "MODIFIER($1)\n" if ($dbg_values > 1);
1367 $type = 'T';
1368
Andy Whitcroftc45dcab2008-06-05 22:46:01 -07001369 } elsif ($cur =~ /^(\#\s*define\s*$Ident)(\(?)/o) {
Andy Whitcroft171ae1a2008-04-29 00:59:32 -07001370 print "DEFINE($1,$2)\n" if ($dbg_values > 1);
Andy Whitcroftc2fdda02008-02-08 04:20:54 -08001371 $av_preprocessor = 1;
Andy Whitcroft171ae1a2008-04-29 00:59:32 -07001372 push(@av_paren_type, $type);
1373 if ($2 ne '') {
1374 $av_pending = 'N';
1375 }
1376 $type = 'E';
1377
Andy Whitcroftc45dcab2008-06-05 22:46:01 -07001378 } elsif ($cur =~ /^(\#\s*(?:undef\s*$Ident|include\b))/o) {
Andy Whitcroft171ae1a2008-04-29 00:59:32 -07001379 print "UNDEF($1)\n" if ($dbg_values > 1);
1380 $av_preprocessor = 1;
1381 push(@av_paren_type, $type);
Andy Whitcroft6c72ffa2007-10-18 03:05:08 -07001382
Andy Whitcroftc45dcab2008-06-05 22:46:01 -07001383 } elsif ($cur =~ /^(\#\s*(?:ifdef|ifndef|if))/o) {
Andy Whitcroftcf655042008-03-04 14:28:20 -08001384 print "PRE_START($1)\n" if ($dbg_values > 1);
Andy Whitcroftc2fdda02008-02-08 04:20:54 -08001385 $av_preprocessor = 1;
Andy Whitcroftcf655042008-03-04 14:28:20 -08001386
1387 push(@av_paren_type, $type);
1388 push(@av_paren_type, $type);
Andy Whitcroft171ae1a2008-04-29 00:59:32 -07001389 $type = 'E';
Andy Whitcroftcf655042008-03-04 14:28:20 -08001390
Andy Whitcroftc45dcab2008-06-05 22:46:01 -07001391 } elsif ($cur =~ /^(\#\s*(?:else|elif))/o) {
Andy Whitcroftcf655042008-03-04 14:28:20 -08001392 print "PRE_RESTART($1)\n" if ($dbg_values > 1);
1393 $av_preprocessor = 1;
1394
1395 push(@av_paren_type, $av_paren_type[$#av_paren_type]);
1396
Andy Whitcroft171ae1a2008-04-29 00:59:32 -07001397 $type = 'E';
Andy Whitcroftcf655042008-03-04 14:28:20 -08001398
Andy Whitcroftc45dcab2008-06-05 22:46:01 -07001399 } elsif ($cur =~ /^(\#\s*(?:endif))/o) {
Andy Whitcroftcf655042008-03-04 14:28:20 -08001400 print "PRE_END($1)\n" if ($dbg_values > 1);
1401
1402 $av_preprocessor = 1;
1403
1404 # Assume all arms of the conditional end as this
1405 # one does, and continue as if the #endif was not here.
1406 pop(@av_paren_type);
1407 push(@av_paren_type, $type);
Andy Whitcroft171ae1a2008-04-29 00:59:32 -07001408 $type = 'E';
Andy Whitcroft6c72ffa2007-10-18 03:05:08 -07001409
1410 } elsif ($cur =~ /^(\\\n)/o) {
Andy Whitcroftc2fdda02008-02-08 04:20:54 -08001411 print "PRECONT($1)\n" if ($dbg_values > 1);
Andy Whitcroft6c72ffa2007-10-18 03:05:08 -07001412
Andy Whitcroft171ae1a2008-04-29 00:59:32 -07001413 } elsif ($cur =~ /^(__attribute__)\s*\(?/o) {
1414 print "ATTR($1)\n" if ($dbg_values > 1);
1415 $av_pending = $type;
1416 $type = 'N';
1417
Andy Whitcroft6c72ffa2007-10-18 03:05:08 -07001418 } elsif ($cur =~ /^(sizeof)\s*(\()?/o) {
Andy Whitcroftc2fdda02008-02-08 04:20:54 -08001419 print "SIZEOF($1)\n" if ($dbg_values > 1);
Andy Whitcroft6c72ffa2007-10-18 03:05:08 -07001420 if (defined $2) {
Andy Whitcroftcf655042008-03-04 14:28:20 -08001421 $av_pending = 'V';
Andy Whitcroft6c72ffa2007-10-18 03:05:08 -07001422 }
1423 $type = 'N';
1424
Andy Whitcroft14b111c2008-10-15 22:02:16 -07001425 } elsif ($cur =~ /^(if|while|for)\b/o) {
Andy Whitcroftc2fdda02008-02-08 04:20:54 -08001426 print "COND($1)\n" if ($dbg_values > 1);
Andy Whitcroft14b111c2008-10-15 22:02:16 -07001427 $av_pending = 'E';
Andy Whitcroft6c72ffa2007-10-18 03:05:08 -07001428 $type = 'N';
1429
Andy Whitcroft1f65f942008-07-23 21:29:10 -07001430 } elsif ($cur =~/^(case)/o) {
1431 print "CASE($1)\n" if ($dbg_values > 1);
1432 $av_pend_colon = 'C';
1433 $type = 'N';
1434
Andy Whitcroft14b111c2008-10-15 22:02:16 -07001435 } elsif ($cur =~/^(return|else|goto|typeof|__typeof__)\b/o) {
Andy Whitcroftc2fdda02008-02-08 04:20:54 -08001436 print "KEYWORD($1)\n" if ($dbg_values > 1);
Andy Whitcroft6c72ffa2007-10-18 03:05:08 -07001437 $type = 'N';
1438
1439 } elsif ($cur =~ /^(\()/o) {
Andy Whitcroftc2fdda02008-02-08 04:20:54 -08001440 print "PAREN('$1')\n" if ($dbg_values > 1);
Andy Whitcroftcf655042008-03-04 14:28:20 -08001441 push(@av_paren_type, $av_pending);
1442 $av_pending = '_';
Andy Whitcroft6c72ffa2007-10-18 03:05:08 -07001443 $type = 'N';
1444
1445 } elsif ($cur =~ /^(\))/o) {
Andy Whitcroftcf655042008-03-04 14:28:20 -08001446 my $new_type = pop(@av_paren_type);
1447 if ($new_type ne '_') {
1448 $type = $new_type;
Andy Whitcroftc2fdda02008-02-08 04:20:54 -08001449 print "PAREN('$1') -> $type\n"
1450 if ($dbg_values > 1);
Andy Whitcroft6c72ffa2007-10-18 03:05:08 -07001451 } else {
Andy Whitcroftc2fdda02008-02-08 04:20:54 -08001452 print "PAREN('$1')\n" if ($dbg_values > 1);
Andy Whitcroft6c72ffa2007-10-18 03:05:08 -07001453 }
1454
Andy Whitcroftc8cb2ca2008-07-23 21:28:57 -07001455 } elsif ($cur =~ /^($Ident)\s*\(/o) {
Andy Whitcroftc2fdda02008-02-08 04:20:54 -08001456 print "FUNC($1)\n" if ($dbg_values > 1);
Andy Whitcroftc8cb2ca2008-07-23 21:28:57 -07001457 $type = 'V';
Andy Whitcroftcf655042008-03-04 14:28:20 -08001458 $av_pending = 'V';
Andy Whitcroft6c72ffa2007-10-18 03:05:08 -07001459
Andy Whitcroft8e761b02009-01-06 14:41:19 -08001460 } elsif ($cur =~ /^($Ident\s*):(?:\s*\d+\s*(,|=|;))?/) {
1461 if (defined $2 && $type eq 'C' || $type eq 'T') {
Andy Whitcroft1f65f942008-07-23 21:29:10 -07001462 $av_pend_colon = 'B';
Andy Whitcroft8e761b02009-01-06 14:41:19 -08001463 } elsif ($type eq 'E') {
1464 $av_pend_colon = 'L';
Andy Whitcroft1f65f942008-07-23 21:29:10 -07001465 }
1466 print "IDENT_COLON($1,$type>$av_pend_colon)\n" if ($dbg_values > 1);
1467 $type = 'V';
1468
Andy Whitcroft6c72ffa2007-10-18 03:05:08 -07001469 } elsif ($cur =~ /^($Ident|$Constant)/o) {
Andy Whitcroftc2fdda02008-02-08 04:20:54 -08001470 print "IDENT($1)\n" if ($dbg_values > 1);
Andy Whitcroft6c72ffa2007-10-18 03:05:08 -07001471 $type = 'V';
1472
1473 } elsif ($cur =~ /^($Assignment)/o) {
Andy Whitcroftc2fdda02008-02-08 04:20:54 -08001474 print "ASSIGN($1)\n" if ($dbg_values > 1);
Andy Whitcroft6c72ffa2007-10-18 03:05:08 -07001475 $type = 'N';
1476
Andy Whitcroftcf655042008-03-04 14:28:20 -08001477 } elsif ($cur =~/^(;|{|})/) {
Andy Whitcroftc2fdda02008-02-08 04:20:54 -08001478 print "END($1)\n" if ($dbg_values > 1);
Andy Whitcroft13214ad2008-02-08 04:22:03 -08001479 $type = 'E';
Andy Whitcroft1f65f942008-07-23 21:29:10 -07001480 $av_pend_colon = 'O';
Andy Whitcroft13214ad2008-02-08 04:22:03 -08001481
Andy Whitcroft8e761b02009-01-06 14:41:19 -08001482 } elsif ($cur =~/^(,)/) {
1483 print "COMMA($1)\n" if ($dbg_values > 1);
1484 $type = 'C';
1485
Andy Whitcroft1f65f942008-07-23 21:29:10 -07001486 } elsif ($cur =~ /^(\?)/o) {
1487 print "QUESTION($1)\n" if ($dbg_values > 1);
1488 $type = 'N';
1489
1490 } elsif ($cur =~ /^(:)/o) {
1491 print "COLON($1,$av_pend_colon)\n" if ($dbg_values > 1);
1492
1493 substr($var, length($res), 1, $av_pend_colon);
1494 if ($av_pend_colon eq 'C' || $av_pend_colon eq 'L') {
1495 $type = 'E';
1496 } else {
1497 $type = 'N';
1498 }
1499 $av_pend_colon = 'O';
1500
Andy Whitcroft8e761b02009-01-06 14:41:19 -08001501 } elsif ($cur =~ /^(\[)/o) {
Andy Whitcroft13214ad2008-02-08 04:22:03 -08001502 print "CLOSE($1)\n" if ($dbg_values > 1);
Andy Whitcroft6c72ffa2007-10-18 03:05:08 -07001503 $type = 'N';
1504
Andy Whitcroft0d413862008-10-15 22:02:16 -07001505 } elsif ($cur =~ /^(-(?![->])|\+(?!\+)|\*|\&\&|\&)/o) {
Andy Whitcroft74048ed2008-07-23 21:29:10 -07001506 my $variant;
1507
1508 print "OPV($1)\n" if ($dbg_values > 1);
1509 if ($type eq 'V') {
1510 $variant = 'B';
1511 } else {
1512 $variant = 'U';
1513 }
1514
1515 substr($var, length($res), 1, $variant);
1516 $type = 'N';
1517
Andy Whitcroft6c72ffa2007-10-18 03:05:08 -07001518 } elsif ($cur =~ /^($Operators)/o) {
Andy Whitcroftc2fdda02008-02-08 04:20:54 -08001519 print "OP($1)\n" if ($dbg_values > 1);
Andy Whitcroft6c72ffa2007-10-18 03:05:08 -07001520 if ($1 ne '++' && $1 ne '--') {
1521 $type = 'N';
1522 }
1523
1524 } elsif ($cur =~ /(^.)/o) {
Andy Whitcroftc2fdda02008-02-08 04:20:54 -08001525 print "C($1)\n" if ($dbg_values > 1);
Andy Whitcroft6c72ffa2007-10-18 03:05:08 -07001526 }
1527 if (defined $1) {
1528 $cur = substr($cur, length($1));
1529 $res .= $type x length($1);
1530 }
1531 }
1532
Andy Whitcroft1f65f942008-07-23 21:29:10 -07001533 return ($res, $var);
Andy Whitcroft6c72ffa2007-10-18 03:05:08 -07001534}
1535
Andy Whitcroft8905a672007-11-28 16:21:06 -08001536sub possible {
Andy Whitcroft13214ad2008-02-08 04:22:03 -08001537 my ($possible, $line) = @_;
Andy Whitcroft9a974fd2009-10-26 16:50:12 -07001538 my $notPermitted = qr{(?:
Andy Whitcroft0776e592008-10-15 22:02:29 -07001539 ^(?:
1540 $Modifier|
1541 $Storage|
1542 $Type|
Andy Whitcroft9a974fd2009-10-26 16:50:12 -07001543 DEFINE_\S+
1544 )$|
1545 ^(?:
Andy Whitcroft0776e592008-10-15 22:02:29 -07001546 goto|
1547 return|
1548 case|
1549 else|
1550 asm|__asm__|
Andy Whitcroft89a88352012-01-10 15:10:00 -08001551 do|
1552 \#|
1553 \#\#|
Andy Whitcroft9a974fd2009-10-26 16:50:12 -07001554 )(?:\s|$)|
Andy Whitcroft0776e592008-10-15 22:02:29 -07001555 ^(?:typedef|struct|enum)\b
Andy Whitcroft9a974fd2009-10-26 16:50:12 -07001556 )}x;
1557 warn "CHECK<$possible> ($line)\n" if ($dbg_possible > 2);
1558 if ($possible !~ $notPermitted) {
Andy Whitcroftc45dcab2008-06-05 22:46:01 -07001559 # Check for modifiers.
1560 $possible =~ s/\s*$Storage\s*//g;
1561 $possible =~ s/\s*$Sparse\s*//g;
1562 if ($possible =~ /^\s*$/) {
1563
1564 } elsif ($possible =~ /\s/) {
1565 $possible =~ s/\s*$Type\s*//g;
Andy Whitcroftd2506582008-07-23 21:29:09 -07001566 for my $modifier (split(' ', $possible)) {
Andy Whitcroft9a974fd2009-10-26 16:50:12 -07001567 if ($modifier !~ $notPermitted) {
1568 warn "MODIFIER: $modifier ($possible) ($line)\n" if ($dbg_possible);
1569 push(@modifierList, $modifier);
1570 }
Andy Whitcroftd2506582008-07-23 21:29:09 -07001571 }
Andy Whitcroftc45dcab2008-06-05 22:46:01 -07001572
1573 } else {
1574 warn "POSSIBLE: $possible ($line)\n" if ($dbg_possible);
1575 push(@typeList, $possible);
1576 }
Andy Whitcroft8905a672007-11-28 16:21:06 -08001577 build_types();
Andy Whitcroft0776e592008-10-15 22:02:29 -07001578 } else {
1579 warn "NOTPOSS: $possible ($line)\n" if ($dbg_possible > 1);
Andy Whitcroft8905a672007-11-28 16:21:06 -08001580 }
1581}
1582
Andy Whitcroft6c72ffa2007-10-18 03:05:08 -07001583my $prefix = '';
1584
Joe Perches000d1cc12011-07-25 17:13:25 -07001585sub show_type {
Joe Perchescbec18a2014-04-03 14:49:19 -07001586 my ($type) = @_;
Joe Perches91bfe482013-09-11 14:23:59 -07001587
Joe Perchescbec18a2014-04-03 14:49:19 -07001588 return defined $use_type{$type} if (scalar keys %use_type > 0);
1589
1590 return !defined $ignore_type{$type};
Joe Perches000d1cc12011-07-25 17:13:25 -07001591}
1592
Andy Whitcroftf0a594c2007-07-19 01:48:34 -07001593sub report {
Joe Perchescbec18a2014-04-03 14:49:19 -07001594 my ($level, $type, $msg) = @_;
1595
1596 if (!show_type($type) ||
1597 (defined $tst_only && $msg !~ /\Q$tst_only\E/)) {
Andy Whitcroft773647a2008-03-28 14:15:58 -07001598 return 0;
1599 }
Joe Perches000d1cc12011-07-25 17:13:25 -07001600 my $line;
1601 if ($show_types) {
Joe Perchescbec18a2014-04-03 14:49:19 -07001602 $line = "$prefix$level:$type: $msg\n";
Joe Perches000d1cc12011-07-25 17:13:25 -07001603 } else {
Joe Perchescbec18a2014-04-03 14:49:19 -07001604 $line = "$prefix$level: $msg\n";
Joe Perches000d1cc12011-07-25 17:13:25 -07001605 }
Andy Whitcroft8905a672007-11-28 16:21:06 -08001606 $line = (split('\n', $line))[0] . "\n" if ($terse);
1607
Andy Whitcroft13214ad2008-02-08 04:22:03 -08001608 push(our @report, $line);
Andy Whitcroft773647a2008-03-28 14:15:58 -07001609
1610 return 1;
Andy Whitcroftf0a594c2007-07-19 01:48:34 -07001611}
Joe Perchescbec18a2014-04-03 14:49:19 -07001612
Andy Whitcroftf0a594c2007-07-19 01:48:34 -07001613sub report_dump {
Andy Whitcroft13214ad2008-02-08 04:22:03 -08001614 our @report;
Andy Whitcroftf0a594c2007-07-19 01:48:34 -07001615}
Joe Perches000d1cc12011-07-25 17:13:25 -07001616
Joe Perchesd752fcc2014-08-06 16:11:05 -07001617sub fixup_current_range {
1618 my ($lineRef, $offset, $length) = @_;
1619
1620 if ($$lineRef =~ /^\@\@ -\d+,\d+ \+(\d+),(\d+) \@\@/) {
1621 my $o = $1;
1622 my $l = $2;
1623 my $no = $o + $offset;
1624 my $nl = $l + $length;
1625 $$lineRef =~ s/\+$o,$l \@\@/\+$no,$nl \@\@/;
1626 }
1627}
1628
1629sub fix_inserted_deleted_lines {
1630 my ($linesRef, $insertedRef, $deletedRef) = @_;
1631
1632 my $range_last_linenr = 0;
1633 my $delta_offset = 0;
1634
1635 my $old_linenr = 0;
1636 my $new_linenr = 0;
1637
1638 my $next_insert = 0;
1639 my $next_delete = 0;
1640
1641 my @lines = ();
1642
1643 my $inserted = @{$insertedRef}[$next_insert++];
1644 my $deleted = @{$deletedRef}[$next_delete++];
1645
1646 foreach my $old_line (@{$linesRef}) {
1647 my $save_line = 1;
1648 my $line = $old_line; #don't modify the array
1649 if ($line =~ /^(?:\+\+\+\|\-\-\-)\s+\S+/) { #new filename
1650 $delta_offset = 0;
1651 } elsif ($line =~ /^\@\@ -\d+,\d+ \+\d+,\d+ \@\@/) { #new hunk
1652 $range_last_linenr = $new_linenr;
1653 fixup_current_range(\$line, $delta_offset, 0);
1654 }
1655
1656 while (defined($deleted) && ${$deleted}{'LINENR'} == $old_linenr) {
1657 $deleted = @{$deletedRef}[$next_delete++];
1658 $save_line = 0;
1659 fixup_current_range(\$lines[$range_last_linenr], $delta_offset--, -1);
1660 }
1661
1662 while (defined($inserted) && ${$inserted}{'LINENR'} == $old_linenr) {
1663 push(@lines, ${$inserted}{'LINE'});
1664 $inserted = @{$insertedRef}[$next_insert++];
1665 $new_linenr++;
1666 fixup_current_range(\$lines[$range_last_linenr], $delta_offset++, 1);
1667 }
1668
1669 if ($save_line) {
1670 push(@lines, $line);
1671 $new_linenr++;
1672 }
1673
1674 $old_linenr++;
1675 }
1676
1677 return @lines;
1678}
1679
Joe Perchesf2d7e4d2014-08-06 16:11:07 -07001680sub fix_insert_line {
1681 my ($linenr, $line) = @_;
1682
1683 my $inserted = {
1684 LINENR => $linenr,
1685 LINE => $line,
1686 };
1687 push(@fixed_inserted, $inserted);
1688}
1689
1690sub fix_delete_line {
1691 my ($linenr, $line) = @_;
1692
1693 my $deleted = {
1694 LINENR => $linenr,
1695 LINE => $line,
1696 };
1697
1698 push(@fixed_deleted, $deleted);
1699}
1700
Andy Whitcroftde7d4f02007-07-15 23:37:22 -07001701sub ERROR {
Joe Perchescbec18a2014-04-03 14:49:19 -07001702 my ($type, $msg) = @_;
1703
1704 if (report("ERROR", $type, $msg)) {
Andy Whitcroft773647a2008-03-28 14:15:58 -07001705 our $clean = 0;
1706 our $cnt_error++;
Joe Perches3705ce52013-07-03 15:05:31 -07001707 return 1;
Andy Whitcroft773647a2008-03-28 14:15:58 -07001708 }
Joe Perches3705ce52013-07-03 15:05:31 -07001709 return 0;
Andy Whitcroftde7d4f02007-07-15 23:37:22 -07001710}
1711sub WARN {
Joe Perchescbec18a2014-04-03 14:49:19 -07001712 my ($type, $msg) = @_;
1713
1714 if (report("WARNING", $type, $msg)) {
Andy Whitcroft773647a2008-03-28 14:15:58 -07001715 our $clean = 0;
1716 our $cnt_warn++;
Joe Perches3705ce52013-07-03 15:05:31 -07001717 return 1;
Andy Whitcroft773647a2008-03-28 14:15:58 -07001718 }
Joe Perches3705ce52013-07-03 15:05:31 -07001719 return 0;
Andy Whitcroftde7d4f02007-07-15 23:37:22 -07001720}
1721sub CHK {
Joe Perchescbec18a2014-04-03 14:49:19 -07001722 my ($type, $msg) = @_;
1723
1724 if ($check && report("CHECK", $type, $msg)) {
Andy Whitcroft6c72ffa2007-10-18 03:05:08 -07001725 our $clean = 0;
1726 our $cnt_chk++;
Joe Perches3705ce52013-07-03 15:05:31 -07001727 return 1;
Andy Whitcroft6c72ffa2007-10-18 03:05:08 -07001728 }
Joe Perches3705ce52013-07-03 15:05:31 -07001729 return 0;
Andy Whitcroftde7d4f02007-07-15 23:37:22 -07001730}
1731
Andy Whitcroft6ecd9672008-10-15 22:02:21 -07001732sub check_absolute_file {
1733 my ($absolute, $herecurr) = @_;
1734 my $file = $absolute;
1735
1736 ##print "absolute<$absolute>\n";
1737
1738 # See if any suffix of this path is a path within the tree.
1739 while ($file =~ s@^[^/]*/@@) {
1740 if (-f "$root/$file") {
1741 ##print "file<$file>\n";
1742 last;
1743 }
1744 }
1745 if (! -f _) {
1746 return 0;
1747 }
1748
1749 # It is, so see if the prefix is acceptable.
1750 my $prefix = $absolute;
1751 substr($prefix, -length($file)) = '';
1752
1753 ##print "prefix<$prefix>\n";
1754 if ($prefix ne ".../") {
Joe Perches000d1cc12011-07-25 17:13:25 -07001755 WARN("USE_RELATIVE_PATH",
1756 "use relative pathname instead of absolute in changelog text\n" . $herecurr);
Andy Whitcroft6ecd9672008-10-15 22:02:21 -07001757 }
1758}
1759
Joe Perches3705ce52013-07-03 15:05:31 -07001760sub trim {
1761 my ($string) = @_;
1762
Joe Perchesb34c6482013-09-11 14:24:01 -07001763 $string =~ s/^\s+|\s+$//g;
1764
1765 return $string;
1766}
1767
1768sub ltrim {
1769 my ($string) = @_;
1770
1771 $string =~ s/^\s+//;
1772
1773 return $string;
1774}
1775
1776sub rtrim {
1777 my ($string) = @_;
1778
1779 $string =~ s/\s+$//;
Joe Perches3705ce52013-07-03 15:05:31 -07001780
1781 return $string;
1782}
1783
Joe Perches52ea8502013-11-12 15:10:09 -08001784sub string_find_replace {
1785 my ($string, $find, $replace) = @_;
1786
1787 $string =~ s/$find/$replace/g;
1788
1789 return $string;
1790}
1791
Joe Perches3705ce52013-07-03 15:05:31 -07001792sub tabify {
1793 my ($leading) = @_;
1794
1795 my $source_indent = 8;
1796 my $max_spaces_before_tab = $source_indent - 1;
1797 my $spaces_to_tab = " " x $source_indent;
1798
1799 #convert leading spaces to tabs
1800 1 while $leading =~ s@^([\t]*)$spaces_to_tab@$1\t@g;
1801 #Remove spaces before a tab
1802 1 while $leading =~ s@^([\t]*)( {1,$max_spaces_before_tab})\t@$1\t@g;
1803
1804 return "$leading";
1805}
1806
Joe Perchesd1fe9c02012-03-23 15:02:16 -07001807sub pos_last_openparen {
1808 my ($line) = @_;
1809
1810 my $pos = 0;
1811
1812 my $opens = $line =~ tr/\(/\(/;
1813 my $closes = $line =~ tr/\)/\)/;
1814
1815 my $last_openparen = 0;
1816
1817 if (($opens == 0) || ($closes >= $opens)) {
1818 return -1;
1819 }
1820
1821 my $len = length($line);
1822
1823 for ($pos = 0; $pos < $len; $pos++) {
1824 my $string = substr($line, $pos);
1825 if ($string =~ /^($FuncArg|$balanced_parens)/) {
1826 $pos += length($1) - 1;
1827 } elsif (substr($line, $pos, 1) eq '(') {
1828 $last_openparen = $pos;
1829 } elsif (index($string, '(') == -1) {
1830 last;
1831 }
1832 }
1833
Joe Perches91cb5192014-04-03 14:49:32 -07001834 return length(expand_tabs(substr($line, 0, $last_openparen))) + 1;
Joe Perchesd1fe9c02012-03-23 15:02:16 -07001835}
1836
Andy Whitcroft0a920b5b2007-06-01 00:46:48 -07001837sub process {
1838 my $filename = shift;
Andy Whitcroft0a920b5b2007-06-01 00:46:48 -07001839
1840 my $linenr=0;
1841 my $prevline="";
Andy Whitcroftc2fdda02008-02-08 04:20:54 -08001842 my $prevrawline="";
Andy Whitcroft0a920b5b2007-06-01 00:46:48 -07001843 my $stashline="";
Andy Whitcroftc2fdda02008-02-08 04:20:54 -08001844 my $stashrawline="";
Andy Whitcroft0a920b5b2007-06-01 00:46:48 -07001845
Andy Whitcroft4a0df2e2007-06-08 13:46:39 -07001846 my $length;
Andy Whitcroft0a920b5b2007-06-01 00:46:48 -07001847 my $indent;
1848 my $previndent=0;
1849 my $stashindent=0;
1850
Andy Whitcroftde7d4f02007-07-15 23:37:22 -07001851 our $clean = 1;
Andy Whitcroft0a920b5b2007-06-01 00:46:48 -07001852 my $signoff = 0;
1853 my $is_patch = 0;
1854
Joe Perches29ee1b02014-08-06 16:10:35 -07001855 my $in_header_lines = $file ? 0 : 1;
Joe Perches15662b32011-10-31 17:13:12 -07001856 my $in_commit_log = 0; #Scanning lines before patch
Joe Perches13f19372014-08-06 16:10:59 -07001857 my $reported_maintainer_file = 0;
Pasi Savanainenfa64205d2012-10-04 17:13:29 -07001858 my $non_utf8_charset = 0;
1859
Joe Perches365dd4e2014-08-06 16:10:42 -07001860 my $last_blank_line = 0;
Joe Perches5e4f6ba2014-12-10 15:52:05 -08001861 my $last_coalesced_string_linenr = -1;
Joe Perches365dd4e2014-08-06 16:10:42 -07001862
Andy Whitcroft13214ad2008-02-08 04:22:03 -08001863 our @report = ();
Andy Whitcroft6c72ffa2007-10-18 03:05:08 -07001864 our $cnt_lines = 0;
1865 our $cnt_error = 0;
1866 our $cnt_warn = 0;
1867 our $cnt_chk = 0;
1868
Andy Whitcroft0a920b5b2007-06-01 00:46:48 -07001869 # Trace the real file/line as we go.
1870 my $realfile = '';
1871 my $realline = 0;
1872 my $realcnt = 0;
1873 my $here = '';
1874 my $in_comment = 0;
Andy Whitcroftc2fdda02008-02-08 04:20:54 -08001875 my $comment_edge = 0;
Andy Whitcroft0a920b5b2007-06-01 00:46:48 -07001876 my $first_line = 0;
Wolfram Sang1e855722009-01-06 14:41:24 -08001877 my $p1_prefix = '';
Andy Whitcroft0a920b5b2007-06-01 00:46:48 -07001878
Andy Whitcroft13214ad2008-02-08 04:22:03 -08001879 my $prev_values = 'E';
1880
1881 # suppression flags
Andy Whitcroft773647a2008-03-28 14:15:58 -07001882 my %suppress_ifbraces;
Andy Whitcroft170d3a22008-10-15 22:02:30 -07001883 my %suppress_whiletrailers;
Andy Whitcroft2b474a12009-10-26 16:50:16 -07001884 my %suppress_export;
Andy Whitcroft3e469cd2012-01-10 15:10:01 -08001885 my $suppress_statement = 0;
Andy Whitcroft653d4872007-06-23 17:16:34 -07001886
Joe Perches7e51f192013-09-11 14:23:57 -07001887 my %signatures = ();
Joe Perches323c1262012-12-17 16:02:07 -08001888
Andy Whitcroftc2fdda02008-02-08 04:20:54 -08001889 # Pre-scan the patch sanitizing the lines.
Andy Whitcroftde7d4f02007-07-15 23:37:22 -07001890 # Pre-scan the patch looking for any __setup documentation.
Andy Whitcroftc2fdda02008-02-08 04:20:54 -08001891 #
Andy Whitcroftde7d4f02007-07-15 23:37:22 -07001892 my @setup_docs = ();
1893 my $setup_docs = 0;
Andy Whitcroft773647a2008-03-28 14:15:58 -07001894
Joe Perchesd8b07712013-11-12 15:10:06 -08001895 my $camelcase_file_seeded = 0;
1896
Andy Whitcroft773647a2008-03-28 14:15:58 -07001897 sanitise_line_reset();
Andy Whitcroftc2fdda02008-02-08 04:20:54 -08001898 my $line;
1899 foreach my $rawline (@rawlines) {
Andy Whitcroft773647a2008-03-28 14:15:58 -07001900 $linenr++;
1901 $line = $rawline;
Andy Whitcroftc2fdda02008-02-08 04:20:54 -08001902
Joe Perches3705ce52013-07-03 15:05:31 -07001903 push(@fixed, $rawline) if ($fix);
1904
Andy Whitcroft773647a2008-03-28 14:15:58 -07001905 if ($rawline=~/^\+\+\+\s+(\S+)/) {
Andy Whitcroftde7d4f02007-07-15 23:37:22 -07001906 $setup_docs = 0;
1907 if ($1 =~ m@Documentation/kernel-parameters.txt$@) {
1908 $setup_docs = 1;
1909 }
Andy Whitcroft773647a2008-03-28 14:15:58 -07001910 #next;
Andy Whitcroftde7d4f02007-07-15 23:37:22 -07001911 }
Andy Whitcroft773647a2008-03-28 14:15:58 -07001912 if ($rawline=~/^\@\@ -\d+(?:,\d+)? \+(\d+)(,(\d+))? \@\@/) {
1913 $realline=$1-1;
1914 if (defined $2) {
1915 $realcnt=$3+1;
1916 } else {
1917 $realcnt=1+1;
1918 }
Andy Whitcroftc45dcab2008-06-05 22:46:01 -07001919 $in_comment = 0;
Andy Whitcroft773647a2008-03-28 14:15:58 -07001920
1921 # Guestimate if this is a continuing comment. Run
1922 # the context looking for a comment "edge". If this
1923 # edge is a close comment then we must be in a comment
1924 # at context start.
1925 my $edge;
Andy Whitcroft01fa9142008-10-15 22:02:19 -07001926 my $cnt = $realcnt;
1927 for (my $ln = $linenr + 1; $cnt > 0; $ln++) {
1928 next if (defined $rawlines[$ln - 1] &&
1929 $rawlines[$ln - 1] =~ /^-/);
1930 $cnt--;
1931 #print "RAW<$rawlines[$ln - 1]>\n";
Andy Whitcroft721c1cb2009-01-06 14:41:16 -08001932 last if (!defined $rawlines[$ln - 1]);
Andy Whitcroftfae17da2009-01-06 14:41:20 -08001933 if ($rawlines[$ln - 1] =~ m@(/\*|\*/)@ &&
1934 $rawlines[$ln - 1] !~ m@"[^"]*(?:/\*|\*/)[^"]*"@) {
1935 ($edge) = $1;
1936 last;
1937 }
Andy Whitcroft773647a2008-03-28 14:15:58 -07001938 }
1939 if (defined $edge && $edge eq '*/') {
1940 $in_comment = 1;
1941 }
1942
1943 # Guestimate if this is a continuing comment. If this
1944 # is the start of a diff block and this line starts
1945 # ' *' then it is very likely a comment.
1946 if (!defined $edge &&
Andy Whitcroft83242e02009-01-06 14:41:17 -08001947 $rawlines[$linenr] =~ m@^.\s*(?:\*\*+| \*)(?:\s|$)@)
Andy Whitcroft773647a2008-03-28 14:15:58 -07001948 {
1949 $in_comment = 1;
1950 }
1951
1952 ##print "COMMENT:$in_comment edge<$edge> $rawline\n";
1953 sanitise_line_reset($in_comment);
1954
Andy Whitcroft171ae1a2008-04-29 00:59:32 -07001955 } elsif ($realcnt && $rawline =~ /^(?:\+| |$)/) {
Andy Whitcroft773647a2008-03-28 14:15:58 -07001956 # Standardise the strings and chars within the input to
Andy Whitcroft171ae1a2008-04-29 00:59:32 -07001957 # simplify matching -- only bother with positive lines.
Andy Whitcroft773647a2008-03-28 14:15:58 -07001958 $line = sanitise_line($rawline);
1959 }
1960 push(@lines, $line);
1961
1962 if ($realcnt > 1) {
1963 $realcnt-- if ($line =~ /^(?:\+| |$)/);
1964 } else {
1965 $realcnt = 0;
1966 }
1967
1968 #print "==>$rawline\n";
1969 #print "-->$line\n";
Andy Whitcroftde7d4f02007-07-15 23:37:22 -07001970
1971 if ($setup_docs && $line =~ /^\+/) {
1972 push(@setup_docs, $line);
1973 }
1974 }
1975
Andy Whitcroft6c72ffa2007-10-18 03:05:08 -07001976 $prefix = '';
1977
Andy Whitcroft773647a2008-03-28 14:15:58 -07001978 $realcnt = 0;
1979 $linenr = 0;
Joe Perches194f66f2014-08-06 16:11:03 -07001980 $fixlinenr = -1;
Andy Whitcroft0a920b5b2007-06-01 00:46:48 -07001981 foreach my $line (@lines) {
1982 $linenr++;
Joe Perches194f66f2014-08-06 16:11:03 -07001983 $fixlinenr++;
Joe Perches1b5539b2013-09-11 14:24:03 -07001984 my $sline = $line; #copy of $line
1985 $sline =~ s/$;/ /g; #with comments as spaces
Andy Whitcroft0a920b5b2007-06-01 00:46:48 -07001986
Andy Whitcroftc2fdda02008-02-08 04:20:54 -08001987 my $rawline = $rawlines[$linenr - 1];
Andy Whitcroft6c72ffa2007-10-18 03:05:08 -07001988
Andy Whitcroft0a920b5b2007-06-01 00:46:48 -07001989#extract the line range in the file after the patch is applied
Andy Whitcroft6c72ffa2007-10-18 03:05:08 -07001990 if ($line=~/^\@\@ -\d+(?:,\d+)? \+(\d+)(,(\d+))? \@\@/) {
Andy Whitcroft0a920b5b2007-06-01 00:46:48 -07001991 $is_patch = 1;
Andy Whitcroft4a0df2e2007-06-08 13:46:39 -07001992 $first_line = $linenr + 1;
Andy Whitcroft0a920b5b2007-06-01 00:46:48 -07001993 $realline=$1-1;
1994 if (defined $2) {
1995 $realcnt=$3+1;
1996 } else {
1997 $realcnt=1+1;
1998 }
Andy Whitcroftc2fdda02008-02-08 04:20:54 -08001999 annotate_reset();
Andy Whitcroft13214ad2008-02-08 04:22:03 -08002000 $prev_values = 'E';
2001
Andy Whitcroft773647a2008-03-28 14:15:58 -07002002 %suppress_ifbraces = ();
Andy Whitcroft170d3a22008-10-15 22:02:30 -07002003 %suppress_whiletrailers = ();
Andy Whitcroft2b474a12009-10-26 16:50:16 -07002004 %suppress_export = ();
Andy Whitcroft3e469cd2012-01-10 15:10:01 -08002005 $suppress_statement = 0;
Andy Whitcroft0a920b5b2007-06-01 00:46:48 -07002006 next;
Andy Whitcroft0a920b5b2007-06-01 00:46:48 -07002007
Andy Whitcroft4a0df2e2007-06-08 13:46:39 -07002008# track the line number as we move through the hunk, note that
2009# new versions of GNU diff omit the leading space on completely
2010# blank context lines so we need to count that too.
Andy Whitcroft773647a2008-03-28 14:15:58 -07002011 } elsif ($line =~ /^( |\+|$)/) {
Andy Whitcroft0a920b5b2007-06-01 00:46:48 -07002012 $realline++;
Andy Whitcroftd8aaf122007-06-23 17:16:44 -07002013 $realcnt-- if ($realcnt != 0);
Andy Whitcroft0a920b5b2007-06-01 00:46:48 -07002014
Andy Whitcroft4a0df2e2007-06-08 13:46:39 -07002015 # Measure the line length and indent.
Andy Whitcroftc2fdda02008-02-08 04:20:54 -08002016 ($length, $indent) = line_stats($rawline);
Andy Whitcroft0a920b5b2007-06-01 00:46:48 -07002017
2018 # Track the previous line.
2019 ($prevline, $stashline) = ($stashline, $line);
2020 ($previndent, $stashindent) = ($stashindent, $indent);
Andy Whitcroftc2fdda02008-02-08 04:20:54 -08002021 ($prevrawline, $stashrawline) = ($stashrawline, $rawline);
2022
Andy Whitcroft773647a2008-03-28 14:15:58 -07002023 #warn "line<$line>\n";
Andy Whitcroft6c72ffa2007-10-18 03:05:08 -07002024
Andy Whitcroftd8aaf122007-06-23 17:16:44 -07002025 } elsif ($realcnt == 1) {
2026 $realcnt--;
Andy Whitcroft0a920b5b2007-06-01 00:46:48 -07002027 }
2028
Andy Whitcroftcc77cdc2009-10-26 16:50:13 -07002029 my $hunk_line = ($realcnt != 0);
2030
Andy Whitcroft0a920b5b2007-06-01 00:46:48 -07002031#make up the handle for any error we report on this line
Andy Whitcroft773647a2008-03-28 14:15:58 -07002032 $prefix = "$filename:$realline: " if ($emacs && $file);
2033 $prefix = "$filename:$linenr: " if ($emacs && !$file);
2034
Andy Whitcroft6c72ffa2007-10-18 03:05:08 -07002035 $here = "#$linenr: " if (!$file);
2036 $here = "#$realline: " if ($file);
Andy Whitcroft773647a2008-03-28 14:15:58 -07002037
Joe Perches2ac73b42014-06-04 16:12:05 -07002038 my $found_file = 0;
Andy Whitcroft773647a2008-03-28 14:15:58 -07002039 # extract the filename as it passes
Rabin Vincent3bf9a002010-10-26 14:23:16 -07002040 if ($line =~ /^diff --git.*?(\S+)$/) {
2041 $realfile = $1;
Joe Perches2b7ab452013-11-12 15:10:14 -08002042 $realfile =~ s@^([^/]*)/@@ if (!$file);
Joe Perches270c49a2012-01-10 15:09:50 -08002043 $in_commit_log = 0;
Joe Perches2ac73b42014-06-04 16:12:05 -07002044 $found_file = 1;
Rabin Vincent3bf9a002010-10-26 14:23:16 -07002045 } elsif ($line =~ /^\+\+\+\s+(\S+)/) {
Andy Whitcroft773647a2008-03-28 14:15:58 -07002046 $realfile = $1;
Joe Perches2b7ab452013-11-12 15:10:14 -08002047 $realfile =~ s@^([^/]*)/@@ if (!$file);
Joe Perches270c49a2012-01-10 15:09:50 -08002048 $in_commit_log = 0;
Wolfram Sang1e855722009-01-06 14:41:24 -08002049
2050 $p1_prefix = $1;
Andy Whitcrofte2f7aa42009-02-27 14:03:06 -08002051 if (!$file && $tree && $p1_prefix ne '' &&
2052 -e "$root/$p1_prefix") {
Joe Perches000d1cc12011-07-25 17:13:25 -07002053 WARN("PATCH_PREFIX",
2054 "patch prefix '$p1_prefix' exists, appears to be a -p0 patch\n");
Wolfram Sang1e855722009-01-06 14:41:24 -08002055 }
Andy Whitcroft773647a2008-03-28 14:15:58 -07002056
Andy Whitcroftc1ab3322008-10-15 22:02:20 -07002057 if ($realfile =~ m@^include/asm/@) {
Joe Perches000d1cc12011-07-25 17:13:25 -07002058 ERROR("MODIFIED_INCLUDE_ASM",
2059 "do not modify files in include/asm, change architecture specific files in include/asm-<architecture>\n" . "$here$rawline\n");
Andy Whitcroft773647a2008-03-28 14:15:58 -07002060 }
Joe Perches2ac73b42014-06-04 16:12:05 -07002061 $found_file = 1;
2062 }
2063
2064 if ($found_file) {
2065 if ($realfile =~ m@^(drivers/net/|net/)@) {
2066 $check = 1;
2067 } else {
2068 $check = $check_orig;
2069 }
Andy Whitcroft773647a2008-03-28 14:15:58 -07002070 next;
2071 }
2072
Randy Dunlap389834b2007-06-08 13:47:03 -07002073 $here .= "FILE: $realfile:$realline:" if ($realcnt != 0);
Andy Whitcroft0a920b5b2007-06-01 00:46:48 -07002074
Andy Whitcroftc2fdda02008-02-08 04:20:54 -08002075 my $hereline = "$here\n$rawline\n";
2076 my $herecurr = "$here\n$rawline\n";
2077 my $hereprev = "$here\n$prevrawline\n$rawline\n";
Andy Whitcroft0a920b5b2007-06-01 00:46:48 -07002078
Andy Whitcroft6c72ffa2007-10-18 03:05:08 -07002079 $cnt_lines++ if ($realcnt != 0);
2080
Rabin Vincent3bf9a002010-10-26 14:23:16 -07002081# Check for incorrect file permissions
2082 if ($line =~ /^new (file )?mode.*[7531]\d{0,2}$/) {
2083 my $permhere = $here . "FILE: $realfile\n";
Joe Perches04db4d22013-04-29 16:18:14 -07002084 if ($realfile !~ m@scripts/@ &&
2085 $realfile !~ /\.(py|pl|awk|sh)$/) {
Joe Perches000d1cc12011-07-25 17:13:25 -07002086 ERROR("EXECUTE_PERMISSIONS",
2087 "do not set execute permissions for source files\n" . $permhere);
Rabin Vincent3bf9a002010-10-26 14:23:16 -07002088 }
2089 }
2090
Joe Perches20112472011-07-25 17:13:23 -07002091# Check the patch for a signoff:
Andy Whitcroftd8aaf122007-06-23 17:16:44 -07002092 if ($line =~ /^\s*signed-off-by:/i) {
Andy Whitcroft4a0df2e2007-06-08 13:46:39 -07002093 $signoff++;
Joe Perches15662b32011-10-31 17:13:12 -07002094 $in_commit_log = 0;
Joe Perches20112472011-07-25 17:13:23 -07002095 }
2096
Joe Perchese0d975b2014-12-10 15:51:49 -08002097# Check if MAINTAINERS is being updated. If so, there's probably no need to
2098# emit the "does MAINTAINERS need updating?" message on file add/move/delete
2099 if ($line =~ /^\s*MAINTAINERS\s*\|/) {
2100 $reported_maintainer_file = 1;
2101 }
2102
Joe Perches20112472011-07-25 17:13:23 -07002103# Check signature styles
Joe Perches270c49a2012-01-10 15:09:50 -08002104 if (!$in_header_lines &&
Joe Perchesce0338df3c2012-07-30 14:41:18 -07002105 $line =~ /^(\s*)([a-z0-9_-]+by:|$signature_tags)(\s*)(.*)/i) {
Joe Perches20112472011-07-25 17:13:23 -07002106 my $space_before = $1;
2107 my $sign_off = $2;
2108 my $space_after = $3;
2109 my $email = $4;
2110 my $ucfirst_sign_off = ucfirst(lc($sign_off));
2111
Joe Perchesce0338df3c2012-07-30 14:41:18 -07002112 if ($sign_off !~ /$signature_tags/) {
2113 WARN("BAD_SIGN_OFF",
2114 "Non-standard signature: $sign_off\n" . $herecurr);
2115 }
Joe Perches20112472011-07-25 17:13:23 -07002116 if (defined $space_before && $space_before ne "") {
Joe Perches3705ce52013-07-03 15:05:31 -07002117 if (WARN("BAD_SIGN_OFF",
2118 "Do not use whitespace before $ucfirst_sign_off\n" . $herecurr) &&
2119 $fix) {
Joe Perches194f66f2014-08-06 16:11:03 -07002120 $fixed[$fixlinenr] =
Joe Perches3705ce52013-07-03 15:05:31 -07002121 "$ucfirst_sign_off $email";
2122 }
Andy Whitcroft0a920b5b2007-06-01 00:46:48 -07002123 }
Joe Perches20112472011-07-25 17:13:23 -07002124 if ($sign_off =~ /-by:$/i && $sign_off ne $ucfirst_sign_off) {
Joe Perches3705ce52013-07-03 15:05:31 -07002125 if (WARN("BAD_SIGN_OFF",
2126 "'$ucfirst_sign_off' is the preferred signature form\n" . $herecurr) &&
2127 $fix) {
Joe Perches194f66f2014-08-06 16:11:03 -07002128 $fixed[$fixlinenr] =
Joe Perches3705ce52013-07-03 15:05:31 -07002129 "$ucfirst_sign_off $email";
2130 }
2131
Joe Perches20112472011-07-25 17:13:23 -07002132 }
2133 if (!defined $space_after || $space_after ne " ") {
Joe Perches3705ce52013-07-03 15:05:31 -07002134 if (WARN("BAD_SIGN_OFF",
2135 "Use a single space after $ucfirst_sign_off\n" . $herecurr) &&
2136 $fix) {
Joe Perches194f66f2014-08-06 16:11:03 -07002137 $fixed[$fixlinenr] =
Joe Perches3705ce52013-07-03 15:05:31 -07002138 "$ucfirst_sign_off $email";
2139 }
Joe Perches20112472011-07-25 17:13:23 -07002140 }
2141
2142 my ($email_name, $email_address, $comment) = parse_email($email);
2143 my $suggested_email = format_email(($email_name, $email_address));
2144 if ($suggested_email eq "") {
Joe Perches000d1cc12011-07-25 17:13:25 -07002145 ERROR("BAD_SIGN_OFF",
2146 "Unrecognized email address: '$email'\n" . $herecurr);
Joe Perches20112472011-07-25 17:13:23 -07002147 } else {
2148 my $dequoted = $suggested_email;
2149 $dequoted =~ s/^"//;
2150 $dequoted =~ s/" </ </;
2151 # Don't force email to have quotes
2152 # Allow just an angle bracketed address
2153 if ("$dequoted$comment" ne $email &&
2154 "<$email_address>$comment" ne $email &&
2155 "$suggested_email$comment" ne $email) {
Joe Perches000d1cc12011-07-25 17:13:25 -07002156 WARN("BAD_SIGN_OFF",
2157 "email address '$email' might be better as '$suggested_email$comment'\n" . $herecurr);
Joe Perches20112472011-07-25 17:13:23 -07002158 }
Andy Whitcroft0a920b5b2007-06-01 00:46:48 -07002159 }
Joe Perches7e51f192013-09-11 14:23:57 -07002160
2161# Check for duplicate signatures
2162 my $sig_nospace = $line;
2163 $sig_nospace =~ s/\s//g;
2164 $sig_nospace = lc($sig_nospace);
2165 if (defined $signatures{$sig_nospace}) {
2166 WARN("BAD_SIGN_OFF",
2167 "Duplicate signature\n" . $herecurr);
2168 } else {
2169 $signatures{$sig_nospace} = 1;
2170 }
Andy Whitcroft0a920b5b2007-06-01 00:46:48 -07002171 }
2172
Joe Perches9b3189e2014-06-04 16:12:10 -07002173# Check for old stable address
2174 if ($line =~ /^\s*cc:\s*.*<?\bstable\@kernel\.org\b>?.*$/i) {
2175 ERROR("STABLE_ADDRESS",
2176 "The 'stable' address should be 'stable\@vger.kernel.org'\n" . $herecurr);
2177 }
2178
Christopher Covington7ebd05e2014-04-03 14:49:31 -07002179# Check for unwanted Gerrit info
2180 if ($in_commit_log && $line =~ /^\s*change-id:/i) {
2181 ERROR("GERRIT_CHANGE_ID",
2182 "Remove Gerrit Change-Id's before submitting upstream.\n" . $herecurr);
2183 }
2184
Joe Perches0d7835f2015-02-13 14:38:35 -08002185# Check for git id commit length and improperly formed commit descriptions
2186 if ($in_commit_log && $line =~ /\b(c)ommit\s+([0-9a-f]{5,})/i) {
Joe Perchesd311cd42014-08-06 16:10:57 -07002187 my $init_char = $1;
2188 my $orig_commit = lc($2);
Joe Perches0d7835f2015-02-13 14:38:35 -08002189 my $short = 1;
2190 my $long = 0;
2191 my $case = 1;
2192 my $space = 1;
2193 my $hasdesc = 0;
Joe Perches19c146a2015-02-13 14:39:00 -08002194 my $hasparens = 0;
Joe Perches0d7835f2015-02-13 14:38:35 -08002195 my $id = '0123456789ab';
2196 my $orig_desc = "commit description";
2197 my $description = "";
2198
2199 $short = 0 if ($line =~ /\bcommit\s+[0-9a-f]{12,40}/i);
2200 $long = 1 if ($line =~ /\bcommit\s+[0-9a-f]{41,}/i);
2201 $space = 0 if ($line =~ /\bcommit [0-9a-f]/i);
2202 $case = 0 if ($line =~ /\b[Cc]ommit\s+[0-9a-f]{5,40}[^A-F]/);
2203 if ($line =~ /\bcommit\s+[0-9a-f]{5,}\s+\("([^"]+)"\)/i) {
2204 $orig_desc = $1;
Joe Perches19c146a2015-02-13 14:39:00 -08002205 $hasparens = 1;
Joe Perches0d7835f2015-02-13 14:38:35 -08002206 } elsif ($line =~ /\bcommit\s+[0-9a-f]{5,}\s*$/i &&
2207 defined $rawlines[$linenr] &&
2208 $rawlines[$linenr] =~ /^\s*\("([^"]+)"\)/) {
2209 $orig_desc = $1;
Joe Perches19c146a2015-02-13 14:39:00 -08002210 $hasparens = 1;
Joe Perchesb671fde2015-02-13 14:38:41 -08002211 } elsif ($line =~ /\bcommit\s+[0-9a-f]{5,}\s+\("[^"]+$/i &&
2212 defined $rawlines[$linenr] &&
2213 $rawlines[$linenr] =~ /^\s*[^"]+"\)/) {
2214 $line =~ /\bcommit\s+[0-9a-f]{5,}\s+\("([^"]+)$/i;
2215 $orig_desc = $1;
2216 $rawlines[$linenr] =~ /^\s*([^"]+)"\)/;
2217 $orig_desc .= " " . $1;
Joe Perches19c146a2015-02-13 14:39:00 -08002218 $hasparens = 1;
Joe Perches0d7835f2015-02-13 14:38:35 -08002219 }
2220
2221 ($id, $description) = git_commit_info($orig_commit,
2222 $id, $orig_desc);
2223
Joe Perches19c146a2015-02-13 14:39:00 -08002224 if ($short || $long || $space || $case || ($orig_desc ne $description) || !$hasparens) {
Joe Perches0d7835f2015-02-13 14:38:35 -08002225 ERROR("GIT_COMMIT_ID",
2226 "Please use git commit description style 'commit <12+ chars of sha1> (\"<title line>\")' - ie: '${init_char}ommit $id (\"$description\")'\n" . $herecurr);
2227 }
Joe Perchesd311cd42014-08-06 16:10:57 -07002228 }
2229
Joe Perches13f19372014-08-06 16:10:59 -07002230# Check for added, moved or deleted files
2231 if (!$reported_maintainer_file && !$in_commit_log &&
2232 ($line =~ /^(?:new|deleted) file mode\s*\d+\s*$/ ||
2233 $line =~ /^rename (?:from|to) [\w\/\.\-]+\s*$/ ||
2234 ($line =~ /\{\s*([\w\/\.\-]*)\s*\=\>\s*([\w\/\.\-]*)\s*\}/ &&
2235 (defined($1) || defined($2))))) {
2236 $reported_maintainer_file = 1;
2237 WARN("FILE_PATH_CHANGES",
2238 "added, moved or deleted file(s), does MAINTAINERS need updating?\n" . $herecurr);
2239 }
2240
Andy Whitcroft00df3442007-06-08 13:47:06 -07002241# Check for wrappage within a valid hunk of the file
Andy Whitcroft8905a672007-11-28 16:21:06 -08002242 if ($realcnt != 0 && $line !~ m{^(?:\+|-| |\\ No newline|$)}) {
Joe Perches000d1cc12011-07-25 17:13:25 -07002243 ERROR("CORRUPTED_PATCH",
2244 "patch seems to be corrupt (line wrapped?)\n" .
Andy Whitcroft6c72ffa2007-10-18 03:05:08 -07002245 $herecurr) if (!$emitted_corrupt++);
Andy Whitcroftde7d4f02007-07-15 23:37:22 -07002246 }
2247
Andy Whitcroft6ecd9672008-10-15 22:02:21 -07002248# Check for absolute kernel paths.
2249 if ($tree) {
2250 while ($line =~ m{(?:^|\s)(/\S*)}g) {
2251 my $file = $1;
2252
2253 if ($file =~ m{^(.*?)(?::\d+)+:?$} &&
2254 check_absolute_file($1, $herecurr)) {
2255 #
2256 } else {
2257 check_absolute_file($file, $herecurr);
2258 }
2259 }
2260 }
2261
Andy Whitcroftde7d4f02007-07-15 23:37:22 -07002262# UTF-8 regex found at http://www.w3.org/International/questions/qa-forms-utf-8.en.php
2263 if (($realfile =~ /^$/ || $line =~ /^\+/) &&
Andy Whitcroft171ae1a2008-04-29 00:59:32 -07002264 $rawline !~ m/^$UTF8*$/) {
2265 my ($utf8_prefix) = ($rawline =~ /^($UTF8*)/);
2266
2267 my $blank = copy_spacing($rawline);
2268 my $ptr = substr($blank, 0, length($utf8_prefix)) . "^";
2269 my $hereptr = "$hereline$ptr\n";
2270
Joe Perches34d99212011-07-25 17:13:26 -07002271 CHK("INVALID_UTF8",
2272 "Invalid UTF-8, patch and commit message should be encoded in UTF-8\n" . $hereptr);
Andy Whitcroft00df3442007-06-08 13:47:06 -07002273 }
Andy Whitcroft0a920b5b2007-06-01 00:46:48 -07002274
Joe Perches15662b32011-10-31 17:13:12 -07002275# Check if it's the start of a commit log
2276# (not a header line and we haven't seen the patch filename)
2277 if ($in_header_lines && $realfile =~ /^$/ &&
Joe Perches29ee1b02014-08-06 16:10:35 -07002278 !($rawline =~ /^\s+\S/ ||
2279 $rawline =~ /^(commit\b|from\b|[\w-]+:).*$/i)) {
Joe Perches15662b32011-10-31 17:13:12 -07002280 $in_header_lines = 0;
2281 $in_commit_log = 1;
2282 }
2283
Pasi Savanainenfa64205d2012-10-04 17:13:29 -07002284# Check if there is UTF-8 in a commit log when a mail header has explicitly
2285# declined it, i.e defined some charset where it is missing.
2286 if ($in_header_lines &&
2287 $rawline =~ /^Content-Type:.+charset="(.+)".*$/ &&
2288 $1 !~ /utf-8/i) {
2289 $non_utf8_charset = 1;
2290 }
2291
2292 if ($in_commit_log && $non_utf8_charset && $realfile =~ /^$/ &&
Joe Perches15662b32011-10-31 17:13:12 -07002293 $rawline =~ /$NON_ASCII_UTF8/) {
Pasi Savanainenfa64205d2012-10-04 17:13:29 -07002294 WARN("UTF8_BEFORE_PATCH",
Joe Perches15662b32011-10-31 17:13:12 -07002295 "8-bit UTF-8 used in possible commit log\n" . $herecurr);
2296 }
2297
Kees Cook66b47b42014-10-13 15:51:57 -07002298# Check for various typo / spelling mistakes
Joe Perches36061e32014-12-10 15:51:43 -08002299 if (defined($misspellings) && ($in_commit_log || $line =~ /^\+/)) {
Kees Cook66b47b42014-10-13 15:51:57 -07002300 while ($rawline =~ /(?:^|[^a-z@])($misspellings)(?:$|[^a-z@])/gi) {
2301 my $typo = $1;
2302 my $typo_fix = $spelling_fix{lc($typo)};
2303 $typo_fix = ucfirst($typo_fix) if ($typo =~ /^[A-Z]/);
2304 $typo_fix = uc($typo_fix) if ($typo =~ /^[A-Z]+$/);
2305 my $msg_type = \&WARN;
2306 $msg_type = \&CHK if ($file);
2307 if (&{$msg_type}("TYPO_SPELLING",
2308 "'$typo' may be misspelled - perhaps '$typo_fix'?\n" . $herecurr) &&
2309 $fix) {
2310 $fixed[$fixlinenr] =~ s/(^|[^A-Za-z@])($typo)($|[^A-Za-z@])/$1$typo_fix$3/;
2311 }
2312 }
2313 }
2314
Andy Whitcroft306708542008-10-15 22:02:28 -07002315# ignore non-hunk lines and lines being removed
2316 next if (!$hunk_line || $line =~ /^-/);
Andy Whitcroft00df3442007-06-08 13:47:06 -07002317
Andy Whitcroft0a920b5b2007-06-01 00:46:48 -07002318#trailing whitespace
Andy Whitcroft9c0ca6f2007-10-16 23:29:38 -07002319 if ($line =~ /^\+.*\015/) {
Andy Whitcroftc2fdda02008-02-08 04:20:54 -08002320 my $herevet = "$here\n" . cat_vet($rawline) . "\n";
Joe Perchesd5e616f2013-09-11 14:23:54 -07002321 if (ERROR("DOS_LINE_ENDINGS",
2322 "DOS line endings\n" . $herevet) &&
2323 $fix) {
Joe Perches194f66f2014-08-06 16:11:03 -07002324 $fixed[$fixlinenr] =~ s/[\s\015]+$//;
Joe Perchesd5e616f2013-09-11 14:23:54 -07002325 }
Andy Whitcroftc2fdda02008-02-08 04:20:54 -08002326 } elsif ($rawline =~ /^\+.*\S\s+$/ || $rawline =~ /^\+\s+$/) {
2327 my $herevet = "$here\n" . cat_vet($rawline) . "\n";
Joe Perches3705ce52013-07-03 15:05:31 -07002328 if (ERROR("TRAILING_WHITESPACE",
2329 "trailing whitespace\n" . $herevet) &&
2330 $fix) {
Joe Perches194f66f2014-08-06 16:11:03 -07002331 $fixed[$fixlinenr] =~ s/\s+$//;
Joe Perches3705ce52013-07-03 15:05:31 -07002332 }
2333
Andy Whitcroftd2c0a232010-10-26 14:23:12 -07002334 $rpt_cleaners = 1;
Andy Whitcroft0a920b5b2007-06-01 00:46:48 -07002335 }
Andy Whitcroft5368df202008-10-15 22:02:27 -07002336
Josh Triplett4783f892013-11-12 15:10:12 -08002337# Check for FSF mailing addresses.
Alexander Duyck109d8cb2014-01-23 15:54:50 -08002338 if ($rawline =~ /\bwrite to the Free/i ||
Joe Perches3e2232f2014-01-23 15:54:48 -08002339 $rawline =~ /\b59\s+Temple\s+Pl/i ||
2340 $rawline =~ /\b51\s+Franklin\s+St/i) {
Josh Triplett4783f892013-11-12 15:10:12 -08002341 my $herevet = "$here\n" . cat_vet($rawline) . "\n";
2342 my $msg_type = \&ERROR;
2343 $msg_type = \&CHK if ($file);
2344 &{$msg_type}("FSF_MAILING_ADDRESS",
Joe Perches3e2232f2014-01-23 15:54:48 -08002345 "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)
Josh Triplett4783f892013-11-12 15:10:12 -08002346 }
2347
Andi Kleen33549572010-05-24 14:33:29 -07002348# check for Kconfig help text having a real description
Andy Whitcroft9fe287d72010-10-26 14:23:15 -07002349# Only applies when adding the entry originally, after that we do not have
2350# sufficient context to determine whether it is indeed long enough.
Andi Kleen33549572010-05-24 14:33:29 -07002351 if ($realfile =~ /Kconfig/ &&
Joe Perches8d73e0e2014-08-06 16:10:46 -07002352 $line =~ /^\+\s*config\s+/) {
Andi Kleen33549572010-05-24 14:33:29 -07002353 my $length = 0;
Andy Whitcroft9fe287d72010-10-26 14:23:15 -07002354 my $cnt = $realcnt;
2355 my $ln = $linenr + 1;
2356 my $f;
Andy Whitcrofta1385802012-01-10 15:10:03 -08002357 my $is_start = 0;
Andy Whitcroft9fe287d72010-10-26 14:23:15 -07002358 my $is_end = 0;
Andy Whitcrofta1385802012-01-10 15:10:03 -08002359 for (; $cnt > 0 && defined $lines[$ln - 1]; $ln++) {
Andy Whitcroft9fe287d72010-10-26 14:23:15 -07002360 $f = $lines[$ln - 1];
2361 $cnt-- if ($lines[$ln - 1] !~ /^-/);
2362 $is_end = $lines[$ln - 1] =~ /^\+/;
Andy Whitcroft9fe287d72010-10-26 14:23:15 -07002363
2364 next if ($f =~ /^-/);
Joe Perches8d73e0e2014-08-06 16:10:46 -07002365 last if (!$file && $f =~ /^\@\@/);
Andy Whitcrofta1385802012-01-10 15:10:03 -08002366
Joe Perches8d73e0e2014-08-06 16:10:46 -07002367 if ($lines[$ln - 1] =~ /^\+\s*(?:bool|tristate)\s*\"/) {
Andy Whitcrofta1385802012-01-10 15:10:03 -08002368 $is_start = 1;
Joe Perches8d73e0e2014-08-06 16:10:46 -07002369 } elsif ($lines[$ln - 1] =~ /^\+\s*(?:---)?help(?:---)?$/) {
Andy Whitcrofta1385802012-01-10 15:10:03 -08002370 $length = -1;
2371 }
2372
Andy Whitcroft9fe287d72010-10-26 14:23:15 -07002373 $f =~ s/^.//;
Andi Kleen33549572010-05-24 14:33:29 -07002374 $f =~ s/#.*//;
2375 $f =~ s/^\s+//;
2376 next if ($f =~ /^$/);
Andy Whitcroft9fe287d72010-10-26 14:23:15 -07002377 if ($f =~ /^\s*config\s/) {
2378 $is_end = 1;
2379 last;
2380 }
Andi Kleen33549572010-05-24 14:33:29 -07002381 $length++;
2382 }
Vadim Bendebury56193272014-10-13 15:51:48 -07002383 if ($is_start && $is_end && $length < $min_conf_desc_length) {
2384 WARN("CONFIG_DESCRIPTION",
2385 "please write a paragraph that describes the config symbol fully\n" . $herecurr);
2386 }
Andy Whitcrofta1385802012-01-10 15:10:03 -08002387 #print "is_start<$is_start> is_end<$is_end> length<$length>\n";
Andi Kleen33549572010-05-24 14:33:29 -07002388 }
2389
Kees Cook1ba8dfd2012-12-17 16:01:48 -08002390# discourage the addition of CONFIG_EXPERIMENTAL in Kconfig.
2391 if ($realfile =~ /Kconfig/ &&
2392 $line =~ /.\s*depends on\s+.*\bEXPERIMENTAL\b/) {
2393 WARN("CONFIG_EXPERIMENTAL",
2394 "Use of CONFIG_EXPERIMENTAL is deprecated. For alternatives, see https://lkml.org/lkml/2012/10/23/580\n");
2395 }
2396
Christoph Jaeger327953e2015-02-13 14:38:29 -08002397# discourage the use of boolean for type definition attributes of Kconfig options
2398 if ($realfile =~ /Kconfig/ &&
2399 $line =~ /^\+\s*\bboolean\b/) {
2400 WARN("CONFIG_TYPE_BOOLEAN",
2401 "Use of boolean is deprecated, please use bool instead.\n" . $herecurr);
2402 }
2403
Arnaud Lacombec68e5872011-08-15 01:07:14 -04002404 if (($realfile =~ /Makefile.*/ || $realfile =~ /Kbuild.*/) &&
2405 ($line =~ /\+(EXTRA_[A-Z]+FLAGS).*/)) {
2406 my $flag = $1;
2407 my $replacement = {
2408 'EXTRA_AFLAGS' => 'asflags-y',
2409 'EXTRA_CFLAGS' => 'ccflags-y',
2410 'EXTRA_CPPFLAGS' => 'cppflags-y',
2411 'EXTRA_LDFLAGS' => 'ldflags-y',
2412 };
2413
2414 WARN("DEPRECATED_VARIABLE",
2415 "Use of $flag is deprecated, please use \`$replacement->{$flag} instead.\n" . $herecurr) if ($replacement->{$flag});
2416 }
2417
Rob Herringbff5da42014-01-23 15:54:51 -08002418# check for DT compatible documentation
Florian Vaussard7dd05b32014-04-03 14:49:26 -07002419 if (defined $root &&
2420 (($realfile =~ /\.dtsi?$/ && $line =~ /^\+\s*compatible\s*=\s*\"/) ||
2421 ($realfile =~ /\.[ch]$/ && $line =~ /^\+.*\.compatible\s*=\s*\"/))) {
2422
Rob Herringbff5da42014-01-23 15:54:51 -08002423 my @compats = $rawline =~ /\"([a-zA-Z0-9\-\,\.\+_]+)\"/g;
2424
Florian Vaussardcc933192014-04-03 14:49:27 -07002425 my $dt_path = $root . "/Documentation/devicetree/bindings/";
2426 my $vp_file = $dt_path . "vendor-prefixes.txt";
2427
Rob Herringbff5da42014-01-23 15:54:51 -08002428 foreach my $compat (@compats) {
2429 my $compat2 = $compat;
Rob Herring185d5662014-06-04 16:12:03 -07002430 $compat2 =~ s/\,[a-zA-Z0-9]*\-/\,<\.\*>\-/;
2431 my $compat3 = $compat;
2432 $compat3 =~ s/\,([a-z]*)[0-9]*\-/\,$1<\.\*>\-/;
2433 `grep -Erq "$compat|$compat2|$compat3" $dt_path`;
Rob Herringbff5da42014-01-23 15:54:51 -08002434 if ( $? >> 8 ) {
2435 WARN("UNDOCUMENTED_DT_STRING",
2436 "DT compatible string \"$compat\" appears un-documented -- check $dt_path\n" . $herecurr);
2437 }
2438
Florian Vaussard4fbf32a2014-04-03 14:49:25 -07002439 next if $compat !~ /^([a-zA-Z0-9\-]+)\,/;
2440 my $vendor = $1;
Florian Vaussardcc933192014-04-03 14:49:27 -07002441 `grep -Eq "^$vendor\\b" $vp_file`;
Rob Herringbff5da42014-01-23 15:54:51 -08002442 if ( $? >> 8 ) {
2443 WARN("UNDOCUMENTED_DT_STRING",
Florian Vaussardcc933192014-04-03 14:49:27 -07002444 "DT compatible string vendor \"$vendor\" appears un-documented -- check $vp_file\n" . $herecurr);
Rob Herringbff5da42014-01-23 15:54:51 -08002445 }
2446 }
2447 }
2448
Andy Whitcroft5368df202008-10-15 22:02:27 -07002449# check we are in a valid source file if not then ignore this hunk
Geert Uytterhoevende4c9242014-10-13 15:51:46 -07002450 next if ($realfile !~ /\.(h|c|s|S|pl|sh|dtsi|dts)$/);
Andy Whitcroft5368df202008-10-15 22:02:27 -07002451
Joe Perches6cd7f382012-12-17 16:01:54 -08002452#line length limit
Andy Whitcroftc45dcab2008-06-05 22:46:01 -07002453 if ($line =~ /^\+/ && $prevrawline !~ /\/\*\*/ &&
Andy Whitcroftf4c014c2008-07-23 21:29:01 -07002454 $rawline !~ /^.\s*\*\s*\@$Ident\s/ &&
Joe Perches0fccc622011-05-24 17:13:41 -07002455 !($line =~ /^\+\s*$logFunctions\s*\(\s*(?:(KERN_\S+\s*|[^"]*))?"[X\t]*"\s*(?:|,|\)\s*;)\s*$/ ||
Joe Perches8bbea962010-08-09 17:21:01 -07002456 $line =~ /^\+\s*"[^"]*"\s*(?:\s*|,|\)\s*;)\s*$/) &&
Joe Perches6cd7f382012-12-17 16:01:54 -08002457 $length > $max_line_length)
Andy Whitcroftc45dcab2008-06-05 22:46:01 -07002458 {
Joe Perches000d1cc12011-07-25 17:13:25 -07002459 WARN("LONG_LINE",
Joe Perches6cd7f382012-12-17 16:01:54 -08002460 "line over $max_line_length characters\n" . $herecurr);
Andy Whitcroft0a920b5b2007-06-01 00:46:48 -07002461 }
2462
Andy Whitcroft8905a672007-11-28 16:21:06 -08002463# check for adding lines without a newline.
2464 if ($line =~ /^\+/ && defined $lines[$linenr] && $lines[$linenr] =~ /^\\ No newline at end of file/) {
Joe Perches000d1cc12011-07-25 17:13:25 -07002465 WARN("MISSING_EOF_NEWLINE",
2466 "adding a line without newline at end of file\n" . $herecurr);
Andy Whitcroft8905a672007-11-28 16:21:06 -08002467 }
2468
Mike Frysinger42e41c52009-09-21 17:04:40 -07002469# Blackfin: use hi/lo macros
2470 if ($realfile =~ m@arch/blackfin/.*\.S$@) {
2471 if ($line =~ /\.[lL][[:space:]]*=.*&[[:space:]]*0x[fF][fF][fF][fF]/) {
2472 my $herevet = "$here\n" . cat_vet($line) . "\n";
Joe Perches000d1cc12011-07-25 17:13:25 -07002473 ERROR("LO_MACRO",
2474 "use the LO() macro, not (... & 0xFFFF)\n" . $herevet);
Mike Frysinger42e41c52009-09-21 17:04:40 -07002475 }
2476 if ($line =~ /\.[hH][[:space:]]*=.*>>[[:space:]]*16/) {
2477 my $herevet = "$here\n" . cat_vet($line) . "\n";
Joe Perches000d1cc12011-07-25 17:13:25 -07002478 ERROR("HI_MACRO",
2479 "use the HI() macro, not (... >> 16)\n" . $herevet);
Mike Frysinger42e41c52009-09-21 17:04:40 -07002480 }
2481 }
2482
Andy Whitcroftb9ea10d2008-10-15 22:02:24 -07002483# check we are in a valid source file C or perl if not then ignore this hunk
Geert Uytterhoevende4c9242014-10-13 15:51:46 -07002484 next if ($realfile !~ /\.(h|c|pl|dtsi|dts)$/);
Andy Whitcroft0a920b5b2007-06-01 00:46:48 -07002485
2486# at the beginning of a line any tabs must come first and anything
2487# more than 8 must use tabs.
Andy Whitcroftc2fdda02008-02-08 04:20:54 -08002488 if ($rawline =~ /^\+\s* \t\s*\S/ ||
2489 $rawline =~ /^\+\s* \s*/) {
2490 my $herevet = "$here\n" . cat_vet($rawline) . "\n";
Andy Whitcroftd2c0a232010-10-26 14:23:12 -07002491 $rpt_cleaners = 1;
Joe Perches3705ce52013-07-03 15:05:31 -07002492 if (ERROR("CODE_INDENT",
2493 "code indent should use tabs where possible\n" . $herevet) &&
2494 $fix) {
Joe Perches194f66f2014-08-06 16:11:03 -07002495 $fixed[$fixlinenr] =~ s/^\+([ \t]+)/"\+" . tabify($1)/e;
Joe Perches3705ce52013-07-03 15:05:31 -07002496 }
Andy Whitcroft0a920b5b2007-06-01 00:46:48 -07002497 }
2498
Alberto Panizzo08e44362010-03-05 13:43:54 -08002499# check for space before tabs.
2500 if ($rawline =~ /^\+/ && $rawline =~ / \t/) {
2501 my $herevet = "$here\n" . cat_vet($rawline) . "\n";
Joe Perches3705ce52013-07-03 15:05:31 -07002502 if (WARN("SPACE_BEFORE_TAB",
2503 "please, no space before tabs\n" . $herevet) &&
2504 $fix) {
Joe Perches194f66f2014-08-06 16:11:03 -07002505 while ($fixed[$fixlinenr] =~
Joe Perchesd2207cc2014-10-13 15:51:53 -07002506 s/(^\+.*) {8,8}\t/$1\t\t/) {}
Joe Perches194f66f2014-08-06 16:11:03 -07002507 while ($fixed[$fixlinenr] =~
Joe Perchesc76f4cb2014-01-23 15:54:46 -08002508 s/(^\+.*) +\t/$1\t/) {}
Joe Perches3705ce52013-07-03 15:05:31 -07002509 }
Alberto Panizzo08e44362010-03-05 13:43:54 -08002510 }
2511
Joe Perchesd1fe9c02012-03-23 15:02:16 -07002512# check for && or || at the start of a line
2513 if ($rawline =~ /^\+\s*(&&|\|\|)/) {
2514 CHK("LOGICAL_CONTINUATIONS",
2515 "Logical continuations should be on the previous line\n" . $hereprev);
2516 }
2517
2518# check multi-line statement indentation matches previous line
2519 if ($^V && $^V ge 5.10.0 &&
Joe Perches91cb5192014-04-03 14:49:32 -07002520 $prevline =~ /^\+([ \t]*)((?:$c90_Keywords(?:\s+if)\s*)|(?:$Declare\s*)?(?:$Ident|\(\s*\*\s*$Ident\s*\))\s*|$Ident\s*=\s*$Ident\s*)\(.*(\&\&|\|\||,)\s*$/) {
Joe Perchesd1fe9c02012-03-23 15:02:16 -07002521 $prevline =~ /^\+(\t*)(.*)$/;
2522 my $oldindent = $1;
2523 my $rest = $2;
2524
2525 my $pos = pos_last_openparen($rest);
2526 if ($pos >= 0) {
Joe Perchesb34a26f2012-07-30 14:41:16 -07002527 $line =~ /^(\+| )([ \t]*)/;
2528 my $newindent = $2;
Joe Perchesd1fe9c02012-03-23 15:02:16 -07002529
2530 my $goodtabindent = $oldindent .
2531 "\t" x ($pos / 8) .
2532 " " x ($pos % 8);
2533 my $goodspaceindent = $oldindent . " " x $pos;
2534
2535 if ($newindent ne $goodtabindent &&
2536 $newindent ne $goodspaceindent) {
Joe Perches3705ce52013-07-03 15:05:31 -07002537
2538 if (CHK("PARENTHESIS_ALIGNMENT",
2539 "Alignment should match open parenthesis\n" . $hereprev) &&
2540 $fix && $line =~ /^\+/) {
Joe Perches194f66f2014-08-06 16:11:03 -07002541 $fixed[$fixlinenr] =~
Joe Perches3705ce52013-07-03 15:05:31 -07002542 s/^\+[ \t]*/\+$goodtabindent/;
2543 }
Joe Perchesd1fe9c02012-03-23 15:02:16 -07002544 }
2545 }
2546 }
2547
Joe Perches43f7fe52015-02-13 14:38:52 -08002548 if ($line =~ /^\+.*(\w+\s*)?\(\s*$Type\s*\)[ \t]+(?!$Assignment|$Arithmetic|[,;:\?\(\{\}\[\<\>]|&&|\|\||\\$)/ &&
Joe Perches04941aa2014-12-10 15:51:37 -08002549 (!defined($1) || $1 !~ /sizeof\s*/)) {
Joe Perches3705ce52013-07-03 15:05:31 -07002550 if (CHK("SPACING",
Joe Perchesf27c95d2014-08-06 16:10:52 -07002551 "No space is necessary after a cast\n" . $herecurr) &&
Joe Perches3705ce52013-07-03 15:05:31 -07002552 $fix) {
Joe Perches194f66f2014-08-06 16:11:03 -07002553 $fixed[$fixlinenr] =~
Joe Perchesf27c95d2014-08-06 16:10:52 -07002554 s/(\(\s*$Type\s*\))[ \t]+/$1/;
Joe Perches3705ce52013-07-03 15:05:31 -07002555 }
Joe Perchesaad4f612012-03-23 15:02:19 -07002556 }
2557
Joe Perches05880602012-10-04 17:13:35 -07002558 if ($realfile =~ m@^(drivers/net/|net/)@ &&
Joe Perchesfdb4bcd2013-07-03 15:05:23 -07002559 $prevrawline =~ /^\+[ \t]*\/\*[ \t]*$/ &&
Joe Perches85ad9782014-04-03 14:49:20 -07002560 $rawline =~ /^\+[ \t]*\*/ &&
2561 $realline > 2) {
Joe Perches05880602012-10-04 17:13:35 -07002562 WARN("NETWORKING_BLOCK_COMMENT_STYLE",
2563 "networking block comments don't use an empty /* line, use /* Comment...\n" . $hereprev);
2564 }
2565
2566 if ($realfile =~ m@^(drivers/net/|net/)@ &&
Joe Perchesa605e322013-07-03 15:05:24 -07002567 $prevrawline =~ /^\+[ \t]*\/\*/ && #starting /*
2568 $prevrawline !~ /\*\/[ \t]*$/ && #no trailing */
Joe Perches61135e92013-09-11 14:23:59 -07002569 $rawline =~ /^\+/ && #line is new
Joe Perchesa605e322013-07-03 15:05:24 -07002570 $rawline !~ /^\+[ \t]*\*/) { #no leading *
2571 WARN("NETWORKING_BLOCK_COMMENT_STYLE",
2572 "networking block comments start with * on subsequent lines\n" . $hereprev);
2573 }
2574
2575 if ($realfile =~ m@^(drivers/net/|net/)@ &&
Joe Perchesc24f9f12012-11-08 15:53:29 -08002576 $rawline !~ m@^\+[ \t]*\*/[ \t]*$@ && #trailing */
2577 $rawline !~ m@^\+.*/\*.*\*/[ \t]*$@ && #inline /*...*/
2578 $rawline !~ m@^\+.*\*{2,}/[ \t]*$@ && #trailing **/
2579 $rawline =~ m@^\+[ \t]*.+\*\/[ \t]*$@) { #non blank */
Joe Perches05880602012-10-04 17:13:35 -07002580 WARN("NETWORKING_BLOCK_COMMENT_STYLE",
2581 "networking block comments put the trailing */ on a separate line\n" . $herecurr);
2582 }
2583
Joe Perches7f619192014-08-06 16:10:39 -07002584# check for missing blank lines after struct/union declarations
2585# with exceptions for various attributes and macros
2586 if ($prevline =~ /^[\+ ]};?\s*$/ &&
2587 $line =~ /^\+/ &&
2588 !($line =~ /^\+\s*$/ ||
2589 $line =~ /^\+\s*EXPORT_SYMBOL/ ||
2590 $line =~ /^\+\s*MODULE_/i ||
2591 $line =~ /^\+\s*\#\s*(?:end|elif|else)/ ||
2592 $line =~ /^\+[a-z_]*init/ ||
2593 $line =~ /^\+\s*(?:static\s+)?[A-Z_]*ATTR/ ||
2594 $line =~ /^\+\s*DECLARE/ ||
2595 $line =~ /^\+\s*__setup/)) {
Joe Perchesd752fcc2014-08-06 16:11:05 -07002596 if (CHK("LINE_SPACING",
2597 "Please use a blank line after function/struct/union/enum declarations\n" . $hereprev) &&
2598 $fix) {
Joe Perchesf2d7e4d2014-08-06 16:11:07 -07002599 fix_insert_line($fixlinenr, "\+");
Joe Perchesd752fcc2014-08-06 16:11:05 -07002600 }
Joe Perches7f619192014-08-06 16:10:39 -07002601 }
2602
Joe Perches365dd4e2014-08-06 16:10:42 -07002603# check for multiple consecutive blank lines
2604 if ($prevline =~ /^[\+ ]\s*$/ &&
2605 $line =~ /^\+\s*$/ &&
2606 $last_blank_line != ($linenr - 1)) {
Joe Perchesd752fcc2014-08-06 16:11:05 -07002607 if (CHK("LINE_SPACING",
2608 "Please don't use multiple blank lines\n" . $hereprev) &&
2609 $fix) {
Joe Perchesf2d7e4d2014-08-06 16:11:07 -07002610 fix_delete_line($fixlinenr, $rawline);
Joe Perchesd752fcc2014-08-06 16:11:05 -07002611 }
2612
Joe Perches365dd4e2014-08-06 16:10:42 -07002613 $last_blank_line = $linenr;
2614 }
2615
Joe Perches3b617e32014-04-03 14:49:28 -07002616# check for missing blank lines after declarations
Joe Perches3f7bac02014-06-04 16:12:04 -07002617 if ($sline =~ /^\+\s+\S/ && #Not at char 1
2618 # actual declarations
2619 ($prevline =~ /^\+\s+$Declare\s*$Ident\s*[=,;:\[]/ ||
Joe Perches5a4e1fd2014-08-06 16:10:33 -07002620 # function pointer declarations
2621 $prevline =~ /^\+\s+$Declare\s*\(\s*\*\s*$Ident\s*\)\s*[=,;:\[\(]/ ||
Joe Perches3f7bac02014-06-04 16:12:04 -07002622 # foo bar; where foo is some local typedef or #define
2623 $prevline =~ /^\+\s+$Ident(?:\s+|\s*\*\s*)$Ident\s*[=,;\[]/ ||
2624 # known declaration macros
2625 $prevline =~ /^\+\s+$declaration_macros/) &&
2626 # for "else if" which can look like "$Ident $Ident"
2627 !($prevline =~ /^\+\s+$c90_Keywords\b/ ||
2628 # other possible extensions of declaration lines
2629 $prevline =~ /(?:$Compare|$Assignment|$Operators)\s*$/ ||
2630 # not starting a section or a macro "\" extended line
2631 $prevline =~ /(?:\{\s*|\\)$/) &&
2632 # looks like a declaration
2633 !($sline =~ /^\+\s+$Declare\s*$Ident\s*[=,;:\[]/ ||
Joe Perches5a4e1fd2014-08-06 16:10:33 -07002634 # function pointer declarations
2635 $sline =~ /^\+\s+$Declare\s*\(\s*\*\s*$Ident\s*\)\s*[=,;:\[\(]/ ||
Joe Perches3f7bac02014-06-04 16:12:04 -07002636 # foo bar; where foo is some local typedef or #define
2637 $sline =~ /^\+\s+$Ident(?:\s+|\s*\*\s*)$Ident\s*[=,;\[]/ ||
2638 # known declaration macros
2639 $sline =~ /^\+\s+$declaration_macros/ ||
2640 # start of struct or union or enum
Joe Perches3b617e32014-04-03 14:49:28 -07002641 $sline =~ /^\+\s+(?:union|struct|enum|typedef)\b/ ||
Joe Perches3f7bac02014-06-04 16:12:04 -07002642 # start or end of block or continuation of declaration
2643 $sline =~ /^\+\s+(?:$|[\{\}\.\#\"\?\:\(\[])/ ||
2644 # bitfield continuation
2645 $sline =~ /^\+\s+$Ident\s*:\s*\d+\s*[,;]/ ||
2646 # other possible extensions of declaration lines
2647 $sline =~ /^\+\s+\(?\s*(?:$Compare|$Assignment|$Operators)/) &&
2648 # indentation of previous and current line are the same
2649 (($prevline =~ /\+(\s+)\S/) && $sline =~ /^\+$1\S/)) {
Joe Perchesd752fcc2014-08-06 16:11:05 -07002650 if (WARN("LINE_SPACING",
2651 "Missing a blank line after declarations\n" . $hereprev) &&
2652 $fix) {
Joe Perchesf2d7e4d2014-08-06 16:11:07 -07002653 fix_insert_line($fixlinenr, "\+");
Joe Perchesd752fcc2014-08-06 16:11:05 -07002654 }
Joe Perches3b617e32014-04-03 14:49:28 -07002655 }
2656
Raffaele Recalcati5f7ddae2010-08-09 17:20:59 -07002657# check for spaces at the beginning of a line.
Andy Whitcroft6b4c5be2010-10-26 14:23:11 -07002658# Exceptions:
2659# 1) within comments
2660# 2) indented preprocessor commands
2661# 3) hanging labels
Joe Perches3705ce52013-07-03 15:05:31 -07002662 if ($rawline =~ /^\+ / && $line !~ /^\+ *(?:$;|#|$Ident:)/) {
Raffaele Recalcati5f7ddae2010-08-09 17:20:59 -07002663 my $herevet = "$here\n" . cat_vet($rawline) . "\n";
Joe Perches3705ce52013-07-03 15:05:31 -07002664 if (WARN("LEADING_SPACE",
2665 "please, no spaces at the start of a line\n" . $herevet) &&
2666 $fix) {
Joe Perches194f66f2014-08-06 16:11:03 -07002667 $fixed[$fixlinenr] =~ s/^\+([ \t]+)/"\+" . tabify($1)/e;
Joe Perches3705ce52013-07-03 15:05:31 -07002668 }
Raffaele Recalcati5f7ddae2010-08-09 17:20:59 -07002669 }
2670
Andy Whitcroftb9ea10d2008-10-15 22:02:24 -07002671# check we are in a valid C source file if not then ignore this hunk
2672 next if ($realfile !~ /\.(h|c)$/);
2673
Joe Perches032a4c02014-08-06 16:10:29 -07002674# check indentation of any line with a bare else
Joe Perches840080a2014-10-13 15:51:59 -07002675# (but not if it is a multiple line "if (foo) return bar; else return baz;")
Joe Perches032a4c02014-08-06 16:10:29 -07002676# if the previous line is a break or return and is indented 1 tab more...
2677 if ($sline =~ /^\+([\t]+)(?:}[ \t]*)?else(?:[ \t]*{)?\s*$/) {
2678 my $tabs = length($1) + 1;
Joe Perches840080a2014-10-13 15:51:59 -07002679 if ($prevline =~ /^\+\t{$tabs,$tabs}break\b/ ||
2680 ($prevline =~ /^\+\t{$tabs,$tabs}return\b/ &&
2681 defined $lines[$linenr] &&
2682 $lines[$linenr] !~ /^[ \+]\t{$tabs,$tabs}return/)) {
Joe Perches032a4c02014-08-06 16:10:29 -07002683 WARN("UNNECESSARY_ELSE",
2684 "else is not generally useful after a break or return\n" . $hereprev);
2685 }
2686 }
2687
Joe Perchesc00df192014-08-06 16:11:01 -07002688# check indentation of a line with a break;
2689# if the previous line is a goto or return and is indented the same # of tabs
2690 if ($sline =~ /^\+([\t]+)break\s*;\s*$/) {
2691 my $tabs = $1;
2692 if ($prevline =~ /^\+$tabs(?:goto|return)\b/) {
2693 WARN("UNNECESSARY_BREAK",
2694 "break is not useful after a goto or return\n" . $hereprev);
2695 }
2696 }
2697
Kees Cook1ba8dfd2012-12-17 16:01:48 -08002698# discourage the addition of CONFIG_EXPERIMENTAL in #if(def).
2699 if ($line =~ /^\+\s*\#\s*if.*\bCONFIG_EXPERIMENTAL\b/) {
2700 WARN("CONFIG_EXPERIMENTAL",
2701 "Use of CONFIG_EXPERIMENTAL is deprecated. For alternatives, see https://lkml.org/lkml/2012/10/23/580\n");
2702 }
2703
Andy Whitcroftc2fdda02008-02-08 04:20:54 -08002704# check for RCS/CVS revision markers
Andy Whitcroftcf655042008-03-04 14:28:20 -08002705 if ($rawline =~ /^\+.*\$(Revision|Log|Id)(?:\$|)/) {
Joe Perches000d1cc12011-07-25 17:13:25 -07002706 WARN("CVS_KEYWORD",
2707 "CVS style keyword markers, these will _not_ be updated\n". $herecurr);
Andy Whitcroftc2fdda02008-02-08 04:20:54 -08002708 }
Andy Whitcroft22f2a2e2007-08-10 13:01:03 -07002709
Mike Frysinger42e41c52009-09-21 17:04:40 -07002710# Blackfin: don't use __builtin_bfin_[cs]sync
2711 if ($line =~ /__builtin_bfin_csync/) {
2712 my $herevet = "$here\n" . cat_vet($line) . "\n";
Joe Perches000d1cc12011-07-25 17:13:25 -07002713 ERROR("CSYNC",
2714 "use the CSYNC() macro in asm/blackfin.h\n" . $herevet);
Mike Frysinger42e41c52009-09-21 17:04:40 -07002715 }
2716 if ($line =~ /__builtin_bfin_ssync/) {
2717 my $herevet = "$here\n" . cat_vet($line) . "\n";
Joe Perches000d1cc12011-07-25 17:13:25 -07002718 ERROR("SSYNC",
2719 "use the SSYNC() macro in asm/blackfin.h\n" . $herevet);
Mike Frysinger42e41c52009-09-21 17:04:40 -07002720 }
2721
Joe Perches56e77d72013-02-21 16:44:14 -08002722# check for old HOTPLUG __dev<foo> section markings
2723 if ($line =~ /\b(__dev(init|exit)(data|const|))\b/) {
2724 WARN("HOTPLUG_SECTION",
2725 "Using $1 is unnecessary\n" . $herecurr);
2726 }
2727
Andy Whitcroft9c0ca6f2007-10-16 23:29:38 -07002728# Check for potential 'bare' types
Andy Whitcroft2b474a12009-10-26 16:50:16 -07002729 my ($stat, $cond, $line_nr_next, $remain_next, $off_next,
2730 $realline_next);
Andy Whitcroft3e469cd2012-01-10 15:10:01 -08002731#print "LINE<$line>\n";
2732 if ($linenr >= $suppress_statement &&
Joe Perches1b5539b2013-09-11 14:24:03 -07002733 $realcnt && $sline =~ /.\s*\S/) {
Andy Whitcroft170d3a22008-10-15 22:02:30 -07002734 ($stat, $cond, $line_nr_next, $remain_next, $off_next) =
Andy Whitcroftf5fe35d2008-07-23 21:29:03 -07002735 ctx_statement_block($linenr, $realcnt, 0);
Andy Whitcroft171ae1a2008-04-29 00:59:32 -07002736 $stat =~ s/\n./\n /g;
2737 $cond =~ s/\n./\n /g;
2738
Andy Whitcroft3e469cd2012-01-10 15:10:01 -08002739#print "linenr<$linenr> <$stat>\n";
2740 # If this statement has no statement boundaries within
2741 # it there is no point in retrying a statement scan
2742 # until we hit end of it.
2743 my $frag = $stat; $frag =~ s/;+\s*$//;
2744 if ($frag !~ /(?:{|;)/) {
2745#print "skip<$line_nr_next>\n";
2746 $suppress_statement = $line_nr_next;
2747 }
Andy Whitcroftf74bd192012-01-10 15:09:54 -08002748
Andy Whitcroft2b474a12009-10-26 16:50:16 -07002749 # Find the real next line.
2750 $realline_next = $line_nr_next;
2751 if (defined $realline_next &&
2752 (!defined $lines[$realline_next - 1] ||
2753 substr($lines[$realline_next - 1], $off_next) =~ /^\s*$/)) {
2754 $realline_next++;
2755 }
2756
Andy Whitcroft171ae1a2008-04-29 00:59:32 -07002757 my $s = $stat;
2758 $s =~ s/{.*$//s;
Andy Whitcroftcf655042008-03-04 14:28:20 -08002759
Andy Whitcroftc2fdda02008-02-08 04:20:54 -08002760 # Ignore goto labels.
Andy Whitcroft171ae1a2008-04-29 00:59:32 -07002761 if ($s =~ /$Ident:\*$/s) {
Andy Whitcroftc2fdda02008-02-08 04:20:54 -08002762
2763 # Ignore functions being called
Andy Whitcroft171ae1a2008-04-29 00:59:32 -07002764 } elsif ($s =~ /^.\s*$Ident\s*\(/s) {
Andy Whitcroftc2fdda02008-02-08 04:20:54 -08002765
Andy Whitcroft463f2862009-09-21 17:04:34 -07002766 } elsif ($s =~ /^.\s*else\b/s) {
2767
Andy Whitcroftc45dcab2008-06-05 22:46:01 -07002768 # declarations always start with types
Andy Whitcroftd2506582008-07-23 21:29:09 -07002769 } 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) {
Andy Whitcroftc45dcab2008-06-05 22:46:01 -07002770 my $type = $1;
2771 $type =~ s/\s+/ /g;
2772 possible($type, "A:" . $s);
2773
Andy Whitcroft8905a672007-11-28 16:21:06 -08002774 # definitions in global scope can only start with types
Andy Whitcrofta6a840622008-10-15 22:02:30 -07002775 } elsif ($s =~ /^.(?:$Storage\s+)?(?:$Inline\s+)?(?:const\s+)?($Ident)\b\s*(?!:)/s) {
Andy Whitcroftc45dcab2008-06-05 22:46:01 -07002776 possible($1, "B:" . $s);
Andy Whitcroftc2fdda02008-02-08 04:20:54 -08002777 }
Andy Whitcroft8905a672007-11-28 16:21:06 -08002778
2779 # any (foo ... *) is a pointer cast, and foo is a type
Andy Whitcroft65863862009-01-06 14:41:21 -08002780 while ($s =~ /\(($Ident)(?:\s+$Sparse)*[\s\*]+\s*\)/sg) {
Andy Whitcroftc45dcab2008-06-05 22:46:01 -07002781 possible($1, "C:" . $s);
Andy Whitcroft9c0ca6f2007-10-16 23:29:38 -07002782 }
Andy Whitcroft8905a672007-11-28 16:21:06 -08002783
2784 # Check for any sort of function declaration.
2785 # int foo(something bar, other baz);
2786 # void (*store_gdt)(x86_descr_ptr *);
Andy Whitcroft171ae1a2008-04-29 00:59:32 -07002787 if ($prev_values eq 'E' && $s =~ /^(.(?:typedef\s*)?(?:(?:$Storage|$Inline)\s*)*\s*$Type\s*(?:\b$Ident|\(\*\s*$Ident\))\s*)\(/s) {
Andy Whitcroft8905a672007-11-28 16:21:06 -08002788 my ($name_len) = length($1);
Andy Whitcroft8905a672007-11-28 16:21:06 -08002789
Andy Whitcroftcf655042008-03-04 14:28:20 -08002790 my $ctx = $s;
Andy Whitcroft773647a2008-03-28 14:15:58 -07002791 substr($ctx, 0, $name_len + 1, '');
Andy Whitcroft8905a672007-11-28 16:21:06 -08002792 $ctx =~ s/\)[^\)]*$//;
Andy Whitcroftcf655042008-03-04 14:28:20 -08002793
Andy Whitcroft8905a672007-11-28 16:21:06 -08002794 for my $arg (split(/\s*,\s*/, $ctx)) {
Andy Whitcroftc45dcab2008-06-05 22:46:01 -07002795 if ($arg =~ /^(?:const\s+)?($Ident)(?:\s+$Sparse)*\s*\**\s*(:?\b$Ident)?$/s || $arg =~ /^($Ident)$/s) {
Andy Whitcroft8905a672007-11-28 16:21:06 -08002796
Andy Whitcroftc45dcab2008-06-05 22:46:01 -07002797 possible($1, "D:" . $s);
Andy Whitcroft8905a672007-11-28 16:21:06 -08002798 }
2799 }
2800 }
2801
Andy Whitcroft9c0ca6f2007-10-16 23:29:38 -07002802 }
2803
Andy Whitcroft653d4872007-06-23 17:16:34 -07002804#
2805# Checks which may be anchored in the context.
2806#
2807
2808# Check for switch () and associated case and default
2809# statements should be at the same indent.
Andy Whitcroft00df3442007-06-08 13:47:06 -07002810 if ($line=~/\bswitch\s*\(.*\)/) {
2811 my $err = '';
2812 my $sep = '';
2813 my @ctx = ctx_block_outer($linenr, $realcnt);
2814 shift(@ctx);
2815 for my $ctx (@ctx) {
2816 my ($clen, $cindent) = line_stats($ctx);
2817 if ($ctx =~ /^\+\s*(case\s+|default:)/ &&
2818 $indent != $cindent) {
2819 $err .= "$sep$ctx\n";
2820 $sep = '';
2821 } else {
2822 $sep = "[...]\n";
2823 }
2824 }
2825 if ($err ne '') {
Joe Perches000d1cc12011-07-25 17:13:25 -07002826 ERROR("SWITCH_CASE_INDENT_LEVEL",
2827 "switch and case should be at the same indent\n$hereline$err");
Andy Whitcroftde7d4f02007-07-15 23:37:22 -07002828 }
2829 }
2830
2831# if/while/etc brace do not go on next line, unless defining a do while loop,
2832# or if that brace on the next line is for something else
Joe Perches0fe3dc22014-08-06 16:11:16 -07002833 if ($line =~ /(.*)\b((?:if|while|for|switch|(?:[a-z_]+|)for_each[a-z_]+)\s*\(|do\b|else\b)/ && $line !~ /^.\s*\#/) {
Andy Whitcroft773647a2008-03-28 14:15:58 -07002834 my $pre_ctx = "$1$2";
2835
Andy Whitcroft9c0ca6f2007-10-16 23:29:38 -07002836 my ($level, @ctx) = ctx_statement_level($linenr, $realcnt, 0);
Joe Perches8eef05d2012-02-03 15:20:39 -08002837
2838 if ($line =~ /^\+\t{6,}/) {
2839 WARN("DEEP_INDENTATION",
2840 "Too many leading tabs - consider code refactoring\n" . $herecurr);
2841 }
2842
Andy Whitcroftde7d4f02007-07-15 23:37:22 -07002843 my $ctx_cnt = $realcnt - $#ctx - 1;
2844 my $ctx = join("\n", @ctx);
2845
Andy Whitcroft548596d2008-07-23 21:29:01 -07002846 my $ctx_ln = $linenr;
2847 my $ctx_skip = $realcnt;
Andy Whitcroftde7d4f02007-07-15 23:37:22 -07002848
Andy Whitcroft548596d2008-07-23 21:29:01 -07002849 while ($ctx_skip > $ctx_cnt || ($ctx_skip == $ctx_cnt &&
2850 defined $lines[$ctx_ln - 1] &&
2851 $lines[$ctx_ln - 1] =~ /^-/)) {
2852 ##print "SKIP<$ctx_skip> CNT<$ctx_cnt>\n";
2853 $ctx_skip-- if (!defined $lines[$ctx_ln - 1] || $lines[$ctx_ln - 1] !~ /^-/);
Andy Whitcroft773647a2008-03-28 14:15:58 -07002854 $ctx_ln++;
2855 }
Andy Whitcroft548596d2008-07-23 21:29:01 -07002856
Andy Whitcroft53210162008-07-23 21:29:03 -07002857 #print "realcnt<$realcnt> ctx_cnt<$ctx_cnt>\n";
2858 #print "pre<$pre_ctx>\nline<$line>\nctx<$ctx>\nnext<$lines[$ctx_ln - 1]>\n";
Andy Whitcroft773647a2008-03-28 14:15:58 -07002859
Joe Perchesd752fcc2014-08-06 16:11:05 -07002860 if ($ctx !~ /{\s*/ && defined($lines[$ctx_ln - 1]) && $lines[$ctx_ln - 1] =~ /^\+\s*{/) {
Joe Perches000d1cc12011-07-25 17:13:25 -07002861 ERROR("OPEN_BRACE",
2862 "that open brace { should be on the previous line\n" .
Andy Whitcroft01464f32010-10-26 14:23:19 -07002863 "$here\n$ctx\n$rawlines[$ctx_ln - 1]\n");
Andy Whitcroft00df3442007-06-08 13:47:06 -07002864 }
Andy Whitcroft773647a2008-03-28 14:15:58 -07002865 if ($level == 0 && $pre_ctx !~ /}\s*while\s*\($/ &&
2866 $ctx =~ /\)\s*\;\s*$/ &&
2867 defined $lines[$ctx_ln - 1])
2868 {
Andy Whitcroft9c0ca6f2007-10-16 23:29:38 -07002869 my ($nlength, $nindent) = line_stats($lines[$ctx_ln - 1]);
2870 if ($nindent > $indent) {
Joe Perches000d1cc12011-07-25 17:13:25 -07002871 WARN("TRAILING_SEMICOLON",
2872 "trailing semicolon indicates no statements, indent implies otherwise\n" .
Andy Whitcroft01464f32010-10-26 14:23:19 -07002873 "$here\n$ctx\n$rawlines[$ctx_ln - 1]\n");
Andy Whitcroft9c0ca6f2007-10-16 23:29:38 -07002874 }
2875 }
Andy Whitcroft00df3442007-06-08 13:47:06 -07002876 }
2877
Andy Whitcroft4d001e42008-10-15 22:02:21 -07002878# Check relative indent for conditionals and blocks.
Joe Perches0fe3dc22014-08-06 16:11:16 -07002879 if ($line =~ /\b(?:(?:if|while|for|(?:[a-z_]+|)for_each[a-z_]+)\s*\(|do\b)/ && $line !~ /^.\s*#/ && $line !~ /\}\s*while\s*/) {
Andy Whitcroft3e469cd2012-01-10 15:10:01 -08002880 ($stat, $cond, $line_nr_next, $remain_next, $off_next) =
2881 ctx_statement_block($linenr, $realcnt, 0)
2882 if (!defined $stat);
Andy Whitcroft4d001e42008-10-15 22:02:21 -07002883 my ($s, $c) = ($stat, $cond);
2884
2885 substr($s, 0, length($c), '');
2886
2887 # Make sure we remove the line prefixes as we have
2888 # none on the first line, and are going to readd them
2889 # where necessary.
2890 $s =~ s/\n./\n/gs;
2891
2892 # Find out how long the conditional actually is.
Andy Whitcroft6f779c12008-10-15 22:02:27 -07002893 my @newlines = ($c =~ /\n/gs);
2894 my $cond_lines = 1 + $#newlines;
Andy Whitcroft4d001e42008-10-15 22:02:21 -07002895
2896 # We want to check the first line inside the block
2897 # starting at the end of the conditional, so remove:
2898 # 1) any blank line termination
2899 # 2) any opening brace { on end of the line
2900 # 3) any do (...) {
2901 my $continuation = 0;
2902 my $check = 0;
2903 $s =~ s/^.*\bdo\b//;
2904 $s =~ s/^\s*{//;
2905 if ($s =~ s/^\s*\\//) {
2906 $continuation = 1;
2907 }
Andy Whitcroft9bd49ef2008-10-15 22:02:22 -07002908 if ($s =~ s/^\s*?\n//) {
Andy Whitcroft4d001e42008-10-15 22:02:21 -07002909 $check = 1;
2910 $cond_lines++;
2911 }
2912
2913 # Also ignore a loop construct at the end of a
2914 # preprocessor statement.
2915 if (($prevline =~ /^.\s*#\s*define\s/ ||
2916 $prevline =~ /\\\s*$/) && $continuation == 0) {
2917 $check = 0;
2918 }
2919
Andy Whitcroft9bd49ef2008-10-15 22:02:22 -07002920 my $cond_ptr = -1;
Andy Whitcroft740504c2008-10-15 22:02:35 -07002921 $continuation = 0;
Andy Whitcroft9bd49ef2008-10-15 22:02:22 -07002922 while ($cond_ptr != $cond_lines) {
2923 $cond_ptr = $cond_lines;
Andy Whitcroft4d001e42008-10-15 22:02:21 -07002924
Andy Whitcroftf16fa282008-10-15 22:02:32 -07002925 # If we see an #else/#elif then the code
2926 # is not linear.
2927 if ($s =~ /^\s*\#\s*(?:else|elif)/) {
2928 $check = 0;
2929 }
2930
Andy Whitcroft9bd49ef2008-10-15 22:02:22 -07002931 # Ignore:
2932 # 1) blank lines, they should be at 0,
2933 # 2) preprocessor lines, and
2934 # 3) labels.
Andy Whitcroft740504c2008-10-15 22:02:35 -07002935 if ($continuation ||
2936 $s =~ /^\s*?\n/ ||
Andy Whitcroft9bd49ef2008-10-15 22:02:22 -07002937 $s =~ /^\s*#\s*?/ ||
2938 $s =~ /^\s*$Ident\s*:/) {
Andy Whitcroft740504c2008-10-15 22:02:35 -07002939 $continuation = ($s =~ /^.*?\\\n/) ? 1 : 0;
Andy Whitcroft30dad6e2009-09-21 17:04:36 -07002940 if ($s =~ s/^.*?\n//) {
2941 $cond_lines++;
2942 }
Andy Whitcroft9bd49ef2008-10-15 22:02:22 -07002943 }
Andy Whitcroft4d001e42008-10-15 22:02:21 -07002944 }
2945
2946 my (undef, $sindent) = line_stats("+" . $s);
2947 my $stat_real = raw_line($linenr, $cond_lines);
2948
2949 # Check if either of these lines are modified, else
2950 # this is not this patch's fault.
2951 if (!defined($stat_real) ||
2952 $stat !~ /^\+/ && $stat_real !~ /^\+/) {
2953 $check = 0;
2954 }
2955 if (defined($stat_real) && $cond_lines > 1) {
2956 $stat_real = "[...]\n$stat_real";
2957 }
2958
Andy Whitcroft9bd49ef2008-10-15 22:02:22 -07002959 #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";
Andy Whitcroft4d001e42008-10-15 22:02:21 -07002960
2961 if ($check && (($sindent % 8) != 0 ||
2962 ($sindent <= $indent && $s ne ''))) {
Joe Perches000d1cc12011-07-25 17:13:25 -07002963 WARN("SUSPECT_CODE_INDENT",
2964 "suspect code indent for conditional statements ($indent, $sindent)\n" . $herecurr . "$stat_real\n");
Andy Whitcroft4d001e42008-10-15 22:02:21 -07002965 }
2966 }
2967
Andy Whitcroft6c72ffa2007-10-18 03:05:08 -07002968 # Track the 'values' across context and added lines.
2969 my $opline = $line; $opline =~ s/^./ /;
Andy Whitcroft1f65f942008-07-23 21:29:10 -07002970 my ($curr_values, $curr_vars) =
2971 annotate_values($opline . "\n", $prev_values);
Andy Whitcroft6c72ffa2007-10-18 03:05:08 -07002972 $curr_values = $prev_values . $curr_values;
Andy Whitcroftc2fdda02008-02-08 04:20:54 -08002973 if ($dbg_values) {
2974 my $outline = $opline; $outline =~ s/\t/ /g;
Andy Whitcroftcf655042008-03-04 14:28:20 -08002975 print "$linenr > .$outline\n";
2976 print "$linenr > $curr_values\n";
Andy Whitcroft1f65f942008-07-23 21:29:10 -07002977 print "$linenr > $curr_vars\n";
Andy Whitcroftc2fdda02008-02-08 04:20:54 -08002978 }
Andy Whitcroft6c72ffa2007-10-18 03:05:08 -07002979 $prev_values = substr($curr_values, -1);
2980
Andy Whitcroft00df3442007-06-08 13:47:06 -07002981#ignore lines not being added
Joe Perches3705ce52013-07-03 15:05:31 -07002982 next if ($line =~ /^[^\+]/);
Andy Whitcroft00df3442007-06-08 13:47:06 -07002983
Andy Whitcroft653d4872007-06-23 17:16:34 -07002984# TEST: allow direct testing of the type matcher.
Andy Whitcroft7429c692008-07-23 21:29:06 -07002985 if ($dbg_type) {
2986 if ($line =~ /^.\s*$Declare\s*$/) {
Joe Perches000d1cc12011-07-25 17:13:25 -07002987 ERROR("TEST_TYPE",
2988 "TEST: is type\n" . $herecurr);
Andy Whitcroft7429c692008-07-23 21:29:06 -07002989 } elsif ($dbg_type > 1 && $line =~ /^.+($Declare)/) {
Joe Perches000d1cc12011-07-25 17:13:25 -07002990 ERROR("TEST_NOT_TYPE",
2991 "TEST: is not type ($1 is)\n". $herecurr);
Andy Whitcroft7429c692008-07-23 21:29:06 -07002992 }
Andy Whitcroft653d4872007-06-23 17:16:34 -07002993 next;
2994 }
Andy Whitcrofta1ef2772008-10-15 22:02:17 -07002995# TEST: allow direct testing of the attribute matcher.
2996 if ($dbg_attr) {
Andy Whitcroft9360b0e2009-02-27 14:03:08 -08002997 if ($line =~ /^.\s*$Modifier\s*$/) {
Joe Perches000d1cc12011-07-25 17:13:25 -07002998 ERROR("TEST_ATTR",
2999 "TEST: is attr\n" . $herecurr);
Andy Whitcroft9360b0e2009-02-27 14:03:08 -08003000 } elsif ($dbg_attr > 1 && $line =~ /^.+($Modifier)/) {
Joe Perches000d1cc12011-07-25 17:13:25 -07003001 ERROR("TEST_NOT_ATTR",
3002 "TEST: is not attr ($1 is)\n". $herecurr);
Andy Whitcrofta1ef2772008-10-15 22:02:17 -07003003 }
3004 next;
3005 }
Andy Whitcroft653d4872007-06-23 17:16:34 -07003006
Andy Whitcroftf0a594c2007-07-19 01:48:34 -07003007# check for initialisation to aggregates open brace on the next line
Andy Whitcroft99423c22009-10-26 16:50:15 -07003008 if ($line =~ /^.\s*{/ &&
3009 $prevline =~ /(?:^|[^=])=\s*$/) {
Joe Perchesd752fcc2014-08-06 16:11:05 -07003010 if (ERROR("OPEN_BRACE",
3011 "that open brace { should be on the previous line\n" . $hereprev) &&
Joe Perchesf2d7e4d2014-08-06 16:11:07 -07003012 $fix && $prevline =~ /^\+/ && $line =~ /^\+/) {
3013 fix_delete_line($fixlinenr - 1, $prevrawline);
3014 fix_delete_line($fixlinenr, $rawline);
Joe Perchesd752fcc2014-08-06 16:11:05 -07003015 my $fixedline = $prevrawline;
3016 $fixedline =~ s/\s*=\s*$/ = {/;
Joe Perchesf2d7e4d2014-08-06 16:11:07 -07003017 fix_insert_line($fixlinenr, $fixedline);
Joe Perchesd752fcc2014-08-06 16:11:05 -07003018 $fixedline = $line;
3019 $fixedline =~ s/^(.\s*){\s*/$1/;
Joe Perchesf2d7e4d2014-08-06 16:11:07 -07003020 fix_insert_line($fixlinenr, $fixedline);
Joe Perchesd752fcc2014-08-06 16:11:05 -07003021 }
Andy Whitcroftf0a594c2007-07-19 01:48:34 -07003022 }
3023
Andy Whitcroft653d4872007-06-23 17:16:34 -07003024#
3025# Checks which are anchored on the added line.
3026#
3027
3028# check for malformed paths in #include statements (uses RAW line)
Andy Whitcroftc45dcab2008-06-05 22:46:01 -07003029 if ($rawline =~ m{^.\s*\#\s*include\s+[<"](.*)[">]}) {
Andy Whitcroft653d4872007-06-23 17:16:34 -07003030 my $path = $1;
3031 if ($path =~ m{//}) {
Joe Perches000d1cc12011-07-25 17:13:25 -07003032 ERROR("MALFORMED_INCLUDE",
Joe Perches495e9d82012-12-20 15:05:37 -08003033 "malformed #include filename\n" . $herecurr);
3034 }
3035 if ($path =~ "^uapi/" && $realfile =~ m@\binclude/uapi/@) {
3036 ERROR("UAPI_INCLUDE",
3037 "No #include in ...include/uapi/... should use a uapi/ path prefix\n" . $herecurr);
Andy Whitcroft653d4872007-06-23 17:16:34 -07003038 }
Andy Whitcroft653d4872007-06-23 17:16:34 -07003039 }
Andy Whitcroft00df3442007-06-08 13:47:06 -07003040
3041# no C99 // comments
3042 if ($line =~ m{//}) {
Joe Perches3705ce52013-07-03 15:05:31 -07003043 if (ERROR("C99_COMMENTS",
3044 "do not use C99 // comments\n" . $herecurr) &&
3045 $fix) {
Joe Perches194f66f2014-08-06 16:11:03 -07003046 my $line = $fixed[$fixlinenr];
Joe Perches3705ce52013-07-03 15:05:31 -07003047 if ($line =~ /\/\/(.*)$/) {
3048 my $comment = trim($1);
Joe Perches194f66f2014-08-06 16:11:03 -07003049 $fixed[$fixlinenr] =~ s@\/\/(.*)$@/\* $comment \*/@;
Joe Perches3705ce52013-07-03 15:05:31 -07003050 }
3051 }
Andy Whitcroft00df3442007-06-08 13:47:06 -07003052 }
3053 # Remove C99 comments.
Andy Whitcroft0a920b5b2007-06-01 00:46:48 -07003054 $line =~ s@//.*@@;
Andy Whitcroft6c72ffa2007-10-18 03:05:08 -07003055 $opline =~ s@//.*@@;
Andy Whitcroft0a920b5b2007-06-01 00:46:48 -07003056
Andy Whitcroft2b474a12009-10-26 16:50:16 -07003057# EXPORT_SYMBOL should immediately follow the thing it is exporting, consider
3058# the whole statement.
3059#print "APW <$lines[$realline_next - 1]>\n";
3060 if (defined $realline_next &&
3061 exists $lines[$realline_next - 1] &&
3062 !defined $suppress_export{$realline_next} &&
3063 ($lines[$realline_next - 1] =~ /EXPORT_SYMBOL.*\((.*)\)/ ||
3064 $lines[$realline_next - 1] =~ /EXPORT_UNUSED_SYMBOL.*\((.*)\)/)) {
Andy Whitcroft3cbf62d2010-10-26 14:23:18 -07003065 # Handle definitions which produce identifiers with
3066 # a prefix:
3067 # XXX(foo);
3068 # EXPORT_SYMBOL(something_foo);
Andy Whitcroft653d4872007-06-23 17:16:34 -07003069 my $name = $1;
Andy Whitcroft87a53872012-01-10 15:10:04 -08003070 if ($stat =~ /^(?:.\s*}\s*\n)?.([A-Z_]+)\s*\(\s*($Ident)/ &&
Andy Whitcroft3cbf62d2010-10-26 14:23:18 -07003071 $name =~ /^${Ident}_$2/) {
3072#print "FOO C name<$name>\n";
3073 $suppress_export{$realline_next} = 1;
3074
3075 } elsif ($stat !~ /(?:
Andy Whitcroft2b474a12009-10-26 16:50:16 -07003076 \n.}\s*$|
Andy Whitcroft48012052008-10-15 22:02:34 -07003077 ^.DEFINE_$Ident\(\Q$name\E\)|
3078 ^.DECLARE_$Ident\(\Q$name\E\)|
3079 ^.LIST_HEAD\(\Q$name\E\)|
Andy Whitcroft2b474a12009-10-26 16:50:16 -07003080 ^.(?:$Storage\s+)?$Type\s*\(\s*\*\s*\Q$name\E\s*\)\s*\(|
3081 \b\Q$name\E(?:\s+$Attribute)*\s*(?:;|=|\[|\()
Andy Whitcroft48012052008-10-15 22:02:34 -07003082 )/x) {
Andy Whitcroft2b474a12009-10-26 16:50:16 -07003083#print "FOO A<$lines[$realline_next - 1]> stat<$stat> name<$name>\n";
3084 $suppress_export{$realline_next} = 2;
3085 } else {
3086 $suppress_export{$realline_next} = 1;
Andy Whitcroft0a920b5b2007-06-01 00:46:48 -07003087 }
3088 }
Andy Whitcroft2b474a12009-10-26 16:50:16 -07003089 if (!defined $suppress_export{$linenr} &&
3090 $prevline =~ /^.\s*$/ &&
3091 ($line =~ /EXPORT_SYMBOL.*\((.*)\)/ ||
3092 $line =~ /EXPORT_UNUSED_SYMBOL.*\((.*)\)/)) {
3093#print "FOO B <$lines[$linenr - 1]>\n";
3094 $suppress_export{$linenr} = 2;
3095 }
3096 if (defined $suppress_export{$linenr} &&
3097 $suppress_export{$linenr} == 2) {
Joe Perches000d1cc12011-07-25 17:13:25 -07003098 WARN("EXPORT_SYMBOL",
3099 "EXPORT_SYMBOL(foo); should immediately follow its function/variable\n" . $herecurr);
Andy Whitcroft2b474a12009-10-26 16:50:16 -07003100 }
Andy Whitcroft0a920b5b2007-06-01 00:46:48 -07003101
Joe Eloff5150bda2010-08-09 17:21:00 -07003102# check for global initialisers.
Joe Perchesd5e616f2013-09-11 14:23:54 -07003103 if ($line =~ /^\+(\s*$Type\s*$Ident\s*(?:\s+$Modifier))*\s*=\s*(0|NULL|false)\s*;/) {
3104 if (ERROR("GLOBAL_INITIALISERS",
3105 "do not initialise globals to 0 or NULL\n" .
3106 $herecurr) &&
3107 $fix) {
Joe Perches194f66f2014-08-06 16:11:03 -07003108 $fixed[$fixlinenr] =~ s/($Type\s*$Ident\s*(?:\s+$Modifier))*\s*=\s*(0|NULL|false)\s*;/$1;/;
Joe Perchesd5e616f2013-09-11 14:23:54 -07003109 }
Andy Whitcroftf0a594c2007-07-19 01:48:34 -07003110 }
Andy Whitcroft653d4872007-06-23 17:16:34 -07003111# check for static initialisers.
Joe Perchesd5e616f2013-09-11 14:23:54 -07003112 if ($line =~ /^\+.*\bstatic\s.*=\s*(0|NULL|false)\s*;/) {
3113 if (ERROR("INITIALISED_STATIC",
3114 "do not initialise statics to 0 or NULL\n" .
3115 $herecurr) &&
3116 $fix) {
Joe Perches194f66f2014-08-06 16:11:03 -07003117 $fixed[$fixlinenr] =~ s/(\bstatic\s.*?)\s*=\s*(0|NULL|false)\s*;/$1;/;
Joe Perchesd5e616f2013-09-11 14:23:54 -07003118 }
Andy Whitcroft0a920b5b2007-06-01 00:46:48 -07003119 }
3120
Joe Perches18130872014-08-06 16:11:22 -07003121# check for misordered declarations of char/short/int/long with signed/unsigned
3122 while ($sline =~ m{(\b$TypeMisordered\b)}g) {
3123 my $tmp = trim($1);
3124 WARN("MISORDERED_TYPE",
3125 "type '$tmp' should be specified in [[un]signed] [short|int|long|long long] order\n" . $herecurr);
3126 }
3127
Joe Perchescb710ec2010-10-26 14:23:20 -07003128# check for static const char * arrays.
3129 if ($line =~ /\bstatic\s+const\s+char\s*\*\s*(\w+)\s*\[\s*\]\s*=\s*/) {
Joe Perches000d1cc12011-07-25 17:13:25 -07003130 WARN("STATIC_CONST_CHAR_ARRAY",
3131 "static const char * array should probably be static const char * const\n" .
Joe Perchescb710ec2010-10-26 14:23:20 -07003132 $herecurr);
3133 }
3134
3135# check for static char foo[] = "bar" declarations.
3136 if ($line =~ /\bstatic\s+char\s+(\w+)\s*\[\s*\]\s*=\s*"/) {
Joe Perches000d1cc12011-07-25 17:13:25 -07003137 WARN("STATIC_CONST_CHAR_ARRAY",
3138 "static char array declaration should probably be static const char\n" .
Joe Perchescb710ec2010-10-26 14:23:20 -07003139 $herecurr);
3140 }
3141
Joe Perches9b0fa602014-04-03 14:49:18 -07003142# check for non-global char *foo[] = {"bar", ...} declarations.
3143 if ($line =~ /^.\s+(?:static\s+|const\s+)?char\s+\*\s*\w+\s*\[\s*\]\s*=\s*\{/) {
3144 WARN("STATIC_CONST_CHAR_ARRAY",
3145 "char * array declaration might be better as static const\n" .
3146 $herecurr);
3147 }
3148
Joe Perchesb36190c2014-01-27 17:07:18 -08003149# check for function declarations without arguments like "int foo()"
3150 if ($line =~ /(\b$Type\s+$Ident)\s*\(\s*\)/) {
3151 if (ERROR("FUNCTION_WITHOUT_ARGS",
3152 "Bad function definition - $1() should probably be $1(void)\n" . $herecurr) &&
3153 $fix) {
Joe Perches194f66f2014-08-06 16:11:03 -07003154 $fixed[$fixlinenr] =~ s/(\b($Type)\s+($Ident))\s*\(\s*\)/$2 $3(void)/;
Joe Perchesb36190c2014-01-27 17:07:18 -08003155 }
3156 }
3157
Joe Perches92e112f2013-12-13 11:36:22 -07003158# check for uses of DEFINE_PCI_DEVICE_TABLE
3159 if ($line =~ /\bDEFINE_PCI_DEVICE_TABLE\s*\(\s*(\w+)\s*\)\s*=/) {
3160 if (WARN("DEFINE_PCI_DEVICE_TABLE",
3161 "Prefer struct pci_device_id over deprecated DEFINE_PCI_DEVICE_TABLE\n" . $herecurr) &&
3162 $fix) {
Joe Perches194f66f2014-08-06 16:11:03 -07003163 $fixed[$fixlinenr] =~ s/\b(?:static\s+|)DEFINE_PCI_DEVICE_TABLE\s*\(\s*(\w+)\s*\)\s*=\s*/static const struct pci_device_id $1\[\] = /;
Joe Perches92e112f2013-12-13 11:36:22 -07003164 }
Joe Perches93ed0e22010-10-26 14:23:21 -07003165 }
3166
Andy Whitcroft653d4872007-06-23 17:16:34 -07003167# check for new typedefs, only function parameters and sparse annotations
3168# make sense.
3169 if ($line =~ /\btypedef\s/ &&
Andy Whitcroft80545762009-01-06 14:41:26 -08003170 $line !~ /\btypedef\s+$Type\s*\(\s*\*?$Ident\s*\)\s*\(/ &&
Andy Whitcroftc45dcab2008-06-05 22:46:01 -07003171 $line !~ /\btypedef\s+$Type\s+$Ident\s*\(/ &&
Andy Whitcroft8ed22ca2008-10-15 22:02:32 -07003172 $line !~ /\b$typeTypedefs\b/ &&
Joe Perches021158b2015-02-13 14:38:43 -08003173 $line !~ /\b$typeOtherOSTypedefs\b/ &&
Andy Whitcroft653d4872007-06-23 17:16:34 -07003174 $line !~ /\b__bitwise(?:__|)\b/) {
Joe Perches000d1cc12011-07-25 17:13:25 -07003175 WARN("NEW_TYPEDEFS",
3176 "do not add new typedefs\n" . $herecurr);
Andy Whitcroft0a920b5b2007-06-01 00:46:48 -07003177 }
3178
3179# * goes on variable not on type
Andy Whitcroft65863862009-01-06 14:41:21 -08003180 # (char*[ const])
Andy Whitcroftbfcb2cc2012-01-10 15:10:15 -08003181 while ($line =~ m{(\($NonptrType(\s*(?:$Modifier\b\s*|\*\s*)+)\))}g) {
3182 #print "AA<$1>\n";
Joe Perches3705ce52013-07-03 15:05:31 -07003183 my ($ident, $from, $to) = ($1, $2, $2);
Andy Whitcroftd8aaf122007-06-23 17:16:44 -07003184
Andy Whitcroft65863862009-01-06 14:41:21 -08003185 # Should start with a space.
3186 $to =~ s/^(\S)/ $1/;
3187 # Should not end with a space.
3188 $to =~ s/\s+$//;
3189 # '*'s should not have spaces between.
Andy Whitcroftf9a0b3d2009-01-15 13:51:05 -08003190 while ($to =~ s/\*\s+\*/\*\*/) {
Andy Whitcroft65863862009-01-06 14:41:21 -08003191 }
Andy Whitcroftd8aaf122007-06-23 17:16:44 -07003192
Joe Perches3705ce52013-07-03 15:05:31 -07003193## print "1: from<$from> to<$to> ident<$ident>\n";
Andy Whitcroft65863862009-01-06 14:41:21 -08003194 if ($from ne $to) {
Joe Perches3705ce52013-07-03 15:05:31 -07003195 if (ERROR("POINTER_LOCATION",
3196 "\"(foo$from)\" should be \"(foo$to)\"\n" . $herecurr) &&
3197 $fix) {
3198 my $sub_from = $ident;
3199 my $sub_to = $ident;
3200 $sub_to =~ s/\Q$from\E/$to/;
Joe Perches194f66f2014-08-06 16:11:03 -07003201 $fixed[$fixlinenr] =~
Joe Perches3705ce52013-07-03 15:05:31 -07003202 s@\Q$sub_from\E@$sub_to@;
3203 }
Andy Whitcroft65863862009-01-06 14:41:21 -08003204 }
Andy Whitcroftbfcb2cc2012-01-10 15:10:15 -08003205 }
3206 while ($line =~ m{(\b$NonptrType(\s*(?:$Modifier\b\s*|\*\s*)+)($Ident))}g) {
3207 #print "BB<$1>\n";
Joe Perches3705ce52013-07-03 15:05:31 -07003208 my ($match, $from, $to, $ident) = ($1, $2, $2, $3);
Andy Whitcroftd8aaf122007-06-23 17:16:44 -07003209
Andy Whitcroft65863862009-01-06 14:41:21 -08003210 # Should start with a space.
3211 $to =~ s/^(\S)/ $1/;
3212 # Should not end with a space.
3213 $to =~ s/\s+$//;
3214 # '*'s should not have spaces between.
Andy Whitcroftf9a0b3d2009-01-15 13:51:05 -08003215 while ($to =~ s/\*\s+\*/\*\*/) {
Andy Whitcroft65863862009-01-06 14:41:21 -08003216 }
3217 # Modifiers should have spaces.
3218 $to =~ s/(\b$Modifier$)/$1 /;
3219
Joe Perches3705ce52013-07-03 15:05:31 -07003220## print "2: from<$from> to<$to> ident<$ident>\n";
Andy Whitcroft667026e2009-02-27 14:03:08 -08003221 if ($from ne $to && $ident !~ /^$Modifier$/) {
Joe Perches3705ce52013-07-03 15:05:31 -07003222 if (ERROR("POINTER_LOCATION",
3223 "\"foo${from}bar\" should be \"foo${to}bar\"\n" . $herecurr) &&
3224 $fix) {
3225
3226 my $sub_from = $match;
3227 my $sub_to = $match;
3228 $sub_to =~ s/\Q$from\E/$to/;
Joe Perches194f66f2014-08-06 16:11:03 -07003229 $fixed[$fixlinenr] =~
Joe Perches3705ce52013-07-03 15:05:31 -07003230 s@\Q$sub_from\E@$sub_to@;
3231 }
Andy Whitcroft65863862009-01-06 14:41:21 -08003232 }
Andy Whitcroft0a920b5b2007-06-01 00:46:48 -07003233 }
3234
3235# # no BUG() or BUG_ON()
3236# if ($line =~ /\b(BUG|BUG_ON)\b/) {
3237# print "Try to use WARN_ON & Recovery code rather than BUG() or BUG_ON()\n";
3238# print "$herecurr";
3239# $clean = 0;
3240# }
3241
Andy Whitcroft8905a672007-11-28 16:21:06 -08003242 if ($line =~ /\bLINUX_VERSION_CODE\b/) {
Joe Perches000d1cc12011-07-25 17:13:25 -07003243 WARN("LINUX_VERSION_CODE",
3244 "LINUX_VERSION_CODE should be avoided, code should be for the version to which it is merged\n" . $herecurr);
Andy Whitcroft8905a672007-11-28 16:21:06 -08003245 }
3246
Joe Perches17441222011-06-15 15:08:17 -07003247# check for uses of printk_ratelimit
3248 if ($line =~ /\bprintk_ratelimit\s*\(/) {
Joe Perches000d1cc12011-07-25 17:13:25 -07003249 WARN("PRINTK_RATELIMITED",
Joe Perches101ee682015-02-13 14:38:54 -08003250 "Prefer printk_ratelimited or pr_<level>_ratelimited to printk_ratelimit\n" . $herecurr);
Joe Perches17441222011-06-15 15:08:17 -07003251 }
3252
Andy Whitcroft00df3442007-06-08 13:47:06 -07003253# printk should use KERN_* levels. Note that follow on printk's on the
3254# same line do not need a level, so we use the current block context
3255# to try and find and validate the current printk. In summary the current
Lucas De Marchi25985ed2011-03-30 22:57:33 -03003256# printk includes all preceding printk's which have no newline on the end.
Andy Whitcroft00df3442007-06-08 13:47:06 -07003257# we assume the first bad printk is the one to report.
Andy Whitcroftf0a594c2007-07-19 01:48:34 -07003258 if ($line =~ /\bprintk\((?!KERN_)\s*"/) {
Andy Whitcroft00df3442007-06-08 13:47:06 -07003259 my $ok = 0;
3260 for (my $ln = $linenr - 1; $ln >= $first_line; $ln--) {
3261 #print "CHECK<$lines[$ln - 1]\n";
Lucas De Marchi25985ed2011-03-30 22:57:33 -03003262 # we have a preceding printk if it ends
Andy Whitcroft00df3442007-06-08 13:47:06 -07003263 # with "\n" ignore it, else it is to blame
3264 if ($lines[$ln - 1] =~ m{\bprintk\(}) {
3265 if ($rawlines[$ln - 1] !~ m{\\n"}) {
3266 $ok = 1;
3267 }
3268 last;
3269 }
3270 }
3271 if ($ok == 0) {
Joe Perches000d1cc12011-07-25 17:13:25 -07003272 WARN("PRINTK_WITHOUT_KERN_LEVEL",
3273 "printk() should include KERN_ facility level\n" . $herecurr);
Andy Whitcroft00df3442007-06-08 13:47:06 -07003274 }
Andy Whitcroft0a920b5b2007-06-01 00:46:48 -07003275 }
3276
Joe Perches243f3802012-05-31 16:26:09 -07003277 if ($line =~ /\bprintk\s*\(\s*KERN_([A-Z]+)/) {
3278 my $orig = $1;
3279 my $level = lc($orig);
3280 $level = "warn" if ($level eq "warning");
Joe Perches8f26b832012-10-04 17:13:32 -07003281 my $level2 = $level;
3282 $level2 = "dbg" if ($level eq "debug");
Joe Perches243f3802012-05-31 16:26:09 -07003283 WARN("PREFER_PR_LEVEL",
Yogesh Chaudharidaa8b052014-04-03 14:49:23 -07003284 "Prefer [subsystem eg: netdev]_$level2([subsystem]dev, ... then dev_$level2(dev, ... then pr_$level(... to printk(KERN_$orig ...\n" . $herecurr);
Joe Perches243f3802012-05-31 16:26:09 -07003285 }
3286
3287 if ($line =~ /\bpr_warning\s*\(/) {
Joe Perchesd5e616f2013-09-11 14:23:54 -07003288 if (WARN("PREFER_PR_LEVEL",
3289 "Prefer pr_warn(... to pr_warning(...\n" . $herecurr) &&
3290 $fix) {
Joe Perches194f66f2014-08-06 16:11:03 -07003291 $fixed[$fixlinenr] =~
Joe Perchesd5e616f2013-09-11 14:23:54 -07003292 s/\bpr_warning\b/pr_warn/;
3293 }
Joe Perches243f3802012-05-31 16:26:09 -07003294 }
3295
Joe Perchesdc139312013-02-21 16:44:13 -08003296 if ($line =~ /\bdev_printk\s*\(\s*KERN_([A-Z]+)/) {
3297 my $orig = $1;
3298 my $level = lc($orig);
3299 $level = "warn" if ($level eq "warning");
3300 $level = "dbg" if ($level eq "debug");
3301 WARN("PREFER_DEV_LEVEL",
3302 "Prefer dev_$level(... to dev_printk(KERN_$orig, ...\n" . $herecurr);
3303 }
3304
Andy Whitcroft653d4872007-06-23 17:16:34 -07003305# function brace can't be on same line, except for #defines of do while,
3306# or if closed on same line
Joe Perches8d182472014-08-06 16:11:12 -07003307 if (($line=~/$Type\s*$Ident\(.*\).*\s*{/) and
Andy Whitcroftc45dcab2008-06-05 22:46:01 -07003308 !($line=~/\#\s*define.*do\s{/) and !($line=~/}/)) {
Joe Perches8d182472014-08-06 16:11:12 -07003309 if (ERROR("OPEN_BRACE",
3310 "open brace '{' following function declarations go on the next line\n" . $herecurr) &&
3311 $fix) {
3312 fix_delete_line($fixlinenr, $rawline);
3313 my $fixed_line = $rawline;
3314 $fixed_line =~ /(^..*$Type\s*$Ident\(.*\)\s*){(.*)$/;
3315 my $line1 = $1;
3316 my $line2 = $2;
3317 fix_insert_line($fixlinenr, ltrim($line1));
3318 fix_insert_line($fixlinenr, "\+{");
3319 if ($line2 !~ /^\s*$/) {
3320 fix_insert_line($fixlinenr, "\+\t" . trim($line2));
3321 }
3322 }
Andy Whitcroft0a920b5b2007-06-01 00:46:48 -07003323 }
Andy Whitcroft653d4872007-06-23 17:16:34 -07003324
Andy Whitcroft8905a672007-11-28 16:21:06 -08003325# open braces for enum, union and struct go on the same line.
3326 if ($line =~ /^.\s*{/ &&
3327 $prevline =~ /^.\s*(?:typedef\s+)?(enum|union|struct)(?:\s+$Ident)?\s*$/) {
Joe Perches8d182472014-08-06 16:11:12 -07003328 if (ERROR("OPEN_BRACE",
3329 "open brace '{' following $1 go on the same line\n" . $hereprev) &&
3330 $fix && $prevline =~ /^\+/ && $line =~ /^\+/) {
3331 fix_delete_line($fixlinenr - 1, $prevrawline);
3332 fix_delete_line($fixlinenr, $rawline);
3333 my $fixedline = rtrim($prevrawline) . " {";
3334 fix_insert_line($fixlinenr, $fixedline);
3335 $fixedline = $rawline;
3336 $fixedline =~ s/^(.\s*){\s*/$1\t/;
3337 if ($fixedline !~ /^\+\s*$/) {
3338 fix_insert_line($fixlinenr, $fixedline);
3339 }
3340 }
Andy Whitcroft8905a672007-11-28 16:21:06 -08003341 }
3342
Andy Whitcroft0c73b4e2010-10-26 14:23:15 -07003343# missing space after union, struct or enum definition
Joe Perches3705ce52013-07-03 15:05:31 -07003344 if ($line =~ /^.\s*(?:typedef\s+)?(enum|union|struct)(?:\s+$Ident){1,2}[=\{]/) {
3345 if (WARN("SPACING",
3346 "missing space after $1 definition\n" . $herecurr) &&
3347 $fix) {
Joe Perches194f66f2014-08-06 16:11:03 -07003348 $fixed[$fixlinenr] =~
Joe Perches3705ce52013-07-03 15:05:31 -07003349 s/^(.\s*(?:typedef\s+)?(?:enum|union|struct)(?:\s+$Ident){1,2})([=\{])/$1 $2/;
3350 }
Andy Whitcroft0c73b4e2010-10-26 14:23:15 -07003351 }
3352
Joe Perches31070b52014-01-23 15:54:49 -08003353# Function pointer declarations
3354# check spacing between type, funcptr, and args
3355# canonical declaration is "type (*funcptr)(args...)"
Joe Perches91f72e92014-04-03 14:49:12 -07003356 if ($line =~ /^.\s*($Declare)\((\s*)\*(\s*)($Ident)(\s*)\)(\s*)\(/) {
Joe Perches31070b52014-01-23 15:54:49 -08003357 my $declare = $1;
3358 my $pre_pointer_space = $2;
3359 my $post_pointer_space = $3;
3360 my $funcname = $4;
3361 my $post_funcname_space = $5;
3362 my $pre_args_space = $6;
3363
Joe Perches91f72e92014-04-03 14:49:12 -07003364# the $Declare variable will capture all spaces after the type
3365# so check it for a missing trailing missing space but pointer return types
3366# don't need a space so don't warn for those.
3367 my $post_declare_space = "";
3368 if ($declare =~ /(\s+)$/) {
3369 $post_declare_space = $1;
3370 $declare = rtrim($declare);
3371 }
3372 if ($declare !~ /\*$/ && $post_declare_space =~ /^$/) {
Joe Perches31070b52014-01-23 15:54:49 -08003373 WARN("SPACING",
3374 "missing space after return type\n" . $herecurr);
Joe Perches91f72e92014-04-03 14:49:12 -07003375 $post_declare_space = " ";
Joe Perches31070b52014-01-23 15:54:49 -08003376 }
3377
3378# unnecessary space "type (*funcptr)(args...)"
Joe Perches91f72e92014-04-03 14:49:12 -07003379# This test is not currently implemented because these declarations are
3380# equivalent to
3381# int foo(int bar, ...)
3382# and this is form shouldn't/doesn't generate a checkpatch warning.
3383#
3384# elsif ($declare =~ /\s{2,}$/) {
3385# WARN("SPACING",
3386# "Multiple spaces after return type\n" . $herecurr);
3387# }
Joe Perches31070b52014-01-23 15:54:49 -08003388
3389# unnecessary space "type ( *funcptr)(args...)"
3390 if (defined $pre_pointer_space &&
3391 $pre_pointer_space =~ /^\s/) {
3392 WARN("SPACING",
3393 "Unnecessary space after function pointer open parenthesis\n" . $herecurr);
3394 }
3395
3396# unnecessary space "type (* funcptr)(args...)"
3397 if (defined $post_pointer_space &&
3398 $post_pointer_space =~ /^\s/) {
3399 WARN("SPACING",
3400 "Unnecessary space before function pointer name\n" . $herecurr);
3401 }
3402
3403# unnecessary space "type (*funcptr )(args...)"
3404 if (defined $post_funcname_space &&
3405 $post_funcname_space =~ /^\s/) {
3406 WARN("SPACING",
3407 "Unnecessary space after function pointer name\n" . $herecurr);
3408 }
3409
3410# unnecessary space "type (*funcptr) (args...)"
3411 if (defined $pre_args_space &&
3412 $pre_args_space =~ /^\s/) {
3413 WARN("SPACING",
3414 "Unnecessary space before function pointer arguments\n" . $herecurr);
3415 }
3416
3417 if (show_type("SPACING") && $fix) {
Joe Perches194f66f2014-08-06 16:11:03 -07003418 $fixed[$fixlinenr] =~
Joe Perches91f72e92014-04-03 14:49:12 -07003419 s/^(.\s*)$Declare\s*\(\s*\*\s*$Ident\s*\)\s*\(/$1 . $declare . $post_declare_space . '(*' . $funcname . ')('/ex;
Joe Perches31070b52014-01-23 15:54:49 -08003420 }
3421 }
3422
Andy Whitcroft8d31cfc2008-07-23 21:29:02 -07003423# check for spacing round square brackets; allowed:
3424# 1. with a type on the left -- int [] a;
Andy Whitcroftfe2a7db2008-10-15 22:02:15 -07003425# 2. at the beginning of a line for slice initialisers -- [0...10] = 5,
3426# 3. inside a curly brace -- = { [0...10] = 5 }
Andy Whitcroft8d31cfc2008-07-23 21:29:02 -07003427 while ($line =~ /(.*?\s)\[/g) {
3428 my ($where, $prefix) = ($-[1], $1);
3429 if ($prefix !~ /$Type\s+$/ &&
Andy Whitcroftfe2a7db2008-10-15 22:02:15 -07003430 ($where != 0 || $prefix !~ /^.\s+$/) &&
Andy Whitcroftdaebc532012-03-23 15:02:17 -07003431 $prefix !~ /[{,]\s+$/) {
Joe Perches3705ce52013-07-03 15:05:31 -07003432 if (ERROR("BRACKET_SPACE",
3433 "space prohibited before open square bracket '['\n" . $herecurr) &&
3434 $fix) {
Joe Perches194f66f2014-08-06 16:11:03 -07003435 $fixed[$fixlinenr] =~
Joe Perches3705ce52013-07-03 15:05:31 -07003436 s/^(\+.*?)\s+\[/$1\[/;
3437 }
Andy Whitcroft8d31cfc2008-07-23 21:29:02 -07003438 }
3439 }
3440
Andy Whitcroftf0a594c2007-07-19 01:48:34 -07003441# check for spaces between functions and their parentheses.
Andy Whitcroft6c72ffa2007-10-18 03:05:08 -07003442 while ($line =~ /($Ident)\s+\(/g) {
Andy Whitcroftc2fdda02008-02-08 04:20:54 -08003443 my $name = $1;
Andy Whitcroft773647a2008-03-28 14:15:58 -07003444 my $ctx_before = substr($line, 0, $-[1]);
3445 my $ctx = "$ctx_before$name";
Andy Whitcroftc2fdda02008-02-08 04:20:54 -08003446
3447 # Ignore those directives where spaces _are_ permitted.
Andy Whitcroft773647a2008-03-28 14:15:58 -07003448 if ($name =~ /^(?:
3449 if|for|while|switch|return|case|
3450 volatile|__volatile__|
3451 __attribute__|format|__extension__|
3452 asm|__asm__)$/x)
3453 {
Andy Whitcroftc2fdda02008-02-08 04:20:54 -08003454 # cpp #define statements have non-optional spaces, ie
3455 # if there is a space between the name and the open
3456 # parenthesis it is simply not a parameter group.
Andy Whitcroftc45dcab2008-06-05 22:46:01 -07003457 } elsif ($ctx_before =~ /^.\s*\#\s*define\s*$/) {
Andy Whitcroft773647a2008-03-28 14:15:58 -07003458
3459 # cpp #elif statement condition may start with a (
Andy Whitcroftc45dcab2008-06-05 22:46:01 -07003460 } elsif ($ctx =~ /^.\s*\#\s*elif\s*$/) {
Andy Whitcroftc2fdda02008-02-08 04:20:54 -08003461
3462 # If this whole things ends with a type its most
3463 # likely a typedef for a function.
Andy Whitcroft773647a2008-03-28 14:15:58 -07003464 } elsif ($ctx =~ /$Type$/) {
Andy Whitcroftc2fdda02008-02-08 04:20:54 -08003465
3466 } else {
Joe Perches3705ce52013-07-03 15:05:31 -07003467 if (WARN("SPACING",
3468 "space prohibited between function name and open parenthesis '('\n" . $herecurr) &&
3469 $fix) {
Joe Perches194f66f2014-08-06 16:11:03 -07003470 $fixed[$fixlinenr] =~
Joe Perches3705ce52013-07-03 15:05:31 -07003471 s/\b$name\s+\(/$name\(/;
3472 }
Andy Whitcroft6c72ffa2007-10-18 03:05:08 -07003473 }
Andy Whitcroftf0a594c2007-07-19 01:48:34 -07003474 }
Eric Nelson9a4cad42012-05-31 16:26:09 -07003475
Andy Whitcroft653d4872007-06-23 17:16:34 -07003476# Check operator spacing.
Andy Whitcroft0a920b5b2007-06-01 00:46:48 -07003477 if (!($line=~/\#\s*include/)) {
Joe Perches3705ce52013-07-03 15:05:31 -07003478 my $fixed_line = "";
3479 my $line_fixed = 0;
3480
Andy Whitcroft9c0ca6f2007-10-16 23:29:38 -07003481 my $ops = qr{
3482 <<=|>>=|<=|>=|==|!=|
3483 \+=|-=|\*=|\/=|%=|\^=|\|=|&=|
3484 =>|->|<<|>>|<|>|=|!|~|
Andy Whitcroft1f65f942008-07-23 21:29:10 -07003485 &&|\|\||,|\^|\+\+|--|&|\||\+|-|\*|\/|%|
Joe Perches84731622013-11-12 15:10:05 -08003486 \?:|\?|:
Andy Whitcroft9c0ca6f2007-10-16 23:29:38 -07003487 }x;
Andy Whitcroftcf655042008-03-04 14:28:20 -08003488 my @elements = split(/($ops|;)/, $opline);
Joe Perches3705ce52013-07-03 15:05:31 -07003489
3490## print("element count: <" . $#elements . ">\n");
3491## foreach my $el (@elements) {
3492## print("el: <$el>\n");
3493## }
3494
3495 my @fix_elements = ();
Andy Whitcroft00df3442007-06-08 13:47:06 -07003496 my $off = 0;
Andy Whitcroft6c72ffa2007-10-18 03:05:08 -07003497
Joe Perches3705ce52013-07-03 15:05:31 -07003498 foreach my $el (@elements) {
3499 push(@fix_elements, substr($rawline, $off, length($el)));
3500 $off += length($el);
3501 }
3502
3503 $off = 0;
3504
Andy Whitcroft6c72ffa2007-10-18 03:05:08 -07003505 my $blank = copy_spacing($opline);
Joe Perchesb34c6482013-09-11 14:24:01 -07003506 my $last_after = -1;
Andy Whitcroft6c72ffa2007-10-18 03:05:08 -07003507
Andy Whitcroft0a920b5b2007-06-01 00:46:48 -07003508 for (my $n = 0; $n < $#elements; $n += 2) {
Joe Perches3705ce52013-07-03 15:05:31 -07003509
3510 my $good = $fix_elements[$n] . $fix_elements[$n + 1];
3511
3512## print("n: <$n> good: <$good>\n");
3513
Andy Whitcroft4a0df2e2007-06-08 13:46:39 -07003514 $off += length($elements[$n]);
3515
Lucas De Marchi25985ed2011-03-30 22:57:33 -03003516 # Pick up the preceding and succeeding characters.
Andy Whitcroft773647a2008-03-28 14:15:58 -07003517 my $ca = substr($opline, 0, $off);
3518 my $cc = '';
3519 if (length($opline) >= ($off + length($elements[$n + 1]))) {
3520 $cc = substr($opline, $off + length($elements[$n + 1]));
3521 }
3522 my $cb = "$ca$;$cc";
3523
Andy Whitcroft4a0df2e2007-06-08 13:46:39 -07003524 my $a = '';
3525 $a = 'V' if ($elements[$n] ne '');
3526 $a = 'W' if ($elements[$n] =~ /\s$/);
Andy Whitcroftcf655042008-03-04 14:28:20 -08003527 $a = 'C' if ($elements[$n] =~ /$;$/);
Andy Whitcroft4a0df2e2007-06-08 13:46:39 -07003528 $a = 'B' if ($elements[$n] =~ /(\[|\()$/);
3529 $a = 'O' if ($elements[$n] eq '');
Andy Whitcroft773647a2008-03-28 14:15:58 -07003530 $a = 'E' if ($ca =~ /^\s*$/);
Andy Whitcroft4a0df2e2007-06-08 13:46:39 -07003531
Andy Whitcroft0a920b5b2007-06-01 00:46:48 -07003532 my $op = $elements[$n + 1];
Andy Whitcroft4a0df2e2007-06-08 13:46:39 -07003533
3534 my $c = '';
Andy Whitcroft0a920b5b2007-06-01 00:46:48 -07003535 if (defined $elements[$n + 2]) {
Andy Whitcroft4a0df2e2007-06-08 13:46:39 -07003536 $c = 'V' if ($elements[$n + 2] ne '');
3537 $c = 'W' if ($elements[$n + 2] =~ /^\s/);
Andy Whitcroftcf655042008-03-04 14:28:20 -08003538 $c = 'C' if ($elements[$n + 2] =~ /^$;/);
Andy Whitcroft4a0df2e2007-06-08 13:46:39 -07003539 $c = 'B' if ($elements[$n + 2] =~ /^(\)|\]|;)/);
3540 $c = 'O' if ($elements[$n + 2] eq '');
Andy Whitcroft8b1b3372009-01-06 14:41:27 -08003541 $c = 'E' if ($elements[$n + 2] =~ /^\s*\\$/);
Andy Whitcroft4a0df2e2007-06-08 13:46:39 -07003542 } else {
3543 $c = 'E';
Andy Whitcroft0a920b5b2007-06-01 00:46:48 -07003544 }
3545
Andy Whitcroft4a0df2e2007-06-08 13:46:39 -07003546 my $ctx = "${a}x${c}";
3547
3548 my $at = "(ctx:$ctx)";
3549
Andy Whitcroft6c72ffa2007-10-18 03:05:08 -07003550 my $ptr = substr($blank, 0, $off) . "^";
Andy Whitcroftde7d4f02007-07-15 23:37:22 -07003551 my $hereptr = "$hereline$ptr\n";
Andy Whitcroft0a920b5b2007-06-01 00:46:48 -07003552
Andy Whitcroft74048ed2008-07-23 21:29:10 -07003553 # Pull out the value of this operator.
Andy Whitcroft6c72ffa2007-10-18 03:05:08 -07003554 my $op_type = substr($curr_values, $off + 1, 1);
Andy Whitcroft0a920b5b2007-06-01 00:46:48 -07003555
Andy Whitcroft1f65f942008-07-23 21:29:10 -07003556 # Get the full operator variant.
3557 my $opv = $op . substr($curr_vars, $off, 1);
3558
Andy Whitcroft13214ad2008-02-08 04:22:03 -08003559 # Ignore operators passed as parameters.
3560 if ($op_type ne 'V' &&
3561 $ca =~ /\s$/ && $cc =~ /^\s*,/) {
3562
Andy Whitcroftcf655042008-03-04 14:28:20 -08003563# # Ignore comments
3564# } elsif ($op =~ /^$;+$/) {
Andy Whitcroft13214ad2008-02-08 04:22:03 -08003565
Andy Whitcroftd8aaf122007-06-23 17:16:44 -07003566 # ; should have either the end of line or a space or \ after it
Andy Whitcroft13214ad2008-02-08 04:22:03 -08003567 } elsif ($op eq ';') {
Andy Whitcroftcf655042008-03-04 14:28:20 -08003568 if ($ctx !~ /.x[WEBC]/ &&
3569 $cc !~ /^\\/ && $cc !~ /^;/) {
Joe Perches3705ce52013-07-03 15:05:31 -07003570 if (ERROR("SPACING",
3571 "space required after that '$op' $at\n" . $hereptr)) {
Joe Perchesb34c6482013-09-11 14:24:01 -07003572 $good = $fix_elements[$n] . trim($fix_elements[$n + 1]) . " ";
Joe Perches3705ce52013-07-03 15:05:31 -07003573 $line_fixed = 1;
3574 }
Andy Whitcroftd8aaf122007-06-23 17:16:44 -07003575 }
3576
3577 # // is a comment
3578 } elsif ($op eq '//') {
Andy Whitcroft0a920b5b2007-06-01 00:46:48 -07003579
Joe Perchesb00e4812014-04-03 14:49:33 -07003580 # : when part of a bitfield
3581 } elsif ($opv eq ':B') {
3582 # skip the bitfield test for now
3583
Andy Whitcroft1f65f942008-07-23 21:29:10 -07003584 # No spaces for:
3585 # ->
Joe Perchesb00e4812014-04-03 14:49:33 -07003586 } elsif ($op eq '->') {
Andy Whitcroft4a0df2e2007-06-08 13:46:39 -07003587 if ($ctx =~ /Wx.|.xW/) {
Joe Perches3705ce52013-07-03 15:05:31 -07003588 if (ERROR("SPACING",
3589 "spaces prohibited around that '$op' $at\n" . $hereptr)) {
Joe Perchesb34c6482013-09-11 14:24:01 -07003590 $good = rtrim($fix_elements[$n]) . trim($fix_elements[$n + 1]);
Joe Perches3705ce52013-07-03 15:05:31 -07003591 if (defined $fix_elements[$n + 2]) {
3592 $fix_elements[$n + 2] =~ s/^\s+//;
3593 }
Joe Perchesb34c6482013-09-11 14:24:01 -07003594 $line_fixed = 1;
Joe Perches3705ce52013-07-03 15:05:31 -07003595 }
Andy Whitcroft0a920b5b2007-06-01 00:46:48 -07003596 }
3597
Joe Perches23810972014-12-10 15:51:32 -08003598 # , must not have a space before and must have a space on the right.
Andy Whitcroft0a920b5b2007-06-01 00:46:48 -07003599 } elsif ($op eq ',') {
Joe Perches23810972014-12-10 15:51:32 -08003600 my $rtrim_before = 0;
3601 my $space_after = 0;
3602 if ($ctx =~ /Wx./) {
3603 if (ERROR("SPACING",
3604 "space prohibited before that '$op' $at\n" . $hereptr)) {
3605 $line_fixed = 1;
3606 $rtrim_before = 1;
3607 }
3608 }
Andy Whitcroftcf655042008-03-04 14:28:20 -08003609 if ($ctx !~ /.x[WEC]/ && $cc !~ /^}/) {
Joe Perches3705ce52013-07-03 15:05:31 -07003610 if (ERROR("SPACING",
3611 "space required after that '$op' $at\n" . $hereptr)) {
Joe Perches3705ce52013-07-03 15:05:31 -07003612 $line_fixed = 1;
Joe Perchesb34c6482013-09-11 14:24:01 -07003613 $last_after = $n;
Joe Perches23810972014-12-10 15:51:32 -08003614 $space_after = 1;
3615 }
3616 }
3617 if ($rtrim_before || $space_after) {
3618 if ($rtrim_before) {
3619 $good = rtrim($fix_elements[$n]) . trim($fix_elements[$n + 1]);
3620 } else {
3621 $good = $fix_elements[$n] . trim($fix_elements[$n + 1]);
3622 }
3623 if ($space_after) {
3624 $good .= " ";
Joe Perches3705ce52013-07-03 15:05:31 -07003625 }
Andy Whitcroft0a920b5b2007-06-01 00:46:48 -07003626 }
3627
Andy Whitcroft9c0ca6f2007-10-16 23:29:38 -07003628 # '*' as part of a type definition -- reported already.
Andy Whitcroft74048ed2008-07-23 21:29:10 -07003629 } elsif ($opv eq '*_') {
Andy Whitcroft9c0ca6f2007-10-16 23:29:38 -07003630 #warn "'*' is part of type\n";
3631
3632 # unary operators should have a space before and
3633 # none after. May be left adjacent to another
3634 # unary operator, or a cast
3635 } elsif ($op eq '!' || $op eq '~' ||
Andy Whitcroft74048ed2008-07-23 21:29:10 -07003636 $opv eq '*U' || $opv eq '-U' ||
Andy Whitcroft0d413862008-10-15 22:02:16 -07003637 $opv eq '&U' || $opv eq '&&U') {
Andy Whitcroftcf655042008-03-04 14:28:20 -08003638 if ($ctx !~ /[WEBC]x./ && $ca !~ /(?:\)|!|~|\*|-|\&|\||\+\+|\-\-|\{)$/) {
Joe Perches3705ce52013-07-03 15:05:31 -07003639 if (ERROR("SPACING",
3640 "space required before that '$op' $at\n" . $hereptr)) {
Joe Perchesb34c6482013-09-11 14:24:01 -07003641 if ($n != $last_after + 2) {
3642 $good = $fix_elements[$n] . " " . ltrim($fix_elements[$n + 1]);
3643 $line_fixed = 1;
3644 }
Joe Perches3705ce52013-07-03 15:05:31 -07003645 }
Andy Whitcroft0a920b5b2007-06-01 00:46:48 -07003646 }
Andy Whitcrofta3340b32009-02-27 14:03:07 -08003647 if ($op eq '*' && $cc =~/\s*$Modifier\b/) {
Andy Whitcroft171ae1a2008-04-29 00:59:32 -07003648 # A unary '*' may be const
3649
3650 } elsif ($ctx =~ /.xW/) {
Joe Perches3705ce52013-07-03 15:05:31 -07003651 if (ERROR("SPACING",
3652 "space prohibited after that '$op' $at\n" . $hereptr)) {
Joe Perchesb34c6482013-09-11 14:24:01 -07003653 $good = $fix_elements[$n] . rtrim($fix_elements[$n + 1]);
Joe Perches3705ce52013-07-03 15:05:31 -07003654 if (defined $fix_elements[$n + 2]) {
3655 $fix_elements[$n + 2] =~ s/^\s+//;
3656 }
Joe Perchesb34c6482013-09-11 14:24:01 -07003657 $line_fixed = 1;
Joe Perches3705ce52013-07-03 15:05:31 -07003658 }
Andy Whitcroft0a920b5b2007-06-01 00:46:48 -07003659 }
3660
3661 # unary ++ and unary -- are allowed no space on one side.
3662 } elsif ($op eq '++' or $op eq '--') {
Andy Whitcroft773647a2008-03-28 14:15:58 -07003663 if ($ctx !~ /[WEOBC]x[^W]/ && $ctx !~ /[^W]x[WOBEC]/) {
Joe Perches3705ce52013-07-03 15:05:31 -07003664 if (ERROR("SPACING",
3665 "space required one side of that '$op' $at\n" . $hereptr)) {
Joe Perchesb34c6482013-09-11 14:24:01 -07003666 $good = $fix_elements[$n] . trim($fix_elements[$n + 1]) . " ";
Joe Perches3705ce52013-07-03 15:05:31 -07003667 $line_fixed = 1;
3668 }
Andy Whitcroft0a920b5b2007-06-01 00:46:48 -07003669 }
Andy Whitcroft773647a2008-03-28 14:15:58 -07003670 if ($ctx =~ /Wx[BE]/ ||
3671 ($ctx =~ /Wx./ && $cc =~ /^;/)) {
Joe Perches3705ce52013-07-03 15:05:31 -07003672 if (ERROR("SPACING",
3673 "space prohibited before that '$op' $at\n" . $hereptr)) {
Joe Perchesb34c6482013-09-11 14:24:01 -07003674 $good = rtrim($fix_elements[$n]) . trim($fix_elements[$n + 1]);
Joe Perches3705ce52013-07-03 15:05:31 -07003675 $line_fixed = 1;
3676 }
Andy Whitcroft653d4872007-06-23 17:16:34 -07003677 }
Andy Whitcroft773647a2008-03-28 14:15:58 -07003678 if ($ctx =~ /ExW/) {
Joe Perches3705ce52013-07-03 15:05:31 -07003679 if (ERROR("SPACING",
3680 "space prohibited after that '$op' $at\n" . $hereptr)) {
Joe Perchesb34c6482013-09-11 14:24:01 -07003681 $good = $fix_elements[$n] . trim($fix_elements[$n + 1]);
Joe Perches3705ce52013-07-03 15:05:31 -07003682 if (defined $fix_elements[$n + 2]) {
3683 $fix_elements[$n + 2] =~ s/^\s+//;
3684 }
Joe Perchesb34c6482013-09-11 14:24:01 -07003685 $line_fixed = 1;
Joe Perches3705ce52013-07-03 15:05:31 -07003686 }
Andy Whitcroft773647a2008-03-28 14:15:58 -07003687 }
3688
Andy Whitcroft0a920b5b2007-06-01 00:46:48 -07003689 # << and >> may either have or not have spaces both sides
Andy Whitcroft9c0ca6f2007-10-16 23:29:38 -07003690 } elsif ($op eq '<<' or $op eq '>>' or
3691 $op eq '&' or $op eq '^' or $op eq '|' or
3692 $op eq '+' or $op eq '-' or
Andy Whitcroftc2fdda02008-02-08 04:20:54 -08003693 $op eq '*' or $op eq '/' or
3694 $op eq '%')
Andy Whitcroft0a920b5b2007-06-01 00:46:48 -07003695 {
Joe Perchesd2e025f2015-02-13 14:38:57 -08003696 if ($check) {
3697 if (defined $fix_elements[$n + 2] && $ctx !~ /[EW]x[EW]/) {
3698 if (CHK("SPACING",
3699 "spaces preferred around that '$op' $at\n" . $hereptr)) {
3700 $good = rtrim($fix_elements[$n]) . " " . trim($fix_elements[$n + 1]) . " ";
3701 $fix_elements[$n + 2] =~ s/^\s+//;
3702 $line_fixed = 1;
3703 }
3704 } elsif (!defined $fix_elements[$n + 2] && $ctx !~ /Wx[OE]/) {
3705 if (CHK("SPACING",
3706 "space preferred before that '$op' $at\n" . $hereptr)) {
3707 $good = rtrim($fix_elements[$n]) . " " . trim($fix_elements[$n + 1]);
3708 $line_fixed = 1;
3709 }
3710 }
3711 } elsif ($ctx =~ /Wx[^WCE]|[^WCE]xW/) {
Joe Perches3705ce52013-07-03 15:05:31 -07003712 if (ERROR("SPACING",
3713 "need consistent spacing around '$op' $at\n" . $hereptr)) {
Joe Perchesb34c6482013-09-11 14:24:01 -07003714 $good = rtrim($fix_elements[$n]) . " " . trim($fix_elements[$n + 1]) . " ";
3715 if (defined $fix_elements[$n + 2]) {
3716 $fix_elements[$n + 2] =~ s/^\s+//;
3717 }
Joe Perches3705ce52013-07-03 15:05:31 -07003718 $line_fixed = 1;
3719 }
Andy Whitcroft0a920b5b2007-06-01 00:46:48 -07003720 }
3721
Andy Whitcroft1f65f942008-07-23 21:29:10 -07003722 # A colon needs no spaces before when it is
3723 # terminating a case value or a label.
3724 } elsif ($opv eq ':C' || $opv eq ':L') {
3725 if ($ctx =~ /Wx./) {
Joe Perches3705ce52013-07-03 15:05:31 -07003726 if (ERROR("SPACING",
3727 "space prohibited before that '$op' $at\n" . $hereptr)) {
Joe Perchesb34c6482013-09-11 14:24:01 -07003728 $good = rtrim($fix_elements[$n]) . trim($fix_elements[$n + 1]);
Joe Perches3705ce52013-07-03 15:05:31 -07003729 $line_fixed = 1;
3730 }
Andy Whitcroft1f65f942008-07-23 21:29:10 -07003731 }
3732
Andy Whitcroft0a920b5b2007-06-01 00:46:48 -07003733 # All the others need spaces both sides.
Andy Whitcroftcf655042008-03-04 14:28:20 -08003734 } elsif ($ctx !~ /[EWC]x[CWE]/) {
Andy Whitcroft1f65f942008-07-23 21:29:10 -07003735 my $ok = 0;
3736
Andy Whitcroft22f2a2e2007-08-10 13:01:03 -07003737 # Ignore email addresses <foo@bar>
Andy Whitcroft1f65f942008-07-23 21:29:10 -07003738 if (($op eq '<' &&
3739 $cc =~ /^\S+\@\S+>/) ||
3740 ($op eq '>' &&
3741 $ca =~ /<\S+\@\S+$/))
3742 {
3743 $ok = 1;
3744 }
3745
Joe Perches84731622013-11-12 15:10:05 -08003746 # messages are ERROR, but ?: are CHK
Andy Whitcroft1f65f942008-07-23 21:29:10 -07003747 if ($ok == 0) {
Joe Perches84731622013-11-12 15:10:05 -08003748 my $msg_type = \&ERROR;
3749 $msg_type = \&CHK if (($op eq '?:' || $op eq '?' || $op eq ':') && $ctx =~ /VxV/);
3750
3751 if (&{$msg_type}("SPACING",
3752 "spaces required around that '$op' $at\n" . $hereptr)) {
Joe Perchesb34c6482013-09-11 14:24:01 -07003753 $good = rtrim($fix_elements[$n]) . " " . trim($fix_elements[$n + 1]) . " ";
3754 if (defined $fix_elements[$n + 2]) {
3755 $fix_elements[$n + 2] =~ s/^\s+//;
3756 }
Joe Perches3705ce52013-07-03 15:05:31 -07003757 $line_fixed = 1;
3758 }
Andy Whitcroft22f2a2e2007-08-10 13:01:03 -07003759 }
Andy Whitcroft0a920b5b2007-06-01 00:46:48 -07003760 }
Andy Whitcroft4a0df2e2007-06-08 13:46:39 -07003761 $off += length($elements[$n + 1]);
Joe Perches3705ce52013-07-03 15:05:31 -07003762
3763## print("n: <$n> GOOD: <$good>\n");
3764
3765 $fixed_line = $fixed_line . $good;
Andy Whitcroft0a920b5b2007-06-01 00:46:48 -07003766 }
Joe Perches3705ce52013-07-03 15:05:31 -07003767
3768 if (($#elements % 2) == 0) {
3769 $fixed_line = $fixed_line . $fix_elements[$#elements];
3770 }
3771
Joe Perches194f66f2014-08-06 16:11:03 -07003772 if ($fix && $line_fixed && $fixed_line ne $fixed[$fixlinenr]) {
3773 $fixed[$fixlinenr] = $fixed_line;
Joe Perches3705ce52013-07-03 15:05:31 -07003774 }
3775
3776
Andy Whitcroft0a920b5b2007-06-01 00:46:48 -07003777 }
3778
Joe Perches786b6322013-07-03 15:05:32 -07003779# check for whitespace before a non-naked semicolon
Joe Perchesd2e248e2014-01-23 15:54:41 -08003780 if ($line =~ /^\+.*\S\s+;\s*$/) {
Joe Perches786b6322013-07-03 15:05:32 -07003781 if (WARN("SPACING",
3782 "space prohibited before semicolon\n" . $herecurr) &&
3783 $fix) {
Joe Perches194f66f2014-08-06 16:11:03 -07003784 1 while $fixed[$fixlinenr] =~
Joe Perches786b6322013-07-03 15:05:32 -07003785 s/^(\+.*\S)\s+;/$1;/;
3786 }
3787 }
3788
Andy Whitcroftf0a594c2007-07-19 01:48:34 -07003789# check for multiple assignments
3790 if ($line =~ /^.\s*$Lval\s*=\s*$Lval\s*=(?!=)/) {
Joe Perches000d1cc12011-07-25 17:13:25 -07003791 CHK("MULTIPLE_ASSIGNMENTS",
3792 "multiple assignments should be avoided\n" . $herecurr);
Andy Whitcroftf0a594c2007-07-19 01:48:34 -07003793 }
3794
Andy Whitcroft22f2a2e2007-08-10 13:01:03 -07003795## # check for multiple declarations, allowing for a function declaration
3796## # continuation.
3797## if ($line =~ /^.\s*$Type\s+$Ident(?:\s*=[^,{]*)?\s*,\s*$Ident.*/ &&
3798## $line !~ /^.\s*$Type\s+$Ident(?:\s*=[^,{]*)?\s*,\s*$Type\s*$Ident.*/) {
3799##
3800## # Remove any bracketed sections to ensure we do not
3801## # falsly report the parameters of functions.
3802## my $ln = $line;
3803## while ($ln =~ s/\([^\(\)]*\)//g) {
3804## }
3805## if ($ln =~ /,/) {
Joe Perches000d1cc12011-07-25 17:13:25 -07003806## WARN("MULTIPLE_DECLARATION",
3807## "declaring multiple variables together should be avoided\n" . $herecurr);
Andy Whitcroft22f2a2e2007-08-10 13:01:03 -07003808## }
3809## }
Andy Whitcroftf0a594c2007-07-19 01:48:34 -07003810
Andy Whitcroft0a920b5b2007-06-01 00:46:48 -07003811#need space before brace following if, while, etc
Andy Whitcroft22f2a2e2007-08-10 13:01:03 -07003812 if (($line =~ /\(.*\){/ && $line !~ /\($Type\){/) ||
3813 $line =~ /do{/) {
Joe Perches3705ce52013-07-03 15:05:31 -07003814 if (ERROR("SPACING",
3815 "space required before the open brace '{'\n" . $herecurr) &&
3816 $fix) {
Joe Perches194f66f2014-08-06 16:11:03 -07003817 $fixed[$fixlinenr] =~ s/^(\+.*(?:do|\))){/$1 {/;
Joe Perches3705ce52013-07-03 15:05:31 -07003818 }
Andy Whitcroftde7d4f02007-07-15 23:37:22 -07003819 }
3820
Joe Perchesc4a62ef2013-07-03 15:05:28 -07003821## # check for blank lines before declarations
3822## if ($line =~ /^.\t+$Type\s+$Ident(?:\s*=.*)?;/ &&
3823## $prevrawline =~ /^.\s*$/) {
3824## WARN("SPACING",
3825## "No blank lines before declarations\n" . $hereprev);
3826## }
3827##
3828
Andy Whitcroftde7d4f02007-07-15 23:37:22 -07003829# closing brace should have a space following it when it has anything
3830# on the line
3831 if ($line =~ /}(?!(?:,|;|\)))\S/) {
Joe Perchesd5e616f2013-09-11 14:23:54 -07003832 if (ERROR("SPACING",
3833 "space required after that close brace '}'\n" . $herecurr) &&
3834 $fix) {
Joe Perches194f66f2014-08-06 16:11:03 -07003835 $fixed[$fixlinenr] =~
Joe Perchesd5e616f2013-09-11 14:23:54 -07003836 s/}((?!(?:,|;|\)))\S)/} $1/;
3837 }
Andy Whitcroft0a920b5b2007-06-01 00:46:48 -07003838 }
3839
Andy Whitcroft22f2a2e2007-08-10 13:01:03 -07003840# check spacing on square brackets
3841 if ($line =~ /\[\s/ && $line !~ /\[\s*$/) {
Joe Perches3705ce52013-07-03 15:05:31 -07003842 if (ERROR("SPACING",
3843 "space prohibited after that open square bracket '['\n" . $herecurr) &&
3844 $fix) {
Joe Perches194f66f2014-08-06 16:11:03 -07003845 $fixed[$fixlinenr] =~
Joe Perches3705ce52013-07-03 15:05:31 -07003846 s/\[\s+/\[/;
3847 }
Andy Whitcroft22f2a2e2007-08-10 13:01:03 -07003848 }
3849 if ($line =~ /\s\]/) {
Joe Perches3705ce52013-07-03 15:05:31 -07003850 if (ERROR("SPACING",
3851 "space prohibited before that close square bracket ']'\n" . $herecurr) &&
3852 $fix) {
Joe Perches194f66f2014-08-06 16:11:03 -07003853 $fixed[$fixlinenr] =~
Joe Perches3705ce52013-07-03 15:05:31 -07003854 s/\s+\]/\]/;
3855 }
Andy Whitcroft22f2a2e2007-08-10 13:01:03 -07003856 }
3857
Andy Whitcroftc45dcab2008-06-05 22:46:01 -07003858# check spacing on parentheses
Andy Whitcroft9c0ca6f2007-10-16 23:29:38 -07003859 if ($line =~ /\(\s/ && $line !~ /\(\s*(?:\\)?$/ &&
3860 $line !~ /for\s*\(\s+;/) {
Joe Perches3705ce52013-07-03 15:05:31 -07003861 if (ERROR("SPACING",
3862 "space prohibited after that open parenthesis '('\n" . $herecurr) &&
3863 $fix) {
Joe Perches194f66f2014-08-06 16:11:03 -07003864 $fixed[$fixlinenr] =~
Joe Perches3705ce52013-07-03 15:05:31 -07003865 s/\(\s+/\(/;
3866 }
Andy Whitcroft22f2a2e2007-08-10 13:01:03 -07003867 }
Andy Whitcroft13214ad2008-02-08 04:22:03 -08003868 if ($line =~ /(\s+)\)/ && $line !~ /^.\s*\)/ &&
Andy Whitcroftc45dcab2008-06-05 22:46:01 -07003869 $line !~ /for\s*\(.*;\s+\)/ &&
3870 $line !~ /:\s+\)/) {
Joe Perches3705ce52013-07-03 15:05:31 -07003871 if (ERROR("SPACING",
3872 "space prohibited before that close parenthesis ')'\n" . $herecurr) &&
3873 $fix) {
Joe Perches194f66f2014-08-06 16:11:03 -07003874 $fixed[$fixlinenr] =~
Joe Perches3705ce52013-07-03 15:05:31 -07003875 s/\s+\)/\)/;
3876 }
Andy Whitcroft22f2a2e2007-08-10 13:01:03 -07003877 }
3878
Joe Perchese2826fd2014-08-06 16:10:48 -07003879# check unnecessary parentheses around addressof/dereference single $Lvals
3880# ie: &(foo->bar) should be &foo->bar and *(foo->bar) should be *foo->bar
3881
3882 while ($line =~ /(?:[^&]&\s*|\*)\(\s*($Ident\s*(?:$Member\s*)+)\s*\)/g) {
Joe Perchesea4acbb2014-12-10 15:51:51 -08003883 my $var = $1;
3884 if (CHK("UNNECESSARY_PARENTHESES",
3885 "Unnecessary parentheses around $var\n" . $herecurr) &&
3886 $fix) {
3887 $fixed[$fixlinenr] =~ s/\(\s*\Q$var\E\s*\)/$var/;
3888 }
3889 }
3890
3891# check for unnecessary parentheses around function pointer uses
3892# ie: (foo->bar)(); should be foo->bar();
3893# but not "if (foo->bar) (" to avoid some false positives
3894 if ($line =~ /(\bif\s*|)(\(\s*$Ident\s*(?:$Member\s*)+\))[ \t]*\(/ && $1 !~ /^if/) {
3895 my $var = $2;
3896 if (CHK("UNNECESSARY_PARENTHESES",
3897 "Unnecessary parentheses around function pointer $var\n" . $herecurr) &&
3898 $fix) {
3899 my $var2 = deparenthesize($var);
3900 $var2 =~ s/\s//g;
3901 $fixed[$fixlinenr] =~ s/\Q$var\E/$var2/;
3902 }
3903 }
Joe Perchese2826fd2014-08-06 16:10:48 -07003904
Andy Whitcroft0a920b5b2007-06-01 00:46:48 -07003905#goto labels aren't indented, allow a single space however
Andy Whitcroft4a0df2e2007-06-08 13:46:39 -07003906 if ($line=~/^.\s+[A-Za-z\d_]+:(?![0-9]+)/ and
Andy Whitcroft0a920b5b2007-06-01 00:46:48 -07003907 !($line=~/^. [A-Za-z\d_]+:/) and !($line=~/^.\s+default:/)) {
Joe Perches3705ce52013-07-03 15:05:31 -07003908 if (WARN("INDENTED_LABEL",
3909 "labels should not be indented\n" . $herecurr) &&
3910 $fix) {
Joe Perches194f66f2014-08-06 16:11:03 -07003911 $fixed[$fixlinenr] =~
Joe Perches3705ce52013-07-03 15:05:31 -07003912 s/^(.)\s+/$1/;
3913 }
Andy Whitcroft0a920b5b2007-06-01 00:46:48 -07003914 }
3915
Joe Perches5b9553a2014-04-03 14:49:21 -07003916# return is not a function
Joe Perches507e5142013-11-12 15:10:13 -08003917 if (defined($stat) && $stat =~ /^.\s*return(\s*)\(/s) {
Andy Whitcroftc45dcab2008-06-05 22:46:01 -07003918 my $spacing = $1;
Joe Perches507e5142013-11-12 15:10:13 -08003919 if ($^V && $^V ge 5.10.0 &&
Joe Perches5b9553a2014-04-03 14:49:21 -07003920 $stat =~ /^.\s*return\s*($balanced_parens)\s*;\s*$/) {
3921 my $value = $1;
3922 $value = deparenthesize($value);
3923 if ($value =~ m/^\s*$FuncArg\s*(?:\?|$)/) {
3924 ERROR("RETURN_PARENTHESES",
3925 "return is not a function, parentheses are not required\n" . $herecurr);
3926 }
Andy Whitcroftc45dcab2008-06-05 22:46:01 -07003927 } elsif ($spacing !~ /\s+/) {
Joe Perches000d1cc12011-07-25 17:13:25 -07003928 ERROR("SPACING",
3929 "space required before the open parenthesis '('\n" . $herecurr);
Andy Whitcroftc45dcab2008-06-05 22:46:01 -07003930 }
3931 }
Joe Perches507e5142013-11-12 15:10:13 -08003932
Joe Perchesb43ae212014-06-23 13:22:07 -07003933# unnecessary return in a void function
3934# at end-of-function, with the previous line a single leading tab, then return;
3935# and the line before that not a goto label target like "out:"
3936 if ($sline =~ /^[ \+]}\s*$/ &&
3937 $prevline =~ /^\+\treturn\s*;\s*$/ &&
3938 $linenr >= 3 &&
3939 $lines[$linenr - 3] =~ /^[ +]/ &&
3940 $lines[$linenr - 3] !~ /^[ +]\s*$Ident\s*:/) {
Joe Perches9819cf22014-06-04 16:12:09 -07003941 WARN("RETURN_VOID",
Joe Perchesb43ae212014-06-23 13:22:07 -07003942 "void function return statements are not generally useful\n" . $hereprev);
3943 }
Joe Perches9819cf22014-06-04 16:12:09 -07003944
Joe Perches189248d2014-01-23 15:54:47 -08003945# if statements using unnecessary parentheses - ie: if ((foo == bar))
3946 if ($^V && $^V ge 5.10.0 &&
3947 $line =~ /\bif\s*((?:\(\s*){2,})/) {
3948 my $openparens = $1;
3949 my $count = $openparens =~ tr@\(@\(@;
3950 my $msg = "";
3951 if ($line =~ /\bif\s*(?:\(\s*){$count,$count}$LvalOrFunc\s*($Compare)\s*$LvalOrFunc(?:\s*\)){$count,$count}/) {
3952 my $comp = $4; #Not $1 because of $LvalOrFunc
3953 $msg = " - maybe == should be = ?" if ($comp eq "==");
3954 WARN("UNNECESSARY_PARENTHESES",
3955 "Unnecessary parentheses$msg\n" . $herecurr);
3956 }
3957 }
3958
Andy Whitcroft53a3c442010-10-26 14:23:14 -07003959# Return of what appears to be an errno should normally be -'ve
3960 if ($line =~ /^.\s*return\s*(E[A-Z]*)\s*;/) {
3961 my $name = $1;
3962 if ($name ne 'EOF' && $name ne 'ERROR') {
Joe Perches000d1cc12011-07-25 17:13:25 -07003963 WARN("USE_NEGATIVE_ERRNO",
3964 "return of an errno should typically be -ve (return -$1)\n" . $herecurr);
Andy Whitcroft53a3c442010-10-26 14:23:14 -07003965 }
3966 }
Andy Whitcroftc45dcab2008-06-05 22:46:01 -07003967
Andy Whitcroft0a920b5b2007-06-01 00:46:48 -07003968# Need a space before open parenthesis after if, while etc
Joe Perches3705ce52013-07-03 15:05:31 -07003969 if ($line =~ /\b(if|while|for|switch)\(/) {
3970 if (ERROR("SPACING",
3971 "space required before the open parenthesis '('\n" . $herecurr) &&
3972 $fix) {
Joe Perches194f66f2014-08-06 16:11:03 -07003973 $fixed[$fixlinenr] =~
Joe Perches3705ce52013-07-03 15:05:31 -07003974 s/\b(if|while|for|switch)\(/$1 \(/;
3975 }
Andy Whitcroft0a920b5b2007-06-01 00:46:48 -07003976 }
3977
Andy Whitcroftf5fe35d2008-07-23 21:29:03 -07003978# Check for illegal assignment in if conditional -- and check for trailing
3979# statements after the conditional.
Andy Whitcroft170d3a22008-10-15 22:02:30 -07003980 if ($line =~ /do\s*(?!{)/) {
Andy Whitcroft3e469cd2012-01-10 15:10:01 -08003981 ($stat, $cond, $line_nr_next, $remain_next, $off_next) =
3982 ctx_statement_block($linenr, $realcnt, 0)
3983 if (!defined $stat);
Andy Whitcroft170d3a22008-10-15 22:02:30 -07003984 my ($stat_next) = ctx_statement_block($line_nr_next,
3985 $remain_next, $off_next);
3986 $stat_next =~ s/\n./\n /g;
3987 ##print "stat<$stat> stat_next<$stat_next>\n";
3988
3989 if ($stat_next =~ /^\s*while\b/) {
3990 # If the statement carries leading newlines,
3991 # then count those as offsets.
3992 my ($whitespace) =
3993 ($stat_next =~ /^((?:\s*\n[+-])*\s*)/s);
3994 my $offset =
3995 statement_rawlines($whitespace) - 1;
3996
3997 $suppress_whiletrailers{$line_nr_next +
3998 $offset} = 1;
3999 }
4000 }
4001 if (!defined $suppress_whiletrailers{$linenr} &&
Joe Perchesc11230f2013-11-21 14:31:57 -08004002 defined($stat) && defined($cond) &&
Andy Whitcroft170d3a22008-10-15 22:02:30 -07004003 $line =~ /\b(?:if|while|for)\s*\(/ && $line !~ /^.\s*#/) {
Andy Whitcroft171ae1a2008-04-29 00:59:32 -07004004 my ($s, $c) = ($stat, $cond);
Andy Whitcroft8905a672007-11-28 16:21:06 -08004005
Andy Whitcroftb53c8e12009-01-06 14:41:29 -08004006 if ($c =~ /\bif\s*\(.*[^<>!=]=[^=].*/s) {
Joe Perches000d1cc12011-07-25 17:13:25 -07004007 ERROR("ASSIGN_IN_IF",
4008 "do not use assignment in if condition\n" . $herecurr);
Andy Whitcroft8905a672007-11-28 16:21:06 -08004009 }
4010
4011 # Find out what is on the end of the line after the
4012 # conditional.
Andy Whitcroft773647a2008-03-28 14:15:58 -07004013 substr($s, 0, length($c), '');
Andy Whitcroft8905a672007-11-28 16:21:06 -08004014 $s =~ s/\n.*//g;
Andy Whitcroft13214ad2008-02-08 04:22:03 -08004015 $s =~ s/$;//g; # Remove any comments
Andy Whitcroft53210162008-07-23 21:29:03 -07004016 if (length($c) && $s !~ /^\s*{?\s*\\*\s*$/ &&
4017 $c !~ /}\s*while\s*/)
Andy Whitcroft773647a2008-03-28 14:15:58 -07004018 {
Andy Whitcroftbb44ad32008-10-15 22:02:34 -07004019 # Find out how long the conditional actually is.
4020 my @newlines = ($c =~ /\n/gs);
4021 my $cond_lines = 1 + $#newlines;
Hidetoshi Seto42bdf742010-03-05 13:43:50 -08004022 my $stat_real = '';
Andy Whitcroftbb44ad32008-10-15 22:02:34 -07004023
Hidetoshi Seto42bdf742010-03-05 13:43:50 -08004024 $stat_real = raw_line($linenr, $cond_lines)
4025 . "\n" if ($cond_lines);
Andy Whitcroftbb44ad32008-10-15 22:02:34 -07004026 if (defined($stat_real) && $cond_lines > 1) {
4027 $stat_real = "[...]\n$stat_real";
4028 }
4029
Joe Perches000d1cc12011-07-25 17:13:25 -07004030 ERROR("TRAILING_STATEMENTS",
4031 "trailing statements should be on next line\n" . $herecurr . $stat_real);
Andy Whitcroft8905a672007-11-28 16:21:06 -08004032 }
4033 }
4034
Andy Whitcroft13214ad2008-02-08 04:22:03 -08004035# Check for bitwise tests written as boolean
4036 if ($line =~ /
4037 (?:
4038 (?:\[|\(|\&\&|\|\|)
4039 \s*0[xX][0-9]+\s*
4040 (?:\&\&|\|\|)
4041 |
4042 (?:\&\&|\|\|)
4043 \s*0[xX][0-9]+\s*
4044 (?:\&\&|\|\||\)|\])
4045 )/x)
4046 {
Joe Perches000d1cc12011-07-25 17:13:25 -07004047 WARN("HEXADECIMAL_BOOLEAN_TEST",
4048 "boolean test with hexadecimal, perhaps just 1 \& or \|?\n" . $herecurr);
Andy Whitcroft13214ad2008-02-08 04:22:03 -08004049 }
4050
Andy Whitcroft8905a672007-11-28 16:21:06 -08004051# if and else should not have general statements after it
Andy Whitcroft13214ad2008-02-08 04:22:03 -08004052 if ($line =~ /^.\s*(?:}\s*)?else\b(.*)/) {
4053 my $s = $1;
4054 $s =~ s/$;//g; # Remove any comments
4055 if ($s !~ /^\s*(?:\sif|(?:{|)\s*\\?\s*$)/) {
Joe Perches000d1cc12011-07-25 17:13:25 -07004056 ERROR("TRAILING_STATEMENTS",
4057 "trailing statements should be on next line\n" . $herecurr);
Andy Whitcroft13214ad2008-02-08 04:22:03 -08004058 }
Andy Whitcroft0a920b5b2007-06-01 00:46:48 -07004059 }
Andy Whitcroft39667782009-01-15 13:51:06 -08004060# if should not continue a brace
4061 if ($line =~ /}\s*if\b/) {
Joe Perches000d1cc12011-07-25 17:13:25 -07004062 ERROR("TRAILING_STATEMENTS",
Rasmus Villemoes048b1232014-08-06 16:10:37 -07004063 "trailing statements should be on next line (or did you mean 'else if'?)\n" .
Andy Whitcroft39667782009-01-15 13:51:06 -08004064 $herecurr);
4065 }
Andy Whitcrofta1080bf2008-10-15 22:02:25 -07004066# case and default should not have general statements after them
4067 if ($line =~ /^.\s*(?:case\s*.*|default\s*):/g &&
4068 $line !~ /\G(?:
Andy Whitcroft3fef12d2008-10-15 22:02:36 -07004069 (?:\s*$;*)(?:\s*{)?(?:\s*$;*)(?:\s*\\)?\s*$|
Andy Whitcrofta1080bf2008-10-15 22:02:25 -07004070 \s*return\s+
4071 )/xg)
4072 {
Joe Perches000d1cc12011-07-25 17:13:25 -07004073 ERROR("TRAILING_STATEMENTS",
4074 "trailing statements should be on next line\n" . $herecurr);
Andy Whitcrofta1080bf2008-10-15 22:02:25 -07004075 }
Andy Whitcroft0a920b5b2007-06-01 00:46:48 -07004076
4077 # Check for }<nl>else {, these must be at the same
4078 # indent level to be relevant to each other.
Joe Perches8b8856f2014-08-06 16:11:14 -07004079 if ($prevline=~/}\s*$/ and $line=~/^.\s*else\s*/ &&
4080 $previndent == $indent) {
4081 if (ERROR("ELSE_AFTER_BRACE",
4082 "else should follow close brace '}'\n" . $hereprev) &&
4083 $fix && $prevline =~ /^\+/ && $line =~ /^\+/) {
4084 fix_delete_line($fixlinenr - 1, $prevrawline);
4085 fix_delete_line($fixlinenr, $rawline);
4086 my $fixedline = $prevrawline;
4087 $fixedline =~ s/}\s*$//;
4088 if ($fixedline !~ /^\+\s*$/) {
4089 fix_insert_line($fixlinenr, $fixedline);
4090 }
4091 $fixedline = $rawline;
4092 $fixedline =~ s/^(.\s*)else/$1} else/;
4093 fix_insert_line($fixlinenr, $fixedline);
4094 }
Andy Whitcroft0a920b5b2007-06-01 00:46:48 -07004095 }
4096
Joe Perches8b8856f2014-08-06 16:11:14 -07004097 if ($prevline=~/}\s*$/ and $line=~/^.\s*while\s*/ &&
4098 $previndent == $indent) {
Andy Whitcroftc2fdda02008-02-08 04:20:54 -08004099 my ($s, $c) = ctx_statement_block($linenr, $realcnt, 0);
4100
4101 # Find out what is on the end of the line after the
4102 # conditional.
Andy Whitcroft773647a2008-03-28 14:15:58 -07004103 substr($s, 0, length($c), '');
Andy Whitcroftc2fdda02008-02-08 04:20:54 -08004104 $s =~ s/\n.*//g;
4105
4106 if ($s =~ /^\s*;/) {
Joe Perches8b8856f2014-08-06 16:11:14 -07004107 if (ERROR("WHILE_AFTER_BRACE",
4108 "while should follow close brace '}'\n" . $hereprev) &&
4109 $fix && $prevline =~ /^\+/ && $line =~ /^\+/) {
4110 fix_delete_line($fixlinenr - 1, $prevrawline);
4111 fix_delete_line($fixlinenr, $rawline);
4112 my $fixedline = $prevrawline;
4113 my $trailing = $rawline;
4114 $trailing =~ s/^\+//;
4115 $trailing = trim($trailing);
4116 $fixedline =~ s/}\s*$/} $trailing/;
4117 fix_insert_line($fixlinenr, $fixedline);
4118 }
Andy Whitcroftc2fdda02008-02-08 04:20:54 -08004119 }
4120 }
4121
Joe Perches95e2c602013-07-03 15:05:20 -07004122#Specific variable tests
Joe Perches323c1262012-12-17 16:02:07 -08004123 while ($line =~ m{($Constant|$Lval)}g) {
4124 my $var = $1;
Joe Perches95e2c602013-07-03 15:05:20 -07004125
4126#gcc binary extension
4127 if ($var =~ /^$Binary$/) {
Joe Perchesd5e616f2013-09-11 14:23:54 -07004128 if (WARN("GCC_BINARY_CONSTANT",
4129 "Avoid gcc v4.3+ binary constant extension: <$var>\n" . $herecurr) &&
4130 $fix) {
4131 my $hexval = sprintf("0x%x", oct($var));
Joe Perches194f66f2014-08-06 16:11:03 -07004132 $fixed[$fixlinenr] =~
Joe Perchesd5e616f2013-09-11 14:23:54 -07004133 s/\b$var\b/$hexval/;
4134 }
Joe Perches95e2c602013-07-03 15:05:20 -07004135 }
4136
4137#CamelCase
Joe Perches807bd262013-07-03 15:05:22 -07004138 if ($var !~ /^$Constant$/ &&
Joe Perchesbe797942013-07-03 15:05:20 -07004139 $var =~ /[A-Z][a-z]|[a-z][A-Z]/ &&
Joe Perches22735ce2013-07-03 15:05:33 -07004140#Ignore Page<foo> variants
Joe Perches807bd262013-07-03 15:05:22 -07004141 $var !~ /^(?:Clear|Set|TestClear|TestSet|)Page[A-Z]/ &&
Joe Perches22735ce2013-07-03 15:05:33 -07004142#Ignore SI style variants like nS, mV and dB (ie: max_uV, regulator_min_uA_show)
Julius Wernerf5123572014-12-10 15:51:54 -08004143 $var !~ /^(?:[a-z_]*?)_?[a-z][A-Z](?:_[a-z_]+)?$/ &&
4144#Ignore some three character SI units explicitly, like MiB and KHz
4145 $var !~ /^(?:[a-z_]*?)_?(?:[KMGT]iB|[KMGT]?Hz)(?:_[a-z_]+)?$/) {
Joe Perches7e781f62013-09-11 14:23:55 -07004146 while ($var =~ m{($Ident)}g) {
4147 my $word = $1;
4148 next if ($word !~ /[A-Z][a-z]|[a-z][A-Z]/);
Joe Perchesd8b07712013-11-12 15:10:06 -08004149 if ($check) {
4150 seed_camelcase_includes();
4151 if (!$file && !$camelcase_file_seeded) {
4152 seed_camelcase_file($realfile);
4153 $camelcase_file_seeded = 1;
4154 }
4155 }
Joe Perches7e781f62013-09-11 14:23:55 -07004156 if (!defined $camelcase{$word}) {
4157 $camelcase{$word} = 1;
4158 CHK("CAMELCASE",
4159 "Avoid CamelCase: <$word>\n" . $herecurr);
4160 }
Joe Perches34456862013-07-03 15:05:34 -07004161 }
Joe Perches323c1262012-12-17 16:02:07 -08004162 }
4163 }
Andy Whitcroft0a920b5b2007-06-01 00:46:48 -07004164
4165#no spaces allowed after \ in define
Joe Perchesd5e616f2013-09-11 14:23:54 -07004166 if ($line =~ /\#\s*define.*\\\s+$/) {
4167 if (WARN("WHITESPACE_AFTER_LINE_CONTINUATION",
4168 "Whitespace after \\ makes next lines useless\n" . $herecurr) &&
4169 $fix) {
Joe Perches194f66f2014-08-06 16:11:03 -07004170 $fixed[$fixlinenr] =~ s/\s+$//;
Joe Perchesd5e616f2013-09-11 14:23:54 -07004171 }
Andy Whitcroft0a920b5b2007-06-01 00:46:48 -07004172 }
4173
Andy Whitcroft653d4872007-06-23 17:16:34 -07004174#warn if <asm/foo.h> is #included and <linux/foo.h> is available (uses RAW line)
Andy Whitcroftc45dcab2008-06-05 22:46:01 -07004175 if ($tree && $rawline =~ m{^.\s*\#\s*include\s*\<asm\/(.*)\.h\>}) {
Andy Whitcrofte09dec42008-10-15 22:02:20 -07004176 my $file = "$1.h";
4177 my $checkfile = "include/linux/$file";
4178 if (-f "$root/$checkfile" &&
4179 $realfile ne $checkfile &&
Wolfram Sang7840a942010-08-09 17:20:57 -07004180 $1 !~ /$allowed_asm_includes/)
Andy Whitcroftc45dcab2008-06-05 22:46:01 -07004181 {
Andy Whitcrofte09dec42008-10-15 22:02:20 -07004182 if ($realfile =~ m{^arch/}) {
Joe Perches000d1cc12011-07-25 17:13:25 -07004183 CHK("ARCH_INCLUDE_LINUX",
4184 "Consider using #include <linux/$file> instead of <asm/$file>\n" . $herecurr);
Andy Whitcrofte09dec42008-10-15 22:02:20 -07004185 } else {
Joe Perches000d1cc12011-07-25 17:13:25 -07004186 WARN("INCLUDE_LINUX",
4187 "Use #include <linux/$file> instead of <asm/$file>\n" . $herecurr);
Andy Whitcrofte09dec42008-10-15 22:02:20 -07004188 }
Andy Whitcroft0a920b5b2007-06-01 00:46:48 -07004189 }
4190 }
4191
Andy Whitcroft653d4872007-06-23 17:16:34 -07004192# multi-statement macros should be enclosed in a do while loop, grab the
4193# first statement and ensure its the whole macro if its not enclosed
Andy Whitcroftcf655042008-03-04 14:28:20 -08004194# in a known good container
Andy Whitcroftb8f96a312008-07-23 21:29:07 -07004195 if ($realfile !~ m@/vmlinux.lds.h$@ &&
4196 $line =~ /^.\s*\#\s*define\s*$Ident(\()?/) {
Andy Whitcroftd8aaf122007-06-23 17:16:44 -07004197 my $ln = $linenr;
4198 my $cnt = $realcnt;
Andy Whitcroftc45dcab2008-06-05 22:46:01 -07004199 my ($off, $dstat, $dcond, $rest);
4200 my $ctx = '';
Joe Perches08a28432014-10-13 15:51:55 -07004201 my $has_flow_statement = 0;
4202 my $has_arg_concat = 0;
Andy Whitcroftc45dcab2008-06-05 22:46:01 -07004203 ($dstat, $dcond, $ln, $cnt, $off) =
Andy Whitcroftf74bd192012-01-10 15:09:54 -08004204 ctx_statement_block($linenr, $realcnt, 0);
4205 $ctx = $dstat;
Andy Whitcroftc45dcab2008-06-05 22:46:01 -07004206 #print "dstat<$dstat> dcond<$dcond> cnt<$cnt> off<$off>\n";
Andy Whitcrofta3bb97a2008-07-23 21:29:00 -07004207 #print "LINE<$lines[$ln-1]> len<" . length($lines[$ln-1]) . "\n";
Andy Whitcroftc45dcab2008-06-05 22:46:01 -07004208
Joe Perches08a28432014-10-13 15:51:55 -07004209 $has_flow_statement = 1 if ($ctx =~ /\b(goto|return)\b/);
4210 $has_arg_concat = 1 if ($ctx =~ /\#\#/);
4211
Andy Whitcroftf74bd192012-01-10 15:09:54 -08004212 $dstat =~ s/^.\s*\#\s*define\s+$Ident(?:\([^\)]*\))?\s*//;
Andy Whitcroft292f1a92008-07-23 21:29:11 -07004213 $dstat =~ s/$;//g;
Andy Whitcroftc45dcab2008-06-05 22:46:01 -07004214 $dstat =~ s/\\\n.//g;
4215 $dstat =~ s/^\s*//s;
4216 $dstat =~ s/\s*$//s;
4217
4218 # Flatten any parentheses and braces
Andy Whitcroftbf30d6e2008-10-15 22:02:33 -07004219 while ($dstat =~ s/\([^\(\)]*\)/1/ ||
4220 $dstat =~ s/\{[^\{\}]*\}/1/ ||
Andy Whitcroftc81769f2012-01-10 15:10:10 -08004221 $dstat =~ s/\[[^\[\]]*\]/1/)
Andy Whitcroftbf30d6e2008-10-15 22:02:33 -07004222 {
Andy Whitcroftde7d4f02007-07-15 23:37:22 -07004223 }
Andy Whitcroftd8aaf122007-06-23 17:16:44 -07004224
Andy Whitcrofte45bab82012-03-23 15:02:18 -07004225 # Flatten any obvious string concatentation.
4226 while ($dstat =~ s/("X*")\s*$Ident/$1/ ||
4227 $dstat =~ s/$Ident\s*("X*")/$1/)
4228 {
4229 }
4230
Andy Whitcroftc45dcab2008-06-05 22:46:01 -07004231 my $exceptions = qr{
4232 $Declare|
4233 module_param_named|
Kees Cooka0a0a7a2012-10-04 17:13:38 -07004234 MODULE_PARM_DESC|
Andy Whitcroftc45dcab2008-06-05 22:46:01 -07004235 DECLARE_PER_CPU|
4236 DEFINE_PER_CPU|
Andy Whitcroft383099f2009-01-06 14:41:18 -08004237 __typeof__\(|
Stefani Seibold22fd2d32010-03-05 13:43:52 -08004238 union|
4239 struct|
Andy Whitcroftea71a0a2009-09-21 17:04:38 -07004240 \.$Ident\s*=\s*|
4241 ^\"|\"$
Andy Whitcroftc45dcab2008-06-05 22:46:01 -07004242 }x;
Andy Whitcroft5eaa20b2010-10-26 14:23:18 -07004243 #print "REST<$rest> dstat<$dstat> ctx<$ctx>\n";
Andy Whitcroftf74bd192012-01-10 15:09:54 -08004244 if ($dstat ne '' &&
4245 $dstat !~ /^(?:$Ident|-?$Constant),$/ && # 10, // foo(),
4246 $dstat !~ /^(?:$Ident|-?$Constant);$/ && # foo();
Joe Perches3cc4b1c2013-07-03 15:05:27 -07004247 $dstat !~ /^[!~-]?(?:$Lval|$Constant)$/ && # 10 // foo() // !foo // ~foo // -foo // foo->bar // foo.bar->baz
Joe Perches356fd392014-08-06 16:10:31 -07004248 $dstat !~ /^'X'$/ && $dstat !~ /^'XX'$/ && # character constants
Andy Whitcroftf74bd192012-01-10 15:09:54 -08004249 $dstat !~ /$exceptions/ &&
4250 $dstat !~ /^\.$Ident\s*=/ && # .foo =
Joe Perchese942e2c2013-04-17 15:58:26 -07004251 $dstat !~ /^(?:\#\s*$Ident|\#\s*$Constant)\s*$/ && # stringification #foo
Andy Whitcroft72f115f2012-01-10 15:10:06 -08004252 $dstat !~ /^do\s*$Constant\s*while\s*$Constant;?$/ && # do {...} while (...); // do {...} while (...)
Andy Whitcroftf74bd192012-01-10 15:09:54 -08004253 $dstat !~ /^for\s*$Constant$/ && # for (...)
4254 $dstat !~ /^for\s*$Constant\s+(?:$Ident|-?$Constant)$/ && # for (...) bar()
4255 $dstat !~ /^do\s*{/ && # do {...
Joe Perchesf95a7e62013-09-11 14:24:00 -07004256 $dstat !~ /^\({/ && # ({...
4257 $ctx !~ /^.\s*#\s*define\s+TRACE_(?:SYSTEM|INCLUDE_FILE|INCLUDE_PATH)\b/)
Andy Whitcroftf74bd192012-01-10 15:09:54 -08004258 {
4259 $ctx =~ s/\n*$//;
4260 my $herectx = $here . "\n";
4261 my $cnt = statement_rawlines($ctx);
4262
4263 for (my $n = 0; $n < $cnt; $n++) {
4264 $herectx .= raw_line($linenr, $n) . "\n";
Andy Whitcroftc45dcab2008-06-05 22:46:01 -07004265 }
4266
Andy Whitcroftf74bd192012-01-10 15:09:54 -08004267 if ($dstat =~ /;/) {
4268 ERROR("MULTISTATEMENT_MACRO_USE_DO_WHILE",
4269 "Macros with multiple statements should be enclosed in a do - while loop\n" . "$herectx");
4270 } else {
Joe Perches000d1cc12011-07-25 17:13:25 -07004271 ERROR("COMPLEX_MACRO",
Andrew Morton388982b2014-10-13 15:51:40 -07004272 "Macros with complex values should be enclosed in parentheses\n" . "$herectx");
Andy Whitcroftd8aaf122007-06-23 17:16:44 -07004273 }
Andy Whitcroft653d4872007-06-23 17:16:34 -07004274 }
Joe Perches5023d342012-12-17 16:01:47 -08004275
Joe Perches08a28432014-10-13 15:51:55 -07004276# check for macros with flow control, but without ## concatenation
4277# ## concatenation is commonly a macro that defines a function so ignore those
4278 if ($has_flow_statement && !$has_arg_concat) {
4279 my $herectx = $here . "\n";
4280 my $cnt = statement_rawlines($ctx);
4281
4282 for (my $n = 0; $n < $cnt; $n++) {
4283 $herectx .= raw_line($linenr, $n) . "\n";
4284 }
4285 WARN("MACRO_WITH_FLOW_CONTROL",
4286 "Macros with flow control statements should be avoided\n" . "$herectx");
4287 }
4288
Joe Perches481eb482012-12-17 16:01:56 -08004289# check for line continuations outside of #defines, preprocessor #, and asm
Joe Perches5023d342012-12-17 16:01:47 -08004290
4291 } else {
4292 if ($prevline !~ /^..*\\$/ &&
Joe Perches481eb482012-12-17 16:01:56 -08004293 $line !~ /^\+\s*\#.*\\$/ && # preprocessor
4294 $line !~ /^\+.*\b(__asm__|asm)\b.*\\$/ && # asm
Joe Perches5023d342012-12-17 16:01:47 -08004295 $line =~ /^\+.*\\$/) {
4296 WARN("LINE_CONTINUATIONS",
4297 "Avoid unnecessary line continuations\n" . $herecurr);
4298 }
Andy Whitcroft0a920b5b2007-06-01 00:46:48 -07004299 }
4300
Joe Perchesb13edf72012-07-30 14:41:24 -07004301# do {} while (0) macro tests:
4302# single-statement macros do not need to be enclosed in do while (0) loop,
4303# macro should not end with a semicolon
4304 if ($^V && $^V ge 5.10.0 &&
4305 $realfile !~ m@/vmlinux.lds.h$@ &&
4306 $line =~ /^.\s*\#\s*define\s+$Ident(\()?/) {
4307 my $ln = $linenr;
4308 my $cnt = $realcnt;
4309 my ($off, $dstat, $dcond, $rest);
4310 my $ctx = '';
4311 ($dstat, $dcond, $ln, $cnt, $off) =
4312 ctx_statement_block($linenr, $realcnt, 0);
4313 $ctx = $dstat;
4314
4315 $dstat =~ s/\\\n.//g;
Joe Perches1b36b202015-02-13 14:38:32 -08004316 $dstat =~ s/$;/ /g;
Joe Perchesb13edf72012-07-30 14:41:24 -07004317
4318 if ($dstat =~ /^\+\s*#\s*define\s+$Ident\s*${balanced_parens}\s*do\s*{(.*)\s*}\s*while\s*\(\s*0\s*\)\s*([;\s]*)\s*$/) {
4319 my $stmts = $2;
4320 my $semis = $3;
4321
4322 $ctx =~ s/\n*$//;
4323 my $cnt = statement_rawlines($ctx);
4324 my $herectx = $here . "\n";
4325
4326 for (my $n = 0; $n < $cnt; $n++) {
4327 $herectx .= raw_line($linenr, $n) . "\n";
4328 }
4329
Joe Perchesac8e97f2012-08-21 16:15:53 -07004330 if (($stmts =~ tr/;/;/) == 1 &&
4331 $stmts !~ /^\s*(if|while|for|switch)\b/) {
Joe Perchesb13edf72012-07-30 14:41:24 -07004332 WARN("SINGLE_STATEMENT_DO_WHILE_MACRO",
4333 "Single statement macros should not use a do {} while (0) loop\n" . "$herectx");
4334 }
4335 if (defined $semis && $semis ne "") {
4336 WARN("DO_WHILE_MACRO_WITH_TRAILING_SEMICOLON",
4337 "do {} while (0) macros should not be semicolon terminated\n" . "$herectx");
4338 }
Joe Perchesf5ef95b2014-06-04 16:12:06 -07004339 } elsif ($dstat =~ /^\+\s*#\s*define\s+$Ident.*;\s*$/) {
4340 $ctx =~ s/\n*$//;
4341 my $cnt = statement_rawlines($ctx);
4342 my $herectx = $here . "\n";
4343
4344 for (my $n = 0; $n < $cnt; $n++) {
4345 $herectx .= raw_line($linenr, $n) . "\n";
4346 }
4347
4348 WARN("TRAILING_SEMICOLON",
4349 "macros should not use a trailing semicolon\n" . "$herectx");
Joe Perchesb13edf72012-07-30 14:41:24 -07004350 }
4351 }
4352
Mike Frysinger080ba922009-01-06 14:41:25 -08004353# make sure symbols are always wrapped with VMLINUX_SYMBOL() ...
4354# all assignments may have only one of the following with an assignment:
4355# .
4356# ALIGN(...)
4357# VMLINUX_SYMBOL(...)
4358 if ($realfile eq 'vmlinux.lds.h' && $line =~ /(?:(?:^|\s)$Ident\s*=|=\s*$Ident(?:\s|$))/) {
Joe Perches000d1cc12011-07-25 17:13:25 -07004359 WARN("MISSING_VMLINUX_SYMBOL",
4360 "vmlinux.lds.h needs VMLINUX_SYMBOL() around C-visible symbols\n" . $herecurr);
Mike Frysinger080ba922009-01-06 14:41:25 -08004361 }
4362
Andy Whitcroftf0a594c2007-07-19 01:48:34 -07004363# check for redundant bracing round if etc
Andy Whitcroft13214ad2008-02-08 04:22:03 -08004364 if ($line =~ /(^.*)\bif\b/ && $1 !~ /else\s*$/) {
4365 my ($level, $endln, @chunks) =
Andy Whitcroftcf655042008-03-04 14:28:20 -08004366 ctx_statement_full($linenr, $realcnt, 1);
Andy Whitcroft13214ad2008-02-08 04:22:03 -08004367 #print "chunks<$#chunks> linenr<$linenr> endln<$endln> level<$level>\n";
Andy Whitcroftcf655042008-03-04 14:28:20 -08004368 #print "APW: <<$chunks[1][0]>><<$chunks[1][1]>>\n";
4369 if ($#chunks > 0 && $level == 0) {
Joe Perchesaad4f612012-03-23 15:02:19 -07004370 my @allowed = ();
4371 my $allow = 0;
Andy Whitcroft13214ad2008-02-08 04:22:03 -08004372 my $seen = 0;
Andy Whitcroft773647a2008-03-28 14:15:58 -07004373 my $herectx = $here . "\n";
Andy Whitcroftcf655042008-03-04 14:28:20 -08004374 my $ln = $linenr - 1;
Andy Whitcroft13214ad2008-02-08 04:22:03 -08004375 for my $chunk (@chunks) {
4376 my ($cond, $block) = @{$chunk};
4377
Andy Whitcroft773647a2008-03-28 14:15:58 -07004378 # If the condition carries leading newlines, then count those as offsets.
4379 my ($whitespace) = ($cond =~ /^((?:\s*\n[+-])*\s*)/s);
4380 my $offset = statement_rawlines($whitespace) - 1;
4381
Joe Perchesaad4f612012-03-23 15:02:19 -07004382 $allowed[$allow] = 0;
Andy Whitcroft773647a2008-03-28 14:15:58 -07004383 #print "COND<$cond> whitespace<$whitespace> offset<$offset>\n";
4384
4385 # We have looked at and allowed this specific line.
4386 $suppress_ifbraces{$ln + $offset} = 1;
4387
4388 $herectx .= "$rawlines[$ln + $offset]\n[...]\n";
Andy Whitcroftcf655042008-03-04 14:28:20 -08004389 $ln += statement_rawlines($block) - 1;
4390
Andy Whitcroft773647a2008-03-28 14:15:58 -07004391 substr($block, 0, length($cond), '');
Andy Whitcroft13214ad2008-02-08 04:22:03 -08004392
4393 $seen++ if ($block =~ /^\s*{/);
4394
Joe Perchesaad4f612012-03-23 15:02:19 -07004395 #print "cond<$cond> block<$block> allowed<$allowed[$allow]>\n";
Andy Whitcroftcf655042008-03-04 14:28:20 -08004396 if (statement_lines($cond) > 1) {
4397 #print "APW: ALLOWED: cond<$cond>\n";
Joe Perchesaad4f612012-03-23 15:02:19 -07004398 $allowed[$allow] = 1;
Andy Whitcroft13214ad2008-02-08 04:22:03 -08004399 }
4400 if ($block =~/\b(?:if|for|while)\b/) {
Andy Whitcroftcf655042008-03-04 14:28:20 -08004401 #print "APW: ALLOWED: block<$block>\n";
Joe Perchesaad4f612012-03-23 15:02:19 -07004402 $allowed[$allow] = 1;
Andy Whitcroft13214ad2008-02-08 04:22:03 -08004403 }
Andy Whitcroftcf655042008-03-04 14:28:20 -08004404 if (statement_block_size($block) > 1) {
4405 #print "APW: ALLOWED: lines block<$block>\n";
Joe Perchesaad4f612012-03-23 15:02:19 -07004406 $allowed[$allow] = 1;
Andy Whitcroft13214ad2008-02-08 04:22:03 -08004407 }
Joe Perchesaad4f612012-03-23 15:02:19 -07004408 $allow++;
Andy Whitcroft13214ad2008-02-08 04:22:03 -08004409 }
Joe Perchesaad4f612012-03-23 15:02:19 -07004410 if ($seen) {
4411 my $sum_allowed = 0;
4412 foreach (@allowed) {
4413 $sum_allowed += $_;
4414 }
4415 if ($sum_allowed == 0) {
4416 WARN("BRACES",
4417 "braces {} are not necessary for any arm of this statement\n" . $herectx);
4418 } elsif ($sum_allowed != $allow &&
4419 $seen != $allow) {
4420 CHK("BRACES",
4421 "braces {} should be used on all arms of this statement\n" . $herectx);
4422 }
Andy Whitcroft13214ad2008-02-08 04:22:03 -08004423 }
4424 }
4425 }
Andy Whitcroft773647a2008-03-28 14:15:58 -07004426 if (!defined $suppress_ifbraces{$linenr - 1} &&
Andy Whitcroft13214ad2008-02-08 04:22:03 -08004427 $line =~ /\b(if|while|for|else)\b/) {
Andy Whitcroftcf655042008-03-04 14:28:20 -08004428 my $allowed = 0;
Andy Whitcroftf0a594c2007-07-19 01:48:34 -07004429
Andy Whitcroftcf655042008-03-04 14:28:20 -08004430 # Check the pre-context.
4431 if (substr($line, 0, $-[0]) =~ /(\}\s*)$/) {
4432 #print "APW: ALLOWED: pre<$1>\n";
4433 $allowed = 1;
4434 }
Andy Whitcroft773647a2008-03-28 14:15:58 -07004435
4436 my ($level, $endln, @chunks) =
4437 ctx_statement_full($linenr, $realcnt, $-[0]);
4438
Andy Whitcroftcf655042008-03-04 14:28:20 -08004439 # Check the condition.
4440 my ($cond, $block) = @{$chunks[0]};
Andy Whitcroft773647a2008-03-28 14:15:58 -07004441 #print "CHECKING<$linenr> cond<$cond> block<$block>\n";
Andy Whitcroftcf655042008-03-04 14:28:20 -08004442 if (defined $cond) {
Andy Whitcroft773647a2008-03-28 14:15:58 -07004443 substr($block, 0, length($cond), '');
Andy Whitcroftcf655042008-03-04 14:28:20 -08004444 }
4445 if (statement_lines($cond) > 1) {
4446 #print "APW: ALLOWED: cond<$cond>\n";
4447 $allowed = 1;
4448 }
4449 if ($block =~/\b(?:if|for|while)\b/) {
4450 #print "APW: ALLOWED: block<$block>\n";
4451 $allowed = 1;
4452 }
4453 if (statement_block_size($block) > 1) {
4454 #print "APW: ALLOWED: lines block<$block>\n";
4455 $allowed = 1;
4456 }
4457 # Check the post-context.
4458 if (defined $chunks[1]) {
4459 my ($cond, $block) = @{$chunks[1]};
4460 if (defined $cond) {
Andy Whitcroft773647a2008-03-28 14:15:58 -07004461 substr($block, 0, length($cond), '');
Andy Whitcroftf0a594c2007-07-19 01:48:34 -07004462 }
Andy Whitcroftcf655042008-03-04 14:28:20 -08004463 if ($block =~ /^\s*\{/) {
4464 #print "APW: ALLOWED: chunk-1 block<$block>\n";
4465 $allowed = 1;
4466 }
4467 }
4468 if ($level == 0 && $block =~ /^\s*\{/ && !$allowed) {
Justin P. Mattock69932482011-07-26 23:06:29 -07004469 my $herectx = $here . "\n";
Andy Whitcroftf0556632008-10-15 22:02:23 -07004470 my $cnt = statement_rawlines($block);
Andy Whitcroftcf655042008-03-04 14:28:20 -08004471
Andy Whitcroftf0556632008-10-15 22:02:23 -07004472 for (my $n = 0; $n < $cnt; $n++) {
Justin P. Mattock69932482011-07-26 23:06:29 -07004473 $herectx .= raw_line($linenr, $n) . "\n";
Andy Whitcroftcf655042008-03-04 14:28:20 -08004474 }
4475
Joe Perches000d1cc12011-07-25 17:13:25 -07004476 WARN("BRACES",
4477 "braces {} are not necessary for single statement blocks\n" . $herectx);
Andy Whitcroftf0a594c2007-07-19 01:48:34 -07004478 }
4479 }
4480
Joe Perches0979ae62012-12-17 16:01:59 -08004481# check for unnecessary blank lines around braces
Joe Perches77b9a532013-07-03 15:05:29 -07004482 if (($line =~ /^.\s*}\s*$/ && $prevrawline =~ /^.\s*$/)) {
Joe Perchesf8e58212015-02-13 14:38:46 -08004483 if (CHK("BRACES",
4484 "Blank lines aren't necessary before a close brace '}'\n" . $hereprev) &&
4485 $fix && $prevrawline =~ /^\+/) {
4486 fix_delete_line($fixlinenr - 1, $prevrawline);
4487 }
Joe Perches0979ae62012-12-17 16:01:59 -08004488 }
Joe Perches77b9a532013-07-03 15:05:29 -07004489 if (($rawline =~ /^.\s*$/ && $prevline =~ /^..*{\s*$/)) {
Joe Perchesf8e58212015-02-13 14:38:46 -08004490 if (CHK("BRACES",
4491 "Blank lines aren't necessary after an open brace '{'\n" . $hereprev) &&
4492 $fix) {
4493 fix_delete_line($fixlinenr, $rawline);
4494 }
Joe Perches0979ae62012-12-17 16:01:59 -08004495 }
4496
Andy Whitcroft4a0df2e2007-06-08 13:46:39 -07004497# no volatiles please
Andy Whitcroft6c72ffa2007-10-18 03:05:08 -07004498 my $asm_volatile = qr{\b(__asm__|asm)\s+(__volatile__|volatile)\b};
4499 if ($line =~ /\bvolatile\b/ && $line !~ /$asm_volatile/) {
Joe Perches000d1cc12011-07-25 17:13:25 -07004500 WARN("VOLATILE",
4501 "Use of volatile is usually wrong: see Documentation/volatile-considered-harmful.txt\n" . $herecurr);
Andy Whitcroft4a0df2e2007-06-08 13:46:39 -07004502 }
4503
Joe Perches5e4f6ba2014-12-10 15:52:05 -08004504# Check for user-visible strings broken across lines, which breaks the ability
4505# to grep for the string. Make exceptions when the previous string ends in a
4506# newline (multiple lines in one string constant) or '\t', '\r', ';', or '{'
4507# (common in inline assembly) or is a octal \123 or hexadecimal \xaf value
4508 if ($line =~ /^\+\s*"[X\t]*"/ &&
4509 $prevline =~ /"\s*$/ &&
4510 $prevrawline !~ /(?:\\(?:[ntr]|[0-7]{1,3}|x[0-9a-fA-F]{1,2})|;\s*|\{\s*)"\s*$/) {
4511 if (WARN("SPLIT_STRING",
4512 "quoted string split across lines\n" . $hereprev) &&
4513 $fix &&
4514 $prevrawline =~ /^\+.*"\s*$/ &&
4515 $last_coalesced_string_linenr != $linenr - 1) {
4516 my $extracted_string = get_quoted_string($line, $rawline);
4517 my $comma_close = "";
4518 if ($rawline =~ /\Q$extracted_string\E(\s*\)\s*;\s*$|\s*,\s*)/) {
4519 $comma_close = $1;
4520 }
4521
4522 fix_delete_line($fixlinenr - 1, $prevrawline);
4523 fix_delete_line($fixlinenr, $rawline);
4524 my $fixedline = $prevrawline;
4525 $fixedline =~ s/"\s*$//;
4526 $fixedline .= substr($extracted_string, 1) . trim($comma_close);
4527 fix_insert_line($fixlinenr - 1, $fixedline);
4528 $fixedline = $rawline;
4529 $fixedline =~ s/\Q$extracted_string\E\Q$comma_close\E//;
4530 if ($fixedline !~ /\+\s*$/) {
4531 fix_insert_line($fixlinenr, $fixedline);
4532 }
4533 $last_coalesced_string_linenr = $linenr;
4534 }
4535 }
4536
4537# check for missing a space in a string concatenation
4538 if ($prevrawline =~ /[^\\]\w"$/ && $rawline =~ /^\+[\t ]+"\w/) {
4539 WARN('MISSING_SPACE',
4540 "break quoted strings at a space character\n" . $hereprev);
4541 }
4542
4543# check for spaces before a quoted newline
4544 if ($rawline =~ /^.*\".*\s\\n/) {
4545 if (WARN("QUOTED_WHITESPACE_BEFORE_NEWLINE",
4546 "unnecessary whitespace before a quoted newline\n" . $herecurr) &&
4547 $fix) {
4548 $fixed[$fixlinenr] =~ s/^(\+.*\".*)\s+\\n/$1\\n/;
4549 }
4550
4551 }
4552
Joe Perchesf17dba42014-10-13 15:51:51 -07004553# concatenated string without spaces between elements
4554 if ($line =~ /"X+"[A-Z_]+/ || $line =~ /[A-Z_]+"X+"/) {
4555 CHK("CONCATENATED_STRING",
4556 "Concatenated strings should use spaces between elements\n" . $herecurr);
4557 }
4558
Joe Perches90ad30e2014-12-10 15:51:59 -08004559# uncoalesced string fragments
4560 if ($line =~ /"X*"\s*"/) {
4561 WARN("STRING_FRAGMENTS",
4562 "Consecutive strings are generally better as a single string\n" . $herecurr);
4563 }
4564
Joe Perches5e4f6ba2014-12-10 15:52:05 -08004565# check for %L{u,d,i} in strings
4566 my $string;
4567 while ($line =~ /(?:^|")([X\t]*)(?:"|$)/g) {
4568 $string = substr($rawline, $-[1], $+[1] - $-[1]);
4569 $string =~ s/%%/__/g;
4570 if ($string =~ /(?<!%)%L[udi]/) {
4571 WARN("PRINTF_L",
4572 "\%Ld/%Lu are not-standard C, use %lld/%llu\n" . $herecurr);
4573 last;
4574 }
4575 }
4576
4577# check for line continuations in quoted strings with odd counts of "
4578 if ($rawline =~ /\\$/ && $rawline =~ tr/"/"/ % 2) {
4579 WARN("LINE_CONTINUATIONS",
4580 "Avoid line continuations in quoted strings\n" . $herecurr);
4581 }
4582
Andy Whitcroft00df3442007-06-08 13:47:06 -07004583# warn about #if 0
Andy Whitcroftc45dcab2008-06-05 22:46:01 -07004584 if ($line =~ /^.\s*\#\s*if\s+0\b/) {
Joe Perches000d1cc12011-07-25 17:13:25 -07004585 CHK("REDUNDANT_CODE",
4586 "if this code is redundant consider removing it\n" .
Andy Whitcroftde7d4f02007-07-15 23:37:22 -07004587 $herecurr);
Andy Whitcroft4a0df2e2007-06-08 13:46:39 -07004588 }
4589
Andy Whitcroft03df4b52012-12-17 16:01:52 -08004590# check for needless "if (<foo>) fn(<foo>)" uses
4591 if ($prevline =~ /\bif\s*\(\s*($Lval)\s*\)/) {
4592 my $expr = '\s*\(\s*' . quotemeta($1) . '\s*\)\s*;';
4593 if ($line =~ /\b(kfree|usb_free_urb|debugfs_remove(?:_recursive)?)$expr/) {
4594 WARN('NEEDLESS_IF',
Fabio Estevam15160f92014-12-10 15:51:40 -08004595 "$1(NULL) is safe and this check is probably not required\n" . $hereprev);
Greg Kroah-Hartman4c432a82008-07-23 21:29:04 -07004596 }
4597 }
Andy Whitcroftf0a594c2007-07-19 01:48:34 -07004598
Joe Perchesebfdc402014-08-06 16:10:27 -07004599# check for unnecessary "Out of Memory" messages
4600 if ($line =~ /^\+.*\b$logFunctions\s*\(/ &&
4601 $prevline =~ /^[ \+]\s*if\s*\(\s*(\!\s*|NULL\s*==\s*)?($Lval)(\s*==\s*NULL\s*)?\s*\)/ &&
4602 (defined $1 || defined $3) &&
4603 $linenr > 3) {
4604 my $testval = $2;
4605 my $testline = $lines[$linenr - 3];
4606
4607 my ($s, $c) = ctx_statement_block($linenr - 3, $realcnt, 0);
4608# print("line: <$line>\nprevline: <$prevline>\ns: <$s>\nc: <$c>\n\n\n");
4609
4610 if ($c =~ /(?:^|\n)[ \+]\s*(?:$Type\s*)?\Q$testval\E\s*=\s*(?:\([^\)]*\)\s*)?\s*(?:devm_)?(?:[kv][czm]alloc(?:_node|_array)?\b|kstrdup|(?:dev_)?alloc_skb)/) {
4611 WARN("OOM_MESSAGE",
4612 "Possible unnecessary 'out of memory' message\n" . $hereprev);
4613 }
4614 }
4615
Joe Perchesf78d98f2014-10-13 15:52:01 -07004616# check for logging functions with KERN_<LEVEL>
Paolo Bonzinidcaf1122015-02-13 14:38:26 -08004617 if ($line !~ /printk(?:_ratelimited|_once)?\s*\(/ &&
Joe Perchesf78d98f2014-10-13 15:52:01 -07004618 $line =~ /\b$logFunctions\s*\(.*\b(KERN_[A-Z]+)\b/) {
4619 my $level = $1;
4620 if (WARN("UNNECESSARY_KERN_LEVEL",
4621 "Possible unnecessary $level\n" . $herecurr) &&
4622 $fix) {
4623 $fixed[$fixlinenr] =~ s/\s*$level\s*//;
4624 }
4625 }
4626
Joe Perchesabb08a52014-12-10 15:51:46 -08004627# check for mask then right shift without a parentheses
4628 if ($^V && $^V ge 5.10.0 &&
4629 $line =~ /$LvalOrFunc\s*\&\s*($LvalOrFunc)\s*>>/ &&
4630 $4 !~ /^\&/) { # $LvalOrFunc may be &foo, ignore if so
4631 WARN("MASK_THEN_SHIFT",
4632 "Possible precedence defect with mask then right shift - may need parentheses\n" . $herecurr);
4633 }
4634
Joe Perchesb75ac612014-12-10 15:52:02 -08004635# check for pointer comparisons to NULL
4636 if ($^V && $^V ge 5.10.0) {
4637 while ($line =~ /\b$LvalOrFunc\s*(==|\!=)\s*NULL\b/g) {
4638 my $val = $1;
4639 my $equal = "!";
4640 $equal = "" if ($4 eq "!=");
4641 if (CHK("COMPARISON_TO_NULL",
4642 "Comparison to NULL could be written \"${equal}${val}\"\n" . $herecurr) &&
4643 $fix) {
4644 $fixed[$fixlinenr] =~ s/\b\Q$val\E\s*(?:==|\!=)\s*NULL\b/$equal$val/;
4645 }
4646 }
4647 }
4648
Joe Perches8716de32013-09-11 14:24:05 -07004649# check for bad placement of section $InitAttribute (e.g.: __initdata)
4650 if ($line =~ /(\b$InitAttribute\b)/) {
4651 my $attr = $1;
4652 if ($line =~ /^\+\s*static\s+(?:const\s+)?(?:$attr\s+)?($NonptrTypeWithAttr)\s+(?:$attr\s+)?($Ident(?:\[[^]]*\])?)\s*[=;]/) {
4653 my $ptr = $1;
4654 my $var = $2;
4655 if ((($ptr =~ /\b(union|struct)\s+$attr\b/ &&
4656 ERROR("MISPLACED_INIT",
4657 "$attr should be placed after $var\n" . $herecurr)) ||
4658 ($ptr !~ /\b(union|struct)\s+$attr\b/ &&
4659 WARN("MISPLACED_INIT",
4660 "$attr should be placed after $var\n" . $herecurr))) &&
4661 $fix) {
Joe Perches194f66f2014-08-06 16:11:03 -07004662 $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;
Joe Perches8716de32013-09-11 14:24:05 -07004663 }
4664 }
4665 }
4666
Joe Perchese970b8842013-11-12 15:10:10 -08004667# check for $InitAttributeData (ie: __initdata) with const
4668 if ($line =~ /\bconst\b/ && $line =~ /($InitAttributeData)/) {
4669 my $attr = $1;
4670 $attr =~ /($InitAttributePrefix)(.*)/;
4671 my $attr_prefix = $1;
4672 my $attr_type = $2;
4673 if (ERROR("INIT_ATTRIBUTE",
4674 "Use of const init definition must use ${attr_prefix}initconst\n" . $herecurr) &&
4675 $fix) {
Joe Perches194f66f2014-08-06 16:11:03 -07004676 $fixed[$fixlinenr] =~
Joe Perchese970b8842013-11-12 15:10:10 -08004677 s/$InitAttributeData/${attr_prefix}initconst/;
4678 }
4679 }
4680
4681# check for $InitAttributeConst (ie: __initconst) without const
4682 if ($line !~ /\bconst\b/ && $line =~ /($InitAttributeConst)/) {
4683 my $attr = $1;
4684 if (ERROR("INIT_ATTRIBUTE",
4685 "Use of $attr requires a separate use of const\n" . $herecurr) &&
4686 $fix) {
Joe Perches194f66f2014-08-06 16:11:03 -07004687 my $lead = $fixed[$fixlinenr] =~
Joe Perchese970b8842013-11-12 15:10:10 -08004688 /(^\+\s*(?:static\s+))/;
4689 $lead = rtrim($1);
4690 $lead = "$lead " if ($lead !~ /^\+$/);
4691 $lead = "${lead}const ";
Joe Perches194f66f2014-08-06 16:11:03 -07004692 $fixed[$fixlinenr] =~ s/(^\+\s*(?:static\s+))/$lead/;
Joe Perchese970b8842013-11-12 15:10:10 -08004693 }
4694 }
4695
Joe Perchesfbdb8132014-04-03 14:49:14 -07004696# don't use __constant_<foo> functions outside of include/uapi/
4697 if ($realfile !~ m@^include/uapi/@ &&
4698 $line =~ /(__constant_(?:htons|ntohs|[bl]e(?:16|32|64)_to_cpu|cpu_to_[bl]e(?:16|32|64)))\s*\(/) {
4699 my $constant_func = $1;
4700 my $func = $constant_func;
4701 $func =~ s/^__constant_//;
4702 if (WARN("CONSTANT_CONVERSION",
4703 "$constant_func should be $func\n" . $herecurr) &&
4704 $fix) {
Joe Perches194f66f2014-08-06 16:11:03 -07004705 $fixed[$fixlinenr] =~ s/\b$constant_func\b/$func/g;
Joe Perchesfbdb8132014-04-03 14:49:14 -07004706 }
4707 }
4708
Patrick Pannuto1a15a252010-08-09 17:21:01 -07004709# prefer usleep_range over udelay
Bruce Allan37581c22013-02-21 16:44:19 -08004710 if ($line =~ /\budelay\s*\(\s*(\d+)\s*\)/) {
Joe Perches43c1d772014-04-03 14:49:11 -07004711 my $delay = $1;
Patrick Pannuto1a15a252010-08-09 17:21:01 -07004712 # ignore udelay's < 10, however
Joe Perches43c1d772014-04-03 14:49:11 -07004713 if (! ($delay < 10) ) {
Joe Perches000d1cc12011-07-25 17:13:25 -07004714 CHK("USLEEP_RANGE",
Joe Perches43c1d772014-04-03 14:49:11 -07004715 "usleep_range is preferred over udelay; see Documentation/timers/timers-howto.txt\n" . $herecurr);
4716 }
4717 if ($delay > 2000) {
4718 WARN("LONG_UDELAY",
4719 "long udelay - prefer mdelay; see arch/arm/include/asm/delay.h\n" . $herecurr);
Patrick Pannuto1a15a252010-08-09 17:21:01 -07004720 }
4721 }
4722
Patrick Pannuto09ef8722010-08-09 17:21:02 -07004723# warn about unexpectedly long msleep's
4724 if ($line =~ /\bmsleep\s*\((\d+)\);/) {
4725 if ($1 < 20) {
Joe Perches000d1cc12011-07-25 17:13:25 -07004726 WARN("MSLEEP",
Joe Perches43c1d772014-04-03 14:49:11 -07004727 "msleep < 20ms can sleep for up to 20ms; see Documentation/timers/timers-howto.txt\n" . $herecurr);
Patrick Pannuto09ef8722010-08-09 17:21:02 -07004728 }
4729 }
4730
Joe Perches36ec1932013-07-03 15:05:25 -07004731# check for comparisons of jiffies
4732 if ($line =~ /\bjiffies\s*$Compare|$Compare\s*jiffies\b/) {
4733 WARN("JIFFIES_COMPARISON",
4734 "Comparing jiffies is almost always wrong; prefer time_after, time_before and friends\n" . $herecurr);
4735 }
4736
Joe Perches9d7a34a2013-07-03 15:05:26 -07004737# check for comparisons of get_jiffies_64()
4738 if ($line =~ /\bget_jiffies_64\s*\(\s*\)\s*$Compare|$Compare\s*get_jiffies_64\s*\(\s*\)/) {
4739 WARN("JIFFIES_COMPARISON",
4740 "Comparing get_jiffies_64() is almost always wrong; prefer time_after64, time_before64 and friends\n" . $herecurr);
4741 }
4742
Andy Whitcroft00df3442007-06-08 13:47:06 -07004743# warn about #ifdefs in C files
Andy Whitcroftc45dcab2008-06-05 22:46:01 -07004744# if ($line =~ /^.\s*\#\s*if(|n)def/ && ($realfile =~ /\.c$/)) {
Andy Whitcroft00df3442007-06-08 13:47:06 -07004745# print "#ifdef in C files should be avoided\n";
4746# print "$herecurr";
4747# $clean = 0;
4748# }
4749
Andy Whitcroft22f2a2e2007-08-10 13:01:03 -07004750# warn about spacing in #ifdefs
Andy Whitcroftc45dcab2008-06-05 22:46:01 -07004751 if ($line =~ /^.\s*\#\s*(ifdef|ifndef|elif)\s\s+/) {
Joe Perches3705ce52013-07-03 15:05:31 -07004752 if (ERROR("SPACING",
4753 "exactly one space required after that #$1\n" . $herecurr) &&
4754 $fix) {
Joe Perches194f66f2014-08-06 16:11:03 -07004755 $fixed[$fixlinenr] =~
Joe Perches3705ce52013-07-03 15:05:31 -07004756 s/^(.\s*\#\s*(ifdef|ifndef|elif))\s{2,}/$1 /;
4757 }
4758
Andy Whitcroft22f2a2e2007-08-10 13:01:03 -07004759 }
4760
Andy Whitcroft4a0df2e2007-06-08 13:46:39 -07004761# check for spinlock_t definitions without a comment.
Andy Whitcroft171ae1a2008-04-29 00:59:32 -07004762 if ($line =~ /^.\s*(struct\s+mutex|spinlock_t)\s+\S+;/ ||
4763 $line =~ /^.\s*(DEFINE_MUTEX)\s*\(/) {
Andy Whitcroft4a0df2e2007-06-08 13:46:39 -07004764 my $which = $1;
4765 if (!ctx_has_comment($first_line, $linenr)) {
Joe Perches000d1cc12011-07-25 17:13:25 -07004766 CHK("UNCOMMENTED_DEFINITION",
4767 "$1 definition without comment\n" . $herecurr);
Andy Whitcroft4a0df2e2007-06-08 13:46:39 -07004768 }
4769 }
4770# check for memory barriers without a comment.
4771 if ($line =~ /\b(mb|rmb|wmb|read_barrier_depends|smp_mb|smp_rmb|smp_wmb|smp_read_barrier_depends)\(/) {
4772 if (!ctx_has_comment($first_line, $linenr)) {
Joe Perchesc1fd7bb2013-11-12 15:10:11 -08004773 WARN("MEMORY_BARRIER",
4774 "memory barrier without comment\n" . $herecurr);
Andy Whitcroft4a0df2e2007-06-08 13:46:39 -07004775 }
4776 }
4777# check of hardware specific defines
Andy Whitcroftc45dcab2008-06-05 22:46:01 -07004778 if ($line =~ m@^.\s*\#\s*if.*\b(__i386__|__powerpc64__|__sun__|__s390x__)\b@ && $realfile !~ m@include/asm-@) {
Joe Perches000d1cc12011-07-25 17:13:25 -07004779 CHK("ARCH_DEFINES",
4780 "architecture specific defines should be avoided\n" . $herecurr);
Andy Whitcroft0a920b5b2007-06-01 00:46:48 -07004781 }
Andy Whitcroft653d4872007-06-23 17:16:34 -07004782
Tobias Klauserd4977c72010-05-24 14:33:30 -07004783# Check that the storage class is at the beginning of a declaration
4784 if ($line =~ /\b$Storage\b/ && $line !~ /^.\s*$Storage\b/) {
Joe Perches000d1cc12011-07-25 17:13:25 -07004785 WARN("STORAGE_CLASS",
4786 "storage class should be at the beginning of the declaration\n" . $herecurr)
Tobias Klauserd4977c72010-05-24 14:33:30 -07004787 }
4788
Andy Whitcroftde7d4f02007-07-15 23:37:22 -07004789# check the location of the inline attribute, that it is between
4790# storage class and type.
Andy Whitcroft9c0ca6f2007-10-16 23:29:38 -07004791 if ($line =~ /\b$Type\s+$Inline\b/ ||
4792 $line =~ /\b$Inline\s+$Storage\b/) {
Joe Perches000d1cc12011-07-25 17:13:25 -07004793 ERROR("INLINE_LOCATION",
4794 "inline keyword should sit between storage class and type\n" . $herecurr);
Andy Whitcroftde7d4f02007-07-15 23:37:22 -07004795 }
4796
Andy Whitcroft8905a672007-11-28 16:21:06 -08004797# Check for __inline__ and __inline, prefer inline
Joe Perches2b7ab452013-11-12 15:10:14 -08004798 if ($realfile !~ m@\binclude/uapi/@ &&
4799 $line =~ /\b(__inline__|__inline)\b/) {
Joe Perchesd5e616f2013-09-11 14:23:54 -07004800 if (WARN("INLINE",
4801 "plain inline is preferred over $1\n" . $herecurr) &&
4802 $fix) {
Joe Perches194f66f2014-08-06 16:11:03 -07004803 $fixed[$fixlinenr] =~ s/\b(__inline__|__inline)\b/inline/;
Joe Perchesd5e616f2013-09-11 14:23:54 -07004804
4805 }
Andy Whitcroft8905a672007-11-28 16:21:06 -08004806 }
4807
Joe Perches3d130fd2011-01-12 17:00:00 -08004808# Check for __attribute__ packed, prefer __packed
Joe Perches2b7ab452013-11-12 15:10:14 -08004809 if ($realfile !~ m@\binclude/uapi/@ &&
4810 $line =~ /\b__attribute__\s*\(\s*\(.*\bpacked\b/) {
Joe Perches000d1cc12011-07-25 17:13:25 -07004811 WARN("PREFER_PACKED",
4812 "__packed is preferred over __attribute__((packed))\n" . $herecurr);
Joe Perches3d130fd2011-01-12 17:00:00 -08004813 }
4814
Joe Perches39b7e282011-07-25 17:13:24 -07004815# Check for __attribute__ aligned, prefer __aligned
Joe Perches2b7ab452013-11-12 15:10:14 -08004816 if ($realfile !~ m@\binclude/uapi/@ &&
4817 $line =~ /\b__attribute__\s*\(\s*\(.*aligned/) {
Joe Perches000d1cc12011-07-25 17:13:25 -07004818 WARN("PREFER_ALIGNED",
4819 "__aligned(size) is preferred over __attribute__((aligned(size)))\n" . $herecurr);
Joe Perches39b7e282011-07-25 17:13:24 -07004820 }
4821
Joe Perches5f14d3b2012-01-10 15:09:52 -08004822# Check for __attribute__ format(printf, prefer __printf
Joe Perches2b7ab452013-11-12 15:10:14 -08004823 if ($realfile !~ m@\binclude/uapi/@ &&
4824 $line =~ /\b__attribute__\s*\(\s*\(\s*format\s*\(\s*printf/) {
Joe Perchesd5e616f2013-09-11 14:23:54 -07004825 if (WARN("PREFER_PRINTF",
4826 "__printf(string-index, first-to-check) is preferred over __attribute__((format(printf, string-index, first-to-check)))\n" . $herecurr) &&
4827 $fix) {
Joe Perches194f66f2014-08-06 16:11:03 -07004828 $fixed[$fixlinenr] =~ s/\b__attribute__\s*\(\s*\(\s*format\s*\(\s*printf\s*,\s*(.*)\)\s*\)\s*\)/"__printf(" . trim($1) . ")"/ex;
Joe Perchesd5e616f2013-09-11 14:23:54 -07004829
4830 }
Joe Perches5f14d3b2012-01-10 15:09:52 -08004831 }
4832
Joe Perches6061d942012-03-23 15:02:16 -07004833# Check for __attribute__ format(scanf, prefer __scanf
Joe Perches2b7ab452013-11-12 15:10:14 -08004834 if ($realfile !~ m@\binclude/uapi/@ &&
4835 $line =~ /\b__attribute__\s*\(\s*\(\s*format\s*\(\s*scanf\b/) {
Joe Perchesd5e616f2013-09-11 14:23:54 -07004836 if (WARN("PREFER_SCANF",
4837 "__scanf(string-index, first-to-check) is preferred over __attribute__((format(scanf, string-index, first-to-check)))\n" . $herecurr) &&
4838 $fix) {
Joe Perches194f66f2014-08-06 16:11:03 -07004839 $fixed[$fixlinenr] =~ s/\b__attribute__\s*\(\s*\(\s*format\s*\(\s*scanf\s*,\s*(.*)\)\s*\)\s*\)/"__scanf(" . trim($1) . ")"/ex;
Joe Perchesd5e616f2013-09-11 14:23:54 -07004840 }
Joe Perches6061d942012-03-23 15:02:16 -07004841 }
4842
Joe Perches619a9082014-12-10 15:51:35 -08004843# Check for __attribute__ weak, or __weak declarations (may have link issues)
4844 if ($^V && $^V ge 5.10.0 &&
4845 $line =~ /(?:$Declare|$DeclareMisordered)\s*$Ident\s*$balanced_parens\s*(?:$Attribute)?\s*;/ &&
4846 ($line =~ /\b__attribute__\s*\(\s*\(.*\bweak\b/ ||
4847 $line =~ /\b__weak\b/)) {
4848 ERROR("WEAK_DECLARATION",
4849 "Using weak declarations can have unintended link defects\n" . $herecurr);
4850 }
4851
Joe Perches8f53a9b2010-03-05 13:43:48 -08004852# check for sizeof(&)
4853 if ($line =~ /\bsizeof\s*\(\s*\&/) {
Joe Perches000d1cc12011-07-25 17:13:25 -07004854 WARN("SIZEOF_ADDRESS",
4855 "sizeof(& should be avoided\n" . $herecurr);
Joe Perches8f53a9b2010-03-05 13:43:48 -08004856 }
4857
Joe Perches66c80b62012-07-30 14:41:22 -07004858# check for sizeof without parenthesis
4859 if ($line =~ /\bsizeof\s+((?:\*\s*|)$Lval|$Type(?:\s+$Lval|))/) {
Joe Perchesd5e616f2013-09-11 14:23:54 -07004860 if (WARN("SIZEOF_PARENTHESIS",
4861 "sizeof $1 should be sizeof($1)\n" . $herecurr) &&
4862 $fix) {
Joe Perches194f66f2014-08-06 16:11:03 -07004863 $fixed[$fixlinenr] =~ s/\bsizeof\s+((?:\*\s*|)$Lval|$Type(?:\s+$Lval|))/"sizeof(" . trim($1) . ")"/ex;
Joe Perchesd5e616f2013-09-11 14:23:54 -07004864 }
Joe Perches66c80b62012-07-30 14:41:22 -07004865 }
4866
Joe Perches88982fe2012-12-17 16:02:00 -08004867# check for struct spinlock declarations
4868 if ($line =~ /^.\s*\bstruct\s+spinlock\s+\w+\s*;/) {
4869 WARN("USE_SPINLOCK_T",
4870 "struct spinlock should be spinlock_t\n" . $herecurr);
4871 }
4872
Joe Perchesa6962d72013-04-29 16:18:13 -07004873# check for seq_printf uses that could be seq_puts
Joe Perches06668722013-11-12 15:10:07 -08004874 if ($sline =~ /\bseq_printf\s*\(.*"\s*\)\s*;\s*$/) {
Joe Perchesa6962d72013-04-29 16:18:13 -07004875 my $fmt = get_quoted_string($line, $rawline);
Heba Aamercaac1d52015-02-13 14:38:49 -08004876 $fmt =~ s/%%//g;
4877 if ($fmt !~ /%/) {
Joe Perchesd5e616f2013-09-11 14:23:54 -07004878 if (WARN("PREFER_SEQ_PUTS",
4879 "Prefer seq_puts to seq_printf\n" . $herecurr) &&
4880 $fix) {
Joe Perches194f66f2014-08-06 16:11:03 -07004881 $fixed[$fixlinenr] =~ s/\bseq_printf\b/seq_puts/;
Joe Perchesd5e616f2013-09-11 14:23:54 -07004882 }
Joe Perchesa6962d72013-04-29 16:18:13 -07004883 }
4884 }
4885
Andy Whitcroft554e1652012-01-10 15:09:57 -08004886# Check for misused memsets
Joe Perchesd1fe9c02012-03-23 15:02:16 -07004887 if ($^V && $^V ge 5.10.0 &&
4888 defined $stat &&
Joe Perchesd7c76ba2012-01-10 15:09:58 -08004889 $stat =~ /^\+(?:.*?)\bmemset\s*\(\s*$FuncArg\s*,\s*$FuncArg\s*\,\s*$FuncArg\s*\)/s) {
Andy Whitcroft554e1652012-01-10 15:09:57 -08004890
Joe Perchesd7c76ba2012-01-10 15:09:58 -08004891 my $ms_addr = $2;
Joe Perchesd1fe9c02012-03-23 15:02:16 -07004892 my $ms_val = $7;
4893 my $ms_size = $12;
Joe Perchesd7c76ba2012-01-10 15:09:58 -08004894
Andy Whitcroft554e1652012-01-10 15:09:57 -08004895 if ($ms_size =~ /^(0x|)0$/i) {
4896 ERROR("MEMSET",
Joe Perchesd7c76ba2012-01-10 15:09:58 -08004897 "memset to 0's uses 0 as the 2nd argument, not the 3rd\n" . "$here\n$stat\n");
Andy Whitcroft554e1652012-01-10 15:09:57 -08004898 } elsif ($ms_size =~ /^(0x|)1$/i) {
4899 WARN("MEMSET",
Joe Perchesd7c76ba2012-01-10 15:09:58 -08004900 "single byte memset is suspicious. Swapped 2nd/3rd argument?\n" . "$here\n$stat\n");
4901 }
4902 }
4903
Joe Perches98a9bba2014-01-23 15:54:52 -08004904# Check for memcpy(foo, bar, ETH_ALEN) that could be ether_addr_copy(foo, bar)
4905 if ($^V && $^V ge 5.10.0 &&
4906 $line =~ /^\+(?:.*?)\bmemcpy\s*\(\s*$FuncArg\s*,\s*$FuncArg\s*\,\s*ETH_ALEN\s*\)/s) {
4907 if (WARN("PREFER_ETHER_ADDR_COPY",
4908 "Prefer ether_addr_copy() over memcpy() if the Ethernet addresses are __aligned(2)\n" . $herecurr) &&
4909 $fix) {
Joe Perches194f66f2014-08-06 16:11:03 -07004910 $fixed[$fixlinenr] =~ s/\bmemcpy\s*\(\s*$FuncArg\s*,\s*$FuncArg\s*\,\s*ETH_ALEN\s*\)/ether_addr_copy($2, $7)/;
Joe Perches98a9bba2014-01-23 15:54:52 -08004911 }
4912 }
4913
Joe Perchesd7c76ba2012-01-10 15:09:58 -08004914# typecasts on min/max could be min_t/max_t
Joe Perchesd1fe9c02012-03-23 15:02:16 -07004915 if ($^V && $^V ge 5.10.0 &&
4916 defined $stat &&
Joe Perchesd7c76ba2012-01-10 15:09:58 -08004917 $stat =~ /^\+(?:.*?)\b(min|max)\s*\(\s*$FuncArg\s*,\s*$FuncArg\s*\)/) {
Joe Perchesd1fe9c02012-03-23 15:02:16 -07004918 if (defined $2 || defined $7) {
Joe Perchesd7c76ba2012-01-10 15:09:58 -08004919 my $call = $1;
4920 my $cast1 = deparenthesize($2);
4921 my $arg1 = $3;
Joe Perchesd1fe9c02012-03-23 15:02:16 -07004922 my $cast2 = deparenthesize($7);
4923 my $arg2 = $8;
Joe Perchesd7c76ba2012-01-10 15:09:58 -08004924 my $cast;
4925
Joe Perchesd1fe9c02012-03-23 15:02:16 -07004926 if ($cast1 ne "" && $cast2 ne "" && $cast1 ne $cast2) {
Joe Perchesd7c76ba2012-01-10 15:09:58 -08004927 $cast = "$cast1 or $cast2";
4928 } elsif ($cast1 ne "") {
4929 $cast = $cast1;
4930 } else {
4931 $cast = $cast2;
4932 }
4933 WARN("MINMAX",
4934 "$call() should probably be ${call}_t($cast, $arg1, $arg2)\n" . "$here\n$stat\n");
Andy Whitcroft554e1652012-01-10 15:09:57 -08004935 }
4936 }
4937
Joe Perches4a273192012-07-30 14:41:20 -07004938# check usleep_range arguments
4939 if ($^V && $^V ge 5.10.0 &&
4940 defined $stat &&
4941 $stat =~ /^\+(?:.*?)\busleep_range\s*\(\s*($FuncArg)\s*,\s*($FuncArg)\s*\)/) {
4942 my $min = $1;
4943 my $max = $7;
4944 if ($min eq $max) {
4945 WARN("USLEEP_RANGE",
4946 "usleep_range should not use min == max args; see Documentation/timers/timers-howto.txt\n" . "$here\n$stat\n");
4947 } elsif ($min =~ /^\d+$/ && $max =~ /^\d+$/ &&
4948 $min > $max) {
4949 WARN("USLEEP_RANGE",
4950 "usleep_range args reversed, use min then max; see Documentation/timers/timers-howto.txt\n" . "$here\n$stat\n");
4951 }
4952 }
4953
Joe Perches823b7942013-11-12 15:10:15 -08004954# check for naked sscanf
4955 if ($^V && $^V ge 5.10.0 &&
4956 defined $stat &&
Joe Perches6c8bd702014-04-03 14:49:16 -07004957 $line =~ /\bsscanf\b/ &&
Joe Perches823b7942013-11-12 15:10:15 -08004958 ($stat !~ /$Ident\s*=\s*sscanf\s*$balanced_parens/ &&
4959 $stat !~ /\bsscanf\s*$balanced_parens\s*(?:$Compare)/ &&
4960 $stat !~ /(?:$Compare)\s*\bsscanf\s*$balanced_parens/)) {
4961 my $lc = $stat =~ tr@\n@@;
4962 $lc = $lc + $linenr;
4963 my $stat_real = raw_line($linenr, 0);
4964 for (my $count = $linenr + 1; $count <= $lc; $count++) {
4965 $stat_real = $stat_real . "\n" . raw_line($count, 0);
4966 }
4967 WARN("NAKED_SSCANF",
4968 "unchecked sscanf return value\n" . "$here\n$stat_real\n");
4969 }
4970
Joe Perchesafc819a2014-06-04 16:12:08 -07004971# check for simple sscanf that should be kstrto<foo>
4972 if ($^V && $^V ge 5.10.0 &&
4973 defined $stat &&
4974 $line =~ /\bsscanf\b/) {
4975 my $lc = $stat =~ tr@\n@@;
4976 $lc = $lc + $linenr;
4977 my $stat_real = raw_line($linenr, 0);
4978 for (my $count = $linenr + 1; $count <= $lc; $count++) {
4979 $stat_real = $stat_real . "\n" . raw_line($count, 0);
4980 }
4981 if ($stat_real =~ /\bsscanf\b\s*\(\s*$FuncArg\s*,\s*("[^"]+")/) {
4982 my $format = $6;
4983 my $count = $format =~ tr@%@%@;
4984 if ($count == 1 &&
4985 $format =~ /^"\%(?i:ll[udxi]|[udxi]ll|ll|[hl]h?[udxi]|[udxi][hl]h?|[hl]h?|[udxi])"$/) {
4986 WARN("SSCANF_TO_KSTRTO",
4987 "Prefer kstrto<type> to single variable sscanf\n" . "$here\n$stat_real\n");
4988 }
4989 }
4990 }
4991
Joe Perches70dc8a42013-09-11 14:23:58 -07004992# check for new externs in .h files.
4993 if ($realfile =~ /\.h$/ &&
4994 $line =~ /^\+\s*(extern\s+)$Type\s*$Ident\s*\(/s) {
Joe Perchesd1d85782013-09-24 15:27:46 -07004995 if (CHK("AVOID_EXTERNS",
4996 "extern prototypes should be avoided in .h files\n" . $herecurr) &&
Joe Perches70dc8a42013-09-11 14:23:58 -07004997 $fix) {
Joe Perches194f66f2014-08-06 16:11:03 -07004998 $fixed[$fixlinenr] =~ s/(.*)\bextern\b\s*(.*)/$1$2/;
Joe Perches70dc8a42013-09-11 14:23:58 -07004999 }
5000 }
5001
Andy Whitcroftde7d4f02007-07-15 23:37:22 -07005002# check for new externs in .c files.
Andy Whitcroft171ae1a2008-04-29 00:59:32 -07005003 if ($realfile =~ /\.c$/ && defined $stat &&
Andy Whitcroftc45dcab2008-06-05 22:46:01 -07005004 $stat =~ /^.\s*(?:extern\s+)?$Type\s+($Ident)(\s*)\(/s)
Andy Whitcroft171ae1a2008-04-29 00:59:32 -07005005 {
Andy Whitcroftc45dcab2008-06-05 22:46:01 -07005006 my $function_name = $1;
5007 my $paren_space = $2;
Andy Whitcroft171ae1a2008-04-29 00:59:32 -07005008
5009 my $s = $stat;
5010 if (defined $cond) {
5011 substr($s, 0, length($cond), '');
5012 }
Andy Whitcroftc45dcab2008-06-05 22:46:01 -07005013 if ($s =~ /^\s*;/ &&
5014 $function_name ne 'uninitialized_var')
5015 {
Joe Perches000d1cc12011-07-25 17:13:25 -07005016 WARN("AVOID_EXTERNS",
5017 "externs should be avoided in .c files\n" . $herecurr);
Andy Whitcroft171ae1a2008-04-29 00:59:32 -07005018 }
5019
5020 if ($paren_space =~ /\n/) {
Joe Perches000d1cc12011-07-25 17:13:25 -07005021 WARN("FUNCTION_ARGUMENTS",
5022 "arguments for function declarations should follow identifier\n" . $herecurr);
Andy Whitcroft171ae1a2008-04-29 00:59:32 -07005023 }
Andy Whitcroft9c9ba342008-04-29 00:59:33 -07005024
5025 } elsif ($realfile =~ /\.c$/ && defined $stat &&
5026 $stat =~ /^.\s*extern\s+/)
5027 {
Joe Perches000d1cc12011-07-25 17:13:25 -07005028 WARN("AVOID_EXTERNS",
5029 "externs should be avoided in .c files\n" . $herecurr);
Andy Whitcroftde7d4f02007-07-15 23:37:22 -07005030 }
5031
5032# checks for new __setup's
5033 if ($rawline =~ /\b__setup\("([^"]*)"/) {
5034 my $name = $1;
5035
5036 if (!grep(/$name/, @setup_docs)) {
Joe Perches000d1cc12011-07-25 17:13:25 -07005037 CHK("UNDOCUMENTED_SETUP",
5038 "__setup appears un-documented -- check Documentation/kernel-parameters.txt\n" . $herecurr);
Andy Whitcroftde7d4f02007-07-15 23:37:22 -07005039 }
Andy Whitcroft653d4872007-06-23 17:16:34 -07005040 }
Andy Whitcroft9c0ca6f2007-10-16 23:29:38 -07005041
5042# check for pointless casting of kmalloc return
Joe Perchescaf2a542011-01-12 16:59:56 -08005043 if ($line =~ /\*\s*\)\s*[kv][czm]alloc(_node){0,1}\b/) {
Joe Perches000d1cc12011-07-25 17:13:25 -07005044 WARN("UNNECESSARY_CASTS",
5045 "unnecessary cast may hide bugs, see http://c-faq.com/malloc/mallocnocast.html\n" . $herecurr);
Andy Whitcroft9c0ca6f2007-10-16 23:29:38 -07005046 }
Andy Whitcroft13214ad2008-02-08 04:22:03 -08005047
Joe Perchesa640d252013-07-03 15:05:21 -07005048# alloc style
5049# p = alloc(sizeof(struct foo), ...) should be p = alloc(sizeof(*p), ...)
5050 if ($^V && $^V ge 5.10.0 &&
5051 $line =~ /\b($Lval)\s*\=\s*(?:$balanced_parens)?\s*([kv][mz]alloc(?:_node)?)\s*\(\s*(sizeof\s*\(\s*struct\s+$Lval\s*\))/) {
5052 CHK("ALLOC_SIZEOF_STRUCT",
5053 "Prefer $3(sizeof(*$1)...) over $3($4...)\n" . $herecurr);
5054 }
5055
Joe Perches60a55362014-06-04 16:12:07 -07005056# check for k[mz]alloc with multiplies that could be kmalloc_array/kcalloc
5057 if ($^V && $^V ge 5.10.0 &&
Joe Perchese3674552014-08-06 16:10:55 -07005058 $line =~ /\b($Lval)\s*\=\s*(?:$balanced_parens)?\s*(k[mz]alloc)\s*\(\s*($FuncArg)\s*\*\s*($FuncArg)\s*,/) {
Joe Perches60a55362014-06-04 16:12:07 -07005059 my $oldfunc = $3;
5060 my $a1 = $4;
5061 my $a2 = $10;
5062 my $newfunc = "kmalloc_array";
5063 $newfunc = "kcalloc" if ($oldfunc eq "kzalloc");
Joe Perchese3674552014-08-06 16:10:55 -07005064 my $r1 = $a1;
5065 my $r2 = $a2;
5066 if ($a1 =~ /^sizeof\s*\S/) {
5067 $r1 = $a2;
5068 $r2 = $a1;
5069 }
5070 if ($r1 !~ /^sizeof\b/ && $r2 =~ /^sizeof\s*\S/ &&
5071 !($r1 =~ /^$Constant$/ || $r1 =~ /^[A-Z_][A-Z0-9_]*$/)) {
Joe Perches60a55362014-06-04 16:12:07 -07005072 if (WARN("ALLOC_WITH_MULTIPLY",
5073 "Prefer $newfunc over $oldfunc with multiply\n" . $herecurr) &&
5074 $fix) {
Joe Perches194f66f2014-08-06 16:11:03 -07005075 $fixed[$fixlinenr] =~ s/\b($Lval)\s*\=\s*(?:$balanced_parens)?\s*(k[mz]alloc)\s*\(\s*($FuncArg)\s*\*\s*($FuncArg)/$1 . ' = ' . "$newfunc(" . trim($r1) . ', ' . trim($r2)/e;
Joe Perches60a55362014-06-04 16:12:07 -07005076
5077 }
5078 }
5079 }
5080
Joe Perches972fdea2013-04-29 16:18:12 -07005081# check for krealloc arg reuse
5082 if ($^V && $^V ge 5.10.0 &&
5083 $line =~ /\b($Lval)\s*\=\s*(?:$balanced_parens)?\s*krealloc\s*\(\s*\1\s*,/) {
5084 WARN("KREALLOC_ARG_REUSE",
5085 "Reusing the krealloc arg is almost always a bug\n" . $herecurr);
5086 }
5087
Joe Perches5ce59ae2013-02-21 16:44:18 -08005088# check for alloc argument mismatch
5089 if ($line =~ /\b(kcalloc|kmalloc_array)\s*\(\s*sizeof\b/) {
5090 WARN("ALLOC_ARRAY_ARGS",
5091 "$1 uses number as first arg, sizeof is generally wrong\n" . $herecurr);
5092 }
5093
Joe Perchescaf2a542011-01-12 16:59:56 -08005094# check for multiple semicolons
5095 if ($line =~ /;\s*;\s*$/) {
Joe Perchesd5e616f2013-09-11 14:23:54 -07005096 if (WARN("ONE_SEMICOLON",
5097 "Statements terminations use 1 semicolon\n" . $herecurr) &&
5098 $fix) {
Joe Perches194f66f2014-08-06 16:11:03 -07005099 $fixed[$fixlinenr] =~ s/(\s*;\s*){2,}$/;/g;
Joe Perchesd5e616f2013-09-11 14:23:54 -07005100 }
Joe Perchesd1e2ad02012-12-17 16:02:01 -08005101 }
5102
Joe Perches0ab90192014-12-10 15:51:57 -08005103# check for #defines like: 1 << <digit> that could be BIT(digit)
5104 if ($line =~ /#\s*define\s+\w+\s+\(?\s*1\s*([ulUL]*)\s*\<\<\s*(?:\d+|$Ident)\s*\)?/) {
5105 my $ull = "";
5106 $ull = "_ULL" if (defined($1) && $1 =~ /ll/i);
5107 if (CHK("BIT_MACRO",
5108 "Prefer using the BIT$ull macro\n" . $herecurr) &&
5109 $fix) {
5110 $fixed[$fixlinenr] =~ s/\(?\s*1\s*[ulUL]*\s*<<\s*(\d+|$Ident)\s*\)?/BIT${ull}($1)/;
5111 }
5112 }
5113
Joe Perchese81f2392014-08-06 16:11:25 -07005114# check for case / default statements not preceded by break/fallthrough/switch
Joe Perchesc34c09a2014-01-23 15:54:43 -08005115 if ($line =~ /^.\s*(?:case\s+(?:$Ident|$Constant)\s*|default):/) {
5116 my $has_break = 0;
5117 my $has_statement = 0;
5118 my $count = 0;
5119 my $prevline = $linenr;
Joe Perchese81f2392014-08-06 16:11:25 -07005120 while ($prevline > 1 && ($file || $count < 3) && !$has_break) {
Joe Perchesc34c09a2014-01-23 15:54:43 -08005121 $prevline--;
5122 my $rline = $rawlines[$prevline - 1];
5123 my $fline = $lines[$prevline - 1];
5124 last if ($fline =~ /^\@\@/);
5125 next if ($fline =~ /^\-/);
5126 next if ($fline =~ /^.(?:\s*(?:case\s+(?:$Ident|$Constant)[\s$;]*|default):[\s$;]*)*$/);
5127 $has_break = 1 if ($rline =~ /fall[\s_-]*(through|thru)/i);
5128 next if ($fline =~ /^.[\s$;]*$/);
5129 $has_statement = 1;
5130 $count++;
5131 $has_break = 1 if ($fline =~ /\bswitch\b|\b(?:break\s*;[\s$;]*$|return\b|goto\b|continue\b)/);
5132 }
5133 if (!$has_break && $has_statement) {
5134 WARN("MISSING_BREAK",
5135 "Possible switch case/default not preceeded by break or fallthrough comment\n" . $herecurr);
5136 }
5137 }
5138
Joe Perchesd1e2ad02012-12-17 16:02:01 -08005139# check for switch/default statements without a break;
5140 if ($^V && $^V ge 5.10.0 &&
5141 defined $stat &&
5142 $stat =~ /^\+[$;\s]*(?:case[$;\s]+\w+[$;\s]*:[$;\s]*|)*[$;\s]*\bdefault[$;\s]*:[$;\s]*;/g) {
5143 my $ctx = '';
5144 my $herectx = $here . "\n";
5145 my $cnt = statement_rawlines($stat);
5146 for (my $n = 0; $n < $cnt; $n++) {
5147 $herectx .= raw_line($linenr, $n) . "\n";
5148 }
5149 WARN("DEFAULT_NO_BREAK",
5150 "switch default: should use break\n" . $herectx);
Joe Perchescaf2a542011-01-12 16:59:56 -08005151 }
5152
Andy Whitcroft13214ad2008-02-08 04:22:03 -08005153# check for gcc specific __FUNCTION__
Joe Perchesd5e616f2013-09-11 14:23:54 -07005154 if ($line =~ /\b__FUNCTION__\b/) {
5155 if (WARN("USE_FUNC",
5156 "__func__ should be used instead of gcc specific __FUNCTION__\n" . $herecurr) &&
5157 $fix) {
Joe Perches194f66f2014-08-06 16:11:03 -07005158 $fixed[$fixlinenr] =~ s/\b__FUNCTION__\b/__func__/g;
Joe Perchesd5e616f2013-09-11 14:23:54 -07005159 }
Andy Whitcroft13214ad2008-02-08 04:22:03 -08005160 }
Andy Whitcroft773647a2008-03-28 14:15:58 -07005161
Joe Perches62ec8182015-02-13 14:38:18 -08005162# check for uses of __DATE__, __TIME__, __TIMESTAMP__
5163 while ($line =~ /\b(__(?:DATE|TIME|TIMESTAMP)__)\b/g) {
5164 ERROR("DATE_TIME",
5165 "Use of the '$1' macro makes the build non-deterministic\n" . $herecurr);
5166 }
5167
Joe Perches2c924882012-03-23 15:02:20 -07005168# check for use of yield()
5169 if ($line =~ /\byield\s*\(\s*\)/) {
5170 WARN("YIELD",
5171 "Using yield() is generally wrong. See yield() kernel-doc (sched/core.c)\n" . $herecurr);
5172 }
5173
Joe Perches179f8f42013-07-03 15:05:30 -07005174# check for comparisons against true and false
5175 if ($line =~ /\+\s*(.*?)\b(true|false|$Lval)\s*(==|\!=)\s*(true|false|$Lval)\b(.*)$/i) {
5176 my $lead = $1;
5177 my $arg = $2;
5178 my $test = $3;
5179 my $otype = $4;
5180 my $trail = $5;
5181 my $op = "!";
5182
5183 ($arg, $otype) = ($otype, $arg) if ($arg =~ /^(?:true|false)$/i);
5184
5185 my $type = lc($otype);
5186 if ($type =~ /^(?:true|false)$/) {
5187 if (("$test" eq "==" && "$type" eq "true") ||
5188 ("$test" eq "!=" && "$type" eq "false")) {
5189 $op = "";
5190 }
5191
5192 CHK("BOOL_COMPARISON",
5193 "Using comparison to $otype is error prone\n" . $herecurr);
5194
5195## maybe suggesting a correct construct would better
5196## "Using comparison to $otype is error prone. Perhaps use '${lead}${op}${arg}${trail}'\n" . $herecurr);
5197
5198 }
5199 }
5200
Thomas Gleixner4882720b2010-09-07 14:34:01 +00005201# check for semaphores initialized locked
5202 if ($line =~ /^.\s*sema_init.+,\W?0\W?\)/) {
Joe Perches000d1cc12011-07-25 17:13:25 -07005203 WARN("CONSIDER_COMPLETION",
5204 "consider using a completion\n" . $herecurr);
Andy Whitcroft773647a2008-03-28 14:15:58 -07005205 }
Joe Perches6712d852012-03-23 15:02:20 -07005206
Joe Perches67d0a072011-10-31 17:13:10 -07005207# recommend kstrto* over simple_strto* and strict_strto*
5208 if ($line =~ /\b((simple|strict)_(strto(l|ll|ul|ull)))\s*\(/) {
Joe Perches000d1cc12011-07-25 17:13:25 -07005209 WARN("CONSIDER_KSTRTO",
Joe Perches67d0a072011-10-31 17:13:10 -07005210 "$1 is obsolete, use k$3 instead\n" . $herecurr);
Andy Whitcroft773647a2008-03-28 14:15:58 -07005211 }
Joe Perches6712d852012-03-23 15:02:20 -07005212
Fabian Frederickae3ccc42014-06-04 16:12:10 -07005213# check for __initcall(), use device_initcall() explicitly or more appropriate function please
Michael Ellermanf3db6632008-07-23 21:28:57 -07005214 if ($line =~ /^.\s*__initcall\s*\(/) {
Joe Perches000d1cc12011-07-25 17:13:25 -07005215 WARN("USE_DEVICE_INITCALL",
Fabian Frederickae3ccc42014-06-04 16:12:10 -07005216 "please use device_initcall() or more appropriate function instead of __initcall() (see include/linux/init.h)\n" . $herecurr);
Michael Ellermanf3db6632008-07-23 21:28:57 -07005217 }
Joe Perches6712d852012-03-23 15:02:20 -07005218
Emese Revfy79404842010-03-05 13:43:53 -08005219# check for various ops structs, ensure they are const.
5220 my $struct_ops = qr{acpi_dock_ops|
5221 address_space_operations|
5222 backlight_ops|
5223 block_device_operations|
5224 dentry_operations|
5225 dev_pm_ops|
5226 dma_map_ops|
5227 extent_io_ops|
5228 file_lock_operations|
5229 file_operations|
5230 hv_ops|
5231 ide_dma_ops|
5232 intel_dvo_dev_ops|
5233 item_operations|
5234 iwl_ops|
5235 kgdb_arch|
5236 kgdb_io|
5237 kset_uevent_ops|
5238 lock_manager_operations|
5239 microcode_ops|
5240 mtrr_ops|
5241 neigh_ops|
5242 nlmsvc_binding|
5243 pci_raw_ops|
5244 pipe_buf_operations|
5245 platform_hibernation_ops|
5246 platform_suspend_ops|
5247 proto_ops|
5248 rpc_pipe_ops|
5249 seq_operations|
5250 snd_ac97_build_ops|
5251 soc_pcmcia_socket_ops|
5252 stacktrace_ops|
5253 sysfs_ops|
5254 tty_operations|
5255 usb_mon_operations|
5256 wd_ops}x;
Andy Whitcroft6903ffb2009-01-15 13:51:07 -08005257 if ($line !~ /\bconst\b/ &&
Emese Revfy79404842010-03-05 13:43:53 -08005258 $line =~ /\bstruct\s+($struct_ops)\b/) {
Joe Perches000d1cc12011-07-25 17:13:25 -07005259 WARN("CONST_STRUCT",
5260 "struct $1 should normally be const\n" .
Andy Whitcroft6903ffb2009-01-15 13:51:07 -08005261 $herecurr);
Andy Whitcroft2b6db5c2009-01-06 14:41:29 -08005262 }
Andy Whitcroft773647a2008-03-28 14:15:58 -07005263
5264# use of NR_CPUS is usually wrong
5265# ignore definitions of NR_CPUS and usage to define arrays as likely right
5266 if ($line =~ /\bNR_CPUS\b/ &&
Andy Whitcroftc45dcab2008-06-05 22:46:01 -07005267 $line !~ /^.\s*\s*#\s*if\b.*\bNR_CPUS\b/ &&
5268 $line !~ /^.\s*\s*#\s*define\b.*\bNR_CPUS\b/ &&
Andy Whitcroft171ae1a2008-04-29 00:59:32 -07005269 $line !~ /^.\s*$Declare\s.*\[[^\]]*NR_CPUS[^\]]*\]/ &&
5270 $line !~ /\[[^\]]*\.\.\.[^\]]*NR_CPUS[^\]]*\]/ &&
5271 $line !~ /\[[^\]]*NR_CPUS[^\]]*\.\.\.[^\]]*\]/)
Andy Whitcroft773647a2008-03-28 14:15:58 -07005272 {
Joe Perches000d1cc12011-07-25 17:13:25 -07005273 WARN("NR_CPUS",
5274 "usage of NR_CPUS is often wrong - consider using cpu_possible(), num_possible_cpus(), for_each_possible_cpu(), etc\n" . $herecurr);
Andy Whitcroft773647a2008-03-28 14:15:58 -07005275 }
Andy Whitcroft9c9ba342008-04-29 00:59:33 -07005276
Joe Perches52ea8502013-11-12 15:10:09 -08005277# Use of __ARCH_HAS_<FOO> or ARCH_HAVE_<BAR> is wrong.
5278 if ($line =~ /\+\s*#\s*define\s+((?:__)?ARCH_(?:HAS|HAVE)\w*)\b/) {
5279 ERROR("DEFINE_ARCH_HAS",
5280 "#define of '$1' is wrong - use Kconfig variables or standard guards instead\n" . $herecurr);
5281 }
5282
Joe Perchesacd93622015-02-13 14:38:38 -08005283# likely/unlikely comparisons similar to "(likely(foo) > 0)"
5284 if ($^V && $^V ge 5.10.0 &&
5285 $line =~ /\b((?:un)?likely)\s*\(\s*$FuncArg\s*\)\s*$Compare/) {
5286 WARN("LIKELY_MISUSE",
5287 "Using $1 should generally have parentheses around the comparison\n" . $herecurr);
5288 }
5289
Andy Whitcroft691d77b2009-01-06 14:41:16 -08005290# whine mightly about in_atomic
5291 if ($line =~ /\bin_atomic\s*\(/) {
5292 if ($realfile =~ m@^drivers/@) {
Joe Perches000d1cc12011-07-25 17:13:25 -07005293 ERROR("IN_ATOMIC",
5294 "do not use in_atomic in drivers\n" . $herecurr);
Andy Whitcroftf4a87732009-02-27 14:03:05 -08005295 } elsif ($realfile !~ m@^kernel/@) {
Joe Perches000d1cc12011-07-25 17:13:25 -07005296 WARN("IN_ATOMIC",
5297 "use of in_atomic() is incorrect outside core kernel code\n" . $herecurr);
Andy Whitcroft691d77b2009-01-06 14:41:16 -08005298 }
5299 }
Peter Zijlstra1704f472010-03-19 01:37:42 +01005300
5301# check for lockdep_set_novalidate_class
5302 if ($line =~ /^.\s*lockdep_set_novalidate_class\s*\(/ ||
5303 $line =~ /__lockdep_no_validate__\s*\)/ ) {
5304 if ($realfile !~ m@^kernel/lockdep@ &&
5305 $realfile !~ m@^include/linux/lockdep@ &&
5306 $realfile !~ m@^drivers/base/core@) {
Joe Perches000d1cc12011-07-25 17:13:25 -07005307 ERROR("LOCKDEP",
5308 "lockdep_no_validate class is reserved for device->mutex.\n" . $herecurr);
Peter Zijlstra1704f472010-03-19 01:37:42 +01005309 }
5310 }
Dave Jones88f88312011-01-12 16:59:59 -08005311
5312 if ($line =~ /debugfs_create_file.*S_IWUGO/ ||
5313 $line =~ /DEVICE_ATTR.*S_IWUGO/ ) {
Joe Perches000d1cc12011-07-25 17:13:25 -07005314 WARN("EXPORTED_WORLD_WRITABLE",
5315 "Exporting world writable files is usually an error. Consider more restrictive permissions.\n" . $herecurr);
Dave Jones88f88312011-01-12 16:59:59 -08005316 }
Joe Perches24358802014-04-03 14:49:13 -07005317
Joe Perches515a2352014-04-03 14:49:24 -07005318# Mode permission misuses where it seems decimal should be octal
5319# This uses a shortcut match to avoid unnecessary uses of a slow foreach loop
5320 if ($^V && $^V ge 5.10.0 &&
5321 $line =~ /$mode_perms_search/) {
5322 foreach my $entry (@mode_permission_funcs) {
5323 my $func = $entry->[0];
5324 my $arg_pos = $entry->[1];
Joe Perches24358802014-04-03 14:49:13 -07005325
Joe Perches515a2352014-04-03 14:49:24 -07005326 my $skip_args = "";
5327 if ($arg_pos > 1) {
5328 $arg_pos--;
5329 $skip_args = "(?:\\s*$FuncArg\\s*,\\s*){$arg_pos,$arg_pos}";
5330 }
5331 my $test = "\\b$func\\s*\\(${skip_args}([\\d]+)\\s*[,\\)]";
5332 if ($line =~ /$test/) {
5333 my $val = $1;
5334 $val = $6 if ($skip_args ne "");
Joe Perches24358802014-04-03 14:49:13 -07005335
Joe Perches515a2352014-04-03 14:49:24 -07005336 if ($val !~ /^0$/ &&
5337 (($val =~ /^$Int$/ && $val !~ /^$Octal$/) ||
5338 length($val) ne 4)) {
5339 ERROR("NON_OCTAL_PERMISSIONS",
5340 "Use 4 digit octal (0777) not decimal permissions\n" . $herecurr);
Joe Perchesc0a5c892015-02-13 14:38:21 -08005341 } elsif ($val =~ /^$Octal$/ && (oct($val) & 02)) {
5342 ERROR("EXPORTED_WORLD_WRITABLE",
5343 "Exporting writable files is usually an error. Consider more restrictive permissions.\n" . $herecurr);
Joe Perches515a2352014-04-03 14:49:24 -07005344 }
Joe Perches24358802014-04-03 14:49:13 -07005345 }
5346 }
5347 }
Andy Whitcroft13214ad2008-02-08 04:22:03 -08005348 }
5349
5350 # If we have no input at all, then there is nothing to report on
5351 # so just keep quiet.
5352 if ($#rawlines == -1) {
5353 exit(0);
Andy Whitcroft0a920b5b2007-06-01 00:46:48 -07005354 }
5355
Andy Whitcroft8905a672007-11-28 16:21:06 -08005356 # In mailback mode only produce a report in the negative, for
5357 # things that appear to be patches.
5358 if ($mailback && ($clean == 1 || !$is_patch)) {
5359 exit(0);
5360 }
5361
5362 # This is not a patch, and we are are in 'no-patch' mode so
5363 # just keep quiet.
5364 if (!$chk_patch && !$is_patch) {
5365 exit(0);
5366 }
5367
5368 if (!$is_patch) {
Joe Perches000d1cc12011-07-25 17:13:25 -07005369 ERROR("NOT_UNIFIED_DIFF",
5370 "Does not appear to be a unified-diff format patch\n");
Andy Whitcroft0a920b5b2007-06-01 00:46:48 -07005371 }
5372 if ($is_patch && $chk_signoff && $signoff == 0) {
Joe Perches000d1cc12011-07-25 17:13:25 -07005373 ERROR("MISSING_SIGN_OFF",
5374 "Missing Signed-off-by: line(s)\n");
Andy Whitcroft0a920b5b2007-06-01 00:46:48 -07005375 }
5376
Andy Whitcroft8905a672007-11-28 16:21:06 -08005377 print report_dump();
Andy Whitcroft13214ad2008-02-08 04:22:03 -08005378 if ($summary && !($clean == 1 && $quiet == 1)) {
5379 print "$filename " if ($summary_file);
Andy Whitcroft8905a672007-11-28 16:21:06 -08005380 print "total: $cnt_error errors, $cnt_warn warnings, " .
5381 (($check)? "$cnt_chk checks, " : "") .
5382 "$cnt_lines lines checked\n";
5383 print "\n" if ($quiet == 0);
Andy Whitcroftf0a594c2007-07-19 01:48:34 -07005384 }
Andy Whitcroft8905a672007-11-28 16:21:06 -08005385
Andy Whitcroftd2c0a232010-10-26 14:23:12 -07005386 if ($quiet == 0) {
Joe Perchesd1fe9c02012-03-23 15:02:16 -07005387
5388 if ($^V lt 5.10.0) {
5389 print("NOTE: perl $^V is not modern enough to detect all possible issues.\n");
5390 print("An upgrade to at least perl v5.10.0 is suggested.\n\n");
5391 }
5392
Andy Whitcroftd2c0a232010-10-26 14:23:12 -07005393 # If there were whitespace errors which cleanpatch can fix
5394 # then suggest that.
5395 if ($rpt_cleaners) {
5396 print "NOTE: whitespace errors detected, you may wish to use scripts/cleanpatch or\n";
5397 print " scripts/cleanfile\n\n";
Mike Frysingerb0781212011-03-22 16:34:43 -07005398 $rpt_cleaners = 0;
Andy Whitcroftd2c0a232010-10-26 14:23:12 -07005399 }
5400 }
5401
Joe Perches91bfe482013-09-11 14:23:59 -07005402 hash_show_words(\%use_type, "Used");
5403 hash_show_words(\%ignore_type, "Ignored");
Joe Perches000d1cc12011-07-25 17:13:25 -07005404
Joe Perchesd752fcc2014-08-06 16:11:05 -07005405 if ($clean == 0 && $fix &&
5406 ("@rawlines" ne "@fixed" ||
5407 $#fixed_inserted >= 0 || $#fixed_deleted >= 0)) {
Joe Perches9624b8d2014-01-23 15:54:44 -08005408 my $newfile = $filename;
5409 $newfile .= ".EXPERIMENTAL-checkpatch-fixes" if (!$fix_inplace);
Joe Perches3705ce52013-07-03 15:05:31 -07005410 my $linecount = 0;
5411 my $f;
5412
Joe Perchesd752fcc2014-08-06 16:11:05 -07005413 @fixed = fix_inserted_deleted_lines(\@fixed, \@fixed_inserted, \@fixed_deleted);
5414
Joe Perches3705ce52013-07-03 15:05:31 -07005415 open($f, '>', $newfile)
5416 or die "$P: Can't open $newfile for write\n";
5417 foreach my $fixed_line (@fixed) {
5418 $linecount++;
5419 if ($file) {
5420 if ($linecount > 3) {
5421 $fixed_line =~ s/^\+//;
Joe Perchesd752fcc2014-08-06 16:11:05 -07005422 print $f $fixed_line . "\n";
Joe Perches3705ce52013-07-03 15:05:31 -07005423 }
5424 } else {
5425 print $f $fixed_line . "\n";
5426 }
5427 }
5428 close($f);
5429
5430 if (!$quiet) {
5431 print << "EOM";
5432Wrote EXPERIMENTAL --fix correction(s) to '$newfile'
5433
5434Do _NOT_ trust the results written to this file.
5435Do _NOT_ submit these changes without inspecting them for correctness.
5436
5437This EXPERIMENTAL file is simply a convenience to help rewrite patches.
5438No warranties, expressed or implied...
5439
5440EOM
5441 }
5442 }
5443
Andy Whitcroft0a920b5b2007-06-01 00:46:48 -07005444 if ($clean == 1 && $quiet == 0) {
Andy Whitcroftc2fdda02008-02-08 04:20:54 -08005445 print "$vname has no obvious style problems and is ready for submission.\n"
Andy Whitcroft0a920b5b2007-06-01 00:46:48 -07005446 }
5447 if ($clean == 0 && $quiet == 0) {
Joe Perches000d1cc12011-07-25 17:13:25 -07005448 print << "EOM";
5449$vname has style problems, please review.
5450
5451If any of these errors are false positives, please report
5452them to the maintainer, see CHECKPATCH in MAINTAINERS.
5453EOM
Andy Whitcroft0a920b5b2007-06-01 00:46:48 -07005454 }
Andy Whitcroft13214ad2008-02-08 04:22:03 -08005455
Andy Whitcroft0a920b5b2007-06-01 00:46:48 -07005456 return $clean;
5457}