요약·해설과 원문, 전문 번역을 서로 분리했습니다. API 이름, symbol, source path는 원문 표기를 사용합니다.
1. 요약·해설
원문의 핵심 논리와 kernel programming 관점의 보충 설명입니다. 아래의 전문 번역과는 별도로 작성했습니다.
Profile 변경과 비동기 알림
sysfs-platform_profile:23-40현재 값을 읽고 표준 choice를 쓰며, userspace 밖에서 발생한 hotkey·firmware·kernel 변경도 POLLPRI로 알립니다.
2. 영어 원문 전체
번역 기준이 된 Linux v6.18.37 원문입니다. 줄 번호는 이 버전의 파일 좌표입니다.
원문 전체 펼치기
1
What: /sys/firmware/acpi/platform_profile_choices
2
Date: October 2020
3
Contact: Hans de Goede <[email protected]>
4
Description: This file contains a space-separated list of profiles supported for this device.
6
Drivers must use the following standard profile-names:
8
==================== ========================================
9
low-power Low power consumption
10
cool Cooler operation
11
quiet Quieter operation
12
balanced Balance between low power consumption
13
and performance
14
balanced-performance Balance between performance and low
15
power consumption with a slight bias
16
towards performance
17
performance High performance operation
18
==================== ========================================
20
Userspace may expect drivers to offer more than one of these
21
standard profile names.
23
What: /sys/firmware/acpi/platform_profile
24
Date: October 2020
25
Contact: Hans de Goede <[email protected]>
26
Description: Reading this file gives the current selected profile for this
27
device. Writing this file with one of the strings from
28
platform_profile_choices changes the profile to the new value.
30
This file can be monitored for changes by polling for POLLPRI,
31
POLLPRI will be signalled on any changes, independent of those
32
changes coming from a userspace write; or coming from another
33
source such as e.g. a hotkey triggered profile change handled
34
either directly by the embedded-controller or fully handled
35
inside the kernel.
37
This file may also emit the string 'custom' to indicate
38
that multiple platform profiles drivers are in use but
39
have different values. This string can not be written to
40
this interface and is solely for informational purposes.
3. 한국어 전문 번역
영어 원문의 문단 순서와 의미를 유지한 전체 번역입니다. 코드, 함수명, symbol과 URL은 원문 표기를 유지합니다.
ACPI platform profile sysfs ABI: platform profile choices
1-22| 항목 | 한국어 전문 번역 |
|---|---|
| What | /sys/firmware/acpi/platform_profile_choices |
| Date | 2020년 10월 |
| Contact | Hans de Goede <[email protected]> |
| Description | `/sys/firmware/acpi/platform_profile_choices`는 이 device가 지원하는 profiles를 space-separated list로 담습니다. Drivers는 표준 profile names인 `low-power`(낮은 power consumption), `cool`(더 시원한 동작), `quiet`(더 조용한 동작), `balanced`(낮은 power consumption과 performance의 균형), `balanced-performance`(performance 쪽으로 약간 치우친 performance와 낮은 power consumption의 균형), `performance`(높은 performance 동작)를 사용해야 합니다. Userspace는 drivers가 이 표준 names 중 하나보다 많은 choices를 제공할 것으로 기대할 수 있습니다. |
ProfileOperating goal
low-powerLow power consumption
coolCooler operation
quietQuieter operation
balancedBalance low power and performance
balanced-performanceBalance with a slight bias toward performance
performanceHigh performance operation
원문의 RST profile table을 같은 의미의 구조화 표로 다시 그렸습니다.
ACPI platform profile sysfs ABI: platform profile
23-40| 항목 | 한국어 전문 번역 |
|---|---|
| What | /sys/firmware/acpi/platform_profile |
| Date | 2020년 10월 |
| Contact | Hans de Goede <[email protected]> |
| Description | `/sys/firmware/acpi/platform_profile`을 read하면 device에 현재 선택된 profile이 반환됩니다. `platform_profile_choices`의 strings 중 하나를 write하면 새 profile로 변경됩니다. `POLLPRI`를 polling해 changes를 감시할 수 있으며, userspace write뿐 아니라 hotkey로 시작되어 embedded controller가 직접 처리하거나 kernel 내부에서 완전히 처리한 profile change 등 어떤 source의 변경에도 `POLLPRI`가 signal됩니다. 여러 platform-profile drivers가 사용 중이지만 values가 서로 다르면 이 file은 `custom` string을 emit할 수 있습니다. `custom`은 정보 표시 전용이므로 이 interface에 write할 수 없습니다. |
Userspace write→Profile changes→POLLPRI signalled
Hotkey or embedded controller→Profile changes→POLLPRI signalled
Kernel-internal handler→Profile changes→POLLPRI signalled
Multiple drivers with different values→Read custom→custom is not writable
변경 source와 관계없이 current profile update는 POLLPRI watcher로 전달됩니다.
표준 profile vocabulary
sysfs-platform_profile:1-22전력 절감, 소음, 냉각, 균형과 성능을 공통 이름으로 정규화해 userspace가 vendor와 무관하게 profile을 다룰 수 있게 합니다.