PSARC/2008/628 Interrupt Resource Management

[David Kahn]

Just in case this wasn't clear from my last email.

Scott Carter wrote:

 >    The nreq parameter is the total number of interrupts
 >    that the driver requests from the system.  Initially
 >    it is set to be equal to the count parameter when the
 >    driver first calls the ddi_intr_alloc(9F) function.

How is an argument to a function initially set to
some value? It isn't. It doesn't have any value
or persistence as an argument to an interface.
"it" is vague and it doesn't belong in the definition.
At best, it's an implementation note that defines
what the implementation is supposed to do.

We are mixing the internal ddi implementation with
the normative definition of this interface.

Also, is "it" set from the first successful call
to ddi_intr_alloc()? What if the strict behaviour
flag is set and the function fails, for example?
What if no resources are available at all?
How much detail do you need to give here?
(I don't really care what the answers are to
these rhetorical questions, only that the interface
is well-defined.)

-David