xref: /linux/Documentation/ABI/testing/sysfs-bus-cxl (revision 7d4b5ca2e2cb5d28db628ec79c706bcfa832feea)
1b39cb105SDan WilliamsWhat:		/sys/bus/cxl/devices/memX/firmware_version
2b39cb105SDan WilliamsDate:		December, 2020
3b39cb105SDan WilliamsKernelVersion:	v5.12
4b39cb105SDan WilliamsContact:	linux-cxl@vger.kernel.org
5b39cb105SDan WilliamsDescription:
6b39cb105SDan Williams		(RO) "FW Revision" string as reported by the Identify
7b39cb105SDan Williams		Memory Device Output Payload in the CXL-2.0
8b39cb105SDan Williams		specification.
9b39cb105SDan Williams
10b39cb105SDan WilliamsWhat:		/sys/bus/cxl/devices/memX/ram/size
11b39cb105SDan WilliamsDate:		December, 2020
12b39cb105SDan WilliamsKernelVersion:	v5.12
13b39cb105SDan WilliamsContact:	linux-cxl@vger.kernel.org
14b39cb105SDan WilliamsDescription:
15b39cb105SDan Williams		(RO) "Volatile Only Capacity" as bytes. Represents the
16b39cb105SDan Williams		identically named field in the Identify Memory Device Output
17b39cb105SDan Williams		Payload in the CXL-2.0 specification.
18b39cb105SDan Williams
19b39cb105SDan WilliamsWhat:		/sys/bus/cxl/devices/memX/pmem/size
20b39cb105SDan WilliamsDate:		December, 2020
21b39cb105SDan WilliamsKernelVersion:	v5.12
22b39cb105SDan WilliamsContact:	linux-cxl@vger.kernel.org
23b39cb105SDan WilliamsDescription:
24b39cb105SDan Williams		(RO) "Persistent Only Capacity" as bytes. Represents the
25b39cb105SDan Williams		identically named field in the Identify Memory Device Output
26b39cb105SDan Williams		Payload in the CXL-2.0 specification.
274812be97SDan Williams
284812be97SDan WilliamsWhat:		/sys/bus/cxl/devices/*/devtype
294812be97SDan WilliamsDate:		June, 2021
304812be97SDan WilliamsKernelVersion:	v5.14
314812be97SDan WilliamsContact:	linux-cxl@vger.kernel.org
324812be97SDan WilliamsDescription:
334812be97SDan Williams		CXL device objects export the devtype attribute which mirrors
344812be97SDan Williams		the same value communicated in the DEVTYPE environment variable
354812be97SDan Williams		for uevents for devices on the "cxl" bus.
364812be97SDan Williams
374812be97SDan WilliamsWhat:		/sys/bus/cxl/devices/portX/uport
384812be97SDan WilliamsDate:		June, 2021
394812be97SDan WilliamsKernelVersion:	v5.14
404812be97SDan WilliamsContact:	linux-cxl@vger.kernel.org
414812be97SDan WilliamsDescription:
424812be97SDan Williams		CXL port objects are enumerated from either a platform firmware
434812be97SDan Williams		device (ACPI0017 and ACPI0016) or PCIe switch upstream port with
444812be97SDan Williams		CXL component registers. The 'uport' symlink connects the CXL
454812be97SDan Williams		portX object to the device that published the CXL port
464812be97SDan Williams		capability.
47*7d4b5ca2SDan Williams
48*7d4b5ca2SDan WilliamsWhat:		/sys/bus/cxl/devices/portX/dportY
49*7d4b5ca2SDan WilliamsDate:		June, 2021
50*7d4b5ca2SDan WilliamsKernelVersion:	v5.14
51*7d4b5ca2SDan WilliamsContact:	linux-cxl@vger.kernel.org
52*7d4b5ca2SDan WilliamsDescription:
53*7d4b5ca2SDan Williams		CXL port objects are enumerated from either a platform firmware
54*7d4b5ca2SDan Williams		device (ACPI0017 and ACPI0016) or PCIe switch upstream port with
55*7d4b5ca2SDan Williams		CXL component registers. The 'dportY' symlink identifies one or
56*7d4b5ca2SDan Williams		more downstream ports that the upstream port may target in its
57*7d4b5ca2SDan Williams		decode of CXL memory resources.  The 'Y' integer reflects the
58*7d4b5ca2SDan Williams		hardware port unique-id used in the hardware decoder target
59*7d4b5ca2SDan Williams		list.
60