bcc-uthreads(8)

1uthreads(8)                 System Manager's Manual                uthreads(8)
2
3
4

NAME

6       uthreads,  javathreads  -  Trace  thread  creation  events  in  Java or
7       pthreads.
8

SYNOPSIS

10       javathreads [-h] [-v] pid  uthreads [-h] [-l {java}] [-v] pid
11

DESCRIPTION

13       This traces thread creation events in Java processes, or  pthread  cre‐
14       ation  events  in  any  process.  When a thread is created, its name or
15       start address is printed.
16
17       Since this uses BPF, only the root user can use this tool.
18

REQUIREMENTS

20       CONFIG_BPF and bcc.
21

OPTIONS

23       -l {java}
24              The language to trace (currently only Java is  supported).  When
25              no language is specified, only pthread creations are traced.
26
27       -v     Print the resulting BPF program, for debugging purposes.
28
29       pid    The process id to trace.
30

EXAMPLES

32       Trace Java thread creations:
33              # uthreads -l java 148
34
35       Trace pthread creations:
36              # uthreads 1802
37

FIELDS

39       TIME   The event's time in seconds from the beginning of the trace.
40
41       ID     The  thread's  ID. The information in this column depends on the
42              runtime.
43
44       TYPE   Event type -- thread start, stop, or pthread event.
45
46       DESCRIPTION
47              The thread's name or start address function name.
48

OVERHEAD

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

SOURCE

54       This is from bcc.
55
56              https://github.com/iovisor/bcc
57
58       Also  look  in  the  bcc distribution for a companion _example.txt file
59       containing example usage, output, and commentary for this tool.
60

OS

62       Linux
63

STABILITY

65       Unstable - in development.
66

AUTHOR

68       Sasha Goldshtein
69