1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
|
.\" Automatically generated by Pandoc 2.9.2.1
.\"
.TH "mlx5dv_devx_subscribe_devx_event, mlx5dv_devx_subscribe_devx_event_fd" "3" "" "" ""
.hy
.SH NAME
.PP
mlx5dv_devx_subscribe_devx_event - Subscribe over an event channel for
device events.
.PP
mlx5dv_devx_subscribe_devx_event_fd - Subscribe over an event channel
for device events to signal eventfd.
.SH SYNOPSIS
.IP
.nf
\f[C]
#include <infiniband/mlx5dv.h>
int mlx5dv_devx_subscribe_devx_event(struct mlx5dv_devx_event_channel *dv_event_channel,
struct mlx5dv_devx_obj *obj,
uint16_t events_sz,
uint16_t events_num[],
uint64_t cookie)
int mlx5dv_devx_subscribe_devx_event_fd(struct mlx5dv_devx_event_channel *dv_event_channel,
int fd,
struct mlx5dv_devx_obj *obj,
uint16_t event_num)
\f[R]
.fi
.SH DESCRIPTION
.PP
Subscribe over a DEVX event channel for device events.
.SH ARGUMENTS
.TP
\f[I]dv_event_channel\f[R]
Event channel to subscribe over.
.TP
\f[I]fd\f[R]
A file descriptor that previously was opened by the eventfd() system
call.
.TP
\f[I]obj\f[R]
DEVX object that \f[I]events_num\f[R] relates to, can be NULL for
unaffiliated events.
.TP
\f[I]events_sz\f[R]
Size of the \f[I]events_num\f[R] buffer that holds the events to
subscribe for.
.TP
\f[I]events_num\f[R]
Holds the required event numbers to subscribe for, numbers are according
to the device specification.
.TP
\f[I]cookie\f[R]
The value to be returned back when reading the event, can be used as an
ID for application use.
.SH NOTES
.PP
When mlx5dv_devx_subscribe_devx_event_fd will be used the \f[I]fd\f[R]
will be signaled once an event has occurred.
.SH SEE ALSO
.PP
\f[I]mlx5dv_open_device(3)\f[R],
\f[I]mlx5dv_devx_create_event_channel(3)\f[R],
\f[I]mlx5dv_devx_get_event(3)\f[R]
.PP
#AUTHOR
.PP
Yishai Hadas <yishaih@mellanox.com>
|
