Skip to contentSkip to conversation

libnvdimm: Don't use "proxy" headers

PATCH In review Andy Shevchenko 3 participants 3 messages Jun 26, 2025 libnvdimm: non-volatile memory device

lore
Share & tools
lore
#0 lore raw

PATCH 1/1 libnvdimm: Don't use "proxy" headers

Update header inclusions to follow IWYU (Include What You Use) principle.

Note that kernel.h is discouraged to be included as it's written at the top of that file.

While doing that, sort headers alphabetically.

---
 include/linux/libnvdimm.h | 13 ++++++++-----
 1 file changed, 8 insertions(+), 5 deletions(-)
include/linux/libnvdimm.h +8 -5
index e772aae71843..dce8787fba53 100644
@@ -6,12 +6,12 @@
  */
 #ifndef __LIBNVDIMM_H__
 #define __LIBNVDIMM_H__
-#include <linux/kernel.h>
+
+#include <linux/ioport.h>
 #include <linux/sizes.h>
+#include <linux/spinlock.h>
 #include <linux/types.h>
 #include <linux/uuid.h>
-#include <linux/spinlock.h>
-#include <linux/bio.h>
 
 struct badrange_entry {
 	u64 start;
@@ -80,7 +80,9 @@ typedef int (*ndctl_fn)(struct nvdimm_bus_descriptor *nd_desc,
 		struct nvdimm *nvdimm, unsigned int cmd, void *buf,
 		unsigned int buf_len, int *cmd_rc);
 
+struct attribute_group;
 struct device_node;
+struct module;
 struct nvdimm_bus_descriptor {
 	const struct attribute_group **attr_groups;
 	unsigned long cmd_mask;
@@ -121,6 +123,7 @@ struct nd_mapping_desc {
 	int position;
 };
 
+struct bio;
 struct nd_region;
 struct nd_region_desc {
 	struct resource *res;
@@ -147,8 +150,6 @@ static inline void __iomem *devm_nvdimm_ioremap(struct device *dev,
 	return (void __iomem *) devm_nvdimm_memremap(dev, offset, size, 0);
 }
 
-struct nvdimm_bus;
-
 /*
  * Note that separate bits for locked + unlocked are defined so that
  * 'flags == 0' corresponds to an error / not-supported state.
@@ -238,6 +239,8 @@ struct nvdimm_fw_ops {
 	int (*arm)(struct nvdimm *nvdimm, enum nvdimm_fwa_trigger arg);
 };
 
+struct nvdimm_bus;
+
 void badrange_init(struct badrange *badrange);
 int badrange_add(struct badrange *badrange, u64 addr, u64 length);
 void badrange_forget(struct badrange *badrange, phys_addr_t start,
Signature · 1 line
2.47.2
#1 lore raw
Quoted 18 lines · Andy Shevchenko

Update header inclusions to follow IWYU (Include What You Use) principle.

Note that kernel.h is discouraged to be included as it's written at the top of that file.

While doing that, sort headers alphabetically.

---
 include/linux/libnvdimm.h | 13 ++++++++-----
 1 file changed, 8 insertions(+), 5 deletions(-)
include/linux/libnvdimm.h +0 -0
index e772aae71843..dce8787fba53 100644

include/linux/libnvdimm.h line 10

Quoted 6 lines
include/linux/libnvdimm.h +2 -1
@@ -6,12 +6,12 @@
  */
 #ifndef __LIBNVDIMM_H__
 #define __LIBNVDIMM_H__
-#include <linux/kernel.h>
+
+#include <linux/ioport.h>

If we are going in this direction why include ioport vs forward declaring struct resource?

include/linux/libnvdimm.h line 14

Quoted 6 lines
include/linux/libnvdimm.h +1 -2
 #include <linux/sizes.h>
+#include <linux/spinlock.h>
 #include <linux/types.h>
 #include <linux/uuid.h>
-#include <linux/spinlock.h>
-#include <linux/bio.h>

I'm leaning toward including bio, module, and sysfs rather than do the forward declarations.

Are forward declarations preferred these days?

Ira

Quoted 42 lines
include/linux/libnvdimm.h +5 -2
 struct badrange_entry {
 	u64 start;
@@ -80,7 +80,9 @@ typedef int (*ndctl_fn)(struct nvdimm_bus_descriptor *nd_desc,
 		struct nvdimm *nvdimm, unsigned int cmd, void *buf,
 		unsigned int buf_len, int *cmd_rc);
 
+struct attribute_group;
 struct device_node;
+struct module;
 struct nvdimm_bus_descriptor {
 	const struct attribute_group **attr_groups;
 	unsigned long cmd_mask;
@@ -121,6 +123,7 @@ struct nd_mapping_desc {
 	int position;
 };
 
+struct bio;
 struct nd_region;
 struct nd_region_desc {
 	struct resource *res;
@@ -147,8 +150,6 @@ static inline void __iomem *devm_nvdimm_ioremap(struct device *dev,
 	return (void __iomem *) devm_nvdimm_memremap(dev, offset, size, 0);
 }
 
-struct nvdimm_bus;
-
 /*
  * Note that separate bits for locked + unlocked are defined so that
  * 'flags == 0' corresponds to an error / not-supported state.
@@ -238,6 +239,8 @@ struct nvdimm_fw_ops {
 	int (*arm)(struct nvdimm *nvdimm, enum nvdimm_fwa_trigger arg);
 };
 
+struct nvdimm_bus;
+
 void badrange_init(struct badrange *badrange);
 int badrange_add(struct badrange *badrange, u64 addr, u64 length);
 void badrange_forget(struct badrange *badrange, phys_addr_t start,
Signature · 1 line
2.47.2
#2 lore raw

Thu, Jun 26, 2025 at 04:39:07PM -0500, Ira Weiny kirjoitti:

Quoted 1 line

Andy Shevchenko wrote:

...

Quoted 4 lines
Quoted 1 line

+#include <linux/ioport.h>

If we are going in this direction why include ioport vs forward declaring struct resource?

I don't know where I looked when added this. This should be io.h. And yes, we need forward declarations for struct resource and struct kobject.

...

Quoted 5 lines

include/linux/libnvdimm.h line 14

Quoted 2 lines
include/linux/libnvdimm.h +0 -2
-#include <linux/spinlock.h>
-#include <linux/bio.h>

I'm leaning toward including bio, module, and sysfs rather than do the forward declarations.

Header already uses forward declarations.

Quoted 1 line

Are forward declarations preferred these days?

Always with the dependency hell we have. For example, if we go your way we would need to include of.h which is yet another monsteur. I prefer to use this patch as provided.

Signature · 2 lines
With Best Regards,
Andy Shevchenko