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
21 POWER MANAGEMENT TESTS AUTOMATION SUITE
22 ----------------------------------------
23 The tests requires the Kernel to be compiled with the following config's
24
25 for CPU FREQUENCY tests:
26
27 CONFIG_CPU_FREQ
28 CONFIG_CPU_FREQ_TABLE
29 CONFIG_CPU_FREQ_DEBUG
30 CONFIG_CPU_FREQ_STAT
31 CONFIG_CPU_FREQ_STAT_DETAILS
32 CONFIG_CPU_FREQ_DEFAULT_GOV_*
33 CONFIG_CPU_FREQ_GOV_*
34
35 for CPU IDLE tests:
36
37 CONFIG_CPU_IDLE
38 CONFIG_CPU_IDLE_GOV_LADDER
39 CONFIG_CPU_IDLE_GOV_MENU
40
41 for SCHED_MC tests:
42
43 CONFIG_SCHED_MC
44
45 The power management test automation suite helps run the power management functionality
46 (e.g: cpu frequency, cpu idle etc..) tests and report results.
47
48 Test Scripts for CPU FREQUENCY:
49 change_freq.sh
50 change_govr.sh
51 check_cpufreq_sysfs_files.sh
52
53 Test Scripts for CPU IDLE:
54 will be added soon
55
56 Test Scripts for SCHED_MC:
57 test_sched_mc.sh
58
59 Common functionality:
60 pm_include.sh
61 check_kv_arch.c
62 pwkm_load_unload.sh
63
64 To run your tests you can execute the runpwtests.sh
65
66 To run the tests individually :
67
68 P.S. As of now the supporting architecture(s) are x86,x86_64
69
70 Support of system:
71 -----------------
72 If you see some thing like following,
73
74 Power Management 1 FAIL : Required kernel configuration for SCHED_MC NOT set
75 or
76 Power Management 1 FAIL : Required kernel configuration for CPU_FREQ NOT set
77
78 Then either configuration is not set or the system won't support.
79
80 For CPU consolidation verification ebizzy is included in utils directory of LTP.
81 To run cpu consolidation test user has to provide -w <workload> -l <sched_mc_level>.
82 Refer to README in LTPROOT/utils/benchmark/ebizzy-0.2 directory for details of ebizzy.
83
84 To 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.
85 CPU 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
87 Timer 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