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 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
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 the lowest version of the userspace API
107 this kernel supports. !! 107 this 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 mmaped
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 (not in a guest)
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) <<
174 Decimal value of the Per Proce 173 Decimal value of the Per Process MMIO space offset.
175 Users: https://github.com/ibm-capi/li 174 Users: https://github.com/ibm-capi/libcxl
176 175
177 176
178 Card info (eg. /sys/class/cxl/card0) 177 Card info (eg. /sys/class/cxl/card0)
179 178
180 What: /sys/class/cxl/<card>/caia_ver 179 What: /sys/class/cxl/<card>/caia_version
181 Date: September 2014 180 Date: September 2014
182 Contact: linuxppc-dev@lists.ozlabs.org 181 Contact: linuxppc-dev@lists.ozlabs.org
183 Description: read only 182 Description: read only
184 Identifies the CAIA Version th 183 Identifies the CAIA Version the card implements.
185 Users: https://github.com/ibm-capi/li 184 Users: https://github.com/ibm-capi/libcxl
186 185
187 What: /sys/class/cxl/<card>/psl_revi 186 What: /sys/class/cxl/<card>/psl_revision
188 Date: September 2014 187 Date: September 2014
189 Contact: linuxppc-dev@lists.ozlabs.org 188 Contact: linuxppc-dev@lists.ozlabs.org
190 Description: read only 189 Description: read only
191 Identifies the revision level 190 Identifies the revision level of the PSL.
192 Users: https://github.com/ibm-capi/li 191 Users: https://github.com/ibm-capi/libcxl
193 192
194 What: /sys/class/cxl/<card>/base_ima !! 193 What: /sys/class/cxl/<card>/base_image (not in a guest)
195 Date: September 2014 194 Date: September 2014
196 Contact: linuxppc-dev@lists.ozlabs.org 195 Contact: linuxppc-dev@lists.ozlabs.org
197 Description: read only 196 Description: read only
198 (not in a guest) <<
199 Identifies the revision level 197 Identifies the revision level of the base image for devices
200 that support loadable PSLs. Fo 198 that support loadable PSLs. For FPGAs this field identifies
201 the image contained in the on- 199 the image contained in the on-adapter flash which is loaded
202 during the initial program loa 200 during the initial program load.
203 Users: https://github.com/ibm-capi/li 201 Users: https://github.com/ibm-capi/libcxl
204 202
205 What: /sys/class/cxl/<card>/image_lo !! 203 What: /sys/class/cxl/<card>/image_loaded (not in a guest)
206 Date: September 2014 204 Date: September 2014
207 Contact: linuxppc-dev@lists.ozlabs.org 205 Contact: linuxppc-dev@lists.ozlabs.org
208 Description: read only 206 Description: read only
209 (not in a guest) <<
210 Will return "user" or "factory 207 Will return "user" or "factory" depending on the image loaded
211 onto the card. 208 onto the card.
212 Users: https://github.com/ibm-capi/li 209 Users: https://github.com/ibm-capi/libcxl
213 210
214 What: /sys/class/cxl/<card>/load_ima !! 211 What: /sys/class/cxl/<card>/load_image_on_perst (not in a guest)
215 Date: December 2014 212 Date: December 2014
216 Contact: linuxppc-dev@lists.ozlabs.org 213 Contact: linuxppc-dev@lists.ozlabs.org
217 Description: read/write 214 Description: read/write
218 (not in a guest) <<
219 Valid entries are "none", "use 215 Valid entries are "none", "user", and "factory".
220 "none" means PERST will not ca 216 "none" means PERST will not cause image to be loaded to the
221 card. A power cycle is requir 217 card. A power cycle is required to load the image.
222 "none" could be useful for deb 218 "none" could be useful for debugging because the trace arrays
223 are preserved. 219 are preserved.
224 220
225 "user" and "factory" means PER 221 "user" and "factory" means PERST will cause either the user or
226 user or factory image to be lo 222 user or factory image to be loaded.
227 Default is to reload on PERST 223 Default is to reload on PERST whichever image the card has
228 loaded. 224 loaded.
229 Users: https://github.com/ibm-capi/li 225 Users: https://github.com/ibm-capi/libcxl
230 226
231 What: /sys/class/cxl/<card>/reset 227 What: /sys/class/cxl/<card>/reset
232 Date: October 2014 228 Date: October 2014
233 Contact: linuxppc-dev@lists.ozlabs.org 229 Contact: linuxppc-dev@lists.ozlabs.org
234 Description: write only 230 Description: write only
235 Writing 1 will issue a PERST t 231 Writing 1 will issue a PERST to card provided there are no
236 contexts active on any one of 232 contexts active on any one of the card AFUs. This may cause
237 the card to reload the FPGA de 233 the card to reload the FPGA depending on load_image_on_perst.
238 Writing -1 will do a force PER 234 Writing -1 will do a force PERST irrespective of any active
239 contexts on the card AFUs. 235 contexts on the card AFUs.
240 Users: https://github.com/ibm-capi/li 236 Users: https://github.com/ibm-capi/libcxl
241 237
242 What: /sys/class/cxl/<card>/perst_re !! 238 What: /sys/class/cxl/<card>/perst_reloads_same_image (not in a guest)
243 Date: July 2015 239 Date: July 2015
244 Contact: linuxppc-dev@lists.ozlabs.org 240 Contact: linuxppc-dev@lists.ozlabs.org
245 Description: read/write 241 Description: read/write
246 (not in a guest) <<
247 Trust that when an image is re 242 Trust that when an image is reloaded via PERST, it will not
248 have changed. 243 have changed.
249 244
250 == ========================== 245 == =================================================
251 0 don't trust, the image may 246 0 don't trust, the image may be different (default)
252 1 trust that the image will 247 1 trust that the image will not change.
253 == ========================== 248 == =================================================
254 Users: https://github.com/ibm-capi/li 249 Users: https://github.com/ibm-capi/libcxl
255 250
256 What: /sys/class/cxl/<card>/psl_time 251 What: /sys/class/cxl/<card>/psl_timebase_synced
257 Date: March 2016 252 Date: March 2016
258 Contact: linuxppc-dev@lists.ozlabs.org 253 Contact: linuxppc-dev@lists.ozlabs.org
259 Description: read only 254 Description: read only
260 Returns 1 if the psl timebase 255 Returns 1 if the psl timebase register is synchronized
261 with the core timebase registe 256 with the core timebase register, 0 otherwise.
262 Users: https://github.com/ibm-capi/li 257 Users: https://github.com/ibm-capi/libcxl
263 258
264 What: /sys/class/cxl/<card>/tunneled 259 What: /sys/class/cxl/<card>/tunneled_ops_supported
265 Date: May 2018 260 Date: May 2018
266 Contact: linuxppc-dev@lists.ozlabs.org 261 Contact: linuxppc-dev@lists.ozlabs.org
267 Description: read only 262 Description: read only
268 Returns 1 if tunneled operatio 263 Returns 1 if tunneled operations are supported in capi mode,
269 0 otherwise. 264 0 otherwise.
270 Users: https://github.com/ibm-capi/li 265 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.