NAME

       libcxl - A library to interact with CXL devices through sysfs(5) and ioctl(2) interfaces

SYNOPSIS

       #include <cxl/libcxl.h>
       cc ... -lcxl

DESCRIPTION

       libcxl provides interfaces to interact with CXL devices in Linux, using sysfs interfaces for most kernel
       interactions, and the ioctl() interface for command submission.

       The starting point for all library interfaces is a cxl_ctx object, returned by cxl_new(3). CXL Type 3
       memory devices are children of the cxl_ctx object, and can be iterated through using an iterator API.

       Library level interfaces that are agnostic to any device, or a specific subclass of operations have the
       prefix cxl_

       The object representing a CXL Type 3 device is cxl_memdev. Library interfaces related to these devices
       have the prefix cxl_memdev_. These interfaces are mostly associated with sysfs interactions (unless
       otherwise noted in their respective documentation pages). They are typically used to retrieve data
       published by the kernel, or to send data or trigger kernel operations for a given device.

       A cxl_cmd is a reference counted object which is used to perform Mailbox commands as described in the CXL
       Specification. A cxl_cmd object is tied to a cxl_memdev. Associated library interfaces have the prefix
       cxl_cmd_. Within this sub-class of interfaces, there are:

       •   cxl_cmd_new_* interfaces that allocate a new cxl_cmd object for a given command type.

       •   cxl_cmd_submit which submits the command via ioctl()

       •   cxl_cmd_<name>_get_<field> interfaces that get specific fields out of the command response

       •   cxl_cmd_get_* interfaces to get general command related information.

COPYRIGHT

       Copyright © 2016 - 2020, Intel Corporation. License GPLv2: GNU GPL version 2
       http://gnu.org/licenses/gpl.html. This is free software: you are free to change and redistribute it.
       There is NO WARRANTY, to the extent permitted by law.

SEE ALSO

       cxl(1)

libcxl                                             2022-01-24                                          LIBCXL(3)