Documentation/ABI/stable/sysfs-driver-dma-ioatdma GitHub 원문 ↗

Linux 6.18.37 · ABI / stable

Intel IOAT DMA stable sysfs ABI

IOAT DMA channel의 operation capability, descriptor ring 사용량과 전체 크기, device version 및 channel별 interrupt coalescing delay를 설명합니다.

Source pathDocumentation/ABI/stable/sysfs-driver-dma-ioatdma
Source versionLinux v6.18.37
TranslationDUJINLABS 전문 번역 + 해설

요약·해설, 영어 원문, 전체 번역을 구분해 실었습니다. API 이름, 코드 심벌, 소스 경로는 원문 표기를 유지합니다.

1. 요약·해설

원문의 핵심 내용을 정리하고 커널 프로그래밍에 필요한 설명을 덧붙였습니다. 아래의 전체 번역과는 별도로 작성한 해설입니다.

IOAT quickdata channel attribute

sysfs-driver-dma-ioatdma:1-30

PCI IOAT DMA channel마다 capability와 descriptor ring 상태, version, interrupt delay를 제공합니다.

2. 영어 원문 전체

번역에 사용한 Linux v6.18.37 원문입니다. 줄 번호는 해당 버전의 소스 파일을 기준으로 합니다.

원문 전체 펼치기
1 What: /sys/devices/pciXXXX:XX/0000:XX:XX.X/dma/dma<n>chan<n>/quickdata/cap
2 Date: December 3, 2009
3 KernelVersion: 2.6.32
5 Description: Capabilities the DMA supports.Currently there are DMA_PQ, DMA_PQ_VAL,
6 DMA_XOR,DMA_XOR_VAL,DMA_INTERRUPT.
7
8 What: /sys/devices/pciXXXX:XX/0000:XX:XX.X/dma/dma<n>chan<n>/quickdata/ring_active
9 Date: December 3, 2009
10 KernelVersion: 2.6.32
12 Description: The number of descriptors active in the ring.
13
14 What: /sys/devices/pciXXXX:XX/0000:XX:XX.X/dma/dma<n>chan<n>/quickdata/ring_size
15 Date: December 3, 2009
16 KernelVersion: 2.6.32
18 Description: Descriptor ring size, total number of descriptors available.
19
20 What: /sys/devices/pciXXXX:XX/0000:XX:XX.X/dma/dma<n>chan<n>/quickdata/version
21 Date: December 3, 2009
22 KernelVersion: 2.6.32
24 Description: Version of ioatdma device.
25
26 What: /sys/devices/pciXXXX:XX/0000:XX:XX.X/dma/dma<n>chan<n>/quickdata/intr_coalesce
27 Date: August 8, 2017
28 KernelVersion: 4.14
30 Description: Tune-able interrupt delay value per channel basis.
31

3. 한국어 전문 번역

영어 원문의 문단 순서와 의미에 맞춰 전체 내용을 번역했습니다. 코드, 함수명, 코드 심벌, URL은 원문 표기를 유지합니다.

IOAT DMA channel의 capability와 descriptor ring

1-30

모든 항목의 담당자는 [email protected]다. 공통 경로 prefix는 /sys/devices/pciXXXX:XX/0000:XX:XX.X/dma/dma<n>chan<n>/quickdata/이며 <n>은 DMA device와 channel instance를 나타낸다.

Descriptor ring의 전체 크기와 active 영역
DMA clientIOAT channel ringInterrupt
01 Descriptor 제출ring_active 증가작업 진행
02 가용 한계ring_size가 총 slot 수 결정완료 대기
03 Descriptor 완료ring_active 감소intr_coalesce delay 뒤 통지 가능

ring_size는 사용할 수 있는 descriptor 총수이고 ring_active는 그중 현재 처리 중인 수다.

경로 suffix도입설명
cap2009-12-03 · 2.6.32DMA가 지원하는 capability다. 현재 문서에 열거된 값은 DMA_PQ, DMA_PQ_VAL, DMA_XOR, DMA_XOR_VAL, DMA_INTERRUPT다.
ring_active2009-12-03 · 2.6.32Descriptor ring에서 현재 active 상태인 descriptor의 수다.
ring_size2009-12-03 · 2.6.32Descriptor ring의 크기, 즉 사용할 수 있는 descriptor의 총수다.
version2009-12-03 · 2.6.32IOAT DMA device의 version이다.
intr_coalesce2017-08-08 · 4.14Channel별로 조정할 수 있는 interrupt delay 값이다.