sysfs-class-powercap 4.9 KB

123456789101112131415161718192021222324252627282930313233343536373839404142434445464748495051525354555657585960616263646566676869707172737475767778798081828384858687888990919293949596979899100101102103104105106107108109110111112113114115116117118119120121122123124125126127128129130131132133134135136137138139140141142143144145146147148149150151152
  1. What: /sys/class/powercap/
  2. Date: September 2013
  3. KernelVersion: 3.13
  4. Contact: linux-pm@vger.kernel.org
  5. Description:
  6. The powercap/ class sub directory belongs to the power cap
  7. subsystem. Refer to
  8. Documentation/power/powercap/powercap.rst for details.
  9. What: /sys/class/powercap/<control type>
  10. Date: September 2013
  11. KernelVersion: 3.13
  12. Contact: linux-pm@vger.kernel.org
  13. Description:
  14. A <control type> is a unique name under /sys/class/powercap.
  15. Here <control type> determines how the power is going to be
  16. controlled. A <control type> can contain multiple power zones.
  17. What: /sys/class/powercap/<control type>/enabled
  18. Date: September 2013
  19. KernelVersion: 3.13
  20. Contact: linux-pm@vger.kernel.org
  21. Description:
  22. This allows to enable/disable power capping for a "control type".
  23. This status affects every power zone using this "control_type.
  24. What: /sys/class/powercap/<control type>/<power zone>
  25. Date: September 2013
  26. KernelVersion: 3.13
  27. Contact: linux-pm@vger.kernel.org
  28. Description:
  29. A power zone is a single or a collection of devices, which can
  30. be independently monitored and controlled. A power zone sysfs
  31. entry is qualified with the name of the <control type>.
  32. E.g. intel-rapl:0:1:1.
  33. What: /sys/class/powercap/<control type>/<power zone>/<child power zone>
  34. Date: September 2013
  35. KernelVersion: 3.13
  36. Contact: linux-pm@vger.kernel.org
  37. Description:
  38. Power zones may be organized in a hierarchy in which child
  39. power zones provide monitoring and control for a subset of
  40. devices under the parent. For example, if there is a parent
  41. power zone for a whole CPU package, each CPU core in it can
  42. be a child power zone.
  43. What: /sys/class/powercap/.../<power zone>/name
  44. Date: September 2013
  45. KernelVersion: 3.13
  46. Contact: linux-pm@vger.kernel.org
  47. Description:
  48. Specifies the name of this power zone.
  49. What: /sys/class/powercap/.../<power zone>/energy_uj
  50. Date: September 2013
  51. KernelVersion: 3.13
  52. Contact: linux-pm@vger.kernel.org
  53. Description:
  54. Current energy counter in micro-joules. Write "0" to reset.
  55. If the counter can not be reset, then this attribute is
  56. read-only.
  57. What: /sys/class/powercap/.../<power zone>/max_energy_range_uj
  58. Date: September 2013
  59. KernelVersion: 3.13
  60. Contact: linux-pm@vger.kernel.org
  61. Description:
  62. Range of the above energy counter in micro-joules.
  63. What: /sys/class/powercap/.../<power zone>/power_uw
  64. Date: September 2013
  65. KernelVersion: 3.13
  66. Contact: linux-pm@vger.kernel.org
  67. Description:
  68. Current power in micro-watts.
  69. What: /sys/class/powercap/.../<power zone>/max_power_range_uw
  70. Date: September 2013
  71. KernelVersion: 3.13
  72. Contact: linux-pm@vger.kernel.org
  73. Description:
  74. Range of the above power value in micro-watts.
  75. What: /sys/class/powercap/.../<power zone>/constraint_X_name
  76. Date: September 2013
  77. KernelVersion: 3.13
  78. Contact: linux-pm@vger.kernel.org
  79. Description:
  80. Each power zone can define one or more constraints. Each
  81. constraint can have an optional name. Here "X" can have values
  82. from 0 to max integer.
  83. What: /sys/class/powercap/.../<power zone>/constraint_X_power_limit_uw
  84. Date: September 2013
  85. KernelVersion: 3.13
  86. Contact: linux-pm@vger.kernel.org
  87. Description:
  88. Power limit in micro-watts should be applicable for
  89. the time window specified by "constraint_X_time_window_us".
  90. Here "X" can have values from 0 to max integer.
  91. What: /sys/class/powercap/.../<power zone>/constraint_X_time_window_us
  92. Date: September 2013
  93. KernelVersion: 3.13
  94. Contact: linux-pm@vger.kernel.org
  95. Description:
  96. Time window in micro seconds. This is used along with
  97. constraint_X_power_limit_uw to define a power constraint.
  98. Here "X" can have values from 0 to max integer.
  99. What: /sys/class/powercap/<control type>/.../constraint_X_max_power_uw
  100. Date: September 2013
  101. KernelVersion: 3.13
  102. Contact: linux-pm@vger.kernel.org
  103. Description:
  104. Maximum allowed power in micro watts for this constraint.
  105. Here "X" can have values from 0 to max integer.
  106. What: /sys/class/powercap/<control type>/.../constraint_X_min_power_uw
  107. Date: September 2013
  108. KernelVersion: 3.13
  109. Contact: linux-pm@vger.kernel.org
  110. Description:
  111. Minimum allowed power in micro watts for this constraint.
  112. Here "X" can have values from 0 to max integer.
  113. What: /sys/class/powercap/.../<power zone>/constraint_X_max_time_window_us
  114. Date: September 2013
  115. KernelVersion: 3.13
  116. Contact: linux-pm@vger.kernel.org
  117. Description:
  118. Maximum allowed time window in micro seconds for this
  119. constraint. Here "X" can have values from 0 to max integer.
  120. What: /sys/class/powercap/.../<power zone>/constraint_X_min_time_window_us
  121. Date: September 2013
  122. KernelVersion: 3.13
  123. Contact: linux-pm@vger.kernel.org
  124. Description:
  125. Minimum allowed time window in micro seconds for this
  126. constraint. Here "X" can have values from 0 to max integer.
  127. What: /sys/class/powercap/.../<power zone>/enabled
  128. Date: September 2013
  129. KernelVersion: 3.13
  130. Contact: linux-pm@vger.kernel.org
  131. Description:
  132. This allows to enable/disable power capping at power zone level.
  133. This applies to current power zone and its children.