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