linux-kernel - Re: linux-next: build warnings after merge of the rcu 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: <20201126172803.GA16234@pc636>
Date:   Thu, 26 Nov 2020 18:28:03 +0100
From:   Uladzislau Rezki <urezki@...il.com>
To:     "Paul E. McKenney" <paulmck@...nel.org>,
        Stephen Rothwell <sfr@...b.auug.org.au>
Cc:     Stephen Rothwell <sfr@...b.auug.org.au>,
        "Uladzislau Rezki (Sony)" <urezki@...il.com>,
        Linux Kernel Mailing List <linux-kernel@...r.kernel.org>,
        Linux Next Mailing List <linux-next@...r.kernel.org>
Subject: Re: linux-next: build warnings after merge of the rcu tree

> On Thu, Nov 26, 2020 at 05:44:28PM +1100, Stephen Rothwell wrote:
> > Hi all,
> > 
> > After merging the rcu tree, today's linux-next build (htmldocs) produced
> > these warnings:
> > 
> > include/linux/rcupdate.h:872: warning: Excess function parameter 'ptr' description in 'kfree_rcu'
> > include/linux/rcupdate.h:872: warning: Excess function parameter 'rhf' description in 'kfree_rcu'
> > 
> > Introduced by commit
> > 
> >   beba8bdf2f16 ("rcu: Introduce kfree_rcu() single-argument macro")
> 
> Heh!  The documentation isn't dealing at all well with this situation.
> 
> Would one of the docbook experts have some advice, keeping in mind
> that kfree_rcu might have either one or two arguments?
> 
Indeed. The question is if the docbook is capable of describing such
macro usage, 1 or 2 args.

--
Vlad Rezki