kgess-mirror/freebsd-src
1
0
Fork 0
mirror of https://git.freebsd.org/src.git synced 2026-01-16 23:02:24 +00:00
Code Issues Projects Releases Packages Wiki Activity Actions 2

device_delete_child.9: Reference device_detach.9 and BUS_CHILD_DELETED.9

Browse source 
Refer to device_detach(9) for the description of detaching a device.
Note that descendants of the child device are also deleted (though in
theory a proper detach routine should have already deleted these).
Finally, note that BUS_CHILD_DELETED(9) is invoked on each deleted
device.

Differential Revision:	https://reviews.freebsd.org/D48365
This commit is contained in:
John Baldwin 2025-02-05 14:45:54 -05:00
parent d7fa71dfed
commit 3f93f96c26
1 changed files with 18 additions and 5 deletions
Show stats Download patch file Download diff file Expand all files Collapse all files

23
share/man/man9/device_delete_child.9
View file

@ -26,7 +26,7 @@
.\" (INCLUDING NEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY OUT OF THE USE OF
.\" THIS SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF SUCH DAMAGE.
.\"
.Dd June 16, 1998
.Dd February 5, 2025
.Dt DEVICE_DELETE_CHILD 9
.Os
.Sh NAME
@ -41,13 +41,26 @@
The specified device is removed from
.Fa dev
and deleted.
If the device is currently attached, it is first detached (see
.Xr DEVICE_ATTACH 9
and
.Xr DEVICE_DETACH 9 ) .
If the device is currently attached, it is first detached via
.Xr device_detach 9 .
If
.Fn device_detach
fails,
its error value is returned.
Otherwise,
all descendant devices of
.Fa child
are deleted and zero is returned.
.Pp
The
.Xr BUS_CHILD_DELETED 9
method is invoked for each device that is deleted.
This permits the parent device's driver to tear down any state associated
with child devices such as ivars.
.Sh RETURN VALUES
Zero is returned on success, otherwise an error is returned.
.Sh SEE ALSO
.Xr BUS_CHILD_DELETED 9 ,
.Xr device_add_child 9
.Sh AUTHORS
This manual page was written by