1 // SPDX-License-Identifier: GPL-2.0 <<
2 /* 1 /*
3 * Scheduler code and data structures related 2 * Scheduler code and data structures related to cpufreq.
4 * 3 *
5 * Copyright (C) 2016, Intel Corporation 4 * Copyright (C) 2016, Intel Corporation
6 * Author: Rafael J. Wysocki <rafael.j.wysocki 5 * Author: Rafael J. Wysocki <rafael.j.wysocki@intel.com>
>> 6 *
>> 7 * This program is free software; you can redistribute it and/or modify
>> 8 * it under the terms of the GNU General Public License version 2 as
>> 9 * published by the Free Software Foundation.
7 */ 10 */
8 11
9 DEFINE_PER_CPU(struct update_util_data __rcu * !! 12 #include "sched.h"
>> 13
>> 14 DEFINE_PER_CPU(struct update_util_data *, cpufreq_update_util_data);
10 15
11 /** 16 /**
12 * cpufreq_add_update_util_hook - Populate the 17 * cpufreq_add_update_util_hook - Populate the CPU's update_util_data pointer.
13 * @cpu: The CPU to set the pointer for. 18 * @cpu: The CPU to set the pointer for.
14 * @data: New pointer value. 19 * @data: New pointer value.
15 * @func: Callback function to set for the CPU 20 * @func: Callback function to set for the CPU.
16 * 21 *
17 * Set and publish the update_util_data pointe 22 * Set and publish the update_util_data pointer for the given CPU.
18 * 23 *
19 * The update_util_data pointer of @cpu is set 24 * The update_util_data pointer of @cpu is set to @data and the callback
20 * function pointer in the target struct updat 25 * function pointer in the target struct update_util_data is set to @func.
21 * That function will be called by cpufreq_upd 26 * That function will be called by cpufreq_update_util() from RCU-sched
22 * read-side critical sections, so it must not 27 * read-side critical sections, so it must not sleep. @data will always be
23 * passed to it as the first argument which al 28 * passed to it as the first argument which allows the function to get to the
24 * target update_util_data structure and its c 29 * target update_util_data structure and its container.
25 * 30 *
26 * The update_util_data pointer of @cpu must b 31 * The update_util_data pointer of @cpu must be NULL when this function is
27 * called or it will WARN() and return with no 32 * called or it will WARN() and return with no effect.
28 */ 33 */
29 void cpufreq_add_update_util_hook(int cpu, str 34 void cpufreq_add_update_util_hook(int cpu, struct update_util_data *data,
30 void (*func)(struct up 35 void (*func)(struct update_util_data *data, u64 time,
31 unsigned 36 unsigned int flags))
32 { 37 {
33 if (WARN_ON(!data || !func)) 38 if (WARN_ON(!data || !func))
34 return; 39 return;
35 40
36 if (WARN_ON(per_cpu(cpufreq_update_uti 41 if (WARN_ON(per_cpu(cpufreq_update_util_data, cpu)))
37 return; 42 return;
38 43
39 data->func = func; 44 data->func = func;
40 rcu_assign_pointer(per_cpu(cpufreq_upd 45 rcu_assign_pointer(per_cpu(cpufreq_update_util_data, cpu), data);
41 } 46 }
42 EXPORT_SYMBOL_GPL(cpufreq_add_update_util_hook 47 EXPORT_SYMBOL_GPL(cpufreq_add_update_util_hook);
43 48
44 /** 49 /**
45 * cpufreq_remove_update_util_hook - Clear the 50 * cpufreq_remove_update_util_hook - Clear the CPU's update_util_data pointer.
46 * @cpu: The CPU to clear the pointer for. 51 * @cpu: The CPU to clear the pointer for.
47 * 52 *
48 * Clear the update_util_data pointer for the 53 * Clear the update_util_data pointer for the given CPU.
49 * 54 *
50 * Callers must use RCU callbacks to free any !! 55 * Callers must use RCU-sched callbacks to free any memory that might be
51 * accessed via the old update_util_data point !! 56 * accessed via the old update_util_data pointer or invoke synchronize_sched()
52 * right after this function to avoid use-afte 57 * right after this function to avoid use-after-free.
53 */ 58 */
54 void cpufreq_remove_update_util_hook(int cpu) 59 void cpufreq_remove_update_util_hook(int cpu)
55 { 60 {
56 rcu_assign_pointer(per_cpu(cpufreq_upd 61 rcu_assign_pointer(per_cpu(cpufreq_update_util_data, cpu), NULL);
57 } 62 }
58 EXPORT_SYMBOL_GPL(cpufreq_remove_update_util_h 63 EXPORT_SYMBOL_GPL(cpufreq_remove_update_util_hook);
59 <<
60 /** <<
61 * cpufreq_this_cpu_can_update - Check if cpuf <<
62 * @policy: cpufreq policy to check. <<
63 * <<
64 * Return 'true' if: <<
65 * - the local and remote CPUs share @policy, <<
66 * - dvfs_possible_from_any_cpu is set in @pol <<
67 * offline (in which case it is not expected <<
68 */ <<
69 bool cpufreq_this_cpu_can_update(struct cpufre <<
70 { <<
71 return cpumask_test_cpu(smp_processor_ <<
72 (policy->dvfs_possible_from_an <<
73 rcu_dereference_sched(*this_c <<
74 } <<
75 64
Linux® is a registered trademark of Linus Torvalds in the United States and other countries.
TOMOYO® is a registered trademark of NTT DATA CORPORATION.