From: Thierry Reding Date: Tue, 6 Dec 2022 16:59:40 +0000 (+0100) Subject: iommu: Add note about struct iommu_fwspec usage X-Git-Tag: microblaze-v6.6~1557^2~8 X-Git-Url: http://git.monstr.eu/?a=commitdiff_plain;h=495b637f640b7f87ab42f3cc829e35ea76a1f3eb;p=linux-2.6-microblaze.git iommu: Add note about struct iommu_fwspec usage This structure is to be considered private to the IOMMU API. Except for very few exceptions, IOMMU consumer drivers should treat this as opaque data. Acked-by: Joerg Roedel Signed-off-by: Thierry Reding Link: https://lore.kernel.org/r/20221206165945.3551774-2-thierry.reding@gmail.com Signed-off-by: Ulf Hansson --- diff --git a/include/linux/iommu.h b/include/linux/iommu.h index 3c9da1f8979e..20b592dec335 100644 --- a/include/linux/iommu.h +++ b/include/linux/iommu.h @@ -605,6 +605,10 @@ struct iommu_group *fsl_mc_device_group(struct device *dev); * @flags: IOMMU_FWSPEC_* flags * @num_ids: number of associated device IDs * @ids: IDs which this device may present to the IOMMU + * + * Note that the IDs (and any other information, really) stored in this structure should be + * considered private to the IOMMU device driver and are not to be used directly by IOMMU + * consumers. */ struct iommu_fwspec { const struct iommu_ops *ops;