summaryrefslogtreecommitdiffstats
path: root/share
diff options
context:
space:
mode:
authorjhb <jhb@FreeBSD.org>2011-01-06 21:14:34 +0000
committerjhb <jhb@FreeBSD.org>2011-01-06 21:14:34 +0000
commitb80745da98e50e465f6eb1d88cf8964816504536 (patch)
tree6743d27926a58743ef4c0c198984aaa48ef64d76 /share
parent65e0897b21bafab7de5fdb76fa36831b1ace3d96 (diff)
downloadFreeBSD-src-b80745da98e50e465f6eb1d88cf8964816504536.zip
FreeBSD-src-b80745da98e50e465f6eb1d88cf8964816504536.tar.gz
Retire the INTR_FAST flag as it was obsoleted by the introduction of the
filter argument to bus_setup_intr().
Diffstat (limited to 'share')
-rw-r--r--share/man/man9/BUS_SETUP_INTR.910
-rw-r--r--share/man/man9/ithread.915
-rw-r--r--share/man/man9/mutex.94
-rw-r--r--share/man/man9/swi.96
4 files changed, 8 insertions, 27 deletions
diff --git a/share/man/man9/BUS_SETUP_INTR.9 b/share/man/man9/BUS_SETUP_INTR.9
index e1d0e94..3910570 100644
--- a/share/man/man9/BUS_SETUP_INTR.9
+++ b/share/man/man9/BUS_SETUP_INTR.9
@@ -85,9 +85,8 @@ marks the interrupt as being a good source of entropy -
this may be used by the entropy device
.Pa /dev/random .
.Pp
-To define a time-critical handler (previously known as
-.Dv INTR_FAST )
-that will not execute any potentially blocking operation, use the
+To define a time-critical handler that will not execute any potentially
+blocking operation, use the
.Fa filter
argument.
See the
@@ -128,10 +127,7 @@ will no longer be called.
.Pp
Mutexes are not allowed to be held across calls to these functions.
.Ss "Filter Routines"
-A filter runs in a context very similar to what was known as an
-.Dv INTR_FAST
-routine in previous versions of
-.Fx .
+A filter runs in primary interrupt context.
In this context, normal mutexes cannot be used.
Only the spin lock version of these can be used (specified by passing
.Dv MTX_SPIN
diff --git a/share/man/man9/ithread.9 b/share/man/man9/ithread.9
index 498c51a..1f4bfb9 100644
--- a/share/man/man9/ithread.9
+++ b/share/man/man9/ithread.9
@@ -180,15 +180,6 @@ The
flag specifies that this handler cannot share an interrupt thread with
another handler.
The
-.Dv INTR_FAST
-flag specifies that when this handler is executed, it should be run immediately
-rather than being run asynchronously when its interrupt thread is scheduled to
-run.
-The
-.Dv INTR_FAST
-flag implies
-.Dv INTR_EXCL .
-The
.Dv INTR_MPSAFE
flag specifies that this handler is MP safe in that it does not need the
Giant mutex to be held while it is executed.
@@ -198,10 +189,8 @@ flag specifies that the interrupt source this handler is tied to is a good
source of entropy, and thus that entropy should be gathered when an interrupt
from the handler's source triggers.
Presently, the
-.Dv INTR_FAST
-and
.Dv INTR_ENTROPY
-flags are not valid for software interrupt handlers.
+flag is not valid for software interrupt handlers.
.Pp
It is not permitted to sleep in an interrupt thread; hence, any memory
or zone allocations in an interrupt thread should be specified with the
@@ -237,7 +226,7 @@ swi_add(struct ithd **ithdp, const char *name, driver_intr_t handler,
struct ithd *ithd;
int error;
- if (flags & (INTR_FAST | INTR_ENTROPY))
+ if (flags & INTR_ENTROPY)
return (EINVAL);
ithd = (ithdp != NULL) ? *ithdp : NULL;
diff --git a/share/man/man9/mutex.9 b/share/man/man9/mutex.9
index b27f7f9..d1e7438 100644
--- a/share/man/man9/mutex.9
+++ b/share/man/man9/mutex.9
@@ -128,9 +128,7 @@ Mutexes which do not context switch are
mutexes.
These should only be used to protect data shared with primary interrupt
code.
-This includes
-.Dv INTR_FAST
-interrupt handlers and low level scheduling code.
+This includes interrupt filters and low level scheduling code.
In all architectures both acquiring and releasing of a
uncontested spin mutex is more expensive than the same operation
on a non-spin mutex.
diff --git a/share/man/man9/swi.9 b/share/man/man9/swi.9
index ea0b32b..ec2c3d6 100644
--- a/share/man/man9/swi.9
+++ b/share/man/man9/swi.9
@@ -179,10 +179,8 @@ MIB variable
.It Bq Er EINVAL
The
.Fa flags
-argument specifies either
-.Dv INTR_ENTROPY
-or
-.Dv INTR_FAST .
+argument specifies
+.Dv INTR_ENTROPY .
.It Bq Er EINVAL
The
.Fa ithdp
OpenPOWER on IntegriCloud