summaryrefslogtreecommitdiff
diff options
context:
space:
mode:
authorThomas Gleixner <tglx@linutronix.de>2021-12-06 23:51:49 +0100
committerThomas Gleixner <tglx@linutronix.de>2021-12-16 22:22:20 +0100
commitef3350c53d2aac65cf1c4ecc968bbb1de5f421ea (patch)
tree8e6d71f065f0adb3819bacf50287b15a15773660
parentcc9a246dbf6bdef56d9eee296a1db52dd0607976 (diff)
genirq/msi: Add abuse prevention comment to msi header
Hope dies last. Signed-off-by: Thomas Gleixner <tglx@linutronix.de> Reviewed-by: Greg Kroah-Hartman <gregkh@linuxfoundation.org> Reviewed-by: Jason Gunthorpe <jgg@nvidia.com> Link: https://lore.kernel.org/r/20211206210749.170847844@linutronix.de
-rw-r--r--include/linux/msi.h14
1 files changed, 14 insertions, 0 deletions
diff --git a/include/linux/msi.h b/include/linux/msi.h
index b54010ba7b0d..70cc6a555a8e 100644
--- a/include/linux/msi.h
+++ b/include/linux/msi.h
@@ -2,6 +2,20 @@
#ifndef LINUX_MSI_H
#define LINUX_MSI_H
+/*
+ * This header file contains MSI data structures and functions which are
+ * only relevant for:
+ * - Interrupt core code
+ * - PCI/MSI core code
+ * - MSI interrupt domain implementations
+ * - IOMMU, low level VFIO, NTB and other justified exceptions
+ * dealing with low level MSI details.
+ *
+ * Regular device drivers have no business with any of these functions and
+ * especially storing MSI descriptor pointers in random code is considered
+ * abuse. The only function which is relevant for drivers is msi_get_virq().
+ */
+
#include <linux/cpumask.h>
#include <linux/mutex.h>
#include <linux/list.h>