Re: [PATCH] arch/x86/kernel/apic: Fix kernel-doc warning for spurious_interrupt()

[Borislav Petkov]

On Fri, May 22, 2026 at 09:46:10PM +0200, Alexander Lechthaler wrote:
> Add the missing @spurious_interrupt kernel-doc entry.
> 
> Signed-off-by: Alexander Lechthaler <alexander@lechthaler.online>
> ---
>  arch/x86/kernel/apic/apic.c | 3 +--
>  1 file changed, 1 insertion(+), 2 deletions(-)
> 
> diff --git a/arch/x86/kernel/apic/apic.c b/arch/x86/kernel/apic/apic.c
> index 639904911444..114089c39a17 100644
> --- a/arch/x86/kernel/apic/apic.c
> +++ b/arch/x86/kernel/apic/apic.c
> @@ -2145,8 +2145,7 @@ static noinline void handle_spurious_interrupt(u8 vector)
>  
>  /**
>   * spurious_interrupt - Catch all for interrupts raised on unused vectors
> - * @regs:	Pointer to pt_regs on stack
> - * @vector:	The vector number
> + * @spurious_interrupt: Interrupt entry point
>   *
>   * This is invoked from ASM entry code to catch all interrupts which
>   * trigger on an entry which is routed to the common_spurious idtentry
> -- 

You go and find the definition of DEFINE_IDTENTRY_IRQ:

#define DEFINE_IDTENTRY_IRQ(func)                                       \
static void __##func(struct pt_regs *regs, u32 vector);                 \

and you see that it takes as a single argument a function which has two
parameters: regs and vector. This is what the kernel doc comment above
documents. Not the @func parameter to the macro.

HTH.

-- 
Regards/Gruss,
    Boris.

https://people.kernel.org/tglx/notes-about-netiquette