1 What: nvdimm 1 What: nvdimm
2 Date: July 2020 2 Date: July 2020
3 KernelVersion: 5.8 3 KernelVersion: 5.8
4 Contact: Dan Williams <dan.j.williams@int 4 Contact: Dan Williams <dan.j.williams@intel.com>
5 Description: 5 Description:
6 6
7 The libnvdimm sub-system implements a common s 7 The libnvdimm sub-system implements a common sysfs interface for
8 platform nvdimm resources. See Documentation/d 8 platform nvdimm resources. See Documentation/driver-api/nvdimm/.
9 9
10 What: /sys/bus/event_source/devices/ 10 What: /sys/bus/event_source/devices/nmemX/format
11 Date: February 2022 11 Date: February 2022
12 KernelVersion: 5.18 12 KernelVersion: 5.18
13 Contact: Kajol Jain <kjain@linux.ibm.com 13 Contact: Kajol Jain <kjain@linux.ibm.com>
14 Description: (RO) Attribute group to descri 14 Description: (RO) Attribute group to describe the magic bits
15 that go into perf_event_attr.c 15 that go into perf_event_attr.config for a particular pmu.
16 (See ABI/testing/sysfs-bus-eve 16 (See ABI/testing/sysfs-bus-event_source-devices-format).
17 17
18 Each attribute under this grou 18 Each attribute under this group defines a bit range of the
19 perf_event_attr.config. Suppor 19 perf_event_attr.config. Supported attribute is listed
20 below:: 20 below::
21 <<
22 event = "config:0-4" - eve 21 event = "config:0-4" - event ID
23 22
24 For example:: 23 For example::
25 !! 24 ctl_res_cnt = "event=0x1"
26 ctl_res_cnt = "event=0x1" <<
27 25
28 What: /sys/bus/event_source/devices/ 26 What: /sys/bus/event_source/devices/nmemX/events
29 Date: February 2022 27 Date: February 2022
30 KernelVersion: 5.18 28 KernelVersion: 5.18
31 Contact: Kajol Jain <kjain@linux.ibm.com 29 Contact: Kajol Jain <kjain@linux.ibm.com>
32 Description: (RO) Attribute group to descri 30 Description: (RO) Attribute group to describe performance monitoring events
33 for the nvdimm memory device. 31 for the nvdimm memory device. Each attribute in this group
34 describes a single performance 32 describes a single performance monitoring event supported by
35 this nvdimm pmu. The name of 33 this nvdimm pmu. The name of the file is the name of the event.
36 (See ABI/testing/sysfs-bus-eve 34 (See ABI/testing/sysfs-bus-event_source-devices-events). A
37 listing of the events supporte 35 listing of the events supported by a given nvdimm provider type
38 can be found in Documentation/ 36 can be found in Documentation/driver-api/nvdimm/$provider.
39 37
40 What: /sys/bus/event_source/devices/n 38 What: /sys/bus/event_source/devices/nmemX/cpumask
41 Date: February 2022 39 Date: February 2022
42 KernelVersion: 5.18 40 KernelVersion: 5.18
43 Contact: Kajol Jain <kjain@linux.ibm.com 41 Contact: Kajol Jain <kjain@linux.ibm.com>
44 Description: (RO) This sysfs file exposes t 42 Description: (RO) This sysfs file exposes the cpumask which is designated to
45 to retrieve nvdimm pmu event c 43 to retrieve nvdimm pmu event counter data.
46 44
47 What: /sys/bus/nd/devices/nmemX/cxl/ 45 What: /sys/bus/nd/devices/nmemX/cxl/id
48 Date: November 2022 46 Date: November 2022
49 KernelVersion: 6.2 47 KernelVersion: 6.2
50 Contact: Dave Jiang <dave.jiang@intel.co 48 Contact: Dave Jiang <dave.jiang@intel.com>
51 Description: (RO) Show the id (serial) of t 49 Description: (RO) Show the id (serial) of the device. This is CXL specific.
52 50
53 What: /sys/bus/nd/devices/nmemX/cxl/ 51 What: /sys/bus/nd/devices/nmemX/cxl/provider
54 Date: November 2022 52 Date: November 2022
55 KernelVersion: 6.2 53 KernelVersion: 6.2
56 Contact: Dave Jiang <dave.jiang@intel.co 54 Contact: Dave Jiang <dave.jiang@intel.com>
57 Description: (RO) Shows the CXL bridge devi 55 Description: (RO) Shows the CXL bridge device that ties to a CXL memory device
58 to this NVDIMM device. I.e. th 56 to this NVDIMM device. I.e. the parent of the device returned is
59 a /sys/bus/cxl/devices/memX in 57 a /sys/bus/cxl/devices/memX instance.
Linux® is a registered trademark of Linus Torvalds in the United States and other countries.
TOMOYO® is a registered trademark of NTT DATA CORPORATION.