mirror of
https://mirrors.bfsu.edu.cn/git/linux.git
synced 2024-12-12 13:34:10 +08:00
08981d29c3
While humans may be able to understand that something like: /sys/bus/rapidio/devices/nn:d:iiii could actually mean: /sys/bus/rapidio/devices/00:e:0000 This is something that computers can't easily identify. As get_abi.pl needs to convert it into a regex, change What: lines to: /sys/bus/rapidio/devices/<nn>:<d>:<iiii> Which is the commonly-used pattern on ABI files for wildcards. Signed-off-by: Mauro Carvalho Chehab <mchehab+huawei@kernel.org> Link: https://lore.kernel.org/r/207762e994d50eec0bf8d61c3adf153030c821eb.1631782432.git.mchehab+huawei@kernel.org Signed-off-by: Greg Kroah-Hartman <gregkh@linuxfoundation.org>
202 lines
7.0 KiB
Plaintext
202 lines
7.0 KiB
Plaintext
What: /sys/bus/rapidio/devices/<nn>:<d>:<iiii>
|
|
Description:
|
|
For each RapidIO device, the RapidIO subsystem creates files in
|
|
an individual subdirectory with the following name format of
|
|
device_name "nn:d:iiii", where:
|
|
|
|
==== ========================================================
|
|
nn two-digit hexadecimal ID of RapidIO network where the
|
|
device resides
|
|
d device type: 'e' - for endpoint or 's' - for switch
|
|
iiii four-digit device destID for endpoints, or switchID for
|
|
switches
|
|
==== ========================================================
|
|
|
|
For example, below is a list of device directories that
|
|
represents a typical RapidIO network with one switch, one host,
|
|
and two agent endpoints, as it is seen by the enumerating host
|
|
(with destID = 1)::
|
|
|
|
/sys/bus/rapidio/devices/00:e:0000
|
|
/sys/bus/rapidio/devices/00:e:0002
|
|
/sys/bus/rapidio/devices/00:s:0001
|
|
|
|
NOTE:
|
|
An enumerating or discovering endpoint does not create a
|
|
sysfs entry for itself, this is why an endpoint with destID=1
|
|
is not shown in the list.
|
|
|
|
Attributes Common for All RapidIO Devices
|
|
-----------------------------------------
|
|
|
|
What: /sys/bus/rapidio/devices/<nn>:<d>:<iiii>/did
|
|
Date: Nov, 2005
|
|
KernelVersion: v2.6.15
|
|
Contact: Matt Porter <mporter@kernel.crashing.org>,
|
|
Alexandre Bounine <alexandre.bounine@idt.com>
|
|
Description:
|
|
(RO) returns the device identifier
|
|
|
|
What: /sys/bus/rapidio/devices/<nn>:<d>:<iiii>/vid
|
|
Date: Nov, 2005
|
|
KernelVersion: v2.6.15
|
|
Contact: Matt Porter <mporter@kernel.crashing.org>,
|
|
Alexandre Bounine <alexandre.bounine@idt.com>
|
|
Description:
|
|
(RO) returns the device vendor identifier
|
|
|
|
What: /sys/bus/rapidio/devices/<nn>:<d>:<iiii>/device_rev
|
|
Date: Nov, 2005
|
|
KernelVersion: v2.6.15
|
|
Contact: Matt Porter <mporter@kernel.crashing.org>,
|
|
Alexandre Bounine <alexandre.bounine@idt.com>
|
|
Description:
|
|
(RO) returns the device revision level
|
|
|
|
What: /sys/bus/rapidio/devices/<nn>:<d>:<iiii>/asm_did
|
|
Date: Nov, 2005
|
|
KernelVersion: v2.6.15
|
|
Contact: Matt Porter <mporter@kernel.crashing.org>,
|
|
Alexandre Bounine <alexandre.bounine@idt.com>
|
|
Description:
|
|
(RO) returns identifier for the assembly containing the device
|
|
|
|
What: /sys/bus/rapidio/devices/<nn>:<d>:<iiii>/asm_rev
|
|
Date: Nov, 2005
|
|
KernelVersion: v2.6.15
|
|
Contact: Matt Porter <mporter@kernel.crashing.org>,
|
|
Alexandre Bounine <alexandre.bounine@idt.com>
|
|
Description:
|
|
(RO) returns revision level of the assembly containing the
|
|
device
|
|
|
|
What: /sys/bus/rapidio/devices/<nn>:<d>:<iiii>/asm_vid
|
|
Date: Nov, 2005
|
|
KernelVersion: v2.6.15
|
|
Contact: Matt Porter <mporter@kernel.crashing.org>,
|
|
Alexandre Bounine <alexandre.bounine@idt.com>
|
|
Description:
|
|
(RO) returns vendor identifier of the assembly containing the
|
|
device
|
|
|
|
What: /sys/bus/rapidio/devices/<nn>:<d>:<iiii>/destid
|
|
Date: Mar, 2011
|
|
KernelVersion: v2.6.3
|
|
Contact: Matt Porter <mporter@kernel.crashing.org>,
|
|
Alexandre Bounine <alexandre.bounine@idt.com>
|
|
Description:
|
|
(RO) returns device destination ID assigned by the enumeration
|
|
routine
|
|
|
|
What: /sys/bus/rapidio/devices/<nn>:<d>:<iiii>/lprev
|
|
Date: Mar, 2011
|
|
KernelVersion: v2.6.39
|
|
Contact: Matt Porter <mporter@kernel.crashing.org>,
|
|
Alexandre Bounine <alexandre.bounine@idt.com>
|
|
Description:
|
|
(RO) returns name of previous device (switch) on the path to the
|
|
device that that owns this attribute
|
|
|
|
What: /sys/bus/rapidio/devices/<nn>:<d>:<iiii>/modalias
|
|
Date: Jul, 2013
|
|
KernelVersion: v3.11
|
|
Contact: Matt Porter <mporter@kernel.crashing.org>,
|
|
Alexandre Bounine <alexandre.bounine@idt.com>
|
|
Description:
|
|
(RO) returns the device modalias
|
|
|
|
What: /sys/bus/rapidio/devices/<nn>:<d>:<iiii>/config
|
|
Date: Nov, 2005
|
|
KernelVersion: v2.6.15
|
|
Contact: Matt Porter <mporter@kernel.crashing.org>,
|
|
Alexandre Bounine <alexandre.bounine@idt.com>
|
|
Description:
|
|
(RW) Binary attribute to read from and write to the device
|
|
configuration registers using the RapidIO maintenance
|
|
transactions. This attribute is similar in behaviour to the
|
|
"config" attribute of PCI devices and provides an access to the
|
|
RapidIO device registers using standard file read and write
|
|
operations.
|
|
|
|
RapidIO Switch Device Attributes
|
|
--------------------------------
|
|
|
|
RapidIO switches have additional attributes in sysfs. RapidIO subsystem supports
|
|
common and device-specific sysfs attributes for switches. Because switches are
|
|
integrated into the RapidIO subsystem, it offers a method to create
|
|
device-specific sysfs attributes by specifying a callback function that may be
|
|
set by the switch initialization routine during enumeration or discovery
|
|
process.
|
|
|
|
What: /sys/bus/rapidio/devices/<nn>:<s>:<iiii>/routes
|
|
Date: Nov, 2005
|
|
KernelVersion: v2.6.15
|
|
Contact: Matt Porter <mporter@kernel.crashing.org>,
|
|
Alexandre Bounine <alexandre.bounine@idt.com>
|
|
Description:
|
|
(RO) reports switch routing information in "destID port" format.
|
|
This attribute reports only valid routing table entries, one
|
|
line for each entry.
|
|
|
|
What: /sys/bus/rapidio/devices/<nn>:<s>:<iiii>/destid
|
|
Date: Mar, 2011
|
|
KernelVersion: v2.6.3
|
|
Contact: Matt Porter <mporter@kernel.crashing.org>,
|
|
Alexandre Bounine <alexandre.bounine@idt.com>
|
|
Description:
|
|
(RO) device destination ID of the associated device that defines
|
|
a route to the switch
|
|
|
|
What: /sys/bus/rapidio/devices/<nn>:<s>:<iiii>/hopcount
|
|
Date: Mar, 2011
|
|
KernelVersion: v2.6.39
|
|
Contact: Matt Porter <mporter@kernel.crashing.org>,
|
|
Alexandre Bounine <alexandre.bounine@idt.com>
|
|
Description:
|
|
(RO) number of hops on the path to the switch
|
|
|
|
What: /sys/bus/rapidio/devices/<nn>:<s>:<iiii>/lnext
|
|
Date: Mar, 2011
|
|
KernelVersion: v2.6.39
|
|
Contact: Matt Porter <mporter@kernel.crashing.org>,
|
|
Alexandre Bounine <alexandre.bounine@idt.com>
|
|
Description:
|
|
(RO) returns names of devices linked to the switch except one of
|
|
a device linked to the ingress port (reported as "lprev"). This
|
|
is an array names with number of lines equal to number of ports
|
|
in switch. If a switch port has no attached device, returns
|
|
"null" instead of a device name.
|
|
|
|
Device-specific Switch Attributes
|
|
---------------------------------
|
|
|
|
IDT_GEN2-
|
|
|
|
What: /sys/bus/rapidio/devices/<nn>:<s>:<iiii>/errlog
|
|
Date: Oct, 2010
|
|
KernelVersion: v2.6.37
|
|
Contact: Matt Porter <mporter@kernel.crashing.org>,
|
|
Alexandre Bounine <alexandre.bounine@idt.com>
|
|
Description:
|
|
(RO) reads contents of device error log until it is empty.
|
|
|
|
RapidIO Bus Attributes
|
|
----------------------
|
|
|
|
What: /sys/bus/rapidio/scan
|
|
Date: May, 2013
|
|
KernelVersion: v3.11
|
|
Contact: Matt Porter <mporter@kernel.crashing.org>,
|
|
Alexandre Bounine <alexandre.bounine@idt.com>
|
|
Description:
|
|
(WO) Allows to trigger enumeration discovery process from user
|
|
space. To initiate an enumeration or discovery process on
|
|
specific mport device, a user needs to write mport_ID (not
|
|
RapidIO destination ID) into this file. The mport_ID is a
|
|
sequential number (0 ... RIO_MAX_MPORTS) assigned to the mport
|
|
device. For example, for a machine with a single RapidIO
|
|
controller, mport_ID for that controller always will be 0. To
|
|
initiate RapidIO enumeration/discovery on all available mports a
|
|
user must write '-1' (or RIO_MPORT_ANY) into this attribute
|
|
file.
|