mlx5dv_get_vfio_device_list(3) mlx5dv_get_vfio_device_list(3)
NAME
mlx5dv_get_vfio_device_list - Get list of available devices to be used
over VFIO
SYNOPSIS
#include <infiniband/mlx5dv.h>
struct ibv_device **
mlx5dv_get_vfio_device_list(struct mlx5dv_vfio_context_attr *attr);
DESCRIPTION
Returns a NULL-terminated array of devices based on input attr.
ARGUMENTS
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
Returns the array of the matching devices, or sets errno and returns
NULL if the request fails.
NOTES
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
ibv_open_device(3) ibv_free_device_list(3)
AUTHOR
Yishai Hadas <yishaih@nvidia.com>
mlx5dv_get_vfio_device_list(3)
Generated by dwww version 1.15 on Sat Jun 29 11:03:42 CEST 2024.