2005-04-16 22:20:36 +00:00
|
|
|
/*
|
2009-01-18 03:36:14 +00:00
|
|
|
* acpi-cpufreq.c - ACPI Processor P-States Driver
|
2005-04-16 22:20:36 +00:00
|
|
|
*
|
|
|
|
* Copyright (C) 2001, 2002 Andy Grover <andrew.grover@intel.com>
|
|
|
|
* Copyright (C) 2001, 2002 Paul Diefenbaugh <paul.s.diefenbaugh@intel.com>
|
|
|
|
* Copyright (C) 2002 - 2004 Dominik Brodowski <linux@brodo.de>
|
2006-10-03 19:29:15 +00:00
|
|
|
* Copyright (C) 2006 Denis Sadykov <denis.m.sadykov@intel.com>
|
2005-04-16 22:20:36 +00:00
|
|
|
*
|
|
|
|
* ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
|
|
|
|
*
|
|
|
|
* This program is free software; you can redistribute it and/or modify
|
|
|
|
* it under the terms of the GNU General Public License as published by
|
|
|
|
* the Free Software Foundation; either version 2 of the License, or (at
|
|
|
|
* your option) any later version.
|
|
|
|
*
|
|
|
|
* This program is distributed in the hope that it will be useful, but
|
|
|
|
* WITHOUT ANY WARRANTY; without even the implied warranty of
|
|
|
|
* MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the GNU
|
|
|
|
* General Public License for more details.
|
|
|
|
*
|
|
|
|
* You should have received a copy of the GNU General Public License along
|
|
|
|
* with this program; if not, write to the Free Software Foundation, Inc.,
|
|
|
|
* 59 Temple Place, Suite 330, Boston, MA 02111-1307 USA.
|
|
|
|
*
|
|
|
|
* ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
|
|
|
|
*/
|
|
|
|
|
|
|
|
#include <linux/kernel.h>
|
|
|
|
#include <linux/module.h>
|
|
|
|
#include <linux/init.h>
|
2006-10-03 19:29:15 +00:00
|
|
|
#include <linux/smp.h>
|
|
|
|
#include <linux/sched.h>
|
2005-04-16 22:20:36 +00:00
|
|
|
#include <linux/cpufreq.h>
|
2005-08-25 19:59:00 +00:00
|
|
|
#include <linux/compiler.h>
|
2006-09-01 21:02:24 +00:00
|
|
|
#include <linux/dmi.h>
|
include cleanup: Update gfp.h and slab.h includes to prepare for breaking implicit slab.h inclusion from percpu.h
percpu.h is included by sched.h and module.h and thus ends up being
included when building most .c files. percpu.h includes slab.h which
in turn includes gfp.h making everything defined by the two files
universally available and complicating inclusion dependencies.
percpu.h -> slab.h dependency is about to be removed. Prepare for
this change by updating users of gfp and slab facilities include those
headers directly instead of assuming availability. As this conversion
needs to touch large number of source files, the following script is
used as the basis of conversion.
http://userweb.kernel.org/~tj/misc/slabh-sweep.py
The script does the followings.
* Scan files for gfp and slab usages and update includes such that
only the necessary includes are there. ie. if only gfp is used,
gfp.h, if slab is used, slab.h.
* When the script inserts a new include, it looks at the include
blocks and try to put the new include such that its order conforms
to its surrounding. It's put in the include block which contains
core kernel includes, in the same order that the rest are ordered -
alphabetical, Christmas tree, rev-Xmas-tree or at the end if there
doesn't seem to be any matching order.
* If the script can't find a place to put a new include (mostly
because the file doesn't have fitting include block), it prints out
an error message indicating which .h file needs to be added to the
file.
The conversion was done in the following steps.
1. The initial automatic conversion of all .c files updated slightly
over 4000 files, deleting around 700 includes and adding ~480 gfp.h
and ~3000 slab.h inclusions. The script emitted errors for ~400
files.
2. Each error was manually checked. Some didn't need the inclusion,
some needed manual addition while adding it to implementation .h or
embedding .c file was more appropriate for others. This step added
inclusions to around 150 files.
3. The script was run again and the output was compared to the edits
from #2 to make sure no file was left behind.
4. Several build tests were done and a couple of problems were fixed.
e.g. lib/decompress_*.c used malloc/free() wrappers around slab
APIs requiring slab.h to be added manually.
5. The script was run on all .h files but without automatically
editing them as sprinkling gfp.h and slab.h inclusions around .h
files could easily lead to inclusion dependency hell. Most gfp.h
inclusion directives were ignored as stuff from gfp.h was usually
wildly available and often used in preprocessor macros. Each
slab.h inclusion directive was examined and added manually as
necessary.
6. percpu.h was updated not to include slab.h.
7. Build test were done on the following configurations and failures
were fixed. CONFIG_GCOV_KERNEL was turned off for all tests (as my
distributed build env didn't work with gcov compiles) and a few
more options had to be turned off depending on archs to make things
build (like ipr on powerpc/64 which failed due to missing writeq).
* x86 and x86_64 UP and SMP allmodconfig and a custom test config.
* powerpc and powerpc64 SMP allmodconfig
* sparc and sparc64 SMP allmodconfig
* ia64 SMP allmodconfig
* s390 SMP allmodconfig
* alpha SMP allmodconfig
* um on x86_64 SMP allmodconfig
8. percpu.h modifications were reverted so that it could be applied as
a separate patch and serve as bisection point.
Given the fact that I had only a couple of failures from tests on step
6, I'm fairly confident about the coverage of this conversion patch.
If there is a breakage, it's likely to be something in one of the arch
headers which should be easily discoverable easily on most builds of
the specific arch.
Signed-off-by: Tejun Heo <tj@kernel.org>
Guess-its-ok-by: Christoph Lameter <cl@linux-foundation.org>
Cc: Ingo Molnar <mingo@redhat.com>
Cc: Lee Schermerhorn <Lee.Schermerhorn@hp.com>
2010-03-24 08:04:11 +00:00
|
|
|
#include <linux/slab.h>
|
2005-04-16 22:20:36 +00:00
|
|
|
|
|
|
|
#include <linux/acpi.h>
|
2009-01-18 03:36:14 +00:00
|
|
|
#include <linux/io.h>
|
|
|
|
#include <linux/delay.h>
|
|
|
|
#include <linux/uaccess.h>
|
|
|
|
|
2005-04-16 22:20:36 +00:00
|
|
|
#include <acpi/processor.h>
|
|
|
|
|
2006-10-03 19:33:14 +00:00
|
|
|
#include <asm/msr.h>
|
2006-10-03 19:29:15 +00:00
|
|
|
#include <asm/processor.h>
|
|
|
|
#include <asm/cpufeature.h>
|
2010-03-18 17:41:46 +00:00
|
|
|
#include "mperf.h"
|
2006-10-03 19:29:15 +00:00
|
|
|
|
2005-04-16 22:20:36 +00:00
|
|
|
MODULE_AUTHOR("Paul Diefenbaugh, Dominik Brodowski");
|
|
|
|
MODULE_DESCRIPTION("ACPI Processor P-States Driver");
|
|
|
|
MODULE_LICENSE("GPL");
|
|
|
|
|
2012-09-04 08:28:03 +00:00
|
|
|
#define PFX "acpi-cpufreq: "
|
|
|
|
|
2006-10-03 19:33:14 +00:00
|
|
|
enum {
|
|
|
|
UNDEFINED_CAPABLE = 0,
|
|
|
|
SYSTEM_INTEL_MSR_CAPABLE,
|
2012-09-04 08:28:02 +00:00
|
|
|
SYSTEM_AMD_MSR_CAPABLE,
|
2006-10-03 19:33:14 +00:00
|
|
|
SYSTEM_IO_CAPABLE,
|
|
|
|
};
|
|
|
|
|
|
|
|
#define INTEL_MSR_RANGE (0xffff)
|
2012-09-04 08:28:02 +00:00
|
|
|
#define AMD_MSR_RANGE (0x7)
|
2006-10-03 19:33:14 +00:00
|
|
|
|
2012-09-04 08:28:07 +00:00
|
|
|
#define MSR_K7_HWCR_CPB_DIS (1ULL << 25)
|
|
|
|
|
2006-10-03 19:29:15 +00:00
|
|
|
struct acpi_cpufreq_data {
|
2006-10-03 19:35:23 +00:00
|
|
|
struct acpi_processor_performance *acpi_data;
|
|
|
|
struct cpufreq_frequency_table *freq_table;
|
|
|
|
unsigned int resume;
|
|
|
|
unsigned int cpu_feature;
|
2005-04-16 22:20:36 +00:00
|
|
|
};
|
|
|
|
|
2009-10-29 13:34:13 +00:00
|
|
|
static DEFINE_PER_CPU(struct acpi_cpufreq_data *, acfreq_data);
|
2008-01-30 12:33:12 +00:00
|
|
|
|
2007-08-07 22:40:30 +00:00
|
|
|
/* acpi_perf_data is a pointer to percpu data. */
|
2010-08-13 14:00:11 +00:00
|
|
|
static struct acpi_processor_performance __percpu *acpi_perf_data;
|
2005-04-16 22:20:36 +00:00
|
|
|
|
|
|
|
static struct cpufreq_driver acpi_cpufreq_driver;
|
|
|
|
|
2005-08-25 19:59:00 +00:00
|
|
|
static unsigned int acpi_pstate_strict;
|
2012-09-04 08:28:07 +00:00
|
|
|
static bool boost_enabled, boost_supported;
|
|
|
|
static struct msr __percpu *msrs;
|
|
|
|
|
|
|
|
static bool boost_state(unsigned int cpu)
|
|
|
|
{
|
|
|
|
u32 lo, hi;
|
|
|
|
u64 msr;
|
|
|
|
|
|
|
|
switch (boot_cpu_data.x86_vendor) {
|
|
|
|
case X86_VENDOR_INTEL:
|
|
|
|
rdmsr_on_cpu(cpu, MSR_IA32_MISC_ENABLE, &lo, &hi);
|
|
|
|
msr = lo | ((u64)hi << 32);
|
|
|
|
return !(msr & MSR_IA32_MISC_ENABLE_TURBO_DISABLE);
|
|
|
|
case X86_VENDOR_AMD:
|
|
|
|
rdmsr_on_cpu(cpu, MSR_K7_HWCR, &lo, &hi);
|
|
|
|
msr = lo | ((u64)hi << 32);
|
|
|
|
return !(msr & MSR_K7_HWCR_CPB_DIS);
|
|
|
|
}
|
|
|
|
return false;
|
|
|
|
}
|
|
|
|
|
|
|
|
static void boost_set_msrs(bool enable, const struct cpumask *cpumask)
|
|
|
|
{
|
|
|
|
u32 cpu;
|
|
|
|
u32 msr_addr;
|
|
|
|
u64 msr_mask;
|
|
|
|
|
|
|
|
switch (boot_cpu_data.x86_vendor) {
|
|
|
|
case X86_VENDOR_INTEL:
|
|
|
|
msr_addr = MSR_IA32_MISC_ENABLE;
|
|
|
|
msr_mask = MSR_IA32_MISC_ENABLE_TURBO_DISABLE;
|
|
|
|
break;
|
|
|
|
case X86_VENDOR_AMD:
|
|
|
|
msr_addr = MSR_K7_HWCR;
|
|
|
|
msr_mask = MSR_K7_HWCR_CPB_DIS;
|
|
|
|
break;
|
|
|
|
default:
|
|
|
|
return;
|
|
|
|
}
|
|
|
|
|
|
|
|
rdmsr_on_cpus(cpumask, msr_addr, msrs);
|
|
|
|
|
|
|
|
for_each_cpu(cpu, cpumask) {
|
|
|
|
struct msr *reg = per_cpu_ptr(msrs, cpu);
|
|
|
|
if (enable)
|
|
|
|
reg->q &= ~msr_mask;
|
|
|
|
else
|
|
|
|
reg->q |= msr_mask;
|
|
|
|
}
|
|
|
|
|
|
|
|
wrmsr_on_cpus(cpumask, msr_addr, msrs);
|
|
|
|
}
|
|
|
|
|
2012-09-04 08:28:08 +00:00
|
|
|
static ssize_t _store_boost(const char *buf, size_t count)
|
2012-09-04 08:28:07 +00:00
|
|
|
{
|
|
|
|
int ret;
|
|
|
|
unsigned long val = 0;
|
|
|
|
|
|
|
|
if (!boost_supported)
|
|
|
|
return -EINVAL;
|
|
|
|
|
|
|
|
ret = kstrtoul(buf, 10, &val);
|
|
|
|
if (ret || (val > 1))
|
|
|
|
return -EINVAL;
|
|
|
|
|
|
|
|
if ((val && boost_enabled) || (!val && !boost_enabled))
|
|
|
|
return count;
|
|
|
|
|
|
|
|
get_online_cpus();
|
|
|
|
|
|
|
|
boost_set_msrs(val, cpu_online_mask);
|
|
|
|
|
|
|
|
put_online_cpus();
|
|
|
|
|
|
|
|
boost_enabled = val;
|
|
|
|
pr_debug("Core Boosting %sabled.\n", val ? "en" : "dis");
|
|
|
|
|
|
|
|
return count;
|
|
|
|
}
|
|
|
|
|
2012-09-04 08:28:08 +00:00
|
|
|
static ssize_t store_global_boost(struct kobject *kobj, struct attribute *attr,
|
|
|
|
const char *buf, size_t count)
|
|
|
|
{
|
|
|
|
return _store_boost(buf, count);
|
|
|
|
}
|
|
|
|
|
2012-09-04 08:28:07 +00:00
|
|
|
static ssize_t show_global_boost(struct kobject *kobj,
|
|
|
|
struct attribute *attr, char *buf)
|
|
|
|
{
|
|
|
|
return sprintf(buf, "%u\n", boost_enabled);
|
|
|
|
}
|
|
|
|
|
|
|
|
static struct global_attr global_boost = __ATTR(boost, 0644,
|
|
|
|
show_global_boost,
|
|
|
|
store_global_boost);
|
2005-08-25 19:59:00 +00:00
|
|
|
|
2012-09-04 08:28:08 +00:00
|
|
|
#ifdef CONFIG_X86_ACPI_CPUFREQ_CPB
|
|
|
|
static ssize_t store_cpb(struct cpufreq_policy *policy, const char *buf,
|
|
|
|
size_t count)
|
|
|
|
{
|
|
|
|
return _store_boost(buf, count);
|
|
|
|
}
|
|
|
|
|
|
|
|
static ssize_t show_cpb(struct cpufreq_policy *policy, char *buf)
|
|
|
|
{
|
|
|
|
return sprintf(buf, "%u\n", boost_enabled);
|
|
|
|
}
|
|
|
|
|
|
|
|
static struct freq_attr cpb = __ATTR(cpb, 0644, show_cpb, store_cpb);
|
|
|
|
#endif
|
|
|
|
|
2006-10-03 19:33:14 +00:00
|
|
|
static int check_est_cpu(unsigned int cpuid)
|
|
|
|
{
|
2007-10-19 18:35:04 +00:00
|
|
|
struct cpuinfo_x86 *cpu = &cpu_data(cpuid);
|
2006-10-03 19:33:14 +00:00
|
|
|
|
2009-06-08 10:27:54 +00:00
|
|
|
return cpu_has(cpu, X86_FEATURE_EST);
|
2006-10-03 19:33:14 +00:00
|
|
|
}
|
|
|
|
|
2012-09-04 08:28:02 +00:00
|
|
|
static int check_amd_hwpstate_cpu(unsigned int cpuid)
|
|
|
|
{
|
|
|
|
struct cpuinfo_x86 *cpu = &cpu_data(cpuid);
|
|
|
|
|
|
|
|
return cpu_has(cpu, X86_FEATURE_HW_PSTATE);
|
|
|
|
}
|
|
|
|
|
2006-10-03 19:33:14 +00:00
|
|
|
static unsigned extract_io(u32 value, struct acpi_cpufreq_data *data)
|
2006-10-03 19:29:15 +00:00
|
|
|
{
|
2006-10-03 19:35:23 +00:00
|
|
|
struct acpi_processor_performance *perf;
|
|
|
|
int i;
|
2006-10-03 19:29:15 +00:00
|
|
|
|
|
|
|
perf = data->acpi_data;
|
|
|
|
|
2009-01-18 03:36:14 +00:00
|
|
|
for (i = 0; i < perf->state_count; i++) {
|
2006-10-03 19:29:15 +00:00
|
|
|
if (value == perf->states[i].status)
|
|
|
|
return data->freq_table[i].frequency;
|
|
|
|
}
|
|
|
|
return 0;
|
|
|
|
}
|
|
|
|
|
2006-10-03 19:33:14 +00:00
|
|
|
static unsigned extract_msr(u32 msr, struct acpi_cpufreq_data *data)
|
|
|
|
{
|
|
|
|
int i;
|
2006-10-03 19:37:42 +00:00
|
|
|
struct acpi_processor_performance *perf;
|
2006-10-03 19:33:14 +00:00
|
|
|
|
2012-09-04 08:28:02 +00:00
|
|
|
if (boot_cpu_data.x86_vendor == X86_VENDOR_AMD)
|
|
|
|
msr &= AMD_MSR_RANGE;
|
|
|
|
else
|
|
|
|
msr &= INTEL_MSR_RANGE;
|
|
|
|
|
2006-10-03 19:37:42 +00:00
|
|
|
perf = data->acpi_data;
|
|
|
|
|
2009-01-18 03:36:14 +00:00
|
|
|
for (i = 0; data->freq_table[i].frequency != CPUFREQ_TABLE_END; i++) {
|
2006-10-03 19:37:42 +00:00
|
|
|
if (msr == perf->states[data->freq_table[i].index].status)
|
2006-10-03 19:33:14 +00:00
|
|
|
return data->freq_table[i].frequency;
|
|
|
|
}
|
|
|
|
return data->freq_table[0].frequency;
|
|
|
|
}
|
|
|
|
|
|
|
|
static unsigned extract_freq(u32 val, struct acpi_cpufreq_data *data)
|
|
|
|
{
|
|
|
|
switch (data->cpu_feature) {
|
2006-10-03 19:35:23 +00:00
|
|
|
case SYSTEM_INTEL_MSR_CAPABLE:
|
2012-09-04 08:28:02 +00:00
|
|
|
case SYSTEM_AMD_MSR_CAPABLE:
|
2006-10-03 19:33:14 +00:00
|
|
|
return extract_msr(val, data);
|
2006-10-03 19:35:23 +00:00
|
|
|
case SYSTEM_IO_CAPABLE:
|
2006-10-03 19:33:14 +00:00
|
|
|
return extract_io(val, data);
|
2006-10-03 19:35:23 +00:00
|
|
|
default:
|
2006-10-03 19:33:14 +00:00
|
|
|
return 0;
|
|
|
|
}
|
|
|
|
}
|
|
|
|
|
|
|
|
struct msr_addr {
|
|
|
|
u32 reg;
|
|
|
|
};
|
|
|
|
|
2006-10-03 19:29:15 +00:00
|
|
|
struct io_addr {
|
|
|
|
u16 port;
|
|
|
|
u8 bit_width;
|
|
|
|
};
|
|
|
|
|
|
|
|
struct drv_cmd {
|
2006-10-03 19:33:14 +00:00
|
|
|
unsigned int type;
|
2009-01-15 14:46:08 +00:00
|
|
|
const struct cpumask *mask;
|
2009-01-18 03:36:14 +00:00
|
|
|
union {
|
|
|
|
struct msr_addr msr;
|
|
|
|
struct io_addr io;
|
|
|
|
} addr;
|
2006-10-03 19:29:15 +00:00
|
|
|
u32 val;
|
|
|
|
};
|
|
|
|
|
2009-04-13 17:27:49 +00:00
|
|
|
/* Called via smp_call_function_single(), on the target CPU */
|
|
|
|
static void do_drv_read(void *_cmd)
|
2005-04-16 22:20:36 +00:00
|
|
|
{
|
2009-01-16 23:31:15 +00:00
|
|
|
struct drv_cmd *cmd = _cmd;
|
2006-10-03 19:33:14 +00:00
|
|
|
u32 h;
|
|
|
|
|
|
|
|
switch (cmd->type) {
|
2006-10-03 19:35:23 +00:00
|
|
|
case SYSTEM_INTEL_MSR_CAPABLE:
|
2012-09-04 08:28:02 +00:00
|
|
|
case SYSTEM_AMD_MSR_CAPABLE:
|
2006-10-03 19:33:14 +00:00
|
|
|
rdmsr(cmd->addr.msr.reg, cmd->val, h);
|
|
|
|
break;
|
2006-10-03 19:35:23 +00:00
|
|
|
case SYSTEM_IO_CAPABLE:
|
2006-12-13 18:41:16 +00:00
|
|
|
acpi_os_read_port((acpi_io_address)cmd->addr.io.port,
|
|
|
|
&cmd->val,
|
|
|
|
(u32)cmd->addr.io.bit_width);
|
2006-10-03 19:33:14 +00:00
|
|
|
break;
|
2006-10-03 19:35:23 +00:00
|
|
|
default:
|
2006-10-03 19:33:14 +00:00
|
|
|
break;
|
|
|
|
}
|
2006-10-03 19:29:15 +00:00
|
|
|
}
|
2005-04-16 22:20:36 +00:00
|
|
|
|
2009-04-13 17:27:49 +00:00
|
|
|
/* Called via smp_call_function_many(), on the target CPUs */
|
|
|
|
static void do_drv_write(void *_cmd)
|
2006-10-03 19:29:15 +00:00
|
|
|
{
|
2009-01-16 23:31:15 +00:00
|
|
|
struct drv_cmd *cmd = _cmd;
|
2007-05-23 22:42:13 +00:00
|
|
|
u32 lo, hi;
|
2006-10-03 19:33:14 +00:00
|
|
|
|
|
|
|
switch (cmd->type) {
|
2006-10-03 19:35:23 +00:00
|
|
|
case SYSTEM_INTEL_MSR_CAPABLE:
|
2007-05-23 22:42:13 +00:00
|
|
|
rdmsr(cmd->addr.msr.reg, lo, hi);
|
|
|
|
lo = (lo & ~INTEL_MSR_RANGE) | (cmd->val & INTEL_MSR_RANGE);
|
|
|
|
wrmsr(cmd->addr.msr.reg, lo, hi);
|
2006-10-03 19:33:14 +00:00
|
|
|
break;
|
2012-09-04 08:28:02 +00:00
|
|
|
case SYSTEM_AMD_MSR_CAPABLE:
|
|
|
|
wrmsr(cmd->addr.msr.reg, cmd->val, 0);
|
|
|
|
break;
|
2006-10-03 19:35:23 +00:00
|
|
|
case SYSTEM_IO_CAPABLE:
|
2006-12-13 18:41:16 +00:00
|
|
|
acpi_os_write_port((acpi_io_address)cmd->addr.io.port,
|
|
|
|
cmd->val,
|
|
|
|
(u32)cmd->addr.io.bit_width);
|
2006-10-03 19:33:14 +00:00
|
|
|
break;
|
2006-10-03 19:35:23 +00:00
|
|
|
default:
|
2006-10-03 19:33:14 +00:00
|
|
|
break;
|
|
|
|
}
|
2006-10-03 19:29:15 +00:00
|
|
|
}
|
2005-04-16 22:20:36 +00:00
|
|
|
|
2006-10-18 04:41:48 +00:00
|
|
|
static void drv_read(struct drv_cmd *cmd)
|
2006-10-03 19:29:15 +00:00
|
|
|
{
|
2009-12-22 00:19:58 +00:00
|
|
|
int err;
|
2006-10-03 19:29:15 +00:00
|
|
|
cmd->val = 0;
|
|
|
|
|
2009-12-22 00:19:58 +00:00
|
|
|
err = smp_call_function_any(cmd->mask, do_drv_read, cmd, 1);
|
|
|
|
WARN_ON_ONCE(err); /* smp_call_function_any() was buggy? */
|
2006-10-03 19:29:15 +00:00
|
|
|
}
|
|
|
|
|
|
|
|
static void drv_write(struct drv_cmd *cmd)
|
|
|
|
{
|
2009-04-15 15:05:13 +00:00
|
|
|
int this_cpu;
|
|
|
|
|
|
|
|
this_cpu = get_cpu();
|
|
|
|
if (cpumask_test_cpu(this_cpu, cmd->mask))
|
|
|
|
do_drv_write(cmd);
|
2009-04-13 17:27:49 +00:00
|
|
|
smp_call_function_many(cmd->mask, do_drv_write, cmd, 1);
|
2009-04-15 15:05:13 +00:00
|
|
|
put_cpu();
|
2006-10-03 19:29:15 +00:00
|
|
|
}
|
2005-04-16 22:20:36 +00:00
|
|
|
|
2009-01-04 13:18:08 +00:00
|
|
|
static u32 get_cur_val(const struct cpumask *mask)
|
2006-10-03 19:29:15 +00:00
|
|
|
{
|
2006-10-03 19:35:23 +00:00
|
|
|
struct acpi_processor_performance *perf;
|
|
|
|
struct drv_cmd cmd;
|
2005-04-16 22:20:36 +00:00
|
|
|
|
2009-01-04 13:18:08 +00:00
|
|
|
if (unlikely(cpumask_empty(mask)))
|
2006-10-03 19:29:15 +00:00
|
|
|
return 0;
|
2005-04-16 22:20:36 +00:00
|
|
|
|
2009-10-29 13:34:13 +00:00
|
|
|
switch (per_cpu(acfreq_data, cpumask_first(mask))->cpu_feature) {
|
2006-10-03 19:33:14 +00:00
|
|
|
case SYSTEM_INTEL_MSR_CAPABLE:
|
|
|
|
cmd.type = SYSTEM_INTEL_MSR_CAPABLE;
|
|
|
|
cmd.addr.msr.reg = MSR_IA32_PERF_STATUS;
|
|
|
|
break;
|
2012-09-04 08:28:02 +00:00
|
|
|
case SYSTEM_AMD_MSR_CAPABLE:
|
|
|
|
cmd.type = SYSTEM_AMD_MSR_CAPABLE;
|
|
|
|
cmd.addr.msr.reg = MSR_AMD_PERF_STATUS;
|
|
|
|
break;
|
2006-10-03 19:33:14 +00:00
|
|
|
case SYSTEM_IO_CAPABLE:
|
|
|
|
cmd.type = SYSTEM_IO_CAPABLE;
|
2009-10-29 13:34:13 +00:00
|
|
|
perf = per_cpu(acfreq_data, cpumask_first(mask))->acpi_data;
|
2006-10-03 19:33:14 +00:00
|
|
|
cmd.addr.io.port = perf->control_register.address;
|
|
|
|
cmd.addr.io.bit_width = perf->control_register.bit_width;
|
|
|
|
break;
|
|
|
|
default:
|
|
|
|
return 0;
|
|
|
|
}
|
|
|
|
|
2009-01-15 14:46:08 +00:00
|
|
|
cmd.mask = mask;
|
2006-10-03 19:29:15 +00:00
|
|
|
drv_read(&cmd);
|
2005-04-16 22:20:36 +00:00
|
|
|
|
2011-03-27 13:04:46 +00:00
|
|
|
pr_debug("get_cur_val = %u\n", cmd.val);
|
2006-10-03 19:29:15 +00:00
|
|
|
|
|
|
|
return cmd.val;
|
|
|
|
}
|
2005-04-16 22:20:36 +00:00
|
|
|
|
2006-10-03 19:29:15 +00:00
|
|
|
static unsigned int get_cur_freq_on_cpu(unsigned int cpu)
|
|
|
|
{
|
2009-10-29 13:34:13 +00:00
|
|
|
struct acpi_cpufreq_data *data = per_cpu(acfreq_data, cpu);
|
2006-10-03 19:35:23 +00:00
|
|
|
unsigned int freq;
|
2008-04-28 19:13:43 +00:00
|
|
|
unsigned int cached_freq;
|
2006-10-03 19:29:15 +00:00
|
|
|
|
2011-03-27 13:04:46 +00:00
|
|
|
pr_debug("get_cur_freq_on_cpu (%d)\n", cpu);
|
2006-10-03 19:29:15 +00:00
|
|
|
|
|
|
|
if (unlikely(data == NULL ||
|
2006-10-03 19:35:23 +00:00
|
|
|
data->acpi_data == NULL || data->freq_table == NULL)) {
|
2006-10-03 19:29:15 +00:00
|
|
|
return 0;
|
2005-04-16 22:20:36 +00:00
|
|
|
}
|
|
|
|
|
2008-04-28 19:13:43 +00:00
|
|
|
cached_freq = data->freq_table[data->acpi_data->state].frequency;
|
2009-01-04 13:18:10 +00:00
|
|
|
freq = extract_freq(get_cur_val(cpumask_of(cpu)), data);
|
2008-04-28 19:13:43 +00:00
|
|
|
if (freq != cached_freq) {
|
|
|
|
/*
|
|
|
|
* The dreaded BIOS frequency change behind our back.
|
|
|
|
* Force set the frequency on next target call.
|
|
|
|
*/
|
|
|
|
data->resume = 1;
|
|
|
|
}
|
|
|
|
|
2011-03-27 13:04:46 +00:00
|
|
|
pr_debug("cur freq = %u\n", freq);
|
2005-04-16 22:20:36 +00:00
|
|
|
|
2006-10-03 19:29:15 +00:00
|
|
|
return freq;
|
2005-04-16 22:20:36 +00:00
|
|
|
}
|
|
|
|
|
2009-01-16 23:31:15 +00:00
|
|
|
static unsigned int check_freqs(const struct cpumask *mask, unsigned int freq,
|
2006-10-03 19:35:23 +00:00
|
|
|
struct acpi_cpufreq_data *data)
|
2006-10-03 19:29:15 +00:00
|
|
|
{
|
2006-10-03 19:35:23 +00:00
|
|
|
unsigned int cur_freq;
|
|
|
|
unsigned int i;
|
2005-04-16 22:20:36 +00:00
|
|
|
|
2009-01-18 03:36:14 +00:00
|
|
|
for (i = 0; i < 100; i++) {
|
2006-10-03 19:29:15 +00:00
|
|
|
cur_freq = extract_freq(get_cur_val(mask), data);
|
|
|
|
if (cur_freq == freq)
|
|
|
|
return 1;
|
|
|
|
udelay(10);
|
|
|
|
}
|
|
|
|
return 0;
|
|
|
|
}
|
|
|
|
|
|
|
|
static int acpi_cpufreq_target(struct cpufreq_policy *policy,
|
2006-10-03 19:35:23 +00:00
|
|
|
unsigned int target_freq, unsigned int relation)
|
2005-04-16 22:20:36 +00:00
|
|
|
{
|
2009-10-29 13:34:13 +00:00
|
|
|
struct acpi_cpufreq_data *data = per_cpu(acfreq_data, policy->cpu);
|
2006-10-03 19:35:23 +00:00
|
|
|
struct acpi_processor_performance *perf;
|
|
|
|
struct cpufreq_freqs freqs;
|
|
|
|
struct drv_cmd cmd;
|
2006-12-19 20:58:55 +00:00
|
|
|
unsigned int next_state = 0; /* Index into freq_table */
|
|
|
|
unsigned int next_perf_state = 0; /* Index into perf table */
|
2006-10-03 19:35:23 +00:00
|
|
|
unsigned int i;
|
|
|
|
int result = 0;
|
2006-10-03 19:29:15 +00:00
|
|
|
|
2011-03-27 13:04:46 +00:00
|
|
|
pr_debug("acpi_cpufreq_target %d (%d)\n", target_freq, policy->cpu);
|
2006-10-03 19:29:15 +00:00
|
|
|
|
|
|
|
if (unlikely(data == NULL ||
|
2006-10-18 04:41:48 +00:00
|
|
|
data->acpi_data == NULL || data->freq_table == NULL)) {
|
2006-10-03 19:29:15 +00:00
|
|
|
return -ENODEV;
|
|
|
|
}
|
2005-04-16 22:20:36 +00:00
|
|
|
|
2006-10-03 19:29:15 +00:00
|
|
|
perf = data->acpi_data;
|
2005-04-16 22:20:36 +00:00
|
|
|
result = cpufreq_frequency_table_target(policy,
|
2006-10-03 19:35:23 +00:00
|
|
|
data->freq_table,
|
|
|
|
target_freq,
|
|
|
|
relation, &next_state);
|
2009-01-04 13:18:08 +00:00
|
|
|
if (unlikely(result)) {
|
|
|
|
result = -ENODEV;
|
|
|
|
goto out;
|
|
|
|
}
|
2005-04-16 22:20:36 +00:00
|
|
|
|
2006-10-03 19:29:15 +00:00
|
|
|
next_perf_state = data->freq_table[next_state].index;
|
2006-10-03 19:36:30 +00:00
|
|
|
if (perf->state == next_perf_state) {
|
2006-10-03 19:29:15 +00:00
|
|
|
if (unlikely(data->resume)) {
|
2011-03-27 13:04:46 +00:00
|
|
|
pr_debug("Called after resume, resetting to P%d\n",
|
2006-10-03 19:35:23 +00:00
|
|
|
next_perf_state);
|
2006-10-03 19:29:15 +00:00
|
|
|
data->resume = 0;
|
|
|
|
} else {
|
2011-03-27 13:04:46 +00:00
|
|
|
pr_debug("Already at target state (P%d)\n",
|
2006-10-03 19:35:23 +00:00
|
|
|
next_perf_state);
|
2009-01-04 13:18:08 +00:00
|
|
|
goto out;
|
2006-10-03 19:29:15 +00:00
|
|
|
}
|
2005-12-14 20:05:00 +00:00
|
|
|
}
|
|
|
|
|
2006-10-03 19:35:23 +00:00
|
|
|
switch (data->cpu_feature) {
|
|
|
|
case SYSTEM_INTEL_MSR_CAPABLE:
|
|
|
|
cmd.type = SYSTEM_INTEL_MSR_CAPABLE;
|
|
|
|
cmd.addr.msr.reg = MSR_IA32_PERF_CTL;
|
2007-05-23 22:42:13 +00:00
|
|
|
cmd.val = (u32) perf->states[next_perf_state].control;
|
2006-10-03 19:35:23 +00:00
|
|
|
break;
|
2012-09-04 08:28:02 +00:00
|
|
|
case SYSTEM_AMD_MSR_CAPABLE:
|
|
|
|
cmd.type = SYSTEM_AMD_MSR_CAPABLE;
|
|
|
|
cmd.addr.msr.reg = MSR_AMD_PERF_CTL;
|
|
|
|
cmd.val = (u32) perf->states[next_perf_state].control;
|
|
|
|
break;
|
2006-10-03 19:35:23 +00:00
|
|
|
case SYSTEM_IO_CAPABLE:
|
|
|
|
cmd.type = SYSTEM_IO_CAPABLE;
|
|
|
|
cmd.addr.io.port = perf->control_register.address;
|
|
|
|
cmd.addr.io.bit_width = perf->control_register.bit_width;
|
|
|
|
cmd.val = (u32) perf->states[next_perf_state].control;
|
|
|
|
break;
|
|
|
|
default:
|
2009-01-04 13:18:08 +00:00
|
|
|
result = -ENODEV;
|
|
|
|
goto out;
|
2006-10-03 19:35:23 +00:00
|
|
|
}
|
2005-12-14 20:05:00 +00:00
|
|
|
|
2009-01-04 13:18:08 +00:00
|
|
|
/* cpufreq holds the hotplug lock, so we are safe from here on */
|
2006-10-03 19:29:15 +00:00
|
|
|
if (policy->shared_type != CPUFREQ_SHARED_TYPE_ANY)
|
2009-01-15 14:46:08 +00:00
|
|
|
cmd.mask = policy->cpus;
|
2006-10-03 19:29:15 +00:00
|
|
|
else
|
2009-01-15 14:46:08 +00:00
|
|
|
cmd.mask = cpumask_of(policy->cpu);
|
2005-12-14 20:05:00 +00:00
|
|
|
|
2006-12-19 20:58:55 +00:00
|
|
|
freqs.old = perf->states[perf->state].core_frequency * 1000;
|
|
|
|
freqs.new = data->freq_table[next_state].frequency;
|
2010-04-20 11:17:35 +00:00
|
|
|
for_each_cpu(i, policy->cpus) {
|
2006-10-03 19:29:15 +00:00
|
|
|
freqs.cpu = i;
|
|
|
|
cpufreq_notify_transition(&freqs, CPUFREQ_PRECHANGE);
|
2005-12-14 20:05:00 +00:00
|
|
|
}
|
2005-04-16 22:20:36 +00:00
|
|
|
|
2006-10-03 19:29:15 +00:00
|
|
|
drv_write(&cmd);
|
2005-12-14 20:05:00 +00:00
|
|
|
|
2006-10-03 19:29:15 +00:00
|
|
|
if (acpi_pstate_strict) {
|
2009-01-04 13:18:08 +00:00
|
|
|
if (!check_freqs(cmd.mask, freqs.new, data)) {
|
2011-03-27 13:04:46 +00:00
|
|
|
pr_debug("acpi_cpufreq_target failed (%d)\n",
|
2006-10-03 19:35:23 +00:00
|
|
|
policy->cpu);
|
2009-01-04 13:18:08 +00:00
|
|
|
result = -EAGAIN;
|
|
|
|
goto out;
|
2005-12-14 20:05:00 +00:00
|
|
|
}
|
|
|
|
}
|
|
|
|
|
2010-04-20 11:17:35 +00:00
|
|
|
for_each_cpu(i, policy->cpus) {
|
2006-10-03 19:29:15 +00:00
|
|
|
freqs.cpu = i;
|
|
|
|
cpufreq_notify_transition(&freqs, CPUFREQ_POSTCHANGE);
|
|
|
|
}
|
|
|
|
perf->state = next_perf_state;
|
|
|
|
|
2009-01-04 13:18:08 +00:00
|
|
|
out:
|
2006-10-03 19:29:15 +00:00
|
|
|
return result;
|
2005-04-16 22:20:36 +00:00
|
|
|
}
|
|
|
|
|
2006-10-03 19:35:23 +00:00
|
|
|
static int acpi_cpufreq_verify(struct cpufreq_policy *policy)
|
2005-04-16 22:20:36 +00:00
|
|
|
{
|
2009-10-29 13:34:13 +00:00
|
|
|
struct acpi_cpufreq_data *data = per_cpu(acfreq_data, policy->cpu);
|
2005-04-16 22:20:36 +00:00
|
|
|
|
2011-03-27 13:04:46 +00:00
|
|
|
pr_debug("acpi_cpufreq_verify\n");
|
2005-04-16 22:20:36 +00:00
|
|
|
|
2006-10-03 19:29:15 +00:00
|
|
|
return cpufreq_frequency_table_verify(policy, data->freq_table);
|
2005-04-16 22:20:36 +00:00
|
|
|
}
|
|
|
|
|
|
|
|
static unsigned long
|
2006-10-03 19:35:23 +00:00
|
|
|
acpi_cpufreq_guess_freq(struct acpi_cpufreq_data *data, unsigned int cpu)
|
2005-04-16 22:20:36 +00:00
|
|
|
{
|
2006-10-03 19:35:23 +00:00
|
|
|
struct acpi_processor_performance *perf = data->acpi_data;
|
2005-12-14 20:05:00 +00:00
|
|
|
|
2005-04-16 22:20:36 +00:00
|
|
|
if (cpu_khz) {
|
|
|
|
/* search the closest match to cpu_khz */
|
|
|
|
unsigned int i;
|
|
|
|
unsigned long freq;
|
2005-12-14 20:05:00 +00:00
|
|
|
unsigned long freqn = perf->states[0].core_frequency * 1000;
|
2005-04-16 22:20:36 +00:00
|
|
|
|
2009-01-18 03:36:14 +00:00
|
|
|
for (i = 0; i < (perf->state_count-1); i++) {
|
2005-04-16 22:20:36 +00:00
|
|
|
freq = freqn;
|
2006-10-18 04:41:48 +00:00
|
|
|
freqn = perf->states[i+1].core_frequency * 1000;
|
2005-04-16 22:20:36 +00:00
|
|
|
if ((2 * cpu_khz) > (freqn + freq)) {
|
2005-12-14 20:05:00 +00:00
|
|
|
perf->state = i;
|
2006-10-03 19:35:23 +00:00
|
|
|
return freq;
|
2005-04-16 22:20:36 +00:00
|
|
|
}
|
|
|
|
}
|
2006-10-18 04:41:48 +00:00
|
|
|
perf->state = perf->state_count-1;
|
2006-10-03 19:35:23 +00:00
|
|
|
return freqn;
|
2005-12-14 20:05:00 +00:00
|
|
|
} else {
|
2005-04-16 22:20:36 +00:00
|
|
|
/* assume CPU is at P0... */
|
2005-12-14 20:05:00 +00:00
|
|
|
perf->state = 0;
|
|
|
|
return perf->states[0].core_frequency * 1000;
|
|
|
|
}
|
2005-04-16 22:20:36 +00:00
|
|
|
}
|
|
|
|
|
2009-01-01 02:08:47 +00:00
|
|
|
static void free_acpi_perf_data(void)
|
|
|
|
{
|
|
|
|
unsigned int i;
|
|
|
|
|
|
|
|
/* Freeing a NULL pointer is OK, and alloc_percpu zeroes. */
|
|
|
|
for_each_possible_cpu(i)
|
|
|
|
free_cpumask_var(per_cpu_ptr(acpi_perf_data, i)
|
|
|
|
->shared_cpu_map);
|
|
|
|
free_percpu(acpi_perf_data);
|
|
|
|
}
|
|
|
|
|
2012-09-04 08:28:07 +00:00
|
|
|
static int boost_notify(struct notifier_block *nb, unsigned long action,
|
|
|
|
void *hcpu)
|
|
|
|
{
|
|
|
|
unsigned cpu = (long)hcpu;
|
|
|
|
const struct cpumask *cpumask;
|
|
|
|
|
|
|
|
cpumask = get_cpu_mask(cpu);
|
|
|
|
|
|
|
|
/*
|
|
|
|
* Clear the boost-disable bit on the CPU_DOWN path so that
|
|
|
|
* this cpu cannot block the remaining ones from boosting. On
|
|
|
|
* the CPU_UP path we simply keep the boost-disable flag in
|
|
|
|
* sync with the current global state.
|
|
|
|
*/
|
|
|
|
|
|
|
|
switch (action) {
|
|
|
|
case CPU_UP_PREPARE:
|
|
|
|
case CPU_UP_PREPARE_FROZEN:
|
|
|
|
boost_set_msrs(boost_enabled, cpumask);
|
|
|
|
break;
|
|
|
|
|
|
|
|
case CPU_DOWN_PREPARE:
|
|
|
|
case CPU_DOWN_PREPARE_FROZEN:
|
|
|
|
boost_set_msrs(1, cpumask);
|
|
|
|
break;
|
|
|
|
|
|
|
|
default:
|
|
|
|
break;
|
|
|
|
}
|
|
|
|
|
|
|
|
return NOTIFY_OK;
|
|
|
|
}
|
|
|
|
|
|
|
|
|
|
|
|
static struct notifier_block boost_nb = {
|
|
|
|
.notifier_call = boost_notify,
|
|
|
|
};
|
|
|
|
|
2005-12-14 20:05:00 +00:00
|
|
|
/*
|
|
|
|
* acpi_cpufreq_early_init - initialize ACPI P-States library
|
|
|
|
*
|
|
|
|
* Initialize the ACPI P-States library (drivers/acpi/processor_perflib.c)
|
|
|
|
* in order to determine correct frequency and voltage pairings. We can
|
|
|
|
* do _PDC and _PSD and find out the processor dependency for the
|
|
|
|
* actual init that will happen later...
|
|
|
|
*/
|
2007-08-07 22:40:30 +00:00
|
|
|
static int __init acpi_cpufreq_early_init(void)
|
2005-12-14 20:05:00 +00:00
|
|
|
{
|
2009-01-01 02:08:47 +00:00
|
|
|
unsigned int i;
|
2011-03-27 13:04:46 +00:00
|
|
|
pr_debug("acpi_cpufreq_early_init\n");
|
2005-12-14 20:05:00 +00:00
|
|
|
|
2007-08-07 22:40:30 +00:00
|
|
|
acpi_perf_data = alloc_percpu(struct acpi_processor_performance);
|
|
|
|
if (!acpi_perf_data) {
|
2011-03-27 13:04:46 +00:00
|
|
|
pr_debug("Memory allocation error for acpi_perf_data.\n");
|
2007-08-07 22:40:30 +00:00
|
|
|
return -ENOMEM;
|
2005-12-14 20:05:00 +00:00
|
|
|
}
|
2009-01-01 02:08:47 +00:00
|
|
|
for_each_possible_cpu(i) {
|
2009-06-06 21:51:36 +00:00
|
|
|
if (!zalloc_cpumask_var_node(
|
2009-01-01 02:08:47 +00:00
|
|
|
&per_cpu_ptr(acpi_perf_data, i)->shared_cpu_map,
|
|
|
|
GFP_KERNEL, cpu_to_node(i))) {
|
2009-01-01 02:08:47 +00:00
|
|
|
|
|
|
|
/* Freeing a NULL pointer is OK: alloc_percpu zeroes. */
|
|
|
|
free_acpi_perf_data();
|
|
|
|
return -ENOMEM;
|
|
|
|
}
|
|
|
|
}
|
2005-12-14 20:05:00 +00:00
|
|
|
|
|
|
|
/* Do initialization in ACPI core */
|
2006-10-03 19:29:15 +00:00
|
|
|
acpi_processor_preregister_performance(acpi_perf_data);
|
|
|
|
return 0;
|
2005-12-14 20:05:00 +00:00
|
|
|
}
|
|
|
|
|
2006-10-21 05:37:39 +00:00
|
|
|
#ifdef CONFIG_SMP
|
2006-09-01 21:02:24 +00:00
|
|
|
/*
|
|
|
|
* Some BIOSes do SW_ANY coordination internally, either set it up in hw
|
|
|
|
* or do it in BIOS firmware and won't inform about it to OS. If not
|
|
|
|
* detected, this has a side effect of making CPU run at a different speed
|
|
|
|
* than OS intended it to run at. Detect it and handle it cleanly.
|
|
|
|
*/
|
|
|
|
static int bios_with_sw_any_bug;
|
|
|
|
|
2007-10-03 19:15:40 +00:00
|
|
|
static int sw_any_bug_found(const struct dmi_system_id *d)
|
2006-09-01 21:02:24 +00:00
|
|
|
{
|
|
|
|
bios_with_sw_any_bug = 1;
|
|
|
|
return 0;
|
|
|
|
}
|
|
|
|
|
2007-10-03 19:15:40 +00:00
|
|
|
static const struct dmi_system_id sw_any_bug_dmi_table[] = {
|
2006-09-01 21:02:24 +00:00
|
|
|
{
|
|
|
|
.callback = sw_any_bug_found,
|
|
|
|
.ident = "Supermicro Server X6DLP",
|
|
|
|
.matches = {
|
|
|
|
DMI_MATCH(DMI_SYS_VENDOR, "Supermicro"),
|
|
|
|
DMI_MATCH(DMI_BIOS_VERSION, "080010"),
|
|
|
|
DMI_MATCH(DMI_PRODUCT_NAME, "X6DLP"),
|
|
|
|
},
|
|
|
|
},
|
|
|
|
{ }
|
|
|
|
};
|
2009-08-26 17:19:37 +00:00
|
|
|
|
|
|
|
static int acpi_cpufreq_blacklist(struct cpuinfo_x86 *c)
|
|
|
|
{
|
2009-09-25 17:30:08 +00:00
|
|
|
/* Intel Xeon Processor 7100 Series Specification Update
|
|
|
|
* http://www.intel.com/Assets/PDF/specupdate/314554.pdf
|
2009-08-26 17:19:37 +00:00
|
|
|
* AL30: A Machine Check Exception (MCE) Occurring during an
|
|
|
|
* Enhanced Intel SpeedStep Technology Ratio Change May Cause
|
2009-09-25 17:30:08 +00:00
|
|
|
* Both Processor Cores to Lock Up. */
|
2009-08-26 17:19:37 +00:00
|
|
|
if (c->x86_vendor == X86_VENDOR_INTEL) {
|
|
|
|
if ((c->x86 == 15) &&
|
|
|
|
(c->x86_model == 6) &&
|
2009-09-25 17:30:08 +00:00
|
|
|
(c->x86_mask == 8)) {
|
|
|
|
printk(KERN_INFO "acpi-cpufreq: Intel(R) "
|
|
|
|
"Xeon(R) 7100 Errata AL30, processors may "
|
|
|
|
"lock up on frequency changes: disabling "
|
|
|
|
"acpi-cpufreq.\n");
|
2009-08-26 17:19:37 +00:00
|
|
|
return -ENODEV;
|
2009-09-25 17:30:08 +00:00
|
|
|
}
|
2009-08-26 17:19:37 +00:00
|
|
|
}
|
|
|
|
return 0;
|
|
|
|
}
|
2006-10-21 05:37:39 +00:00
|
|
|
#endif
|
2006-09-01 21:02:24 +00:00
|
|
|
|
2006-10-03 19:35:23 +00:00
|
|
|
static int acpi_cpufreq_cpu_init(struct cpufreq_policy *policy)
|
2005-04-16 22:20:36 +00:00
|
|
|
{
|
2006-10-03 19:35:23 +00:00
|
|
|
unsigned int i;
|
|
|
|
unsigned int valid_states = 0;
|
|
|
|
unsigned int cpu = policy->cpu;
|
|
|
|
struct acpi_cpufreq_data *data;
|
|
|
|
unsigned int result = 0;
|
2007-10-19 18:35:04 +00:00
|
|
|
struct cpuinfo_x86 *c = &cpu_data(policy->cpu);
|
2006-10-03 19:35:23 +00:00
|
|
|
struct acpi_processor_performance *perf;
|
2009-09-25 17:30:08 +00:00
|
|
|
#ifdef CONFIG_SMP
|
|
|
|
static int blacklisted;
|
|
|
|
#endif
|
2005-04-16 22:20:36 +00:00
|
|
|
|
2011-03-27 13:04:46 +00:00
|
|
|
pr_debug("acpi_cpufreq_cpu_init\n");
|
2005-04-16 22:20:36 +00:00
|
|
|
|
2009-08-26 17:19:37 +00:00
|
|
|
#ifdef CONFIG_SMP
|
2009-09-25 17:30:08 +00:00
|
|
|
if (blacklisted)
|
|
|
|
return blacklisted;
|
|
|
|
blacklisted = acpi_cpufreq_blacklist(c);
|
|
|
|
if (blacklisted)
|
|
|
|
return blacklisted;
|
2009-08-26 17:19:37 +00:00
|
|
|
#endif
|
|
|
|
|
2006-10-03 19:29:15 +00:00
|
|
|
data = kzalloc(sizeof(struct acpi_cpufreq_data), GFP_KERNEL);
|
2005-04-16 22:20:36 +00:00
|
|
|
if (!data)
|
2006-10-03 19:35:23 +00:00
|
|
|
return -ENOMEM;
|
2005-04-16 22:20:36 +00:00
|
|
|
|
2009-02-20 07:29:08 +00:00
|
|
|
data->acpi_data = per_cpu_ptr(acpi_perf_data, cpu);
|
2009-10-29 13:34:13 +00:00
|
|
|
per_cpu(acfreq_data, cpu) = data;
|
2005-04-16 22:20:36 +00:00
|
|
|
|
2006-10-18 04:41:48 +00:00
|
|
|
if (cpu_has(c, X86_FEATURE_CONSTANT_TSC))
|
2006-10-03 19:29:15 +00:00
|
|
|
acpi_cpufreq_driver.flags |= CPUFREQ_CONST_LOOPS;
|
2005-04-16 22:20:36 +00:00
|
|
|
|
2006-10-03 19:29:15 +00:00
|
|
|
result = acpi_processor_register_performance(data->acpi_data, cpu);
|
2005-04-16 22:20:36 +00:00
|
|
|
if (result)
|
|
|
|
goto err_free;
|
|
|
|
|
2005-12-14 20:05:00 +00:00
|
|
|
perf = data->acpi_data;
|
|
|
|
policy->shared_type = perf->shared_type;
|
2006-10-18 04:41:48 +00:00
|
|
|
|
2006-06-26 04:34:43 +00:00
|
|
|
/*
|
2006-10-18 04:41:48 +00:00
|
|
|
* Will let policy->cpus know about dependency only when software
|
2006-06-26 04:34:43 +00:00
|
|
|
* coordination is required.
|
|
|
|
*/
|
|
|
|
if (policy->shared_type == CPUFREQ_SHARED_TYPE_ALL ||
|
2006-09-01 21:02:24 +00:00
|
|
|
policy->shared_type == CPUFREQ_SHARED_TYPE_ANY) {
|
2009-01-04 13:18:06 +00:00
|
|
|
cpumask_copy(policy->cpus, perf->shared_cpu_map);
|
2006-09-01 21:02:24 +00:00
|
|
|
}
|
2009-01-04 13:18:06 +00:00
|
|
|
cpumask_copy(policy->related_cpus, perf->shared_cpu_map);
|
2006-09-01 21:02:24 +00:00
|
|
|
|
|
|
|
#ifdef CONFIG_SMP
|
|
|
|
dmi_check_system(sw_any_bug_dmi_table);
|
2009-01-04 13:18:06 +00:00
|
|
|
if (bios_with_sw_any_bug && cpumask_weight(policy->cpus) == 1) {
|
2006-09-01 21:02:24 +00:00
|
|
|
policy->shared_type = CPUFREQ_SHARED_TYPE_ALL;
|
2009-01-04 13:18:06 +00:00
|
|
|
cpumask_copy(policy->cpus, cpu_core_mask(cpu));
|
2006-09-01 21:02:24 +00:00
|
|
|
}
|
2012-09-04 08:28:03 +00:00
|
|
|
|
|
|
|
if (check_amd_hwpstate_cpu(cpu) && !acpi_pstate_strict) {
|
|
|
|
cpumask_clear(policy->cpus);
|
|
|
|
cpumask_set_cpu(cpu, policy->cpus);
|
|
|
|
cpumask_copy(policy->related_cpus, cpu_sibling_mask(cpu));
|
|
|
|
policy->shared_type = CPUFREQ_SHARED_TYPE_HW;
|
|
|
|
pr_info_once(PFX "overriding BIOS provided _PSD data\n");
|
|
|
|
}
|
2006-09-01 21:02:24 +00:00
|
|
|
#endif
|
2005-12-14 20:05:00 +00:00
|
|
|
|
2005-04-16 22:20:36 +00:00
|
|
|
/* capability check */
|
2005-12-14 20:05:00 +00:00
|
|
|
if (perf->state_count <= 1) {
|
2011-03-27 13:04:46 +00:00
|
|
|
pr_debug("No P-States\n");
|
2005-04-16 22:20:36 +00:00
|
|
|
result = -ENODEV;
|
|
|
|
goto err_unreg;
|
|
|
|
}
|
2005-12-14 20:05:00 +00:00
|
|
|
|
2006-10-03 19:29:15 +00:00
|
|
|
if (perf->control_register.space_id != perf->status_register.space_id) {
|
|
|
|
result = -ENODEV;
|
|
|
|
goto err_unreg;
|
|
|
|
}
|
|
|
|
|
|
|
|
switch (perf->control_register.space_id) {
|
2006-10-03 19:35:23 +00:00
|
|
|
case ACPI_ADR_SPACE_SYSTEM_IO:
|
2011-03-27 13:04:46 +00:00
|
|
|
pr_debug("SYSTEM IO addr space\n");
|
2006-10-03 19:33:14 +00:00
|
|
|
data->cpu_feature = SYSTEM_IO_CAPABLE;
|
|
|
|
break;
|
2006-10-03 19:35:23 +00:00
|
|
|
case ACPI_ADR_SPACE_FIXED_HARDWARE:
|
2011-03-27 13:04:46 +00:00
|
|
|
pr_debug("HARDWARE addr space\n");
|
2012-09-04 08:28:02 +00:00
|
|
|
if (check_est_cpu(cpu)) {
|
|
|
|
data->cpu_feature = SYSTEM_INTEL_MSR_CAPABLE;
|
|
|
|
break;
|
2006-10-03 19:33:14 +00:00
|
|
|
}
|
2012-09-04 08:28:02 +00:00
|
|
|
if (check_amd_hwpstate_cpu(cpu)) {
|
|
|
|
data->cpu_feature = SYSTEM_AMD_MSR_CAPABLE;
|
|
|
|
break;
|
|
|
|
}
|
|
|
|
result = -ENODEV;
|
|
|
|
goto err_unreg;
|
2006-10-03 19:35:23 +00:00
|
|
|
default:
|
2011-03-27 13:04:46 +00:00
|
|
|
pr_debug("Unknown addr space %d\n",
|
2006-10-03 19:35:23 +00:00
|
|
|
(u32) (perf->control_register.space_id));
|
2005-04-16 22:20:36 +00:00
|
|
|
result = -ENODEV;
|
|
|
|
goto err_unreg;
|
|
|
|
}
|
|
|
|
|
2006-10-18 04:41:48 +00:00
|
|
|
data->freq_table = kmalloc(sizeof(struct cpufreq_frequency_table) *
|
|
|
|
(perf->state_count+1), GFP_KERNEL);
|
2005-04-16 22:20:36 +00:00
|
|
|
if (!data->freq_table) {
|
|
|
|
result = -ENOMEM;
|
|
|
|
goto err_unreg;
|
|
|
|
}
|
|
|
|
|
|
|
|
/* detect transition latency */
|
|
|
|
policy->cpuinfo.transition_latency = 0;
|
2009-01-18 03:36:14 +00:00
|
|
|
for (i = 0; i < perf->state_count; i++) {
|
2006-10-03 19:35:23 +00:00
|
|
|
if ((perf->states[i].transition_latency * 1000) >
|
|
|
|
policy->cpuinfo.transition_latency)
|
|
|
|
policy->cpuinfo.transition_latency =
|
|
|
|
perf->states[i].transition_latency * 1000;
|
2005-04-16 22:20:36 +00:00
|
|
|
}
|
|
|
|
|
2009-03-19 21:41:40 +00:00
|
|
|
/* Check for high latency (>20uS) from buggy BIOSes, like on T42 */
|
|
|
|
if (perf->control_register.space_id == ACPI_ADR_SPACE_FIXED_HARDWARE &&
|
|
|
|
policy->cpuinfo.transition_latency > 20 * 1000) {
|
|
|
|
policy->cpuinfo.transition_latency = 20 * 1000;
|
2009-05-26 21:58:39 +00:00
|
|
|
printk_once(KERN_INFO
|
|
|
|
"P-state transition latency capped at 20 uS\n");
|
2009-03-19 21:41:40 +00:00
|
|
|
}
|
|
|
|
|
2005-04-16 22:20:36 +00:00
|
|
|
/* table init */
|
2009-01-18 03:36:14 +00:00
|
|
|
for (i = 0; i < perf->state_count; i++) {
|
|
|
|
if (i > 0 && perf->states[i].core_frequency >=
|
2007-06-14 01:24:02 +00:00
|
|
|
data->freq_table[valid_states-1].frequency / 1000)
|
2006-10-03 19:29:15 +00:00
|
|
|
continue;
|
|
|
|
|
|
|
|
data->freq_table[valid_states].index = i;
|
|
|
|
data->freq_table[valid_states].frequency =
|
2006-10-03 19:35:23 +00:00
|
|
|
perf->states[i].core_frequency * 1000;
|
2006-10-03 19:29:15 +00:00
|
|
|
valid_states++;
|
2005-04-16 22:20:36 +00:00
|
|
|
}
|
2006-11-14 01:47:44 +00:00
|
|
|
data->freq_table[valid_states].frequency = CPUFREQ_TABLE_END;
|
2006-12-19 20:58:55 +00:00
|
|
|
perf->state = 0;
|
2005-04-16 22:20:36 +00:00
|
|
|
|
|
|
|
result = cpufreq_frequency_table_cpuinfo(policy, data->freq_table);
|
2006-10-18 04:41:48 +00:00
|
|
|
if (result)
|
2005-04-16 22:20:36 +00:00
|
|
|
goto err_freqfree;
|
|
|
|
|
2009-04-17 14:22:08 +00:00
|
|
|
if (perf->states[0].core_frequency * 1000 != policy->cpuinfo.max_freq)
|
|
|
|
printk(KERN_WARNING FW_WARN "P-state 0 is not max freq\n");
|
|
|
|
|
2006-12-15 18:52:45 +00:00
|
|
|
switch (perf->control_register.space_id) {
|
2006-10-03 19:35:23 +00:00
|
|
|
case ACPI_ADR_SPACE_SYSTEM_IO:
|
2006-10-03 19:33:14 +00:00
|
|
|
/* Current speed is unknown and not detectable by IO port */
|
|
|
|
policy->cur = acpi_cpufreq_guess_freq(data, policy->cpu);
|
|
|
|
break;
|
2006-10-03 19:35:23 +00:00
|
|
|
case ACPI_ADR_SPACE_FIXED_HARDWARE:
|
2006-10-03 19:36:30 +00:00
|
|
|
acpi_cpufreq_driver.get = get_cur_freq_on_cpu;
|
2006-12-15 18:52:45 +00:00
|
|
|
policy->cur = get_cur_freq_on_cpu(cpu);
|
2006-10-03 19:33:14 +00:00
|
|
|
break;
|
2006-10-03 19:35:23 +00:00
|
|
|
default:
|
2006-10-03 19:33:14 +00:00
|
|
|
break;
|
|
|
|
}
|
|
|
|
|
2005-04-16 22:20:36 +00:00
|
|
|
/* notify BIOS that we exist */
|
|
|
|
acpi_processor_notify_smm(THIS_MODULE);
|
|
|
|
|
2006-10-03 19:38:45 +00:00
|
|
|
/* Check for APERF/MPERF support in hardware */
|
2011-07-13 21:58:32 +00:00
|
|
|
if (boot_cpu_has(X86_FEATURE_APERFMPERF))
|
2010-03-18 17:41:46 +00:00
|
|
|
acpi_cpufreq_driver.getavg = cpufreq_get_measured_perf;
|
2006-10-03 19:38:45 +00:00
|
|
|
|
2011-03-27 13:04:46 +00:00
|
|
|
pr_debug("CPU%u - ACPI performance management activated.\n", cpu);
|
2005-12-14 20:05:00 +00:00
|
|
|
for (i = 0; i < perf->state_count; i++)
|
2011-03-27 13:04:46 +00:00
|
|
|
pr_debug(" %cP%d: %d MHz, %d mW, %d uS\n",
|
2006-10-03 19:35:23 +00:00
|
|
|
(i == perf->state ? '*' : ' '), i,
|
2005-12-14 20:05:00 +00:00
|
|
|
(u32) perf->states[i].core_frequency,
|
|
|
|
(u32) perf->states[i].power,
|
|
|
|
(u32) perf->states[i].transition_latency);
|
2005-04-16 22:20:36 +00:00
|
|
|
|
|
|
|
cpufreq_frequency_table_get_attr(data->freq_table, policy->cpu);
|
2006-10-03 19:35:23 +00:00
|
|
|
|
2005-05-18 17:49:00 +00:00
|
|
|
/*
|
|
|
|
* the first call to ->target() should result in us actually
|
|
|
|
* writing something to the appropriate registers.
|
|
|
|
*/
|
|
|
|
data->resume = 1;
|
2006-10-03 19:35:23 +00:00
|
|
|
|
2006-10-03 19:29:15 +00:00
|
|
|
return result;
|
2005-04-16 22:20:36 +00:00
|
|
|
|
2006-10-18 04:41:48 +00:00
|
|
|
err_freqfree:
|
2005-04-16 22:20:36 +00:00
|
|
|
kfree(data->freq_table);
|
2006-10-18 04:41:48 +00:00
|
|
|
err_unreg:
|
2005-12-14 20:05:00 +00:00
|
|
|
acpi_processor_unregister_performance(perf, cpu);
|
2006-10-18 04:41:48 +00:00
|
|
|
err_free:
|
2005-04-16 22:20:36 +00:00
|
|
|
kfree(data);
|
2009-10-29 13:34:13 +00:00
|
|
|
per_cpu(acfreq_data, cpu) = NULL;
|
2005-04-16 22:20:36 +00:00
|
|
|
|
2006-10-03 19:35:23 +00:00
|
|
|
return result;
|
2005-04-16 22:20:36 +00:00
|
|
|
}
|
|
|
|
|
2006-10-03 19:35:23 +00:00
|
|
|
static int acpi_cpufreq_cpu_exit(struct cpufreq_policy *policy)
|
2005-04-16 22:20:36 +00:00
|
|
|
{
|
2009-10-29 13:34:13 +00:00
|
|
|
struct acpi_cpufreq_data *data = per_cpu(acfreq_data, policy->cpu);
|
2005-04-16 22:20:36 +00:00
|
|
|
|
2011-03-27 13:04:46 +00:00
|
|
|
pr_debug("acpi_cpufreq_cpu_exit\n");
|
2005-04-16 22:20:36 +00:00
|
|
|
|
|
|
|
if (data) {
|
|
|
|
cpufreq_frequency_table_put_attr(policy->cpu);
|
2009-10-29 13:34:13 +00:00
|
|
|
per_cpu(acfreq_data, policy->cpu) = NULL;
|
2006-10-03 19:35:23 +00:00
|
|
|
acpi_processor_unregister_performance(data->acpi_data,
|
|
|
|
policy->cpu);
|
2010-10-12 01:09:37 +00:00
|
|
|
kfree(data->freq_table);
|
2005-04-16 22:20:36 +00:00
|
|
|
kfree(data);
|
|
|
|
}
|
|
|
|
|
2006-10-03 19:35:23 +00:00
|
|
|
return 0;
|
2005-04-16 22:20:36 +00:00
|
|
|
}
|
|
|
|
|
2006-10-03 19:35:23 +00:00
|
|
|
static int acpi_cpufreq_resume(struct cpufreq_policy *policy)
|
2005-04-16 22:20:36 +00:00
|
|
|
{
|
2009-10-29 13:34:13 +00:00
|
|
|
struct acpi_cpufreq_data *data = per_cpu(acfreq_data, policy->cpu);
|
2005-04-16 22:20:36 +00:00
|
|
|
|
2011-03-27 13:04:46 +00:00
|
|
|
pr_debug("acpi_cpufreq_resume\n");
|
2005-04-16 22:20:36 +00:00
|
|
|
|
|
|
|
data->resume = 1;
|
|
|
|
|
2006-10-03 19:35:23 +00:00
|
|
|
return 0;
|
2005-04-16 22:20:36 +00:00
|
|
|
}
|
|
|
|
|
2006-10-03 19:35:23 +00:00
|
|
|
static struct freq_attr *acpi_cpufreq_attr[] = {
|
2005-04-16 22:20:36 +00:00
|
|
|
&cpufreq_freq_attr_scaling_available_freqs,
|
2012-09-04 08:28:08 +00:00
|
|
|
NULL, /* this is a placeholder for cpb, do not remove */
|
2005-04-16 22:20:36 +00:00
|
|
|
NULL,
|
|
|
|
};
|
|
|
|
|
|
|
|
static struct cpufreq_driver acpi_cpufreq_driver = {
|
2009-11-19 11:31:01 +00:00
|
|
|
.verify = acpi_cpufreq_verify,
|
|
|
|
.target = acpi_cpufreq_target,
|
|
|
|
.bios_limit = acpi_processor_get_bios_limit,
|
|
|
|
.init = acpi_cpufreq_cpu_init,
|
|
|
|
.exit = acpi_cpufreq_cpu_exit,
|
|
|
|
.resume = acpi_cpufreq_resume,
|
|
|
|
.name = "acpi-cpufreq",
|
|
|
|
.owner = THIS_MODULE,
|
|
|
|
.attr = acpi_cpufreq_attr,
|
2005-04-16 22:20:36 +00:00
|
|
|
};
|
|
|
|
|
2012-09-04 08:28:07 +00:00
|
|
|
static void __init acpi_cpufreq_boost_init(void)
|
|
|
|
{
|
|
|
|
if (boot_cpu_has(X86_FEATURE_CPB) || boot_cpu_has(X86_FEATURE_IDA)) {
|
|
|
|
msrs = msrs_alloc();
|
|
|
|
|
|
|
|
if (!msrs)
|
|
|
|
return;
|
|
|
|
|
|
|
|
boost_supported = true;
|
|
|
|
boost_enabled = boost_state(0);
|
|
|
|
|
|
|
|
get_online_cpus();
|
|
|
|
|
|
|
|
/* Force all MSRs to the same value */
|
|
|
|
boost_set_msrs(boost_enabled, cpu_online_mask);
|
|
|
|
|
|
|
|
register_cpu_notifier(&boost_nb);
|
|
|
|
|
|
|
|
put_online_cpus();
|
|
|
|
} else
|
|
|
|
global_boost.attr.mode = 0444;
|
|
|
|
|
|
|
|
/* We create the boost file in any case, though for systems without
|
|
|
|
* hardware support it will be read-only and hardwired to return 0.
|
|
|
|
*/
|
|
|
|
if (sysfs_create_file(cpufreq_global_kobject, &(global_boost.attr)))
|
|
|
|
pr_warn(PFX "could not register global boost sysfs file\n");
|
|
|
|
else
|
|
|
|
pr_debug("registered global boost sysfs file\n");
|
|
|
|
}
|
|
|
|
|
|
|
|
static void __exit acpi_cpufreq_boost_exit(void)
|
|
|
|
{
|
|
|
|
sysfs_remove_file(cpufreq_global_kobject, &(global_boost.attr));
|
|
|
|
|
|
|
|
if (msrs) {
|
|
|
|
unregister_cpu_notifier(&boost_nb);
|
|
|
|
|
|
|
|
msrs_free(msrs);
|
|
|
|
msrs = NULL;
|
|
|
|
}
|
|
|
|
}
|
|
|
|
|
2006-10-03 19:35:23 +00:00
|
|
|
static int __init acpi_cpufreq_init(void)
|
2005-04-16 22:20:36 +00:00
|
|
|
{
|
2007-08-07 22:40:30 +00:00
|
|
|
int ret;
|
|
|
|
|
2008-09-25 02:04:31 +00:00
|
|
|
if (acpi_disabled)
|
|
|
|
return 0;
|
|
|
|
|
2011-03-27 13:04:46 +00:00
|
|
|
pr_debug("acpi_cpufreq_init\n");
|
2005-04-16 22:20:36 +00:00
|
|
|
|
2007-08-07 22:40:30 +00:00
|
|
|
ret = acpi_cpufreq_early_init();
|
|
|
|
if (ret)
|
|
|
|
return ret;
|
2005-12-14 20:05:00 +00:00
|
|
|
|
2012-09-04 08:28:08 +00:00
|
|
|
#ifdef CONFIG_X86_ACPI_CPUFREQ_CPB
|
|
|
|
/* this is a sysfs file with a strange name and an even stranger
|
|
|
|
* semantic - per CPU instantiation, but system global effect.
|
|
|
|
* Lets enable it only on AMD CPUs for compatibility reasons and
|
|
|
|
* only if configured. This is considered legacy code, which
|
|
|
|
* will probably be removed at some point in the future.
|
|
|
|
*/
|
|
|
|
if (check_amd_hwpstate_cpu(0)) {
|
|
|
|
struct freq_attr **iter;
|
|
|
|
|
|
|
|
pr_debug("adding sysfs entry for cpb\n");
|
|
|
|
|
|
|
|
for (iter = acpi_cpufreq_attr; *iter != NULL; iter++)
|
|
|
|
;
|
|
|
|
|
|
|
|
/* make sure there is a terminator behind it */
|
|
|
|
if (iter[1] == NULL)
|
|
|
|
*iter = &cpb;
|
|
|
|
}
|
|
|
|
#endif
|
|
|
|
|
2008-07-14 02:59:44 +00:00
|
|
|
ret = cpufreq_register_driver(&acpi_cpufreq_driver);
|
|
|
|
if (ret)
|
2009-01-01 02:08:47 +00:00
|
|
|
free_acpi_perf_data();
|
2012-09-04 08:28:07 +00:00
|
|
|
else
|
|
|
|
acpi_cpufreq_boost_init();
|
2008-07-14 02:59:44 +00:00
|
|
|
|
|
|
|
return ret;
|
2005-04-16 22:20:36 +00:00
|
|
|
}
|
|
|
|
|
2006-10-03 19:35:23 +00:00
|
|
|
static void __exit acpi_cpufreq_exit(void)
|
2005-04-16 22:20:36 +00:00
|
|
|
{
|
2011-03-27 13:04:46 +00:00
|
|
|
pr_debug("acpi_cpufreq_exit\n");
|
2005-04-16 22:20:36 +00:00
|
|
|
|
2012-09-04 08:28:07 +00:00
|
|
|
acpi_cpufreq_boost_exit();
|
|
|
|
|
2005-04-16 22:20:36 +00:00
|
|
|
cpufreq_unregister_driver(&acpi_cpufreq_driver);
|
|
|
|
|
2011-07-08 20:37:44 +00:00
|
|
|
free_acpi_perf_data();
|
2005-04-16 22:20:36 +00:00
|
|
|
}
|
|
|
|
|
2005-08-25 19:59:00 +00:00
|
|
|
module_param(acpi_pstate_strict, uint, 0644);
|
2006-10-03 19:35:23 +00:00
|
|
|
MODULE_PARM_DESC(acpi_pstate_strict,
|
2006-10-18 04:41:48 +00:00
|
|
|
"value 0 or non-zero. non-zero -> strict ACPI checks are "
|
|
|
|
"performed during frequency changes.");
|
2005-04-16 22:20:36 +00:00
|
|
|
|
|
|
|
late_initcall(acpi_cpufreq_init);
|
|
|
|
module_exit(acpi_cpufreq_exit);
|
|
|
|
|
|
|
|
MODULE_ALIAS("acpi");
|