mlx5dv_devx_subscribe_devx_event_fd(3) — Linux manual page

NAME | SYNOPSIS | DESCRIPTION | ARGUMENTS | NOTES | SEE ALSO | COLOPHON

mlx5dv_devx_su...e_devx_event_fd(3)   mlx5dv_devx_su...e_devx_event_fd(3)

NAME         top

       mlx5dv_devx_subscribe_devx_event - Subscribe over an event channel
       for device events.

       mlx5dv_devx_subscribe_devx_event_fd - Subscribe over an event
       channel for device events to signal eventfd.

SYNOPSIS         top

              #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)

DESCRIPTION         top

       Subscribe over a DEVX event channel for device events.

ARGUMENTS         top

       dv_event_channel
              Event channel to subscribe over.

       fd     A file descriptor that previously was opened by the
              eventfd() system call.

       obj    DEVX object that events_num relates to, can be NULL for
              unaffiliated events.

       events_sz
              Size of the events_num buffer that holds the events to
              subscribe for.

       events_num
              Holds the required event numbers to subscribe for, numbers
              are according to the device specification.

       cookie The value to be returned back when reading the event, can
              be used as an ID for application use.

NOTES         top

       When mlx5dv_devx_subscribe_devx_event_fd will be used the fd will
       be signaled once an event has occurred.

SEE ALSO         top

       mlx5dv_open_device(3), mlx5dv_devx_create_event_channel(3),
       mlx5dv_devx_get_event(3)

       #AUTHOR

       Yishai Hadas ⟨yishaih@mellanox.com⟩

COLOPHON         top

       This page is part of the rdma-core (RDMA Core Userspace Libraries
       and Daemons) project.  Information about the project can be found
       at ⟨https://github.com/linux-rdma/rdma-core⟩.  If you have a bug
       report for this manual page, send it to
       linux-rdma@vger.kernel.org.  This page was obtained from the
       project's upstream Git repository
       ⟨https://github.com/linux-rdma/rdma-core.git⟩ on 2025-08-11.  (At
       that time, the date of the most recent commit that was found in
       the repository was 2025-08-04.)  If you discover any rendering
       problems in this HTML version of the page, or you believe there is
       a better or more up-to-date source for the page, or you have
       corrections or improvements to the information in this COLOPHON
       (which is not part of the original manual page), send a mail to
       man-pages@man7.org

                                      mlx5dv_devx_su...e_devx_event_fd(3)