NAME

uthreads, cthreads, javathreads - Trace thread creation events in Java or pthreads.

SYNOPSIS

cthreads [-h] [-v] pid javathreads [-h] [-v] pid uthreads [-h] [-l {c,java,none}] [-v] pid

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.

REQUIREMENTS

CONFIG_BPF and bcc.

OPTIONS

-l {c,java,none}: The language to trace. C and none select tracing pthreads only, regardless of the runtime being traced.
-v: Print the resulting BPF program, for debugging purposes.
pid: The process id to trace.

EXAMPLES

Trace Java thread creations:: # uthreads -l java 148
Trace pthread creations:: # uthreads 1802

FIELDS

TIME: The event's time in seconds from the beginning of the trace.
ID: The thread's ID. The information in this column depends on the runtime.
TYPE: Event type -- thread start, stop, or pthread event.
DESCRIPTION: The thread's name or start address function name.

OVERHEAD

Thread start and stop events are usually not very frequent, which makes this tool's overhead negligible.

SOURCE

This is from bcc.

: https://github.com/iovisor/bcc

Also look in the bcc distribution for a companion _example.txt file containing example usage, output, and commentary for this tool.

OS

Linux

STABILITY

Unstable - in development.

AUTHOR

Sasha Goldshtein