← Documents Documentation/ABI/testing/configfs-rdma_cm GitHub 원문 ↗

Linux 6.18.37 · ABI / testing

RDMA CM configfs testing ABI

RDMA CM configuration을 위한 configfs mount와 HCA directory 생성, port별 기본 RoCE mode 및 QP TOS 설정을 설명합니다.

Source pathDocumentation/ABI/testing/configfs-rdma_cm
Source versionLinux v6.18.37
TranslationDUJINLABS 전문 번역 + 해설

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

1. 요약·해설

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

RDMA CM configfs entry와 HCA directory

configfs-rdma_cm:1-13

Configfs를 /config에 mount하고 특정 HCA의 directory를 생성해 RDMA-CM attribute를 구성합니다.

Default RoCE mode

configfs-rdma_cm:16-22

HCA port에서 시작하는 RDMA-CM connection의 기본 RoCE type을 IB/RoCE v1 또는 RoCE v2로 설정합니다.

Default RoCE TOS

configfs-rdma_cm:24-30

RDMA-CM QP 생성 시 적용할 기본 TOS 0-255를 설정하며 rdma_set_option API로 override할 수 있습니다.

2. 영어 원문 전체

번역 기준이 된 Linux v6.18.37 원문입니다. 줄 번호는 이 버전의 파일 좌표입니다.

원문 전체 펼치기
1 What: /config/rdma_cm
2 Date: November 29, 2015
3 KernelVersion: 4.4.0
4 Description: Interface is used to configure RDMA-cable HCAs in respect to
5 RDMA-CM attributes.
6
7 Attributes are visible only when configfs is mounted. To mount
8 configfs in /config directory use:
9 # mount -t configfs none /config/
10
11 In order to set parameters related to a specific HCA, a directory
12 for this HCA has to be created:
13 mkdir -p /config/rdma_cm/<hca>
14
15
16 What: /config/rdma_cm/<hca>/ports/<port-num>/default_roce_mode
17 Date: November 29, 2015
18 KernelVersion: 4.4.0
19 Description: RDMA-CM based connections from HCA <hca> at port <port-num>
20 will be initiated with this RoCE type as default.
21 The possible RoCE types are either "IB/RoCE v1" or "RoCE v2".
22 This parameter has RW access.
23
24 What: /config/rdma_cm/<hca>/ports/<port-num>/default_roce_tos
25 Date: February 7, 2017
26 KernelVersion: 4.11.0
27 Description: RDMA-CM QPs from HCA <hca> at port <port-num>
28 will be created with this TOS as default.
29 This can be overridden by using the rdma_set_option API.
30 The possible RoCE TOS values are 0-255.
31

3. 한국어 전문 번역

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

RDMA-CM attribute configuration 진입점

1-13
항목내용
What/config/rdma_cm
Date2015년 11월 29일
KernelVersion4.4.0
DescriptionRDMA-CM attribute와 관련해 RDMA HCA를 구성하는 데 사용하는 interface이다.

Attribute는 configfs가 mount되어 있을 때만 보인다. `/config` directory에 configfs를 mount하려면 다음 명령을 사용한다.

# mount -t configfs none /config/

특정 HCA와 관련된 parameter를 설정하려면 해당 HCA의 directory를 만들어야 한다.

mkdir -p /config/rdma_cm/<hca>

Port별 기본 RoCE type

16-22
항목내용
What/config/rdma_cm/<hca>/ports/<port-num>/default_roce_mode
Date2015년 11월 29일
KernelVersion4.4.0
DescriptionHCA <hca>의 <port-num> port에서 시작하는 RDMA-CM 기반 connection은 이 RoCE type을 기본값으로 사용한다.
허용 type`IB/RoCE v1` 또는 `RoCE v2`
AccessRead/write

Port별 RDMA-CM QP 기본 TOS

24-30
항목내용
What/config/rdma_cm/<hca>/ports/<port-num>/default_roce_tos
Date2017년 2월 7일
KernelVersion4.11.0
DescriptionHCA <hca>의 <port-num> port에서 만드는 RDMA-CM QP는 이 TOS를 기본값으로 사용한다.
Override`rdma_set_option` API를 사용해 기본값을 override할 수 있다.
허용 값0-255
HCA port별 RDMA-CM 기본값 적용
Configfs를 /config에 mount/config/rdma_cm/<hca> 생성ports/<port-num>/default_roce_modeIB/RoCE v1 또는 RoCE v2RDMA-CM connection 기본 mode
Configfs를 /config에 mount/config/rdma_cm/<hca> 생성ports/<port-num>/default_roce_tos0-255RDMA-CM QP 기본 TOS
Applicationrdma_set_option()Connection별 TOS override

Configfs에서 지정한 mode와 TOS는 해당 HCA port에서 새 RDMA-CM connection과 QP를 만들 때 기본값으로 사용된다.