README
1################################################################################
2## ##
3## Copyright (c) International Business Machines Corp., 2007 ##
4## ##
5## This program is free software; you can redistribute it and#or modify ##
6## it under the terms of the GNU General Public License as published by ##
7## the Free Software Foundation; either version 2 of the License, or ##
8## (at your option) any later version. ##
9## ##
10## This program is distributed in the hope that it will be useful, but ##
11## WITHOUT ANY WARRANTY; without even the implied warranty of MERCHANTABILITY ##
12## or FITNESS FOR A PARTICULAR PURPOSE. See the GNU General Public License ##
13## for more details. ##
14## ##
15## You should have received a copy of the GNU General Public License ##
16## along with this program; if not, write to the Free Software ##
17## Foundation, Inc., 51 Franklin Street, Fifth Floor, Boston, MA 02110-1301 USA ##
18## ##
19################################################################################
20
21POWER MANAGEMENT TESTS AUTOMATION SUITE
22----------------------------------------
23The tests requires the Kernel to be compiled with the following config's
24
25for CPU FREQUENCY tests:
26
27CONFIG_CPU_FREQ
28CONFIG_CPU_FREQ_TABLE
29CONFIG_CPU_FREQ_DEBUG
30CONFIG_CPU_FREQ_STAT
31CONFIG_CPU_FREQ_STAT_DETAILS
32CONFIG_CPU_FREQ_DEFAULT_GOV_*
33CONFIG_CPU_FREQ_GOV_*
34
35for CPU IDLE tests:
36
37CONFIG_CPU_IDLE
38CONFIG_CPU_IDLE_GOV_LADDER
39CONFIG_CPU_IDLE_GOV_MENU
40
41for SCHED_MC tests:
42
43CONFIG_SCHED_MC
44
45The power management test automation suite helps run the power management functionality
46(e.g: cpu frequency, cpu idle etc..) tests and report results.
47
48Test Scripts for CPU FREQUENCY:
49change_freq.sh
50change_govr.sh
51check_cpufreq_sysfs_files.sh
52
53Test Scripts for CPU IDLE:
54will be added soon
55
56Test Scripts for SCHED_MC:
57test_sched_mc.sh
58
59Common functionality:
60pm_include.sh
61check_kv_arch.c
62pwkm_load_unload.sh
63
64To run your tests you can execute the runpwtests.sh
65
66To run the tests individually :
67
68P.S. As of now the supporting architecture(s) are x86,x86_64
69
70Support of system:
71-----------------
72If you see some thing like following,
73
74Power Management 1 FAIL : Required kernel configuration for SCHED_MC NOT set
75or
76Power Management 1 FAIL : Required kernel configuration for CPU_FREQ NOT set
77
78Then either configuration is not set or the system won't support.
79
80For CPU consolidation verification ebizzy is included in utils directory of LTP.
81To run cpu consolidation test user has to provide -w <workload> -l <sched_mc_level>.
82Refer to README in LTPROOT/utils/benchmark/ebizzy-0.2 directory for details of ebizzy.
83
84To test CPU consolidation for sched_mc 2 kernbench has to run. Kernbench needs linux kernel source as input in /root directory . For example download from http://www.kernel.org/pub/linux/kernel/v2.6/linux-2.6.29.4.tar.bz2. If Linux kernel source not found kernbench wiil not execute.
85CPU consolidation testcases will not execute if number of CPU's in package is less then 2. If system is hyper threaded but number of CPU is 1 only sched_smt testcases will be excuted. For better coverage of testcases select a system which is atleast quad core and then hyper threaded so that you will observe 8 CPU's in each package.
86
87Timer migration interface test will execute on kernel versions 2.6.31 and above. Timer migration functionality verification testcases will be executed only on suitable architecture like quad core or the number of CPU's in each package should be atleast 4 and above
88