2024-01-25 19:38:48

by Breno Leitao

[permalink] [raw]
Subject: [PATCH net 00/10] Fix MODULE_DESCRIPTION() for net (p3)

There are hundreds of network modules that misses MODULE_DESCRIPTION(),
causing a warning when compiling with W=1. Example:

WARNING: modpost: missing MODULE_DESCRIPTION() in drivers/net/arcnet/com90io.o
WARNING: modpost: missing MODULE_DESCRIPTION() in drivers/net/arcnet/arc-rimi.o
WARNING: modpost: missing MODULE_DESCRIPTION() in drivers/net/arcnet/com20020.o

This part3 of the patchset focus on the missing ethernet drivers, which
is now warning free. This also fixes net/pcs and ieee802154.

Breno Leitao (10):
net: fill in MODULE_DESCRIPTION()s for encx24j600
net: fill in MODULE_DESCRIPTION()s for ocelot
net: fill in MODULE_DESCRIPTION()s for SMSC drivers
net: fill in MODULE_DESCRIPTION()s for Qualcom drivers
net: fill in MODULE_DESCRIPTION()s for dwmac-socfpga
net: fill in MODULE_DESCRIPTION()s for cpsw-common
net: fill in MODULE_DESCRIPTION()s for ec_bhf
net: fill in MODULE_DESCRIPTION()s for PCS drivers
net: fill in MODULE_DESCRIPTION()s for ieee802154
net: fill in MODULE_DESCRIPTION()s for arcnet

drivers/net/arcnet/arcnet.c | 1 +
drivers/net/ethernet/ec_bhf.c | 1 +
drivers/net/ethernet/microchip/encx24j600-regmap.c | 1 +
drivers/net/ethernet/mscc/ocelot.c | 1 +
drivers/net/ethernet/qualcomm/emac/emac.c | 1 +
drivers/net/ethernet/qualcomm/rmnet/rmnet_config.c | 1 +
drivers/net/ethernet/smsc/smc91x.c | 1 +
drivers/net/ethernet/smsc/smsc911x.c | 1 +
drivers/net/ethernet/smsc/smsc9420.c | 1 +
drivers/net/ethernet/stmicro/stmmac/dwmac-socfpga.c | 1 +
drivers/net/ethernet/ti/cpsw-common.c | 1 +
drivers/net/pcs/pcs-lynx.c | 1 +
drivers/net/pcs/pcs-mtk-lynxi.c | 1 +
drivers/net/pcs/pcs-xpcs.c | 1 +
net/ieee802154/6lowpan/core.c | 1 +
net/ieee802154/socket.c | 1 +
16 files changed, 16 insertions(+)

--
2.39.3



2024-01-25 19:38:48

by Breno Leitao

[permalink] [raw]
Subject: [PATCH net 05/10] net: fill in MODULE_DESCRIPTION()s for dwmac-socfpga

W=1 builds now warn if module is built without a MODULE_DESCRIPTION().
Add descriptions to the STMicro DWMAC for Altera SOCs.

Signed-off-by: Breno Leitao <[email protected]>
---
drivers/net/ethernet/stmicro/stmmac/dwmac-socfpga.c | 1 +
1 file changed, 1 insertion(+)

diff --git a/drivers/net/ethernet/stmicro/stmmac/dwmac-socfpga.c b/drivers/net/ethernet/stmicro/stmmac/dwmac-socfpga.c
index ba2ce776bd4d..68f85e4605cb 100644
--- a/drivers/net/ethernet/stmicro/stmmac/dwmac-socfpga.c
+++ b/drivers/net/ethernet/stmicro/stmmac/dwmac-socfpga.c
@@ -585,4 +585,5 @@ static struct platform_driver socfpga_dwmac_driver = {
};
module_platform_driver(socfpga_dwmac_driver);

+MODULE_DESCRIPTION("Altera SOC DWMAC Specific Glue layer");
MODULE_LICENSE("GPL v2");
--
2.39.3


2024-01-25 19:39:08

by Breno Leitao

[permalink] [raw]
Subject: [PATCH net 01/10] net: fill in MODULE_DESCRIPTION()s for encx24j600

W=1 builds now warn if module is built without a MODULE_DESCRIPTION().
Add descriptions to the Microchip ENCX24J600 helpers driver.

Signed-off-by: Breno Leitao <[email protected]>
---
drivers/net/ethernet/microchip/encx24j600-regmap.c | 1 +
1 file changed, 1 insertion(+)

diff --git a/drivers/net/ethernet/microchip/encx24j600-regmap.c b/drivers/net/ethernet/microchip/encx24j600-regmap.c
index 5693784eec5b..2e0fe16a4082 100644
--- a/drivers/net/ethernet/microchip/encx24j600-regmap.c
+++ b/drivers/net/ethernet/microchip/encx24j600-regmap.c
@@ -513,4 +513,5 @@ int devm_regmap_init_encx24j600(struct device *dev,
}
EXPORT_SYMBOL_GPL(devm_regmap_init_encx24j600);

+MODULE_DESCRIPTION("Microchip ENCX24J600 helpers");
MODULE_LICENSE("GPL");
--
2.39.3


2024-01-25 19:39:10

by Breno Leitao

[permalink] [raw]
Subject: [PATCH net 06/10] net: fill in MODULE_DESCRIPTION()s for cpsw-common

W=1 builds now warn if module is built without a MODULE_DESCRIPTION().
Add descriptions to the TI CPSW switch module.

Signed-off-by: Breno Leitao <[email protected]>
Reviewed-by: Roger Quadros <[email protected]>
---
drivers/net/ethernet/ti/cpsw-common.c | 1 +
1 file changed, 1 insertion(+)

diff --git a/drivers/net/ethernet/ti/cpsw-common.c b/drivers/net/ethernet/ti/cpsw-common.c
index 26dc906eae90..57fe936bb177 100644
--- a/drivers/net/ethernet/ti/cpsw-common.c
+++ b/drivers/net/ethernet/ti/cpsw-common.c
@@ -90,4 +90,5 @@ int ti_cm_get_macid(struct device *dev, int slave, u8 *mac_addr)
}
EXPORT_SYMBOL_GPL(ti_cm_get_macid);

+MODULE_DESCRIPTION("TI CPSW Switch common module");
MODULE_LICENSE("GPL");
--
2.39.3


2024-01-25 19:39:43

by Breno Leitao

[permalink] [raw]
Subject: [PATCH net 03/10] net: fill in MODULE_DESCRIPTION()s for SMSC drivers

W=1 builds now warn if module is built without a MODULE_DESCRIPTION().
Add descriptions to the SMSC 91x/911x/9420 Ethernet drivers.

Signed-off-by: Breno Leitao <[email protected]>
---
drivers/net/ethernet/smsc/smc91x.c | 1 +
drivers/net/ethernet/smsc/smsc911x.c | 1 +
drivers/net/ethernet/smsc/smsc9420.c | 1 +
3 files changed, 3 insertions(+)

diff --git a/drivers/net/ethernet/smsc/smc91x.c b/drivers/net/ethernet/smsc/smc91x.c
index 758347616535..78ff3af7911a 100644
--- a/drivers/net/ethernet/smsc/smc91x.c
+++ b/drivers/net/ethernet/smsc/smc91x.c
@@ -98,6 +98,7 @@ static int watchdog = 1000;
module_param(watchdog, int, 0400);
MODULE_PARM_DESC(watchdog, "transmit timeout in milliseconds");

+MODULE_DESCRIPTION("SMC 91C9x/91C1xxx Ethernet driver");
MODULE_LICENSE("GPL");
MODULE_ALIAS("platform:smc91x");

diff --git a/drivers/net/ethernet/smsc/smsc911x.c b/drivers/net/ethernet/smsc/smsc911x.c
index 31cb7d0166f0..74f1ccc96459 100644
--- a/drivers/net/ethernet/smsc/smsc911x.c
+++ b/drivers/net/ethernet/smsc/smsc911x.c
@@ -56,6 +56,7 @@
#define SMSC_MDIONAME "smsc911x-mdio"
#define SMSC_DRV_VERSION "2008-10-21"

+MODULE_DESCRIPTION("SMSC LAN911x/LAN921x Ethernet driver");
MODULE_LICENSE("GPL");
MODULE_VERSION(SMSC_DRV_VERSION);
MODULE_ALIAS("platform:smsc911x");
diff --git a/drivers/net/ethernet/smsc/smsc9420.c b/drivers/net/ethernet/smsc/smsc9420.c
index e1c4a11c1f18..15cb96c2506d 100644
--- a/drivers/net/ethernet/smsc/smsc9420.c
+++ b/drivers/net/ethernet/smsc/smsc9420.c
@@ -26,6 +26,7 @@
#define DRV_DESCRIPTION "SMSC LAN9420 driver"
#define DRV_VERSION "1.01"

+MODULE_DESCRIPTION("SMSC LAN9420 Ethernet driver");
MODULE_LICENSE("GPL");
MODULE_VERSION(DRV_VERSION);

--
2.39.3


2024-01-25 19:40:33

by Breno Leitao

[permalink] [raw]
Subject: [PATCH net 10/10] net: fill in MODULE_DESCRIPTION()s for arcnet

W=1 builds now warn if module is built without a MODULE_DESCRIPTION().
Add descriptions to arcnet module.

Signed-off-by: Breno Leitao <[email protected]>
---
drivers/net/arcnet/arcnet.c | 1 +
1 file changed, 1 insertion(+)

diff --git a/drivers/net/arcnet/arcnet.c b/drivers/net/arcnet/arcnet.c
index d9e052c49ba1..166bfc3c8e6c 100644
--- a/drivers/net/arcnet/arcnet.c
+++ b/drivers/net/arcnet/arcnet.c
@@ -108,6 +108,7 @@ static int go_tx(struct net_device *dev);

static int debug = ARCNET_DEBUG;
module_param(debug, int, 0);
+MODULE_DESCRIPTION("ARCnet core driver");
MODULE_LICENSE("GPL");

static int __init arcnet_init(void)
--
2.39.3


2024-01-25 19:42:52

by Breno Leitao

[permalink] [raw]
Subject: [PATCH net 07/10] net: fill in MODULE_DESCRIPTION()s for ec_bhf

W=1 builds now warn if module is built without a MODULE_DESCRIPTION().
Add descriptions to the Beckhoff CX5020 EtherCAT Ethernet driver.

Signed-off-by: Breno Leitao <[email protected]>
---
drivers/net/ethernet/ec_bhf.c | 1 +
1 file changed, 1 insertion(+)

diff --git a/drivers/net/ethernet/ec_bhf.c b/drivers/net/ethernet/ec_bhf.c
index c2c5c589a5e3..44af1d13d931 100644
--- a/drivers/net/ethernet/ec_bhf.c
+++ b/drivers/net/ethernet/ec_bhf.c
@@ -590,5 +590,6 @@ module_pci_driver(pci_driver);
module_param(polling_frequency, long, 0444);
MODULE_PARM_DESC(polling_frequency, "Polling timer frequency in ns");

+MODULE_DESCRIPTION("Beckhoff CX5020 EtherCAT Ethernet driver");
MODULE_LICENSE("GPL");
MODULE_AUTHOR("Dariusz Marcinkiewicz <[email protected]>");
--
2.39.3


2024-01-25 19:46:08

by Breno Leitao

[permalink] [raw]
Subject: [PATCH net 09/10] net: fill in MODULE_DESCRIPTION()s for ieee802154

W=1 builds now warn if module is built without a MODULE_DESCRIPTION().
Add descriptions to ieee802154 modules.

Signed-off-by: Breno Leitao <[email protected]>
Acked-by: Miquel Raynal <[email protected]>
Acked-by: Stefan Schmidt <[email protected]>
---
net/ieee802154/6lowpan/core.c | 1 +
net/ieee802154/socket.c | 1 +
2 files changed, 2 insertions(+)

diff --git a/net/ieee802154/6lowpan/core.c b/net/ieee802154/6lowpan/core.c
index 2c087b7f17c5..e643f52663f9 100644
--- a/net/ieee802154/6lowpan/core.c
+++ b/net/ieee802154/6lowpan/core.c
@@ -280,5 +280,6 @@ static void __exit lowpan_cleanup_module(void)

module_init(lowpan_init_module);
module_exit(lowpan_cleanup_module);
+MODULE_DESCRIPTION("IPv6 over Low power Wireless Personal Area Network IEEE 802.15.4 core");
MODULE_LICENSE("GPL");
MODULE_ALIAS_RTNL_LINK("lowpan");
diff --git a/net/ieee802154/socket.c b/net/ieee802154/socket.c
index 00302e8b9615..990a83455dcf 100644
--- a/net/ieee802154/socket.c
+++ b/net/ieee802154/socket.c
@@ -1137,4 +1137,5 @@ module_init(af_ieee802154_init);
module_exit(af_ieee802154_remove);

MODULE_LICENSE("GPL");
+MODULE_DESCRIPTION("IEEE 802.15.4 socket interface");
MODULE_ALIAS_NETPROTO(PF_IEEE802154);
--
2.39.3


2024-01-25 19:47:22

by Breno Leitao

[permalink] [raw]
Subject: [PATCH net 08/10] net: fill in MODULE_DESCRIPTION()s for PCS drivers

W=1 builds now warn if module is built without a MODULE_DESCRIPTION().
Add descriptions to the Lynx, XPCS and LynxI PCS drivers.

Signed-off-by: Breno Leitao <[email protected]>
---
drivers/net/pcs/pcs-lynx.c | 1 +
drivers/net/pcs/pcs-mtk-lynxi.c | 1 +
drivers/net/pcs/pcs-xpcs.c | 1 +
3 files changed, 3 insertions(+)

diff --git a/drivers/net/pcs/pcs-lynx.c b/drivers/net/pcs/pcs-lynx.c
index dc3962b2aa6b..853b8c138718 100644
--- a/drivers/net/pcs/pcs-lynx.c
+++ b/drivers/net/pcs/pcs-lynx.c
@@ -398,4 +398,5 @@ void lynx_pcs_destroy(struct phylink_pcs *pcs)
}
EXPORT_SYMBOL(lynx_pcs_destroy);

+MODULE_DESCRIPTION("NXP Lynx PCS phylink library");
MODULE_LICENSE("Dual BSD/GPL");
diff --git a/drivers/net/pcs/pcs-mtk-lynxi.c b/drivers/net/pcs/pcs-mtk-lynxi.c
index 8501dd365279..4f63abe638c4 100644
--- a/drivers/net/pcs/pcs-mtk-lynxi.c
+++ b/drivers/net/pcs/pcs-mtk-lynxi.c
@@ -303,4 +303,5 @@ void mtk_pcs_lynxi_destroy(struct phylink_pcs *pcs)
}
EXPORT_SYMBOL(mtk_pcs_lynxi_destroy);

+MODULE_DESCRIPTION("MediaTek SGMII library for LynxI");
MODULE_LICENSE("GPL");
diff --git a/drivers/net/pcs/pcs-xpcs.c b/drivers/net/pcs/pcs-xpcs.c
index 31f0beba638a..52a7757ee419 100644
--- a/drivers/net/pcs/pcs-xpcs.c
+++ b/drivers/net/pcs/pcs-xpcs.c
@@ -1456,4 +1456,5 @@ struct dw_xpcs *xpcs_create_mdiodev(struct mii_bus *bus, int addr,
}
EXPORT_SYMBOL_GPL(xpcs_create_mdiodev);

+MODULE_DESCRIPTION("Synopsys DesignWare XPCS library");
MODULE_LICENSE("GPL v2");
--
2.39.3


2024-01-26 10:38:08

by Andrew Lunn

[permalink] [raw]
Subject: Re: [PATCH net 08/10] net: fill in MODULE_DESCRIPTION()s for PCS drivers

On Thu, Jan 25, 2024 at 11:34:18AM -0800, Breno Leitao wrote:
> W=1 builds now warn if module is built without a MODULE_DESCRIPTION().
> Add descriptions to the Lynx, XPCS and LynxI PCS drivers.
>
> Signed-off-by: Breno Leitao <[email protected]>

Reviewed-by: Andrew Lunn <[email protected]>

Andrew

2024-01-29 12:20:41

by patchwork-bot+netdevbpf

[permalink] [raw]
Subject: Re: [PATCH net 00/10] Fix MODULE_DESCRIPTION() for net (p3)

Hello:

This series was applied to netdev/net-next.git (main)
by David S. Miller <[email protected]>:

On Thu, 25 Jan 2024 11:34:10 -0800 you wrote:
> There are hundreds of network modules that misses MODULE_DESCRIPTION(),
> causing a warning when compiling with W=1. Example:
>
> WARNING: modpost: missing MODULE_DESCRIPTION() in drivers/net/arcnet/com90io.o
> WARNING: modpost: missing MODULE_DESCRIPTION() in drivers/net/arcnet/arc-rimi.o
> WARNING: modpost: missing MODULE_DESCRIPTION() in drivers/net/arcnet/com20020.o
>
> [...]

Here is the summary with links:
- [net,01/10] net: fill in MODULE_DESCRIPTION()s for encx24j600
https://git.kernel.org/netdev/net-next/c/dec836ed69d1
- [net,02/10] net: fill in MODULE_DESCRIPTION()s for ocelot
https://git.kernel.org/netdev/net-next/c/1c870c63d7d2
- [net,03/10] net: fill in MODULE_DESCRIPTION()s for SMSC drivers
https://git.kernel.org/netdev/net-next/c/9ba4295b2eab
- [net,04/10] net: fill in MODULE_DESCRIPTION()s for Qualcom drivers
https://git.kernel.org/netdev/net-next/c/66c164633bb0
- [net,05/10] net: fill in MODULE_DESCRIPTION()s for dwmac-socfpga
https://git.kernel.org/netdev/net-next/c/23f487f70c73
- [net,06/10] net: fill in MODULE_DESCRIPTION()s for cpsw-common
https://git.kernel.org/netdev/net-next/c/3e4620c89148
- [net,07/10] net: fill in MODULE_DESCRIPTION()s for ec_bhf
https://git.kernel.org/netdev/net-next/c/ad979679d64b
- [net,08/10] net: fill in MODULE_DESCRIPTION()s for PCS drivers
https://git.kernel.org/netdev/net-next/c/be884c15de37
- [net,09/10] net: fill in MODULE_DESCRIPTION()s for ieee802154
https://git.kernel.org/netdev/net-next/c/6aa89bf8ac9a
- [net,10/10] net: fill in MODULE_DESCRIPTION()s for arcnet
https://git.kernel.org/netdev/net-next/c/d06aa0eb0a70

You are awesome, thank you!
--
Deet-doot-dot, I am a bot.
https://korg.docs.kernel.org/patchwork/pwbot.html



2024-01-29 20:01:09

by Jakub Kicinski

[permalink] [raw]
Subject: Re: [PATCH net 00/10] Fix MODULE_DESCRIPTION() for net (p3)

On Mon, 29 Jan 2024 12:20:28 +0000 [email protected]
wrote:
> This series was applied to netdev/net-next.git (main)
> by David S. Miller <[email protected]>:

????

2024-01-30 12:57:49

by Simon Horman

[permalink] [raw]
Subject: Re: [PATCH net 03/10] net: fill in MODULE_DESCRIPTION()s for SMSC drivers

On Thu, Jan 25, 2024 at 11:34:13AM -0800, Breno Leitao wrote:
> W=1 builds now warn if module is built without a MODULE_DESCRIPTION().
> Add descriptions to the SMSC 91x/911x/9420 Ethernet drivers.
>
> Signed-off-by: Breno Leitao <[email protected]>

Reviewed-by: Simon Horman <[email protected]>


2024-01-30 12:58:04

by Simon Horman

[permalink] [raw]
Subject: Re: [PATCH net 05/10] net: fill in MODULE_DESCRIPTION()s for dwmac-socfpga

On Thu, Jan 25, 2024 at 11:34:15AM -0800, Breno Leitao wrote:
> W=1 builds now warn if module is built without a MODULE_DESCRIPTION().
> Add descriptions to the STMicro DWMAC for Altera SOCs.
>
> Signed-off-by: Breno Leitao <[email protected]>

Reviewed-by: Simon Horman <[email protected]>


2024-01-30 12:58:29

by Simon Horman

[permalink] [raw]
Subject: Re: [PATCH net 06/10] net: fill in MODULE_DESCRIPTION()s for cpsw-common

On Thu, Jan 25, 2024 at 11:34:16AM -0800, Breno Leitao wrote:
> W=1 builds now warn if module is built without a MODULE_DESCRIPTION().
> Add descriptions to the TI CPSW switch module.
>
> Signed-off-by: Breno Leitao <[email protected]>
> Reviewed-by: Roger Quadros <[email protected]>

Reviewed-by: Simon Horman <[email protected]>


2024-01-30 12:58:50

by Simon Horman

[permalink] [raw]
Subject: Re: [PATCH net 07/10] net: fill in MODULE_DESCRIPTION()s for ec_bhf

On Thu, Jan 25, 2024 at 11:34:17AM -0800, Breno Leitao wrote:
> W=1 builds now warn if module is built without a MODULE_DESCRIPTION().
> Add descriptions to the Beckhoff CX5020 EtherCAT Ethernet driver.
>
> Signed-off-by: Breno Leitao <[email protected]>

Reviewed-by: Simon Horman <[email protected]>


2024-01-30 12:59:20

by Simon Horman

[permalink] [raw]
Subject: Re: [PATCH net 01/10] net: fill in MODULE_DESCRIPTION()s for encx24j600

On Thu, Jan 25, 2024 at 11:34:11AM -0800, Breno Leitao wrote:
> W=1 builds now warn if module is built without a MODULE_DESCRIPTION().
> Add descriptions to the Microchip ENCX24J600 helpers driver.
>
> Signed-off-by: Breno Leitao <[email protected]>

Reviewed-by: Simon Horman <[email protected]>


2024-01-30 13:05:38

by Simon Horman

[permalink] [raw]
Subject: Re: [PATCH net 10/10] net: fill in MODULE_DESCRIPTION()s for arcnet

On Thu, Jan 25, 2024 at 11:34:20AM -0800, Breno Leitao wrote:
> W=1 builds now warn if module is built without a MODULE_DESCRIPTION().
> Add descriptions to arcnet module.
>
> Signed-off-by: Breno Leitao <[email protected]>

Reviewed-by: Simon Horman <[email protected]>