Blame view

Documentation/cpuidle/sysfs.txt 3.37 KB
fe8e288a6   Venkatesh Pallipadi   cpuidle: Add Docu...
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
  
  
  		Supporting multiple CPU idle levels in kernel
  
  				cpuidle sysfs
  
  System global cpuidle related information and tunables are under
  /sys/devices/system/cpu/cpuidle
  
  The current interfaces in this directory has self-explanatory names:
  * current_driver
  * current_governor_ro
  
  With cpuidle_sysfs_switch boot option (meant for developer testing)
  following objects are visible instead.
  * current_driver
  * available_governors
  * current_governor
  In this case users can switch the governor at run time by writing
  to current_governor.
  
  
  Per logical CPU specific cpuidle information are under
  /sys/devices/system/cpu/cpuX/cpuidle
  for each online cpu X
  
  --------------------------------------------------------------------------------
  # ls -lR /sys/devices/system/cpu/cpu0/cpuidle/
  /sys/devices/system/cpu/cpu0/cpuidle/:
  total 0
  drwxr-xr-x 2 root root 0 Feb  8 10:42 state0
  drwxr-xr-x 2 root root 0 Feb  8 10:42 state1
  drwxr-xr-x 2 root root 0 Feb  8 10:42 state2
  drwxr-xr-x 2 root root 0 Feb  8 10:42 state3
  
  /sys/devices/system/cpu/cpu0/cpuidle/state0:
  total 0
  -r--r--r-- 1 root root 4096 Feb  8 10:42 desc
3a53396b0   ShuoX Liu   cpuidle: add a sy...
39
  -rw-r--r-- 1 root root 4096 Feb  8 10:42 disable
fe8e288a6   Venkatesh Pallipadi   cpuidle: Add Docu...
40
41
42
43
44
45
46
47
48
  -r--r--r-- 1 root root 4096 Feb  8 10:42 latency
  -r--r--r-- 1 root root 4096 Feb  8 10:42 name
  -r--r--r-- 1 root root 4096 Feb  8 10:42 power
  -r--r--r-- 1 root root 4096 Feb  8 10:42 time
  -r--r--r-- 1 root root 4096 Feb  8 10:42 usage
  
  /sys/devices/system/cpu/cpu0/cpuidle/state1:
  total 0
  -r--r--r-- 1 root root 4096 Feb  8 10:42 desc
3a53396b0   ShuoX Liu   cpuidle: add a sy...
49
  -rw-r--r-- 1 root root 4096 Feb  8 10:42 disable
fe8e288a6   Venkatesh Pallipadi   cpuidle: Add Docu...
50
51
52
53
54
55
56
57
58
  -r--r--r-- 1 root root 4096 Feb  8 10:42 latency
  -r--r--r-- 1 root root 4096 Feb  8 10:42 name
  -r--r--r-- 1 root root 4096 Feb  8 10:42 power
  -r--r--r-- 1 root root 4096 Feb  8 10:42 time
  -r--r--r-- 1 root root 4096 Feb  8 10:42 usage
  
  /sys/devices/system/cpu/cpu0/cpuidle/state2:
  total 0
  -r--r--r-- 1 root root 4096 Feb  8 10:42 desc
3a53396b0   ShuoX Liu   cpuidle: add a sy...
59
  -rw-r--r-- 1 root root 4096 Feb  8 10:42 disable
fe8e288a6   Venkatesh Pallipadi   cpuidle: Add Docu...
60
61
62
63
64
65
66
67
68
  -r--r--r-- 1 root root 4096 Feb  8 10:42 latency
  -r--r--r-- 1 root root 4096 Feb  8 10:42 name
  -r--r--r-- 1 root root 4096 Feb  8 10:42 power
  -r--r--r-- 1 root root 4096 Feb  8 10:42 time
  -r--r--r-- 1 root root 4096 Feb  8 10:42 usage
  
  /sys/devices/system/cpu/cpu0/cpuidle/state3:
  total 0
  -r--r--r-- 1 root root 4096 Feb  8 10:42 desc
3a53396b0   ShuoX Liu   cpuidle: add a sy...
69
  -rw-r--r-- 1 root root 4096 Feb  8 10:42 disable
fe8e288a6   Venkatesh Pallipadi   cpuidle: Add Docu...
70
71
72
73
74
75
76
77
78
  -r--r--r-- 1 root root 4096 Feb  8 10:42 latency
  -r--r--r-- 1 root root 4096 Feb  8 10:42 name
  -r--r--r-- 1 root root 4096 Feb  8 10:42 power
  -r--r--r-- 1 root root 4096 Feb  8 10:42 time
  -r--r--r-- 1 root root 4096 Feb  8 10:42 usage
  --------------------------------------------------------------------------------
  
  
  * desc : Small description about the idle state (string)
62d6ae880   Carsten Emde   Honor state disab...
79
  * disable : Option to disable this idle state (bool) -> see note below
fe8e288a6   Venkatesh Pallipadi   cpuidle: Add Docu...
80
81
82
83
84
  * latency : Latency to exit out of this idle state (in microseconds)
  * name : Name of the idle state (string)
  * power : Power consumed while in this idle state (in milliwatts)
  * time : Total time spent in this idle state (in microseconds)
  * usage : Number of times this state was entered (count)
62d6ae880   Carsten Emde   Honor state disab...
85
86
87
88
89
90
91
92
  
  Note:
  The behavior and the effect of the disable variable depends on the
  implementation of a particular governor. In the ladder governor, for
  example, it is not coherent, i.e. if one is disabling a light state,
  then all deeper states are disabled as well, but the disable variable
  does not reflect it. Likewise, if one enables a deep state but a lighter
  state still is disabled, then this has no effect.