linux-kernel - Re: [PATCH v2] PM: sleep: wakeirq: Update outdated documentation comments

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: <CAJZ5v0gjViMyma4X6sWszq4euQ3=R2fE3gvzqJFDshbrnF9tGQ@mail.gmail.com>
Date: Wed, 11 Feb 2026 21:14:07 +0100
From: "Rafael J. Wysocki" <rafael@...nel.org>
To: Wang Jiayue <akaieurus@...il.com>
Cc: rafael@...nel.org, lenb@...nel.org, pavel@...nel.org, 
	gregkh@...uxfoundation.org, dakr@...nel.org, linux-pm@...r.kernel.org, 
	linux-kernel@...r.kernel.org, Gui-Dong Han <hanguidong02@...il.com>
Subject: Re: [PATCH v2] PM: sleep: wakeirq: Update outdated documentation comments

On Fri, Feb 6, 2026 at 10:23 AM Wang Jiayue <akaieurus@...il.com> wrote:
>
> The comments claiming that dev_pm_*wake_irq*() helpers must be called
> with dev->power.lock held and only from rpm_suspend/resume paths are no
> longer correct, since pm_runtime_force_suspend/resume() call them
> lockless. Update the comments to reflect it.
>
> Reported-by: Gui-Dong Han <hanguidong02@...il.com>
> Closes: https://lore.kernel.org/all/CAJZ5v0jN9fU9NdWqc-+F5hiSEP4JkR=_qcdGzzHtk1i5tvCDbQ@mail.gmail.com/
> Fixes: c46a0d5ae4f9 ("PM: runtime: Extend support for wakeirq for force_suspend|resume")
> Signed-off-by: Wang Jiayue <akaieurus@...il.com>
> ---
> v2:
> * Rephrase the comments to also cover the
>   pm_runtime_force_suspend/resume() case, as suggested by Rafael J. Wysocki
> v1:
> * Initial fix just remove outdated comments
> ---
>  drivers/base/power/wakeirq.c | 11 +++++++----
>  1 file changed, 7 insertions(+), 4 deletions(-)
>
> diff --git a/drivers/base/power/wakeirq.c b/drivers/base/power/wakeirq.c
> index 8aa28c08b289..f5db37c4818e 100644
> --- a/drivers/base/power/wakeirq.c
> +++ b/drivers/base/power/wakeirq.c
> @@ -270,8 +270,10 @@ EXPORT_SYMBOL_GPL(dev_pm_set_dedicated_wake_irq_reverse);
>   * otherwise try to disable already disabled wakeirq. The wake-up interrupt
>   * starts disabled with IRQ_NOAUTOEN set.
>   *
> - * Should be only called from rpm_suspend() and rpm_resume() path.
> - * Caller must hold &dev->power.lock to change wirq->status
> + * Should be called from rpm_suspend(), rpm_resume(),
> + * pm_runtime_force_suspend() or pm_runtime_force_resume().
> + * Caller must hold &dev->power.lock or disable runtime PM to change
> + * wirq->status.
>   */
>  void dev_pm_enable_wake_irq_check(struct device *dev,
>                                   bool can_change_status)
> @@ -303,7 +305,8 @@ void dev_pm_enable_wake_irq_check(struct device *dev,
>   * @cond_disable: if set, also check WAKE_IRQ_DEDICATED_REVERSE
>   *
>   * Disables wake-up interrupt conditionally based on status.
> - * Should be only called from rpm_suspend() and rpm_resume() path.
> + * Should be called from rpm_suspend(), rpm_resume(),
> + * pm_runtime_force_suspend() or pm_runtime_force_resume().
>   */
>  void dev_pm_disable_wake_irq_check(struct device *dev, bool cond_disable)
>  {
> @@ -329,7 +332,7 @@ void dev_pm_disable_wake_irq_check(struct device *dev, bool cond_disable)
>   * enable wake IRQ after running ->runtime_suspend() which depends on
>   * WAKE_IRQ_DEDICATED_REVERSE.
>   *
> - * Should be only called from rpm_suspend() path.
> + * Should be called from rpm_suspend() or pm_runtime_force_suspend().
>   */
>  void dev_pm_enable_wake_irq_complete(struct device *dev)
>  {
> --

Applied as 7.0-rc material, thanks!