drivers/powercap/idle_inject.c

7  * The idle injection framework provides a way to force CPUs to enter idle
13  * All of the kthreads used for idle injection are created at init time.
15  * Next, the users of the idle injection framework provide a cpumask via
20  * idle injection to be started.
22  * The idle injection kthreads will call play_idle_precise() with the idle
26  * injection cycle.
28  * The timer interrupt handler will wake up the idle injection kthreads for
31  * Idle injection is stopped synchronously and no leftover idle injection
35  * synchronization to prevent race conditions like starting idle injection
61  * struct idle_inject_device - idle injection data
62  * @timer: idle injection period timer
67  *		injection in the given cycle.
68  * @cpumask: mask of CPUs affected by idle injection
96  * idle_inject_wakeup - Wake up idle injection threads
97  * @ii_dev: target idle injection device
99  * Every idle injection task associated with the given idle injection device
115  * idle_inject_timer_fn - idle injection timer function
116  * @timer: idle injection hrtimer
118  * This function is called when the idle injection timer expires.  It wakes up
119  * idle injection tasks associated with the timer and they, in turn, invoke
142  * idle_inject_fn - idle injection work function
167  * @ii_dev: idle injection control device structure
186  * @ii_dev: idle injection control device structure
201  * @ii_dev: idle injection control device structure
213  * @ii_dev: idle injection control device structure
215  * The function starts idle injection by first waking up all of the idle
216  * injection kthreads associated with @ii_dev to let them inject CPU idle time
217  * sets up a timer to start the next idle injection period.
245  * @ii_dev: idle injection control device structure
247  * The function stops idle injection and waits for the threads to finish work.
251  * When it returns, there is no more idle injection kthread activity.  The
259 	pr_debug("Stopping idle injection on CPUs '%*pbl'\n",  in idle_inject_stop()
265 	 * Stopping idle injection requires all of the idle injection kthreads  in idle_inject_stop()
276 	 * injection kthread from running when the CPU goes online again after  in idle_inject_stop()
291  * idle_inject_setup - prepare the current task for idle injection
317  * idle_inject_register_full - initialize idle injection on a set of CPUs
318  * @cpumask: CPUs to be affected by idle injection
322  * This function creates an idle injection control device structure for the
325  * It does not start any injection cycles.
327  * Return: NULL if memory allocation fails, idle injection control device
373  * idle_inject_register - initialize idle injection on a set of CPUs
374  * @cpumask: CPUs to be affected by idle injection
376  * This function creates an idle injection control device structure for the
378  * start any injection cycles.
380  * Return: NULL if memory allocation fails, idle injection control device
390  * idle_inject_unregister - unregister idle injection control device
391  * @ii_dev: idle injection control device to unregister
393  * The function stops idle injection for the given control device,