1.. SPDX-License-Identifier: GPL-2.0 2 3.. include:: ../disclaimer-zh_TW.rst 4 5:Original: :doc:`../../../cpu-freq/cpufreq-stats` 6:Translator: Yanteng Si <siyanteng@loongson.cn> 7 Hu Haowen <src.res@email.cn> 8 9.. _tw_cpufreq-stats.rst: 10 11 12========================================== 13sysfs CPUFreq Stats的一般說明 14========================================== 15 16用戶信息 17 18 19作者: Venkatesh Pallipadi <venkatesh.pallipadi@intel.com> 20 21.. Contents 22 23 1. 簡介 24 2. 提供的統計數據(舉例說明) 25 3. 配置cpufreq-stats 26 27 281. 簡介 29=============== 30 31cpufreq-stats是一個爲每個CPU提供CPU頻率統計的驅動。 32這些統計數據在/sysfs中以一堆只讀接口的形式提供。這個接口（在配置好後）將出現在 33/sysfs（<sysfs root>/devices/system/cpu/cpuX/cpufreq/stats/）中cpufreq下的一個單 34獨的目錄中，提供給每個CPU。 35各種統計數據將在此目錄下形成只讀文件。 36 37此驅動是獨立於任何可能運行在你所用CPU上的特定cpufreq_driver而設計的。因此，它將與所有 38cpufreq_driver一起工作。 39 40 412. 提供的統計數據(舉例說明) 42===================================== 43 44cpufreq stats提供了以下統計數據（在下面詳細解釋）。 45 46- time_in_state 47- total_trans 48- trans_table 49 50所有的統計數據將從統計驅動被載入的時間（或統計被重置的時間）開始，到某一統計數據被讀取的時間爲止。 51顯然，統計驅動不會有任何關於統計驅動載入之前的頻率轉換信息。 52 53:: 54 55 <mysystem>:/sys/devices/system/cpu/cpu0/cpufreq/stats # ls -l 56 total 0 57 drwxr-xr-x 2 root root 0 May 14 16:06 . 58 drwxr-xr-x 3 root root 0 May 14 15:58 .. 59 --w------- 1 root root 4096 May 14 16:06 reset 60 -r--r--r-- 1 root root 4096 May 14 16:06 time_in_state 61 -r--r--r-- 1 root root 4096 May 14 16:06 total_trans 62 -r--r--r-- 1 root root 4096 May 14 16:06 trans_table 63 64- **reset** 65 66只寫屬性，可用於重置統計計數器。這對於評估不同調節器下的系統行爲非常有用，且無需重啓。 67 68 69- **time_in_state** 70 71此項給出了這個CPU所支持的每個頻率所花費的時間。cat輸出的每一行都會有"<frequency> 72<time>"對，表示這個CPU在<frequency>上花費了<time>個usertime單位的時間。這裡的 73usertime單位是10mS（類似於/proc中輸出的其他時間）。 74 75:: 76 77 <mysystem>:/sys/devices/system/cpu/cpu0/cpufreq/stats # cat time_in_state 78 3600000 2089 79 3400000 136 80 3200000 34 81 3000000 67 82 2800000 172488 83 84 85- **total_trans** 86 87給出了這個CPU上頻率轉換的總次數。cat的輸出將有一個單一的計數，這就是頻率轉換的總數。 88 89:: 90 91 <mysystem>:/sys/devices/system/cpu/cpu0/cpufreq/stats # cat total_trans 92 20 93 94- **trans_table** 95 96這將提供所有CPU頻率轉換的細粒度信息。這裡的cat輸出是一個二維矩陣，其中一個條目<i, j>（第 97i行，第j列）代表從Freq_i到Freq_j的轉換次數。Freq_i行和Freq_j列遵循驅動最初提供給cpufreq 98核的頻率表的排序順序，因此可以排序（升序或降序）或不排序。 這裡的輸出也包含了每行每列的實際 99頻率值，以便更好地閱讀。 100 101如果轉換表大於PAGE_SIZE，讀取時將返回一個-EFBIG錯誤。 102 103:: 104 105 <mysystem>:/sys/devices/system/cpu/cpu0/cpufreq/stats # cat trans_table 106 From : To 107 : 3600000 3400000 3200000 3000000 2800000 108 3600000: 0 5 0 0 0 109 3400000: 4 0 2 0 0 110 3200000: 0 1 0 2 0 111 3000000: 0 0 1 0 3 112 2800000: 0 0 0 2 0 113 1143. 配置cpufreq-stats 115============================ 116 117要在你的內核中配置cpufreq-stats:: 118 119 Config Main Menu 120 Power management options (ACPI, APM) ---> 121 CPU Frequency scaling ---> 122 [*] CPU Frequency scaling 123 [*] CPU frequency translation statistics 124 125 126"CPU Frequency scaling" (CONFIG_CPU_FREQ) 應該被啓用以配置cpufreq-stats。 127 128"CPU frequency translation statistics" (CONFIG_CPU_FREQ_STAT)提供了包括 129time_in_state、total_trans和trans_table的統計數據。 130 131一旦啓用了這個選項，並且你的CPU支持cpufrequency，你就可以在/sysfs中看到CPU頻率統計。 132 133