.\" Automatically generated by Pandoc 1.16.0.2
.\"
.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[]
.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
.B \f[I]context\f[]
.IP
.nf
\f[C]
RDMA\ device\ context\ to\ create\ the\ channel\ on.
\f[]
.fi
.RS
.RE
.TP
.B \f[I]flags\f[]
MLX5DV_DEVX_CREATE_EVENT_CHANNEL_FLAGS_OMIT_EV_DATA: omit the event data
on this channel.
.RS
.RE
.SH RETURN VALUE
.PP
Upon success \f[I]mlx5dv_devx_create_event_channel\f[] will return a new
\f[I]struct mlx5dv_devx_event_channel\f[] object, on error NULL will be
returned and errno will be set.
.SH SEE ALSO
.PP
\f[I]mlx5dv_open_device(3)\f[], \f[I]mlx5dv_devx_obj_create(3)\f[]
.SH AUTHOR
.PP
Yishai Hadas <yishaih@mellanox.com>
