Documentation/ABI/testing/sysfs-class-rtrs-server GitHub 원문 ↗

Linux 6.18.37 · ABI / testing

RTRS server class sysfs ABI

RTRS server session·path directory, non-blocking disconnect, HCA/address metadata와 five-field RDMA 통계를 설명합니다.

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

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

1. 요약·해설

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

Server session and path tree

sysfs-class-rtrs-server:1-14

Client가 session과 path를 만들면 server에도 session-name 및 source@destination path directory를 생성합니다.

Path disconnect and identity

sysfs-class-rtrs-server:16-45

Server disconnect는 즉시 반환하는 non-blocking operation이며 path의 HCA name·port와 source·destination address를 제공합니다.

Server RDMA statistics

sysfs-class-rtrs-server:47-53

Read/write operation count·total size와 current inflight operation 수를 다섯 값으로 제공합니다.

2. 영어 원문 전체

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

원문 전체 펼치기
1 What: /sys/class/rtrs-server
2 Date: Feb 2020
3 KernelVersion: 5.7
4 Contact: Jack Wang <[email protected]> Danil Kipnis <[email protected]>
5 Description: When a user of RTRS API creates a new session on a client side, a
6 directory entry with the name of that session is created in here.
7
8 What: /sys/class/rtrs-server/<session-name>/paths/
9 Date: Feb 2020
10 KernelVersion: 5.7
11 Contact: Jack Wang <[email protected]> Danil Kipnis <[email protected]>
12 Description: When new path is created by writing to "add_path" entry on client side,
13 a directory entry named as <source address>@<destination address> is created
14 on server.
15
16 What: /sys/class/rtrs-server/<session-name>/paths/<src@dst>/disconnect
17 Date: Feb 2020
18 KernelVersion: 5.7
19 Contact: Jack Wang <[email protected]> Danil Kipnis <[email protected]>
20 Description: When "1" is written to the file, the RTRS session is being disconnected.
21 Operations is non-blocking and returns control immediately to the caller.
22
23 What: /sys/class/rtrs-server/<session-name>/paths/<src@dst>/hca_name
24 Date: Feb 2020
25 KernelVersion: 5.7
26 Contact: Jack Wang <[email protected]> Danil Kipnis <[email protected]>
27 Description: RO, Contains the name of HCA the connection established on.
28
29 What: /sys/class/rtrs-server/<session-name>/paths/<src@dst>/hca_port
30 Date: Feb 2020
31 KernelVersion: 5.7
32 Contact: Jack Wang <[email protected]> Danil Kipnis <[email protected]>
33 Description: RO, Contains the port number of active port traffic is going through.
34
35 What: /sys/class/rtrs-server/<session-name>/paths/<src@dst>/src_addr
36 Date: Feb 2020
37 KernelVersion: 5.7
38 Contact: Jack Wang <[email protected]> Danil Kipnis <[email protected]>
39 Description: RO, Contains the source address of the path
40
41 What: /sys/class/rtrs-server/<session-name>/paths/<src@dst>/dst_addr
42 Date: Feb 2020
43 KernelVersion: 5.7
44 Contact: Jack Wang <[email protected]> Danil Kipnis <[email protected]>
45 Description: RO, Contains the destination address of the path
46
47 What: /sys/class/rtrs-server/<session-name>/paths/<src@dst>/stats/rdma
48 Date: Feb 2020
49 KernelVersion: 5.7
50 Contact: Jack Wang <[email protected]> Danil Kipnis <[email protected]>
51 Description: Contains statistics regarding rdma operations and inflight operations.
52 The output consists of 5 values:
53 <read-count> <read-total-size> <write-count> <write-total-size> <inflights>
54

3. 한국어 전문 번역

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

RTRS server session directory

1-6
항목한국어 전문 번역
What/sys/class/rtrs-server
Date2020년 2월
KernelVersion5.7
ContactJack Wang <[email protected]> Danil Kipnis <[email protected]>
DescriptionClient side의 RTRS API user가 새 session을 만들면 이곳에 해당 session 이름의 directory entry를 생성합니다.

Server-side session paths

8-14
항목한국어 전문 번역
What/sys/class/rtrs-server/<session-name>/paths/
Date2020년 2월
KernelVersion5.7
ContactJack Wang <[email protected]> Danil Kipnis <[email protected]>
DescriptionClient side의 add_path entry에 써서 새 path를 만들면 server에 <source address>@<destination address> 이름의 directory entry를 생성합니다.
RTRS server hierarchy
Client session 생성/sys/class/rtrs-server/<session-name>Client add_pathpaths/<src@dst>

Client session과 add_path operation이 server의 matching session/path tree로 반영됩니다.

Disconnect an RTRS server session

16-21
항목한국어 전문 번역
What/sys/class/rtrs-server/<session-name>/paths/<src@dst>/disconnect
Date2020년 2월
KernelVersion5.7
ContactJack Wang <[email protected]> Danil Kipnis <[email protected]>
Description이 file에 1을 쓰면 RTRS session disconnect가 시작됩니다. Operation은 non-blocking이며 caller에게 즉시 control을 반환합니다.

Server path HCA name

23-27
항목한국어 전문 번역
What/sys/class/rtrs-server/<session-name>/paths/<src@dst>/hca_name
Date2020년 2월
KernelVersion5.7
ContactJack Wang <[email protected]> Danil Kipnis <[email protected]>
Description(RO) Connection을 수립한 HCA의 이름을 보관합니다.

Server path active HCA port

29-33
항목한국어 전문 번역
What/sys/class/rtrs-server/<session-name>/paths/<src@dst>/hca_port
Date2020년 2월
KernelVersion5.7
ContactJack Wang <[email protected]> Danil Kipnis <[email protected]>
Description(RO) Active traffic이 통과하는 port 번호를 보관합니다.

Server path source address

35-39
항목한국어 전문 번역
What/sys/class/rtrs-server/<session-name>/paths/<src@dst>/src_addr
Date2020년 2월
KernelVersion5.7
ContactJack Wang <[email protected]> Danil Kipnis <[email protected]>
Description(RO) Path의 source address를 보관합니다.

Server path destination address

41-45
항목한국어 전문 번역
What/sys/class/rtrs-server/<session-name>/paths/<src@dst>/dst_addr
Date2020년 2월
KernelVersion5.7
ContactJack Wang <[email protected]> Danil Kipnis <[email protected]>
Description(RO) Path의 destination address를 보관합니다.
RTRS server path metadata
Attribute의미
hca_nameConnection HCA name
hca_portActive traffic port
src_addrSource address
dst_addrDestination address

Server가 각 path에서 노출하는 connection identity입니다.

Server path RDMA statistics

47-53
항목한국어 전문 번역
What/sys/class/rtrs-server/<session-name>/paths/<src@dst>/stats/rdma
Date2020년 2월
KernelVersion5.7
ContactJack Wang <[email protected]> Danil Kipnis <[email protected]>
DescriptionRDMA operation과 inflight operation 통계를 다섯 값으로 보관합니다. 순서대로 read count, read total size, write count, write total size, inflight 수입니다.
<read-count> <read-total-size> <write-count> <write-total-size> <inflights>
RTRS server RDMA output
순서Field
1read-count
2read-total-size
3write-count
4write-total-size
5inflights

Server stats/rdma의 five-field 순서입니다.