요약·해설과 원문, 전문 번역을 서로 분리했습니다. API 이름, symbol, source path는 원문 표기를 사용합니다.
1. 요약·해설
원문의 핵심 논리와 kernel programming 관점의 보충 설명입니다. 아래의 전문 번역과는 별도로 작성했습니다.
Power zone hierarchy
sysfs-class-powercap:27-53독립 monitoring·control 단위와 parent subset을 나타내는 child zone, zone name을 제공합니다.
Energy and power measurements
sysfs-class-powercap:55-84Microjoule energy counter와 range, microwatt current power와 range를 구분합니다.
Indexed power constraints
sysfs-class-powercap:86-112Constraint X의 optional name, power limit와 적용 time window를 한 쌍으로 정의합니다.
Constraint bounds and zone enable
sysfs-class-powercap:114-152Constraint별 minimum·maximum power와 time window, 현재 zone과 child에 적용되는 enable을 제공합니다.
2. 영어 원문 전체
번역 기준이 된 Linux v6.18.37 원문입니다. 줄 번호는 이 버전의 파일 좌표입니다.
원문 전체 펼치기
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.
10
What: /sys/class/powercap/<control type>
11
Date: September 2013
12
KernelVersion: 3.13
13
Contact: linux-pm@vger.kernel.org
14
Description:
15
A <control type> is a unique name under /sys/class/powercap.
16
Here <control type> determines how the power is going to be
17
controlled. A <control type> can contain multiple power zones.
19
What: /sys/class/powercap/<control type>/enabled
20
Date: September 2013
21
KernelVersion: 3.13
22
Contact: linux-pm@vger.kernel.org
23
Description:
24
This allows to enable/disable power capping for a "control type".
25
This status affects every power zone using this "control_type.
27
What: /sys/class/powercap/<control type>/<power zone>
28
Date: September 2013
29
KernelVersion: 3.13
30
Contact: linux-pm@vger.kernel.org
31
Description:
32
A power zone is a single or a collection of devices, which can
33
be independently monitored and controlled. A power zone sysfs
34
entry is qualified with the name of the <control type>.
35
E.g. intel-rapl:0:1:1.
37
What: /sys/class/powercap/<control type>/<power zone>/<child power zone>
38
Date: September 2013
39
KernelVersion: 3.13
40
Contact: linux-pm@vger.kernel.org
41
Description:
42
Power zones may be organized in a hierarchy in which child
43
power zones provide monitoring and control for a subset of
44
devices under the parent. For example, if there is a parent
45
power zone for a whole CPU package, each CPU core in it can
46
be a child power zone.
48
What: /sys/class/powercap/.../<power zone>/name
49
Date: September 2013
50
KernelVersion: 3.13
51
Contact: linux-pm@vger.kernel.org
52
Description:
53
Specifies the name of this power zone.
55
What: /sys/class/powercap/.../<power zone>/energy_uj
56
Date: September 2013
57
KernelVersion: 3.13
58
Contact: linux-pm@vger.kernel.org
59
Description:
60
Current energy counter in micro-joules. Write "0" to reset.
61
If the counter can not be reset, then this attribute is
62
read-only.
64
What: /sys/class/powercap/.../<power zone>/max_energy_range_uj
65
Date: September 2013
66
KernelVersion: 3.13
67
Contact: linux-pm@vger.kernel.org
68
Description:
69
Range of the above energy counter in micro-joules.
72
What: /sys/class/powercap/.../<power zone>/power_uw
73
Date: September 2013
74
KernelVersion: 3.13
75
Contact: linux-pm@vger.kernel.org
76
Description:
77
Current power in micro-watts.
79
What: /sys/class/powercap/.../<power zone>/max_power_range_uw
80
Date: September 2013
81
KernelVersion: 3.13
82
Contact: linux-pm@vger.kernel.org
83
Description:
84
Range of the above power value in micro-watts.
86
What: /sys/class/powercap/.../<power zone>/constraint_X_name
87
Date: September 2013
88
KernelVersion: 3.13
89
Contact: linux-pm@vger.kernel.org
90
Description:
91
Each power zone can define one or more constraints. Each
92
constraint can have an optional name. Here "X" can have values
93
from 0 to max integer.
95
What: /sys/class/powercap/.../<power zone>/constraint_X_power_limit_uw
96
Date: September 2013
97
KernelVersion: 3.13
98
Contact: linux-pm@vger.kernel.org
99
Description:
100
Power limit in micro-watts should be applicable for
101
the time window specified by "constraint_X_time_window_us".
102
Here "X" can have values from 0 to max integer.
104
What: /sys/class/powercap/.../<power zone>/constraint_X_time_window_us
105
Date: September 2013
106
KernelVersion: 3.13
107
Contact: linux-pm@vger.kernel.org
108
Description:
109
Time window in micro seconds. This is used along with
110
constraint_X_power_limit_uw to define a power constraint.
111
Here "X" can have values from 0 to max integer.
114
What: /sys/class/powercap/<control type>/.../constraint_X_max_power_uw
115
Date: September 2013
116
KernelVersion: 3.13
117
Contact: linux-pm@vger.kernel.org
118
Description:
119
Maximum allowed power in micro watts for this constraint.
120
Here "X" can have values from 0 to max integer.
122
What: /sys/class/powercap/<control type>/.../constraint_X_min_power_uw
123
Date: September 2013
124
KernelVersion: 3.13
125
Contact: linux-pm@vger.kernel.org
126
Description:
127
Minimum allowed power in micro watts for this constraint.
128
Here "X" can have values from 0 to max integer.
130
What: /sys/class/powercap/.../<power zone>/constraint_X_max_time_window_us
131
Date: September 2013
132
KernelVersion: 3.13
133
Contact: linux-pm@vger.kernel.org
134
Description:
135
Maximum allowed time window in micro seconds for this
136
constraint. Here "X" can have values from 0 to max integer.
138
What: /sys/class/powercap/.../<power zone>/constraint_X_min_time_window_us
139
Date: September 2013
140
KernelVersion: 3.13
141
Contact: linux-pm@vger.kernel.org
142
Description:
143
Minimum allowed time window in micro seconds for this
144
constraint. Here "X" can have values from 0 to max integer.
146
What: /sys/class/powercap/.../<power zone>/enabled
147
Date: September 2013
148
KernelVersion: 3.13
149
Contact: linux-pm@vger.kernel.org
150
Description:
151
This allows to enable/disable power capping at power zone level.
152
This applies to current power zone and its children.
3. 한국어 전문 번역
영어 원문의 문단 순서와 의미를 유지한 전체 번역입니다. 코드, 함수명, symbol과 URL은 원문 표기를 유지합니다.
Power cap subsystem class
1-8| 항목 | 한국어 전문 번역 |
|---|---|
| What | /sys/class/powercap/ |
| Date | 2013년 9월 |
| KernelVersion | 3.13 |
| Contact | linux-pm@vger.kernel.org |
| Description | powercap/ class subdirectory는 power cap subsystem에 속합니다. 자세한 내용은 Documentation/power/powercap/powercap.rst를 참조하십시오. |
Power control type
10-17| 항목 | 한국어 전문 번역 |
|---|---|
| What | /sys/class/powercap/<control type> |
| Date | 2013년 9월 |
| KernelVersion | 3.13 |
| Contact | linux-pm@vger.kernel.org |
| Description | <control type>은 /sys/class/powercap 아래의 unique name입니다. Power를 제어하는 방식을 결정하며 하나의 <control type>은 여러 power zone을 포함할 수 있습니다. |
Control-type power capping enable
19-25| 항목 | 한국어 전문 번역 |
|---|---|
| What | /sys/class/powercap/<control type>/enabled |
| Date | 2013년 9월 |
| KernelVersion | 3.13 |
| Contact | linux-pm@vger.kernel.org |
| Description | "control type"의 power capping을 enable 또는 disable합니다. 이 상태는 해당 control type을 사용하는 모든 power zone에 영향을 줍니다. |
Independent power zone
27-35| 항목 | 한국어 전문 번역 |
|---|---|
| What | /sys/class/powercap/<control type>/<power zone> |
| Date | 2013년 9월 |
| KernelVersion | 3.13 |
| Contact | linux-pm@vger.kernel.org |
| Description | Power zone은 독립적으로 monitor하고 control할 수 있는 단일 device 또는 device collection입니다. Power zone sysfs entry는 <control type> name으로 qualify됩니다. 예는 intel-rapl:0:1:1입니다. |
Child power zone
37-46| 항목 | 한국어 전문 번역 |
|---|---|
| What | /sys/class/powercap/<control type>/<power zone>/<child power zone> |
| Date | 2013년 9월 |
| KernelVersion | 3.13 |
| Contact | linux-pm@vger.kernel.org |
| Description | Power zone은 hierarchy로 구성할 수 있으며 child power zone은 parent 아래 device subset을 monitor하고 control합니다. 예를 들어 전체 CPU package가 parent power zone이면 각 CPU core가 child power zone이 될 수 있습니다. |
/sys/class/powercap/→<control type>: power control 방식→<power zone>: 독립 monitoring·control 단위→<child power zone>: parent device subset
Control mechanism 아래 zone과 device subset인 child zone이 배치됩니다.
Power zone name
48-53| 항목 | 한국어 전문 번역 |
|---|---|
| What | /sys/class/powercap/.../<power zone>/name |
| Date | 2013년 9월 |
| KernelVersion | 3.13 |
| Contact | linux-pm@vger.kernel.org |
| Description | 이 power zone의 이름을 지정합니다. |
Current zone energy
55-62| 항목 | 한국어 전문 번역 |
|---|---|
| What | /sys/class/powercap/.../<power zone>/energy_uj |
| Date | 2013년 9월 |
| KernelVersion | 3.13 |
| Contact | linux-pm@vger.kernel.org |
| Description | Microjoule 단위의 current energy counter입니다. 0을 쓰면 reset합니다. Counter를 reset할 수 없으면 이 속성은 read-only입니다. |
Energy counter range
64-69| 항목 | 한국어 전문 번역 |
|---|---|
| What | /sys/class/powercap/.../<power zone>/max_energy_range_uj |
| Date | 2013년 9월 |
| KernelVersion | 3.13 |
| Contact | linux-pm@vger.kernel.org |
| Description | 위 energy counter의 range를 microjoule 단위로 제공합니다. |
Current zone power
72-77| 항목 | 한국어 전문 번역 |
|---|---|
| What | /sys/class/powercap/.../<power zone>/power_uw |
| Date | 2013년 9월 |
| KernelVersion | 3.13 |
| Contact | linux-pm@vger.kernel.org |
| Description | Current power를 microwatt 단위로 제공합니다. |
Power value range
79-84| 항목 | 한국어 전문 번역 |
|---|---|
| What | /sys/class/powercap/.../<power zone>/max_power_range_uw |
| Date | 2013년 9월 |
| KernelVersion | 3.13 |
| Contact | linux-pm@vger.kernel.org |
| Description | 위 power value의 range를 microwatt 단위로 제공합니다. |
측정Current valueRange단위
Energyenergy_ujmax_energy_range_ujµJ
Powerpower_uwmax_power_range_uwµW
Energy counter와 instantaneous power 및 각 range입니다.
Constraint name
86-93| 항목 | 한국어 전문 번역 |
|---|---|
| What | /sys/class/powercap/.../<power zone>/constraint_X_name |
| Date | 2013년 9월 |
| KernelVersion | 3.13 |
| Contact | linux-pm@vger.kernel.org |
| Description | 각 power zone은 하나 이상의 constraint를 정의할 수 있고 각 constraint에는 optional name이 있을 수 있습니다. X는 0부터 maximum integer까지의 값입니다. |
Constraint power limit
95-102| 항목 | 한국어 전문 번역 |
|---|---|
| What | /sys/class/powercap/.../<power zone>/constraint_X_power_limit_uw |
| Date | 2013년 9월 |
| KernelVersion | 3.13 |
| Contact | linux-pm@vger.kernel.org |
| Description | Microwatt 단위 power limit는 constraint_X_time_window_us가 지정한 time window에 적용되어야 합니다. X는 0부터 maximum integer까지의 값입니다. |
Constraint time window
104-111| 항목 | 한국어 전문 번역 |
|---|---|
| What | /sys/class/powercap/.../<power zone>/constraint_X_time_window_us |
| Date | 2013년 9월 |
| KernelVersion | 3.13 |
| Contact | linux-pm@vger.kernel.org |
| Description | Microsecond 단위 time window입니다. constraint_X_power_limit_uw와 함께 power constraint를 정의합니다. X는 0부터 maximum integer까지의 값입니다. |
Field의미단위
constraint_X_nameOptional constraint nameString
constraint_X_power_limit_uw적용 power limitµW
constraint_X_time_window_usLimit 적용 time windowµs
같은 X index의 name, power limit와 적용 window가 한 constraint를 이룹니다.
Maximum allowed constraint power
114-120| 항목 | 한국어 전문 번역 |
|---|---|
| What | /sys/class/powercap/<control type>/.../constraint_X_max_power_uw |
| Date | 2013년 9월 |
| KernelVersion | 3.13 |
| Contact | linux-pm@vger.kernel.org |
| Description | 이 constraint에 허용되는 maximum power를 microwatt 단위로 제공합니다. X는 0부터 maximum integer까지의 값입니다. |
Minimum allowed constraint power
122-128| 항목 | 한국어 전문 번역 |
|---|---|
| What | /sys/class/powercap/<control type>/.../constraint_X_min_power_uw |
| Date | 2013년 9월 |
| KernelVersion | 3.13 |
| Contact | linux-pm@vger.kernel.org |
| Description | 이 constraint에 허용되는 minimum power를 microwatt 단위로 제공합니다. X는 0부터 maximum integer까지의 값입니다. |
Maximum allowed time window
130-136| 항목 | 한국어 전문 번역 |
|---|---|
| What | /sys/class/powercap/.../<power zone>/constraint_X_max_time_window_us |
| Date | 2013년 9월 |
| KernelVersion | 3.13 |
| Contact | linux-pm@vger.kernel.org |
| Description | 이 constraint에 허용되는 maximum time window를 microsecond 단위로 제공합니다. X는 0부터 maximum integer까지의 값입니다. |
Minimum allowed time window
138-144| 항목 | 한국어 전문 번역 |
|---|---|
| What | /sys/class/powercap/.../<power zone>/constraint_X_min_time_window_us |
| Date | 2013년 9월 |
| KernelVersion | 3.13 |
| Contact | linux-pm@vger.kernel.org |
| Description | 이 constraint에 허용되는 minimum time window를 microsecond 단위로 제공합니다. X는 0부터 maximum integer까지의 값입니다. |
대상MinimumMaximum
Power (µW)constraint_X_min_power_uwconstraint_X_max_power_uw
Time window (µs)constraint_X_min_time_window_usconstraint_X_max_time_window_us
Power와 time window의 legal minimum·maximum을 별도 attribute로 제공합니다.
Zone-level power capping enable
146-152| 항목 | 한국어 전문 번역 |
|---|---|
| What | /sys/class/powercap/.../<power zone>/enabled |
| Date | 2013년 9월 |
| KernelVersion | 3.13 |
| Contact | linux-pm@vger.kernel.org |
| Description | Power zone level에서 power capping을 enable 또는 disable합니다. 현재 power zone과 그 child에 적용됩니다. |
속성 위치적용 범위
<control type>/enabled해당 control type을 사용하는 모든 power zone
<power zone>/enabled현재 power zone과 child zones
Control-type enable과 zone-level enable의 적용 범위입니다.
Powercap class and control types
sysfs-class-powercap:1-25Subsystem class, power control 방식별 unique control type과 전체 zone에 영향을 주는 enable을 설명합니다.