Scroll to navigation

CXL_AFU_FD_TO_H(3) CXL Programmer's Manual CXL_AFU_FD_TO_H(3)


cxl_afu_fd_to_h - create an AFU handle from the file descriptor of an already open AFU


#include <libcxl.h>

struct cxl_afu_h cxl_afu_fd_to_h(int fd);


cxl_afu_fd_to_h() returns an AFU handle from the already open AFU device associated to the file descriptor fd.

A dedicated process mode AFU only has one context and only allows the device to be opened once. An AFU directed mode AFU can have many contexts, the device can be opened once for each context that is available.


On success, an AFU handle is returned. On error, NULL is returned, and errno is set appropriately.


Bad file descriptor.
Kernel does not support CXL devices, or device is not an AFU.
Insufficient memory.
No AFU context available.
Unsupported kernel CXL API version.


AFU device in dedicated process mode.
AFU device in AFU directed mode, master context.
AFU device in AFU directed mode, slave context.


cxl(3), cxl_afu_attach(3), cxl_afu_attach_work(3), cxl_afu_attach_full(3), cxl_afu_dev_name(3), cxl_afu_fd(3), cxl_afu_free(3), cxl_afu_get_process_element(3), cxl_afu_open_dev(3), cxl_afu_open_h(3), cxl_afu_opened(3), cxl_get_api_version(3), cxl_get_api_version_compatible(3), cxl_get_cr_class(3), cxl_get_cr_device(3), cxl_get_cr_vendor(3), cxl_get_mode(3), cxl_get_modes_supported(3), cxl_read_event(3), cxl_read_expected_event(3), cxl_set_mode(3), open(2)

2017-05-24 LIBCXL 1.5