git: 36f268e8e737 - stable/15 - dtrace_pid.4: Add example "Listing Program's Function Entries"

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 ,