From nobody Tue Dec 16 07:33:18 2025 Received: from bombadil.infradead.org (bombadil.infradead.org [198.137.202.133]) (using TLSv1.2 with cipher ECDHE-RSA-AES256-GCM-SHA384 (256/256 bits)) (No client certificate requested) by smtp.subspace.kernel.org (Postfix) with ESMTPS id 2AE9D22A7F9 for ; Sun, 14 Dec 2025 20:23:44 +0000 (UTC) Authentication-Results: smtp.subspace.kernel.org; arc=none smtp.client-ip=198.137.202.133 ARC-Seal: i=1; a=rsa-sha256; d=subspace.kernel.org; s=arc-20240116; t=1765743826; cv=none; b=qqyzvnYibm6UZ/YbJw61kw2NqauZVAUHRXGn7GtsUt1pOiJqzgL/tL3MSAQPmabGbredIY6Dw2PR0Mb/G9tN1SwzmQQ/tKX96jmAbz3nc1ILNOrPahe20m8hKgzqWGBjdElBx7XjRiCqldnLY6ztmfzMRVnqSUcgHAa6kc0bWMI= ARC-Message-Signature: i=1; a=rsa-sha256; d=subspace.kernel.org; s=arc-20240116; t=1765743826; c=relaxed/simple; bh=XImq56bClskEsknIWOHjAVhT+bIhI3ghxOXLNV1Qftw=; h=From:To:Cc:Subject:Date:Message-ID:MIME-Version; b=C+4VbS/05wSF2CGnsFchopcQQa1/qkZcGpbIVaeOyYT8RkxTW3bIMgSptxWevPFR8bBRPhYIUeTiwX2fX09R/tYbSnRG34F5NlUWQJ+2ieW5Z2nB/IEjWoUq3hArK17PQFL7S0nfYAqYIek2jNnwb+t4aP2gO9bGoHFmssudi6Q= ARC-Authentication-Results: i=1; smtp.subspace.kernel.org; dmarc=pass (p=none dis=none) header.from=infradead.org; spf=none smtp.mailfrom=infradead.org; dkim=pass (2048-bit key) header.d=infradead.org header.i=@infradead.org header.b=NHj2UF7z; arc=none smtp.client-ip=198.137.202.133 Authentication-Results: smtp.subspace.kernel.org; dmarc=pass (p=none dis=none) header.from=infradead.org Authentication-Results: smtp.subspace.kernel.org; spf=none smtp.mailfrom=infradead.org Authentication-Results: smtp.subspace.kernel.org; dkim=pass (2048-bit key) header.d=infradead.org header.i=@infradead.org header.b="NHj2UF7z" DKIM-Signature: v=1; a=rsa-sha256; q=dns/txt; c=relaxed/relaxed; d=infradead.org; s=bombadil.20210309; h=Content-Transfer-Encoding: MIME-Version:Message-ID:Date:Subject:Cc:To:From:Sender:Reply-To:Content-Type: Content-ID:Content-Description:In-Reply-To:References; bh=8BFIiOfyAIJEFqSWwC6MX4TS7jg+TRp6dfpkcGqpfV0=; b=NHj2UF7zfkdi0w2K8BNHND+1Ti Bmk2eoTXa/orXquBvDjFCmNHQbTk93gUpepQRhhG6T+NXxinaBAgyqBrAkqDHvky1S2/0Jclgb2HJ OLSB6yunESraRj4JJBeZtZzB2VtFJXdGurko4gwdkzQWOJz+pGK2BNVP6f/uubpNibgvR2DIFkSRU N0dS3VruNvvA4d20R/NAyMrhqhmCguECwAQhkNWNos1xxb4QClolxRy8B53uPMet9PQ9lj0VSaJ1x WC4wqDTJgouBWR4F/XTFxuvS4Zw8+iwa1/20/Dq/TFZtFs7qZ0YcE2hZjACF+TV6mVfg8WUv6rbBb HaiYS1nQ==; Received: from [50.53.43.113] (helo=bombadil.infradead.org) by bombadil.infradead.org with esmtpsa (Exim 4.98.2 #2 (Red Hat Linux)) id 1vUsd6-00000002iSl-0RF5; Sun, 14 Dec 2025 20:23:44 +0000 From: Randy Dunlap To: linux-kernel@vger.kernel.org Cc: Randy Dunlap , Thomas Gleixner Subject: [PATCH] PCI/MSI: correct kernel-doc in Date: Sun, 14 Dec 2025 12:23:41 -0800 Message-ID: <20251214202341.2205675-1-rdunlap@infradead.org> X-Mailer: git-send-email 2.52.0 Precedence: bulk X-Mailing-List: linux-kernel@vger.kernel.org List-Id: List-Subscribe: List-Unsubscribe: MIME-Version: 1.0 Content-Transfer-Encoding: quoted-printable Content-Type: text/plain; charset="utf-8" Eliminate all kernel-doc warnings in : - add "struct" to struct kernel-doc headers - add missing struct member descriptions or correct typos in them Fixes these warnings: Warning: include/linux/msi.h:60 cannot understand function prototype: 'struct msi_msg' Warning: include/linux/msi.h:73 struct member 'arch_addr_lo' not described in 'msi_msg' Warning: include/linux/msi.h:73 struct member 'arch_addr_hi' not described in 'msi_msg' Warning: include/linux/msi.h:106 cannot understand function prototype: 'struct pci_msi_desc' Warning: include/linux/msi.h:124 struct member 'msi_attrib' not described in 'pci_msi_desc' Warning: include/linux/msi.h:204 struct member 'sysfs_attrs' not described in 'msi_desc' Warning: include/linux/msi.h:227 struct member 'domain' not described in 'msi_dev_domain' Signed-off-by: Randy Dunlap --- Cc: Thomas Gleixner --- include/linux/msi.h | 13 +++++++------ 1 file changed, 7 insertions(+), 6 deletions(-) --- linux-next-20251201.orig/include/linux/msi.h +++ linux-next-20251201/include/linux/msi.h @@ -49,12 +49,12 @@ typedef struct arch_msi_msg_data { #endif =20 /** - * msi_msg - Representation of a MSI message + * struct msi_msg - Representation of a MSI message * @address_lo: Low 32 bits of msi message address - * @arch_addrlo: Architecture specific shadow of @address_lo + * @arch_addr_lo: Architecture specific shadow of @address_lo * @address_hi: High 32 bits of msi message address * (only used when device supports it) - * @arch_addrhi: Architecture specific shadow of @address_hi + * @arch_addr_hi: Architecture specific shadow of @address_hi * @data: MSI message data (usually 16 bits) * @arch_data: Architecture specific shadow of @data */ @@ -91,7 +91,7 @@ typedef void (*irq_write_msi_msg_t)(stru struct msi_msg *msg); =20 /** - * pci_msi_desc - PCI/MSI specific MSI descriptor data + * struct pci_msi_desc - PCI/MSI specific MSI descriptor data * * @msi_mask: [PCI MSI] MSI cached mask bits * @msix_ctrl: [PCI MSI-X] MSI-X cached per vector control bits @@ -101,6 +101,7 @@ typedef void (*irq_write_msi_msg_t)(stru * @can_mask: [PCI MSI/X] Masking supported? * @is_64: [PCI MSI/X] Address size: 0=3D32bit 1=3D64bit * @default_irq:[PCI MSI/X] The default pre-assigned non-MSI irq + * @msi_attrib: [PCI MSI/X] Compound struct of MSI/X attributes * @mask_pos: [PCI MSI] Mask register position * @mask_base: [PCI MSI-X] Mask register base address */ @@ -169,7 +170,7 @@ struct msi_desc_data { * Only used if iommu_msi_shift !=3D 0 * @iommu_msi_shift: Indicates how many bits of the original address shoul= d be * preserved when using iommu_msi_iova. - * @sysfs_attr: Pointer to sysfs device attribute + * @sysfs_attrs: Pointer to sysfs device attribute * * @write_msi_msg: Callback that may be called when the MSI message * address or data changes @@ -220,7 +221,7 @@ enum msi_desc_filter { /** * struct msi_dev_domain - The internals of MSI domain info per device * @store: Xarray for storing MSI descriptor pointers - * @irqdomain: Pointer to a per device interrupt domain + * @domain: Pointer to a per device interrupt domain */ struct msi_dev_domain { struct xarray store;