Rather that hide their purpose in some dark, damp corner of Documentation/, add some documentation to the default implementations.
Unified · Split
| @@ -217,6 +217,16 @@ static inline bool cpus_share_cache(int this_cpu, int that_cpu) · 216 unmodified lines | |||
| 217 | #endif /* !CONFIG_SMP */ | 217 | #endif /* !CONFIG_SMP */ |
| 218 | 218 | ||
| 219 | #ifndef arch_scale_cpu_capacity | 219 | #ifndef arch_scale_cpu_capacity |
| 220 | /** | ||
| 221 | * arch_scale_cpu_capacity - get the capacity scale factor of a given CPU. | ||
| 222 | * @cpu: the CPU in question. | ||
| 223 | * | ||
| 224 | * Return: the CPU scale factor normalized against SCHED_CAPACITY_SCALE, i.e. | ||
| 225 | * | ||
| 226 | * max_perf(cpu) | ||
| 227 | * ----------------------------- * SCHED_CAPACITY_SCALE | ||
| 228 | * max(max_perf(c) : c \in CPUs) | ||
| 229 | */ | ||
| 220 | static __always_inline | 230 | static __always_inline |
| 221 | unsigned long arch_scale_cpu_capacity(int cpu) | 231 | unsigned long arch_scale_cpu_capacity(int cpu) |
| 222 | { | 232 | { |
| @@ -2049,6 +2049,16 @@ void arch_scale_freq_tick(void) · 2048 unmodified lines | |||
| 2049 | #endif | 2049 | #endif |
| 2050 | 2050 | ||
| 2051 | #ifndef arch_scale_freq_capacity | 2051 | #ifndef arch_scale_freq_capacity |
| 2052 | /** | ||
| 2053 | * arch_scale_freq_capacity - get the frequency scale factor of a given CPU. | ||
| 2054 | * @cpu: the CPU in question. | ||
| 2055 | * | ||
| 2056 | * Return: the frequency scale factor normalized against SCHED_CAPACITY_SCALE, i.e. | ||
| 2057 | * | ||
| 2058 | * f_curr | ||
| 2059 | * ------ * SCHED_CAPACITY_SCALE | ||
| 2060 | * f_max | ||
| 2061 | */ | ||
| 2052 | static __always_inline | 2062 | static __always_inline |
| 2053 | unsigned long arch_scale_freq_capacity(int cpu) | 2063 | unsigned long arch_scale_freq_capacity(int cpu) |
| 2054 | { | 2064 | { |