vfio: document multiprocess limitation for container API
authorAnatoly Burakov <anatoly.burakov@intel.com>
Wed, 27 Feb 2019 15:41:24 +0000 (15:41 +0000)
committerThomas Monjalon <thomas@monjalon.net>
Thu, 28 Mar 2019 23:07:16 +0000 (00:07 +0100)
Currently, there is no support for sharing custom VFIO containers
between multiple processes, but it is not documented.

Document this limitation.

Cc: stable@dpdk.org
Signed-off-by: Anatoly Burakov <anatoly.burakov@intel.com>
lib/librte_eal/common/include/rte_vfio.h

index cae96fa..4b3a91e 100644 (file)
@@ -291,6 +291,10 @@ rte_vfio_get_group_fd(int iommu_group_num);
  *       containers by default, user needs to manage DMA mappings for
  *       any container created by this API.
  *
+ * @note When creating containers using this API, the container will only be
+ *       available in the process that has created it. Sharing containers and
+ *       devices between multiple processes is not supported.
+ *
  * @return
  *   the container fd if successful
  *   <0 if failed