Re: [PATCH net v3] wifi: nl80211: document sta-info nested attribute

[Johannes Berg]

On Fri, 2026-10-02 at 13:25 -0700, Jakub Kicinski wrote:
> > 
> > There's a license issue - we have ISC license on nl80211.h now, but
> > Donald and Hilal picked GPL/syscall/BSD-3 for the yaml and of course
> 
> That license is required for all netlink specs, FWIW
> It's totally my fault if it's wrong, I just didn't want it to be
> _just_ GPL since that would propagate to use space code which
> we want to be permissive about. The spec is effectively a uAPI
> description it should be public domain in my non-layer mind.

Oh, sure. But BSD-3 isn't (advertising clause), and people copy at least
the nl80211.h file around to other projects. And the syscall exception
doesn't really talk about distributing that code. So presumably going
from ISC to this would require people to update even their binary
distribution's docs (where it's built in) ...

> > that carries over to the generated .h file, not sure if that's an issue
> > for downstream projects but might be with advertising clause? Could we
> > change it if I'm adding >10k new lines from nl80211.h? :)
> > 
> > I can post it but ... is it worth it? Not even sure it would
> > significantly simplify our lives, although the generated header file
> > with documentation is much more regular in that it always has the type,
> > etc. (which is what Jouni was asking about)
> 
> Well, I certainly don't care so my choice would be not to have to review
> the code gen changes (:

Fair :)

I'm not really sure it gives _that_ much benefit ... I guess I'll mull
it over and maybe run it by some wifi people.

Thanks :)

johannes