The branch main has been updated by jhb:
URL:
https://cgit.FreeBSD.org/src/commit/?id=4f711f9085b82988cf3ed464ec0bb842d39d4e5a
commit 4f711f9085b82988cf3ed464ec0bb842d39d4e5a
Author: John Baldwin <j...@freebsd.org>
AuthorDate: 2025-02-05 19:48:29 +0000
Commit: John Baldwin <j...@freebsd.org>
CommitDate: 2025-02-05 19:48:51 +0000
bus_generic_detach.9: Update for new semantics
bus_generic_detach now deletes children after detaching them.
Reviewed by: ziaee
Differential Revision: https://reviews.freebsd.org/D48371
---
share/man/man9/bus_generic_detach.9 | 18 ++++++++++++++----
1 file changed, 14 insertions(+), 4 deletions(-)
diff --git a/share/man/man9/bus_generic_detach.9
b/share/man/man9/bus_generic_detach.9
index 590cd26486e4..b7a2aa6e6105 100644
--- a/share/man/man9/bus_generic_detach.9
+++ b/share/man/man9/bus_generic_detach.9
@@ -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 January 15, 2017
+.Dd February 5, 2025
.Dt BUS_GENERIC_DETACH 9
.Os
.Sh NAME
@@ -44,13 +44,23 @@ This function provides an implementation of the
.Xr DEVICE_DETACH 9
method
which can be used by most bus code.
-It simply calls the
-.Xr DEVICE_DETACH 9
-method of each child device attached to the bus.
+It uses
+.Xr bus_detach_children 9
+to detach drivers from all child devices giving them a chance to veto the
+detach request.
+If
+.Fn bus_detach_children
+succeeds,
+.Fn bus_generic_detach
+calls
+.Xr device_delete_children 9
+to delete all child devices.
.Sh RETURN VALUES
Zero is returned on success, otherwise an appropriate error is returned.
.Sh SEE ALSO
+.Xr bus_detach_children 9 ,
.Xr device 9 ,
+.Xr device_delete_children 9 ,
.Xr driver 9
.Sh AUTHORS
This manual page was written by
