linux-kernel - [PATCH] scripts/checkpatch.pl: Improve guidance for LONG

lists.openwall.net		lists / announce owl-users owl-dev john-users john-dev passwdqc-users yescrypt popa3d-users / oss-security kernel-hardening musl sabotage tlsify passwords / crypt-dev xvendor / Bugtraq Full-Disclosure linux-kernel linux-netdev linux-ext4 linux-hardening linux-cve-announce PHC
Open Source and information security mailing list archives

Hash Suite: Windows password security audit tool. GUI, reports in PDF.

[<prev] [next>] [thread-next>] [day] [month] [year] [list]

Message-ID: <20140626060136.GA2528@thin>
Date:	Wed, 25 Jun 2014 23:01:42 -0700
From:	Josh Triplett <josh@...htriplett.org>
To:	Joe Perches <joe@...ches.com>, Andy Whitcroft <apw@...onical.com>,
	gregkh@...ux-foundation.org, akpm@...ux-foundation.org
Cc:	linux-kernel@...r.kernel.org
Subject: [PATCH] scripts/checkpatch.pl: Improve guidance for LONG_LINE

Currently, LONG_LINE just informs the user about the line length,
leaving them to shorten the line.  Too many users run checkpatch and
blindly follow its recommendation by splitting long lines, which almost
invariably results in worse code.  On rare occasions, the line-width
limit encourages sensible refactoring of nested code into functions, but
more frequently it just results in painfully over-wrapped code.

Improve the guidance by detecting long lines that start with 4+ tabs and
explicitly suggesting simplification or refactoring in that case.

This does not introduce or remove any warnings; it just changes the text
of a warning that checkpatch would already emit, to emphasize a
preference for simplifying or refactoring complex, deeply nested code,
rather than just wrapping it but leaving it complex.

Signed-off-by: Josh Triplett <josh@...htriplett.org>
---

Of the ~267000 80+ character lines in the current kernel source, this
new guidance would trigger on ~67000 of them.

Other things I tested, but did not include in this patch, to minimize
controversy or subjectivity: flagging long lines with 2 or more logical
operations (&& or ||) to suggest wrapping at the operators, and flagging
long lines with 30+ character identifiers to suggest consideration of
whether the identifier could remain self-documenting if shortened.

 scripts/checkpatch.pl | 12 ++++++++++--
 1 file changed, 10 insertions(+), 2 deletions(-)

diff --git a/scripts/checkpatch.pl b/scripts/checkpatch.pl
index 010b18e..6e82f19 100755
--- a/scripts/checkpatch.pl
+++ b/scripts/checkpatch.pl
@@ -2146,8 +2146,16 @@ sub process {
 		    $line =~ /^\+\s*"[^"]*"\s*(?:\s*|,|\)\s*;)\s*$/) &&
 		    $length > $max_line_length)
 		{
-			WARN("LONG_LINE",
-			     "line over $max_line_length characters\n" . $herecurr);
+			if ($line =~ /^\+\t{4,}/) {
+				WARN("LONG_LINE_DEEP_NESTING",
+				     "line over $max_line_length characters with excessive nesting (4+ tabs)\n"
+				     . "Consider simplifying or refactoring to eliminate excessive nesting.\n"
+				     . $herecurr);
+			} else {
+				WARN("LONG_LINE",
+				     "line over $max_line_length characters\n"
+				     . $herecurr);
+			}
 		}

 # Check for user-visible strings broken across lines, which breaks the ability
-- 
2.0.0

--
To unsubscribe from this list: send the line "unsubscribe linux-kernel" in
the body of a message to majordomo@...r.kernel.org
More majordomo info at  http://vger.kernel.org/majordomo-info.html
Please read the FAQ at  http://www.tux.org/lkml/