include/linux/iommufd.h

   1 /* SPDX-License-Identifier: GPL-2.0-only */
   2 /*
   3  * Copyright (C) 2021 Intel Corporation
   4  * Copyright (c) 2021-2022, NVIDIA CORPORATION & AFFILIATES
   5  */
   6 #ifndef __LINUX_IOMMUFD_H
   7 #define __LINUX_IOMMUFD_H
   8
   9 #include <linux/types.h>
  10 #include <linux/errno.h>
  11 #include <linux/err.h>
  12
  13 struct device;
  14 struct iommufd_device;
  15 struct page;
  16 struct iommufd_ctx;
  17 struct iommufd_access;
  18 struct file;
  19 struct iommu_group;
  20
  21 struct iommufd_device *iommufd_device_bind(struct iommufd_ctx *ictx,
  22                                            struct device *dev, u32 *id);
  23 void iommufd_device_unbind(struct iommufd_device *idev);
  24
  25 int iommufd_device_attach(struct iommufd_device *idev, u32 *pt_id);
  26 int iommufd_device_replace(struct iommufd_device *idev, u32 *pt_id);
  27 void iommufd_device_detach(struct iommufd_device *idev);
  28
  29 struct iommufd_ctx *iommufd_device_to_ictx(struct iommufd_device *idev);
  30 u32 iommufd_device_to_id(struct iommufd_device *idev);
  31
  32 struct iommufd_access_ops {
  33         u8 needs_pin_pages : 1;
  34         void (*unmap)(void *data, unsigned long iova, unsigned long length);
  35 };
  36
  37 enum {
  38         IOMMUFD_ACCESS_RW_READ = 0,
  39         IOMMUFD_ACCESS_RW_WRITE = 1 << 0,
  40         /* Set if the caller is in a kthread then rw will use kthread_use_mm() */
  41         IOMMUFD_ACCESS_RW_KTHREAD = 1 << 1,
  42
  43         /* Only for use by selftest */
  44         __IOMMUFD_ACCESS_RW_SLOW_PATH = 1 << 2,
  45 };
  46
  47 struct iommufd_access *
  48 iommufd_access_create(struct iommufd_ctx *ictx,
  49                       const struct iommufd_access_ops *ops, void *data, u32 *id);
  50 void iommufd_access_destroy(struct iommufd_access *access);
  51 int iommufd_access_attach(struct iommufd_access *access, u32 ioas_id);
  52 int iommufd_access_replace(struct iommufd_access *access, u32 ioas_id);
  53 void iommufd_access_detach(struct iommufd_access *access);
  54
  55 void iommufd_ctx_get(struct iommufd_ctx *ictx);
  56
  57 #if IS_ENABLED(CONFIG_IOMMUFD)
  58 struct iommufd_ctx *iommufd_ctx_from_file(struct file *file);
  59 struct iommufd_ctx *iommufd_ctx_from_fd(int fd);
  60 void iommufd_ctx_put(struct iommufd_ctx *ictx);
  61 bool iommufd_ctx_has_group(struct iommufd_ctx *ictx, struct iommu_group *group);
  62
  63 int iommufd_access_pin_pages(struct iommufd_access *access, unsigned long iova,
  64                              unsigned long length, struct page **out_pages,
  65                              unsigned int flags);
  66 void iommufd_access_unpin_pages(struct iommufd_access *access,
  67                                 unsigned long iova, unsigned long length);
  68 int iommufd_access_rw(struct iommufd_access *access, unsigned long iova,
  69                       void *data, size_t len, unsigned int flags);
  70 int iommufd_vfio_compat_ioas_get_id(struct iommufd_ctx *ictx, u32 *out_ioas_id);
  71 int iommufd_vfio_compat_ioas_create(struct iommufd_ctx *ictx);
  72 int iommufd_vfio_compat_set_no_iommu(struct iommufd_ctx *ictx);
  73 #else /* !CONFIG_IOMMUFD */
  74 static inline struct iommufd_ctx *iommufd_ctx_from_file(struct file *file)
  75 {
  76         return ERR_PTR(-EOPNOTSUPP);
  77 }
  78
  79 static inline void iommufd_ctx_put(struct iommufd_ctx *ictx)
  80 {
  81 }
  82
  83 static inline int iommufd_access_pin_pages(struct iommufd_access *access,
  84                                            unsigned long iova,
  85                                            unsigned long length,
  86                                            struct page **out_pages,
  87                                            unsigned int flags)
  88 {
  89         return -EOPNOTSUPP;
  90 }
  91
  92 static inline void iommufd_access_unpin_pages(struct iommufd_access *access,
  93                                               unsigned long iova,
  94                                               unsigned long length)
  95 {
  96 }
  97
  98 static inline int iommufd_access_rw(struct iommufd_access *access, unsigned long iova,
  99                       void *data, size_t len, unsigned int flags)
 100 {
 101         return -EOPNOTSUPP;
 102 }
 103
 104 static inline int iommufd_vfio_compat_ioas_create(struct iommufd_ctx *ictx)
 105 {
 106         return -EOPNOTSUPP;
 107 }
 108
 109 static inline int iommufd_vfio_compat_set_no_iommu(struct iommufd_ctx *ictx)
 110 {
 111         return -EOPNOTSUPP;
 112 }
 113 #endif /* CONFIG_IOMMUFD */
 114 #endif