Subject: Re: linux-next: build warning after merge of the iommufd tree

From: Jason Gunthorpe <[email-masked]>
Date: Fri, 11 Jul 2025 11:04:10 -0300

On Fri, Jul 11, 2025 at 06:35:26PM +1000, Stephen Rothwell wrote:
> Hi all,
> 
> After merging the iommufd tree, today's linux-next build (htmldocs)
> produced this warning:
> 
> include/uapi/linux/iommufd.h:607: warning: cannot understand function prototype: 'struct iommu_hw_info_tegra241_cmdqv '
> 
> Introduced by commit
> 
>   b135de24cfc0 ("iommu/tegra241-cmdqv: Add user-space use support")
> 
> You forgot the "struct" in the kerneldoc comment.

I fixed it with this:

--- a/include/uapi/linux/iommufd.h
+++ b/include/uapi/linux/iommufd.h
@@ -592,8 +592,9 @@ struct iommu_hw_info_arm_smmuv3 {
 };
 
 /**
- * iommu_hw_info_tegra241_cmdqv - NVIDIA Tegra241 CMDQV Hardware Information
- *                                (IOMMU_HW_INFO_TYPE_TEGRA241_CMDQV)
+ * struct iommu_hw_info_tegra241_cmdqv - NVIDIA Tegra241 CMDQV Hardware
+ *         Information (IOMMU_HW_INFO_TYPE_TEGRA241_CMDQV)
+ *
  * @flags: Must be 0
  * @version: Version number for the CMDQ-V HW for PARAM bits[03:00]
  * @log2vcmdqs: Log2 of the total number of VCMDQs for PARAM bits[07:04]

Thanks,
Jason