workqueue: Introduce from_work() helper for cleaner callback declarations
authorAllen Pais <apais@linux.microsoft.com>
Tue, 27 Feb 2024 19:10:37 +0000 (19:10 +0000)
committerTejun Heo <tj@kernel.org>
Tue, 27 Feb 2024 19:38:26 +0000 (09:38 -1000)
commit60b2ebf48526567b53e0188dbd1a4df8e646bcc1
tree3a2ab1d6fa6c0465bfd5b7d26a850641559f59b0
parentccdec92198df0c91f45a68f971771b6b0c1ba02d
workqueue: Introduce from_work() helper for cleaner callback declarations

To streamline the transition from tasklets to worqueues, a new helper
function, from_work(), is introduced. This helper, inspired by existing
from_() patterns, utilizes container_of() and eliminates the redundancy
of declaring variable types, leading to more concise and readable code.

The modified code snippet demonstrates the enhanced clarity achieved
with from_wq():

  void callback(struct work_struct *w)
   {
     - struct some_data_structure *local = container_of(w,
       struct some_data_structure,
       work);
     + struct some_data_structure *local = from_work(local, w, work);

This change aims to facilitate a smoother transition and uphold code
quality standards.

Based on:
  git://git.kernel.org/pub/scm/linux/kernel/git/tj/wq.git disable_work-v3

Signed-off-by: Allen Pais <allen.lkml@gmail.com>
Signed-off-by: Tejun Heo <tj@kernel.org>
include/linux/workqueue.h