요약·해설과 원문, 전문 번역을 서로 분리했습니다. API 이름, symbol, source path는 원문 표기를 사용합니다.
1. 요약·해설
원문의 핵심 논리와 kernel programming 관점의 보충 설명입니다. 아래의 전문 번역과는 별도로 작성했습니다.
Bitstream selection and reload
sysfs-driver-genwqe:18-40curr_bitstream은 active default/backup image를 나타내고 next_bitstream과 reload_bitstream이 다음 image 선택과 PCIe card reset을 통한 reload를 담당합니다.
Telemetry, card state, clock and SR-IOV
sysfs-driver-genwqe:41-78Temperature, free-running timer, queue working time과 card state·base clock을 읽고 sriov_numvfs에 1-15 또는 0을 써 VF를 enable/disable합니다.
2. 영어 원문 전체
번역 기준이 된 Linux v6.18.37 원문입니다. 줄 번호는 이 버전의 파일 좌표입니다.
원문 전체 펼치기
1
What: /sys/class/genwqe/genwqe<n>_card/version
2
Date: Oct 2013
3
Contact: [email protected]
4
Description: Unique bitstream identification e.g.
5
'0000000330336283.00000000475a4950'.
7
What: /sys/class/genwqe/genwqe<n>_card/appid
8
Date: Oct 2013
9
Contact: [email protected]
10
Description: Identifies the currently active card application e.g. 'GZIP'
11
for compression/decompression.
13
What: /sys/class/genwqe/genwqe<n>_card/type
14
Date: Oct 2013
15
Contact: [email protected]
16
Description: Type of the card e.g. 'GenWQE5-A7'.
18
What: /sys/class/genwqe/genwqe<n>_card/curr_bitstream
19
Date: Oct 2013
20
Contact: [email protected]
21
Description: Currently active bitstream. 1 is default, 0 is backup.
23
What: /sys/class/genwqe/genwqe<n>_card/next_bitstream
24
Date: Oct 2013
25
Contact: [email protected]
26
Description: Interface to set the next bitstream to be used.
28
What: /sys/class/genwqe/genwqe<n>_card/reload_bitstream
29
Date: May 2014
30
Contact: [email protected]
31
Description: Interface to trigger a PCIe card reset to reload the bitstream.
33
::
35
sudo sh -c 'echo 1 > \
36
/sys/class/genwqe/genwqe0_card/reload_bitstream'
38
If successfully, the card will come back with the bitstream set
39
on 'next_bitstream'.
41
What: /sys/class/genwqe/genwqe<n>_card/tempsens
42
Date: Oct 2013
43
Contact: [email protected]
44
Description: Interface to read the cards temperature sense register.
46
What: /sys/class/genwqe/genwqe<n>_card/freerunning_timer
47
Date: Oct 2013
48
Contact: [email protected]
49
Description: Interface to read the cards free running timer.
50
Used for performance and utilization measurements.
52
What: /sys/class/genwqe/genwqe<n>_card/queue_working_time
53
Date: Oct 2013
54
Contact: [email protected]
55
Description: Interface to read queue working time.
56
Used for performance and utilization measurements.
58
What: /sys/class/genwqe/genwqe<n>_card/state
59
Date: Oct 2013
60
Contact: [email protected]
61
Description: State of the card: "unused", "used", "error".
63
What: /sys/class/genwqe/genwqe<n>_card/base_clock
64
Date: Oct 2013
65
Contact: [email protected]
66
Description: Base clock frequency of the card.
68
What: /sys/class/genwqe/genwqe<n>_card/device/sriov_numvfs
69
Date: Oct 2013
70
Contact: [email protected]
71
Description: Enable VFs (1..15)::
73
sudo sh -c 'echo 15 > \
74
/sys/bus/pci/devices/0000\:1b\:00.0/sriov_numvfs'
76
Disable VFs::
78
Write a 0 into the same sysfs entry.
3. 한국어 전문 번역
영어 원문의 문단 순서와 의미를 유지한 전체 번역입니다. 코드, 함수명, symbol과 URL은 원문 표기를 유지합니다.
Unique bitstream identification
1-6| 항목 | 한국어 전문 번역 |
|---|---|
| What | /sys/class/genwqe/genwqe<n>_card/version |
| Date | 2013년 10월 |
| Contact | [email protected] |
| Description | Unique bitstream identification을 반환합니다. 예시는 "0000000330336283.00000000475a4950"입니다. |
GroupAttributes
Identityversion, appid, type
Bitstream lifecyclecurr_bitstream, next_bitstream, reload_bitstream
Telemetrytempsens, freerunning_timer, queue_working_time
Runtime statestate, base_clock
Virtualizationdevice/sriov_numvfs
Card identity, bitstream lifecycle, telemetry와 virtualization controls를 묶었습니다.
Active card application identifier
7-12| 항목 | 한국어 전문 번역 |
|---|---|
| What | /sys/class/genwqe/genwqe<n>_card/appid |
| Date | 2013년 10월 |
| Contact | [email protected] |
| Description | Currently active한 card application을 식별합니다. 예를 들어 compression/decompression application은 "GZIP"으로 표시됩니다. |
GenWQE card type
13-17| 항목 | 한국어 전문 번역 |
|---|---|
| What | /sys/class/genwqe/genwqe<n>_card/type |
| Date | 2013년 10월 |
| Contact | [email protected] |
| Description | Card type을 반환합니다. 예시는 "GenWQE5-A7"입니다. |
Currently active bitstream
18-22| 항목 | 한국어 전문 번역 |
|---|---|
| What | /sys/class/genwqe/genwqe<n>_card/curr_bitstream |
| Date | 2013년 10월 |
| Contact | [email protected] |
| Description | Currently active한 bitstream을 반환합니다. 1은 default bitstream이고 0은 backup bitstream입니다. |
ValueActive bitstream
0Backup
1Default
Active image를 default와 backup으로 구분합니다.
Next bitstream selection
23-27| 항목 | 한국어 전문 번역 |
|---|---|
| What | /sys/class/genwqe/genwqe<n>_card/next_bitstream |
| Date | 2013년 10월 |
| Contact | [email protected] |
| Description | 다음에 사용할 bitstream을 설정하는 interface입니다. |
Reload selected bitstream
28-40| 항목 | 한국어 전문 번역 |
|---|---|
| What | /sys/class/genwqe/genwqe<n>_card/reload_bitstream |
| Date | 2014년 5월 |
| Contact | [email protected] |
| Description | Bitstream을 reload하도록 PCIe card reset을 trigger하는 interface입니다. 성공하면 card는 next_bitstream에 설정한 bitstream으로 다시 나타납니다. |
sudo sh -c 'echo 1 > \
/sys/class/genwqe/genwqe0_card/reload_bitstream'Set next_bitstream→Write 1 to reload_bitstream→Reset the PCIe card→Card returns with selected bitstream
next_bitstream selection이 reset 뒤 active image가 되는 순서입니다.
Card temperature-sense register
41-45| 항목 | 한국어 전문 번역 |
|---|---|
| What | /sys/class/genwqe/genwqe<n>_card/tempsens |
| Date | 2013년 10월 |
| Contact | [email protected] |
| Description | Card의 temperature sense register를 읽는 interface입니다. |
Card free-running timer
46-51| 항목 | 한국어 전문 번역 |
|---|---|
| What | /sys/class/genwqe/genwqe<n>_card/freerunning_timer |
| Date | 2013년 10월 |
| Contact | [email protected] |
| Description | Card의 free-running timer를 읽습니다. Performance와 utilization measurement에 사용합니다. |
Queue working time
52-57| 항목 | 한국어 전문 번역 |
|---|---|
| What | /sys/class/genwqe/genwqe<n>_card/queue_working_time |
| Date | 2013년 10월 |
| Contact | [email protected] |
| Description | Queue working time을 읽습니다. Performance와 utilization measurement에 사용합니다. |
GenWQE card state
58-62| 항목 | 한국어 전문 번역 |
|---|---|
| What | /sys/class/genwqe/genwqe<n>_card/state |
| Date | 2013년 10월 |
| Contact | [email protected] |
| Description | Card state를 "unused", "used" 또는 "error"로 반환합니다. |
StateMeaning
unusedCard is not in use
usedCard is in use
errorCard is in an error state
State attribute가 반환하는 세 가지 string입니다.
Card base-clock frequency
63-67| 항목 | 한국어 전문 번역 |
|---|---|
| What | /sys/class/genwqe/genwqe<n>_card/base_clock |
| Date | 2013년 10월 |
| Contact | [email protected] |
| Description | Card의 base clock frequency를 반환합니다. |
GenWQE SR-IOV virtual functions
68-78| 항목 | 한국어 전문 번역 |
|---|---|
| What | /sys/class/genwqe/genwqe<n>_card/device/sriov_numvfs |
| Date | 2013년 10월 |
| Contact | [email protected] |
| Description | 1-15를 write하면 해당 수의 VFs를 enable합니다. 같은 sysfs entry에 0을 write하면 VFs를 disable합니다. |
sudo sh -c 'echo 15 > \
/sys/bus/pci/devices/0000\:1b\:00.0/sriov_numvfs'Write valueResult
0Disable VFs
1-15Enable the requested number of VFs
sriov_numvfs write value가 VF allocation을 제어합니다.
Card and application identity
sysfs-driver-genwqe:1-17version, appid와 type이 bitstream identifier, active card application과 hardware type을 각각 보고합니다.