NAME

ptt_paje - PTT graphical decoder

SYNOPSIS

ptt_paje [options] input_file

DESCRIPTION

Its primary function is to decode the binary data collected by ptt_trace(1) into a Paje compliant format. The output can be used with the Paje visualization tool to get a graphical representation of the program execution.

OPTIONS

Input options

-i file
input file name. The input file can also be the last command line option.

Output options

-o file
output file name. If it is `-' or not set, stdin will be used.

-s {pid,pidx,tid}
split output by pid or tid.
pid: each pid has its own file. The file pattern is filename-pid.
pidx: each pid has its own file and the history of the parent process is copied (doesn't work well as threads are deleted after a fork...) after a fork. The file pattern is filename-pid.
tid: each (pid, tid) couple has its own file. The file pattern is filename-pid-tid.

Warning: Paje needs complete events, so splitting could break object initialisation.

Output options

-p pid[,pid...]
search for pid. Select only events of the given pids.

The comma acts like an or.

Warning: in case of fork without an exec, the libpthread won't be reinitialised, and Paje output won't detect which thread is the main thread.

See also the ptt_view(1) comments.

-n name[,name...]
select the objects by their name (actually address)

The comma acts like an or.

Warning: you should only try to select tid. Selecting mutex or other thing won't work because Paje needs information of all objects that interteract with the display ones (for example thread info for mutex).

See also the ptt_view(1) comments.

-e
display only function calls and function return events

-z start:end
event filter. This filter only displays end - start events skipping start events The syntax -z :end or -z start: is also supported and imply start=0 or end=infinity.

Warning: You should always set start=0 with Paje. Skipping events will result in missing information and it will be impossible to display the chart.

See also the ptt_view(1) comments.

-Z start:end
This filter only displays events that occurred after start microseconds and before end microseconds. The syntax -Z :end or -Z start: is also supported and imply start=0 or end=infinity. time filter

Warning: You should always set start=0 with Paje. Skipping events will result in missing information and it will be impossible to display the chart.

Display options

-m
mask attribute and state of threads

-d
show attribute and state of threads

no display option
mask attribute and show state of threads

-h
display the help

Size of trace

Current version of Paje is time and memory aware, so the size of the trace should be small enough in order to be workable.

Next version of Paje should improve this by alllowing partial parsing when displaying, ...

SEE ALSO

ptt_view(1), ptt_trace(1), Paje(1)

AUTHOR

Matthieu CASTET, Guillaume DURANCEAU