From nobody Mon Mar 3 16:57:01 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 4Z64jV1BSyz5pnRl; Mon, 03 Mar 2025 16:57:02 +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 "R10" (verified OK)) by mx1.freebsd.org (Postfix) with ESMTPS id 4Z64jT6gRQz4694; Mon, 03 Mar 2025 16:57:01 +0000 (UTC) (envelope-from git@FreeBSD.org) DKIM-Signature: v=1; a=rsa-sha256; c=relaxed/relaxed; d=freebsd.org; s=dkim; t=1741021022; 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=poGNCMLIo1X1T/RQRYBlFRe4veJZvDd+RhKeeKJIRqM=; b=O2bR+m0BQhesvYv1EmZKsaI6D5SgdNKdl6MNY7i6VzyJFODlFf8DqxnLDabtgceu5Mh9DX bHV4GG9iPCGaqOOkEOb7rCuSRL2RDpXfuis+P4Gi2ti6dcT0A5c20anUJh64zdZZ6UY89m IN0fNJZqWCp9+d0gN+SYxEj4wQEEYrErS91LUgeu70ygHciD4rN6J3BxCl02n8aE/uJUeL ykcSeys6pJWOdzlGyBm8a3Vc5kGl3uN8FcGEjBYwAC9mWQrnZxtbCEnr8WT8ErrUbuhnVY J010VLmWymousdXeI8wINsjVfHAjirfqA9V5nB6rrRJbGFDl7TzeLsLJk1z4Ew== ARC-Seal: i=1; s=dkim; d=freebsd.org; t=1741021022; a=rsa-sha256; cv=none; b=m6psRAtiKGxSPKyvH0zGCOPtO8pYqh/fA9o1iN+TMWIN2caA+SvygBQv+tb0p3dZ5wDhVp MmweqWc/ivdgvXBCI+24Ettk4uIPZ/TI8dstE71havw4L58IXWA9AOXXII+16poD8z1F2F 7dD9xPQjsff++dgahgPtqGRi4b+DXkfs3jS+IoOjYXQNuhjzrFz7jb5G0Kr425K1x/WMfQ Mcp4GQXv3+Ge/wqBqtcx4Klsim+z1AaE8RXVFj1UK6MGabiA46glbaloquHHjYx2R1v460 M3qh0PqbpoJ/wv+vyCm4g0QBLkEAr+ilnzIs6UQ8sc3rib15Beu6nTRxSNOsBw== ARC-Authentication-Results: i=1; mx1.freebsd.org; none ARC-Message-Signature: i=1; a=rsa-sha256; c=relaxed/relaxed; d=freebsd.org; s=dkim; t=1741021022; 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=poGNCMLIo1X1T/RQRYBlFRe4veJZvDd+RhKeeKJIRqM=; b=auwExUbSgzQ6P0shqQXkXKY6T2TDl5Xn2y9oFhUzgetljTSWLze0nUfl3UpzcUQg3pgOr9 E4LefH6b3so4nQrImHPyTMKcqZmfedFPEdy5HxXJAS7ZjI1MG7W1ufa0dB4cnByDCvLUg+ HB6O0xmvNKgP1kKCm1IgIblGfBzStfqizdtobD+28Y3v/arV8kSyYupg+QY0JZ/k61DRV8 S5VE5sSNeM03K5QvcUP5gwFIRrTPki2hKfxQhzabjVzOMEVNoKP0wQT2EymRHJKZDcF7Ai Zkx9mlGETGqpNjd0eHp1T8m2QSQIa5lanWJhD8Kt+0UMTz7kMRd4JKrspAASUg== 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 4Z64jT5wyMzwZc; Mon, 03 Mar 2025 16:57:01 +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 523Gv12r083801; Mon, 3 Mar 2025 16:57:01 GMT (envelope-from git@gitrepo.freebsd.org) Received: (from git@localhost) by gitrepo.freebsd.org (8.18.1/8.18.1/Submit) id 523Gv1bA083798; Mon, 3 Mar 2025 16:57:01 GMT (envelope-from git) Date: Mon, 3 Mar 2025 16:57:01 GMT Message-Id: <202503031657.523Gv1bA083798@gitrepo.freebsd.org> To: src-committers@FreeBSD.org, dev-commits-src-all@FreeBSD.org, dev-commits-src-branches@FreeBSD.org From: John Baldwin Subject: git: 0960dc0d5bf4 - stable/14 - BUS_HINTED_CHILD.9: New manpage to document this bus method 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/stable/14 X-Git-Reftype: branch X-Git-Commit: 0960dc0d5bf4f8e4c432a67a995104584bc1c940 Auto-Submitted: auto-generated The branch stable/14 has been updated by jhb: URL: https://cgit.FreeBSD.org/src/commit/?id=0960dc0d5bf4f8e4c432a67a995104584bc1c940 commit 0960dc0d5bf4f8e4c432a67a995104584bc1c940 Author: John Baldwin AuthorDate: 2025-01-16 15:51:44 +0000 Commit: John Baldwin CommitDate: 2025-03-03 16:56:20 +0000 BUS_HINTED_CHILD.9: New manpage to document this bus method Reviewed by: ziaee, imp Differential Revision: https://reviews.freebsd.org/D48366 (cherry picked from commit 4276dfa8c4b9e75ab29f2c53a7af36c2f77ab563) --- share/man/man9/BUS_HINTED_CHILD.9 | 36 ++++++++++++++++++++++++++++++++++++ share/man/man9/Makefile | 1 + 2 files changed, 37 insertions(+) diff --git a/share/man/man9/BUS_HINTED_CHILD.9 b/share/man/man9/BUS_HINTED_CHILD.9 new file mode 100644 index 000000000000..699bb06e8dd8 --- /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 +.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 index fdfdb2e888d9..7d06be6eb6a0 100644 --- a/share/man/man9/Makefile +++ b/share/man/man9/Makefile @@ -47,6 +47,7 @@ MAN= accept_filter.9 \ 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 \