NAME | SYNOPSIS | DESCRIPTION | ARGUMENTS | RETURN VALUE | NOTES | SEE ALSO | AUTHOR | COLOPHON |
|
|
mlx5dv_get_vfio_device_list(3) mlx5dv_get_vfio_device_list(3)
mlx5dv_get_vfio_device_list - Get list of available devices to be used over VFIO
#include <infiniband/mlx5dv.h> struct ibv_device ** mlx5dv_get_vfio_device_list(struct mlx5dv_vfio_context_attr *attr);
Returns a NULL-terminated array of devices based on input attr.
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.
Returns the array of the matching devices, or sets errno and returns NULL if the request fails.
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.
ibv_open_device(3) ibv_free_device_list(3)
Yishai Hadas ⟨yishaih@nvidia.com⟩
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)