Skip to contentSkip to conversation

Introduce auxiliary bus IRQs sysfs

PATCH Superseded Shay Drory 4 participants 11 messages Jun 18, 2024 – Jun 25, 2024

Subsystems (6)

v7 of 10 Superseded Latest is v10 →

lore
Share & tools
lore

Shay Drory

author
#0 lore raw

v7 cover Introduce auxiliary bus IRQs sysfs

Today, PCI PFs and VFs, which are anchored on the PCI bus, display their IRQ information in the <pci_device>/msi_irqs/<irq_num> sysfs files. PCI subfunctions (SFs) are similar to PFs and VFs and these SFs are anchored on the auxiliary bus. However, these PCI SFs lack such IRQ information on the auxiliary bus, leaving users without visibility into which IRQs are used by the SFs. This absence makes it impossible to debug situations and to understand the source of interrupts/SFs for performance tuning and debug.

Additionally, the SFs are multifunctional devices supporting RDMA, network devices, clocks, and more, similar to their peer PCI PFs and VFs. Therefore, it is desirable to have SFs' IRQ information available at the bus/device level.

To overcome the above limitations, this short series extends the auxiliary bus to display IRQ information in sysfs, similar to that of PFs and VFs.

It adds an 'irqs' directory under the auxiliary device and includes an <irq_num> sysfs file within it.

For example:

$ ls /sys/bus/auxiliary/devices/mlx5_core.sf.1/irqs/
50  51  52  53  54  55  56  57  58

Patch summary:
==============
patch-1 adds auxiliary bus to support irqs used by auxiliary device patch-2 mlx5 driver using exposing irqs for PCI SF devices via auxiliary
bus

---
v6->v7:
- dynamically creating irqs directory when first irq file created, patch #1 (Greg).
- removed irqs flag and simplified the dev_add() API, patch #1 (Greg).
- move sysfs related new code to a new auxiliary_sysfs.c file, patch #1 (Greg). v5->v6:
- fix error flow in patch #2 (Przemek and Parav).
- remove concept of shared and exclusive and hence global xarray in patch #1 (Greg). v4->v5:
- addressed comments from Greg in patch #1.
v3->4:
- addressed comments from Przemek in patch #1.
v2->v3:
- addressed comments from Parav and Przemek in patch #1.
- fixed a bug in patch #2.
v1->v2:
- addressed comments from Greg, Simon H and kernel test boot in patch #1.

Shay Drory (2):
driver core: auxiliary bus: show auxiliary device IRQs net/mlx5: Expose SFs IRQs

 Documentation/ABI/testing/sysfs-bus-auxiliary |   7 ++
 drivers/base/Makefile                         |   1 +
 drivers/base/auxiliary.c                      |   1 +
 drivers/base/auxiliary_sysfs.c                | 110 ++++++++++++++++++
 drivers/net/ethernet/mellanox/mlx5/core/eq.c  |   6 +-
 .../mellanox/mlx5/core/irq_affinity.c         |  18 ++-
 .../ethernet/mellanox/mlx5/core/mlx5_core.h   |   6 +
 .../ethernet/mellanox/mlx5/core/mlx5_irq.h    |  12 +-
 .../net/ethernet/mellanox/mlx5/core/pci_irq.c |  12 +-
 include/linux/auxiliary_bus.h                 |  20 ++++
 10 files changed, 182 insertions(+), 11 deletions(-)
 create mode 100644 Documentation/ABI/testing/sysfs-bus-auxiliary
 create mode 100644 drivers/base/auxiliary_sysfs.c
Signature · 1 line
2.38.1
author
#1 lore raw

PATCH v7 1/2 driver core: auxiliary bus: show auxiliary device IRQs

PCI subfunctions (SF) are anchored on the auxiliary bus. PCI physical and virtual functions are anchored on the PCI bus. The irq information of each such function is visible to users via sysfs directory "msi_irqs" containing files for each irq entry. However, for PCI SFs such information is unavailable. Due to this users have no visibility on IRQs used by the SFs.
Secondly, an SF can be multi function device supporting rdma, netdevice and more. Without irq information at the bus level, the user is unable to view or use the affinity of the SF IRQs.

Hence to match to the equivalent PCI PFs and VFs, add "irqs" directory, for supporting auxiliary devices, containing file for each irq entry.

For example:

$ ls /sys/bus/auxiliary/devices/mlx5_core.sf.1/irqs/
50  51  52  53  54  55  56  57  58

---
v6-v7:
- dynamically creating irqs directory when first irq file created (Greg)
- removed irqs flag and simplified the dev_add() API (Greg)
- move sysfs related new code to a new auxiliary_sysfs.c file (Greg) v5-v6:
- removed concept of shared and exclusive and hence global xarray (Greg) v4-v5:
- restore global mutex and replace refcount_t with simple integer (Greg) v3->4:
- remove global mutex (Przemek)
v2->v3:
- fix function declaration in case SYSFS isn't defined v1->v2:
- move #ifdefs from drivers/base/auxiliary.c to include/linux/auxiliary_bus.h (Greg)
- use EXPORT_SYMBOL_GPL instead of EXPORT_SYMBOL (Greg)
- Fix kzalloc(ref) to kzalloc(*ref) (Simon)
- Add return description in auxiliary_device_sysfs_irq_add() kdoc (Simon)
- Fix auxiliary_irq_mode_show doc (kernel test boot)

---
 Documentation/ABI/testing/sysfs-bus-auxiliary |   7 ++
 drivers/base/Makefile                         |   1 +
 drivers/base/auxiliary.c                      |   1 +
 drivers/base/auxiliary_sysfs.c                | 110 ++++++++++++++++++
 include/linux/auxiliary_bus.h                 |  20 ++++
 5 files changed, 139 insertions(+)
 create mode 100644 Documentation/ABI/testing/sysfs-bus-auxiliary
 create mode 100644 drivers/base/auxiliary_sysfs.c
Documentation/ABI/testing/sysfs-bus-auxiliary new file +7 -0
new file mode 100644
index 000000000000..e8752c2354bc
@@ -0,0 +1,7 @@
+What:		/sys/bus/auxiliary/devices/.../irqs/
+Date:		April, 2024
+Contact:	Shay Drory <[email protected]>
+Description:
+		The /sys/devices/.../irqs directory contains a variable set of
+		files, with each file is named as irq number similar to PCI PF
+		or VF's irq number located in msi_irqs directory.
drivers/base/Makefile +1 -0
index 3079bfe53d04..7fb21768ca36 100644
@@ -16,6 +16,7 @@ obj-$(CONFIG_NUMA)	+= node.o
 obj-$(CONFIG_MEMORY_HOTPLUG) += memory.o
 ifeq ($(CONFIG_SYSFS),y)
 obj-$(CONFIG_MODULES)	+= module.o
+obj-$(CONFIG_AUXILIARY_BUS) += auxiliary_sysfs.o
 endif
 obj-$(CONFIG_SYS_HYPERVISOR) += hypervisor.o
 obj-$(CONFIG_REGMAP)	+= regmap/
drivers/base/auxiliary.c +1 -0
index d3a2c40c2f12..55bde375150f 100644
@@ -287,6 +287,7 @@ int auxiliary_device_init(struct auxiliary_device *auxdev)
 
 	dev->bus = &auxiliary_bus_type;
 	device_initialize(&auxdev->dev);
+	mutex_init(&auxdev->lock);
 	return 0;
 }
 EXPORT_SYMBOL_GPL(auxiliary_device_init);
drivers/base/auxiliary_sysfs.c new file +110 -0

110 lines not on this page · raw message

include/linux/auxiliary_bus.h +20 -0
index de21d9d24a95..96be140bd1ff 100644
@@ -58,6 +58,7 @@
  *       in
  * @name: Match name found by the auxiliary device driver,
  * @id: unique identitier if multiple devices of the same name are exported,
+ * @irqs: irqs xarray contains irq indices which are used by the device,
  *
  * An auxiliary_device represents a part of its parent device's functionality.
  * It is given a name that, combined with the registering drivers
@@ -138,7 +139,10 @@
 struct auxiliary_device {
 	struct device dev;
 	const char *name;
+	struct xarray irqs;
+	struct mutex lock; /* Protects "irqs" directory creation */
 	u32 id;
+	u8 dir_exists:1;
 };
 
 /**
@@ -212,8 +216,24 @@ int auxiliary_device_init(struct auxiliary_device *auxdev);
 int __auxiliary_device_add(struct auxiliary_device *auxdev, const char *modname);
 #define auxiliary_device_add(auxdev) __auxiliary_device_add(auxdev, KBUILD_MODNAME)
 
+#ifdef CONFIG_SYSFS
+int auxiliary_device_sysfs_irq_add(struct auxiliary_device *auxdev, int irq);
+void auxiliary_device_sysfs_irq_remove(struct auxiliary_device *auxdev,
+				       int irq);
+#else /* CONFIG_SYSFS */
+static inline int
+auxiliary_device_sysfs_irq_add(struct auxiliary_device *auxdev, int irq)
+{
+	return 0;
+}
+
+static inline void
+auxiliary_device_sysfs_irq_remove(struct auxiliary_device *auxdev, int irq) {}
+#endif
+
 static inline void auxiliary_device_uninit(struct auxiliary_device *auxdev)
 {
+	mutex_destroy(&auxdev->lock);
 	put_device(&auxdev->dev);
 }
 
Signature · 1 line
2.38.1
#2 lore raw

Re: [PATCH net-next v7 1/2] driver core: auxiliary bus: show auxiliary device IRQs

Quoted 25 lines · Shay Drory

PCI subfunctions (SF) are anchored on the auxiliary bus. PCI physical and virtual functions are anchored on the PCI bus. The irq information of each such function is visible to users via sysfs directory "msi_irqs" containing files for each irq entry. However, for PCI SFs such information is unavailable. Due to this users have no visibility on IRQs used by the SFs.
Secondly, an SF can be multi function device supporting rdma, netdevice and more. Without irq information at the bus level, the user is unable to view or use the affinity of the SF IRQs.

Hence to match to the equivalent PCI PFs and VFs, add "irqs" directory, for supporting auxiliary devices, containing file for each irq entry.

For example:

$ ls /sys/bus/auxiliary/devices/mlx5_core.sf.1/irqs/
50  51  52  53  54  55  56  57  58

---
v6-v7:
- dynamically creating irqs directory when first irq file created (Greg)
- removed irqs flag and simplified the dev_add() API (Greg)
- move sysfs related new code to a new auxiliary_sysfs.c file (Greg)

[...]

drivers/base/auxiliary_sysfs.c line 30

Quoted 9 lines
drivers/base/auxiliary_sysfs.c new file +9 -0
+static int auxiliary_irq_dir_prepare(struct auxiliary_device *auxdev)
+{
+	int ret = 0;
+
+	mutex_lock(&auxdev->lock);
+	if (auxdev->dir_exists)
+		goto unlock;
+
+	xa_init(&auxdev->irqs);

due to below error handling you could end up with calling xa_init() twice (and this is a "library" code, so it does not matter how you handle this error in the current sole user ;))

Quoted 9 lines
drivers/base/auxiliary_sysfs.c new file +9 -0
+	ret = devm_device_add_group(&auxdev->dev, &auxiliary_irqs_group);
+	if (!ret)
+		auxdev->dir_exists = 1;
+
+unlock:
+	mutex_unlock(&auxdev->lock);
+	return ret;
+}
+

[...]

Quoted 11 lines
include/linux/auxiliary_bus.h +1 -0
@@ -58,6 +58,7 @@
   *       in
   * @name: Match name found by the auxiliary device driver,
   * @id: unique identitier if multiple devices of the same name are exported,
+ * @irqs: irqs xarray contains irq indices which are used by the device,
   *
   * An auxiliary_device represents a part of its parent device's functionality.
   * It is given a name that, combined with the registering drivers

include/linux/auxiliary_bus.h line 145

Quoted 7 lines
include/linux/auxiliary_bus.h +3 -0
@@ -138,7 +139,10 @@
  struct auxiliary_device {
  	struct device dev;
  	const char *name;
+	struct xarray irqs;
+	struct mutex lock; /* Protects "irqs" directory creation */
  	u32 id;
+	u8 dir_exists:1;

nit: I would make it a bool, or bool: 1 if you really want

Quoted 1 line
include/linux/auxiliary_bus.h +0 -0
  };

[...]

maintainer
#3 lore raw

Re: [PATCH net-next v7 1/2] driver core: auxiliary bus: show auxiliary device IRQs

Quoted 67 lines · Przemek Kitszel
Quoted 25 lines · Shay Drory

PCI subfunctions (SF) are anchored on the auxiliary bus. PCI physical and virtual functions are anchored on the PCI bus. The irq information of each such function is visible to users via sysfs directory "msi_irqs" containing files for each irq entry. However, for PCI SFs such information is unavailable. Due to this users have no visibility on IRQs used by the SFs.
Secondly, an SF can be multi function device supporting rdma, netdevice and more. Without irq information at the bus level, the user is unable to view or use the affinity of the SF IRQs.

Hence to match to the equivalent PCI PFs and VFs, add "irqs" directory, for supporting auxiliary devices, containing file for each irq entry.

For example:

$ ls /sys/bus/auxiliary/devices/mlx5_core.sf.1/irqs/
50  51  52  53  54  55  56  57  58

---
v6-v7:
- dynamically creating irqs directory when first irq file created (Greg)
- removed irqs flag and simplified the dev_add() API (Greg)
- move sysfs related new code to a new auxiliary_sysfs.c file (Greg)

[...]

drivers/base/auxiliary_sysfs.c line 30

Quoted 9 lines
drivers/base/auxiliary_sysfs.c new file +9 -0
+static int auxiliary_irq_dir_prepare(struct auxiliary_device *auxdev)
+{
+	int ret = 0;
+
+	mutex_lock(&auxdev->lock);
+	if (auxdev->dir_exists)
+		goto unlock;
+
+	xa_init(&auxdev->irqs);

due to below error handling you could end up with calling xa_init() twice (and this is a "library" code, so it does not matter how you handle this error in the current sole user ;))

Quoted 9 lines
drivers/base/auxiliary_sysfs.c new file +9 -0
+	ret = devm_device_add_group(&auxdev->dev, &auxiliary_irqs_group);
+	if (!ret)
+		auxdev->dir_exists = 1;
+
+unlock:
+	mutex_unlock(&auxdev->lock);
+	return ret;
+}
+

[...]

Quoted 12 lines
include/linux/auxiliary_bus.h +1 -0
@@ -58,6 +58,7 @@
   *       in
   * @name: Match name found by the auxiliary device driver,
   * @id: unique identitier if multiple devices of the same name are exported,
+ * @irqs: irqs xarray contains irq indices which are used by the device,
   *
   * An auxiliary_device represents a part of its parent device's functionality.
   * It is given a name that, combined with the registering drivers
@@ -138,7 +139,10 @@
  struct auxiliary_device {
Quoted 8 lines

include/linux/auxiliary_bus.h line 145

Quoted 6 lines
include/linux/auxiliary_bus.h +3 -0
  	struct device dev;
  	const char *name;
+	struct xarray irqs;
+	struct mutex lock; /* Protects "irqs" directory creation */
  	u32 id;
+	u8 dir_exists:1;

nit: I would make it a bool, or bool: 1 if you really want

Why is this even needed? It should "know" if the directory is there or not, it can always be looked up, right?

thanks,

greg k-h

maintainer
#4 lore raw

Re: [PATCH net-next v7 1/2] driver core: auxiliary bus: show auxiliary device IRQs

In reply to Shay Drory
Quoted 24 lines · Shay Drory
drivers/base/auxiliary_sysfs.c new file +18 -0
new file mode 100644
index 000000000000..3f112fd26e72
@@ -0,0 +1,110 @@
+// SPDX-License-Identifier: GPL-2.0
+/*
+ * Copyright (c) 2024, NVIDIA CORPORATION & AFFILIATES
+ */
+
+#include <linux/auxiliary_bus.h>
+#include <linux/slab.h>
+
+struct auxiliary_irq_info {
+	struct device_attribute sysfs_attr;
+};
+
+static struct attribute *auxiliary_irq_attrs[] = {
+	NULL
+};
+
+static const struct attribute_group auxiliary_irqs_group = {
+	.name = "irqs",

drivers/base/auxiliary_sysfs.c line 28

Quoted 10 lines
drivers/base/auxiliary_sysfs.c new file +10 -0
+	.attrs = auxiliary_irq_attrs,
+};
+
+static int auxiliary_irq_dir_prepare(struct auxiliary_device *auxdev)
+{
+	int ret = 0;
+
+	mutex_lock(&auxdev->lock);
+	if (auxdev->dir_exists)
+		goto unlock;

You do know about cleanup.h, right? Please use it.

But what exactly are you trying to protect here? How will you race and add two irqs at the same time? Driver probe is always single threaded, so what would be calling this at the same time from multiple places?

Quoted 33 lines
drivers/base/auxiliary_sysfs.c new file +33 -0
+
+	xa_init(&auxdev->irqs);
+	ret = devm_device_add_group(&auxdev->dev, &auxiliary_irqs_group);
+	if (!ret)
+		auxdev->dir_exists = 1;
+
+unlock:
+	mutex_unlock(&auxdev->lock);
+	return ret;
+}
+
+/**
+ * auxiliary_device_sysfs_irq_add - add a sysfs entry for the given IRQ
+ * @auxdev: auxiliary bus device to add the sysfs entry.
+ * @irq: The associated interrupt number.
+ *
+ * This function should be called after auxiliary device have successfully
+ * received the irq.
+ *
+ * Return: zero on success or an error code on failure.
+ */
+int auxiliary_device_sysfs_irq_add(struct auxiliary_device *auxdev, int irq)
+{
+	struct device *dev = &auxdev->dev;
+	struct auxiliary_irq_info *info;
+	int ret;
+
+	ret = auxiliary_irq_dir_prepare(auxdev);
+	if (ret)
+		return ret;
+
+	info = kzalloc(sizeof(*info), GFP_KERNEL);
+	if (!info)

drivers/base/auxiliary_sysfs.c line 71

Quoted 10 lines
drivers/base/auxiliary_sysfs.c new file +10 -0
+		return -ENOMEM;
+
+	sysfs_attr_init(&info->sysfs_attr.attr);
+	info->sysfs_attr.attr.name = kasprintf(GFP_KERNEL, "%d", irq);
+	if (!info->sysfs_attr.attr.name) {
+		ret = -ENOMEM;
+		goto name_err;
+	}
+
+	ret = xa_insert(&auxdev->irqs, irq, info, GFP_KERNEL);

So no lock happening here, either use it always, or not at all?

drivers/base/auxiliary_sysfs.c line 76

Quoted 5 lines
drivers/base/auxiliary_sysfs.c new file +5 -0
+	if (ret)
+		goto auxdev_xa_err;
+
+	ret = sysfs_add_file_to_group(&dev->kobj, &info->sysfs_attr.attr,
+				      auxiliary_irqs_group.name);

You do know that you are never going to see these files from the userspace library tools that watch sysfs, right? libudev will never see them as you are adding them AFTER the device is created.

So, because of that, who is really going to use these files?

drivers/base/auxiliary_sysfs.c line 87

Quoted 11 lines
drivers/base/auxiliary_sysfs.c new file +11 -0
+	if (ret)
+		goto sysfs_add_err;
+
+	return 0;
+
+sysfs_add_err:
+	xa_erase(&auxdev->irqs, irq);
+auxdev_xa_err:
+	kfree(info->sysfs_attr.attr.name);
+name_err:
+	kfree(info);

Again, cleanup.h is your friend.

Quoted 36 lines
drivers/base/auxiliary_sysfs.c new file +23 -0
+	return ret;
+}
+EXPORT_SYMBOL_GPL(auxiliary_device_sysfs_irq_add);
+
+/**
+ * auxiliary_device_sysfs_irq_remove - remove a sysfs entry for the given IRQ
+ * @auxdev: auxiliary bus device to add the sysfs entry.
+ * @irq: the IRQ to remove.
+ *
+ * This function should be called to remove an IRQ sysfs entry.
+ */
+void auxiliary_device_sysfs_irq_remove(struct auxiliary_device *auxdev, int irq)
+{
+	struct auxiliary_irq_info *info = xa_load(&auxdev->irqs, irq);
+	struct device *dev = &auxdev->dev;
+
+	sysfs_remove_file_from_group(&dev->kobj, &info->sysfs_attr.attr,
+				     auxiliary_irqs_group.name);
+	xa_erase(&auxdev->irqs, irq);
+	kfree(info->sysfs_attr.attr.name);
+	kfree(info);
+}
+EXPORT_SYMBOL_GPL(auxiliary_device_sysfs_irq_remove);
include/linux/auxiliary_bus.h +1 -0
index de21d9d24a95..96be140bd1ff 100644
@@ -58,6 +58,7 @@
  *       in
  * @name: Match name found by the auxiliary device driver,
  * @id: unique identitier if multiple devices of the same name are exported,
+ * @irqs: irqs xarray contains irq indices which are used by the device,
  *
  * An auxiliary_device represents a part of its parent device's functionality.
  * It is given a name that, combined with the registering drivers

include/linux/auxiliary_bus.h line 143

Quoted 5 lines
include/linux/auxiliary_bus.h +2 -0
@@ -138,7 +139,10 @@
 struct auxiliary_device {
 	struct device dev;
 	const char *name;
+	struct xarray irqs;
+	struct mutex lock; /* Protects "irqs" directory creation */

Protects it from what?

include/linux/auxiliary_bus.h line 145

Quoted 2 lines
include/linux/auxiliary_bus.h +1 -0
 	u32 id;
+	u8 dir_exists:1;

I don't think this is needed, but if it really is, just use a bool.

include/linux/auxiliary_bus.h int auxiliary_device_init(struct auxiliary_device *auxdev); · line 222

Quoted 11 lines
include/linux/auxiliary_bus.h +4 -0
 };
 
 /**
@@ -212,8 +216,24 @@ int auxiliary_device_init(struct auxiliary_device *auxdev);
 int __auxiliary_device_add(struct auxiliary_device *auxdev, const char *modname);
 #define auxiliary_device_add(auxdev) __auxiliary_device_add(auxdev, KBUILD_MODNAME)
 
+#ifdef CONFIG_SYSFS
+int auxiliary_device_sysfs_irq_add(struct auxiliary_device *auxdev, int irq);
+void auxiliary_device_sysfs_irq_remove(struct auxiliary_device *auxdev,
+				       int irq);

You can use longer lines :)

thanks,

greg k-h

author
#5 lore raw

Re: [PATCH net-next v7 1/2] driver core: auxiliary bus: show auxiliary device IRQs

Quoted 41 lines · Greg KH

External email: Use caution opening links or attachments

Quoted 24 lines · Shay Drory
drivers/base/auxiliary_sysfs.c new file +18 -0
new file mode 100644
index 000000000000..3f112fd26e72
@@ -0,0 +1,110 @@
+// SPDX-License-Identifier: GPL-2.0
+/*
+ * Copyright (c) 2024, NVIDIA CORPORATION & AFFILIATES
+ */
+
+#include <linux/auxiliary_bus.h>
+#include <linux/slab.h>
+
+struct auxiliary_irq_info {
+     struct device_attribute sysfs_attr;
+};
+
+static struct attribute *auxiliary_irq_attrs[] = {
+     NULL
+};
+
+static const struct attribute_group auxiliary_irqs_group = {
+     .name = "irqs",

drivers/base/auxiliary_sysfs.c line 28

Quoted 10 lines
drivers/base/auxiliary_sysfs.c new file +10 -0
+     .attrs = auxiliary_irq_attrs,
+};
+
+static int auxiliary_irq_dir_prepare(struct auxiliary_device *auxdev)
+{
+     int ret = 0;
+
+     mutex_lock(&auxdev->lock);
+     if (auxdev->dir_exists)
+             goto unlock;

You do know about cleanup.h, right? Please use it.

Quoted 3 lines

But what exactly are you trying to protect here? How will you race and add two irqs at the same time? Driver probe is always single threaded, so what would be calling this at the same time from multiple places?

mlx5 driver requests IRQs on demand for PCI PF, VF, SFs. And it occurs from multiple threads, hence we need to protect it.

Quoted 39 lines
Quoted 39 lines
drivers/base/auxiliary_sysfs.c new file +37 -0
+
+     xa_init(&auxdev->irqs);
+     ret = devm_device_add_group(&auxdev->dev, &auxiliary_irqs_group);
+     if (!ret)
+             auxdev->dir_exists = 1;
+
+unlock:
+     mutex_unlock(&auxdev->lock);
+     return ret;
+}
+
+/**
+ * auxiliary_device_sysfs_irq_add - add a sysfs entry for the given IRQ
+ * @auxdev: auxiliary bus device to add the sysfs entry.
+ * @irq: The associated interrupt number.
+ *
+ * This function should be called after auxiliary device have successfully
+ * received the irq.
+ *
+ * Return: zero on success or an error code on failure.
+ */
+int auxiliary_device_sysfs_irq_add(struct auxiliary_device *auxdev, int irq)
+{
+     struct device *dev = &auxdev->dev;
+     struct auxiliary_irq_info *info;
+     int ret;
+
+     ret = auxiliary_irq_dir_prepare(auxdev);
+     if (ret)
+             return ret;
+
+     info = kzalloc(sizeof(*info), GFP_KERNEL);
+     if (!info)
+             return -ENOMEM;
+
+     sysfs_attr_init(&info->sysfs_attr.attr);
+     info->sysfs_attr.attr.name = kasprintf(GFP_KERNEL, "%d", irq);
Quoted 8 lines

drivers/base/auxiliary_sysfs.c line 71

Quoted 6 lines
drivers/base/auxiliary_sysfs.c new file +6 -0
+     if (!info->sysfs_attr.attr.name) {
+             ret = -ENOMEM;
+             goto name_err;
+     }
+
+     ret = xa_insert(&auxdev->irqs, irq, info, GFP_KERNEL);

So no lock happening here, either use it always, or not at all?

the lock is only needed to protect the group (directory) creation, which will be used by all the IRQs of this auxdev.
parallel calls to this API will always be with different IRQs, which means each IRQ have a unique index.

Quoted 8 lines

drivers/base/auxiliary_sysfs.c line 76

Quoted 7 lines
drivers/base/auxiliary_sysfs.c new file +5 -0
+     if (ret)
+             goto auxdev_xa_err;
+
+     ret = sysfs_add_file_to_group(&dev->kobj, &info->sysfs_attr.attr,
+                                   auxiliary_irqs_group.name);
Quoted 5 lines

You do know that you are never going to see these files from the userspace library tools that watch sysfs, right? libudev will never see them as you are adding them AFTER the device is created.

So, because of that, who is really going to use these files?

To learn about the interrupt mapping of the SF IRQs.

Quoted 51 lines

drivers/base/auxiliary_sysfs.c line 87

Quoted 13 lines
drivers/base/auxiliary_sysfs.c new file +11 -0
+     if (ret)
+             goto sysfs_add_err;
+
+     return 0;
+
+sysfs_add_err:
+     xa_erase(&auxdev->irqs, irq);
+auxdev_xa_err:
+     kfree(info->sysfs_attr.attr.name);
+name_err:
+     kfree(info);

Again, cleanup.h is your friend.

Quoted 35 lines
drivers/base/auxiliary_sysfs.c new file +23 -0
+     return ret;
+}
+EXPORT_SYMBOL_GPL(auxiliary_device_sysfs_irq_add);
+
+/**
+ * auxiliary_device_sysfs_irq_remove - remove a sysfs entry for the given IRQ
+ * @auxdev: auxiliary bus device to add the sysfs entry.
+ * @irq: the IRQ to remove.
+ *
+ * This function should be called to remove an IRQ sysfs entry.
+ */
+void auxiliary_device_sysfs_irq_remove(struct auxiliary_device *auxdev, int irq)
+{
+     struct auxiliary_irq_info *info = xa_load(&auxdev->irqs, irq);
+     struct device *dev = &auxdev->dev;
+
+     sysfs_remove_file_from_group(&dev->kobj, &info->sysfs_attr.attr,
+                                  auxiliary_irqs_group.name);
+     xa_erase(&auxdev->irqs, irq);
+     kfree(info->sysfs_attr.attr.name);
+     kfree(info);
+}
+EXPORT_SYMBOL_GPL(auxiliary_device_sysfs_irq_remove);
include/linux/auxiliary_bus.h +1 -0
index de21d9d24a95..96be140bd1ff 100644
@@ -58,6 +58,7 @@
   *       in
   * @name: Match name found by the auxiliary device driver,
   * @id: unique identitier if multiple devices of the same name are exported,
+ * @irqs: irqs xarray contains irq indices which are used by the device,
   *
   * An auxiliary_device represents a part of its parent device's functionality.
   * It is given a name that, combined with the registering drivers
Quoted 8 lines

include/linux/auxiliary_bus.h line 143

Quoted 6 lines
include/linux/auxiliary_bus.h +2 -0
@@ -138,7 +139,10 @@
  struct auxiliary_device {
       struct device dev;
       const char *name;
+     struct xarray irqs;
+     struct mutex lock; /* Protects "irqs" directory creation */

Protects it from what?

please look the answer above

Quoted 6 lines

include/linux/auxiliary_bus.h line 145

Quoted 4 lines
include/linux/auxiliary_bus.h +1 -0
       u32 id;
+     u8 dir_exists:1;

I don't think this is needed, but if it really is, just use a bool.

If you know of an API that query whether a specific group is exists on some device, can you please share it with me?
I came out empty when I looked for one :(

Quoted 19 lines

include/linux/auxiliary_bus.h int auxiliary_device_init(struct auxiliary_device *auxdev); · line 222

Quoted 13 lines
include/linux/auxiliary_bus.h +4 -0
  };
 
  /**
@@ -212,8 +216,24 @@ int auxiliary_device_init(struct auxiliary_device *auxdev);
  int __auxiliary_device_add(struct auxiliary_device *auxdev, const char *modname);
  #define auxiliary_device_add(auxdev) __auxiliary_device_add(auxdev, KBUILD_MODNAME)
 
+#ifdef CONFIG_SYSFS
+int auxiliary_device_sysfs_irq_add(struct auxiliary_device *auxdev, int irq);
+void auxiliary_device_sysfs_irq_remove(struct auxiliary_device *auxdev,
+                                    int irq);

You can use longer lines :)

thanks,

greg k-h

maintainer
#6 lore raw

Re: [PATCH net-next v7 1/2] driver core: auxiliary bus: show auxiliary device IRQs

Quoted 44 lines · Shay Drori
Quoted 41 lines · Greg KH

External email: Use caution opening links or attachments

Quoted 24 lines · Shay Drory
drivers/base/auxiliary_sysfs.c new file +18 -0
new file mode 100644
index 000000000000..3f112fd26e72
@@ -0,0 +1,110 @@
+// SPDX-License-Identifier: GPL-2.0
+/*
+ * Copyright (c) 2024, NVIDIA CORPORATION & AFFILIATES
+ */
+
+#include <linux/auxiliary_bus.h>
+#include <linux/slab.h>
+
+struct auxiliary_irq_info {
+     struct device_attribute sysfs_attr;
+};
+
+static struct attribute *auxiliary_irq_attrs[] = {
+     NULL
+};
+
+static const struct attribute_group auxiliary_irqs_group = {
+     .name = "irqs",

drivers/base/auxiliary_sysfs.c line 28

Quoted 10 lines
drivers/base/auxiliary_sysfs.c new file +10 -0
+     .attrs = auxiliary_irq_attrs,
+};
+
+static int auxiliary_irq_dir_prepare(struct auxiliary_device *auxdev)
+{
+     int ret = 0;
+
+     mutex_lock(&auxdev->lock);
+     if (auxdev->dir_exists)
+             goto unlock;

You do know about cleanup.h, right? Please use it.

Quoted 7 lines
Quoted 3 lines

But what exactly are you trying to protect here? How will you race and add two irqs at the same time? Driver probe is always single threaded, so what would be calling this at the same time from multiple places?

mlx5 driver requests IRQs on demand for PCI PF, VF, SFs. And it occurs from multiple threads, hence we need to protect it.

How are irqs asked for, for the same device, from multiple threads? What threads exactly? What is causing these irqs to be asked for?

But ok, that's fine, if you want to do this, then properly protect the allocation, don't just half-protect it like you did here :(

Quoted 47 lines
Quoted 37 lines
Quoted 37 lines
drivers/base/auxiliary_sysfs.c new file +37 -0
+
+     xa_init(&auxdev->irqs);
+     ret = devm_device_add_group(&auxdev->dev, &auxiliary_irqs_group);
+     if (!ret)
+             auxdev->dir_exists = 1;
+
+unlock:
+     mutex_unlock(&auxdev->lock);
+     return ret;
+}
+
+/**
+ * auxiliary_device_sysfs_irq_add - add a sysfs entry for the given IRQ
+ * @auxdev: auxiliary bus device to add the sysfs entry.
+ * @irq: The associated interrupt number.
+ *
+ * This function should be called after auxiliary device have successfully
+ * received the irq.
+ *
+ * Return: zero on success or an error code on failure.
+ */
+int auxiliary_device_sysfs_irq_add(struct auxiliary_device *auxdev, int irq)
+{
+     struct device *dev = &auxdev->dev;
+     struct auxiliary_irq_info *info;
+     int ret;
+
+     ret = auxiliary_irq_dir_prepare(auxdev);
+     if (ret)
+             return ret;
+
+     info = kzalloc(sizeof(*info), GFP_KERNEL);
+     if (!info)
+             return -ENOMEM;
+
+     sysfs_attr_init(&info->sysfs_attr.attr);
+     info->sysfs_attr.attr.name = kasprintf(GFP_KERNEL, "%d", irq);
Quoted 8 lines

drivers/base/auxiliary_sysfs.c line 71

Quoted 6 lines
drivers/base/auxiliary_sysfs.c new file +6 -0
+     if (!info->sysfs_attr.attr.name) {
+             ret = -ENOMEM;
+             goto name_err;
+     }
+
+     ret = xa_insert(&auxdev->irqs, irq, info, GFP_KERNEL);

So no lock happening here, either use it always, or not at all?

Quoted 4 lines

the lock is only needed to protect the group (directory) creation, which will be used by all the IRQs of this auxdev.
parallel calls to this API will always be with different IRQs, which means each IRQ have a unique index.

You are inserting into the sysfs group at the same time? You are calling xa_insert() at the same time? Is that protected with some internal lock? If so, this needs to be documented a bunch here.

Allocating irqs is NOT a fast path, just grab a lock and do it right please, don't make us constantly have to stare at the code to ensure it is correct.

Quoted 6 lines
Quoted 6 lines
Quoted 5 lines
drivers/base/auxiliary_sysfs.c new file +5 -0
+     if (ret)
+             goto auxdev_xa_err;
+
+     ret = sysfs_add_file_to_group(&dev->kobj, &info->sysfs_attr.attr,
+                                   auxiliary_irqs_group.name);
Quoted 7 lines
Quoted 5 lines

You do know that you are never going to see these files from the userspace library tools that watch sysfs, right? libudev will never see them as you are adding them AFTER the device is created.

So, because of that, who is really going to use these files?

To learn about the interrupt mapping of the SF IRQs.

Who is going to "learn"? Again, you are creating files that our userspace tools will miss, so what userspace tools are going to be able to learn anything here?

This is strongly implying that all of this is just a debugging aid. So please, put this in debugfs where that type of thing belongs.

Quoted 58 lines
Quoted 49 lines

drivers/base/auxiliary_sysfs.c line 87

Quoted 11 lines
drivers/base/auxiliary_sysfs.c new file +11 -0
+     if (ret)
+             goto sysfs_add_err;
+
+     return 0;
+
+sysfs_add_err:
+     xa_erase(&auxdev->irqs, irq);
+auxdev_xa_err:
+     kfree(info->sysfs_attr.attr.name);
+name_err:
+     kfree(info);

Again, cleanup.h is your friend.

Quoted 35 lines
drivers/base/auxiliary_sysfs.c new file +23 -0
+     return ret;
+}
+EXPORT_SYMBOL_GPL(auxiliary_device_sysfs_irq_add);
+
+/**
+ * auxiliary_device_sysfs_irq_remove - remove a sysfs entry for the given IRQ
+ * @auxdev: auxiliary bus device to add the sysfs entry.
+ * @irq: the IRQ to remove.
+ *
+ * This function should be called to remove an IRQ sysfs entry.
+ */
+void auxiliary_device_sysfs_irq_remove(struct auxiliary_device *auxdev, int irq)
+{
+     struct auxiliary_irq_info *info = xa_load(&auxdev->irqs, irq);
+     struct device *dev = &auxdev->dev;
+
+     sysfs_remove_file_from_group(&dev->kobj, &info->sysfs_attr.attr,
+                                  auxiliary_irqs_group.name);
+     xa_erase(&auxdev->irqs, irq);
+     kfree(info->sysfs_attr.attr.name);
+     kfree(info);
+}
+EXPORT_SYMBOL_GPL(auxiliary_device_sysfs_irq_remove);
include/linux/auxiliary_bus.h +1 -0
index de21d9d24a95..96be140bd1ff 100644
@@ -58,6 +58,7 @@
   *       in
   * @name: Match name found by the auxiliary device driver,
   * @id: unique identitier if multiple devices of the same name are exported,
+ * @irqs: irqs xarray contains irq indices which are used by the device,
   *
   * An auxiliary_device represents a part of its parent device's functionality.
   * It is given a name that, combined with the registering drivers
Quoted 8 lines

include/linux/auxiliary_bus.h line 143

Quoted 6 lines
include/linux/auxiliary_bus.h +2 -0
@@ -138,7 +139,10 @@
  struct auxiliary_device {
       struct device dev;
       const char *name;
+     struct xarray irqs;
+     struct mutex lock; /* Protects "irqs" directory creation */

Protects it from what?

Quoted 1 line

please look the answer above

You need to document it here. Or somewhere. Don't rely on an email thread from 10 years ago for when you look at this in 10 years and wonder what is going on...

Quoted 9 lines
Quoted 4 lines

include/linux/auxiliary_bus.h line 145

Quoted 2 lines
include/linux/auxiliary_bus.h +1 -0
       u32 id;
+     u8 dir_exists:1;

I don't think this is needed, but if it really is, just use a bool.

If you know of an API that query whether a specific group is exists on some device, can you please share it with me?
I came out empty when I looked for one :(

Normally sysfs groups are NOT created this way at all. Oh wait, they can be now, why not use the new feature where a group is created by the core but only exposed if an attribute is added there?

Will that work here? See commit d87c295f599c ("sysfs: Introduce a mechanism to hide static attribute_groups") for details. That should solve the issue of trying to figure out if the directory is present or not logic.

thanks,

greg k-h

author
#7 lore raw

Re: [PATCH net-next v7 1/2] driver core: auxiliary bus: show auxiliary device IRQs

Quoted 53 lines · Greg KH

External email: Use caution opening links or attachments

Quoted 49 lines · Shay Drori
Quoted 44 lines · Greg KH

External email: Use caution opening links or attachments

Quoted 24 lines · Shay Drory
drivers/base/auxiliary_sysfs.c new file +18 -0
new file mode 100644
index 000000000000..3f112fd26e72
@@ -0,0 +1,110 @@
+// SPDX-License-Identifier: GPL-2.0
+/*
+ * Copyright (c) 2024, NVIDIA CORPORATION & AFFILIATES
+ */
+
+#include <linux/auxiliary_bus.h>
+#include <linux/slab.h>
+
+struct auxiliary_irq_info {
+     struct device_attribute sysfs_attr;
+};
+
+static struct attribute *auxiliary_irq_attrs[] = {
+     NULL
+};
+
+static const struct attribute_group auxiliary_irqs_group = {
+     .name = "irqs",

drivers/base/auxiliary_sysfs.c line 28

Quoted 10 lines
drivers/base/auxiliary_sysfs.c new file +10 -0
+     .attrs = auxiliary_irq_attrs,
+};
+
+static int auxiliary_irq_dir_prepare(struct auxiliary_device *auxdev)
+{
+     int ret = 0;
+
+     mutex_lock(&auxdev->lock);
+     if (auxdev->dir_exists)
+             goto unlock;

You do know about cleanup.h, right? Please use it.

But what exactly are you trying to protect here? How will you race and add two irqs at the same time? Driver probe is always single threaded, so what would be calling this at the same time from multiple places?

Quoted 8 lines
Quoted 2 lines

mlx5 driver requests IRQs on demand for PCI PF, VF, SFs. And it occurs from multiple threads, hence we need to protect it.

How are irqs asked for, for the same device, from multiple threads? What threads exactly? What is causing these irqs to be asked for?

But ok, that's fine, if you want to do this, then properly protect the allocation, don't just half-protect it like you did here :(

Thanks for the comment, will protect all the allocations

Quoted 53 lines
Quoted 48 lines
Quoted 38 lines
Quoted 38 lines
drivers/base/auxiliary_sysfs.c new file +37 -0
+
+     xa_init(&auxdev->irqs);
+     ret = devm_device_add_group(&auxdev->dev, &auxiliary_irqs_group);
+     if (!ret)
+             auxdev->dir_exists = 1;
+
+unlock:
+     mutex_unlock(&auxdev->lock);
+     return ret;
+}
+
+/**
+ * auxiliary_device_sysfs_irq_add - add a sysfs entry for the given IRQ
+ * @auxdev: auxiliary bus device to add the sysfs entry.
+ * @irq: The associated interrupt number.
+ *
+ * This function should be called after auxiliary device have successfully
+ * received the irq.
+ *
+ * Return: zero on success or an error code on failure.
+ */
+int auxiliary_device_sysfs_irq_add(struct auxiliary_device *auxdev, int irq)
+{
+     struct device *dev = &auxdev->dev;
+     struct auxiliary_irq_info *info;
+     int ret;
+
+     ret = auxiliary_irq_dir_prepare(auxdev);
+     if (ret)
+             return ret;
+
+     info = kzalloc(sizeof(*info), GFP_KERNEL);
+     if (!info)
+             return -ENOMEM;
+
+     sysfs_attr_init(&info->sysfs_attr.attr);
+     info->sysfs_attr.attr.name = kasprintf(GFP_KERNEL, "%d", irq);
Quoted 8 lines

drivers/base/auxiliary_sysfs.c line 71

Quoted 6 lines
drivers/base/auxiliary_sysfs.c new file +6 -0
+     if (!info->sysfs_attr.attr.name) {
+             ret = -ENOMEM;
+             goto name_err;
+     }
+
+     ret = xa_insert(&auxdev->irqs, irq, info, GFP_KERNEL);

So no lock happening here, either use it always, or not at all?

Quoted 4 lines

the lock is only needed to protect the group (directory) creation, which will be used by all the IRQs of this auxdev.
parallel calls to this API will always be with different IRQs, which means each IRQ have a unique index.

Quoted 7 lines

You are inserting into the sysfs group at the same time? You are calling xa_insert() at the same time? Is that protected with some internal lock? If so, this needs to be documented a bunch here.

Allocating irqs is NOT a fast path, just grab a lock and do it right please, don't make us constantly have to stare at the code to ensure it is correct.

like I said above, I will protect all the allocations

Quoted 13 lines
Quoted 13 lines
Quoted 12 lines

drivers/base/auxiliary_sysfs.c line 76

Quoted 6 lines
drivers/base/auxiliary_sysfs.c new file +5 -0
+     if (ret)
+             goto auxdev_xa_err;
+
+     ret = sysfs_add_file_to_group(&dev->kobj, &info->sysfs_attr.attr,
+                                   auxiliary_irqs_group.name);

You do know that you are never going to see these files from the userspace library tools that watch sysfs, right? libudev will never see them as you are adding them AFTER the device is created.

So, because of that, who is really going to use these files?

Quoted 8 lines
Quoted 1 line

To learn about the interrupt mapping of the SF IRQs.

Who is going to "learn"? Again, you are creating files that our userspace tools will miss, so what userspace tools are going to be able to learn anything here?

This is strongly implying that all of this is just a debugging aid. So please, put this in debugfs where that type of thing belongs.

It is certainly a debugging aid as I described in the commit log. But it is one of the purpose.
The motivation was clear but probably I should have better written. The irq affinity setting code [1] needs to read the irqs number of the device.
Tools like irqbalance [1] are using the sysfs.
And one should be able to do the same for the PCI SF too. They cannot rely on the debugfs.

[1] https://github.com/Irqbalance/irqbalance/blob/ba44a683cdfaa688e89e0d887952032766fb89aa/classify.c#L631

Quoted 59 lines
Quoted 59 lines
Quoted 58 lines

drivers/base/auxiliary_sysfs.c line 87

Quoted 12 lines
drivers/base/auxiliary_sysfs.c new file +11 -0
+     if (ret)
+             goto sysfs_add_err;
+
+     return 0;
+
+sysfs_add_err:
+     xa_erase(&auxdev->irqs, irq);
+auxdev_xa_err:
+     kfree(info->sysfs_attr.attr.name);
+name_err:
+     kfree(info);

Again, cleanup.h is your friend.

Quoted 36 lines
drivers/base/auxiliary_sysfs.c new file +23 -0
+     return ret;
+}
+EXPORT_SYMBOL_GPL(auxiliary_device_sysfs_irq_add);
+
+/**
+ * auxiliary_device_sysfs_irq_remove - remove a sysfs entry for the given IRQ
+ * @auxdev: auxiliary bus device to add the sysfs entry.
+ * @irq: the IRQ to remove.
+ *
+ * This function should be called to remove an IRQ sysfs entry.
+ */
+void auxiliary_device_sysfs_irq_remove(struct auxiliary_device *auxdev, int irq)
+{
+     struct auxiliary_irq_info *info = xa_load(&auxdev->irqs, irq);
+     struct device *dev = &auxdev->dev;
+
+     sysfs_remove_file_from_group(&dev->kobj, &info->sysfs_attr.attr,
+                                  auxiliary_irqs_group.name);
+     xa_erase(&auxdev->irqs, irq);
+     kfree(info->sysfs_attr.attr.name);
+     kfree(info);
+}
+EXPORT_SYMBOL_GPL(auxiliary_device_sysfs_irq_remove);
include/linux/auxiliary_bus.h +1 -0
index de21d9d24a95..96be140bd1ff 100644
@@ -58,6 +58,7 @@
    *       in
    * @name: Match name found by the auxiliary device driver,
    * @id: unique identitier if multiple devices of the same name are exported,
+ * @irqs: irqs xarray contains irq indices which are used by the device,
    *
    * An auxiliary_device represents a part of its parent device's functionality.
    * It is given a name that, combined with the registering drivers

include/linux/auxiliary_bus.h line 143

Quoted 5 lines
include/linux/auxiliary_bus.h +2 -0
@@ -138,7 +139,10 @@
   struct auxiliary_device {
        struct device dev;
        const char *name;
+     struct xarray irqs;
+     struct mutex lock; /* Protects "irqs" directory creation */

Protects it from what?

Quoted 5 lines
Quoted 1 line

please look the answer above

You need to document it here. Or somewhere. Don't rely on an email thread from 10 years ago for when you look at this in 10 years and wonder what is going on...

Thanks, I will document it better in next version

Quoted 11 lines
Quoted 10 lines
Quoted 5 lines

include/linux/auxiliary_bus.h line 145

Quoted 3 lines
include/linux/auxiliary_bus.h +1 -0
        u32 id;
+     u8 dir_exists:1;

I don't think this is needed, but if it really is, just use a bool.

If you know of an API that query whether a specific group is exists on some device, can you please share it with me?
I came out empty when I looked for one :(

Quoted 8 lines

Normally sysfs groups are NOT created this way at all. Oh wait, they can be now, why not use the new feature where a group is created by the core but only exposed if an attribute is added there?

Will that work here? See commit d87c295f599c ("sysfs: Introduce a mechanism to hide static attribute_groups") for details. That should solve the issue of trying to figure out if the directory is present or not logic.

thank for the suggestion:)
will give it a shoot

Quoted 4 lines

thanks,

greg k-h

author
#8 lore raw

Re: [PATCH net-next v7 1/2] driver core: auxiliary bus: show auxiliary device IRQs

Hi Greg

Quoted 14 lines · Shay Drori
Quoted 14 lines
Quoted 9 lines
Quoted 4 lines
Quoted 2 lines

        u32 id;
+     u8 dir_exists:1;

I don't think this is needed, but if it really is, just use a bool.

If you know of an API that query whether a specific group is exists on some device, can you please share it with me?
I came out empty when I looked for one 🙁

Normally sysfs groups are NOT created this way at all.  Oh wait, they can be now, why not use the new feature where a group is created by the core but only exposed if an attribute is added there?

Quoted 8 lines
Quoted 4 lines

Will that work here?  See commit d87c295f599c ("sysfs: Introduce a mechanism to hide static attribute_groups") for details.  That should solve the issue of trying to figure out if the directory is present or not logic.

thank for the suggestion:)
will give it a shoot

I tried using the commit you mentioned.
the commit introduce is_visible callback, which being called when a group is added to the system.

Hence, auxiliary driver needs to know early when using the static group. To know if to use this static group, the mlx5 driver needs to pass the flag. But the whole point was to avoid passing that flag.

Do you suggest passing the flag in __auxiliary_device_add() and use it to is_visible trick?

thanks

reviewer
#9 lore raw

Re: [PATCH net-next v7 1/2] driver core: auxiliary bus: show auxiliary device IRQs

In reply to Shay Drory
Quoted 19 lines · Shay Drory

PCI subfunctions (SF) are anchored on the auxiliary bus. PCI physical and virtual functions are anchored on the PCI bus. The irq information of each such function is visible to users via sysfs directory "msi_irqs" containing files for each irq entry. However, for PCI SFs such information is unavailable. Due to this users have no visibility on IRQs used by the SFs.
Secondly, an SF can be multi function device supporting rdma, netdevice and more. Without irq information at the bus level, the user is unable to view or use the affinity of the SF IRQs.

Hence to match to the equivalent PCI PFs and VFs, add "irqs" directory, for supporting auxiliary devices, containing file for each irq entry.

For example:

$ ls /sys/bus/auxiliary/devices/mlx5_core.sf.1/irqs/
50  51  52  53  54  55  56  57  58

...

include/linux/auxiliary_bus.h line 61

Quoted 7 lines
include/linux/auxiliary_bus.h +1 -0
@@ -58,6 +58,7 @@
  *       in
  * @name: Match name found by the auxiliary device driver,
  * @id: unique identitier if multiple devices of the same name are exported,
+ * @irqs: irqs xarray contains irq indices which are used by the device,

Hi Shay,

A minor nit from my side: please also add entries for @lock and @dir_exists.

Flagged by kernel-doc -none

Quoted 14 lines
include/linux/auxiliary_bus.h +3 -0
  *
  * An auxiliary_device represents a part of its parent device's functionality.
  * It is given a name that, combined with the registering drivers
@@ -138,7 +139,10 @@
 struct auxiliary_device {
 	struct device dev;
 	const char *name;
+	struct xarray irqs;
+	struct mutex lock; /* Protects "irqs" directory creation */
 	u32 id;
+	u8 dir_exists:1;
 };
 
 /**

...

author
#10 lore raw

PATCH v7 2/2 net/mlx5: Expose SFs IRQs

In reply to Shay Drory

Expose the sysfs files for the IRQs that the mlx5 PCI SFs are using. These entries are similar to PCI PFs and VFs in 'msi_irqs' directory.

---
v6->v7:
- remove not needed changes to mlx5 sfnum SF sysfs v5->v6:
- fail IRQ creation in case auxiliary_device_sysfs_irq_add() failed (Parav and Przemek)
v2->v3:
- fix mlx5 sfnum SF sysfs

---
 drivers/net/ethernet/mellanox/mlx5/core/eq.c   |  6 +++---
 .../ethernet/mellanox/mlx5/core/irq_affinity.c | 18 +++++++++++++++++-
 .../ethernet/mellanox/mlx5/core/mlx5_core.h    |  6 ++++++
 .../net/ethernet/mellanox/mlx5/core/mlx5_irq.h | 12 ++++++++----
 .../net/ethernet/mellanox/mlx5/core/pci_irq.c  | 12 +++++++++---
 5 files changed, 43 insertions(+), 11 deletions(-)
drivers/net/ethernet/mellanox/mlx5/core/eq.c +3 -3
index 5693986ae656..5661f047702e 100644
@@ -714,7 +714,7 @@ static int create_async_eqs(struct mlx5_core_dev *dev)
 err1:
 	mlx5_cmd_allowed_opcode(dev, CMD_ALLOWED_OPCODE_ALL);
 	mlx5_eq_notifier_unregister(dev, &table->cq_err_nb);
-	mlx5_ctrl_irq_release(table->ctrl_irq);
+	mlx5_ctrl_irq_release(dev, table->ctrl_irq);
 	return err;
 }
 
@@ -730,7 +730,7 @@ static void destroy_async_eqs(struct mlx5_core_dev *dev)
 	cleanup_async_eq(dev, &table->cmd_eq, "cmd");
 	mlx5_cmd_allowed_opcode(dev, CMD_ALLOWED_OPCODE_ALL);
 	mlx5_eq_notifier_unregister(dev, &table->cq_err_nb);
-	mlx5_ctrl_irq_release(table->ctrl_irq);
+	mlx5_ctrl_irq_release(dev, table->ctrl_irq);
 }
 
 struct mlx5_eq *mlx5_get_async_eq(struct mlx5_core_dev *dev)
@@ -918,7 +918,7 @@ static int comp_irq_request_sf(struct mlx5_core_dev *dev, u16 vecidx)
 	af_desc.is_managed = 1;
 	cpumask_copy(&af_desc.mask, cpu_online_mask);
 	cpumask_andnot(&af_desc.mask, &af_desc.mask, &table->used_cpus);
-	irq = mlx5_irq_affinity_request(pool, &af_desc);
+	irq = mlx5_irq_affinity_request(dev, pool, &af_desc);
 	if (IS_ERR(irq))
 		return PTR_ERR(irq);
 
drivers/net/ethernet/mellanox/mlx5/core/irq_affinity.c +17 -1
index 612e666ec263..f7b01b3f0cba 100644
@@ -112,15 +112,18 @@ irq_pool_find_least_loaded(struct mlx5_irq_pool *pool, const struct cpumask *req
 
 /**
  * mlx5_irq_affinity_request - request an IRQ according to the given mask.
+ * @dev: mlx5 core device which is requesting the IRQ.
  * @pool: IRQ pool to request from.
  * @af_desc: affinity descriptor for this IRQ.
  *
  * This function returns a pointer to IRQ, or ERR_PTR in case of error.
  */
 struct mlx5_irq *
-mlx5_irq_affinity_request(struct mlx5_irq_pool *pool, struct irq_affinity_desc *af_desc)
+mlx5_irq_affinity_request(struct mlx5_core_dev *dev, struct mlx5_irq_pool *pool,
+			  struct irq_affinity_desc *af_desc)
 {
 	struct mlx5_irq *least_loaded_irq, *new_irq;
+	int ret;
 
 	mutex_lock(&pool->lock);
 	least_loaded_irq = irq_pool_find_least_loaded(pool, &af_desc->mask);
@@ -153,6 +156,16 @@ mlx5_irq_affinity_request(struct mlx5_irq_pool *pool, struct irq_affinity_desc *
 			      mlx5_irq_read_locked(least_loaded_irq) / MLX5_EQ_REFS_PER_IRQ);
 unlock:
 	mutex_unlock(&pool->lock);
+	if (mlx5_irq_pool_is_sf_pool(pool)) {
+		ret = auxiliary_device_sysfs_irq_add(mlx5_sf_coredev_to_adev(dev),
+						     mlx5_irq_get_irq(least_loaded_irq));
+		if (ret) {
+			mlx5_core_err(dev, "Failed to create sysfs entry for irq %d, ret = %d\n",
+				      mlx5_irq_get_irq(least_loaded_irq), ret);
+			mlx5_irq_put(least_loaded_irq);
+			least_loaded_irq = ERR_PTR(ret);
+		}
+	}
 	return least_loaded_irq;
 }
 
@@ -164,6 +177,9 @@ void mlx5_irq_affinity_irq_release(struct mlx5_core_dev *dev, struct mlx5_irq *i
 	cpu = cpumask_first(mlx5_irq_get_affinity_mask(irq));
 	synchronize_irq(pci_irq_vector(pool->dev->pdev,
 				       mlx5_irq_get_index(irq)));
+	if (mlx5_irq_pool_is_sf_pool(pool))
+		auxiliary_device_sysfs_irq_remove(mlx5_sf_coredev_to_adev(dev),
+						  mlx5_irq_get_irq(irq));
 	if (mlx5_irq_put(irq))
 		if (pool->irqs_per_cpu)
 			cpu_put(pool, cpu);
drivers/net/ethernet/mellanox/mlx5/core/mlx5_core.h +6 -0
index c38342b9f320..e764b720d9b2 100644
@@ -320,6 +320,12 @@ static inline bool mlx5_core_is_sf(const struct mlx5_core_dev *dev)
 	return dev->coredev_type == MLX5_COREDEV_SF;
 }
 
+static inline struct auxiliary_device *
+mlx5_sf_coredev_to_adev(struct mlx5_core_dev *mdev)
+{
+	return container_of(mdev->device, struct auxiliary_device, dev);
+}
+
 int mlx5_mdev_init(struct mlx5_core_dev *dev, int profile_idx);
 void mlx5_mdev_uninit(struct mlx5_core_dev *dev);
 int mlx5_init_one(struct mlx5_core_dev *dev);
drivers/net/ethernet/mellanox/mlx5/core/mlx5_irq.h +8 -4
index 1088114e905d..0881e961d8b1 100644
@@ -25,7 +25,7 @@ int mlx5_set_msix_vec_count(struct mlx5_core_dev *dev, int devfn,
 int mlx5_get_default_msix_vec_count(struct mlx5_core_dev *dev, int num_vfs);
 
 struct mlx5_irq *mlx5_ctrl_irq_request(struct mlx5_core_dev *dev);
-void mlx5_ctrl_irq_release(struct mlx5_irq *ctrl_irq);
+void mlx5_ctrl_irq_release(struct mlx5_core_dev *dev, struct mlx5_irq *ctrl_irq);
 struct mlx5_irq *mlx5_irq_request(struct mlx5_core_dev *dev, u16 vecidx,
 				  struct irq_affinity_desc *af_desc,
 				  struct cpu_rmap **rmap);
@@ -36,13 +36,15 @@ int mlx5_irq_attach_nb(struct mlx5_irq *irq, struct notifier_block *nb);
 int mlx5_irq_detach_nb(struct mlx5_irq *irq, struct notifier_block *nb);
 struct cpumask *mlx5_irq_get_affinity_mask(struct mlx5_irq *irq);
 int mlx5_irq_get_index(struct mlx5_irq *irq);
+int mlx5_irq_get_irq(const struct mlx5_irq *irq);
 
 struct mlx5_irq_pool;
 #ifdef CONFIG_MLX5_SF
 struct mlx5_irq *mlx5_irq_affinity_irq_request_auto(struct mlx5_core_dev *dev,
 						    struct cpumask *used_cpus, u16 vecidx);
-struct mlx5_irq *mlx5_irq_affinity_request(struct mlx5_irq_pool *pool,
-					   struct irq_affinity_desc *af_desc);
+struct mlx5_irq *
+mlx5_irq_affinity_request(struct mlx5_core_dev *dev, struct mlx5_irq_pool *pool,
+			  struct irq_affinity_desc *af_desc);
 void mlx5_irq_affinity_irq_release(struct mlx5_core_dev *dev, struct mlx5_irq *irq);
 #else
 static inline
@@ -53,7 +55,8 @@ struct mlx5_irq *mlx5_irq_affinity_irq_request_auto(struct mlx5_core_dev *dev,
 }
 
 static inline struct mlx5_irq *
-mlx5_irq_affinity_request(struct mlx5_irq_pool *pool, struct irq_affinity_desc *af_desc)
+mlx5_irq_affinity_request(struct mlx5_core_dev *dev, struct mlx5_irq_pool *pool,
+			  struct irq_affinity_desc *af_desc)
 {
 	return ERR_PTR(-EOPNOTSUPP);
 }
@@ -61,6 +64,7 @@ mlx5_irq_affinity_request(struct mlx5_irq_pool *pool, struct irq_affinity_desc *
 static inline
 void mlx5_irq_affinity_irq_release(struct mlx5_core_dev *dev, struct mlx5_irq *irq)
 {
+	mlx5_irq_release_vector(irq);
 }
 #endif
 #endif /* __MLX5_IRQ_H__ */
drivers/net/ethernet/mellanox/mlx5/core/pci_irq.c +9 -3
index fb8787e30d3f..ac7c3a76b4cf 100644
@@ -367,6 +367,11 @@ struct cpumask *mlx5_irq_get_affinity_mask(struct mlx5_irq *irq)
 	return irq->mask;
 }
 
+int mlx5_irq_get_irq(const struct mlx5_irq *irq)
+{
+	return irq->map.virq;
+}
+
 int mlx5_irq_get_index(struct mlx5_irq *irq)
 {
 	return irq->map.index;
@@ -440,11 +445,12 @@ static void _mlx5_irq_release(struct mlx5_irq *irq)
 
 /**
  * mlx5_ctrl_irq_release - release a ctrl IRQ back to the system.
+ * @dev: mlx5 device that releasing the IRQ.
  * @ctrl_irq: ctrl IRQ to be released.
  */
-void mlx5_ctrl_irq_release(struct mlx5_irq *ctrl_irq)
+void mlx5_ctrl_irq_release(struct mlx5_core_dev *dev, struct mlx5_irq *ctrl_irq)
 {
-	_mlx5_irq_release(ctrl_irq);
+	mlx5_irq_affinity_irq_release(dev, ctrl_irq);
 }
 
 /**
@@ -473,7 +479,7 @@ struct mlx5_irq *mlx5_ctrl_irq_request(struct mlx5_core_dev *dev)
 		/* Allocate the IRQ in index 0. The vector was already allocated */
 		irq = irq_pool_request_vector(pool, 0, &af_desc, NULL);
 	} else {
-		irq = mlx5_irq_affinity_request(pool, &af_desc);
+		irq = mlx5_irq_affinity_request(dev, pool, &af_desc);
 	}
 
 	return irq;
Signature · 1 line
2.38.1