bcc-cthreads(8)

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

NAME

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

SYNOPSIS

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

DESCRIPTION

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

REQUIREMENTS

21       CONFIG_BPF and bcc.
22

OPTIONS

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

EXAMPLES

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

FIELDS

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

OVERHEAD

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

SOURCE

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

OS

63       Linux
64

STABILITY

66       Unstable - in development.
67

AUTHOR

69       Sasha Goldshtein
70