xref: /aosp_15_r20/external/ltp/testcases/kernel/controllers/README (revision 49cdfc7efb34551c7342be41a7384b9c40d7cab7)
1*49cdfc7eSAndroid Build Coastguard WorkerThe complete dir tree is for testcases for resource management testing of linux kernel.
2*49cdfc7eSAndroid Build Coastguard WorkerFor the test plan please refer to the file testplan.txt
3*49cdfc7eSAndroid Build Coastguard Worker
4*49cdfc7eSAndroid Build Coastguard Worker--------------
5*49cdfc7eSAndroid Build Coastguard Worker***WARNING:***
6*49cdfc7eSAndroid Build Coastguard Worker--------------
7*49cdfc7eSAndroid Build Coastguard WorkerThe cpu controller test creates the cpu controller device as /dev/cpuctl. In
8*49cdfc7eSAndroid Build Coastguard Workercase you already have /dev/cpuctl it may be overwritten. So please rename it
9*49cdfc7eSAndroid Build Coastguard Workerto have a backup of your file.
10*49cdfc7eSAndroid Build Coastguard Worker
11*49cdfc7eSAndroid Build Coastguard WorkerThe cpuset controller also creates the device as /dev/cpuset, so please do the
12*49cdfc7eSAndroid Build Coastguard Workersimilar work as above.
13*49cdfc7eSAndroid Build Coastguard Worker
14*49cdfc7eSAndroid Build Coastguard Worker
15*49cdfc7eSAndroid Build Coastguard WorkerFILES DESCRIPTION:
16*49cdfc7eSAndroid Build Coastguard Worker
17*49cdfc7eSAndroid Build Coastguard Workertestplan.txt
18*49cdfc7eSAndroid Build Coastguard Worker------------
19*49cdfc7eSAndroid Build Coastguard WorkerA brief description of the plan for resource management testing.
20*49cdfc7eSAndroid Build Coastguard Worker
21*49cdfc7eSAndroid Build Coastguard Workertest_controllers.sh
22*49cdfc7eSAndroid Build Coastguard Worker-------------------
23*49cdfc7eSAndroid Build Coastguard WorkerThis is the main script file that starts the test. It first checks if the
24*49cdfc7eSAndroid Build Coastguard Workercontrollers are enabled. If not enabled then it will not run the test and
25*49cdfc7eSAndroid Build Coastguard Workerwill exit giving warning.
26*49cdfc7eSAndroid Build Coastguard Worker
27*49cdfc7eSAndroid Build Coastguard WorkerREADME
28*49cdfc7eSAndroid Build Coastguard Worker------
29*49cdfc7eSAndroid Build Coastguard WorkerThis file.
30*49cdfc7eSAndroid Build Coastguard Worker
31*49cdfc7eSAndroid Build Coastguard Workercgroup
32*49cdfc7eSAndroid Build Coastguard Worker------
33*49cdfc7eSAndroid Build Coastguard WorkerDirectory containing the cgroup regression testcases.
34*49cdfc7eSAndroid Build Coastguard Worker
35*49cdfc7eSAndroid Build Coastguard Workercpuctl
36*49cdfc7eSAndroid Build Coastguard Worker------
37*49cdfc7eSAndroid Build Coastguard WorkerDirectory containing the cpu controller testcases. A similar directory will
38*49cdfc7eSAndroid Build Coastguard Workerbe created for any new controller.
39*49cdfc7eSAndroid Build Coastguard Worker
40*49cdfc7eSAndroid Build Coastguard Workermemctl
41*49cdfc7eSAndroid Build Coastguard Worker------
42*49cdfc7eSAndroid Build Coastguard WorkerDirectory containing the memory controller testcases. A similar directory will
43*49cdfc7eSAndroid Build Coastguard Workerbe created for any new controller.
44*49cdfc7eSAndroid Build Coastguard Worker
45*49cdfc7eSAndroid Build Coastguard Workercpuset
46*49cdfc7eSAndroid Build Coastguard Worker------
47*49cdfc7eSAndroid Build Coastguard WorkerDirectory containing the cpuset controller testcases. A similar directory will
48*49cdfc7eSAndroid Build Coastguard Workerbe created for any new controller.
49*49cdfc7eSAndroid Build Coastguard Worker
50*49cdfc7eSAndroid Build Coastguard Workerlibcontrollers
51*49cdfc7eSAndroid Build Coastguard Worker--------------
52*49cdfc7eSAndroid Build Coastguard WorkerThis directory contains the library for cpucontroller testing.
53*49cdfc7eSAndroid Build Coastguard Worker
54*49cdfc7eSAndroid Build Coastguard Workercpuacct
55*49cdfc7eSAndroid Build Coastguard Worker-----------
56*49cdfc7eSAndroid Build Coastguard WorkerDirectory containing the cpu accounting controller testcases.
57*49cdfc7eSAndroid Build Coastguard Worker
58*49cdfc7eSAndroid Build Coastguard WorkerMakefile
59*49cdfc7eSAndroid Build Coastguard Worker--------
60*49cdfc7eSAndroid Build Coastguard WorkerThe usual Makefile to conduct all the tests.
61*49cdfc7eSAndroid Build Coastguard Worker
62*49cdfc7eSAndroid Build Coastguard WorkerBefore starting compilation this file checks if the kernel is supporting the
63*49cdfc7eSAndroid Build Coastguard Workercpu controller. If yes it enters lower directory and compiles the source files
64*49cdfc7eSAndroid Build Coastguard Workerotherwise exits warning to user.
65*49cdfc7eSAndroid Build Coastguard WorkerHence the user has to take care of the fact that the test runs or just quiets.
66*49cdfc7eSAndroid Build Coastguard Worker(Your kernel needs to be 2.6.24 onwards with proper config options)
67*49cdfc7eSAndroid Build Coastguard Worker
68*49cdfc7eSAndroid Build Coastguard WorkerAnd before starting test cpuset, Please check whether the test system has
69*49cdfc7eSAndroid Build Coastguard Worker4 CPUs and 3 Memory nodes and the kernel version is 2.6.28 or above.
70*49cdfc7eSAndroid Build Coastguard Worker
71*49cdfc7eSAndroid Build Coastguard WorkerA snapshot of config file options is given below:
72*49cdfc7eSAndroid Build Coastguard WorkerCONFIG_CGROUPS=y
73*49cdfc7eSAndroid Build Coastguard WorkerCONFIG_CGROUP_DEBUG=y
74*49cdfc7eSAndroid Build Coastguard WorkerCONFIG_CGROUP_NS=y
75*49cdfc7eSAndroid Build Coastguard WorkerCONFIG_CPUSETS=y
76*49cdfc7eSAndroid Build Coastguard WorkerCONFIG_PROC_PID_CPUSET=y
77*49cdfc7eSAndroid Build Coastguard WorkerCONFIG_GROUP_SCHED=y
78*49cdfc7eSAndroid Build Coastguard WorkerCONFIG_FAIR_GROUP_SCHED=y
79*49cdfc7eSAndroid Build Coastguard WorkerCONFIG_RT_GROUP_SCHED=y
80*49cdfc7eSAndroid Build Coastguard Worker# CONFIG_USER_SCHED is not set
81*49cdfc7eSAndroid Build Coastguard WorkerCONFIG_CGROUP_SCHED=y
82