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

NAME

6       tplist - Display kernel tracepoints or USDT probes and their formats.
7

SYNOPSIS

9       tplist [-p PID] [-l LIB] [-v] [filter]
10

DESCRIPTION

12       tplist  lists  all kernel tracepoints, and can optionally print out the
13       tracepoint format; namely, the variables that you can  trace  when  the
14       tracepoint is hit.  tplist can also list USDT probes embedded in a spe‐
15       cific library or executable, and can  list  USDT  probes  for  all  the
16       libraries  loaded  by  a  specific process.  These features are usually
17       used in conjunction with the argdist and/or trace tools.
18
19       On a typical system, accessing the tracepoint list and format  requires
20       root.  However, accessing USDT probes does not require root.
21

OPTIONS

23       -p PID Display  the  USDT  probes  from all the libraries loaded by the
24              specified process.
25
26       -l LIB Display the USDT probes  from  the  specified  library  or  exe‐
27              cutable.  If  the librar or executable can be found in the stan‐
28              dard paths, a full path is not required.
29
30       -v     Increase the verbosity level. Can be used to display  the  vari‐
31              ables, locations, and arguments of tracepoints and USDT probes.
32
33       [filter]
34              A wildcard expression that specifies which tracepoints or probes
35              to print.  For example, block:* will print all block tracepoints
36              (block:block_rq_complete,  etc.).  Regular  expressions  are not
37              supported.
38

EXAMPLES

40       Print all kernel tracepoints:
41              # tplist
42
43       Print all net tracepoints with their format:
44              # tplist -v 'net:*'
45
46       Print all USDT probes in libpthread:
47              $ tplist -l pthread
48
49       Print all USDT probes in process 4717 from the libc provider:
50              $ tplist -p 4717 'libc:*'
51
52       Print all the USDT probes in the node executable:
53              $ tplist -l node
54

SOURCE

56       This is from bcc.
57
58              https://github.com/iovisor/bcc
59

OS

61       Linux
62

STABILITY

64       Unstable - in development.
65

AUTHOR

67       Sasha Goldshtein
68
69
70
71USER COMMANDS                     2016-03-20                         tplist(8)
Impressum