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

Linux 6.18.37 · ABI / testing

OpenCAPI OCXL class sysfs ABI

OCXL AFU의 version·context 수, per-process와 global MMIO 영역, link reset 시 FPGA image reload 정책을 설명합니다.

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

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

1. 요약·해설

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

AFU version and contexts

sysfs-class-ocxl:1-18

AFU configuration space의 version과 현재·maximum context 수를 read-only 형식으로 제공합니다.

Per-process and global MMIO

sysfs-class-ocxl:20-38

Per-process·global MMIO size를 조회하고 AFU global MMIO area에 read/write access를 제공합니다.

FPGA reload on link reset

sysfs-class-ocxl:40-51

Vendor-specific FPGA logic이 지원하는 경우 link reset 때 flash image를 reload할지 제어합니다.

2. 영어 원문 전체

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

원문 전체 펼치기
1 What: /sys/class/ocxl/<afu name>/afu_version
2 Date: January 2018
4 Description: read only
5 Version of the AFU, in the format <major>:<minor>
6 Reflects what is read in the configuration space of the AFU
7
8 What: /sys/class/ocxl/<afu name>/contexts
9 Date: January 2018
11 Description: read only
12 Number of contexts for the AFU, in the format <n>/<max>
13 where:
14
15 ==== ===============================================
16 n number of currently active contexts, for debug
17 max maximum number of contexts supported by the AFU
18 ==== ===============================================
19
20 What: /sys/class/ocxl/<afu name>/pp_mmio_size
21 Date: January 2018
23 Description: read only
24 Size of the per-process mmio area, as defined in the
25 configuration space of the AFU
26
27 What: /sys/class/ocxl/<afu name>/global_mmio_size
28 Date: January 2018
30 Description: read only
31 Size of the global mmio area, as defined in the
32 configuration space of the AFU
33
34 What: /sys/class/ocxl/<afu name>/global_mmio_area
35 Date: January 2018
37 Description: read/write
38 Give access the global mmio area for the AFU
39
40 What: /sys/class/ocxl/<afu name>/reload_on_reset
41 Date: February 2020
43 Description: read/write
44 Control whether the FPGA is reloaded on a link reset. Enabled
45 through a vendor-specific logic block on the FPGA.
46
47 =========== ===========================================
48 0 Do not reload FPGA image from flash
49 1 Reload FPGA image from flash
50 unavailable The device does not support this capability
51 =========== ===========================================
52

3. 한국어 전문 번역

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

AFU version

1-6
항목한국어 전문 번역
What/sys/class/ocxl/<afu name>/afu_version
Date2018년 1월
Contact[email protected]
DescriptionRead-only입니다. AFU version을 <major>:<minor> 형식으로 제공합니다. AFU configuration space에서 읽은 내용을 반영합니다.

AFU context usage

8-18
항목한국어 전문 번역
What/sys/class/ocxl/<afu name>/contexts
Date2018년 1월
Contact[email protected]
DescriptionRead-only입니다. AFU의 context 수를 <n>/<max> 형식으로 제공합니다. n은 debugging을 위한 현재 active context 수이고, max는 AFU가 지원하는 maximum context 수입니다.
OCXL context fields
Field의미
n현재 active context 수, debugging 용도
maxAFU가 지원하는 maximum context 수

원문 ASCII 표의 <n>/<max> 형식을 구성하는 두 값을 정리합니다.

Per-process MMIO size

20-25
항목한국어 전문 번역
What/sys/class/ocxl/<afu name>/pp_mmio_size
Date2018년 1월
Contact[email protected]
DescriptionRead-only입니다. AFU configuration space에 정의된 per-process MMIO area의 크기입니다.

Global MMIO size

27-32
항목한국어 전문 번역
What/sys/class/ocxl/<afu name>/global_mmio_size
Date2018년 1월
Contact[email protected]
DescriptionRead-only입니다. AFU configuration space에 정의된 global MMIO area의 크기입니다.

Global MMIO access

34-38
항목한국어 전문 번역
What/sys/class/ocxl/<afu name>/global_mmio_area
Date2018년 1월
Contact[email protected]
DescriptionRead/write입니다. AFU의 global MMIO area에 access할 수 있게 합니다.
OCXL MMIO attributes
속성Access대상
pp_mmio_sizeRead-onlyPer-process MMIO area size
global_mmio_sizeRead-onlyGlobal MMIO area size
global_mmio_areaRead/writeAFU global MMIO area

Configuration-space 크기 정보와 실제 global area access를 구분합니다.

FPGA reload policy

40-51
항목한국어 전문 번역
What/sys/class/ocxl/<afu name>/reload_on_reset
Date2020년 2월
Contact[email protected]
DescriptionRead/write입니다. Link reset 시 FPGA를 reload할지 제어합니다. FPGA의 vendor-specific logic block을 통해 enable됩니다. 0은 flash에서 FPGA image를 reload하지 않음, 1은 flash에서 FPGA image를 reload함, unavailable은 device가 이 capability를 지원하지 않음을 뜻합니다.
reload_on_reset values
Link reset 동작
0Flash에서 FPGA image를 reload하지 않음
1Flash에서 FPGA image를 reload
unavailableDevice가 이 capability를 지원하지 않음

원문 ASCII 표의 FPGA image reload 동작입니다.