Module Name: src
Committed By: riastradh
Date: Fri Feb 11 23:19:43 UTC 2022
Modified Files:
src/share/man/man9: driver.9
Log Message:
driver(9): Correct paragraph about the driver activate function.
To generate a diff of this commit:
cvs rdiff -u -r1.33 -r1.34 src/share/man/man9/driver.9
Please note that diffs are not public domain; they are subject to the
copyright notices on the relevant files.
Modified files:
Index: src/share/man/man9/driver.9
diff -u src/share/man/man9/driver.9:1.33 src/share/man/man9/driver.9:1.34
--- src/share/man/man9/driver.9:1.33 Fri Feb 11 23:19:34 2022
+++ src/share/man/man9/driver.9 Fri Feb 11 23:19:43 2022
@@ -1,4 +1,4 @@
-.\" $NetBSD: driver.9,v 1.33 2022/02/11 23:19:34 riastradh Exp $
+.\" $NetBSD: driver.9,v 1.34 2022/02/11 23:19:43 riastradh Exp $
.\"
.\" Copyright (c) 2001 The NetBSD Foundation, Inc.
.\" All rights reserved.
@@ -268,31 +268,18 @@ Valid values are
.Dv DETACH_QUIET
(do not print a notice).
.Pp
-The autoconfiguration framework may call the driver's activate function
-to notify the driver of a change in the resources that have been
-allocated to it.
-For example, an Ethernet driver has to be notified if the network stack
-is being added or removed from the kernel.
-The first argument to the activate function
-.Fa self
-is a pointer to the driver's device structure.
-It is the same argument as passed to the attach function.
-The second argument
+The activate function is used by some buses to notify drivers from
+interrupt context when detachment is imminent, with
.Fa act
-describes the action.
-Valid actions are
-.Dv DVACT_ACTIVATE
-(activate the device) and
-.Dv DVACT_DEACTIVATE
-(deactivate the device).
+set to
+.Dv DVACT_DEACTIVATE .
+Currently only
+.Xr pcmcia 9
+and
+.Xr cardbus 9
+use this.
If the action is not supported the activate function should return
.Er EOPNOTSUPP .
-The
-.Dv DVACT_DEACTIVATE
-call will only be made if the
-.Dv DVACT_ACTIVATE
-call was successful.
-The activate function is called in interrupt context.
.Pp
Most drivers will want to make use of interrupt facilities.
Interrupt locators provided through the attachment structure should be
