Intel IOMMU PMU sysfs ABI | Linux 6.18.37

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

1. 요약·해설

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

IOMMU event와 filter bitfields

sysfs-bus-event_source-devices-iommu:1-29

format group은 perf_event_attr.config의 event fields와 config1·config2의 filter enable 및 value fields가 차지하는 bit ranges를 정의합니다.

IOMMU PMU bound CPU

sysfs-bus-event_source-devices-iommu:31-37

cpumask는 모든 IOMMU PMU performance monitoring events에 접근하기 위해 PMU가 bind된 CPU를 반환합니다.

2. 영어 원문 전체

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

원문 전체 펼치기

1 What: /sys/bus/event_source/devices/dmar*/format

2 Date: Jan 2023

3 KernelVersion: 6.3

4 Contact: Kan Liang <kan.liang@linux.intel.com>

5 Description: Read-only. Attribute group to describe the magic bits

6 that go into perf_event_attr.config,

7 perf_event_attr.config1 or perf_event_attr.config2 for

8 the IOMMU pmu. (See also

9 ABI/testing/sysfs-bus-event_source-devices-format).

11 Each attribute in this group defines a bit range in

12 perf_event_attr.config, perf_event_attr.config1,

13 or perf_event_attr.config2. All supported attributes

14 are listed below (See the VT-d Spec 4.0 for possible

15 attribute values)::

17 event = "config:0-27" - event ID

18 event_group = "config:28-31" - event group ID

20 filter_requester_en = "config1:0" - Enable Requester ID filter

21 filter_domain_en = "config1:1" - Enable Domain ID filter

22 filter_pasid_en = "config1:2" - Enable PASID filter

23 filter_ats_en = "config1:3" - Enable Address Type filter

24 filter_page_table_en= "config1:4" - Enable Page Table Level filter

25 filter_requester_id = "config1:16-31" - Requester ID filter

26 filter_domain = "config1:32-47" - Domain ID filter

27 filter_pasid = "config2:0-21" - PASID filter

28 filter_ats = "config2:24-28" - Address Type filter

29 filter_page_table = "config2:32-36" - Page Table Level filter

31 What: /sys/bus/event_source/devices/dmar*/cpumask

32 Date: Jan 2023

33 KernelVersion: 6.3

34 Contact: Kan Liang <kan.liang@linux.intel.com>

35 Description: Read-only. This file always returns the CPU to which the

36 IOMMU pmu is bound for access to all IOMMU pmu performance

37 monitoring events.

3. 한국어 전문 번역

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

Intel IOMMU PMU event format

1-29

항목	전문 번역
What	/sys/bus/event_source/devices/dmar*/format
Date	2023년 1월
KernelVersion	6.3
Contact	Kan Liang <kan.liang@linux.intel.com>
Description	Read-only입니다. IOMMU PMU에서 perf_event_attr.config, perf_event_attr.config1 또는 perf_event_attr.config2에 들어가는 magic bits를 설명하는 attribute group입니다. ABI/testing/sysfs-bus-event_source-devices-format도 참조합니다. 이 group의 각 attribute는 config, config1 또는 config2의 bit range를 정의하며 가능한 values는 VT-d Spec 4.0을 참조합니다.

Attribute	Bit range	의미
event	config:0-27	Event ID
event_group	config:28-31	Event group ID
filter_requester_en	config1:0	Requester ID filter enable
filter_domain_en	config1:1	Domain ID filter enable
filter_pasid_en	config1:2	PASID filter enable
filter_ats_en	config1:3	Address Type filter enable
filter_page_table_en	config1:4	Page Table Level filter enable
filter_requester_id	config1:16-31	Requester ID filter
filter_domain	config1:32-47	Domain ID filter
filter_pasid	config2:0-21	PASID filter
filter_ats	config2:24-28	Address Type filter
filter_page_table	config2:32-36	Page Table Level filter

Intel IOMMU PMU bound CPU

31-37

항목	전문 번역
What	/sys/bus/event_source/devices/dmar*/cpumask
Date	2023년 1월
KernelVersion	6.3
Contact	Kan Liang <kan.liang@linux.intel.com>
Description	Read-only입니다. 이 file은 모든 IOMMU PMU performance monitoring events에 접근하기 위해 IOMMU PMU가 bind된 CPU를 항상 반환합니다.