[src/trunk]: src/share/man/man9 driver(9): Correct paragraph about the driver...

[riastradh <riastradh%NetBSD.org@localhost>]

details:   https://anonhg.NetBSD.org/src/rev/f9338a321c03
branches:  trunk
changeset: 361129:f9338a321c03
user:      riastradh <riastradh%NetBSD.org@localhost>
date:      Fri Feb 11 23:19:43 2022 +0000

description:
driver(9): Correct paragraph about the driver activate function.

diffstat:

 share/man/man9/driver.9 |  33 ++++++++++-----------------------
 1 files changed, 10 insertions(+), 23 deletions(-)

diffs (50 lines):

diff -r e1947ecab5de -r f9338a321c03 share/man/man9/driver.9
--- a/share/man/man9/driver.9   Fri Feb 11 23:19:34 2022 +0000
+++ b/share/man/man9/driver.9   Fri Feb 11 23:19:43 2022 +0000
@@ -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 @@
 .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