Linux/Documentation/ABI/testing/sysfs-bus-cxl

Version: ~ [ linux-6.12-rc7 ] ~ [ linux-6.11.7 ] ~ [ linux-6.10.14 ] ~ [ linux-6.9.12 ] ~ [ linux-6.8.12 ] ~ [ linux-6.7.12 ] ~ [ linux-6.6.60 ] ~ [ linux-6.5.13 ] ~ [ linux-6.4.16 ] ~ [ linux-6.3.13 ] ~ [ linux-6.2.16 ] ~ [ linux-6.1.116 ] ~ [ linux-6.0.19 ] ~ [ linux-5.19.17 ] ~ [ linux-5.18.19 ] ~ [ linux-5.17.15 ] ~ [ linux-5.16.20 ] ~ [ linux-5.15.171 ] ~ [ linux-5.14.21 ] ~ [ linux-5.13.19 ] ~ [ linux-5.12.19 ] ~ [ linux-5.11.22 ] ~ [ linux-5.10.229 ] ~ [ linux-5.9.16 ] ~ [ linux-5.8.18 ] ~ [ linux-5.7.19 ] ~ [ linux-5.6.19 ] ~ [ linux-5.5.19 ] ~ [ linux-5.4.285 ] ~ [ linux-5.3.18 ] ~ [ linux-5.2.21 ] ~ [ linux-5.1.21 ] ~ [ linux-5.0.21 ] ~ [ linux-4.20.17 ] ~ [ linux-4.19.323 ] ~ [ linux-4.18.20 ] ~ [ linux-4.17.19 ] ~ [ linux-4.16.18 ] ~ [ linux-4.15.18 ] ~ [ linux-4.14.336 ] ~ [ linux-4.13.16 ] ~ [ linux-4.12.14 ] ~ [ linux-4.11.12 ] ~ [ linux-4.10.17 ] ~ [ linux-4.9.337 ] ~ [ linux-4.4.302 ] ~ [ linux-3.10.108 ] ~ [ linux-2.6.32.71 ] ~ [ linux-2.6.0 ] ~ [ linux-2.4.37.11 ] ~ [ unix-v6-master ] ~ [ ccs-tools-1.8.12 ] ~ [ policy-sample ] ~
Architecture: ~ [ i386 ] ~ [ alpha ] ~ [ m68k ] ~ [ mips ] ~ [ ppc ] ~ [ sparc ] ~ [ sparc64 ] ~

Diff markup

1 What: /sys/bus/cxl/flush << 2 Date: Januarry, 2022 << 3 KernelVersion: v5.18 << 4 Contact: linux-cxl@vger.kernel.org << 5 Description: << 6 (WO) If userspace manually unb << 7 all descendant memdevs for unb << 8 flushes that work. << 9 << 10 << 11 What: /sys/bus/cxl/devices/memX/firm 1 What: /sys/bus/cxl/devices/memX/firmware_version 12 Date: December, 2020 2 Date: December, 2020 13 KernelVersion: v5.12 3 KernelVersion: v5.12 14 Contact: linux-cxl@vger.kernel.org 4 Contact: linux-cxl@vger.kernel.org 15 Description: 5 Description: 16 (RO) "FW Revision" string as r 6 (RO) "FW Revision" string as reported by the Identify 17 Memory Device Output Payload i 7 Memory Device Output Payload in the CXL-2.0 18 specification. 8 specification. 19 9 20 << 21 What: /sys/bus/cxl/devices/memX/ram/ 10 What: /sys/bus/cxl/devices/memX/ram/size 22 Date: December, 2020 11 Date: December, 2020 23 KernelVersion: v5.12 12 KernelVersion: v5.12 24 Contact: linux-cxl@vger.kernel.org 13 Contact: linux-cxl@vger.kernel.org 25 Description: 14 Description: 26 (RO) "Volatile Only Capacity" 15 (RO) "Volatile Only Capacity" as bytes. Represents the 27 identically named field in the 16 identically named field in the Identify Memory Device Output 28 Payload in the CXL-2.0 specifi 17 Payload in the CXL-2.0 specification. 29 18 30 << 31 What: /sys/bus/cxl/devices/memX/ram/ << 32 Date: May, 2023 << 33 KernelVersion: v6.8 << 34 Contact: linux-cxl@vger.kernel.org << 35 Description: << 36 (RO) For CXL host platforms th << 37 this attribute conveys a comma << 38 specific cookies that identifi << 39 for the volatile partition of << 40 class-ids can be compared agai << 41 published for a root decoder. << 42 that the endpoints map their l << 43 matching platform class, misma << 44 and there are platform specifi << 45 side-effects that may result. << 46 << 47 << 48 What: /sys/bus/cxl/devices/memX/pmem 19 What: /sys/bus/cxl/devices/memX/pmem/size 49 Date: December, 2020 20 Date: December, 2020 50 KernelVersion: v5.12 21 KernelVersion: v5.12 51 Contact: linux-cxl@vger.kernel.org 22 Contact: linux-cxl@vger.kernel.org 52 Description: 23 Description: 53 (RO) "Persistent Only Capacity 24 (RO) "Persistent Only Capacity" as bytes. Represents the 54 identically named field in the 25 identically named field in the Identify Memory Device Output 55 Payload in the CXL-2.0 specifi 26 Payload in the CXL-2.0 specification. 56 << 57 << 58 What: /sys/bus/cxl/devices/memX/pmem << 59 Date: May, 2023 << 60 KernelVersion: v6.8 << 61 Contact: linux-cxl@vger.kernel.org << 62 Description: << 63 (RO) For CXL host platforms th << 64 this attribute conveys a comma << 65 specific cookies that identifi << 66 for the persistent partition o << 67 class-ids can be compared agai << 68 published for a root decoder. << 69 that the endpoints map their l << 70 matching platform class, misma << 71 and there are platform specifi << 72 side-effects that may result. << 73 << 74 << 75 What: /sys/bus/cxl/devices/memX/seri << 76 Date: January, 2022 << 77 KernelVersion: v5.18 << 78 Contact: linux-cxl@vger.kernel.org << 79 Description: << 80 (RO) 64-bit serial number per << 81 capability. Mandatory for CXL << 82 Memory Device PCIe Capabilitie << 83 << 84 << 85 What: /sys/bus/cxl/devices/memX/numa << 86 Date: January, 2022 << 87 KernelVersion: v5.18 << 88 Contact: linux-cxl@vger.kernel.org << 89 Description: << 90 (RO) If NUMA is enabled and th << 91 host PCI device for this memor << 92 affinity for this device. << 93 << 94 << 95 What: /sys/bus/cxl/devices/memX/secu << 96 Date: June, 2023 << 97 KernelVersion: v6.5 << 98 Contact: linux-cxl@vger.kernel.org << 99 Description: << 100 (RO) Reading this file will di << 101 that device. Such states can b << 102 a sanitization is currently un << 103 for persistent memory: 'locked << 104 sysfs entry is select/poll cap << 105 upon completion of a sanitize << 106 << 107 << 108 What: /sys/bus/cxl/devices/memX/secu << 109 Date: June, 2023 << 110 KernelVersion: v6.5 << 111 Contact: linux-cxl@vger.kernel.org << 112 Description: << 113 (WO) Write a boolean 'true' st << 114 sanitize the device to securel << 115 This is done by ensuring that << 116 whether it resides in persiste << 117 or the LSA, is made permanentl << 118 is appropriate for the media t << 119 the device to be disabled, tha << 120 HPA ranges. This permits avoid << 121 management, relying instead fo << 122 transitions between software p << 123 states. If this file is not pr << 124 support for the operation. << 125 << 126 << 127 What /sys/bus/cxl/devices/memX/secu << 128 Date: June, 2023 << 129 KernelVersion: v6.5 << 130 Contact: linux-cxl@vger.kernel.org << 131 Description: << 132 (WO) Write a boolean 'true' st << 133 secure erase user data by chan << 134 all user data areas of the dev << 135 the device to be disabled, tha << 136 HPA ranges. This permits avoid << 137 management, relying instead fo << 138 transitions between software p << 139 states. If this file is not pr << 140 support for the operation. << 141 << 142 << 143 What: /sys/bus/cxl/devices/memX/firm << 144 Date: April, 2023 << 145 KernelVersion: v6.5 << 146 Contact: linux-cxl@vger.kernel.org << 147 Description: << 148 (RW) Firmware uploader mechani << 149 this directory can be used to << 150 firmware for CXL devices. The << 151 documented in sysfs-class-firm << 152 << 153 << 154 What: /sys/bus/cxl/devices/*/devtype << 155 Date: June, 2021 << 156 KernelVersion: v5.14 << 157 Contact: linux-cxl@vger.kernel.org << 158 Description: << 159 (RO) CXL device objects export << 160 mirrors the same value communi << 161 variable for uevents for devic << 162 << 163 << 164 What: /sys/bus/cxl/devices/*/modalia << 165 Date: December, 2021 << 166 KernelVersion: v5.18 << 167 Contact: linux-cxl@vger.kernel.org << 168 Description: << 169 (RO) CXL device objects export << 170 mirrors the same value communi << 171 variable for uevents for devic << 172 << 173 << 174 What: /sys/bus/cxl/devices/portX/upo << 175 Date: June, 2021 << 176 KernelVersion: v5.14 << 177 Contact: linux-cxl@vger.kernel.org << 178 Description: << 179 (RO) CXL port objects are enum << 180 firmware device (ACPI0017 and << 181 port with CXL component regist << 182 the CXL portX object to the de << 183 capability. << 184 << 185 << 186 What: /sys/bus/cxl/devices/{port,end << 187 Date: January, 2023 << 188 KernelVersion: v6.3 << 189 Contact: linux-cxl@vger.kernel.org << 190 Description: << 191 (RO) CXL port objects are inst << 192 a CXL/PCIe switch, and for eac << 193 corresponding memory device in << 194 descendant CXL port (switch or << 195 useful to know which 'dport' o << 196 routes to this descendant. The << 197 the device representing the do << 198 routes to {port,endpoint}X. << 199 << 200 << 201 What: /sys/bus/cxl/devices/portX/dpo << 202 Date: June, 2021 << 203 KernelVersion: v5.14 << 204 Contact: linux-cxl@vger.kernel.org << 205 Description: << 206 (RO) CXL port objects are enum << 207 firmware device (ACPI0017 and << 208 port with CXL component regist << 209 identifies one or more downstr << 210 may target in its decode of CX << 211 integer reflects the hardware << 212 hardware decoder target list. << 213 << 214 << 215 What: /sys/bus/cxl/devices/portX/dec << 216 Date: October, 2023 << 217 KernelVersion: v6.7 << 218 Contact: linux-cxl@vger.kernel.org << 219 Description: << 220 (RO) A memory device is consid << 221 decoders are in the "committed << 222 CXL HDM Decoder n Control Regi << 223 operations like "sanitize" are << 224 decoding a Host Physical Addre << 225 may be elevated without any re << 226 enumerated, as this may be due << 227 platform firwmare or a previou << 228 << 229 << 230 What: /sys/bus/cxl/devices/decoderX. << 231 Date: June, 2021 << 232 KernelVersion: v5.14 << 233 Contact: linux-cxl@vger.kernel.org << 234 Description: << 235 (RO) CXL decoder objects are e << 236 firmware description, or a CXL << 237 PCIe device (see CXL 2.0 secti << 238 Capability Structure). The 'X' << 239 cxl_port container of this dec << 240 instance id of a given decoder << 241 << 242 << 243 What: /sys/bus/cxl/devices/decoderX. << 244 Date: June, 2021 << 245 KernelVersion: v5.14 << 246 Contact: linux-cxl@vger.kernel.org << 247 Description: << 248 (RO) The 'start' and 'size' at << 249 physical address base and numb << 250 decoder's decode window. For d << 251 "cxl_decoder_root" the address << 252 devtype "cxl_decoder_switch" t << 253 decode range of the cxl_port a << 254 and dynamically updates based << 255 that address space. << 256 << 257 << 258 What: /sys/bus/cxl/devices/decoderX. << 259 Date: June, 2021 << 260 KernelVersion: v5.14 << 261 Contact: linux-cxl@vger.kernel.org << 262 Description: << 263 (RO) CXL HDM decoders have the << 264 configuration until the next d << 265 devtype "cxl_decoder_root" the << 266 unlock them. For decoders of << 267 secondary bus reset, of the PC << 268 for this decoders uport, unloc << 269 << 270 << 271 What: /sys/bus/cxl/devices/decoderX. << 272 Date: June, 2021 << 273 KernelVersion: v5.14 << 274 Contact: linux-cxl@vger.kernel.org << 275 Description: << 276 (RO) Display a comma separated << 277 target configuration. The list << 278 configured interleave order of << 279 Each entry in the list is a dp << 280 << 281 << 282 What: /sys/bus/cxl/devices/decoderX. << 283 Date: June, 2021 << 284 KernelVersion: v5.14 << 285 Contact: linux-cxl@vger.kernel.org << 286 Description: << 287 (RO) When a CXL decoder is of << 288 represents a fixed memory wind << 289 firmware. A fixed window may o << 290 types. The 'cap_*' attributes << 291 memory, volatile memory, accel << 292 memory may be mapped behind th << 293 << 294 << 295 What: /sys/bus/cxl/devices/decoderX. << 296 Date: June, 2021 << 297 KernelVersion: v5.14 << 298 Contact: linux-cxl@vger.kernel.org << 299 Description: << 300 (RO) When a CXL decoder is of << 301 can optionally decode either a << 302 expander memory (type-3). The << 303 the current setting which may << 304 memory regions are activated i << 305 << 306 << 307 What: /sys/bus/cxl/devices/endpointX << 308 Date: July, 2022 << 309 KernelVersion: v6.0 << 310 Contact: linux-cxl@vger.kernel.org << 311 Description: << 312 (RO) If this sysfs entry is no << 313 found to support CDAT data. I << 314 the data is 0 reading the CDAT << 315 data is reported. << 316 << 317 << 318 What: /sys/bus/cxl/devices/decoderX. << 319 Date: May, 2022 << 320 KernelVersion: v6.0 << 321 Contact: linux-cxl@vger.kernel.org << 322 Description: << 323 (RW) When a CXL decoder is of << 324 translates from a host physica << 325 address range. Device-local ad << 326 into a 'ram' (volatile memory) << 327 memory) range. The 'mode' attr << 328 'mixed', or 'none'. The 'mixed << 329 when a decoder straddles the v << 330 boundary, and 'none' indicates << 331 decoding, or no DPA allocation << 332 << 333 'mode' can be written, when th << 334 state, with either 'ram' or 'p << 335 next allocation. << 336 << 337 << 338 What: /sys/bus/cxl/devices/decoderX. << 339 Date: May, 2022 << 340 KernelVersion: v6.0 << 341 Contact: linux-cxl@vger.kernel.org << 342 Description: << 343 (RO) When a CXL decoder is of << 344 and its 'dpa_size' attribute i << 345 indicates the device physical << 346 allocation. << 347 << 348 << 349 What: /sys/bus/cxl/devices/decoderX. << 350 Date: May, 2022 << 351 KernelVersion: v6.0 << 352 Contact: linux-cxl@vger.kernel.org << 353 Description: << 354 (RW) When a CXL decoder is of << 355 translates from a host physica << 356 address range. The range, base << 357 DPA allocated to this decoder << 358 Allocations can be mutated as << 359 disabled state. A write to 'dp << 360 allocation and then attempts t << 361 in the device partition referr << 362 Allocate and free requests can << 363 instance number disabled decod << 364 allocations are enforced to oc << 365 order and frees are enforced t << 366 'decoderX.Y/id' order. << 367 << 368 << 369 What: /sys/bus/cxl/devices/decoderX. << 370 Date: May, 2022 << 371 KernelVersion: v6.0 << 372 Contact: linux-cxl@vger.kernel.org << 373 Description: << 374 (RO) The number of targets acr << 375 physical address (HPA) memory << 376 maps every Nth block of HPA (o << 377 'interleave_granularity') to c << 378 decoder's position in the inte << 379 device's (endpoint or switch) << 380 decoders their interleave is s << 381 they only specify a downstream << 382 << 383 << 384 What: /sys/bus/cxl/devices/decoderX. << 385 Date: May, 2022 << 386 KernelVersion: v6.0 << 387 Contact: linux-cxl@vger.kernel.org << 388 Description: << 389 (RO) The number of consecutive << 390 space this decoder claims at a << 391 to the next target in the inte << 392 interleave_granularity (assumi << 393 interleave_granularity). << 394 << 395 << 396 What: /sys/bus/cxl/devices/decoderX. << 397 Date: May, 2022, January, 2023 << 398 KernelVersion: v6.0 (pmem), v6.3 (ram) << 399 Contact: linux-cxl@vger.kernel.org << 400 Description: << 401 (RW) Write a string in the for << 402 of defining a new persistent, << 403 (interleave-set) within the de << 404 'decoderX.Y'. The value writte << 405 returned from reading this att << 406 operation is done on write to << 407 region and allocate the region << 408 EBUSY is returned if the regio << 409 current cached value. << 410 << 411 << 412 What: /sys/bus/cxl/devices/decoderX. << 413 Date: May, 2022 << 414 KernelVersion: v6.0 << 415 Contact: linux-cxl@vger.kernel.org << 416 Description: << 417 (WO) Write a string in the for << 418 provided it is currently idle << 419 << 420 << 421 What: /sys/bus/cxl/devices/decoderX. << 422 Date: May, 2023 << 423 KernelVersion: v6.5 << 424 Contact: linux-cxl@vger.kernel.org << 425 Description: << 426 (RO) For CXL host platforms th << 427 root-decoder-only attribute co << 428 that identifies a QoS performa << 429 This class-id can be compared << 430 published for each memory-type << 431 it is not required that endpoi << 432 to a matching platform class, << 433 there are platform specific si << 434 << 435 << 436 What: /sys/bus/cxl/devices/regionZ/u << 437 Date: May, 2022 << 438 KernelVersion: v6.0 << 439 Contact: linux-cxl@vger.kernel.org << 440 Description: << 441 (RW) Write a unique identifier << 442 be set for persistent regions << 443 UUID of another region. For vo << 444 attribute is a read-only empty << 445 << 446 << 447 What: /sys/bus/cxl/devices/regionZ/i << 448 Date: May, 2022 << 449 KernelVersion: v6.0 << 450 Contact: linux-cxl@vger.kernel.org << 451 Description: << 452 (RW) Set the number of consecu << 453 interleave set will claim. The << 454 values are determined by the C << 455 devices. << 456 << 457 << 458 What: /sys/bus/cxl/devices/regionZ/i << 459 Date: May, 2022 << 460 KernelVersion: v6.0 << 461 Contact: linux-cxl@vger.kernel.org << 462 Description: << 463 (RW) Configures the number of << 464 region is set by writing this << 465 1/interleave_ways of storage f << 466 << 467 << 468 What: /sys/bus/cxl/devices/regionZ/s << 469 Date: May, 2022 << 470 KernelVersion: v6.0 << 471 Contact: linux-cxl@vger.kernel.org << 472 Description: << 473 (RW) System physical address s << 474 When written trigger the drive << 475 parent root decoder's address << 476 address space is reported and << 477 region's resource attribute. S << 478 interleave configuration param << 479 changed, only freed by writing << 480 that data is maintained over a << 481 there is no guarantee that a f << 482 results in the same address be << 483 << 484 << 485 What: /sys/bus/cxl/devices/regionZ/m << 486 Date: January, 2023 << 487 KernelVersion: v6.3 << 488 Contact: linux-cxl@vger.kernel.org << 489 Description: << 490 (RO) The mode of a region is e << 491 and dictates the mode of the e << 492 region. For more details on th << 493 /sys/bus/cxl/devices/decoderX. << 494 << 495 << 496 What: /sys/bus/cxl/devices/regionZ/r << 497 Date: May, 2022 << 498 KernelVersion: v6.0 << 499 Contact: linux-cxl@vger.kernel.org << 500 Description: << 501 (RO) A region is a contiguous << 502 address space. Region capacity << 503 size attribute, the resulting << 504 by the driver is reflected her << 505 read this before writing a val << 506 << 507 << 508 What: /sys/bus/cxl/devices/regionZ/t << 509 Date: May, 2022 << 510 KernelVersion: v6.0 << 511 Contact: linux-cxl@vger.kernel.org << 512 Description: << 513 (RW) Write an endpoint decoder << 514 is the intended position of th << 515 interleave and N is the 'inter << 516 region. ENXIO is returned if t << 517 to map decode scenario, like t << 518 position relative to the root << 519 returned if the position in th << 520 if the region is not in a stat << 521 configuration changes. EINVAL << 522 not an endpoint decoder. Once << 523 successfully written a final v << 524 performed before activating th << 525 << 526 << 527 What: /sys/bus/cxl/devices/regionZ/c << 528 Date: May, 2022 << 529 KernelVersion: v6.0 << 530 Contact: linux-cxl@vger.kernel.org << 531 Description: << 532 (RW) Write a boolean 'true' st << 533 trigger the region to transiti << 534 state to the actively decoding << 535 operation in addition to valid << 536 configured state, validates th << 537 committed in spec mandated ord << 538 1), and checks that the hardwa << 539 Reading this value indicates w << 540 not. << 541 << 542 << 543 What: /sys/bus/cxl/devices/memX/trig << 544 Date: April, 2023 << 545 KernelVersion: v6.4 << 546 Contact: linux-cxl@vger.kernel.org << 547 Description: << 548 (WO) When a boolean 'true' is << 549 memdev driver retrieves the po << 550 list consists of addresses tha << 551 in poison if accessed, and the << 552 attribute is only visible for << 553 capability. The retrieved erro << 554 events when cxl_poison event t << 555 << 556 << 557 What: /sys/bus/cxl/devices/regionZ/a << 558 /sys/bus/cxl/devices/regionZ/a << 559 Date: Jan, 2024 << 560 KernelVersion: v6.9 << 561 Contact: linux-cxl@vger.kernel.org << 562 Description: << 563 (RO) The aggregated read or wr << 564 number is the accumulated read << 565 devices that contributes to th << 566 identical data that should app << 567 /sys/devices/system/node/nodeX << 568 /sys/devices/system/node/nodeX << 569 See Documentation/ABI/stable/s << 570 the number to the closest init << 571 number to the closest CPU. << 572 << 573 << 574 What: /sys/bus/cxl/devices/regionZ/a << 575 /sys/bus/cxl/devices/regionZ/a << 576 Date: Jan, 2024 << 577 KernelVersion: v6.9 << 578 Contact: linux-cxl@vger.kernel.org << 579 Description: << 580 (RO) The read or write latency << 581 the worst read or write latenc << 582 contributes to the region in n << 583 that should appear in << 584 /sys/devices/system/node/nodeX << 585 /sys/devices/system/node/nodeX << 586 See Documentation/ABI/stable/s << 587 the number to the closest init << 588 number to the closest CPU. <<

Linux® is a registered trademark of Linus Torvalds in the United States and other countries.
TOMOYO® is a registered trademark of NTT DATA CORPORATION.

TOMOYO Linux Cross Reference
Linux/Documentation/ABI/testing/sysfs-bus-cxl

Diff markup

Differences between /Documentation/ABI/testing/sysfs-bus-cxl (Version linux-6.12-rc7) and /Documentation/ABI/testing/sysfs-bus-cxl (Version linux-5.13.19)

TOMOYO Linux Cross Reference Linux/Documentation/ABI/testing/sysfs-bus-cxl

Diff markup

Differences between /Documentation/ABI/testing/sysfs-bus-cxl (Version linux-6.12-rc7) and /Documentation/ABI/testing/sysfs-bus-cxl (Version linux-5.13.19)

TOMOYO Linux Cross Reference
Linux/Documentation/ABI/testing/sysfs-bus-cxl