Create a API header for MSI specific functions which are relevant to device
drivers.
Signed-off-by: Thomas Gleixner <[email protected]>
Reviewed-by: Jason Gunthorpe <[email protected]>
---
include/linux/msi.h | 6 ++++--
include/linux/msi_api.h | 15 +++++++++++++++
2 files changed, 19 insertions(+), 2 deletions(-)
--- a/include/linux/msi.h
+++ b/include/linux/msi.h
@@ -13,11 +13,14 @@
*
* 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().
+ * abuse.
+ *
+ * Device driver relevant functions are available in <linux/msi_api.h>
*/
#include <linux/irqdomain_defs.h>
#include <linux/cpumask.h>
+#include <linux/msi_api.h>
#include <linux/xarray.h>
#include <linux/mutex.h>
#include <linux/list.h>
@@ -188,7 +191,6 @@ struct msi_device_data {
int msi_setup_device_data(struct device *dev);
-unsigned int msi_get_virq(struct device *dev, unsigned int index);
void msi_lock_descs(struct device *dev);
void msi_unlock_descs(struct device *dev);
--- /dev/null
+++ b/include/linux/msi_api.h
@@ -0,0 +1,15 @@
+/* SPDX-License-Identifier: GPL-2.0 */
+#ifndef LINUX_MSI_API_H
+#define LINUX_MSI_API_H
+
+/*
+ * APIs which are relevant for device driver code for allocating and
+ * freeing MSI interrupts and querying the associations between
+ * hardware/software MSI indices and the Linux interrupt number.
+ */
+
+struct device;
+
+unsigned int msi_get_virq(struct device *dev, unsigned int index);
+
+#endif
On Mon, 21 Nov 2022 14:36:23 +0000,
Thomas Gleixner <[email protected]> wrote:
>
> Create a API header for MSI specific functions which are relevant to device
> drivers.
>
> Signed-off-by: Thomas Gleixner <[email protected]>
> Reviewed-by: Jason Gunthorpe <[email protected]>
> ---
> include/linux/msi.h | 6 ++++--
> include/linux/msi_api.h | 15 +++++++++++++++
> 2 files changed, 19 insertions(+), 2 deletions(-)
Acked-by: Marc Zyngier <[email protected]>
M.
--
Without deviation from the norm, progress is not possible.