Re: [PATCH] hrtimer: Add kernel doc for hrtimer_cpu_base::csd
From: Paul E. McKenney
Date: Wed Jul 08 2026 - 14:09:15 EST
On Fri, Jun 26, 2026 at 02:47:41PM +0200, Thomas Weißschuh wrote:
> Kernel-doc complains that the structure member is not documented:
>
> Warning: include/linux/hrtimer_defs.h:109 struct member 'csd' not described in 'hrtimer_cpu_base'
>
> Add the missing documentation.
>
> Fixes: 53dac345395c ("hrtimers: Force migrate away hrtimers queued after CPUHP_AP_HRTIMERS_DYING")
> Signed-off-by: Thomas Weißschuh <thomas.weissschuh@xxxxxxxxxxxxx>
Reviewed-by: Paul E. McKenney <paulmck@xxxxxxxxxx>
> ---
> include/linux/hrtimer_defs.h | 1 +
> 1 file changed, 1 insertion(+)
>
> diff --git a/include/linux/hrtimer_defs.h b/include/linux/hrtimer_defs.h
> index 52ed9e46ff13..27703aa2749c 100644
> --- a/include/linux/hrtimer_defs.h
> +++ b/include/linux/hrtimer_defs.h
> @@ -74,6 +74,7 @@ enum hrtimer_base_type {
> * @softirq_next_timer: Pointer to the first expiring softirq based timer
> * @deferred_expires_next: Cached expires next value for deferred rearm
> * @clock_base: Array of clock bases for this cpu
> + * @csd: Remotely call retrigger_next_event() on this base's cpu
> *
> * Note: next_timer is just an optimization for __remove_hrtimer().
> * Do not dereference the pointer because it is not reliable on
>
> ---
> base-commit: 4edcdefd4083ae04b1a5656f4be6cd83ae919ef4
> change-id: 20260626-hrtimer-kdoc-csd-86d6eeb20e44
>
> Best regards,
> --
> Thomas Weißschuh <thomas.weissschuh@xxxxxxxxxxxxx>
>