[net,v2,7/9] net: fill in MODULE_DESCRIPTION()s for net/sched
Commit Message
W=1 builds now warn if module is built without a MODULE_DESCRIPTION().
Add descriptions to the network schedulers.
Signed-off-by: Breno Leitao <leitao@debian.org>
---
net/sched/em_canid.c | 1 +
net/sched/em_cmp.c | 1 +
net/sched/em_meta.c | 1 +
net/sched/em_nbyte.c | 1 +
net/sched/em_text.c | 1 +
net/sched/em_u32.c | 1 +
6 files changed, 6 insertions(+)
Comments
On Wed, Feb 07, 2024 at 02:19:26AM -0800, Breno Leitao wrote:
> W=1 builds now warn if module is built without a MODULE_DESCRIPTION().
> Add descriptions to the network schedulers.
>
> Signed-off-by: Breno Leitao <leitao@debian.org>
Hi Breno,
I wonder if it would be useful to mention Ematch somehow
in the module descriptions as that is the context in
which they operate.
On Wed, 7 Feb 2024 02:19:26 -0800 Breno Leitao wrote:
> --- a/net/sched/em_canid.c
> +++ b/net/sched/em_canid.c
> @@ -222,6 +222,7 @@ static void __exit exit_em_canid(void)
> tcf_em_unregister(&em_canid_ops);
> }
>
> +MODULE_DESCRIPTION("CAN Identifier comparison network helpers");
That sounds like it as library for any code, but it's TC extended match.
Jamal, any suggestion for a good name template for em_ ?
On Wed, Feb 7, 2024 at 10:37 AM Jakub Kicinski <kuba@kernel.org> wrote:
>
> On Wed, 7 Feb 2024 02:19:26 -0800 Breno Leitao wrote:
> > --- a/net/sched/em_canid.c
> > +++ b/net/sched/em_canid.c
> > @@ -222,6 +222,7 @@ static void __exit exit_em_canid(void)
> > tcf_em_unregister(&em_canid_ops);
> > }
> >
> > +MODULE_DESCRIPTION("CAN Identifier comparison network helpers");
>
> That sounds like it as library for any code, but it's TC extended match.
> Jamal, any suggestion for a good name template for em_ ?
At minimal what Simon said. But let me go over it and do individual responses.
cheers,
jamal
On Wed, Feb 7, 2024 at 5:19 AM Breno Leitao <leitao@debian.org> wrote:
>
> W=1 builds now warn if module is built without a MODULE_DESCRIPTION().
> Add descriptions to the network schedulers.
>
> Signed-off-by: Breno Leitao <leitao@debian.org>
> ---
> net/sched/em_canid.c | 1 +
> net/sched/em_cmp.c | 1 +
> net/sched/em_meta.c | 1 +
> net/sched/em_nbyte.c | 1 +
> net/sched/em_text.c | 1 +
> net/sched/em_u32.c | 1 +
> 6 files changed, 6 insertions(+)
>
> diff --git a/net/sched/em_canid.c b/net/sched/em_canid.c
> index 5ea84decec19..c1852d79c00a 100644
> --- a/net/sched/em_canid.c
> +++ b/net/sched/em_canid.c
> @@ -222,6 +222,7 @@ static void __exit exit_em_canid(void)
> tcf_em_unregister(&em_canid_ops);
> }
>
> +MODULE_DESCRIPTION("CAN Identifier comparison network helpers");
ematch classifier to match CAN IDs embedded in skb CAN frames
> MODULE_LICENSE("GPL");
>
> module_init(init_em_canid);
> diff --git a/net/sched/em_cmp.c b/net/sched/em_cmp.c
> index f17b049ea530..285b36c32c16 100644
> --- a/net/sched/em_cmp.c
> +++ b/net/sched/em_cmp.c
> @@ -87,6 +87,7 @@ static void __exit exit_em_cmp(void)
> tcf_em_unregister(&em_cmp_ops);
> }
>
> +MODULE_DESCRIPTION("Simple packet data comparison network helpers");
ematch classifier for basic data types(8/16/32 bit) against skb data
> MODULE_LICENSE("GPL");
>
> module_init(init_em_cmp);
> diff --git a/net/sched/em_meta.c b/net/sched/em_meta.c
> index 09d8afd04a2a..cab43356824a 100644
> --- a/net/sched/em_meta.c
> +++ b/net/sched/em_meta.c
> @@ -1006,6 +1006,7 @@ static void __exit exit_em_meta(void)
> tcf_em_unregister(&em_meta_ops);
> }
>
> +MODULE_DESCRIPTION("Metadata comparison network helpers");
ematch classifier for various internal kernel metadata, skb metadata
and sk metadata
> MODULE_LICENSE("GPL");
>
> module_init(init_em_meta);
> diff --git a/net/sched/em_nbyte.c b/net/sched/em_nbyte.c
> index a83b237cbeb0..34c6e8c8b695 100644
> --- a/net/sched/em_nbyte.c
> +++ b/net/sched/em_nbyte.c
> @@ -68,6 +68,7 @@ static void __exit exit_em_nbyte(void)
> tcf_em_unregister(&em_nbyte_ops);
> }
>
> +MODULE_DESCRIPTION("Multi byte comparison network helpers");
ematch classifier for arbitrary skb multi-bytes
> MODULE_LICENSE("GPL");
>
> module_init(init_em_nbyte);
> diff --git a/net/sched/em_text.c b/net/sched/em_text.c
> index f176afb70559..7a89db8e5409 100644
> --- a/net/sched/em_text.c
> +++ b/net/sched/em_text.c
> @@ -147,6 +147,7 @@ static void __exit exit_em_text(void)
> tcf_em_unregister(&em_text_ops);
> }
>
> +MODULE_DESCRIPTION("Textsearch comparison network helpers");
ematch classifier for embedded text in skbs
> MODULE_LICENSE("GPL");
>
> module_init(init_em_text);
> diff --git a/net/sched/em_u32.c b/net/sched/em_u32.c
> index 71b070da0437..ea32e4e12a99 100644
> --- a/net/sched/em_u32.c
> +++ b/net/sched/em_u32.c
> @@ -52,6 +52,7 @@ static void __exit exit_em_u32(void)
> tcf_em_unregister(&em_u32_ops);
> }
>
> +MODULE_DESCRIPTION("U32 Key comparison network helpers");
ematch skb classifier using 32 bit chunks of data
> MODULE_LICENSE("GPL");
>
> module_init(init_em_u32);
> --
> 2.39.3
>
@@ -222,6 +222,7 @@ static void __exit exit_em_canid(void)
tcf_em_unregister(&em_canid_ops);
}
+MODULE_DESCRIPTION("CAN Identifier comparison network helpers");
MODULE_LICENSE("GPL");
module_init(init_em_canid);
@@ -87,6 +87,7 @@ static void __exit exit_em_cmp(void)
tcf_em_unregister(&em_cmp_ops);
}
+MODULE_DESCRIPTION("Simple packet data comparison network helpers");
MODULE_LICENSE("GPL");
module_init(init_em_cmp);
@@ -1006,6 +1006,7 @@ static void __exit exit_em_meta(void)
tcf_em_unregister(&em_meta_ops);
}
+MODULE_DESCRIPTION("Metadata comparison network helpers");
MODULE_LICENSE("GPL");
module_init(init_em_meta);
@@ -68,6 +68,7 @@ static void __exit exit_em_nbyte(void)
tcf_em_unregister(&em_nbyte_ops);
}
+MODULE_DESCRIPTION("Multi byte comparison network helpers");
MODULE_LICENSE("GPL");
module_init(init_em_nbyte);
@@ -147,6 +147,7 @@ static void __exit exit_em_text(void)
tcf_em_unregister(&em_text_ops);
}
+MODULE_DESCRIPTION("Textsearch comparison network helpers");
MODULE_LICENSE("GPL");
module_init(init_em_text);
@@ -52,6 +52,7 @@ static void __exit exit_em_u32(void)
tcf_em_unregister(&em_u32_ops);
}
+MODULE_DESCRIPTION("U32 Key comparison network helpers");
MODULE_LICENSE("GPL");
module_init(init_em_u32);