요약·해설과 원문, 전문 번역을 서로 분리했습니다. API 이름, symbol, source path는 원문 표기를 사용합니다.
1. 요약·해설
원문의 핵심 논리와 kernel programming 관점의 보충 설명입니다. 아래의 전문 번역과는 별도로 작성했습니다.
Hardware error-isolation policy
sysfs-driver-uacce:22-39isolate_strategy는 시간당 hardware error threshold를 0~65535로 설정하고 isolate는 1 unavailable, 0 available state를 읽습니다.
Algorithms and queue-region sizes
sysfs-driver-uacce:40-57algorithms는 newline-separated arbitrary strings를 제공하고 region_mmio_size와 region_dus_size는 queue file regions의 byte size를 반환합니다.
2. 영어 원문 전체
번역 기준이 된 Linux v6.18.37 원문입니다. 줄 번호는 이 버전의 파일 좌표입니다.
원문 전체 펼치기
1
What: /sys/class/uacce/<dev_name>/api
2
Date: Feb 2020
3
KernelVersion: 5.7
4
Contact: linux-accelerators@lists.ozlabs.org
5
Description: Api of the device
6
Can be any string and up to userspace to parse.
7
Application use the api to match the correct driver
9
What: /sys/class/uacce/<dev_name>/flags
10
Date: Feb 2020
11
KernelVersion: 5.7
12
Contact: linux-accelerators@lists.ozlabs.org
13
Description: Attributes of the device, see UACCE_DEV_xxx flag defined in uacce.h
15
What: /sys/class/uacce/<dev_name>/available_instances
16
Date: Feb 2020
17
KernelVersion: 5.7
18
Contact: linux-accelerators@lists.ozlabs.org
19
Description: Available instances left of the device
20
Return -ENODEV if uacce_ops get_available_instances is not provided
22
What: /sys/class/uacce/<dev_name>/isolate_strategy
23
Date: Nov 2022
24
KernelVersion: 6.1
25
Contact: linux-accelerators@lists.ozlabs.org
26
Description: (RW) A sysfs node that configure the error threshold for the hardware
27
isolation strategy. This size is a configured integer value, which is the
28
number of threshold for hardware errors occurred in one hour. The default is 0.
29
0 means never isolate the device. The maximum value is 65535. You can write
30
a number of threshold based on your hardware.
32
What: /sys/class/uacce/<dev_name>/isolate
33
Date: Nov 2022
34
KernelVersion: 6.1
35
Contact: linux-accelerators@lists.ozlabs.org
36
Description: (R) A sysfs node that read the device isolated state. The value 1
37
means the device is unavailable. The 0 means the device is
38
available.
40
What: /sys/class/uacce/<dev_name>/algorithms
41
Date: Feb 2020
42
KernelVersion: 5.7
43
Contact: linux-accelerators@lists.ozlabs.org
44
Description: Algorithms supported by this accelerator, separated by new line.
45
Can be any string and up to userspace to parse.
47
What: /sys/class/uacce/<dev_name>/region_mmio_size
48
Date: Feb 2020
49
KernelVersion: 5.7
50
Contact: linux-accelerators@lists.ozlabs.org
51
Description: Size (bytes) of mmio region queue file
53
What: /sys/class/uacce/<dev_name>/region_dus_size
54
Date: Feb 2020
55
KernelVersion: 5.7
56
Contact: linux-accelerators@lists.ozlabs.org
57
Description: Size (bytes) of dus region queue file
3. 한국어 전문 번역
영어 원문의 문단 순서와 의미를 유지한 전체 번역입니다. 코드, 함수명, symbol과 URL은 원문 표기를 유지합니다.
Accelerator API identifier
1-8| 항목 | 한국어 전문 번역 |
|---|---|
| What | /sys/class/uacce/<dev_name>/api |
| Date | 2020년 2월 |
| KernelVersion | 5.7 |
| Contact | linux-accelerators@lists.ozlabs.org |
| Description | Device의 API입니다. 임의 string일 수 있으며 userspace가 parse합니다. Application은 API를 사용해 올바른 driver를 match합니다. |
| Access | Read-only |
GroupAttributesPurpose
Identityapi, flagsDriver matching and device flags
Capacityavailable_instancesRemaining device instances
Isolationisolate_strategy, isolateThreshold and isolated state
AlgorithmsalgorithmsSupported accelerator algorithms
Regionsregion_mmio_size, region_dus_sizeQueue-file sizes in bytes
Identity, capacity, isolation과 queue-region attributes를 역할별로 정리했습니다.
Accelerator device flags
9-14| 항목 | 한국어 전문 번역 |
|---|---|
| What | /sys/class/uacce/<dev_name>/flags |
| Date | 2020년 2월 |
| KernelVersion | 5.7 |
| Contact | linux-accelerators@lists.ozlabs.org |
| Description | Device attributes이며 uacce.h에 정의된 UACCE_DEV_xxx flag를 참조합니다. |
| Access | Read-only |
Available accelerator instances
15-21| 항목 | 한국어 전문 번역 |
|---|---|
| What | /sys/class/uacce/<dev_name>/available_instances |
| Date | 2020년 2월 |
| KernelVersion | 5.7 |
| Contact | linux-accelerators@lists.ozlabs.org |
| Description | Device에 남은 available instances 수를 반환합니다. uacce_ops get_available_instances가 제공되지 않으면 -ENODEV를 반환합니다. |
| Access | Read-only |
Hardware isolation threshold
22-31| 항목 | 한국어 전문 번역 |
|---|---|
| What | /sys/class/uacce/<dev_name>/isolate_strategy |
| Date | 2022년 11월 |
| KernelVersion | 6.1 |
| Contact | linux-accelerators@lists.ozlabs.org |
| Description | Hardware isolation strategy의 error threshold를 구성하는 read-write node입니다. 값은 한 시간에 발생한 hardware errors의 threshold 수를 나타내는 integer입니다. Default는 0이고 0은 device를 절대 isolate하지 않음을 뜻합니다. Maximum은 65535이며 hardware에 맞는 threshold 수를 쓸 수 있습니다. |
| Access | Read-write |
| Values | 0 = never isolate; maximum 65535 |
Attribute / valueMeaning
isolate_strategy = 0Never isolate the device
isolate_strategy = 1..65535Errors per hour threshold
isolate = 0Device available
isolate = 1Device unavailable
Hourly error threshold와 isolate state values를 구분합니다.
Accelerator isolated state
32-39| 항목 | 한국어 전문 번역 |
|---|---|
| What | /sys/class/uacce/<dev_name>/isolate |
| Date | 2022년 11월 |
| KernelVersion | 6.1 |
| Contact | linux-accelerators@lists.ozlabs.org |
| Description | Device isolated state를 읽는 node입니다. 1은 device가 unavailable, 0은 available임을 뜻합니다. |
| Access | Read-only |
| Values | 1 = unavailable; 0 = available |
Supported accelerator algorithms
40-46| 항목 | 한국어 전문 번역 |
|---|---|
| What | /sys/class/uacce/<dev_name>/algorithms |
| Date | 2020년 2월 |
| KernelVersion | 5.7 |
| Contact | linux-accelerators@lists.ozlabs.org |
| Description | 이 accelerator가 지원하는 algorithms를 newline으로 구분해 반환합니다. 임의 string일 수 있으며 userspace가 parse합니다. |
| Access | Read-only |
MMIO queue-region size
47-52| 항목 | 한국어 전문 번역 |
|---|---|
| What | /sys/class/uacce/<dev_name>/region_mmio_size |
| Date | 2020년 2월 |
| KernelVersion | 5.7 |
| Contact | linux-accelerators@lists.ozlabs.org |
| Description | Queue file의 MMIO region size를 bytes 단위로 반환합니다. |
| Access | Read-only |
| Unit | Bytes |
DUS queue-region size
53-57| 항목 | 한국어 전문 번역 |
|---|---|
| What | /sys/class/uacce/<dev_name>/region_dus_size |
| Date | 2020년 2월 |
| KernelVersion | 5.7 |
| Contact | linux-accelerators@lists.ozlabs.org |
| Description | Queue file의 DUS region size를 bytes 단위로 반환합니다. |
| Access | Read-only |
| Unit | Bytes |
AttributeQueue-file regionUnit
region_mmio_sizeMMIOBytes
region_dus_sizeDUSBytes
두 region-size attributes와 공통 byte unit입니다.
API, flags and available instances
sysfs-driver-uacce:1-21api와 flags는 userspace driver matching·device attributes를 제공하고 available_instances는 남은 instance 수 또는 unsupported operation의 -ENODEV를 반환합니다.