Date: Sat, 8 Nov 2025 11:15:13 GMT From: Mateusz Piotrowski <0mp@FreeBSD.org> To: src-committers@FreeBSD.org, dev-commits-src-all@FreeBSD.org, dev-commits-src-branches@FreeBSD.org Subject: git: 3b7358bebd30 - stable/13 - dtrace.1: Document evaltime Message-ID: <202511081115.5A8BFDwB090004@gitrepo.freebsd.org>
index | next in thread | raw e-mail
The branch stable/13 has been updated by 0mp: URL: https://cgit.FreeBSD.org/src/commit/?id=3b7358bebd30cc7dea34c329cbc3e7e14264c2bb commit 3b7358bebd30cc7dea34c329cbc3e7e14264c2bb Author: Mateusz Piotrowski <0mp@FreeBSD.org> AuthorDate: 2025-07-14 14:51:37 +0000 Commit: Mateusz Piotrowski <0mp@FreeBSD.org> CommitDate: 2025-11-08 11:15:05 +0000 dtrace.1: Document evaltime Reviewed by: christos, ziaee MFC after: 1 week Differential Revision: https://reviews.freebsd.org/D51301 (cherry picked from commit 1fe7af0635810a96a292638d11d25ddbe95bd581) --- cddl/contrib/opensolaris/cmd/dtrace/dtrace.1 | 46 ++++++++++++++++++++++++++++ 1 file changed, 46 insertions(+) diff --git a/cddl/contrib/opensolaris/cmd/dtrace/dtrace.1 b/cddl/contrib/opensolaris/cmd/dtrace/dtrace.1 index a98d851b9998..34c36920ac97 100644 --- a/cddl/contrib/opensolaris/cmd/dtrace/dtrace.1 +++ b/cddl/contrib/opensolaris/cmd/dtrace/dtrace.1 @@ -608,6 +608,52 @@ Same as the flag. .It Sy dynvarsize Ns = Ns Ar size Size of the dynamic variable space. +.Sm off +.It Sy evaltime = Cm exec | preinit | postinit | main +.Sm on +Process create mode. +When using +.Fl c Ar cmd +to start a command, +.Nm +will first stop the newly started +.Ar cmd , +evaluate the +.Xr d 7 +program, +and then resume the +.Ar cmd . +The +.Cm evaltime +option controls the exact moment when this happens. +.Pp +The following table describes supported modes. +.Bl -column -offset indent "postinit" "D Program Evaluation Time" +.It Sy Mode Ta Sy D Program Evaluation Time +.It Cm exec Ta +Right at the first instruction of the command +.Ar cmd +execution. +.It Cm preinit Ta +Before +.Xr elf 5 Ap s +.Dq .init +sections. +.It Cm postinit Ta +After +.Xr elf 5 Ap s +.Dq .init +sections. +Default on +.Fx . +.It Cm main Ta +Before the first instruction of the +.Fn main +function. +.El +.Pp +Usually, there is no reason to change the default mode, +but it might be handy in situations such as shared library tracing. .It Sy flowindent Turn on flow indentation. Same as thehome | help
Want to link to this message? Use this
URL: <https://mail-archive.FreeBSD.org/cgi/mid.cgi?202511081115.5A8BFDwB090004>