RapidIO port class sysfs ABI | Linux 6.18.37

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

1. 요약·해설

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

RapidIO master port class

sysfs-class-rapidio:1-11

On-chip controller와 PCIe-to-RapidIO bridge를 rapidio_port class의 rapidioN master port로 노출합니다.

Transport system size

sysfs-class-rapidio:13-23

sys_size는 8-bit destination ID를 쓰는 small system과 16-bit ID를 쓰는 large system을 구분합니다.

Master port destination ID

sysfs-class-rapidio:25-37

port_destid는 mport destination ID를 보고하며 0xFFFFFFFF는 아직 valid ID가 없음을 뜻합니다.

Enumerated child devices

sysfs-class-rapidio:39-59

Enumeration 또는 discovery가 끝나면 mport directory 아래에 연결된 child RapidIO device directory가 나타납니다.

2. 영어 원문 전체

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

원문 전체 펼치기

1 What: /sys/class/rapidio_port

2 Description:

3 On-chip RapidIO controllers and PCIe-to-RapidIO bridges

4 (referenced as "Master Port" or "mport") are presented in sysfs

5 as the special class of devices: "rapidio_port".

6 The /sys/class/rapidio_port subdirectory contains individual

7 subdirectories named as "rapidioN" where N = mport ID registered

8 with RapidIO subsystem.

10 NOTE: An mport ID is not a RapidIO destination ID assigned to a

11 given local mport device.

13 What: /sys/class/rapidio_port/rapidio<N>/sys_size

14 Date: Apr, 2014

15 KernelVersion: v3.15

16 Contact: Matt Porter <[email protected]>,

17 Alexandre Bounine <[email protected]>

18 Description:

19 (RO) reports RapidIO common transport system size:

21 0 = small (8-bit destination ID, max. 256 devices),

23 1 = large (16-bit destination ID, max. 65536 devices).

25 What: /sys/class/rapidio_port/rapidio<N>/port_destid

26 Date: Apr, 2014

27 KernelVersion: v3.15

28 Contact: Matt Porter <[email protected]>,

29 Alexandre Bounine <[email protected]>

30 Description:

32 (RO) reports RapidIO destination ID assigned to the given

33 RapidIO mport device. If value 0xFFFFFFFF is returned this means

34 that no valid destination ID have been assigned to the mport

35 (yet). Normally, before enumeration/discovery have been executed

36 only fabric enumerating mports have a valid destination ID

37 assigned to them using "hdid=..." rapidio module parameter.

39 After enumeration or discovery was performed for a given mport device,

40 the corresponding subdirectory will also contain subdirectories for each

41 child RapidIO device connected to the mport.

43 The example below shows mport device subdirectory with several child RapidIO

44 devices attached to it::

46 [rio@rapidio ~]$ ls /sys/class/rapidio_port/rapidio0/ -l

47 total 0

48 drwxr-xr-x 3 root root 0 Feb 11 15:10 00:e:0001

49 drwxr-xr-x 3 root root 0 Feb 11 15:10 00:e:0004

50 drwxr-xr-x 3 root root 0 Feb 11 15:10 00:e:0007

51 drwxr-xr-x 3 root root 0 Feb 11 15:10 00:s:0002

52 drwxr-xr-x 3 root root 0 Feb 11 15:10 00:s:0003

53 drwxr-xr-x 3 root root 0 Feb 11 15:10 00:s:0005

54 lrwxrwxrwx 1 root root 0 Feb 11 15:11 device -> ../../../0000:01:00.0

55 -r--r--r-- 1 root root 4096 Feb 11 15:11 port_destid

56 drwxr-xr-x 2 root root 0 Feb 11 15:11 power

57 lrwxrwxrwx 1 root root 0 Feb 11 15:04 subsystem -> ../../../../../../class/rapidio_port

58 -r--r--r-- 1 root root 4096 Feb 11 15:11 sys_size

59 -rw-r--r-- 1 root root 4096 Feb 11 15:04 uevent

3. 한국어 전문 번역

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

RapidIO master port class

1-11

항목	한국어 전문 번역
What	/sys/class/rapidio_port
Description	On-chip RapidIO controller와 PCIe-to-RapidIO bridge는 "Master Port" 또는 "mport"라고 부르며, sysfs에서 "rapidio_port"라는 special device class로 표시됩니다. /sys/class/rapidio_port subdirectory에는 RapidIO subsystem에 등록된 mport ID N을 사용해 이름 붙인 rapidioN subdirectory가 각각 들어 있습니다. mport ID는 해당 local mport device에 할당된 RapidIO destination ID가 아닙니다.

항목

한국어 전문 번역

What

/sys/class/rapidio_port

Description

On-chip RapidIO controller와 PCIe-to-RapidIO bridge는 "Master Port" 또는 "mport"라고 부르며, sysfs에서 "rapidio_port"라는 special device class로 표시됩니다. /sys/class/rapidio_port subdirectory에는 RapidIO subsystem에 등록된 mport ID N을 사용해 이름 붙인 rapidioN subdirectory가 각각 들어 있습니다. mport ID는 해당 local mport device에 할당된 RapidIO destination ID가 아닙니다.

RapidIO port hierarchy

/sys/class/rapidio_portrapidioN: N은 registered mport IDEnumeration 또는 discoveryChild RapidIO device directories

Class 아래 mport instance가 있고 enumeration 뒤 각 연결 device가 child directory로 나타납니다.

RapidIO transport system size

13-23

항목	한국어 전문 번역
What	/sys/class/rapidio_port/rapidio<N>/sys_size
Date	2014년 4월
KernelVersion	v3.15
Contact	Matt Porter <[email protected]>, Alexandre Bounine <[email protected]>
Description	(RO) RapidIO common transport system size를 보고합니다. 0은 8-bit destination ID와 최대 256개 device를 사용하는 small system이고, 1은 16-bit destination ID와 최대 65,536개 device를 사용하는 large system입니다.

RapidIO system size values

sys_sizeSystemDestination ID최대 device

0Small8-bit256

1Large16-bit65,536

sys_size 값에 따른 destination ID width와 최대 device 수입니다.

RapidIO master port destination ID

25-59

항목	한국어 전문 번역
What	/sys/class/rapidio_port/rapidio<N>/port_destid
Date	2014년 4월
KernelVersion	v3.15
Contact	Matt Porter <[email protected]>, Alexandre Bounine <[email protected]>
Description	(RO) 해당 RapidIO mport device에 할당된 RapidIO destination ID를 보고합니다. 0xFFFFFFFF가 반환되면 mport에 아직 valid destination ID가 할당되지 않았다는 뜻입니다. 일반적으로 enumeration/discovery 전에는 fabric을 enumerate하는 mport만 "hdid=..." RapidIO module parameter로 할당한 valid destination ID를 가집니다. 해당 mport에서 enumeration 또는 discovery가 끝나면 연결된 각 child RapidIO device의 subdirectory도 mport subdirectory 아래에 나타납니다.

port_destid state

상태port_destid 또는 directory 의미

ID 미할당0xFFFFFFFF

Enumeration 전보통 fabric enumerating mport만 hdid=...로 valid ID 보유

Enumeration/discovery 후연결된 child RapidIO device directory 생성

Special value와 enumeration 전후 directory 상태를 함께 읽는 방법입니다.

[rio@rapidio ~]$ ls /sys/class/rapidio_port/rapidio0/ -l
total 0
drwxr-xr-x 3 root root    0 Feb 11 15:10 00:e:0001
drwxr-xr-x 3 root root    0 Feb 11 15:10 00:e:0004
drwxr-xr-x 3 root root    0 Feb 11 15:10 00:e:0007
drwxr-xr-x 3 root root    0 Feb 11 15:10 00:s:0002
drwxr-xr-x 3 root root    0 Feb 11 15:10 00:s:0003
drwxr-xr-x 3 root root    0 Feb 11 15:10 00:s:0005
lrwxrwxrwx 1 root root    0 Feb 11 15:11 device -> ../../../0000:01:00.0
-r--r--r-- 1 root root 4096 Feb 11 15:11 port_destid
drwxr-xr-x 2 root root    0 Feb 11 15:11 power
lrwxrwxrwx 1 root root    0 Feb 11 15:04 subsystem -> ../../../../../../class/rapidio_port
-r--r--r-- 1 root root 4096 Feb 11 15:11 sys_size
-rw-r--r-- 1 root root 4096 Feb 11 15:04 uevent