Documentation/ABI/testing/sysfs-bus-nvdimm

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