← Documents Documentation/ABI/testing/sysfs-driver-genwqe GitHub 원문 ↗

Linux 6.18.37 · ABI / testing

GenWQE accelerator-card sysfs ABI

GenWQE card와 active application·bitstream identity, bitstream reload, telemetry·state, clock과 SR-IOV VF 제어 interfaces를 설명합니다.

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

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

1. 요약·해설

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

Card and application identity

sysfs-driver-genwqe:1-17

version, appid와 type이 bitstream identifier, active card application과 hardware type을 각각 보고합니다.

Bitstream selection and reload

sysfs-driver-genwqe:18-40

curr_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-78

Temperature, 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: haver@linux.vnet.ibm.com
4 Description: Unique bitstream identification e.g.
5 '0000000330336283.00000000475a4950'.
6
7 What: /sys/class/genwqe/genwqe<n>_card/appid
8 Date: Oct 2013
9 Contact: haver@linux.vnet.ibm.com
10 Description: Identifies the currently active card application e.g. 'GZIP'
11 for compression/decompression.
12
13 What: /sys/class/genwqe/genwqe<n>_card/type
14 Date: Oct 2013
15 Contact: haver@linux.vnet.ibm.com
16 Description: Type of the card e.g. 'GenWQE5-A7'.
17
18 What: /sys/class/genwqe/genwqe<n>_card/curr_bitstream
19 Date: Oct 2013
20 Contact: haver@linux.vnet.ibm.com
21 Description: Currently active bitstream. 1 is default, 0 is backup.
22
23 What: /sys/class/genwqe/genwqe<n>_card/next_bitstream
24 Date: Oct 2013
25 Contact: haver@linux.vnet.ibm.com
26 Description: Interface to set the next bitstream to be used.
27
28 What: /sys/class/genwqe/genwqe<n>_card/reload_bitstream
29 Date: May 2014
30 Contact: klebers@linux.vnet.ibm.com
31 Description: Interface to trigger a PCIe card reset to reload the bitstream.
32
33 ::
34
35 sudo sh -c 'echo 1 > \
36 /sys/class/genwqe/genwqe0_card/reload_bitstream'
37
38 If successfully, the card will come back with the bitstream set
39 on 'next_bitstream'.
40
41 What: /sys/class/genwqe/genwqe<n>_card/tempsens
42 Date: Oct 2013
43 Contact: haver@linux.vnet.ibm.com
44 Description: Interface to read the cards temperature sense register.
45
46 What: /sys/class/genwqe/genwqe<n>_card/freerunning_timer
47 Date: Oct 2013
48 Contact: haver@linux.vnet.ibm.com
49 Description: Interface to read the cards free running timer.
50 Used for performance and utilization measurements.
51
52 What: /sys/class/genwqe/genwqe<n>_card/queue_working_time
53 Date: Oct 2013
54 Contact: haver@linux.vnet.ibm.com
55 Description: Interface to read queue working time.
56 Used for performance and utilization measurements.
57
58 What: /sys/class/genwqe/genwqe<n>_card/state
59 Date: Oct 2013
60 Contact: haver@linux.vnet.ibm.com
61 Description: State of the card: "unused", "used", "error".
62
63 What: /sys/class/genwqe/genwqe<n>_card/base_clock
64 Date: Oct 2013
65 Contact: haver@linux.vnet.ibm.com
66 Description: Base clock frequency of the card.
67
68 What: /sys/class/genwqe/genwqe<n>_card/device/sriov_numvfs
69 Date: Oct 2013
70 Contact: haver@linux.vnet.ibm.com
71 Description: Enable VFs (1..15)::
72
73 sudo sh -c 'echo 15 > \
74 /sys/bus/pci/devices/0000\:1b\:00.0/sriov_numvfs'
75
76 Disable VFs::
77
78 Write a 0 into the same sysfs entry.
79

3. 한국어 전문 번역

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

Unique bitstream identification

1-6
항목한국어 전문 번역
What/sys/class/genwqe/genwqe<n>_card/version
Date2013년 10월
Contacthaver@linux.vnet.ibm.com
DescriptionUnique bitstream identification을 반환합니다. 예시는 "0000000330336283.00000000475a4950"입니다.
GenWQE sysfs interface groups
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
Date2013년 10월
Contacthaver@linux.vnet.ibm.com
DescriptionCurrently active한 card application을 식별합니다. 예를 들어 compression/decompression application은 "GZIP"으로 표시됩니다.

GenWQE card type

13-17
항목한국어 전문 번역
What/sys/class/genwqe/genwqe<n>_card/type
Date2013년 10월
Contacthaver@linux.vnet.ibm.com
DescriptionCard type을 반환합니다. 예시는 "GenWQE5-A7"입니다.

Currently active bitstream

18-22
항목한국어 전문 번역
What/sys/class/genwqe/genwqe<n>_card/curr_bitstream
Date2013년 10월
Contacthaver@linux.vnet.ibm.com
DescriptionCurrently active한 bitstream을 반환합니다. 1은 default bitstream이고 0은 backup bitstream입니다.
Current bitstream values
ValueActive bitstream
0Backup
1Default

Active image를 default와 backup으로 구분합니다.

Next bitstream selection

23-27
항목한국어 전문 번역
What/sys/class/genwqe/genwqe<n>_card/next_bitstream
Date2013년 10월
Contacthaver@linux.vnet.ibm.com
Description다음에 사용할 bitstream을 설정하는 interface입니다.

Reload selected bitstream

28-40
항목한국어 전문 번역
What/sys/class/genwqe/genwqe<n>_card/reload_bitstream
Date2014년 5월
Contactklebers@linux.vnet.ibm.com
DescriptionBitstream을 reload하도록 PCIe card reset을 trigger하는 interface입니다. 성공하면 card는 next_bitstream에 설정한 bitstream으로 다시 나타납니다.
sudo sh -c 'echo 1 > \
  /sys/class/genwqe/genwqe0_card/reload_bitstream'
GenWQE bitstream reload
Set next_bitstreamWrite 1 to reload_bitstreamReset the PCIe cardCard returns with selected bitstream

next_bitstream selection이 reset 뒤 active image가 되는 순서입니다.

Card temperature-sense register

41-45
항목한국어 전문 번역
What/sys/class/genwqe/genwqe<n>_card/tempsens
Date2013년 10월
Contacthaver@linux.vnet.ibm.com
DescriptionCard의 temperature sense register를 읽는 interface입니다.

Card free-running timer

46-51
항목한국어 전문 번역
What/sys/class/genwqe/genwqe<n>_card/freerunning_timer
Date2013년 10월
Contacthaver@linux.vnet.ibm.com
DescriptionCard의 free-running timer를 읽습니다. Performance와 utilization measurement에 사용합니다.

Queue working time

52-57
항목한국어 전문 번역
What/sys/class/genwqe/genwqe<n>_card/queue_working_time
Date2013년 10월
Contacthaver@linux.vnet.ibm.com
DescriptionQueue working time을 읽습니다. Performance와 utilization measurement에 사용합니다.

GenWQE card state

58-62
항목한국어 전문 번역
What/sys/class/genwqe/genwqe<n>_card/state
Date2013년 10월
Contacthaver@linux.vnet.ibm.com
DescriptionCard state를 "unused", "used" 또는 "error"로 반환합니다.
GenWQE card states
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
Date2013년 10월
Contacthaver@linux.vnet.ibm.com
DescriptionCard의 base clock frequency를 반환합니다.

GenWQE SR-IOV virtual functions

68-78
항목한국어 전문 번역
What/sys/class/genwqe/genwqe<n>_card/device/sriov_numvfs
Date2013년 10월
Contacthaver@linux.vnet.ibm.com
Description1-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'
SR-IOV VF control values
Write valueResult
0Disable VFs
1-15Enable the requested number of VFs

sriov_numvfs write value가 VF allocation을 제어합니다.