From nobody Sat Sep 19 14:54:52 2026 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 4hnCFn0pTFz6sssH for ; Sat, 19 Sep 2026 14:54:53 +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 4hnCFn08DZz4cJ1 for ; Sat, 19 Sep 2026 14:54:53 +0000 (UTC) (envelope-from git@FreeBSD.org) DKIM-Signature: v=1; a=rsa-sha256; c=relaxed/relaxed; d=freebsd.org; s=dkim; t=1789829693; 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=bAYy9q5uPeGdAnnBrb39DqFV/I6XLhZQdTrEP45uYEk=; b=woNd41UYXh86Alw0E1T3nCSU0V6BQ8dQ6SVY3L0s6DTWgoOiVI5kBV0lmCBgi8GQ3/x0OQ 2rSgc+/imT1DRsuEu6pP0W98r7A9bjZ+c9aDzMq3abs+B118UFqiMT7xffa1N8XzKfKJwH 8RDtDB3TIlvEMJg2cSzmuA51nKQ//cBDcEcY70fpUWtesiSOuTKYtFfoPKAiBpNH9BJUXI HKbMHhTOEfqN87efwZSfMunm7N9EP3E/yPb0nqWgYSnG2Z8I8cZuWdiPZyMmrqTEaPkFPw p9wcFsUEUjQpeX9SRMtMF7GaPlJPY47p888E/UhxJTaUojceERND9kVc/rONkA== ARC-Seal: i=1; a=rsa-sha256; d=freebsd.org; s=dkim; cv=none; t=1789829693; b=MBoQZI3WFKTd3ujC4luzsGgeZi/KxgqHExfPr0OFKz065tME9YFOtxGsp3JbjaJ7ZVsU0u 7TgUZSaTWUd/C6v4nI0wCjD+6q5rK0KIBLc3TD/VLOgJaCOI4LyErDV6zq6ri7aXS/9Tdj 1pB9obJqyj1YKz2ws1kVMeYGNGcu9WBhpi2Lw1/PxkwUN5vmQK3k5cfdvncTte9c3CqvhE 2eYSl0VWc3U267gwzqdOEmkCq4CIeZMjS5IbBGvznWoWRoPVnC3uEKp6ctbYQhGEkJ3/KT lSCLqc1S66XvgpA0OqnU1n56jNUhXCVm99seCrBP9J3amtm5cjhKdMpLQfP2mQ== ARC-Message-Signature: i=1; a=rsa-sha256; c=relaxed/relaxed; d=freebsd.org; s=dkim; t=1789829693; 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=bAYy9q5uPeGdAnnBrb39DqFV/I6XLhZQdTrEP45uYEk=; b=AjJRKh5h0MCCo3MYY3QtG1xeChEnaUh7l6P/jqHUrVwt5H/nMIEgbBsga0Oxmb18nhT8Ae HaB+P0BQ2BsHftUUDEqdE/fCn+QX53amXg/iDpoLKENLuUTYVBD1XtcwVcLCB/XleL7PPg BSbKEFnkNgpZB7wi/YggcrAlzcKn7mz+6oZrEPVpRTeKKgCSeJOcYzLzfncu746truUpy4 kew9vVGwD7r6LDnLrA3+wNzJEZKtN9k7BtS2CV38q7qrKLsv7BH7UcmJHVHY5BQqQtmAkX PnDQvvoU7rgyph6Ig0WZXhGcB+dxPUkwejv8aq3iYKs1tt7dKOx2zuTNBnzRjQ== 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 4hnCFm5m0Fz17KG for ; Sat, 19 Sep 2026 14:54:52 +0000 (UTC) (envelope-from git@FreeBSD.org) Received: from git (uid 1279) (envelope-from git@FreeBSD.org) id 19ac0 by gitrepo.freebsd.org (DragonFly Mail Agent v0.13+ on gitrepo.freebsd.org); Sat, 19 Sep 2026 14:54:52 +0000 To: src-committers@FreeBSD.org, dev-commits-src-all@FreeBSD.org, dev-commits-src-main@FreeBSD.org From: Mateusz Piotrowski <0mp@FreeBSD.org> Subject: git: 7008192726a3 - main - dtrace_pid.4: Add example "Listing Program's Function Entries" 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 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/main X-Git-Reftype: branch X-Git-Commit: 7008192726a30d2d5f8ed912554cc53d7bcf9fba Auto-Submitted: auto-generated Date: Sat, 19 Sep 2026 14:54:52 +0000 Message-Id: <6aaea23c.19ac0.790792ce@gitrepo.freebsd.org> The branch main has been updated by 0mp: URL: https://cgit.FreeBSD.org/src/commit/?id=7008192726a30d2d5f8ed912554cc53d7bcf9fba commit 7008192726a30d2d5f8ed912554cc53d7bcf9fba Author: Mateusz Piotrowski <0mp@FreeBSD.org> AuthorDate: 2026-06-09 22:35:26 +0000 Commit: Mateusz Piotrowski <0mp@FreeBSD.org> CommitDate: 2026-09-19 14:51:06 +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 --- 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 ,