ptt_paje.1

linux下的多线程调试工具

.\" Automatically generated by Pod::Man v1.37, Pod::Parser v1.3
.\"
.\" Standard preamble:
.\" ========================================================================
.de Sh \" Subsection heading
.br
.if t .Sp
.ne 5
.PP
\fB\\$1\fR
.PP
..
.de Sp \" Vertical space (when we can't use .PP)
.if t .sp .5v
.if n .sp
..
.de Vb \" Begin verbatim text
.ft CW
.nf
.ne \\$1
..
.de Ve \" End verbatim text
.ft R
.fi
..
.\" Set up some character translations and predefined strings.  \*(-- will
.\" give an unbreakable dash, \*(PI will give pi, \*(L" will give a left
.\" double quote, and \*(R" will give a right double quote.  | will give a
.\" real vertical bar.  \*(C+ will give a nicer C++.  Capital omega is used to
.\" do unbreakable dashes and therefore won't be available.  \*(C` and \*(C'
.\" expand to `' in nroff, nothing in troff, for use with C<>.
.tr \(*W-|\(bv\*(Tr
.ds C+ C\v'-.1v'\h'-1p'\s-2+\h'-1p'+\s0\v'.1v'\h'-1p'
.ie n \{\
.    ds -- \(*W-
.    ds PI pi
.    if (\n(.H=4u)&(1m=24u) .ds -- \(*W\h'-12u'\(*W\h'-12u'-\" diablo 10 pitch
.    if (\n(.H=4u)&(1m=20u) .ds -- \(*W\h'-12u'\(*W\h'-8u'-\"  diablo 12 pitch
.    ds L" ""
.    ds R" ""
.    ds C` ""
.    ds C' ""
'br\}
.el\{\
.    ds -- \|\(em\|
.    ds PI \(*p
.    ds L" ``
.    ds R" ''
'br\}
.\"
.\" If the F register is turned on, we'll generate index entries on stderr for
.\" titles (.TH), headers (.SH), subsections (.Sh), items (.Ip), and index
.\" entries marked with X<> in POD.  Of course, you'll have to process the
.\" output yourself in some meaningful fashion.
.if \nF \{\
.    de IX
.    tm Index:\\$1\t\\n%\t"\\$2"
..
.    nr % 0
.    rr F
.\}
.\"
.\" For nroff, turn off justification.  Always turn off hyphenation; it makes
.\" way too many mistakes in technical documents.
.hy 0
.if n .na
.\"
.\" Accent mark definitions (@(#)ms.acc 1.5 88/02/08 SMI; from UCB 4.2).
.\" Fear.  Run.  Save yourself.  No user-serviceable parts.
.    \" fudge factors for nroff and troff
.if n \{\
.    ds #H 0
.    ds #V .8m
.    ds #F .3m
.    ds #[ \f1
.    ds #] \fP
.\}
.if t \{\
.    ds #H ((1u-(\\\\n(.fu%2u))*.13m)
.    ds #V .6m
.    ds #F 0
.    ds #[ \&
.    ds #] \&
.\}
.    \" simple accents for nroff and troff
.if n \{\
.    ds ' \&
.    ds ` \&
.    ds ^ \&
.    ds , \&
.    ds ~ ~
.    ds /
.\}
.if t \{\
.    ds ' \\k:\h'-(\\n(.wu*8/10-\*(#H)'\'\h"|\\n:u"
.    ds ` \\k:\h'-(\\n(.wu*8/10-\*(#H)'\`\h'|\\n:u'
.    ds ^ \\k:\h'-(\\n(.wu*10/11-\*(#H)'^\h'|\\n:u'
.    ds , \\k:\h'-(\\n(.wu*8/10)',\h'|\\n:u'
.    ds ~ \\k:\h'-(\\n(.wu-\*(#H-.1m)'~\h'|\\n:u'
.    ds / \\k:\h'-(\\n(.wu*8/10-\*(#H)'\z\(sl\h'|\\n:u'
.\}
.    \" troff and (daisy-wheel) nroff accents
.ds : \\k:\h'-(\\n(.wu*8/10-\*(#H+.1m+\*(#F)'\v'-\*(#V'\z.\h'.2m+\*(#F'.\h'|\\n:u'\v'\*(#V'
.ds 8 \h'\*(#H'\(*b\h'-\*(#H'
.ds o \\k:\h'-(\\n(.wu+\w'\(de'u-\*(#H)/2u'\v'-.3n'\*(#[\z\(de\v'.3n'\h'|\\n:u'\*(#]
.ds d- \h'\*(#H'\(pd\h'-\w'~'u'\v'-.25m'\f2\(hy\fP\v'.25m'\h'-\*(#H'
.ds D- D\\k:\h'-\w'D'u'\v'-.11m'\z\(hy\v'.11m'\h'|\\n:u'
.ds th \*(#[\v'.3m'\s+1I\s-1\v'-.3m'\h'-(\w'I'u*2/3)'\s-1o\s+1\*(#]
.ds Th \*(#[\s+2I\s-2\h'-\w'I'u*3/5'\v'-.3m'o\v'.3m'\*(#]
.ds ae a\h'-(\w'a'u*4/10)'e
.ds Ae A\h'-(\w'A'u*4/10)'E
.    \" corrections for vroff
.if v .ds ~ \\k:\h'-(\\n(.wu*9/10-\*(#H)'\s-2\u~\d\s+2\h'|\\n:u'
.if v .ds ^ \\k:\h'-(\\n(.wu*10/11-\*(#H)'\v'-.4m'^\v'.4m'\h'|\\n:u'
.    \" for low resolution devices (crt and lpr)
.if \n(.H>23 .if \n(.V>19 \
\{\
.    ds : e
.    ds 8 ss
.    ds o a
.    ds d- d\h'-1'\(ga
.    ds D- D\h'-1'\(hy
.    ds th \o'bp'
.    ds Th \o'LP'
.    ds ae ae
.    ds Ae AE
.\}
.rm #[ #] #H #V #F C
.\" ========================================================================
.\"
.IX Title "PTT_PAJE 1"
.TH PTT_PAJE 1 "2006-03-10" "PTT 1.0" "PTT - POSIX Thread Trace Toolkit"
.SH "NAME"
ptt_paje \- PTT graphical decoder
.SH "SYNOPSIS"
.IX Header "SYNOPSIS"
ptt_paje [options] input_file
.SH "DESCRIPTION"
.IX Header "DESCRIPTION"
Its primary function is to decode
the binary data collected by \fIptt_trace\fR\|(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.
.SH "OPTIONS"
.IX Header "OPTIONS"
.Sh "Input options"
.IX Subsection "Input options"
.IP "\fB\-i file\fR" 4
.IX Item "-i file"
input file name.
The input file can also be the last command line option.
.Sh "Output options"
.IX Subsection "Output options"
.IP "\fB\-o file\fR" 4
.IX Item "-o file"
output file name.
If it is `\-' or not set, stdin will be used.
.IP "\fB\-s {pid,pidx,tid}\fR" 4
.IX Item "-s {pid,pidx,tid}"
split output by pid or tid.
.RS 4
.IP "\fBpid\fR: each pid has its own file. The file pattern is \fIfilename-pid\fR." 4
.IX Item "pid: each pid has its own file. The file pattern is filename-pid."
.PD 0
.IP "\fBpidx\fR: 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 \fIfork\fR...) after a \fIfork\fR. The file pattern is \fIfilename-pid\fR." 4
.IX Item "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."
.IP "\fBtid\fR: each (pid, tid) couple has its own file. The file pattern is \fIfilename-pid-tid\fR." 4
.IX Item "tid: each (pid, tid) couple has its own file. The file pattern is filename-pid-tid."
.RE
.RS 4
.PD
.Sp
\&\fIWarning\fR: Paje needs complete events,
so splitting could break object initialisation.
.RE
.Sh "Output options"
.IX Subsection "Output options"
.IP "\fB\-p pid[,pid...]\fR" 4
.IX Item "-p pid[,pid...]"
search for pid.
Select only events of the given pids.
.Sp
The comma acts like an \fBor\fR.
.Sp
\&\fIWarning\fR: in case of \fIfork\fR without an exec,
the libpthread won't be reinitialised,
and Paje output won't detect which thread
is the main thread.
.Sp
See also the \fIptt_view\fR\|(1) comments.
.IP "\fB\-n name[,name...]\fR" 4
.IX Item "-n name[,name...]"
select the objects by their name (actually address)
.Sp
The comma acts like an \fBor\fR.
.Sp
\&\fIWarning\fR: 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).
.Sp
See also the \fIptt_view\fR\|(1) comments.
.IP "\fB\-e\fR" 4
.IX Item "-e"
display only function calls and function return events
.IP "\fB\-z start:end\fR" 4
.IX Item "-z start:end"
event filter.
This filter only displays \f(CW\*(C`end \- start\*(C'\fR events skipping \f(CW\*(C`start\*(C'\fR events
The syntax \fB\-z :end\fR or \fB\-z start:\fR
is also supported and imply start=0 or end=infinity.
.Sp
\&\fIWarning\fR: You should always set start=0 with Paje.
Skipping events will result in missing information
and it will be impossible to display the chart.
.Sp
See also the \fIptt_view\fR\|(1) comments.
.IP "\fB\-Z start:end\fR" 4
.IX Item "-Z start:end"
This filter only displays events that occurred
after \f(CW\*(C`start\*(C'\fR microseconds and before \f(CW\*(C`end\*(C'\fR microseconds.
The syntax \fB\-Z :end\fR or \fB\-Z start:\fR
is also supported and imply start=0 or end=infinity.
time filter
.Sp
\&\fIWarning\fR: You should always set start=0 with Paje.
Skipping events will result in missing information
and it will be impossible to display the chart.
.Sh "Display options"
.IX Subsection "Display options"
.IP "\fB\-m\fR" 4
.IX Item "-m"
mask attribute and state of threads
.IP "\fB\-d\fR" 4
.IX Item "-d"
show attribute and state of threads
.IP "\fBno display option\fR" 4
.IX Item "no display option"
mask attribute and show state of threads
.IP "\fB\-h\fR" 4
.IX Item "-h"
display the help
.SH "Size of trace"
.IX Header "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.
.PP
Next version of Paje should improve this
by alllowing partial parsing when displaying, ...
.SH "SEE ALSO"
.IX Header "SEE ALSO"
\&\fIptt_view\fR\|(1), \fIptt_trace\fR\|(1), \fIPaje\fR\|(1)
.SH "AUTHOR"
.IX Header "AUTHOR"
Matthieu \s-1CASTET\s0, Guillaume \s-1DURANCEAU\s0