Clearify what happens with the cookiep in various cases.

This commit is contained in:
Warner Losh 2003-03-29 05:11:14 +00:00
parent c4ac3bc51d
commit 1aa895cd3f

View File

@ -24,7 +24,7 @@
.\"
.\" $FreeBSD$
.\"
.Dd April 2, 2000
.Dd March 28, 2003
.Dt BUS_SETUP_INTR 9
.Os
.Sh NAME
@ -84,6 +84,16 @@ will be called with the value
.Fa arg
as its only argument.
.Pp
The
.Fa cookiep
argument is a pointer to a void * that
.Nm
will write a cookie for the parent bus' use to if it is successful in
establishing an interrupt.
Driver writers may assume that this cookie will be non-zero.
The nexus driver will write 0 on failure to
.Fa cookiep.
.Pp
The interrupt handler will be detached by
.Fn BUS_TEARDOWN_INTR .
The cookie needs to be passed to