From nobody Fri Aug 29 12:45:43 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 4cCyfv4JW1z65Sb4; Fri, 29 Aug 2025 12:45:43 +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 "R12" (verified OK)) by mx1.freebsd.org (Postfix) with ESMTPS id 4cCyfv3lpLz3Mfb; Fri, 29 Aug 2025 12:45:43 +0000 (UTC) (envelope-from git@FreeBSD.org) DKIM-Signature: v=1; a=rsa-sha256; c=relaxed/relaxed; d=freebsd.org; s=dkim; t=1756471543; 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=LOOuQeWeRK3k3QLBlsvrgHbmYPKVGzM29ho/4EdCKOw=; b=ux0OR3ZId2bXUP+owtroQeYU/OnWBO55nXCP3jj1TTEjY8tfZH4FBABXnKlJLnjqdKehbA 1BUcBNa9EZRHLvy29CeXL2Vw59+HVE/jSZ3ntwDxsjDdOPqKxLHGh6ry/ZQUiaXpifXaie WtAmTZ9Cr3alsDELxcZNO+BELkPSBnb1qjPkdRTRwPNPZ1ZS+o3EpKBdN3kxSxuNBdUy/K lScfqoU7NwgzH1NJ0vqv1zy5U7bKM3KVjtAARHu/ivIGX54WL+PnE4dA0dKR9PQT0LVBZ3 pKbPJNGMRizUBG5QqJzGJ91AEK4psezexUPAX2Oc+zWgSFNvNM9Kf79UOxmHOw== ARC-Message-Signature: i=1; a=rsa-sha256; c=relaxed/relaxed; d=freebsd.org; s=dkim; t=1756471543; 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=LOOuQeWeRK3k3QLBlsvrgHbmYPKVGzM29ho/4EdCKOw=; b=q0Xrd3tA46uCxcEx/7E5AleyCKw1+0KQyB9JhroStmi2syp1aO0DC6qtQPUK/hZ+zhNVEB ALs9azLBoor2N+1w7y7HCkxQsAuKu/guP6BqvuCxcGH1o6JSA+iB/yIqTLHON+G8hfFa6F ITRwedQnQFbToolbPrbofIWVJBgas59CGJvSth6zLJ476zW3ea7VyRKOgwSH2E5hEtefp9 91Wx4zpdZVpEh9HZQ1OEkvCtXukI2Jiie7tIrGvvi7PohNUAbxsqCSSDVYEzTnOZsSqO5t sDMioJTpGSSU/xPHf0p321l2nkbG9ugvFqqvz1ek+zgWbl526B0Rr1CzgAloWQ== ARC-Seal: i=1; s=dkim; d=freebsd.org; t=1756471543; a=rsa-sha256; cv=none; b=PqlbVvBgW/uVkw/cFrn90G16A0bTpXh3ibvamM2ES0sSuYuk2LjHEJU7POIwkMQunQoHkd AkJe5ayqeB7Sv4/zQY4zeNDiXDPlgEcsHGBuSh2PZ6c5La82PTeb67/PXbIYxawDUNL/bX wpdZLE1eqUPjCZRjaOAf1MPyKvTXBeiF/xl0qC6yKvGqo+f2dZUfFVYwTzT8B6sp7F0yah nWhV9msxGSExcG0nQSL2gOhJjXGj8MOlj/qLhXSMUZTfh4LaG+1wd/99tbv+PiuL3lPm/0 tQnyngWf8juUzAxs72tk3hT0ln9rqMgUTHxo1W3tA8Cw+aKX9KT2O25NGQWKug== 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 4cCyfv2mV2zgqZ; Fri, 29 Aug 2025 12:45:43 +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 57TCjhro013847; Fri, 29 Aug 2025 12:45:43 GMT (envelope-from git@gitrepo.freebsd.org) Received: (from git@localhost) by gitrepo.freebsd.org (8.18.1/8.18.1/Submit) id 57TCjh10013844; Fri, 29 Aug 2025 12:45:43 GMT (envelope-from git) Date: Fri, 29 Aug 2025 12:45:43 GMT Message-Id: <202508291245.57TCjh10013844@gitrepo.freebsd.org> To: src-committers@FreeBSD.org, dev-commits-src-all@FreeBSD.org, dev-commits-src-main@FreeBSD.org From: Alexander Ziaee Subject: git: 7e477aac8008 - main - devinfo.8: Polish 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: ziaee X-Git-Repository: src X-Git-Refname: refs/heads/main X-Git-Reftype: branch X-Git-Commit: 7e477aac8008f0de7495715cebf2a7d665679139 Auto-Submitted: auto-generated The branch main has been updated by ziaee: URL: https://cgit.FreeBSD.org/src/commit/?id=7e477aac8008f0de7495715cebf2a7d665679139 commit 7e477aac8008f0de7495715cebf2a7d665679139 Author: Alexander Ziaee AuthorDate: 2025-08-28 20:15:03 +0000 Commit: Alexander Ziaee CommitDate: 2025-08-29 12:43:29 +0000 devinfo.8: Polish + replace "-*- nroff -*-" comment with SPDX tag + alphabetize options in SYNOPSIS and DESCRIPTION + add HISTORY, correct two minor mdoc typos MFC after: 3 days Reviewed by: imp Closes: https://github.com/freebsd/freebsd-src/pull/1829 --- usr.sbin/devinfo/devinfo.8 | 29 ++++++++++++++++++----------- 1 file changed, 18 insertions(+), 11 deletions(-) diff --git a/usr.sbin/devinfo/devinfo.8 b/usr.sbin/devinfo/devinfo.8 index f782b919056c..15a6059c166f 100644 --- a/usr.sbin/devinfo/devinfo.8 +++ b/usr.sbin/devinfo/devinfo.8 @@ -1,4 +1,5 @@ -.\" -*- nroff -*- +.\" +.\" SPDX-License-Identifer: BSD-2-Clause .\" .\" Copyright (c) 2002 Hiten Pandya .\" Copyright (c) 2002 Robert N. M. Watson @@ -25,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 29, 2025 +.Dd August 28, 2025 .Dt DEVINFO 8 .Os .Sh NAME @@ -35,9 +36,9 @@ .Nm .Op Fl rv .Nm -.Fl u Op Fl v -.Nm .Fl p Ar dev Op Fl v +.Nm +.Fl u Op Fl v .Sh DESCRIPTION The .Nm @@ -46,11 +47,16 @@ in the system, starting from the .Dq nexus device. .Pp -The following options are accepted. +The following options are accepted: .Bl -tag -width indent +.It Fl p Ar dev +Display the path of +.Ar dev +back to the root of the device tree. .It Fl r -Causes hardware resource information (such as IRQ, I/O ports, I/O memory -addresses) to be also listed, under each device that has reserved those resources. +Causes hardware resource information +.Pq such as IRQ, I/O ports, I/O memory addresses +to be also listed, under each device that has reserved those resources. .It Fl u Displays the same information as with .Fl r @@ -63,10 +69,6 @@ Display all devices in the driver tree, not just those that are attached or busy. Without this flag, only those devices that have attached are reported. This flag also displays verbose information about each device. -.It Fl p Ar dev -Display the path of -.Ar dev -back to the root of the device tree. .El .Sh SEE ALSO .Xr systat 1 , @@ -77,5 +79,10 @@ back to the root of the device tree. .Xr vmstat 8 , .Xr devclass 9 , .Xr device 9 +.Sh HISTORY +The +.Nm +utility appeared in +.Fx 5.0 . .Sh AUTHORS .An Mike Smith Aq Mt msmith@FreeBSD.org