xref: /linux/Documentation/ABI/testing/sysfs-class-rapidio (revision 71e2f4dd5a65bd8dbca0b77661e75eea471168f8)
1What:		/sys/class/rapidio_port
2Description:
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.
9		NOTE: An mport ID is not a RapidIO destination ID assigned to a
10		given local mport device.
11
12What:		/sys/class/rapidio_port/rapidioN/sys_size
13Date:		Apr, 2014
14KernelVersion:	v3.15
15Contact:	Matt Porter <mporter@kernel.crashing.org>,
16		Alexandre Bounine <alexandre.bounine@idt.com>
17Description:
18		(RO) reports RapidIO common transport system size:
19		0 = small (8-bit destination ID, max. 256 devices),
20		1 = large (16-bit destination ID, max. 65536 devices).
21
22What:		/sys/class/rapidio_port/rapidioN/port_destid
23Date:		Apr, 2014
24KernelVersion:	v3.15
25Contact:	Matt Porter <mporter@kernel.crashing.org>,
26		Alexandre Bounine <alexandre.bounine@idt.com>
27Description:
28		(RO) reports RapidIO destination ID assigned to the given
29		RapidIO mport device. If value 0xFFFFFFFF is returned this means
30		that no valid destination ID have been assigned to the mport
31		(yet). Normally, before enumeration/discovery have been executed
32		only fabric enumerating mports have a valid destination ID
33		assigned to them using "hdid=..." rapidio module parameter.
34
35After enumeration or discovery was performed for a given mport device,
36the corresponding subdirectory will also contain subdirectories for each
37child RapidIO device connected to the mport.
38
39The example below shows mport device subdirectory with several child RapidIO
40devices attached to it.
41
42[rio@rapidio ~]$ ls /sys/class/rapidio_port/rapidio0/ -l
43total 0
44drwxr-xr-x 3 root root    0 Feb 11 15:10 00:e:0001
45drwxr-xr-x 3 root root    0 Feb 11 15:10 00:e:0004
46drwxr-xr-x 3 root root    0 Feb 11 15:10 00:e:0007
47drwxr-xr-x 3 root root    0 Feb 11 15:10 00:s:0002
48drwxr-xr-x 3 root root    0 Feb 11 15:10 00:s:0003
49drwxr-xr-x 3 root root    0 Feb 11 15:10 00:s:0005
50lrwxrwxrwx 1 root root    0 Feb 11 15:11 device -> ../../../0000:01:00.0
51-r--r--r-- 1 root root 4096 Feb 11 15:11 port_destid
52drwxr-xr-x 2 root root    0 Feb 11 15:11 power
53lrwxrwxrwx 1 root root    0 Feb 11 15:04 subsystem -> ../../../../../../class/rapidio_port
54-r--r--r-- 1 root root 4096 Feb 11 15:11 sys_size
55-rw-r--r-- 1 root root 4096 Feb 11 15:04 uevent
56