ptt_trace.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_TRACE 1"
.TH PTT_TRACE 1 "2006-04-21" "PTT 1.0" "PTT - POSIX Thread Trace Toolkit"
.SH "NAME"
ptt_trace \- PTT daemon
.SH "SYNOPSIS"
.IX Header "SYNOPSIS"
ptt_trace [options] \fIcmd\fR [\fIcmd_param\fR...]
.SH "DESCRIPTION"
.IX Header "DESCRIPTION"
Its primary function is to collect the data
generated by the instrumented \s-1NPTL\s0
and to commit it in a file. 
It links \fIcmd\fR to the instrumented libpthread
building in the installation process.
.SH "OPTIONS"
.IX Header "OPTIONS"
.IP "\fB\-s size\fR" 4
.IX Item "-s size"
set the buffer size
.IP "\fB\-h\fR" 4
.IX Item "-h"
display the help
.IP "\fB\-v\fR" 4
.IX Item "-v"
be verbose
.IP "\fB\-m max\fR" 4
.IX Item "-m max"
split in files of max bytes.
If 0, don't split file (default).
.Sp
\&\fIWarning\fR: max is not a strict limit,
but only an indication for the \s-1PTT\s0 daemon.
.IP "\fB\-f max\fR" 4
.IX Item "-f max"
Keep only max file on the disk.
The additional file will be erased.
.IP "\fB\-n name\fR" 4
.IX Item "-n name"
Name of the prefix of the trace file.
The default is trace_[date]_[pid].
.IP "\fB\-l level\fR" 4
.IX Item "-l level"
set the log level
.Sp
You can select multiple level with comma.
For example if you want mutex and cond\-var,
use `\s-1LEVEL_MUTEX_ALL\s0,LEVEL_COND_ALL'.
.Sp
Following values can be used:
.RS 4
.IP "\fB\s-1LEVEL_NONE\s0\fR to trace nothing" 4
.IX Item "LEVEL_NONE to trace nothing"
.PD 0
.IP "\fB\s-1LEVEL_ALL\s0\fR to trace everything" 4
.IX Item "LEVEL_ALL to trace everything"
.IP "\fB\s-1LEVEL_IO\s0\fR to trace only function calls and returns" 4
.IX Item "LEVEL_IO to trace only function calls and returns"
.IP "\fB\s-1LEVEL_THREAD_ALL\s0\fR to trace everything about threads" 4
.IX Item "LEVEL_THREAD_ALL to trace everything about threads"
.IP "\fB\s-1LEVEL_THREAD_IO\s0\fR to trace only function calls and returns about threads" 4
.IX Item "LEVEL_THREAD_IO to trace only function calls and returns about threads"
.IP "\fB\s-1LEVEL_BARRIER_ALL\s0\fR to trace everything about barriers" 4
.IX Item "LEVEL_BARRIER_ALL to trace everything about barriers"
.IP "\fB\s-1LEVEL_BARRIER_IO\s0\fR to trace only function calls and returns about barriers" 4
.IX Item "LEVEL_BARRIER_IO to trace only function calls and returns about barriers"
.IP "\fB\s-1LEVEL_MUTEX_ALL\s0\fR to trace everything about mutexes" 4
.IX Item "LEVEL_MUTEX_ALL to trace everything about mutexes"
.IP "\fB\s-1LEVEL_MUTEX_IO\s0\fR to trace only function calls and returns about mutexes" 4
.IX Item "LEVEL_MUTEX_IO to trace only function calls and returns about mutexes"
.IP "\fB\s-1LEVEL_COND_ALL\s0\fR to trace everything about conditional variables" 4
.IX Item "LEVEL_COND_ALL to trace everything about conditional variables"
.IP "\fB\s-1LEVEL_COND_IO\s0\fR to trace only function calls and returns conditional variables" 4
.IX Item "LEVEL_COND_IO to trace only function calls and returns conditional variables"
.IP "\fB\s-1LEVEL_SEM_ALL\s0\fR to trace everything about semaphores" 4
.IX Item "LEVEL_SEM_ALL to trace everything about semaphores"
.IP "\fB\s-1LEVEL_SEM_IO\s0\fR to trace only function calls and returns semaphores" 4
.IX Item "LEVEL_SEM_IO to trace only function calls and returns semaphores"
.RE
.RS 4
.RE
.IP "\fB\-ori\fR" 4
.IX Item "-ori"
.PD
links \fIcmd\fR to the non-instrumented \s-1NPTL\s0
building in the installation process.
Therefore, the trace mechanism won't be active.
This can be useful to compare results
with and without the trace mechanism
(for example, to measure the impact of the instrumentation
in the patched library).
Other options will have no effect if you use \-ori.
.Sp
\&\fINote\fR: This option is not available
if \s-1PTT\s0 is built with the configure
\&\-\-with\-ptt\-friendly\-glibc option.
.SH "BUGS"
.IX Header "BUGS"
Stress programs sometimes hang
when using \s-1PTT\s0.
.PP
On some (rare) systems,
dynamic linkage to libpthread won't work
For such systems,
relink your application to the instrumented glibc,
using the following gcc flags:
.PP
\&\-Wl,\-dynamic\-linker,/<path\-to\-glibc>/lib/ld\-linux.so.2
\&\-Wl,\-rpath,/<path\-to\-glibc>/lib
.PP
Flags to apply for your system
are written in the file \fIpatch_glibc/flags.txt\fR
created when building glibc.
.SH "SEE ALSO"
.IX Header "SEE ALSO"
\&\fIptt_level\fR\|(1), \fIptt_view\fR\|(1), \fIptt_paje\fR\|(1)
.SH "AUTHOR"
.IX Header "AUTHOR"
Matthieu \s-1CASTET\s0, Nadege \s-1GRIESSER\s0, Guillaume \s-1DURANCEAU\s0