linux-kernel - Re: [PATCH net v1 1/1] idpf: Fix kernel-doc descriptions to avoid warnings

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

Message-ID: <aSayDu8yVe7prrsx@smile.fi.intel.com>
Date: Wed, 26 Nov 2025 09:53:50 +0200
From: Andy Shevchenko <andriy.shevchenko@...ux.intel.com>
To: "Loktionov, Aleksandr" <aleksandr.loktionov@...el.com>
Cc: "Kitszel, Przemyslaw" <przemyslaw.kitszel@...el.com>,
	"Nguyen, Anthony L" <anthony.l.nguyen@...el.com>,
	"intel-wired-lan@...ts.osuosl.org" <intel-wired-lan@...ts.osuosl.org>,
	"netdev@...r.kernel.org" <netdev@...r.kernel.org>,
	Andrew Lunn <andrew+netdev@...n.ch>,
	"linux-kernel@...r.kernel.org" <linux-kernel@...r.kernel.org>,
	"David S. Miller" <davem@...emloft.net>,
	Eric Dumazet <edumazet@...gle.com>,
	Jakub Kicinski <kuba@...nel.org>, Paolo Abeni <pabeni@...hat.com>
Subject: Re: [PATCH net v1 1/1] idpf: Fix kernel-doc descriptions to avoid
 warnings

On Wed, Nov 26, 2025 at 07:24:40AM +0000, Loktionov, Aleksandr wrote:
> > -----Original Message-----
> > From: Kitszel, Przemyslaw <przemyslaw.kitszel@...el.com>
> > Sent: Wednesday, November 26, 2025 7:30 AM
> > On 11/24/25 18:42, Andy Shevchenko wrote:

...

> > >   /**
> > > - * idpf_tx_splitq_has_room - check if enough Tx splitq resources are
> > > available
> > > + * idpf_txq_has_room - check if enough Tx splitq resources are
> > > + available
> > >    * @tx_q: the queue to be checked
> > >    * @descs_needed: number of descriptors required for this packet
> > >    * @bufs_needed: number of Tx buffers required for this packet @@

> > > unsigned int idpf_tx_res_count_required(struct idpf_tx_queue *txq,

> > >    * idpf_tx_splitq_bump_ntu - adjust NTU and generation
> > >    * @txq: the tx ring to wrap
> > >    * @ntu: ring index to bump
> > > + *
> > > + * Return: the next ring index hopping to 0 when wraps around
> > >    */
> > >   static unsigned int idpf_tx_splitq_bump_ntu(struct idpf_tx_queue *txq, u16 ntu)
> Strange idpf_tx_splitq_bump_ntu() is not idpf_txq_has_room 
> Can you doublecheck?

I didn't get. What do you mean? Please elaborate.

-- 
With Best Regards,
Andy Shevchenko