1 Please note that attributes that are shared be 1 Please note that attributes that are shared between devices are stored in
2 the directory pointed to by the symlink device 2 the directory pointed to by the symlink device/.
3 For example, the real path of the attribute /s 3 For 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 mmapped
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
76 ======================= ===== 76 ======================= ======================================
77 none No pr 77 none No prefaulting (default)
78 work_element_descriptor Treat 78 work_element_descriptor Treat the work element
79 descr 79 descriptor as an effective address and
80 prefa 80 prefault what it points to.
81 all all s 81 all all segments process calling
82 START 82 START_WORK maps.
83 ======================= ===== 83 ======================= ======================================
84 84
85 Users: https://github.com/ibm-capi/li 85 Users: https://github.com/ibm-capi/libcxl
86 86
87 What: /sys/class/cxl/<afu>/reset 87 What: /sys/class/cxl/<afu>/reset
88 Date: September 2014 88 Date: September 2014
89 Contact: linuxppc-dev@lists.ozlabs.org 89 Contact: linuxppc-dev@lists.ozlabs.org
90 Description: write only 90 Description: write only
91 Writing 1 here will reset the 91 Writing 1 here will reset the AFU provided there are not
92 contexts active on the AFU. 92 contexts active on the AFU.
93 Users: https://github.com/ibm-capi/li 93 Users: https://github.com/ibm-capi/libcxl
94 94
95 What: /sys/class/cxl/<afu>/api_versi 95 What: /sys/class/cxl/<afu>/api_version
96 Date: September 2014 96 Date: September 2014
97 Contact: linuxppc-dev@lists.ozlabs.org 97 Contact: linuxppc-dev@lists.ozlabs.org
98 Description: read only 98 Description: read only
99 Decimal value of the current v 99 Decimal value of the current version of the kernel/user API.
100 Users: https://github.com/ibm-capi/li 100 Users: https://github.com/ibm-capi/libcxl
101 101
102 What: /sys/class/cxl/<afu>/api_versi 102 What: /sys/class/cxl/<afu>/api_version_compatible
103 Date: September 2014 103 Date: September 2014
104 Contact: linuxppc-dev@lists.ozlabs.org 104 Contact: linuxppc-dev@lists.ozlabs.org
105 Description: read only 105 Description: read only
106 Decimal value of the lowest ve 106 Decimal value of the lowest version of the userspace API
107 this kernel supports. 107 this kernel supports.
108 Users: https://github.com/ibm-capi/li 108 Users: https://github.com/ibm-capi/libcxl
109 109
110 110
111 AFU configuration records (eg. /sys/class/cxl/ 111 AFU configuration records (eg. /sys/class/cxl/afu0.0/cr0):
112 112
113 An AFU may optionally export one or more PCIe 113 An AFU may optionally export one or more PCIe like configuration records, known
114 as AFU configuration records, which will show 114 as AFU configuration records, which will show up here (if present).
115 115
116 What: /sys/class/cxl/<afu>/cr<config 116 What: /sys/class/cxl/<afu>/cr<config num>/vendor
117 Date: February 2015 117 Date: February 2015
118 Contact: linuxppc-dev@lists.ozlabs.org 118 Contact: linuxppc-dev@lists.ozlabs.org
119 Description: read only 119 Description: read only
120 Hexadecimal value of the vendo 120 Hexadecimal value of the vendor ID found in this AFU
121 configuration record. 121 configuration record.
122 Users: https://github.com/ibm-capi/li 122 Users: https://github.com/ibm-capi/libcxl
123 123
124 What: /sys/class/cxl/<afu>/cr<config 124 What: /sys/class/cxl/<afu>/cr<config num>/device
125 Date: February 2015 125 Date: February 2015
126 Contact: linuxppc-dev@lists.ozlabs.org 126 Contact: linuxppc-dev@lists.ozlabs.org
127 Description: read only 127 Description: read only
128 Hexadecimal value of the devic 128 Hexadecimal value of the device ID found in this AFU
129 configuration record. 129 configuration record.
130 Users: https://github.com/ibm-capi/li 130 Users: https://github.com/ibm-capi/libcxl
131 131
132 What: /sys/class/cxl/<afu>/cr<config 132 What: /sys/class/cxl/<afu>/cr<config num>/class
133 Date: February 2015 133 Date: February 2015
134 Contact: linuxppc-dev@lists.ozlabs.org 134 Contact: linuxppc-dev@lists.ozlabs.org
135 Description: read only 135 Description: read only
136 Hexadecimal value of the class 136 Hexadecimal value of the class code found in this AFU
137 configuration record. 137 configuration record.
138 Users: https://github.com/ibm-capi/li 138 Users: https://github.com/ibm-capi/libcxl
139 139
140 What: /sys/class/cxl/<afu>/cr<config 140 What: /sys/class/cxl/<afu>/cr<config num>/config
141 Date: February 2015 141 Date: February 2015
142 Contact: linuxppc-dev@lists.ozlabs.org 142 Contact: linuxppc-dev@lists.ozlabs.org
143 Description: read only 143 Description: read only
144 This binary file provides raw 144 This binary file provides raw access to the AFU configuration
145 record. The format is expected 145 record. The format is expected to match the either the standard
146 or extended configuration spac 146 or extended configuration space defined by the PCIe
147 specification. 147 specification.
148 Users: https://github.com/ibm-capi/li 148 Users: https://github.com/ibm-capi/libcxl
149 149
150 150
151 151
152 Master contexts (eg. /sys/class/cxl/afu0.0m) 152 Master contexts (eg. /sys/class/cxl/afu0.0m)
153 153
154 What: /sys/class/cxl/<afu>m/mmio_siz 154 What: /sys/class/cxl/<afu>m/mmio_size
155 Date: September 2014 155 Date: September 2014
156 Contact: linuxppc-dev@lists.ozlabs.org 156 Contact: linuxppc-dev@lists.ozlabs.org
157 Description: read only 157 Description: read only
158 Decimal value of the size of t 158 Decimal value of the size of the MMIO space that may be mmapped
159 by userspace. This includes al 159 by userspace. This includes all slave contexts space also.
160 Users: https://github.com/ibm-capi/li 160 Users: https://github.com/ibm-capi/libcxl
161 161
162 What: /sys/class/cxl/<afu>m/pp_mmio_ 162 What: /sys/class/cxl/<afu>m/pp_mmio_len
163 Date: September 2014 163 Date: September 2014
164 Contact: linuxppc-dev@lists.ozlabs.org 164 Contact: linuxppc-dev@lists.ozlabs.org
165 Description: read only 165 Description: read only
166 Decimal value of the Per Proce 166 Decimal value of the Per Process MMIO space length.
167 Users: https://github.com/ibm-capi/li 167 Users: https://github.com/ibm-capi/libcxl
168 168
169 What: /sys/class/cxl/<afu>m/pp_mmio_ 169 What: /sys/class/cxl/<afu>m/pp_mmio_off
170 Date: September 2014 170 Date: September 2014
171 Contact: linuxppc-dev@lists.ozlabs.org 171 Contact: linuxppc-dev@lists.ozlabs.org
172 Description: read only 172 Description: read only
173 (not in a guest) 173 (not in a guest)
174 Decimal value of the Per Proce 174 Decimal value of the Per Process MMIO space offset.
175 Users: https://github.com/ibm-capi/li 175 Users: https://github.com/ibm-capi/libcxl
176 176
177 177
178 Card info (eg. /sys/class/cxl/card0) 178 Card info (eg. /sys/class/cxl/card0)
179 179
180 What: /sys/class/cxl/<card>/caia_ver 180 What: /sys/class/cxl/<card>/caia_version
181 Date: September 2014 181 Date: September 2014
182 Contact: linuxppc-dev@lists.ozlabs.org 182 Contact: linuxppc-dev@lists.ozlabs.org
183 Description: read only 183 Description: read only
184 Identifies the CAIA Version th 184 Identifies the CAIA Version the card implements.
185 Users: https://github.com/ibm-capi/li 185 Users: https://github.com/ibm-capi/libcxl
186 186
187 What: /sys/class/cxl/<card>/psl_revi 187 What: /sys/class/cxl/<card>/psl_revision
188 Date: September 2014 188 Date: September 2014
189 Contact: linuxppc-dev@lists.ozlabs.org 189 Contact: linuxppc-dev@lists.ozlabs.org
190 Description: read only 190 Description: read only
191 Identifies the revision level 191 Identifies the revision level of the PSL.
192 Users: https://github.com/ibm-capi/li 192 Users: https://github.com/ibm-capi/libcxl
193 193
194 What: /sys/class/cxl/<card>/base_ima 194 What: /sys/class/cxl/<card>/base_image
195 Date: September 2014 195 Date: September 2014
196 Contact: linuxppc-dev@lists.ozlabs.org 196 Contact: linuxppc-dev@lists.ozlabs.org
197 Description: read only 197 Description: read only
198 (not in a guest) 198 (not in a guest)
199 Identifies the revision level 199 Identifies the revision level of the base image for devices
200 that support loadable PSLs. Fo 200 that support loadable PSLs. For FPGAs this field identifies
201 the image contained in the on- 201 the image contained in the on-adapter flash which is loaded
202 during the initial program loa 202 during the initial program load.
203 Users: https://github.com/ibm-capi/li 203 Users: https://github.com/ibm-capi/libcxl
204 204
205 What: /sys/class/cxl/<card>/image_lo 205 What: /sys/class/cxl/<card>/image_loaded
206 Date: September 2014 206 Date: September 2014
207 Contact: linuxppc-dev@lists.ozlabs.org 207 Contact: linuxppc-dev@lists.ozlabs.org
208 Description: read only 208 Description: read only
209 (not in a guest) 209 (not in a guest)
210 Will return "user" or "factory 210 Will return "user" or "factory" depending on the image loaded
211 onto the card. 211 onto the card.
212 Users: https://github.com/ibm-capi/li 212 Users: https://github.com/ibm-capi/libcxl
213 213
214 What: /sys/class/cxl/<card>/load_ima 214 What: /sys/class/cxl/<card>/load_image_on_perst
215 Date: December 2014 215 Date: December 2014
216 Contact: linuxppc-dev@lists.ozlabs.org 216 Contact: linuxppc-dev@lists.ozlabs.org
217 Description: read/write 217 Description: read/write
218 (not in a guest) 218 (not in a guest)
219 Valid entries are "none", "use 219 Valid entries are "none", "user", and "factory".
220 "none" means PERST will not ca 220 "none" means PERST will not cause image to be loaded to the
221 card. A power cycle is requir 221 card. A power cycle is required to load the image.
222 "none" could be useful for deb 222 "none" could be useful for debugging because the trace arrays
223 are preserved. 223 are preserved.
224 224
225 "user" and "factory" means PER 225 "user" and "factory" means PERST will cause either the user or
226 user or factory image to be lo 226 user or factory image to be loaded.
227 Default is to reload on PERST 227 Default is to reload on PERST whichever image the card has
228 loaded. 228 loaded.
229 Users: https://github.com/ibm-capi/li 229 Users: https://github.com/ibm-capi/libcxl
230 230
231 What: /sys/class/cxl/<card>/reset 231 What: /sys/class/cxl/<card>/reset
232 Date: October 2014 232 Date: October 2014
233 Contact: linuxppc-dev@lists.ozlabs.org 233 Contact: linuxppc-dev@lists.ozlabs.org
234 Description: write only 234 Description: write only
235 Writing 1 will issue a PERST t 235 Writing 1 will issue a PERST to card provided there are no
236 contexts active on any one of 236 contexts active on any one of the card AFUs. This may cause
237 the card to reload the FPGA de 237 the card to reload the FPGA depending on load_image_on_perst.
238 Writing -1 will do a force PER 238 Writing -1 will do a force PERST irrespective of any active
239 contexts on the card AFUs. 239 contexts on the card AFUs.
240 Users: https://github.com/ibm-capi/li 240 Users: https://github.com/ibm-capi/libcxl
241 241
242 What: /sys/class/cxl/<card>/perst_re 242 What: /sys/class/cxl/<card>/perst_reloads_same_image
243 Date: July 2015 243 Date: July 2015
244 Contact: linuxppc-dev@lists.ozlabs.org 244 Contact: linuxppc-dev@lists.ozlabs.org
245 Description: read/write 245 Description: read/write
246 (not in a guest) 246 (not in a guest)
247 Trust that when an image is re 247 Trust that when an image is reloaded via PERST, it will not
248 have changed. 248 have changed.
249 249
250 == ========================== 250 == =================================================
251 0 don't trust, the image may 251 0 don't trust, the image may be different (default)
252 1 trust that the image will 252 1 trust that the image will not change.
253 == ========================== 253 == =================================================
254 Users: https://github.com/ibm-capi/li 254 Users: https://github.com/ibm-capi/libcxl
255 255
256 What: /sys/class/cxl/<card>/psl_time 256 What: /sys/class/cxl/<card>/psl_timebase_synced
257 Date: March 2016 257 Date: March 2016
258 Contact: linuxppc-dev@lists.ozlabs.org 258 Contact: linuxppc-dev@lists.ozlabs.org
259 Description: read only 259 Description: read only
260 Returns 1 if the psl timebase 260 Returns 1 if the psl timebase register is synchronized
261 with the core timebase registe 261 with the core timebase register, 0 otherwise.
262 Users: https://github.com/ibm-capi/li 262 Users: https://github.com/ibm-capi/libcxl
263 263
264 What: /sys/class/cxl/<card>/tunneled 264 What: /sys/class/cxl/<card>/tunneled_ops_supported
265 Date: May 2018 265 Date: May 2018
266 Contact: linuxppc-dev@lists.ozlabs.org 266 Contact: linuxppc-dev@lists.ozlabs.org
267 Description: read only 267 Description: read only
268 Returns 1 if tunneled operatio 268 Returns 1 if tunneled operations are supported in capi mode,
269 0 otherwise. 269 0 otherwise.
270 Users: https://github.com/ibm-capi/li 270 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.