.\" Automatically generated by Pandoc 3.1.3
.\"
.\" Define V font for inline verbatim, using C font in formats
.\" that render this, and otherwise B font.
.ie "\f[CB]x\f[]"x" \{\
. ftr V B
. ftr VI BI
. ftr VB B
. ftr VBI BI
.\}
.el \{\
. ftr V CR
. ftr VI CI
. ftr VB CB
. ftr VBI CBI
.\}
.TH "UFTRACE-INFO" "1" "Sep, 2018" "Uftrace User Manuals" ""
.hy
.SH NAME
.PP
uftrace-info - Print tracing information from the current trace data
file
.SH SYNOPSIS
.PP
uftrace info [\f[I]options\f[R]]
.SH DESCRIPTION
.PP
This command prints metadata recorded in the header of a given trace
data file.
.PP
Alternatively, it can:
.IP \[bu] 2
be used to generate a symbol table of the traced symbols
.IP \[bu] 2
print a task relationship tree for the recorded tasks in the trace
.SH OPTIONS
.TP
--symbols [\f[I]EXECUTABLE\f[R]]
Generate a symbol table for the given traced \f[I]EXECUTABLE\f[R] from
the recorded trace data.
See the example below for the output format: It will print two symbol
tables - normal symbols and dynamic symbols: The normal symbols are
traced functions in the executable itself.
The dynamic symbols are the traced library functions recorded in the
trace.
Because only the trace data is used to generate symbol information, it
will contain different functions than the symbol table of the executable
file itself.
.TP
--task
Print a task relationship tree instead of the trace metadata.
.SH EXAMPLES
.PP
This command shows information like below:
.IP
.nf
\f[C]
$ uftrace record abc

$ uftrace info
# system information
# ==================
# program version     : v0.9 ( dwarf python tui perf sched )
# recorded on         : Wed Sep 19 17:30:39 2018
# cmdline             : uftrace record abc
# cpu info            : Intel(R) Core(TM) i7-3930K CPU \[at] 3.20GHz
# number of cpus      : 12 / 12 (online / possible)
# memory info         : 19.8 / 23.5 GB (free / total)
# system load         : 0.02 / 0.07 / 0.11 (1 / 5 / 15 min)
# kernel version      : Linux 4.5.4-1-ARCH
# hostname            : sejong
# distro              : \[dq]Arch Linux\[dq]
#
# process information
# ===================
# number of tasks     : 1
# task list           : 8284(abc)
# exe image           : /home/namhyung/tmp/abc
# build id            : a3c50d25f7dd98dab68e94ef0f215edb06e98434
# pattern             : regex
# exit status         : exited with code: 0
# elapsed time        : 0.003219479 sec
# cpu time            : 0.003 / 0.000 sec (sys / user)
# context switch      : 1 / 1 (voluntary / involuntary)
# max rss             : 3104 KB
# page fault          : 0 / 169 (major / minor)
# disk iops           : 0 / 24 (read / write)
\f[R]
.fi
.PP
To see the symbol table, one can use the \f[V]--symbols\f[R] option.
.IP
.nf
\f[C]
$ uftrace info --symbols
Normal symbols
==============
[ 0] _start (0x400590) size: 42
[ 1] __gmon_start__ (0x4005c0) size: 59
[ 2] a (0x4006c6) size: 19
[ 3] b (0x4006d9) size: 19
[ 4] c (0x4006ec) size: 49
[ 5] main (0x40071d) size: 19
[ 6] __libc_csu_init (0x400730) size: 101
[ 7] __libc_csu_fini (0x4007a0) size: 2
[ 8] atexit (0x4007b0) size: 41

Dynamic symbols
===============
[ 0] getpid (0x400530) size: 16
[ 1] _mcleanup (0x400540) size: 16
[ 2] __libc_start_main (0x400550) size: 16
[ 3] __monstartup (0x400560) size: 16
[ 4] mcount (0x400570) size: 16
[ 5] __cxa_atexit (0x400580) size: 16
\f[R]
.fi
.PP
The \f[V]--task\f[R] option shows task family hierarchy.
.IP
.nf
\f[C]
$ uftrace info --task
[166399] parent
      [166401] child
\f[R]
.fi
.SH SEE ALSO
.PP
\f[V]uftrace\f[R](1), \f[V]uftrace-record\f[R](1),
\f[V]uftrace-tui\f[R](1)
.SH AUTHORS
Namhyung Kim <namhyung@gmail.com>.