mirror of
https://git.kernel.org/pub/scm/linux/kernel/git/stable/linux.git
synced 2024-09-04 18:09:57 +00:00
![Matti Vaittinen](/assets/img/avatar_default.png)
The kerneldoc for devm_delayed_work_autocancel() contains invalid
parameter description.
Fix the parameter description. And while at it - make it more obvous that
this function operates on delayed_work. That helps differentiating with
resource-managed INIT_WORK description (which should follow in near future)
Fixes: 0341ce5443
("workqueue: Add resource managed version of delayed work init")
Reviewed-by: Hans de Goede <hdegoede@redhat.com>
Signed-off-by: Matti Vaittinen <matti.vaittinen@fi.rohmeurope.com>
Link: https://lore.kernel.org/r/db3a8b4b8899fdf109a0cc760807de12d3b4f09b.1619028482.git.matti.vaittinen@fi.rohmeurope.com
Signed-off-by: Greg Kroah-Hartman <gregkh@linuxfoundation.org>
54 lines
1.9 KiB
C
54 lines
1.9 KiB
C
/* SPDX-License-Identifier: GPL-2.0-only */
|
|
#ifndef __LINUX_DEVM_HELPERS_H
|
|
#define __LINUX_DEVM_HELPERS_H
|
|
|
|
/*
|
|
* Functions which do automatically cancel operations or release resources upon
|
|
* driver detach.
|
|
*
|
|
* These should be helpful to avoid mixing the manual and devm-based resource
|
|
* management which can be source of annoying, rarely occurring,
|
|
* hard-to-reproduce bugs.
|
|
*
|
|
* Please take into account that devm based cancellation may be performed some
|
|
* time after the remove() is ran.
|
|
*
|
|
* Thus mixing devm and manual resource management can easily cause problems
|
|
* when unwinding operations with dependencies. IRQ scheduling a work in a queue
|
|
* is typical example where IRQs are often devm-managed and WQs are manually
|
|
* cleaned at remove(). If IRQs are not manually freed at remove() (and this is
|
|
* often the case when we use devm for IRQs) we have a period of time after
|
|
* remove() - and before devm managed IRQs are freed - where new IRQ may fire
|
|
* and schedule a work item which won't be cancelled because remove() was
|
|
* already ran.
|
|
*/
|
|
|
|
#include <linux/device.h>
|
|
#include <linux/workqueue.h>
|
|
|
|
static inline void devm_delayed_work_drop(void *res)
|
|
{
|
|
cancel_delayed_work_sync(res);
|
|
}
|
|
|
|
/**
|
|
* devm_delayed_work_autocancel - Resource-managed delayed work allocation
|
|
* @dev: Device which lifetime work is bound to
|
|
* @w: Work item to be queued
|
|
* @worker: Worker function
|
|
*
|
|
* Initialize delayed work which is automatically cancelled when driver is
|
|
* detached. A few drivers need delayed work which must be cancelled before
|
|
* driver is detached to avoid accessing removed resources.
|
|
* devm_delayed_work_autocancel() can be used to omit the explicit
|
|
* cancelleation when driver is detached.
|
|
*/
|
|
static inline int devm_delayed_work_autocancel(struct device *dev,
|
|
struct delayed_work *w,
|
|
work_func_t worker)
|
|
{
|
|
INIT_DELAYED_WORK(w, worker);
|
|
return devm_add_action(dev, devm_delayed_work_drop, w);
|
|
}
|
|
|
|
#endif
|