.\" Automatically generated by Pandoc 2.9.2.1
.\"
.TH "UFTRACE-INFO" "1" "Sep, 2018" "Uftrace User Manuals" ""
.hy
.SH NAME
.PP
uftrace-info - Print tracing information for trace data
.SH SYNOPSIS
.PP
uftrace info [\f[I]options\f[R]] [\f[I]COMMAND\f[R]]
.SH DESCRIPTION
.PP
This command prints metadata recorded in the header of a given data
file.
.SH OPTIONS
.TP
--symbols
Print symbols table instead of the recorded tracing info.
It will print two symbol tables - normal symbols and dynamic symbols.
The normal symbols are from the executable itself, and dynamic symbols
are for library calls.
When COMMAND is given, it should provide symbol information which might
not be available from the recorded path of `exe image' or the symbol
file in the data directory.
.TP
--task
Print task relationship in a tree form instead of the tracing info.
.SH EXAMPLE
.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[C]--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[C]--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[C]uftrace\f[R](1), \f[C]uftrace-record\f[R](1),
\f[C]uftrace-tui\f[R](1)
.SH AUTHORS
Namhyung Kim <namhyung@gmail.com>.