Documentation/ABI/testing/sysfs-class-cxl

   1 Slave contexts (eg. /sys/class/cxl/afu0.0s):
   2
   3 What:           /sys/class/cxl/<afu>/irqs_max
   4 Date:           September 2014
   5 Contact:        linuxppc-dev@lists.ozlabs.org
   6 Description:    read/write
   7                 Decimal value of maximum number of interrupts that can be
   8                 requested by userspace.  The default on probe is the maximum
   9                 that hardware can support (eg. 2037). Write values will limit
  10                 userspace applications to that many userspace interrupts. Must
  11                 be >= irqs_min.
  12
  13 What:           /sys/class/cxl/<afu>/irqs_min
  14 Date:           September 2014
  15 Contact:        linuxppc-dev@lists.ozlabs.org
  16 Description:    read only
  17                 Decimal value of the minimum number of interrupts that
  18                 userspace must request on a CXL_START_WORK ioctl. Userspace may
  19                 omit the num_interrupts field in the START_WORK IOCTL to get
  20                 this minimum automatically.
  21
  22 What:           /sys/class/cxl/<afu>/mmio_size
  23 Date:           September 2014
  24 Contact:        linuxppc-dev@lists.ozlabs.org
  25 Description:    read only
  26                 Decimal value of the size of the MMIO space that may be mmaped
  27                 by userspace.
  28
  29 What:           /sys/class/cxl/<afu>/modes_supported
  30 Date:           September 2014
  31 Contact:        linuxppc-dev@lists.ozlabs.org
  32 Description:    read only
  33                 List of the modes this AFU supports. One per line.
  34                 Valid entries are: "dedicated_process" and "afu_directed"
  35
  36 What:           /sys/class/cxl/<afu>/mode
  37 Date:           September 2014
  38 Contact:        linuxppc-dev@lists.ozlabs.org
  39 Description:    read/write
  40                 The current mode the AFU is using. Will be one of the modes
  41                 given in modes_supported. Writing will change the mode
  42                 provided that no user contexts are attached.
  43
  44
  45 What:           /sys/class/cxl/<afu>/prefault_mode
  46 Date:           September 2014
  47 Contact:        linuxppc-dev@lists.ozlabs.org
  48 Description:    read/write
  49                 Set the mode for prefaulting in segments into the segment table
  50                 when performing the START_WORK ioctl. Possible values:
  51                         none: No prefaulting (default)
  52                         work_element_descriptor: Treat the work element
  53                                  descriptor as an effective address and
  54                                  prefault what it points to.
  55                         all: all segments process calling START_WORK maps.
  56
  57 What:           /sys/class/cxl/<afu>/reset
  58 Date:           September 2014
  59 Contact:        linuxppc-dev@lists.ozlabs.org
  60 Description:    write only
  61                 Writing 1 here will reset the AFU provided there are not
  62                 contexts active on the AFU.
  63
  64 What:           /sys/class/cxl/<afu>/api_version
  65 Date:           September 2014
  66 Contact:        linuxppc-dev@lists.ozlabs.org
  67 Description:    read only
  68                 Decimal value of the current version of the kernel/user API.
  69
  70 What:           /sys/class/cxl/<afu>/api_version_com
  71 Date:           September 2014
  72 Contact:        linuxppc-dev@lists.ozlabs.org
  73 Description:    read only
  74                 Decimal value of the the lowest version of the userspace API
  75                 this this kernel supports.
  76
  77
  78
  79 Master contexts (eg. /sys/class/cxl/afu0.0m)
  80
  81 What:           /sys/class/cxl/<afu>m/mmio_size
  82 Date:           September 2014
  83 Contact:        linuxppc-dev@lists.ozlabs.org
  84 Description:    read only
  85                 Decimal value of the size of the MMIO space that may be mmaped
  86                 by userspace. This includes all slave contexts space also.
  87
  88 What:           /sys/class/cxl/<afu>m/pp_mmio_len
  89 Date:           September 2014
  90 Contact:        linuxppc-dev@lists.ozlabs.org
  91 Description:    read only
  92                 Decimal value of the Per Process MMIO space length.
  93
  94 What:           /sys/class/cxl/<afu>m/pp_mmio_off
  95 Date:           September 2014
  96 Contact:        linuxppc-dev@lists.ozlabs.org
  97 Description:    read only
  98                 Decimal value of the Per Process MMIO space offset.
  99
 100
 101 Card info (eg. /sys/class/cxl/card0)
 102
 103 What:           /sys/class/cxl/<card>/caia_version
 104 Date:           September 2014
 105 Contact:        linuxppc-dev@lists.ozlabs.org
 106 Description:    read only
 107                 Identifies the CAIA Version the card implements.
 108
 109 What:           /sys/class/cxl/<card>/psl_version
 110 Date:           September 2014
 111 Contact:        linuxppc-dev@lists.ozlabs.org
 112 Description:    read only
 113                 Identifies the revision level of the PSL.
 114
 115 What:           /sys/class/cxl/<card>/base_image
 116 Date:           September 2014
 117 Contact:        linuxppc-dev@lists.ozlabs.org
 118 Description:    read only
 119                 Identifies the revision level of the base image for devices
 120                 that support loadable PSLs. For FPGAs this field identifies
 121                 the image contained in the on-adapter flash which is loaded
 122                 during the initial program load.
 123
 124 What:           /sys/class/cxl/<card>/image_loaded
 125 Date:           September 2014
 126 Contact:        linuxppc-dev@lists.ozlabs.org
 127 Description:    read only
 128                 Will return "user" or "factory" depending on the image loaded
 129                 onto the card.