1Note: Attributes that are shared between devices are stored in the directory 2pointed to by the symlink device/. 3Example: The real path of the attribute /sys/class/cxl/afu0.0s/irqs_max is 4/sys/class/cxl/afu0.0s/device/irqs_max, i.e. /sys/class/cxl/afu0.0/irqs_max. 5 6 7Slave contexts (eg. /sys/class/cxl/afu0.0s): 8 9What: /sys/class/cxl/<afu>/afu_err_buf 10Date: September 2014 11Contact: linuxppc-dev@lists.ozlabs.org 12Description: read only 13 AFU Error Buffer contents. The contents of this file are 14 application specific and depends on the AFU being used. 15 Applications interacting with the AFU can use this attribute 16 to know about the current error condition and take appropriate 17 action like logging the event etc. 18 19 20What: /sys/class/cxl/<afu>/irqs_max 21Date: September 2014 22Contact: linuxppc-dev@lists.ozlabs.org 23Description: read/write 24 Decimal value of maximum number of interrupts that can be 25 requested by userspace. The default on probe is the maximum 26 that hardware can support (eg. 2037). Write values will limit 27 userspace applications to that many userspace interrupts. Must 28 be >= irqs_min. 29Users: https://github.com/ibm-capi/libcxl 30 31What: /sys/class/cxl/<afu>/irqs_min 32Date: September 2014 33Contact: linuxppc-dev@lists.ozlabs.org 34Description: read only 35 Decimal value of the minimum number of interrupts that 36 userspace must request on a CXL_START_WORK ioctl. Userspace may 37 omit the num_interrupts field in the START_WORK IOCTL to get 38 this minimum automatically. 39Users: https://github.com/ibm-capi/libcxl 40 41What: /sys/class/cxl/<afu>/mmio_size 42Date: September 2014 43Contact: linuxppc-dev@lists.ozlabs.org 44Description: read only 45 Decimal value of the size of the MMIO space that may be mmaped 46 by userspace. 47Users: https://github.com/ibm-capi/libcxl 48 49What: /sys/class/cxl/<afu>/modes_supported 50Date: September 2014 51Contact: linuxppc-dev@lists.ozlabs.org 52Description: read only 53 List of the modes this AFU supports. One per line. 54 Valid entries are: "dedicated_process" and "afu_directed" 55Users: https://github.com/ibm-capi/libcxl 56 57What: /sys/class/cxl/<afu>/mode 58Date: September 2014 59Contact: linuxppc-dev@lists.ozlabs.org 60Description: read/write 61 The current mode the AFU is using. Will be one of the modes 62 given in modes_supported. Writing will change the mode 63 provided that no user contexts are attached. 64Users: https://github.com/ibm-capi/libcxl 65 66 67What: /sys/class/cxl/<afu>/prefault_mode 68Date: September 2014 69Contact: linuxppc-dev@lists.ozlabs.org 70Description: read/write 71 Set the mode for prefaulting in segments into the segment table 72 when performing the START_WORK ioctl. Possible values: 73 none: No prefaulting (default) 74 work_element_descriptor: Treat the work element 75 descriptor as an effective address and 76 prefault what it points to. 77 all: all segments process calling START_WORK maps. 78Users: https://github.com/ibm-capi/libcxl 79 80What: /sys/class/cxl/<afu>/reset 81Date: September 2014 82Contact: linuxppc-dev@lists.ozlabs.org 83Description: write only 84 Writing 1 here will reset the AFU provided there are not 85 contexts active on the AFU. 86Users: https://github.com/ibm-capi/libcxl 87 88What: /sys/class/cxl/<afu>/api_version 89Date: September 2014 90Contact: linuxppc-dev@lists.ozlabs.org 91Description: read only 92 Decimal value of the current version of the kernel/user API. 93Users: https://github.com/ibm-capi/libcxl 94 95What: /sys/class/cxl/<afu>/api_version_compatible 96Date: September 2014 97Contact: linuxppc-dev@lists.ozlabs.org 98Description: read only 99 Decimal value of the the lowest version of the userspace API 100 this this kernel supports. 101Users: https://github.com/ibm-capi/libcxl 102 103 104AFU configuration records (eg. /sys/class/cxl/afu0.0/cr0): 105 106An AFU may optionally export one or more PCIe like configuration records, known 107as AFU configuration records, which will show up here (if present). 108 109What: /sys/class/cxl/<afu>/cr<config num>/vendor 110Date: February 2015 111Contact: linuxppc-dev@lists.ozlabs.org 112Description: read only 113 Hexadecimal value of the vendor ID found in this AFU 114 configuration record. 115Users: https://github.com/ibm-capi/libcxl 116 117What: /sys/class/cxl/<afu>/cr<config num>/device 118Date: February 2015 119Contact: linuxppc-dev@lists.ozlabs.org 120Description: read only 121 Hexadecimal value of the device ID found in this AFU 122 configuration record. 123Users: https://github.com/ibm-capi/libcxl 124 125What: /sys/class/cxl/<afu>/cr<config num>/class 126Date: February 2015 127Contact: linuxppc-dev@lists.ozlabs.org 128Description: read only 129 Hexadecimal value of the class code found in this AFU 130 configuration record. 131Users: https://github.com/ibm-capi/libcxl 132 133What: /sys/class/cxl/<afu>/cr<config num>/config 134Date: February 2015 135Contact: linuxppc-dev@lists.ozlabs.org 136Description: read only 137 This binary file provides raw access to the AFU configuration 138 record. The format is expected to match the either the standard 139 or extended configuration space defined by the PCIe 140 specification. 141Users: https://github.com/ibm-capi/libcxl 142 143 144 145Master contexts (eg. /sys/class/cxl/afu0.0m) 146 147What: /sys/class/cxl/<afu>m/mmio_size 148Date: September 2014 149Contact: linuxppc-dev@lists.ozlabs.org 150Description: read only 151 Decimal value of the size of the MMIO space that may be mmaped 152 by userspace. This includes all slave contexts space also. 153Users: https://github.com/ibm-capi/libcxl 154 155What: /sys/class/cxl/<afu>m/pp_mmio_len 156Date: September 2014 157Contact: linuxppc-dev@lists.ozlabs.org 158Description: read only 159 Decimal value of the Per Process MMIO space length. 160Users: https://github.com/ibm-capi/libcxl 161 162What: /sys/class/cxl/<afu>m/pp_mmio_off (not in a guest) 163Date: September 2014 164Contact: linuxppc-dev@lists.ozlabs.org 165Description: read only 166 Decimal value of the Per Process MMIO space offset. 167Users: https://github.com/ibm-capi/libcxl 168 169 170Card info (eg. /sys/class/cxl/card0) 171 172What: /sys/class/cxl/<card>/caia_version 173Date: September 2014 174Contact: linuxppc-dev@lists.ozlabs.org 175Description: read only 176 Identifies the CAIA Version the card implements. 177Users: https://github.com/ibm-capi/libcxl 178 179What: /sys/class/cxl/<card>/psl_revision 180Date: September 2014 181Contact: linuxppc-dev@lists.ozlabs.org 182Description: read only 183 Identifies the revision level of the PSL. 184Users: https://github.com/ibm-capi/libcxl 185 186What: /sys/class/cxl/<card>/base_image (not in a guest) 187Date: September 2014 188Contact: linuxppc-dev@lists.ozlabs.org 189Description: read only 190 Identifies the revision level of the base image for devices 191 that support loadable PSLs. For FPGAs this field identifies 192 the image contained in the on-adapter flash which is loaded 193 during the initial program load. 194Users: https://github.com/ibm-capi/libcxl 195 196What: /sys/class/cxl/<card>/image_loaded (not in a guest) 197Date: September 2014 198Contact: linuxppc-dev@lists.ozlabs.org 199Description: read only 200 Will return "user" or "factory" depending on the image loaded 201 onto the card. 202Users: https://github.com/ibm-capi/libcxl 203 204What: /sys/class/cxl/<card>/load_image_on_perst (not in a guest) 205Date: December 2014 206Contact: linuxppc-dev@lists.ozlabs.org 207Description: read/write 208 Valid entries are "none", "user", and "factory". 209 "none" means PERST will not cause image to be loaded to the 210 card. A power cycle is required to load the image. 211 "none" could be useful for debugging because the trace arrays 212 are preserved. 213 "user" and "factory" means PERST will cause either the user or 214 user or factory image to be loaded. 215 Default is to reload on PERST whichever image the card has 216 loaded. 217Users: https://github.com/ibm-capi/libcxl 218 219What: /sys/class/cxl/<card>/reset 220Date: October 2014 221Contact: linuxppc-dev@lists.ozlabs.org 222Description: write only 223 Writing 1 will issue a PERST to card which may cause the card 224 to reload the FPGA depending on load_image_on_perst. 225Users: https://github.com/ibm-capi/libcxl 226 227What: /sys/class/cxl/<card>/perst_reloads_same_image (not in a guest) 228Date: July 2015 229Contact: linuxppc-dev@lists.ozlabs.org 230Description: read/write 231 Trust that when an image is reloaded via PERST, it will not 232 have changed. 233 0 = don't trust, the image may be different (default) 234 1 = trust that the image will not change. 235Users: https://github.com/ibm-capi/libcxl 236 237What: /sys/class/cxl/<card>/psl_timebase_synced 238Date: March 2016 239Contact: linuxppc-dev@lists.ozlabs.org 240Description: read only 241 Returns 1 if the psl timebase register is synchronized 242 with the core timebase register, 0 otherwise. 243Users: https://github.com/ibm-capi/libcxl 244