[PATCH v1 5/5] PCI: tegra: Document map_lock and mask_lock usage
From: Anand Moon
Date: Fri Sep 26 2025 - 03:31:32 EST
Add comments to clarify the purpose of map_lock and mask_lock in the
tegra_msi structure. This addresses checkpatch.pl warnings about missing
comments for struct mutex and spinlock_t definitions, improving code
readability without functional changes.
CHECK: struct mutex definition without comment
+ struct mutex map_lock;
CHECK: spinlock_t definition without comment
+ spinlock_t mask_lock;
Cc: Jon Hunter <jonathanh@xxxxxxxxxx>
Signed-off-by: Anand Moon <linux.amoon@xxxxxxxxx>
---
v1: new patch in this series.
---
drivers/pci/controller/pci-tegra.c | 2 ++
1 file changed, 2 insertions(+)
diff --git a/drivers/pci/controller/pci-tegra.c b/drivers/pci/controller/pci-tegra.c
index 02cee0763396..24b6ae0f0035 100644
--- a/drivers/pci/controller/pci-tegra.c
+++ b/drivers/pci/controller/pci-tegra.c
@@ -270,7 +270,9 @@
struct tegra_msi {
DECLARE_BITMAP(used, INT_PCI_MSI_NR);
struct irq_domain *domain;
+ /* Protects mapping operations */
struct mutex map_lock;
+ /* Guards interrupt mask updates */
spinlock_t mask_lock;
void *virt;
dma_addr_t phys;
--
2.50.1