Improve the descriptions of the detach and activate/deactivate interfaces.
This commit is contained in:
parent
d9e921bd84
commit
f599563f29
|
@ -1,4 +1,4 @@
|
||||||
.\" $NetBSD: autoconf.9,v 1.5 2001/09/13 21:41:01 briggs Exp $
|
.\" $NetBSD: autoconf.9,v 1.6 2001/10/18 19:35:25 gmcgarry Exp $
|
||||||
.\"
|
.\"
|
||||||
.\" Copyright (c) 2001 The NetBSD Foundation, Inc.
|
.\" Copyright (c) 2001 The NetBSD Foundation, Inc.
|
||||||
.\" All rights reserved.
|
.\" All rights reserved.
|
||||||
|
@ -224,12 +224,26 @@ detachment (eg. because of hardware removal) and DETACH_QUIET (do not
|
||||||
print a notice).
|
print a notice).
|
||||||
.Fn config_detach
|
.Fn config_detach
|
||||||
returns zero if successful and an error code otherwise.
|
returns zero if successful and an error code otherwise.
|
||||||
|
.Fn config_detach
|
||||||
|
is always called from a thread context, allowing
|
||||||
|
.Xr sleep 9
|
||||||
|
to be called while the device detaches itself.
|
||||||
.It Fn config_activate "dev"
|
.It Fn config_activate "dev"
|
||||||
Called by the parent to activate the child device
|
Called by the parent to activate the child device
|
||||||
.Fa dev .
|
.Fa dev .
|
||||||
|
It is called to activate resources and initialise other kernel
|
||||||
|
subsystems (such as the network subsystem).
|
||||||
|
.Fn config_activate
|
||||||
|
is called from interrupt contect after the device has been attached.
|
||||||
.It Fn config_deactivate "dev"
|
.It Fn config_deactivate "dev"
|
||||||
Called by the parent to deactivate the child device
|
Called by the parent to deactivate the child device
|
||||||
.Fa dev .
|
.Fa dev .
|
||||||
|
.Fn config_deactivate
|
||||||
|
is called from interrupt context to immediately relinquish resources
|
||||||
|
and notify dependent kernel subsystems that the device is about to be
|
||||||
|
detached. At some later point
|
||||||
|
.Fn config_detach
|
||||||
|
will be called to finalise the removal of the device.
|
||||||
.It Fn config_defer "dev" "func"
|
.It Fn config_defer "dev" "func"
|
||||||
Called by the child to defer the remainder of its configuration until
|
Called by the child to defer the remainder of its configuration until
|
||||||
all its parent's devices have been attached. At this point, the
|
all its parent's devices have been attached. At this point, the
|
||||||
|
@ -275,5 +289,5 @@ Autoconfiguration first appeared in
|
||||||
.Bx 4.1 .
|
.Bx 4.1 .
|
||||||
The autoconfiguration framework was completely revised in
|
The autoconfiguration framework was completely revised in
|
||||||
.Bx 4.4 .
|
.Bx 4.4 .
|
||||||
The detach and activate interfaces appeared in
|
The detach and activate/deactivate interfaces appeared in
|
||||||
.Nx 1.5 .
|
.Nx 1.5 .
|
||||||
|
|
Loading…
Reference in New Issue