Re: [PATCH wireless-next 0/3] wifi: netif_napi_add() conversions

[Kalle Valo <kvalo@kernel.org>]

Jakub Kicinski <kuba@kernel.org> writes:

> On Thu, 05 May 2022 07:25:03 +0300 Kalle Valo wrote:
>> Jakub Kicinski <kuba@kernel.org> writes:
>> 
>> > Convert wifi callers to the new netif_napi_add() APIs.
>> >
>> > The callers passing 64 or NAPI_POLL_WEIGHT to the non-Tx flavor
>> > are left alone. I'm planning to include wifi drivers in the massive
>> > tree-wide patch/series which will drop the last argument from
>> > netif_napi_add(). Alternatively I can switch all of wifi to
>> > netif_napi_add_tx_weight() and back after the netif_napi_add()
>> > change makes its wait into wireless-next.
>> > Please LMK if you prefer that.
>> >
>> > Jakub Kicinski (3):
>> >   wifi: wil6210: switch to netif_napi_add_tx()
>> >   wifi: mt76: switch to netif_napi_add_tx()
>> >   wifi: qtnfmac: switch to netif_napi_add_weight()  
>> 
>> We don't use that "wifi:" prefix, otherwise looks good. 
>
> I know, my silent effort to make git log --oneline be more
> understandable for folks outside of networking is not really
> being met with much applause :) Ethernet people also don't
> like the "eth:" prefix..
>
> AFAICS drivers tend to use a format consisting of (numbers at 
> the top denoting commonality):
>
> 3    4       1       2
> net: vendor: driver: component: bla bla

To me that's almost like the full path. An example from wireless
drivers:

drivers/net/wireless/ath/ath11k/mac.c

net: wireless: ath: ath11k: mac: blah blah

Only the directory name "drivers" is missing from the path.

Wouldn't it be easier to modify the tools showing logs (like git log or
gitk) to add that to each commit, then people who want to see that can
enable the feature :)

> Driver name is the most common prefix. It is the most meaningful
> and natural for people working on the code. Not everyone is working 
> on the driver code, tho.

Sure, I understand that not everyone are developers. It's always a
balance.

> 1) When I send PRs to Linus I always wonder how much he can 
> make out of the shortlog. And if people throw "net:" into the mix
> whether it's still clear when something is "just" a driver bug vs
> a core bug affecting everyone. So I started using "eth: " for ethernet
> drivers, and "wifi: " for wireless drivers in the text of the PRs.
>
> 2) For people doing backporting the driver names may not be meaningful,
> but if I'm doing backports for a datacenter kernel I know to pay
> attention to "eth:" while "wifi:" I can safely skip.

Is there a specific reason why you use "wifi:" and not "wireless:"? I
admit the term wireless is not great for our 802.11 subsystem but that
has been used as long as I know.

> 3) The case of this set - I have conversions for the entire tree queued
> up on a branch, it's quite useful for me to use a common area-specific
> prefix to see what goes were.
>
> Anyway, that's just me rambling. I hope you don't mind if I send things
> with a wifi prefix from time to time given it's a convenient way for me
> to mark the queued patches.

I don't mind if you submit with "wifi:", it's easy to edit patches with
my patchwork script during commit :) And if there's a strong need I
think we can change our title scheme in wireless patches. This has come
before but I have always resisted due to extra work involved. To me most
important is consistency within wireless subsystem, if different
wireless drivers (and stack) use a different scheme when the logs will
become hard to read. So I would hope everyone can agree to the new
scheme.

-- 
https://patchwork.kernel.org/project/linux-wireless/list/

https://wireless.wiki.kernel.org/en/developers/documentation/submittingpatches