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