From: Bagas Sanjaya Date: Fri, 7 Nov 2025 08:13:01 +0000 (+0700) Subject: iommupt: Describe @bitnr parameter X-Git-Tag: v6.19-rc1~133^2^8~29 X-Git-Url: http://git.ipfire.org/cgi-bin/gitweb.cgi?a=commitdiff_plain;h=e4dfaf25df1210af6776b6672191cf5e32ba5529;p=thirdparty%2Fkernel%2Flinux.git iommupt: Describe @bitnr parameter Sphinx reports kernel-doc warnings when making htmldocs: WARNING: ./drivers/iommu/generic_pt/pt_common.h:361 function parameter 'bitnr' not described in 'pt_test_sw_bit_acquire' WARNING: ./drivers/iommu/generic_pt/pt_common.h:371 function parameter 'bitnr' not described in 'pt_set_sw_bit_release' Describe @bitnr to squash them. Fixes: bcc64b57b48e ("iommupt: Add basic support for SW bits in the page table") Reviewed-by: Jason Gunthorpe Signed-off-by: Bagas Sanjaya Signed-off-by: Joerg Roedel --- diff --git a/drivers/iommu/generic_pt/pt_common.h b/drivers/iommu/generic_pt/pt_common.h index b5628f47e0db4..3b4e371089140 100644 --- a/drivers/iommu/generic_pt/pt_common.h +++ b/drivers/iommu/generic_pt/pt_common.h @@ -354,6 +354,7 @@ static inline unsigned int pt_max_sw_bit(struct pt_common *common); /** * pt_test_sw_bit_acquire() - Read a software bit in an item * @pts: Entry to set + * @bitnr: Bit to read * * Software bits are ignored by HW and can be used for any purpose by the * software. This does a test bit and acquire operation. @@ -364,6 +365,7 @@ static inline bool pt_test_sw_bit_acquire(struct pt_state *pts, /** * pt_set_sw_bit_release() - Set a software bit in an item * @pts: Entry to set + * @bitnr: Bit to read * * Software bits are ignored by HW and can be used for any purpose by the * software. This does a set bit and release operation.