freebsd-dev/cddl/contrib/dtracetoolkit/Man/man1m/tcl_syscolors.d.1m
2012-05-12 21:25:48 +00:00

60 lines
1.3 KiB
Plaintext

.TH tcl_syscolors.d 1m "$Date:: 2007-10-03 #$" "USER COMMANDS"
.SH NAME
tcl_syscolors.d - trace Tcl program flow plus syscalls, in color.
.SH SYNOPSIS
.B tcl_syscolors.d
{ \-p PID | \-c cmd }
.SH DESCRIPTION
This traces activity from all Tcl processes on the system with DTrace
provider support (tcl8.4.16).
This watches Tcl method entries and returns, and indents child
method calls.
.SH OS
Any
.SH STABILITY
Evolving - uses the DTrace Tcl provider, which may change
as additional features are introduced. Check Tcl/Readme
to see what version these scripts are based on.
.SH EXAMPLES
.TP
Default output,
#
.B tcl_syscolors.d
.PP
.SH FIELDS
.TP
C
CPU-id
.TP
PID
Process ID
.TP
TID
Thread ID
.TP
DELTA(us)
Elapsed time from previous line to this line
.TP
TYPE
Type of call (proc/cmd/syscall)
.TP
NAME
Tcl proc/cmd or syscall name
.SH WARNING
Watch the first column carefully, it prints the CPU-id. If it
changes, then it is very likely that the output has been shuffled.
.PP
.SH DOCUMENTATION
See the DTraceToolkit for further documentation under the
Examples, Notes and Docs directories. The example files may be
especially useful as they aim to demonstrate how to interpret
the output.
.SH EXIT
tcl_syscolors.d will run until Ctrl-C is hit.
.SH AUTHOR
Brendan Gregg
[CA, USA]
.SH SEE ALSO
dtrace(1M)