sptdecode.man

.TH SPTDECODE "" SIMPLE-PT
.SH NAME
sptdecode \- Decode Processor Trace files and display call trace
.SH SYNOPSIS
sptdecode [--sideband sidebandfile] ... [--elf elfbinary ] [--pt ptfile ...] ...
.SH DESCRIPTION
.B sptdecode
decodes Processor Trace traces generated by simple-pt. It shows a call trace of all the function calls
executed during the trace. Mandatory arguments are trace file with
.I --pt,
and either an ELF binary with 
.I --elf
or the side band data listing multiple binaries with
.I --sideband. 
The trace file contains the trace data for a single CPU.
.I --sideband
and 
.I --elf
need to be specified before
.I --pt.
When 
.B -i
is specified, the raw instructions are dumped, optionally with disassembly. 
Default is to just show function calls.
.PP
With the
.B --tsc 
or 
.B -t 
option the time is shown in TSC units, otherwise in us.
.PP
The
.B -d
or
.B --dwarf
option enables dwarf decoding with
.I -i.
.PP
The
.B --abstime
or
.B -a
option enables printing absolute time (relative to system boot), which can be used to
synchronize traces from multiple CPUs.
.SH EXAMPLES
.br
sptcmd command
.br
sptdecode --sideband ptout.sideband --pt ptout.0
.SH NOTES
To decode kernel code 
.I sptcmd
has to run as root, in order to access
.I /proc/kcore.
.SH SEE ALSO
.B sptcmd
.B fastdecode
.B simple-pt