mlx5dv_get_vfio_device_list(3) — Linux manual page

NAME | SYNOPSIS | DESCRIPTION | ARGUMENTS | RETURN VALUE | NOTES | SEE ALSO | AUTHOR | COLOPHON

mlx5dv_get_vfio_device_list(3)             mlx5dv_get_vfio_device_list(3)

NAME         top

       mlx5dv_get_vfio_device_list - Get list of available devices to be
       used over VFIO

SYNOPSIS         top

              #include <infiniband/mlx5dv.h>

              struct ibv_device **
              mlx5dv_get_vfio_device_list(struct mlx5dv_vfio_context_attr *attr);

DESCRIPTION         top

       Returns a NULL-terminated array of devices based on input attr.

ARGUMENTS         top

       attr   Describe the VFIO devices to return in list.

   attr argument
              struct mlx5dv_vfio_context_attr {
                  const char *pci_name;
                  uint32_t flags;
                  uint64_t comp_mask;
              };

       pci_name
              The PCI name of the required device.

       flags

              A bitwise OR of the various values described below.

              *MLX5DV_VFIO_CTX_FLAGS_INIT_LINK_DOWN*:
              Upon device initialization link should stay down.

       comp_mask

              Bitmask specifying what fields in the structure are valid.

RETURN VALUE         top

       Returns the array of the matching devices, or sets errno and
       returns NULL if the request fails.

NOTES         top

       Client code should open all the devices it intends to use with
       ibv_open_device() before calling ibv_free_device_list().  Once it
       frees the array with ibv_free_device_list(), it will be able to
       use only the open devices; pointers to unopened devices will no
       longer be valid.

SEE ALSO         top

       ibv_open_device(3) ibv_free_device_list(3)

AUTHOR         top

       Yishai Hadas ⟨yishaih@nvidia.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_get_vfio_device_list(3)