You can not select more than 25 topics
Topics must start with a letter or number, can include dashes ('-') and can be up to 35 characters long.
69 lines
1.6 KiB
69 lines
1.6 KiB
.TH uthreads 8 "2018-10-09" "USER COMMANDS"
|
|
.SH NAME
|
|
uthreads, cthreads, javathreads \- Trace thread creation events in Java or pthreads.
|
|
.SH SYNOPSIS
|
|
.B cthreads [-h] [-v] pid
|
|
.BR
|
|
.B javathreads [-h] [-v] pid
|
|
.BR
|
|
.B uthreads [-h] [-l {c,java,none}] [-v] pid
|
|
.SH DESCRIPTION
|
|
This traces thread creation events in Java processes, or pthread creation
|
|
events in any process. When a thread is created, its name or start address
|
|
is printed.
|
|
|
|
Since this uses BPF, only the root user can use this tool.
|
|
.SH REQUIREMENTS
|
|
CONFIG_BPF and bcc.
|
|
.SH OPTIONS
|
|
.TP
|
|
\-l {c,java,none}
|
|
The language to trace. C and none select tracing pthreads only, regardless
|
|
of the runtime being traced.
|
|
.TP
|
|
\-v
|
|
Print the resulting BPF program, for debugging purposes.
|
|
.TP
|
|
pid
|
|
The process id to trace.
|
|
.SH EXAMPLES
|
|
.TP
|
|
Trace Java thread creations:
|
|
#
|
|
.B uthreads -l java 148
|
|
.TP
|
|
Trace pthread creations:
|
|
#
|
|
.B uthreads 1802
|
|
.SH FIELDS
|
|
.TP
|
|
TIME
|
|
The event's time in seconds from the beginning of the trace.
|
|
.TP
|
|
ID
|
|
The thread's ID. The information in this column depends on the runtime.
|
|
.TP
|
|
TYPE
|
|
Event type -- thread start, stop, or pthread event.
|
|
.TP
|
|
DESCRIPTION
|
|
The thread's name or start address function name.
|
|
.SH OVERHEAD
|
|
Thread start and stop events are usually not very frequent, which makes this
|
|
tool's overhead negligible.
|
|
.SH SOURCE
|
|
This is from bcc.
|
|
.IP
|
|
https://github.com/iovisor/bcc
|
|
.PP
|
|
Also look in the bcc distribution for a companion _example.txt file containing
|
|
example usage, output, and commentary for this tool.
|
|
.SH OS
|
|
Linux
|
|
.SH STABILITY
|
|
Unstable - in development.
|
|
.SH AUTHOR
|
|
Sasha Goldshtein
|
|
.SH SEE ALSO
|
|
ustat(8), trace(8)
|