From nobody Tue Sep 22 11:16:23 2026 X-Original-To: dev-commits-src-branches@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 4hpyGH6Q4Zz6tXL7 for ; Tue, 22 Sep 2026 11:16:23 +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 "YR2" (not verified)) by mx1.freebsd.org (Postfix) with ESMTPS id 4hpyGH5sr3z3K1g for ; Tue, 22 Sep 2026 11:16:23 +0000 (UTC) (envelope-from git@FreeBSD.org) DKIM-Signature: v=1; a=rsa-sha256; c=relaxed/relaxed; d=freebsd.org; s=dkim; t=1790075783; 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=J1ojAHoC0QlYDqIg+ugrQpN64GOuCguwdY6HkYY8Vc0=; b=UuvcceVtVPk7sihx7JHtfc6W75sUN17M4YmPs6DVfoZ3AK9X3+LZt5ERVHgE0kE9pDYqV9 usl+c5l36IhFhb35Zk+CgJJpOikkEq6UAW0GYP4xCsWxxUyc/5ShQpFOrDEzft03b+iMPL YE18eyZsd+Dxf14ma4ZlWWEfDT68H/Ttj0exBrZM1GsomZi5AHCuyU7HWP74VvBgT/Fh8m l0G6BkLVsgDikY+3SLNLxHq65k8TO9ij+b7+wSr2iBrJKtgFSqj5uRnGowybQeq5CDsyxS avkm+6C9CBn2k6R/oIJ0pURo3a5XtK1VCn/QHtBUvsZuXYBtJMZH8WBh445KnA== ARC-Seal: i=1; a=rsa-sha256; d=freebsd.org; s=dkim; cv=none; t=1790075783; b=Rc6vD3hvUMSuGjcqn5KlXCLT5FtB6iX6kMxs/FOmag+jP/IS1nbhHEk8H6+ArlJPARSUoq CqK06fpD/4jlwukW7uzbON3k6nJ940lidXWrrPhth6xDQglZh7tlRFOJ1jwOhPbScA2Fpg R3Df4EP/kT558lNBxM1uF8D+/7n2+2A1v0P20+MSY+1g2zw/WkscHhFPp6Gbf5OTRVB4/6 a24BWn7gCz9AgYprQogiwTYTDcMJ7f7F4o92h5pvDSaSdNREu73AJKrN0PaE1WbBtmzxHJ bj7GwNYnOXJA0M/McjwEIzCmYn52E/iR0IEMBkGdHeOwWN2rLz/XkcO+9YLWqw== ARC-Message-Signature: i=1; a=rsa-sha256; c=relaxed/relaxed; d=freebsd.org; s=dkim; t=1790075783; 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=J1ojAHoC0QlYDqIg+ugrQpN64GOuCguwdY6HkYY8Vc0=; b=teUMY5cid0RBQEWLQQ9Miow99LoQFWWxlgUTieLmsrQl0azMQIuprZ1RrIv7cHTheTi6MX SIQw6P+LnKBT8kMqLM9+48PO6qwXkacIf9yC6665riphTUU4iwj7QnImlLBdSEvhHxbSs2 4K74HtQJYdMLlSG/nURJHjrv5HM0gsvmyM3il/uG/wsw6w6xw/mfxLD11Oj8Khy8r2Touo V56QQaeM1gTsBay/ycmqux3or+YoBNAqUoscZieiHs8o/tGQ3vlGOd/wVk5TOachw4iNrB GZTtfwtL/ZE8b1EsntjP0/Iz/KvIADqgaI7KBpzvVjavLLhAe3LDi2k4zWNRrA== ARC-Authentication-Results: i=1; mx1.freebsd.org; none Received: from gitrepo.freebsd.org (gitrepo.freebsd.org [IPv6:2610:1c1:1:6068::e6a:5]) by mxrelay.nyi.freebsd.org (Postfix) with ESMTP id 4hpyGH4c5Sz14Yj for ; Tue, 22 Sep 2026 11:16:23 +0000 (UTC) (envelope-from git@FreeBSD.org) Received: from git (uid 1279) (envelope-from git@FreeBSD.org) id 4061c by gitrepo.freebsd.org (DragonFly Mail Agent v0.13+ on gitrepo.freebsd.org); Tue, 22 Sep 2026 11:16:23 +0000 To: src-committers@FreeBSD.org, dev-commits-src-all@FreeBSD.org, dev-commits-src-branches@FreeBSD.org From: Mateusz Piotrowski <0mp@FreeBSD.org> Subject: git: 36f268e8e737 - stable/15 - dtrace_pid.4: Add example "Listing Program's Function Entries" List-Id: Commits to the stable branches of the FreeBSD src repository List-Archive: https://lists.freebsd.org/archives/dev-commits-src-branches List-Help: List-Post: List-Subscribe: List-Unsubscribe: X-BeenThere: dev-commits-src-branches@freebsd.org Sender: owner-dev-commits-src-branches@FreeBSD.org List-Id: List-Post: List-Help: List-Subscribe: List-Unsubscribe: List-Owner: Precedence: list MIME-Version: 1.0 Content-Type: text/plain; charset=utf-8 Content-Transfer-Encoding: 8bit X-Git-Committer: 0mp X-Git-Repository: src X-Git-Refname: refs/heads/stable/15 X-Git-Reftype: branch X-Git-Commit: 36f268e8e7379dfcdbbb530440f2065b7a72f4f2 Auto-Submitted: auto-generated Date: Tue, 22 Sep 2026 11:16:23 +0000 Message-Id: <6ab26387.4061c.36a7a9ce@gitrepo.freebsd.org> The branch stable/15 has been updated by 0mp: URL: https://cgit.FreeBSD.org/src/commit/?id=36f268e8e7379dfcdbbb530440f2065b7a72f4f2 commit 36f268e8e7379dfcdbbb530440f2065b7a72f4f2 Author: Mateusz Piotrowski <0mp@FreeBSD.org> AuthorDate: 2026-06-09 22:35:26 +0000 Commit: Mateusz Piotrowski <0mp@FreeBSD.org> CommitDate: 2026-09-22 11:16:17 +0000 dtrace_pid.4: Add example "Listing Program's Function Entries" Reviewed by: bcr MFC after: 3 days Differential Revision: https://reviews.freebsd.org/D57515 (cherry picked from commit 7008192726a30d2d5f8ed912554cc53d7bcf9fba) --- share/man/man4/dtrace_pid.4 | 24 ++++++++++++++++++++++-- 1 file changed, 22 insertions(+), 2 deletions(-) diff --git a/share/man/man4/dtrace_pid.4 b/share/man/man4/dtrace_pid.4 index 1acbdd097ba8..b2fa13a9c17b 100644 --- a/share/man/man4/dtrace_pid.4 +++ b/share/man/man4/dtrace_pid.4 @@ -1,9 +1,9 @@ .\" -.\" Copyright (c) 2025 Mateusz Piotrowski <0mp@FreeBSD.org> +.\" Copyright (c) 2025-2026 Mateusz Piotrowski <0mp@FreeBSD.org> .\" .\" SPDX-License-Identifier: BSD-2-Clause .\" -.Dd November 6, 2025 +.Dd September 19, 2026 .Dt DTRACE_PID 4 .Os .Sh NAME @@ -73,6 +73,26 @@ Note that all probe arguments within the .Nm pid provider are of type .Ft uint64_t . +.Sh EXAMPLES +.Ss Example 1: Listing Program's Function Entries +The following example lists the entry probes of +.Xr cat 1 Ap s +global functions: +.Bd -literal -offset indent +# dtrace -l -c cat -n 'pid$target:cat::entry' + ID PROVIDER MODULE FUNCTION NAME +106058 pid34639 cat __do_global_dtors_aux entry +106059 pid34639 cat usage entry +106060 pid34639 cat scanfiles entry +106061 pid34639 cat cook_cat entry +106062 pid34639 cat __do_global_ctors_aux entry +106063 pid34639 cat _start entry +106064 pid34639 cat main entry +.Ed +.Pp +This example will not work without +.Xr cat 1 +debug symbols. .Sh SEE ALSO .Xr dtrace 1 , .Xr dtrace_fbt 4 ,