^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 1) What: /sys/devices/system/cpu/
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 2) Date: pre-git history
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 3) Contact: Linux kernel mailing list <linux-kernel@vger.kernel.org>
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 4) Description:
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 5) A collection of both global and individual CPU attributes
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 6)
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 7) Individual CPU attributes are contained in subdirectories
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 8) named by the kernel's logical CPU number, e.g.:
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 9)
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 10) /sys/devices/system/cpu/cpu#/
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 11)
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 12) What: /sys/devices/system/cpu/kernel_max
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 13) /sys/devices/system/cpu/offline
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 14) /sys/devices/system/cpu/online
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 15) /sys/devices/system/cpu/possible
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 16) /sys/devices/system/cpu/present
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 17) Date: December 2008
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 18) Contact: Linux kernel mailing list <linux-kernel@vger.kernel.org>
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 19) Description: CPU topology files that describe kernel limits related to
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 20) hotplug. Briefly:
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 21)
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 22) kernel_max: the maximum cpu index allowed by the kernel
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 23) configuration.
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 24)
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 25) offline: cpus that are not online because they have been
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 26) HOTPLUGGED off or exceed the limit of cpus allowed by the
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 27) kernel configuration (kernel_max above).
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 28)
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 29) online: cpus that are online and being scheduled.
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 30)
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 31) possible: cpus that have been allocated resources and can be
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 32) brought online if they are present.
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 33)
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 34) present: cpus that have been identified as being present in
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 35) the system.
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 36)
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 37) See Documentation/admin-guide/cputopology.rst for more information.
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 38)
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 39)
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 40) What: /sys/devices/system/cpu/probe
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 41) /sys/devices/system/cpu/release
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 42) Date: November 2009
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 43) Contact: Linux kernel mailing list <linux-kernel@vger.kernel.org>
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 44) Description: Dynamic addition and removal of CPU's. This is not hotplug
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 45) removal, this is meant complete removal/addition of the CPU
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 46) from the system.
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 47)
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 48) probe: writes to this file will dynamically add a CPU to the
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 49) system. Information written to the file to add CPU's is
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 50) architecture specific.
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 51)
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 52) release: writes to this file dynamically remove a CPU from
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 53) the system. Information writtento the file to remove CPU's
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 54) is architecture specific.
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 55)
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 56) What: /sys/devices/system/cpu/cpu#/node
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 57) Date: October 2009
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 58) Contact: Linux memory management mailing list <linux-mm@kvack.org>
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 59) Description: Discover NUMA node a CPU belongs to
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 60)
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 61) When CONFIG_NUMA is enabled, a symbolic link that points
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 62) to the corresponding NUMA node directory.
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 63)
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 64) For example, the following symlink is created for cpu42
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 65) in NUMA node 2:
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 66)
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 67) /sys/devices/system/cpu/cpu42/node2 -> ../../node/node2
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 68)
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 69)
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 70) What: /sys/devices/system/cpu/cpu#/topology/core_id
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 71) /sys/devices/system/cpu/cpu#/topology/core_siblings
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 72) /sys/devices/system/cpu/cpu#/topology/core_siblings_list
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 73) /sys/devices/system/cpu/cpu#/topology/physical_package_id
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 74) /sys/devices/system/cpu/cpu#/topology/thread_siblings
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 75) /sys/devices/system/cpu/cpu#/topology/thread_siblings_list
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 76) Date: December 2008
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 77) Contact: Linux kernel mailing list <linux-kernel@vger.kernel.org>
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 78) Description: CPU topology files that describe a logical CPU's relationship
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 79) to other cores and threads in the same physical package.
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 80)
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 81) One cpu# directory is created per logical CPU in the system,
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 82) e.g. /sys/devices/system/cpu/cpu42/.
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 83)
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 84) Briefly, the files above are:
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 85)
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 86) core_id: the CPU core ID of cpu#. Typically it is the
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 87) hardware platform's identifier (rather than the kernel's).
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 88) The actual value is architecture and platform dependent.
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 89)
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 90) core_siblings: internal kernel map of cpu#'s hardware threads
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 91) within the same physical_package_id.
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 92)
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 93) core_siblings_list: human-readable list of the logical CPU
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 94) numbers within the same physical_package_id as cpu#.
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 95)
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 96) physical_package_id: physical package id of cpu#. Typically
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 97) corresponds to a physical socket number, but the actual value
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 98) is architecture and platform dependent.
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 99)
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 100) thread_siblings: internel kernel map of cpu#'s hardware
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 101) threads within the same core as cpu#
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 102)
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 103) thread_siblings_list: human-readable list of cpu#'s hardware
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 104) threads within the same core as cpu#
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 105)
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 106) See Documentation/admin-guide/cputopology.rst for more information.
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 107)
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 108)
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 109) What: /sys/devices/system/cpu/cpuidle/available_governors
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 110) /sys/devices/system/cpu/cpuidle/current_driver
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 111) /sys/devices/system/cpu/cpuidle/current_governor
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 112) /sys/devices/system/cpu/cpuidle/current_governer_ro
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 113) Date: September 2007
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 114) Contact: Linux kernel mailing list <linux-kernel@vger.kernel.org>
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 115) Description: Discover cpuidle policy and mechanism
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 116)
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 117) Various CPUs today support multiple idle levels that are
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 118) differentiated by varying exit latencies and power
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 119) consumption during idle.
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 120)
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 121) Idle policy (governor) is differentiated from idle mechanism
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 122) (driver).
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 123)
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 124) available_governors: (RO) displays a space separated list of
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 125) available governors.
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 126)
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 127) current_driver: (RO) displays current idle mechanism.
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 128)
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 129) current_governor: (RW) displays current idle policy. Users can
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 130) switch the governor at runtime by writing to this file.
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 131)
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 132) current_governor_ro: (RO) displays current idle policy.
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 133)
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 134) See Documentation/admin-guide/pm/cpuidle.rst and
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 135) Documentation/driver-api/pm/cpuidle.rst for more information.
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 136)
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 137)
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 138) What: /sys/devices/system/cpu/cpuX/cpuidle/stateN/name
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 139) /sys/devices/system/cpu/cpuX/cpuidle/stateN/latency
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 140) /sys/devices/system/cpu/cpuX/cpuidle/stateN/power
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 141) /sys/devices/system/cpu/cpuX/cpuidle/stateN/time
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 142) /sys/devices/system/cpu/cpuX/cpuidle/stateN/usage
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 143) /sys/devices/system/cpu/cpuX/cpuidle/stateN/above
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 144) /sys/devices/system/cpu/cpuX/cpuidle/stateN/below
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 145) Date: September 2007
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 146) KernelVersion: v2.6.24
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 147) Contact: Linux power management list <linux-pm@vger.kernel.org>
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 148) Description:
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 149) The directory /sys/devices/system/cpu/cpuX/cpuidle contains per
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 150) logical CPU specific cpuidle information for each online cpu X.
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 151) The processor idle states which are available for use have the
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 152) following attributes:
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 153)
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 154) ======== ==== =================================================
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 155) name: (RO) Name of the idle state (string).
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 156)
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 157) latency: (RO) The latency to exit out of this idle state (in
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 158) microseconds).
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 159)
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 160) power: (RO) The power consumed while in this idle state (in
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 161) milliwatts).
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 162)
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 163) time: (RO) The total time spent in this idle state
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 164) (in microseconds).
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 165)
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 166) usage: (RO) Number of times this state was entered (a count).
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 167)
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 168) above: (RO) Number of times this state was entered, but the
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 169) observed CPU idle duration was too short for it
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 170) (a count).
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 171)
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 172) below: (RO) Number of times this state was entered, but the
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 173) observed CPU idle duration was too long for it
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 174) (a count).
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 175) ======== ==== =================================================
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 176)
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 177) What: /sys/devices/system/cpu/cpuX/cpuidle/stateN/desc
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 178) Date: February 2008
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 179) KernelVersion: v2.6.25
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 180) Contact: Linux power management list <linux-pm@vger.kernel.org>
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 181) Description:
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 182) (RO) A small description about the idle state (string).
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 183)
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 184)
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 185) What: /sys/devices/system/cpu/cpuX/cpuidle/stateN/disable
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 186) Date: March 2012
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 187) KernelVersion: v3.10
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 188) Contact: Linux power management list <linux-pm@vger.kernel.org>
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 189) Description:
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 190) (RW) Option to disable this idle state (bool). The behavior and
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 191) the effect of the disable variable depends on the implementation
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 192) of a particular governor. In the ladder governor, for example,
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 193) it is not coherent, i.e. if one is disabling a light state, then
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 194) all deeper states are disabled as well, but the disable variable
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 195) does not reflect it. Likewise, if one enables a deep state but a
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 196) lighter state still is disabled, then this has no effect.
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 197)
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 198) What: /sys/devices/system/cpu/cpuX/cpuidle/stateN/default_status
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 199) Date: December 2019
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 200) KernelVersion: v5.6
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 201) Contact: Linux power management list <linux-pm@vger.kernel.org>
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 202) Description:
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 203) (RO) The default status of this state, "enabled" or "disabled".
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 204)
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 205) What: /sys/devices/system/cpu/cpuX/cpuidle/stateN/residency
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 206) Date: March 2014
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 207) KernelVersion: v3.15
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 208) Contact: Linux power management list <linux-pm@vger.kernel.org>
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 209) Description:
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 210) (RO) Display the target residency i.e. the minimum amount of
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 211) time (in microseconds) this cpu should spend in this idle state
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 212) to make the transition worth the effort.
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 213)
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 214) What: /sys/devices/system/cpu/cpuX/cpuidle/stateN/s2idle/
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 215) Date: March 2018
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 216) KernelVersion: v4.17
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 217) Contact: Linux power management list <linux-pm@vger.kernel.org>
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 218) Description:
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 219) Idle state usage statistics related to suspend-to-idle.
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 220)
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 221) This attribute group is only present for states that can be
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 222) used in suspend-to-idle with suspended timekeeping.
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 223)
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 224) What: /sys/devices/system/cpu/cpuX/cpuidle/stateN/s2idle/time
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 225) Date: March 2018
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 226) KernelVersion: v4.17
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 227) Contact: Linux power management list <linux-pm@vger.kernel.org>
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 228) Description:
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 229) Total time spent by the CPU in suspend-to-idle (with scheduler
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 230) tick suspended) after requesting this state.
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 231)
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 232) What: /sys/devices/system/cpu/cpuX/cpuidle/stateN/s2idle/usage
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 233) Date: March 2018
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 234) KernelVersion: v4.17
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 235) Contact: Linux power management list <linux-pm@vger.kernel.org>
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 236) Description:
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 237) Total number of times this state has been requested by the CPU
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 238) while entering suspend-to-idle.
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 239)
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 240) What: /sys/devices/system/cpu/cpu#/cpufreq/*
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 241) Date: pre-git history
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 242) Contact: linux-pm@vger.kernel.org
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 243) Description: Discover and change clock speed of CPUs
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 244)
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 245) Clock scaling allows you to change the clock speed of the
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 246) CPUs on the fly. This is a nice method to save battery
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 247) power, because the lower the clock speed, the less power
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 248) the CPU consumes.
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 249)
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 250) There are many knobs to tweak in this directory.
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 251)
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 252) See files in Documentation/cpu-freq/ for more information.
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 253)
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 254)
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 255) What: /sys/devices/system/cpu/cpu#/cpufreq/freqdomain_cpus
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 256) Date: June 2013
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 257) Contact: linux-pm@vger.kernel.org
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 258) Description: Discover CPUs in the same CPU frequency coordination domain
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 259)
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 260) freqdomain_cpus is the list of CPUs (online+offline) that share
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 261) the same clock/freq domain (possibly at the hardware level).
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 262) That information may be hidden from the cpufreq core and the
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 263) value of related_cpus may be different from freqdomain_cpus. This
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 264) attribute is useful for user space DVFS controllers to get better
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 265) power/performance results for platforms using acpi-cpufreq.
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 266)
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 267) This file is only present if the acpi-cpufreq driver is in use.
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 268)
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 269)
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 270) What: /sys/devices/system/cpu/cpu*/cache/index3/cache_disable_{0,1}
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 271) Date: August 2008
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 272) KernelVersion: 2.6.27
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 273) Contact: Linux kernel mailing list <linux-kernel@vger.kernel.org>
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 274) Description: Disable L3 cache indices
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 275)
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 276) These files exist in every CPU's cache/index3 directory. Each
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 277) cache_disable_{0,1} file corresponds to one disable slot which
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 278) can be used to disable a cache index. Reading from these files
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 279) on a processor with this functionality will return the currently
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 280) disabled index for that node. There is one L3 structure per
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 281) node, or per internal node on MCM machines. Writing a valid
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 282) index to one of these files will cause the specificed cache
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 283) index to be disabled.
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 284)
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 285) All AMD processors with L3 caches provide this functionality.
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 286) For details, see BKDGs at
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 287) http://developer.amd.com/documentation/guides/Pages/default.aspx
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 288)
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 289)
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 290) What: /sys/devices/system/cpu/cpufreq/boost
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 291) Date: August 2012
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 292) Contact: Linux kernel mailing list <linux-kernel@vger.kernel.org>
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 293) Description: Processor frequency boosting control
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 294)
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 295) This switch controls the boost setting for the whole system.
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 296) Boosting allows the CPU and the firmware to run at a frequency
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 297) beyound it's nominal limit.
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 298)
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 299) More details can be found in
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 300) Documentation/admin-guide/pm/cpufreq.rst
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 301)
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 302)
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 303) What: /sys/devices/system/cpu/cpu#/crash_notes
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 304) /sys/devices/system/cpu/cpu#/crash_notes_size
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 305) Date: April 2013
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 306) Contact: kexec@lists.infradead.org
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 307) Description: address and size of the percpu note.
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 308)
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 309) crash_notes: the physical address of the memory that holds the
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 310) note of cpu#.
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 311)
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 312) crash_notes_size: size of the note of cpu#.
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 313)
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 314)
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 315) What: /sys/devices/system/cpu/intel_pstate/max_perf_pct
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 316) /sys/devices/system/cpu/intel_pstate/min_perf_pct
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 317) /sys/devices/system/cpu/intel_pstate/no_turbo
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 318) Date: February 2013
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 319) Contact: linux-pm@vger.kernel.org
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 320) Description: Parameters for the Intel P-state driver
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 321)
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 322) Logic for selecting the current P-state in Intel
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 323) Sandybridge+ processors. The three knobs control
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 324) limits for the P-state that will be requested by the
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 325) driver.
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 326)
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 327) max_perf_pct: limits the maximum P state that will be requested by
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 328) the driver stated as a percentage of the available performance.
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 329)
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 330) min_perf_pct: limits the minimum P state that will be requested by
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 331) the driver stated as a percentage of the available performance.
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 332)
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 333) no_turbo: limits the driver to selecting P states below the turbo
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 334) frequency range.
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 335)
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 336) More details can be found in
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 337) Documentation/admin-guide/pm/intel_pstate.rst
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 338)
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 339) What: /sys/devices/system/cpu/cpu*/cache/index*/<set_of_attributes_mentioned_below>
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 340) Date: July 2014(documented, existed before August 2008)
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 341) Contact: Sudeep Holla <sudeep.holla@arm.com>
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 342) Linux kernel mailing list <linux-kernel@vger.kernel.org>
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 343) Description: Parameters for the CPU cache attributes
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 344)
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 345) allocation_policy:
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 346) - WriteAllocate:
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 347) allocate a memory location to a cache line
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 348) on a cache miss because of a write
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 349) - ReadAllocate:
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 350) allocate a memory location to a cache line
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 351) on a cache miss because of a read
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 352) - ReadWriteAllocate:
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 353) both writeallocate and readallocate
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 354)
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 355) attributes:
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 356) LEGACY used only on IA64 and is same as write_policy
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 357)
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 358) coherency_line_size:
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 359) the minimum amount of data in bytes that gets
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 360) transferred from memory to cache
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 361)
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 362) level:
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 363) the cache hierarchy in the multi-level cache configuration
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 364)
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 365) number_of_sets:
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 366) total number of sets in the cache, a set is a
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 367) collection of cache lines with the same cache index
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 368)
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 369) physical_line_partition:
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 370) number of physical cache line per cache tag
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 371)
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 372) shared_cpu_list:
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 373) the list of logical cpus sharing the cache
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 374)
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 375) shared_cpu_map:
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 376) logical cpu mask containing the list of cpus sharing
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 377) the cache
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 378)
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 379) size:
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 380) the total cache size in kB
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 381)
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 382) type:
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 383) - Instruction: cache that only holds instructions
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 384) - Data: cache that only caches data
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 385) - Unified: cache that holds both data and instructions
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 386)
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 387) ways_of_associativity:
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 388) degree of freedom in placing a particular block
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 389) of memory in the cache
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 390)
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 391) write_policy:
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 392) - WriteThrough:
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 393) data is written to both the cache line
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 394) and to the block in the lower-level memory
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 395) - WriteBack:
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 396) data is written only to the cache line and
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 397) the modified cache line is written to main
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 398) memory only when it is replaced
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 399)
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 400)
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 401) What: /sys/devices/system/cpu/cpu*/cache/index*/id
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 402) Date: September 2016
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 403) Contact: Linux kernel mailing list <linux-kernel@vger.kernel.org>
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 404) Description: Cache id
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 405)
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 406) The id provides a unique number for a specific instance of
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 407) a cache of a particular type. E.g. there may be a level
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 408) 3 unified cache on each socket in a server and we may
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 409) assign them ids 0, 1, 2, ...
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 410)
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 411) Note that id value can be non-contiguous. E.g. level 1
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 412) caches typically exist per core, but there may not be a
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 413) power of two cores on a socket, so these caches may be
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 414) numbered 0, 1, 2, 3, 4, 5, 8, 9, 10, ...
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 415)
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 416) What: /sys/devices/system/cpu/cpuX/cpufreq/throttle_stats
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 417) /sys/devices/system/cpu/cpuX/cpufreq/throttle_stats/turbo_stat
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 418) /sys/devices/system/cpu/cpuX/cpufreq/throttle_stats/sub_turbo_stat
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 419) /sys/devices/system/cpu/cpuX/cpufreq/throttle_stats/unthrottle
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 420) /sys/devices/system/cpu/cpuX/cpufreq/throttle_stats/powercap
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 421) /sys/devices/system/cpu/cpuX/cpufreq/throttle_stats/overtemp
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 422) /sys/devices/system/cpu/cpuX/cpufreq/throttle_stats/supply_fault
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 423) /sys/devices/system/cpu/cpuX/cpufreq/throttle_stats/overcurrent
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 424) /sys/devices/system/cpu/cpuX/cpufreq/throttle_stats/occ_reset
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 425) Date: March 2016
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 426) Contact: Linux kernel mailing list <linux-kernel@vger.kernel.org>
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 427) Linux for PowerPC mailing list <linuxppc-dev@ozlabs.org>
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 428) Description: POWERNV CPUFreq driver's frequency throttle stats directory and
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 429) attributes
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 430)
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 431) 'cpuX/cpufreq/throttle_stats' directory contains the CPU frequency
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 432) throttle stat attributes for the chip. The throttle stats of a cpu
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 433) is common across all the cpus belonging to a chip. Below are the
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 434) throttle attributes exported in the 'throttle_stats' directory:
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 435)
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 436) - turbo_stat : This file gives the total number of times the max
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 437) frequency is throttled to lower frequency in turbo (at and above
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 438) nominal frequency) range of frequencies.
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 439)
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 440) - sub_turbo_stat : This file gives the total number of times the
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 441) max frequency is throttled to lower frequency in sub-turbo(below
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 442) nominal frequency) range of frequencies.
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 443)
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 444) - unthrottle : This file gives the total number of times the max
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 445) frequency is unthrottled after being throttled.
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 446)
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 447) - powercap : This file gives the total number of times the max
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 448) frequency is throttled due to 'Power Capping'.
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 449)
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 450) - overtemp : This file gives the total number of times the max
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 451) frequency is throttled due to 'CPU Over Temperature'.
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 452)
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 453) - supply_fault : This file gives the total number of times the
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 454) max frequency is throttled due to 'Power Supply Failure'.
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 455)
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 456) - overcurrent : This file gives the total number of times the
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 457) max frequency is throttled due to 'Overcurrent'.
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 458)
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 459) - occ_reset : This file gives the total number of times the max
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 460) frequency is throttled due to 'OCC Reset'.
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 461)
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 462) The sysfs attributes representing different throttle reasons like
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 463) powercap, overtemp, supply_fault, overcurrent and occ_reset map to
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 464) the reasons provided by OCC firmware for throttling the frequency.
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 465)
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 466) What: /sys/devices/system/cpu/cpufreq/policyX/throttle_stats
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 467) /sys/devices/system/cpu/cpufreq/policyX/throttle_stats/turbo_stat
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 468) /sys/devices/system/cpu/cpufreq/policyX/throttle_stats/sub_turbo_stat
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 469) /sys/devices/system/cpu/cpufreq/policyX/throttle_stats/unthrottle
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 470) /sys/devices/system/cpu/cpufreq/policyX/throttle_stats/powercap
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 471) /sys/devices/system/cpu/cpufreq/policyX/throttle_stats/overtemp
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 472) /sys/devices/system/cpu/cpufreq/policyX/throttle_stats/supply_fault
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 473) /sys/devices/system/cpu/cpufreq/policyX/throttle_stats/overcurrent
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 474) /sys/devices/system/cpu/cpufreq/policyX/throttle_stats/occ_reset
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 475) Date: March 2016
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 476) Contact: Linux kernel mailing list <linux-kernel@vger.kernel.org>
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 477) Linux for PowerPC mailing list <linuxppc-dev@ozlabs.org>
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 478) Description: POWERNV CPUFreq driver's frequency throttle stats directory and
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 479) attributes
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 480)
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 481) 'policyX/throttle_stats' directory and all the attributes are same as
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 482) the /sys/devices/system/cpu/cpuX/cpufreq/throttle_stats directory and
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 483) attributes which give the frequency throttle information of the chip.
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 484)
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 485) What: /sys/devices/system/cpu/cpuX/regs/
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 486) /sys/devices/system/cpu/cpuX/regs/identification/
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 487) /sys/devices/system/cpu/cpuX/regs/identification/midr_el1
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 488) /sys/devices/system/cpu/cpuX/regs/identification/revidr_el1
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 489) Date: June 2016
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 490) Contact: Linux ARM Kernel Mailing list <linux-arm-kernel@lists.infradead.org>
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 491) Description: AArch64 CPU registers
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 492)
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 493) 'identification' directory exposes the CPU ID registers for
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 494) identifying model and revision of the CPU.
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 495)
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 496) What: /sys/devices/system/cpu/aarch32_el0
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 497) Date: November 2020
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 498) Contact: Linux ARM Kernel Mailing list <linux-arm-kernel@lists.infradead.org>
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 499) Description: Identifies the subset of CPUs in the system that can execute
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 500) AArch32 (32-bit ARM) applications. If present, the same format as
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 501) /sys/devices/system/cpu/{offline,online,possible,present} is used.
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 502) If absent, then all or none of the CPUs can execute AArch32
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 503) applications and execve() will behave accordingly.
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 504)
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 505) What: /sys/devices/system/cpu/cpu#/cpu_capacity
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 506) Date: December 2016
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 507) Contact: Linux kernel mailing list <linux-kernel@vger.kernel.org>
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 508) Description: information about CPUs heterogeneity.
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 509)
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 510) cpu_capacity: capacity of cpu#.
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 511)
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 512) What: /sys/devices/system/cpu/vulnerabilities
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 513) /sys/devices/system/cpu/vulnerabilities/meltdown
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 514) /sys/devices/system/cpu/vulnerabilities/spectre_v1
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 515) /sys/devices/system/cpu/vulnerabilities/spectre_v2
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 516) /sys/devices/system/cpu/vulnerabilities/spec_store_bypass
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 517) /sys/devices/system/cpu/vulnerabilities/l1tf
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 518) /sys/devices/system/cpu/vulnerabilities/mds
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 519) /sys/devices/system/cpu/vulnerabilities/srbds
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 520) /sys/devices/system/cpu/vulnerabilities/tsx_async_abort
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 521) /sys/devices/system/cpu/vulnerabilities/itlb_multihit
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 522) Date: January 2018
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 523) Contact: Linux kernel mailing list <linux-kernel@vger.kernel.org>
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 524) Description: Information about CPU vulnerabilities
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 525)
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 526) The files are named after the code names of CPU
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 527) vulnerabilities. The output of those files reflects the
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 528) state of the CPUs in the system. Possible output values:
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 529)
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 530) ================ ==============================================
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 531) "Not affected" CPU is not affected by the vulnerability
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 532) "Vulnerable" CPU is affected and no mitigation in effect
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 533) "Mitigation: $M" CPU is affected and mitigation $M is in effect
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 534) ================ ==============================================
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 535)
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 536) See also: Documentation/admin-guide/hw-vuln/index.rst
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 537)
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 538) What: /sys/devices/system/cpu/smt
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 539) /sys/devices/system/cpu/smt/active
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 540) /sys/devices/system/cpu/smt/control
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 541) Date: June 2018
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 542) Contact: Linux kernel mailing list <linux-kernel@vger.kernel.org>
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 543) Description: Control Symetric Multi Threading (SMT)
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 544)
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 545) active: Tells whether SMT is active (enabled and siblings online)
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 546)
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 547) control: Read/write interface to control SMT. Possible
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 548) values:
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 549)
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 550) ================ =========================================
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 551) "on" SMT is enabled
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 552) "off" SMT is disabled
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 553) "forceoff" SMT is force disabled. Cannot be changed.
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 554) "notsupported" SMT is not supported by the CPU
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 555) "notimplemented" SMT runtime toggling is not
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 556) implemented for the architecture
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 557) ================ =========================================
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 558)
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 559) If control status is "forceoff" or "notsupported" writes
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 560) are rejected.
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 561)
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 562) What: /sys/devices/system/cpu/cpu#/power/energy_perf_bias
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 563) Date: March 2019
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 564) Contact: linux-pm@vger.kernel.org
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 565) Description: Intel Energy and Performance Bias Hint (EPB)
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 566)
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 567) EPB for the given CPU in a sliding scale 0 - 15, where a value
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 568) of 0 corresponds to a hint preference for highest performance
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 569) and a value of 15 corresponds to the maximum energy savings.
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 570)
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 571) In order to change the EPB value for the CPU, write either
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 572) a number in the 0 - 15 sliding scale above, or one of the
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 573) strings: "performance", "balance-performance", "normal",
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 574) "balance-power", "power" (that represent values reflected by
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 575) their meaning), to this attribute.
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 576)
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 577) This attribute is present for all online CPUs supporting the
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 578) Intel EPB feature.
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 579)
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 580) What: /sys/devices/system/cpu/umwait_control
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 581) /sys/devices/system/cpu/umwait_control/enable_c02
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 582) /sys/devices/system/cpu/umwait_control/max_time
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 583) Date: May 2019
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 584) Contact: Linux kernel mailing list <linux-kernel@vger.kernel.org>
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 585) Description: Umwait control
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 586)
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 587) enable_c02: Read/write interface to control umwait C0.2 state
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 588) Read returns C0.2 state status:
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 589) 0: C0.2 is disabled
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 590) 1: C0.2 is enabled
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 591)
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 592) Write 'y' or '1' or 'on' to enable C0.2 state.
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 593) Write 'n' or '0' or 'off' to disable C0.2 state.
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 594)
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 595) The interface is case insensitive.
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 596)
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 597) max_time: Read/write interface to control umwait maximum time
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 598) in TSC-quanta that the CPU can reside in either C0.1
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 599) or C0.2 state. The time is an unsigned 32-bit number.
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 600) Note that a value of zero means there is no limit.
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 601) Low order two bits must be zero.
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 602)
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 603) What: /sys/devices/system/cpu/svm
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 604) Date: August 2019
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 605) Contact: Linux kernel mailing list <linux-kernel@vger.kernel.org>
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 606) Linux for PowerPC mailing list <linuxppc-dev@ozlabs.org>
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 607) Description: Secure Virtual Machine
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 608)
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 609) If 1, it means the system is using the Protected Execution
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 610) Facility in POWER9 and newer processors. i.e., it is a Secure
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 611) Virtual Machine.
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 612)
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 613) What: /sys/devices/system/cpu/cpuX/purr
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 614) Date: Apr 2005
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 615) Contact: Linux for PowerPC mailing list <linuxppc-dev@ozlabs.org>
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 616) Description: PURR ticks for this CPU since the system boot.
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 617)
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 618) The Processor Utilization Resources Register (PURR) is
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 619) a 64-bit counter which provides an estimate of the
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 620) resources used by the CPU thread. The contents of this
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 621) register increases monotonically. This sysfs interface
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 622) exposes the number of PURR ticks for cpuX.
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 623)
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 624) What: /sys/devices/system/cpu/cpuX/spurr
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 625) Date: Dec 2006
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 626) Contact: Linux for PowerPC mailing list <linuxppc-dev@ozlabs.org>
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 627) Description: SPURR ticks for this CPU since the system boot.
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 628)
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 629) The Scaled Processor Utilization Resources Register
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 630) (SPURR) is a 64-bit counter that provides a frequency
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 631) invariant estimate of the resources used by the CPU
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 632) thread. The contents of this register increases
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 633) monotonically. This sysfs interface exposes the number
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 634) of SPURR ticks for cpuX.
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 635)
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 636) What: /sys/devices/system/cpu/cpuX/idle_purr
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 637) Date: Apr 2020
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 638) Contact: Linux for PowerPC mailing list <linuxppc-dev@ozlabs.org>
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 639) Description: PURR ticks for cpuX when it was idle.
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 640)
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 641) This sysfs interface exposes the number of PURR ticks
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 642) for cpuX when it was idle.
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 643)
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 644) What: /sys/devices/system/cpu/cpuX/idle_spurr
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 645) Date: Apr 2020
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 646) Contact: Linux for PowerPC mailing list <linuxppc-dev@ozlabs.org>
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 647) Description: SPURR ticks for cpuX when it was idle.
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 648)
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 649) This sysfs interface exposes the number of SPURR ticks
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 650) for cpuX when it was idle.
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 651)
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 652) What: /sys/devices/system/cpu/cpuX/mte_tcf_preferred
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 653) Date: July 2021
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 654) Contact: Linux ARM Kernel Mailing list <linux-arm-kernel@lists.infradead.org>
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 655) Description: Preferred MTE tag checking mode
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 656)
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 657) When a user program specifies more than one MTE tag checking
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 658) mode, this sysfs node is used to specify which mode should
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 659) be preferred when running on that CPU. Possible values:
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 660)
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 661) ================ ==============================================
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 662) "sync" Prefer synchronous mode
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 663) "async" Prefer asynchronous mode
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 664) ================ ==============================================
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 665)
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 666) Changes to this sysfs node may not take effect immediately.
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 667)
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 668) See also: Documentation/arm64/memory-tagging-extension.rst