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