요약·해설과 원문, 전문 번역을 서로 분리했습니다. API 이름, symbol, source path는 원문 표기를 사용합니다.
1. 요약·해설
원문의 핵심 논리와 kernel programming 관점의 보충 설명입니다. 아래의 전문 번역과는 별도로 작성했습니다.
2. 영어 원문 전체
번역 기준이 된 Linux v6.18.37 원문입니다. 줄 번호는 이 버전의 파일 좌표입니다.
원문 전체 펼치기
.. SPDX-License-Identifier: GPL-2.0
.. include:: <isonum.txt>
======================================
Intel Performance and Energy Bias Hint
======================================
:Copyright: |copy| 2019 Intel Corporation
:Author: Rafael J. Wysocki <[email protected]>
.. kernel-doc:: arch/x86/kernel/cpu/intel_epb.c
:doc: overview
Intel Performance and Energy Bias Attribute in ``sysfs``
========================================================
The Intel Performance and Energy Bias Hint (EPB) value for a given (logical) CPU
can be checked or updated through a ``sysfs`` attribute (file) under
:file:`/sys/devices/system/cpu/cpu<N>/power/`, where the CPU number ``<N>``
is allocated at the system initialization time:
``energy_perf_bias``
Shows the current EPB value for the CPU in a sliding scale 0 - 15, where
a value of 0 corresponds to a hint preference for highest performance
and a value of 15 corresponds to the maximum energy savings.
In order to update the EPB value for the CPU, this attribute can be
written to, either with a number in the 0 - 15 sliding scale above, or
with one of the strings: "performance", "balance-performance", "normal",
"balance-power", "power" that represent values reflected by their
meaning.
This attribute is present for all online CPUs supporting the EPB
feature.
Note that while the EPB interface to the processor is defined at the logical CPU
level, the physical register backing it may be shared by multiple CPUs (for
example, SMT siblings or cores in one package). For this reason, updating the
EPB value for one CPU may cause the EPB values for other CPUs to change.
3. 한국어 전문 번역
영어 원문의 문단 순서와 의미를 유지한 전체 번역입니다. 코드, 함수명, symbol과 URL은 원문 표기를 유지합니다.
Intel 성능 및 에너지 편향 힌트
1-15이 문서는 `SPDX-License-Identifier: GPL-2.0`을 따르며, 저작권은 2019 Intel Corporation에 있습니다. 작성자는 Rafael J. Wysocki `<[email protected]>`입니다.
Intel Performance and Energy Bias Hint(EPB)의 개요는 `arch/x86/kernel/cpu/intel_epb.c`에 있는 kernel-doc 문서에서 가져옵니다.
.. kernel-doc:: arch/x86/kernel/cpu/intel_epb.c
:doc: overview
`sysfs`의 Intel 성능 및 에너지 편향 속성
16-23주어진 논리 CPU의 Intel Performance and Energy Bias Hint(EPB) 값은 시스템 초기화 때 할당된 CPU 번호 `<N>`을 사용해 `/sys/devices/system/cpu/cpu<N>/power/` 아래의 `sysfs` 속성 파일에서 확인하거나 갱신할 수 있습니다.
`energy_perf_bias`
24-37`energy_perf_bias`는 해당 CPU의 현재 EPB 값을 `0 - 15` 범위의 연속 척도로 표시합니다. 값 `0`은 최고 성능을 선호한다는 힌트이고, 값 `15`는 최대 에너지 절약을 뜻합니다.
CPU의 EPB 값을 갱신하려면 이 속성에 위의 `0 - 15` 범위 숫자를 쓰거나, 의미에 대응하는 `performance`, `balance-performance`, `normal`, `balance-power`, `power` 문자열 가운데 하나를 씁니다.
이 속성은 EPB 기능을 지원하는 모든 online CPU에 존재합니다.
요약과 해설
intel_epb.rst:1-41EPB는 성능과 에너지 절약 사이의 선호도를 프로세서에 전달하는 힌트입니다. 숫자와 의미 기반 문자열을 모두 받을 수 있지만, 물리 register 공유 때문에 한 logical CPU에 쓴 값이 다른 CPU에도 영향을 줄 수 있습니다.