Re: [PATCH net-next v2] netdevice: define and allocate &net_device _properly_

From: Kees Cook
Date: Tue Jul 09 2024 - 16:37:33 EST


On Tue, Jul 09, 2024 at 01:19:44PM -0700, Breno Leitao wrote:
> On Tue, Jul 09, 2024 at 07:11:28PM +0100, Simon Horman wrote:
> > Flagged by: kernel-doc -none
>
> How do you run this test exactly? I would like to add to my workflow.

Details here:
https://docs.kernel.org/doc-guide/kernel-doc.html

But basically, either:

$ ./scripts/kernel-doc -none include/linux/netdevice.h
include/linux/netdevice.h:2404: warning: ...

or:

$ make ... W=n
...
../drivers/firewire/init_ohci1394_dma.c:178: warning: Function parameter or struct member 'ohci' not described in 'init_ohci1394_wait_for_busresets'
...

--
Kees Cook