d/freebsd-nq
1
0
Fork 0
Code Issues Pull Requests Packages Projects Releases Wiki Activity

Update the swi_add prototype after struct ithd was split up into

Browse Source 
struct intr_event and struct intr_thread.

PR:		docs/166864
Reviewed by:	jhb (older version)
MFC after:	1 week
This commit is contained in:
Sergey Kandaurov 2012-04-12 16:02:45 +00:00
parent 7582954e34
commit 4b47ece986
1 changed files with 16 additions and 15 deletions
Show Stats Download Patch File Download Diff File Expand all files Collapse all files

31
share/man/man9/swi.9
View File

@ -24,7 +24,7 @@
.\"
.\" $FreeBSD$
.\"
.Dd October 30, 2000
.Dd April 12, 2012
.Dt SWI 9
.Os
.Sh NAME
@ -42,7 +42,7 @@
.Vt "extern void *vm_ih" ;
.Ft int
.Fo swi_add
.Fa "struct ithd **ithdp"
.Fa "struct intr_event **eventp"
.Fa "const char *name"
.Fa "driver_intr_t handler"
.Fa "void *arg"
@ -67,20 +67,21 @@ time, and that they can be run via a lightweight context switch.
.Pp
The
.Fn swi_add
function is used to register a new software interrupt handler.
function is used to add a new software interrupt handler to a specified
interrupt event.
The
.Fa ithdp
.Fa eventp
argument is an optional pointer to a
.Vt struct ithd
.Vt struct intr_event
pointer.
If this argument points to an existing software interrupt thread, then this
handler will be attached to that thread.
Otherwise a new thread will be created, and if
.Fa ithdp
If this argument points to an existing event that holds a list of
interrupt handlers, then this handler will be attached to that event.
Otherwise a new event will be created, and if
.Fa eventp
is not
.Dv NULL ,
then the pointer at that address to will be modified to point to the
newly created thread.
newly created event.
The
.Fa name
argument is used to associate a name with a specific handler.
@ -99,7 +100,7 @@ The
.Fa pri
value specifies the priority of this interrupt handler relative to other
software interrupt handlers.
If an interrupt thread is created, then this value is used as the vector,
If an interrupt event is created, then this value is used as the vector,
and the
.Fa flags
argument is used to specify the attributes of a handler such as
@ -183,7 +184,7 @@ argument specifies
.Dv INTR_ENTROPY .
.It Bq Er EINVAL
The
.Fa ithdp
.Fa eventp
argument points to a hardware interrupt thread.
.It Bq Er EINVAL
Either of the
@ -195,9 +196,9 @@ arguments are
.It Bq Er EINVAL
The
.Dv INTR_EXCL
flag is specified and the interrupt thread pointed to by
.Fa ithdp
already has at least one handler, or the interrupt thread already has an
flag is specified and the interrupt event pointed to by
.Fa eventp
already has at least one handler, or the interrupt event already has an
exclusive handler.
.El
.Sh SEE ALSO