xfs_pwork.c (3237B)
1// SPDX-License-Identifier: GPL-2.0-or-later 2/* 3 * Copyright (C) 2019 Oracle. All Rights Reserved. 4 * Author: Darrick J. Wong <darrick.wong@oracle.com> 5 */ 6#include "xfs.h" 7#include "xfs_fs.h" 8#include "xfs_shared.h" 9#include "xfs_format.h" 10#include "xfs_log_format.h" 11#include "xfs_trans_resv.h" 12#include "xfs_mount.h" 13#include "xfs_trace.h" 14#include "xfs_sysctl.h" 15#include "xfs_pwork.h" 16#include <linux/nmi.h> 17 18/* 19 * Parallel Work Queue 20 * =================== 21 * 22 * Abstract away the details of running a large and "obviously" parallelizable 23 * task across multiple CPUs. Callers initialize the pwork control object with 24 * a desired level of parallelization and a work function. Next, they embed 25 * struct xfs_pwork in whatever structure they use to pass work context to a 26 * worker thread and queue that pwork. The work function will be passed the 27 * pwork item when it is run (from process context) and any returned error will 28 * be recorded in xfs_pwork_ctl.error. Work functions should check for errors 29 * and abort if necessary; the non-zeroness of xfs_pwork_ctl.error does not 30 * stop workqueue item processing. 31 * 32 * This is the rough equivalent of the xfsprogs workqueue code, though we can't 33 * reuse that name here. 34 */ 35 36/* Invoke our caller's function. */ 37static void 38xfs_pwork_work( 39 struct work_struct *work) 40{ 41 struct xfs_pwork *pwork; 42 struct xfs_pwork_ctl *pctl; 43 int error; 44 45 pwork = container_of(work, struct xfs_pwork, work); 46 pctl = pwork->pctl; 47 error = pctl->work_fn(pctl->mp, pwork); 48 if (error && !pctl->error) 49 pctl->error = error; 50 if (atomic_dec_and_test(&pctl->nr_work)) 51 wake_up(&pctl->poll_wait); 52} 53 54/* 55 * Set up control data for parallel work. @work_fn is the function that will 56 * be called. @tag will be written into the kernel threads. @nr_threads is 57 * the level of parallelism desired, or 0 for no limit. 58 */ 59int 60xfs_pwork_init( 61 struct xfs_mount *mp, 62 struct xfs_pwork_ctl *pctl, 63 xfs_pwork_work_fn work_fn, 64 const char *tag) 65{ 66 unsigned int nr_threads = 0; 67 68#ifdef DEBUG 69 if (xfs_globals.pwork_threads >= 0) 70 nr_threads = xfs_globals.pwork_threads; 71#endif 72 trace_xfs_pwork_init(mp, nr_threads, current->pid); 73 74 pctl->wq = alloc_workqueue("%s-%d", 75 WQ_UNBOUND | WQ_SYSFS | WQ_FREEZABLE, nr_threads, tag, 76 current->pid); 77 if (!pctl->wq) 78 return -ENOMEM; 79 pctl->work_fn = work_fn; 80 pctl->error = 0; 81 pctl->mp = mp; 82 atomic_set(&pctl->nr_work, 0); 83 init_waitqueue_head(&pctl->poll_wait); 84 85 return 0; 86} 87 88/* Queue some parallel work. */ 89void 90xfs_pwork_queue( 91 struct xfs_pwork_ctl *pctl, 92 struct xfs_pwork *pwork) 93{ 94 INIT_WORK(&pwork->work, xfs_pwork_work); 95 pwork->pctl = pctl; 96 atomic_inc(&pctl->nr_work); 97 queue_work(pctl->wq, &pwork->work); 98} 99 100/* Wait for the work to finish and tear down the control structure. */ 101int 102xfs_pwork_destroy( 103 struct xfs_pwork_ctl *pctl) 104{ 105 destroy_workqueue(pctl->wq); 106 pctl->wq = NULL; 107 return pctl->error; 108} 109 110/* 111 * Wait for the work to finish by polling completion status and touch the soft 112 * lockup watchdog. This is for callers such as mount which hold locks. 113 */ 114void 115xfs_pwork_poll( 116 struct xfs_pwork_ctl *pctl) 117{ 118 while (wait_event_timeout(pctl->poll_wait, 119 atomic_read(&pctl->nr_work) == 0, HZ) == 0) 120 touch_softlockup_watchdog(); 121}