From: Logan Gunthorpe > On 6/29/2017 12:11 PM, Allen Hubbe wrote: > > Nak. This breaks a work around for stability issues on some hardware. I am ok with changing the > comment to say, this is only supported when called after link up. I would still like to allow these > to be called at any time. Specific hardware drivers like Switchtec may return an error. Upstream > drivers, of course, should call these after link up: patch 5/16 part of this set looks good. > > If absolutely necessary I can leave this out. But in terms of interface > design it's _so_ much better to have it in. This change would bring the > score from a 3 to a 5 on Rusty Russel's Hard to Misuse ranking[1]. To > quote Rusty: > > "3. Read the documentation and you'll get it right. > People only read instructions after they've already tied themselves into > a knot. Then they skim them for keywords and don't read your warnings. I > don't give an example of this; if this is the best an interface can get > do, it's in trouble." > > Can someone not just fix the out-of-tree code? And since when is > out-of-tree code reasonable justification for what's done in upstream? Unfortunately, it is to work around hardware errata. That is not so trivial to fix. The workaround in software is also not acceptable upstream, for doing things like writing directly to the peer's interrupt controller registers, bypassing the ntb doorbells. > > Logan > > [1]http://ozlabs.org/~rusty/index.cgi/tech/2008-03-30.html
