D48366.id149012.diff
No OneTemporary
Actions

Size

1 KB

Referenced Files

None

Subscribers

None

D48366.id149012.diff
View Options

	diff --git a/share/man/man9/BUS_HINTED_CHILD.9 b/share/man/man9/BUS_HINTED_CHILD.9
	new file mode 100644
	--- /dev/null
	+++ b/share/man/man9/BUS_HINTED_CHILD.9
	@@ -0,0 +1,36 @@
	+.\"
	+.\" SPDX-License-Identifier: BSD-2-Clause
	+.\"
	+.\" Copyright (c) 2025 John Baldwin <jhb@FreeBSD.org>
	+.Dd January 6, 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 device 9
	+.Sh HISTORY
	+The
	+.Fn BUS_HINTED_CHILD
	+method first appeared in
	+.Fx 6.2 .
	diff --git a/share/man/man9/Makefile b/share/man/man9/Makefile
	--- a/share/man/man9/Makefile
	+++ b/share/man/man9/Makefile
	@@ -47,6 +47,7 @@
	BUS_GET_CPUS.9 \
	BUS_GET_PROPERTY.9 \
	bus_get_resource.9 \
	+ BUS_HINTED_CHILD.9 \
	bus_map_resource.9 \
	BUS_NEW_PASS.9 \
	BUS_PRINT_CHILD.9 \