From nobody Thu Jul 25 04:49:03 2024 X-Original-To: dev-commits-src-main@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 4WTz1W2grZz5RFgp; Thu, 25 Jul 2024 04:49:03 +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 4WTz1W1Jpjz4WwZ; Thu, 25 Jul 2024 04:49:03 +0000 (UTC) (envelope-from git@FreeBSD.org) DKIM-Signature: v=1; a=rsa-sha256; c=relaxed/relaxed; d=freebsd.org; s=dkim; t=1721882943; 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=4toVWPwWMfyik/CkKV7cSVeVnnAAfiz99xwSpWNG6cs=; b=oEZPbENZ+qhE6zv7XZcLisxAqqoW23gJFuIOVF1pkCIhLCRtaZjv7ZD4/JoD5p1sZp7fAJ 7YXqcmlc2yngB8+/LCM34t/HtJ1Ab0FU//NUDq3wJkOoy8JVJIWOETUcHsc8T5iM0u/Wwg 7Y+cM/6aJQ8DY7fLmWY4xVsWDmpsEGBQ8Jx0KncmpUr9s7tbwKkNRLwifPnWqq7+2Neosl au+XJcZnGg69uWsElPpemQ249rg1VW8kzmDYFf46qdIyBR2VFERLJQzziGM3jOqnoDoU/b UcryoSSTbrwbicrIAkEu2BrJXczSwcLQl4CEzHr8X7LEgVVgBcrVKXVz3RIxbA== ARC-Seal: i=1; s=dkim; d=freebsd.org; t=1721882943; a=rsa-sha256; cv=none; b=q4R45XwxhnsHR3eO5GH1Qu3rjeVt2Ai+QpZI6I0a4NFWiQvdCBiJdmsEz8IGgLGP4cE2mH sviu+0nhpfZocKgKUEm3RJnWl2sv5H2EnbuA4+8rL8Yeid6FTFKdjrEYoiPDX46imLf3KM fWXfYUiYhqcGdybbl2DnA3UKeScgT9GdlFCHnn+KjE+Ok7CoLFRVG8aA1VsXSwoeslWiwn SPZXLsFgAr8HYJOE2x0gUZBOCrfQ2f1bQJ2+YHV4RfTeTquT+WRlyBCcWmAbcw0kM6Eu4Z oF9cpqzsa80fkVGgOBr0LWYZqySwXZFyt7wZ//MIVqZMmld41V7EHrxoVYX1eQ== 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=1721882943; 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=4toVWPwWMfyik/CkKV7cSVeVnnAAfiz99xwSpWNG6cs=; b=HZoIg3MQUY0kmNmZbvKK5DE7jsLS1zl6aKTo37yWj3T9nYcPvrlws4yhy6y7YnJtORiF0u tgkXKwtg+ccVZ3NEGo2WK5NcXIW91qzciVeV7YOXkf/ib43rF63PBpjkCCySmx5EfDR+MJ ITXjehA/fxhfcA7+jLza/eGOdfWgp3peZPdcgZBTO6BLspVqyVgmY08/MnZFwy5tpahkSf JAQ+Ndi7T4Vsg/gzeiWUgSdSBdM+ukaxf8oT3o724e0/XDeZRHm/lVeojE5JoA3f77meqQ TBqEVULBdV3V6A4GxwQTaskcNn+dWkS40W9V0sJ/yoX5kewBzDkkM+hV5b89PA== 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 4WTz1W0x79zgSK; Thu, 25 Jul 2024 04:49:03 +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 46P4n34e031952; Thu, 25 Jul 2024 04:49:03 GMT (envelope-from git@gitrepo.freebsd.org) Received: (from git@localhost) by gitrepo.freebsd.org (8.18.1/8.18.1/Submit) id 46P4n3I1031949; Thu, 25 Jul 2024 04:49:03 GMT (envelope-from git) Date: Thu, 25 Jul 2024 04:49:03 GMT Message-Id: <202407250449.46P4n3I1031949@gitrepo.freebsd.org> To: src-committers@FreeBSD.org, dev-commits-src-all@FreeBSD.org, dev-commits-src-main@FreeBSD.org From: Warner Losh Subject: git: 29d13f3d06de - main - newbus: Document new DEVICE_UNIT_ANY List-Id: Commit messages for the main branch of the src repository List-Archive: https://lists.freebsd.org/archives/dev-commits-src-main List-Help: List-Post: List-Subscribe: List-Unsubscribe: X-BeenThere: dev-commits-src-main@freebsd.org Sender: owner-dev-commits-src-main@FreeBSD.org MIME-Version: 1.0 Content-Type: text/plain; charset=utf-8 Content-Transfer-Encoding: 8bit X-Git-Committer: imp X-Git-Repository: src X-Git-Refname: refs/heads/main X-Git-Reftype: branch X-Git-Commit: 29d13f3d06dec06a2fc9636ca8308c0462f80cfc Auto-Submitted: auto-generated The branch main has been updated by imp: URL: https://cgit.FreeBSD.org/src/commit/?id=29d13f3d06dec06a2fc9636ca8308c0462f80cfc commit 29d13f3d06dec06a2fc9636ca8308c0462f80cfc Author: Warner Losh AuthorDate: 2024-07-25 04:22:55 +0000 Commit: Warner Losh CommitDate: 2024-07-25 04:22:55 +0000 newbus: Document new DEVICE_UNIT_ANY In the past, device_add_child took a -1 to mean any unit. Document it now taking DEVICE_UNIT_ANY. Sponsored by: Netflix --- share/man/man9/device_add_child.9 | 4 ++-- 1 file changed, 2 insertions(+), 2 deletions(-) diff --git a/share/man/man9/device_add_child.9 b/share/man/man9/device_add_child.9 index 423869d6ff6b..dfd0d19049bc 100644 --- a/share/man/man9/device_add_child.9 +++ b/share/man/man9/device_add_child.9 @@ -51,7 +51,7 @@ arguments specify the name and unit number of the device. If the name is unknown then the caller should pass .Dv NULL . If the unit is unknown then the caller should pass -.Dv -1 +.Dv DEVICE_UNIT_ANY and the system will choose the next available unit number. .Pp The name of the device is used to determine which drivers might be @@ -70,7 +70,7 @@ be specified as the device name. .Pp Normally unit numbers will be chosen automatically by the system and a unit number of -.Dv -1 +.Dv DEVICE_UNIT_ANY should be given. When a specific unit number is desired (e.g.,\& for wiring a particular piece of hardware to a pre-configured unit number), that unit should