Re: [linux-safety] [PATCH] usb: host: ehci-sched: add comment about find_tt() not returning error

From: Alan Stern
Date: Mon Oct 12 2020 - 10:57:21 EST


On Mon, Oct 12, 2020 at 04:11:38PM +0200, Lukas Bulwahn wrote:
>
>
> On Sun, 11 Oct 2020, Sudip Mukherjee wrote:
>
> > Add a comment explaining why find_tt() will not return error even though
> > find_tt() is checking for NULL and other errors.
> >
> > Signed-off-by: Sudip Mukherjee <sudipm.mukherjee@xxxxxxxxx>
>
> I get the intent of the comment but there is a large risk that somebody
> could remove the find_tt() call before the calling the function and there
> is no chance to then see later that the comment is actually wrong.

Why would anybody do that? Who would deliberately go change a driver in
a way that is obviously wrong and would break it? Especially when such
changes are likely to cause compile errors?

There are tons of changes one might make to any program that will leave
it syntactically valid but will cause it to fail. What's special about
removing the early calls to find_tt()?

> I guess you want to link this comment here to a code line above and
> request anyone touching the line above to reconsider the comment then.

That really seems unnecessary.

> But there is no 'concept' for such kind of requests to changes and
> comments.
>
> So, the comment is true now, but might be true or wrong later.
>
> I am wondering if such comment deserves to be included if we cannot check
> its validity later...
>
> I would prefer a simple tool that could check that your basic assumption
> on the code is valid and if it the basic assumption is still valid,
> just shut up any stupid tool that simply does not get that these calls
> here cannot return any error.

Real code contains so many assumptions, especially if you include ones
which are obvious to everybody, that such a tool seems impractical.

Alan Stern