Re: [git pull] drm for 6.15-rc1

[Jani Nikula <jani.nikula@linux.intel.com>]

On Mon, 31 Mar 2025, Jason Gunthorpe <jgg@nvidia.com> wrote:
> Please don't keep it fully isolated to DRM.. This new stuff did find
> an error in the fwctl UAPI headers around uuid_t that had gone unnoticed:
>
> https://lore.kernel.org/all/f6489337-67c7-48c8-b48a-58603ec15328@paulmck-laptop/raw
>
> I think that was a valuable report, you just need to find a way to
> make the tests it runs more acceptable..

The header checks have existed for uapi headers before, including the,
uh, turds, but apparently adding them in drm broke the camel's back.

> FWIW, there is a "trick" I like to use for C header files, just ensure
> that some C file someplace includes each header file first in the
> #include list. It automatically makes the compiler check it is self
> contained naturally. You can get pretty far by paying attention to
> this detail and it costs nothing at build time.

It's a fairly good solution for a lot of cases, but it falls a bit
short. I'd additionally like to ensure:

- Header guards are in place
- There are no kernel-doc warnings
- Headers not associated 1:1 with a .c file are also checked

Finally, the cost of having to keep checking the headers are in fact
included first, and nagging about it in reviews, is not without cost.

BR,
Jani.


-- 
Jani Nikula, Intel