Documentation/ABI/testing/sysfs-class-rapidio

   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.
   9                 NOTE: An mport ID is not a RapidIO destination ID assigned to a
  10                 given local mport device.
  11
  12 What:           /sys/class/rapidio_port/rapidioN/sys_size
  13 Date:           Apr, 2014
  14 KernelVersion:  v3.15
  15 Contact:        Matt Porter <mporter@kernel.crashing.org>,
  16                 Alexandre Bounine <alexandre.bounine@idt.com>
  17 Description:
  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
  22 What:           /sys/class/rapidio_port/rapidioN/port_destid
  23 Date:           Apr, 2014
  24 KernelVersion:  v3.15
  25 Contact:        Matt Porter <mporter@kernel.crashing.org>,
  26                 Alexandre Bounine <alexandre.bounine@idt.com>
  27 Description:
  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
  35 After enumeration or discovery was performed for a given mport device,
  36 the corresponding subdirectory will also contain subdirectories for each
  37 child RapidIO device connected to the mport.
  38
  39 The example below shows mport device subdirectory with several child RapidIO
  40 devices attached to it.
  41
  42 [rio@rapidio ~]$ ls /sys/class/rapidio_port/rapidio0/ -l
  43 total 0
  44 drwxr-xr-x 3 root root    0 Feb 11 15:10 00:e:0001
  45 drwxr-xr-x 3 root root    0 Feb 11 15:10 00:e:0004
  46 drwxr-xr-x 3 root root    0 Feb 11 15:10 00:e:0007
  47 drwxr-xr-x 3 root root    0 Feb 11 15:10 00:s:0002
  48 drwxr-xr-x 3 root root    0 Feb 11 15:10 00:s:0003
  49 drwxr-xr-x 3 root root    0 Feb 11 15:10 00:s:0005
  50 lrwxrwxrwx 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
  52 drwxr-xr-x 2 root root    0 Feb 11 15:11 power
  53 lrwxrwxrwx 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