Changeset View
Standalone View
cddl/contrib/opensolaris/cmd/dtrace/dtrace.1
Show All 14 Lines | |||||||||
.\" fields enclosed by brackets "[]" replaced with your own identifying | .\" fields enclosed by brackets "[]" replaced with your own identifying | ||||||||
.\" information: Portions Copyright [yyyy] [name of copyright owner] | .\" information: Portions Copyright [yyyy] [name of copyright owner] | ||||||||
.\" | .\" | ||||||||
.\" CDDL HEADER END | .\" CDDL HEADER END | ||||||||
.\" Copyright (c) 2006, Sun Microsystems, Inc. All Rights Reserved. | .\" Copyright (c) 2006, Sun Microsystems, Inc. All Rights Reserved. | ||||||||
.\" | .\" | ||||||||
.\" $FreeBSD$ | .\" $FreeBSD$ | ||||||||
.\" | .\" | ||||||||
.Dd February 25, 2020 | .Dd April 2, 2021 | ||||||||
.Dt DTRACE 1 | .Dt DTRACE 1 | ||||||||
.Os | .Os | ||||||||
.Sh NAME | .Sh NAME | ||||||||
.Nm dtrace | .Nm dtrace | ||||||||
.Nd dynamic tracing compiler and tracing utility | .Nd dynamic tracing compiler and tracing utility | ||||||||
.Sh SYNOPSIS | .Sh SYNOPSIS | ||||||||
.Nm | .Nm | ||||||||
.Op Fl 32 | Fl 64 | .Op Fl 32 | Fl 64 | ||||||||
▲ Show 20 Lines • Show All 565 Lines • ▼ Show 20 Lines | |||||||||
.Fl a | .Fl a | ||||||||
flag. | flag. | ||||||||
.It Sy jstackframes Ns = Ns Ar scalar | .It Sy jstackframes Ns = Ns Ar scalar | ||||||||
Number of default stack frames for | Number of default stack frames for | ||||||||
.Fn jstack . | .Fn jstack . | ||||||||
.It Sy jstackstrsize Ns = Ns Ar scalar | .It Sy jstackstrsize Ns = Ns Ar scalar | ||||||||
Default string space size for | Default string space size for | ||||||||
.Fn jstack . | .Fn jstack . | ||||||||
.It Sy libdir Ns = Ns Ar path | |||||||||
Add a directory to the system library path. | |||||||||
.It Sy nspec Ns = Ns Ar scalar | .It Sy nspec Ns = Ns Ar scalar | ||||||||
Number of speculations. | Number of speculations. | ||||||||
allanjude: It might be worth mentioning the /usr/lib/dtrace path, and that this can be used to resolve the… | |||||||||
Done Inline ActionsIt might be worth doing -- will update the diff again once jhb gives me the exact error message. domagoj.stolfa_gmail.com: It might be worth doing -- will update the diff again once jhb gives me the exact error message. | |||||||||
Not Done Inline ActionsThere are lots of error messages that can arise when parsing scripts in /usr/lib/dtrace. markj: There are lots of error messages that can arise when parsing scripts in /usr/lib/dtrace. | |||||||||
Done Inline ActionsThat's true -- and the error message in this particular case doesn't really seem like a great one to begin with: dtrace: invalid probe specifier fbt::vn_sendfile:return { trace(arg1) }: "/usr/lib/dtrace/io.d", line 1: cannot find type: struct devstat*: Type information is in parent and unavailable Perhaps if we want to avoid confusion here, the right thing is to change the "invalid probe specifier" error message to something more meaningful? domagoj.stolfa_gmail.com: That's true -- and the error message in this particular case doesn't really seem like a great… | |||||||||
Not Done Inline ActionsThis is definitely something we can do better... I'll just say that the error handling in libdtrace is really quite hard to follow, there's some setjmp/longjmp and complicated interactions with the generated lexer and parser. So it may be an easy change, but also quite possibly is not an easy change. markj: This is definitely something we can do better... I'll just say that the error handling in… | |||||||||
.It Sy nolibs | |||||||||
Do not load D system libraries. | |||||||||
.It Sy quiet | .It Sy quiet | ||||||||
Set quiet mode. | Set quiet mode. | ||||||||
Same as the | Same as the | ||||||||
.Fl q | .Fl q | ||||||||
flag. | flag. | ||||||||
.It Sy specsize Ns = Ns Ar size | .It Sy specsize Ns = Ns Ar size | ||||||||
Size of the speculation buffer. | Size of the speculation buffer. | ||||||||
.It Sy strsize Ns = Ns Ar size | .It Sy strsize Ns = Ns Ar size | ||||||||
Maximum size of strings. | Maximum size of strings. | ||||||||
.It Sy stackframes Ns = Ns Ar scalar | .It Sy stackframes Ns = Ns Ar scalar | ||||||||
Maximum number of kernelspace stack frames to unwind when executing the | Maximum number of kernelspace stack frames to unwind when executing the | ||||||||
.Fn stack | .Fn stack | ||||||||
action. | action. | ||||||||
.It Sy stackindent Ns = Ns Ar scalar | .It Sy stackindent Ns = Ns Ar scalar | ||||||||
Number of whitespace characters to use when indenting | Number of whitespace characters to use when indenting | ||||||||
.Fn stack | .Fn stack | ||||||||
and | and | ||||||||
.Fn ustack | .Fn ustack | ||||||||
output. | output. | ||||||||
.It Sy statusrate Ns = Ns Ar time | .It Sy statusrate Ns = Ns Ar time | ||||||||
Rate of status checking. | Rate of status checking. | ||||||||
.It Sy switchrate Ns = Ns Ar time | .It Sy switchrate Ns = Ns Ar time | ||||||||
Rate of buffer switching. | Rate of buffer switching. | ||||||||
.It Sy syslibdir Ns = Ns Ar path | |||||||||
Path to system libraries. | |||||||||
Done Inline Actions"Defaults to .Pa /usr/lib/dtrace ." markj: "Defaults to .Pa /usr/lib/dtrace ." | |||||||||
Defaults to | |||||||||
.Pa /usr/lib/dtrace . | |||||||||
Done Inline Actions
markj: | |||||||||
.It Sy ustackframes Ns = Ns Ar scalar | .It Sy ustackframes Ns = Ns Ar scalar | ||||||||
Maximum number of userspace stack frames to unwind when executing the | Maximum number of userspace stack frames to unwind when executing the | ||||||||
.Fn ustack | .Fn ustack | ||||||||
action. | action. | ||||||||
.El | .El | ||||||||
.It Fl X Cm a | c | s | t | .It Fl X Cm a | c | s | t | ||||||||
Specify the degree of conformance to the ISO C standard that should be selected | Specify the degree of conformance to the ISO C standard that should be selected | ||||||||
when invoking | when invoking | ||||||||
▲ Show 20 Lines • Show All 153 Lines • Show Last 20 Lines |
It might be worth mentioning the /usr/lib/dtrace path, and that this can be used to resolve the error jhb was running into.
Infact, it might be worth putting the exact error message here, so that search results for that error lead to this man page.