mirrors/linux-stable
1
0
Fork 0
mirror of https://git.kernel.org/pub/scm/linux/kernel/git/stable/linux.git synced 2024-10-03 15:47:36 +00:00
Code Issues Releases Wiki Activity

intel_idle: Clean up kerneldoc comments for multiple functions

Browse source 
Turn the description comments of some functions in the intel_idle
driver into proper kerneldoc ones and clean them up.

No functional impact.

Signed-off-by: Rafael J. Wysocki <rafael.j.wysocki@intel.com>
This commit is contained in:
Rafael J. Wysocki 2020-02-06 18:45:29 +01:00
parent 6eb0443ac8
commit 6eacb15fef
1 changed files with 21 additions and 19 deletions
Show stats Download patch file Download diff file Expand all files Collapse all files

40
drivers/idle/intel_idle.c
View file

@ -1288,11 +1288,11 @@ static inline void intel_idle_init_cstates_acpi(struct cpuidle_driver *drv) { }
static inline bool intel_idle_off_by_default(u32 mwait_hint) { return false; } static inline bool intel_idle_off_by_default(u32 mwait_hint) { return false; }
#endif /* !CONFIG_ACPI_PROCESSOR_CSTATE */ #endif /* !CONFIG_ACPI_PROCESSOR_CSTATE */
/* /**
* ivt_idle_state_table_update(void) * ivt_idle_state_table_update - Tune the idle states table for Ivy Town.
* *
* Tune IVT multi-socket targets * Tune IVT multi-socket targets.
* Assumption: num_sockets == (max_package_num + 1) * Assumption: num_sockets == (max_package_num + 1).
*/ */
static void __init ivt_idle_state_table_update(void) static void __init ivt_idle_state_table_update(void)
{ {
@ -1338,11 +1338,11 @@ static unsigned long long __init irtl_2_usec(unsigned long long irtl)
return div_u64((irtl & 0x3FF) * ns, NSEC_PER_USEC); return div_u64((irtl & 0x3FF) * ns, NSEC_PER_USEC);
} }
/* /**
* bxt_idle_state_table_update(void) * bxt_idle_state_table_update - Fix up the Broxton idle states table.
* *
* On BXT, we trust the IRTL to show the definitive maximum latency * On BXT, trust the IRTL (Interrupt Response Time Limit) MSR to show the
* We use the same value for target_residency. * definitive maximum latency and use the same value for target_residency.
*/ */
static void __init bxt_idle_state_table_update(void) static void __init bxt_idle_state_table_update(void)
{ {
@ -1385,11 +1385,11 @@ static void __init bxt_idle_state_table_update(void)
} }
} }
/*
* sklh_idle_state_table_update(void) /**
* sklh_idle_state_table_update - Fix up the Sky Lake idle states table.
* *
* On SKL-H (model 0x5e) disable C8 and C9 if: * On SKL-H (model 0x5e) skip C8 and C9 if C10 is enabled and SGX disabled.
* C10 is enabled and SGX disabled
*/ */
static void __init sklh_idle_state_table_update(void) static void __init sklh_idle_state_table_update(void)
{ {
@ -1500,9 +1500,9 @@ static void __init intel_idle_init_cstates_icpu(struct cpuidle_driver *drv)
} }
} }
/* /**
* intel_idle_cpuidle_driver_init() * intel_idle_cpuidle_driver_init - Create the list of available idle states.
* allocate, initialize cpuidle_states * @drv: cpuidle driver structure to initialize.
*/ */
static void __init intel_idle_cpuidle_driver_init(struct cpuidle_driver *drv) static void __init intel_idle_cpuidle_driver_init(struct cpuidle_driver *drv)
{ {
@ -1537,10 +1537,12 @@ static void c1e_promotion_disable(void)
wrmsrl(MSR_IA32_POWER_CTL, msr_bits); wrmsrl(MSR_IA32_POWER_CTL, msr_bits);
} }
/* /**
* intel_idle_cpu_init() * intel_idle_cpu_init - Register the target CPU with the cpuidle core.
* allocate, initialize, register cpuidle_devices * @cpu: CPU to initialize.
* @cpu: cpu/core to initialize *
* Register a cpuidle device object for @cpu and update its MSRs in accordance
* with the processor model flags.
*/ */
static int intel_idle_cpu_init(unsigned int cpu) static int intel_idle_cpu_init(unsigned int cpu)
{ {