From: Denis Efremov <efremov@linux.com>
To: Julia Lawall <julia.lawall@inria.fr>
Cc: "Gustavo A . R . Silva" <gustavoars@kernel.org>,
cocci@systeme.lip6.fr, Kees Cook <keescook@chromium.org>,
linux-kernel@vger.kernel.org
Subject: Re: [Cocci] [PATCH v2] coccinelle: misc: add flexible_array.cocci script
Date: Sun, 13 Sep 2020 09:15:04 +0300 [thread overview]
Message-ID: <c717ff19-73c3-2369-7b61-318b0a9662ab@linux.com> (raw)
In-Reply-To: <alpine.DEB.2.22.394.2009121642070.2362@hadrien>
Hi,
On 9/12/20 5:43 PM, Julia Lawall wrote:
>
>
> On Mon, 10 Aug 2020, Denis Efremov wrote:
>
>> Commit 68e4cd17e218 ("docs: deprecated.rst: Add zero-length and one-element
>> arrays") marks one-element and zero-length arrays as deprecated. Kernel
>> code should always use "flexible array members" instead.
>>
>> The script warns about one-element and zero-length arrays in structs.
>>
>> Cc: Kees Cook <keescook@chromium.org>
>> Cc: Gustavo A. R. Silva <gustavoars@kernel.org>
>> Signed-off-by: Denis Efremov <efremov@linux.com>
>> ---
>> Changes in v2:
>> - all uapi headers are now filtered-out. Unfortunately, coccinelle
>> doesn't provide structure names in Location.current_element.
>> For structures the field is always "something_else". Thus, there is
>> no easy way to create a list of existing structures in uapi headers
>> and suppress the warning only for them, but not for the newly added
>> uapi structures.
>> - The pattern doesn't require 2+ fields in a structure/union anymore.
>> Now it also checks single field structures/unions.
>> - The pattern simplified and now uses disjuction in array elements
>> (Thanks, Markus)
>> - Unions are removed from patch mode
>> - one-element arrays are removed from patch mode. Correct patch may
>> involve turning the array to a simple field instead of a flexible
>> array.
>>
>> On the current master branch, the rule generates:
>> - context: https://gist.github.com/evdenis/e2b4323491f9eff35376372df07f723c
>> - patch: https://gist.github.com/evdenis/46081da9d68ecefd07edc3769cebcf32
>>
>> scripts/coccinelle/misc/flexible_array.cocci | 88 ++++++++++++++++++++
>> 1 file changed, 88 insertions(+)
>> create mode 100644 scripts/coccinelle/misc/flexible_array.cocci
>>
>> diff --git a/scripts/coccinelle/misc/flexible_array.cocci b/scripts/coccinelle/misc/flexible_array.cocci
>> new file mode 100644
>> index 000000000000..bf6dcda1783e
>> --- /dev/null
>> +++ b/scripts/coccinelle/misc/flexible_array.cocci
>> @@ -0,0 +1,88 @@
>> +// SPDX-License-Identifier: GPL-2.0-only
>> +///
>> +/// Zero-length and one-element arrays are deprecated, see
>> +/// Documentation/process/deprecated.rst
>> +/// Flexible-array members should be used instead.
>> +///
>> +//
>> +// Confidence: High
>> +// Copyright: (C) 2020 Denis Efremov ISPRAS.
>> +// Comments:
>> +// Options: --no-includes --include-headers
>> +
>> +virtual context
>> +virtual report
>> +virtual org
>> +virtual patch
>> +
>> +@initialize:python@
>> +@@
>> +def relevant(positions):
>> + for p in positions:
>> + if "uapi" in p.file:
>> + return False
>> + return True
>> +
>> +@r depends on !patch@
>> +identifier name, array;
>> +type T;
>> +position p : script:python() { relevant(p) };
>> +@@
>> +
>> +(
>> + struct name {
>> + ...
>> +* T array@p[\(0\|1\)];
>> + };
>> +|
>> + struct {
>> + ...
>> +* T array@p[\(0\|1\)];
>> + };
>> +|
>> + union name {
>> + ...
>> +* T array@p[\(0\|1\)];
>> + };
>> +|
>> + union {
>> + ...
>> +* T array@p[\(0\|1\)];
>> + };
>> +)
>> +
>> +@depends on patch exists@
>
> exists is not necessary here. There are not multiple control-flow paths
> through a structure declaration.
>
>> +identifier name, array;
>> +type T;
>> +position p : script:python() { relevant(p) };
>> +@@
>> +
>> +(
>> + struct name {
>> + ...
>> + T array@p[
>> +- 0
>> + ];
>> + };
>> +|
>> + struct {
>> + ...
>> + T array@p[
>> +- 0
>> + ];
>> + };
>> +)
>> +
>> +@script: python depends on report@
>> +p << r.p;
>> +@@
>> +
>> +msg = "WARNING: use flexible-array member instead"
>> +coccilib.report.print_report(p[0], msg)
>> +
>> +@script: python depends on org@
>> +p << r.p;
>> +@@
>> +
>> +msg = "WARNING: use flexible-array member instead"
>> +coccilib.org.print_todo(p, msg)
>
> This should be coccilib.org.print_todo(p[0], msg)
>
Thanks, I will send v3 with fixes and proper links to online documentation.
Regards,
Denis
_______________________________________________
Cocci mailing list
Cocci@systeme.lip6.fr
https://systeme.lip6.fr/mailman/listinfo/cocci
next prev parent reply other threads:[~2020-09-13 6:15 UTC|newest]
Thread overview: 7+ messages / expand[flat|nested] mbox.gz Atom feed top
2020-08-06 22:03 [Cocci] [RFC PATCH] coccinelle: misc: add flexible_array.cocci script Denis Efremov
2020-08-07 16:18 ` Gustavo A. R. Silva
2020-08-09 21:26 ` [Cocci] [PATCH v2] " Denis Efremov
2020-09-12 14:43 ` Julia Lawall
2020-09-13 6:15 ` Denis Efremov [this message]
2020-09-21 17:49 ` [Cocci] [PATCH v3] " Denis Efremov
2020-10-03 20:09 ` Julia Lawall
Reply instructions:
You may reply publicly to this message via plain-text email
using any one of the following methods:
* Save the following mbox file, import it into your mail client,
and reply-to-all from there: mbox
Avoid top-posting and favor interleaved quoting:
https://en.wikipedia.org/wiki/Posting_style#Interleaved_style
* Reply using the --to, --cc, and --in-reply-to
switches of git-send-email(1):
git send-email \
--in-reply-to=c717ff19-73c3-2369-7b61-318b0a9662ab@linux.com \
--to=efremov@linux.com \
--cc=cocci@systeme.lip6.fr \
--cc=gustavoars@kernel.org \
--cc=julia.lawall@inria.fr \
--cc=keescook@chromium.org \
--cc=linux-kernel@vger.kernel.org \
/path/to/YOUR_REPLY
https://kernel.org/pub/software/scm/git/docs/git-send-email.html
* If your mail client supports setting the In-Reply-To header
via mailto: links, try the mailto: link
Be sure your reply has a Subject: header at the top and a blank line
before the message body.
This is a public inbox, see mirroring instructions
for how to clone and mirror all data and code used for this inbox;
as well as URLs for NNTP newsgroup(s).