summaryrefslogtreecommitdiff
path: root/static/freebsd/man9/BUS_HINTED_CHILD.9
blob: 860ee3a995e386c09e7b4090c210609485c4fb0f (plain)
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
.\"
.\" SPDX-License-Identifier: BSD-2-Clause
.\"
.\" Copyright (c) 2025 John Baldwin <jhb@FreeBSD.org>
.Dd February 5, 2025
.Dt BUS_HINTED_CHILD 9
.Os
.Sh NAME
.Nm BUS_HINTED_CHILD
.Nd notify a bus device about a potential child device identified by hints
.Sh SYNOPSIS
.In sys/param.h
.In sys/bus.h
.Ft void
.Fn BUS_HINTED_CHILD "device_t dev" "const char *dname" "int dunit"
.Sh DESCRIPTION
The
.Fn BUS_HINTED_CHILD
method is invoked by the
.Xr bus_enumerate_hinted_children 9
function for each set of named hints whose
.Dq at
hint matches the bus device
.Fa dev .
Typically, this method should determine if the set of hints for the given
device name and unit sufficiently describe a new device.
If so, a new device should be added via
.Xr BUS_ADD_CHILD 9 .
.Sh SEE ALSO
.Xr BUS_ADD_CHILD 9 ,
.Xr bus_enumerate_hinted_children 9 ,
.Xr device 9
.Sh HISTORY
The
.Fn BUS_HINTED_CHILD
method first appeared in
.Fx 6.2 .