linux-kernel - Re: linux-next: build warning after merge of the iio tree

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-prev] [day] [month] [year] [list]

Message-ID: <20241107122500.00004628@Huawei.com>
Date: Thu, 7 Nov 2024 12:25:00 +0000
From: Jonathan Cameron <Jonathan.Cameron@...wei.com>
To: Stephen Rothwell <sfr@...b.auug.org.au>
CC: Andy Shevchenko <andriy.shevchenko@...ux.intel.com>, Jonathan Corbet
	<corbet@....net>, Linux Kernel Mailing List <linux-kernel@...r.kernel.org>,
	Linux Next Mailing List <linux-next@...r.kernel.org>
Subject: Re: linux-next: build warning after merge of the iio tree

On Thu, 7 Nov 2024 22:40:12 +1100
Stephen Rothwell <sfr@...b.auug.org.au> wrote:

> Hi all,
> 
> After merging the iio tree, today's linux-next build (htmldocs) produced
> this warning:
> 
> include/linux/iio/iio.h:628: warning: Function parameter or struct member '__private' not described in 'iio_dev'
> include/linux/iio/iio.h:628: warning: Excess struct member 'priv' description in 'iio_dev'
> 
> Introduced by commit
> 
>   9a5a2483bc60 ("iio: Mark iio_dev::priv member with __private")
> 

I guess we need to teach the kernel-doc script about __private.
May be just a case of doing the same as done for __aligned, __packed etc.

Also curious why I've not seen warnings in the past about the masklength field
in the same structure.  I guess the test coverage has improved (or I missed
the reports!).

 So a 
   $members =~ s/\s*__private\s*\([^;]*\)/ /gos;

about here:
https://elixir.free-electrons.com/linux/v6.11.6/source/scripts/kernel-doc#L1148

Jon, does that make sense to you?  

Completely untested as I'm on wrong computer at the moment and my approach
to these scripts is cut and paste a similar smelling line until it works ;)

Jonathan