1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
78
79
80
81
82
83
84
85
86
87
88
89
90
91
92
93
94
95
96
97
98
99
100
101
102
103
104
105
106
107
108
109
110
111
112
113
114
115
116
117
118
119
120
121
122
123
124
125
126
127
128
129
130
131
132
133
134
135
136
137
138
139
140
141
142
143
144
145
146
147
148
149
150
151
152
153
154
155
156
157
158
159
160
161
162
163
164
165
166
167
168
169
170
171
172
173
174
175
176
177
178
179
180
181
182
183
184
185
186
187
188
189
190
191
192
193
194
195
196
197
198
199
200
201
202
203
204
205
206
207
208
209
210
211
212
213
214
|
% UFTRACE-TUI(1) Uftrace User Manuals
% Namhyung Kim <namhyung@gmail.com>
% Jun, 2018
NAME
====
uftrace-tui - (Interactive) Text-based User Interface
SYNOPSIS
========
uftrace tui [*options*]
DESCRIPTION
===========
This command starts an interactive window on a terminal which can show same
output of other commands like graph, report and info. Users can navigate the
result easily with key presses. The command line options are used to limit
the initial data loading.
TUI OPTIONS
===========
-f *FIELD*, \--output-fields=*FIELD*
: Customize fields in the output. This option basically indicates graph fields.
Possible values are total, self, addr, total-avg, total-max, total-min, self-avg,
self-max and self-min. The default value is 'total'.
But if this option is used with --report option,
this option indicates report fields. Possible values are total, total-avg,
total-min, total-max, total-stdv, self, self-avg, self-min, self-max,
self-stdv, call and size.
The default value is 'total,self,call'.
Multiple fields can be set by using comma.
If given field name starts with "+", then it'll be appended to the default fields.
The special field 'none' can be used (solely) to hide all fields.
See `uftrace-graph`(1) or `uftrace-report`(1) for an explanation of fields.
The `stdv` in total-stdv and self-stdv stands for relative standard deviation (RSD),
it would only contain value if the function is invoked multiple times.
-s *KEYS*[,*KEYS*,...], \--sort=*KEYS*[,*KEYS*,...]
: Sort functions by given KEYS. Multiple KEYS can be given, separated by comma (,).
Possible keys are total (time), total-avg, total-min, total-max, self (time), self-avg,
self-min, self-max, call, func and size.
This option must be used with --report option.
COMMON OPTIONS
==============
-F *FUNC*, \--filter=*FUNC*
: Set filter to trace selected functions and their children functions.
This option can be used more than once.
See `uftrace-replay`(1) for an explanation of filters.
-N *FUNC*, \--notrace=*FUNC*
: Set filter not to trace selected functions and their children functions.
This option can be used more than once.
See `uftrace-replay`(1) for an explanation of filters.
-C *FUNC*, \--caller-filter=*FUNC*
: Set filter to trace callers of selected functions only.
This option can be used more than once.
See `uftrace-replay`(1) for an explanation of filters.
-T *TRG*, \--trigger=*TRG*
: Set trigger on selected functions. This option can be used more than once.
See `uftrace-replay`(1) for an explanation of triggers.
-D *DEPTH*, \--depth *DEPTH*
: Set trace limit in nesting level.
-t *TIME*, \--time-filter=*TIME*
: Do not show functions which run under the time threshold. If some functions
explicitly have the 'trace' trigger applied, those are always traced
regardless of execution time.
-Z *SIZE*, \--size-filter=*SIZE*
: Do not show functions smaller than SIZE bytes.
-L *LOCATION*, \--loc-filter=*LOCATION*
: Set filter to trace selected source locations.
This option can be used more than once. See *FILTERS*.
\--no-libcall
: Do not show library calls.
\--no-event
: Do not show any events. Implies `--no-sched`.
\--no-sched
: Do not show schedule events.
\--no-sched-preempt
: Do not show preempt schedule events
but show regular(sleeping) schedule events.
\--match=*TYPE*
: Use pattern match using TYPE. Possible types are `regex` and `glob`.
Default is `regex`.
\--with-syms=*DIR*
: Read symbol data from the .sym files in *DIR* directory instead of the
binary. This can be useful to deal with stripped binaries. The file name
of the main binary should be the same when saved and used.
COMMON ANALYSIS OPTIONS
=======================
-H *FUNC*, \--hide=*FUNC*
: Set filter not to trace selected functions.
It doesn't affect their subtrees, but hides only the given functions.
This option can be used more than once.
See `uftrace-replay`(1) for an explanation of filters.
\--kernel-full
: Show all kernel functions called outside of user functions.
\--kernel-only
: Show kernel functions only without user functions.
\--event-full
: Show all (user) events outside of user functions.
\--tid=*TID*[,*TID*,...]
: Only print functions called by the given tasks. To see the list of
tasks in the data file, you can use `uftrace report --task` or
`uftrace info`. This option can also be used more than once.
\--demangle=*TYPE*
: Use demangled C++ symbol names for filters, triggers, arguments and/or
return values. Possible values are "full", "simple" and "no". Default is
"simple" which ignores function arguments and template parameters.
-r *RANGE*, \--time-range=*RANGE*
: Only show functions executed within the time RANGE. The RANGE can be
\<start\>~\<stop\> (separated by "~") and one of \<start\> and \<stop\> can
be omitted. The \<start\> and \<stop\> are timestamp or elapsed time if
they have \<time_unit\> postfix, for example '100us'. The timestamp or
elapsed time can be shown with `-f time` or `-f elapsed` option respectively
in `uftrace replay`(1).
OUTLINE
=======
If there's only one session (the usual case) it'll start with the graph mode to
show a full (function) call graph of the session. Users can change to different
mode by pressing some keys. The `h` key always is available for help.
The current line (marked with '>' below) is displayed with inverted color and
arrow keys are used to move the cursor to a different location.
TOTAL TIME : FUNCTION
> 7.548 us : (1) t-abc
1.811 us : ├─(1) __monstartup
: │
1.266 us : ├─(1) __cxa_atexit
: │
4.471 us : └─(1) main
3.743 us : (1) a
3.194 us : (1) b
2.454 us : (1) c
1.000 us : (1) getpid
uftrace graph: session 2a22812ebbd06f40 (/tmp/uftrace/tests/t-abc)
If there're more than one session, it'll start with session selection mode.
The graph mode is separated for each session but report mode is merged for the
whole sessions.
Key uftrace command
> G call Graph for session #1: t-forkexec
call Graph for session #2: t-abc
R Report functions
I uftrace Info
h Help message
q quit
session a27acff69aec5c9c: exe image: /tmp/uftrace/tests/t-forkexec
KEYS
====
Following keys can be used in the TUI window:
* `Up`, `Down`: Move cursor up/down
* `PageUp`, `PageDown`: Move page up/down
* `Home`, `End`: Move to the first/last entry
* `Enter`: Fold/unfold graph or Select session
* `G`: Show full graph of the current session
* `g`: Show backtrace and call graph of the current function
* `R`: Show uftrace report
* `r`: Show uftrace report of the current function
* `s`: Sort by the next column (in report mode)
* `I`: Show uftrace info
* `S`: Show session list
* `O`: Open editor for current function
* `c`/`e`: Collapse/Expand direct children graph node
* `C`/`E`: Collapse/Expand all descendant graph node
* `n`/`p`: Move to next/prev sibling (in graph mode)
* `u`: Move up to parent (in graph mode)
* `l`: Move to the longest executed child (in graph mode)
* `j`/`k`: Move cursor up/down (like vi)
* `z`: Set current line to the center of screen
* `/`: Start search
* `<`/`P`: Search previous match
* `>`/`N`: Search next match
* `v`: Show debug message
* `f`: Customize fields in graph or report mode
* `h`/`?`: Show help window
* `q`: Quit
SEE ALSO
========
`uftrace`(1), `uftrace-graph`(1), `uftrace-report`(1), `uftrace-info`(1), `uftrace-replay`(1)
|