.\" Automatically generated by Pandoc 3.1.3
.\"
.\" Define V font for inline verbatim, using C font in formats
.\" that render this, and otherwise B font.
.ie "\f[CB]x\f[]"x" \{\
. ftr V B
. ftr VI BI
. ftr VB B
. ftr VBI BI
.\}
.el \{\
. ftr V CR
. ftr VI CI
. ftr VB CB
. ftr VBI CBI
.\}
.TH "mlx5dv_devx_create_event_channel, mlx5dv_devx_destroy_event_channel" "3" "" "" ""
.hy
.SH NAME
.PP
mlx5dv_devx_create_event_channel - Create an event channel to be used
for DEVX asynchronous events.
.PP
mlx5dv_devx_destroy_event_channel - Destroy a DEVX event channel.
.SH SYNOPSIS
.IP
.nf
\f[C]
#include <infiniband/mlx5dv.h>

struct mlx5dv_devx_event_channel {
    int fd;
};

struct mlx5dv_devx_event_channel *
mlx5dv_devx_create_event_channel(struct ibv_context *context,
                                 enum mlx5dv_devx_create_event_channel_flags flags)

void mlx5dv_devx_destroy_event_channel(struct mlx5dv_devx_event_channel *event_channel)
\f[R]
.fi
.SH DESCRIPTION
.PP
Create or destroy a channel to be used for DEVX asynchronous events.
.PP
The create verb exposes an mlx5dv_devx_event_channel object that can be
used to read asynchronous DEVX events.
This lets an application to subscribe to get device events and once an
event occurred read it from this object.
.SH ARGUMENTS
.TP
\f[I]context\f[R]
.IP
.nf
\f[C]
RDMA device context to create the channel on.
\f[R]
.fi
.TP
\f[I]flags\f[R]
MLX5DV_DEVX_CREATE_EVENT_CHANNEL_FLAGS_OMIT_EV_DATA: omit the event data
on this channel.
.SH RETURN VALUE
.PP
Upon success \f[I]mlx5dv_devx_create_event_channel\f[R] will return a
new \f[I]struct mlx5dv_devx_event_channel\f[R] object, on error NULL
will be returned and errno will be set.
.SH SEE ALSO
.PP
\f[I]mlx5dv_open_device(3)\f[R], \f[I]mlx5dv_devx_obj_create(3)\f[R]
.PP
#AUTHOR
.PP
Yishai Hadas <yishaih@mellanox.com>