From nobody Wed Feb 5 19:49:52 2025 X-Original-To: dev-commits-src-all@mlmmj.nyi.freebsd.org Received: from mx1.freebsd.org (mx1.freebsd.org [IPv6:2610:1c1:1:606c::19:1]) by mlmmj.nyi.freebsd.org (Postfix) with ESMTP id 4Yp9mw45cdz5mHhG; Wed, 05 Feb 2025 19:49:52 +0000 (UTC) (envelope-from git@FreeBSD.org) Received: from mxrelay.nyi.freebsd.org (mxrelay.nyi.freebsd.org [IPv6:2610:1c1:1:606c::19:3]) (using TLSv1.3 with cipher TLS_AES_256_GCM_SHA384 (256/256 bits) key-exchange X25519 server-signature RSA-PSS (4096 bits) server-digest SHA256 client-signature RSA-PSS (4096 bits) client-digest SHA256) (Client CN "mxrelay.nyi.freebsd.org", Issuer "R11" (verified OK)) by mx1.freebsd.org (Postfix) with ESMTPS id 4Yp9mw2SqCz3vDT; Wed, 05 Feb 2025 19:49:52 +0000 (UTC) (envelope-from git@FreeBSD.org) DKIM-Signature: v=1; a=rsa-sha256; c=relaxed/relaxed; d=freebsd.org; s=dkim; t=1738784992; h=from:from:reply-to:subject:subject:date:date:message-id:message-id: to:to:cc:mime-version:mime-version:content-type:content-type: content-transfer-encoding:content-transfer-encoding; bh=/jUARQrsCrFykSro1C3HTMHz/f94RMDmePB/K5UTU2E=; b=Kn6gad4Jrsa09htAKQNo4MbbOv6biB+5C16jvmG/M6l3/qwEKZi+lm6NaqXZp5CnAkB02Y 0oMjJsudF8b9OYKQd58xgPL2kQkpatLT2cSVjx6aw7K8miyh6GUcRPc7HVMxv3yZb7gSEs z1y0XJkpszVulrLRPcsPY8Plzj/5V14ergdTH97upjNpFJzfiMw2dLL8+NMUtl6x+QnhWF lNVGxhAKYRisCGy4JG7aex6qBMlLfJ4sp+eZXFQN3dYDKF+nLzlPIYaTG0u/9j+VlHiGVN Ao5AgFpH8OOPDy3o5WNZ1DSErU4ldho0OS8WlCZA2LCN0sTmc3+PkPIn0N7qVg== ARC-Message-Signature: i=1; a=rsa-sha256; c=relaxed/relaxed; d=freebsd.org; s=dkim; t=1738784992; h=from:from:reply-to:subject:subject:date:date:message-id:message-id: to:to:cc:mime-version:mime-version:content-type:content-type: content-transfer-encoding:content-transfer-encoding; bh=/jUARQrsCrFykSro1C3HTMHz/f94RMDmePB/K5UTU2E=; b=fV+fSdKHBBSJTtgErzi5BuSaTqDrc0ritdo7xmEr5vwxuhsQGrucUg+wMvW2ZGVzBrkd4a TZWa3zIO2K19MP4Ry7uvwczvEuzNxFd1c1VCmu/Qyp3yLxQ1gTX+hQhVR4h1ydlphNhPDE a6xqvSbuegzFNcjSNB7vg4E3WJ8IJ1jRDqVcESG8j6AGoXo3ZJM4saSDE9Vu4TIoQQspZi 9Il5FwouxZhoBRfP61tEndP4x6Bxi1iUZryrZ54fmT30ny7rzcAJb9nEABETYwJ8PwCDYR 8hJECj3g/opppaxckq8bz0WCVeim090Uf/W5Rn/fgnbnxx51RoeV6Qnr1TsrWg== ARC-Seal: i=1; s=dkim; d=freebsd.org; t=1738784992; a=rsa-sha256; cv=none; b=OVE/c8E3QHRGmVHOajNd2DW14cax3zwaQlV1tXYVduHGM/aci3awbZJTknc7a/6+dsvxVQ bN0Pu6WRJD6InKXhb4YJ1GftxZqK+RQVTsM7GNGKol7ss2+lExeCvHsXAmz4V19CXqwOTN IuaFraQmaeCftXeRdym+hXoTNY++SNQXya3nIT+58RHBqX0Yw6qTEIpLEqDAIBCvZuWG+6 IyOJRsp5QWSK9OUqyiyD/cHWQdOjl2wp7Rr6hvHBVvSy5Tm61t63Vc8GRcDa8o+BQoEGju kIIHiCAiT/768XLP2T5M7w4WsFspGaqrSwiVbJj0bI5PacDPlbd2FcyM/Fs0Kg== ARC-Authentication-Results: i=1; mx1.freebsd.org; none Received: from gitrepo.freebsd.org (gitrepo.freebsd.org [IPv6:2610:1c1:1:6068::e6a:5]) (using TLSv1.3 with cipher TLS_AES_256_GCM_SHA384 (256/256 bits) key-exchange X25519 server-signature RSA-PSS (4096 bits) server-digest SHA256) (Client did not present a certificate) by mxrelay.nyi.freebsd.org (Postfix) with ESMTPS id 4Yp9mw24ZHz14t6; Wed, 05 Feb 2025 19:49:52 +0000 (UTC) (envelope-from git@FreeBSD.org) Received: from gitrepo.freebsd.org ([127.0.1.44]) by gitrepo.freebsd.org (8.18.1/8.18.1) with ESMTP id 515JnqLq070386; Wed, 5 Feb 2025 19:49:52 GMT (envelope-from git@gitrepo.freebsd.org) Received: (from git@localhost) by gitrepo.freebsd.org (8.18.1/8.18.1/Submit) id 515Jnq8R070383; Wed, 5 Feb 2025 19:49:52 GMT (envelope-from git) Date: Wed, 5 Feb 2025 19:49:52 GMT Message-Id: <202502051949.515Jnq8R070383@gitrepo.freebsd.org> To: src-committers@FreeBSD.org, dev-commits-src-all@FreeBSD.org, dev-commits-src-main@FreeBSD.org From: John Baldwin Subject: git: 4f711f9085b8 - main - bus_generic_detach.9: Update for new semantics List-Id: Commit messages for all branches of the src repository List-Archive: https://lists.freebsd.org/archives/dev-commits-src-all List-Help: List-Post: List-Subscribe: List-Unsubscribe: X-BeenThere: dev-commits-src-all@freebsd.org Sender: owner-dev-commits-src-all@FreeBSD.org MIME-Version: 1.0 Content-Type: text/plain; charset=utf-8 Content-Transfer-Encoding: 8bit X-Git-Committer: jhb X-Git-Repository: src X-Git-Refname: refs/heads/main X-Git-Reftype: branch X-Git-Commit: 4f711f9085b82988cf3ed464ec0bb842d39d4e5a Auto-Submitted: auto-generated The branch main has been updated by jhb: URL: https://cgit.FreeBSD.org/src/commit/?id=4f711f9085b82988cf3ed464ec0bb842d39d4e5a commit 4f711f9085b82988cf3ed464ec0bb842d39d4e5a Author: John Baldwin AuthorDate: 2025-02-05 19:48:29 +0000 Commit: John Baldwin 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