xref: /linux/Documentation/ABI/testing/sysfs-bus-nvdimm (revision 452996fa079b1a8751a02ac04c54b1d69f512249)
1ed8c39d4SMauro Carvalho ChehabWhat:          nvdimm
2ed8c39d4SMauro Carvalho ChehabDate:          July 2020
3ed8c39d4SMauro Carvalho ChehabKernelVersion: 5.8
4ed8c39d4SMauro Carvalho ChehabContact:       Dan Williams <dan.j.williams@intel.com>
5ed8c39d4SMauro Carvalho ChehabDescription:
6ed8c39d4SMauro Carvalho Chehab
748001ea5SDan WilliamsThe libnvdimm sub-system implements a common sysfs interface for
848001ea5SDan Williamsplatform nvdimm resources. See Documentation/driver-api/nvdimm/.
92bec6d9aSKajol Jain
102bec6d9aSKajol JainWhat:           /sys/bus/event_source/devices/nmemX/format
112bec6d9aSKajol JainDate:           February 2022
122bec6d9aSKajol JainKernelVersion:  5.18
132bec6d9aSKajol JainContact:        Kajol Jain <kjain@linux.ibm.com>
142bec6d9aSKajol JainDescription:	(RO) Attribute group to describe the magic bits
152bec6d9aSKajol Jain		that go into perf_event_attr.config for a particular pmu.
162bec6d9aSKajol Jain		(See ABI/testing/sysfs-bus-event_source-devices-format).
172bec6d9aSKajol Jain
182bec6d9aSKajol Jain		Each attribute under this group defines a bit range of the
192bec6d9aSKajol Jain		perf_event_attr.config. Supported attribute is listed
202bec6d9aSKajol Jain		below::
212bec6d9aSKajol Jain		  event  = "config:0-4"  - event ID
222bec6d9aSKajol Jain
232bec6d9aSKajol Jain		For example::
242bec6d9aSKajol Jain			ctl_res_cnt = "event=0x1"
252bec6d9aSKajol Jain
262bec6d9aSKajol JainWhat:           /sys/bus/event_source/devices/nmemX/events
272bec6d9aSKajol JainDate:           February 2022
282bec6d9aSKajol JainKernelVersion:  5.18
292bec6d9aSKajol JainContact:        Kajol Jain <kjain@linux.ibm.com>
302bec6d9aSKajol JainDescription:	(RO) Attribute group to describe performance monitoring events
312bec6d9aSKajol Jain                for the nvdimm memory device. Each attribute in this group
322bec6d9aSKajol Jain                describes a single performance monitoring event supported by
332bec6d9aSKajol Jain                this nvdimm pmu.  The name of the file is the name of the event.
342bec6d9aSKajol Jain                (See ABI/testing/sysfs-bus-event_source-devices-events). A
352bec6d9aSKajol Jain                listing of the events supported by a given nvdimm provider type
362bec6d9aSKajol Jain                can be found in Documentation/driver-api/nvdimm/$provider.
372bec6d9aSKajol Jain
382bec6d9aSKajol JainWhat:          /sys/bus/event_source/devices/nmemX/cpumask
392bec6d9aSKajol JainDate:          February 2022
402bec6d9aSKajol JainKernelVersion:  5.18
412bec6d9aSKajol JainContact:        Kajol Jain <kjain@linux.ibm.com>
422bec6d9aSKajol JainDescription:	(RO) This sysfs file exposes the cpumask which is designated to
432bec6d9aSKajol Jain		to retrieve nvdimm pmu event counter data.
44bd429e53SDave Jiang
45bd429e53SDave JiangWhat:		/sys/bus/nd/devices/nmemX/cxl/id
46bd429e53SDave JiangDate:		November 2022
47bd429e53SDave JiangKernelVersion:	6.2
48bd429e53SDave JiangContact:	Dave Jiang <dave.jiang@intel.com>
49bd429e53SDave JiangDescription:	(RO) Show the id (serial) of the device. This is CXL specific.
50*452996faSDave Jiang
51*452996faSDave JiangWhat:		/sys/bus/nd/devices/nmemX/cxl/provider
52*452996faSDave JiangDate:		November 2022
53*452996faSDave JiangKernelVersion:	6.2
54*452996faSDave JiangContact:	Dave Jiang <dave.jiang@intel.com>
55*452996faSDave JiangDescription:	(RO) Shows the CXL bridge device that ties to a CXL memory device
56*452996faSDave Jiang		to this NVDIMM device. I.e. the parent of the device returned is
57*452996faSDave Jiang		a /sys/bus/cxl/devices/memX instance.
58