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