← Documents Documentation/ABI/testing/sysfs-class-platform-profile GitHub 원문 ↗

Linux 6.18.37 · ABI / testing

Platform profile class sysfs ABI

Platform profile class device의 driver-provided 이름, 표준 profile choice 목록, 현재 profile 변경과 POLLPRI notification을 설명합니다.

Source pathDocumentation/ABI/testing/sysfs-class-platform-profile
Source versionLinux v6.18.37
TranslationDUJINLABS 전문 번역 + 해설

요약·해설과 원문, 전문 번역을 서로 분리했습니다. API 이름, symbol, source path는 원문 표기를 사용합니다.

1. 요약·해설

원문의 핵심 논리와 kernel programming 관점의 보충 설명입니다. 아래의 전문 번역과는 별도로 작성했습니다.

Platform profile device name

sysfs-class-platform-profile:1-6

Driver가 class device에 부여한 이름을 read-only로 제공합니다.

Supported profile choices

sysfs-class-platform-profile:8-29

Device가 지원하는 profile을 space-separated list로 제공하며 driver가 사용할 표준 이름 일곱 개를 정의합니다.

Current profile and notifications

sysfs-class-platform-profile:31-48

현재 profile을 읽고 choices의 문자열로 변경하며 userspace·hotkey·kernel 변경을 POLLPRI로 알립니다.

2. 영어 원문 전체

번역 기준이 된 Linux v6.18.37 원문입니다. 줄 번호는 이 버전의 파일 좌표입니다.

원문 전체 펼치기
1 What: /sys/class/platform-profile/platform-profile-X/name
2 Date: March 2025
3 KernelVersion: 6.14
4 Description: Name of the class device given by the driver.
5
6 RO
7
8 What: /sys/class/platform-profile/platform-profile-X/choices
9 Date: March 2025
10 KernelVersion: 6.14
11 Description: This file contains a space-separated list of profiles supported
12 for this device.
13
14 Drivers must use the following standard profile-names:
15
16 ==================== ========================================
17 low-power Low power consumption
18 cool Cooler operation
19 quiet Quieter operation
20 balanced Balance between low power consumption
21 and performance
22 balanced-performance Balance between performance and low
23 power consumption with a slight bias
24 towards performance
25 performance High performance operation
26 custom Driver defined custom profile
27 ==================== ========================================
28
29 RO
30
31 What: /sys/class/platform-profile/platform-profile-X/profile
32 Date: March 2025
33 KernelVersion: 6.14
34 Description: Reading this file gives the current selected profile for this
35 device. Writing this file with one of the strings from
36 platform_profile_choices changes the profile to the new value.
37
38 This file can be monitored for changes by polling for POLLPRI,
39 POLLPRI will be signaled on any changes, independent of those
40 changes coming from a userspace write; or coming from another
41 source such as e.g. a hotkey triggered profile change handled
42 either directly by the embedded-controller or fully handled
43 inside the kernel.
44
45 This file may also emit the string 'custom' to indicate
46 that the driver is using a driver defined custom profile.
47
48 RW
49

3. 한국어 전문 번역

영어 원문의 문단 순서와 의미를 유지한 전체 번역입니다. 코드, 함수명, symbol과 URL은 원문 표기를 유지합니다.

Class device name

1-6
항목한국어 전문 번역
What/sys/class/platform-profile/platform-profile-X/name
Date2025년 3월
KernelVersion6.14
DescriptionDriver가 부여한 class device의 이름입니다. Read-only입니다.

Standard platform profile choices

8-29
항목한국어 전문 번역
What/sys/class/platform-profile/platform-profile-X/choices
Date2025년 3월
KernelVersion6.14
Description이 device가 지원하는 profile을 space-separated list로 담습니다. Driver는 표준 profile name인 low-power, cool, quiet, balanced, balanced-performance, performance, custom을 사용해야 합니다. Read-only입니다.
Standard platform profile names
Profile동작
low-power낮은 power consumption
cool더 낮은 온도의 동작
quiet더 조용한 동작
balanced낮은 power consumption과 performance 사이의 balance
balanced-performancePerformance 쪽으로 약간 기울어진 performance와 낮은 power consumption 사이의 balance
performanceHigh-performance 동작
customDriver가 정의한 custom profile

원문 ASCII 표의 driver 표준 profile name과 동작 목표입니다.

Current profile selection and polling

31-48
항목한국어 전문 번역
What/sys/class/platform-profile/platform-profile-X/profile
Date2025년 3월
KernelVersion6.14
Description이 file을 읽으면 device에 현재 선택된 profile을 반환합니다. platform_profile_choices의 문자열 중 하나를 쓰면 새 값으로 profile을 변경합니다. POLLPRI를 polling해 변경을 monitor할 수 있으며, userspace write뿐 아니라 embedded controller가 직접 처리하거나 kernel 내부에서 완전히 처리한 hotkey-triggered profile change 같은 다른 source의 변경에도 POLLPRI가 signal됩니다. Driver가 정의한 custom profile을 사용 중임을 나타내기 위해 'custom' 문자열을 내보낼 수도 있습니다. Read/write입니다.
Platform profile change notification
Userspace write 또는 hotkey·embedded-controller·kernel changeDevice profile 변경profile file에서 새 선택값 또는 custom 반환POLLPRI signal로 monitor에 notification

Profile change source와 관계없이 profile file의 POLLPRI notification으로 합쳐집니다.