mprof.ps

debug source code under unix platform.

%!PS-Adobe-3.0
%%Creator: groff version 1.16.1
%%CreationDate: Tue Jan  8 23:42:11 2002
%%DocumentNeededResources: font Times-Roman
%%+ font Times-Bold
%%+ font Times-Italic
%%DocumentSuppliedResources: procset grops 1.16 1
%%Pages: 2
%%PageOrder: Ascend
%%Orientation: Portrait
%%EndComments
%%BeginProlog
%%BeginResource: procset grops 1.16 1
/setpacking where{
pop
currentpacking
true setpacking
}if
/grops 120 dict dup begin
/SC 32 def
/A/show load def
/B{0 SC 3 -1 roll widthshow}bind def
/C{0 exch ashow}bind def
/D{0 exch 0 SC 5 2 roll awidthshow}bind def
/E{0 rmoveto show}bind def
/F{0 rmoveto 0 SC 3 -1 roll widthshow}bind def
/G{0 rmoveto 0 exch ashow}bind def
/H{0 rmoveto 0 exch 0 SC 5 2 roll awidthshow}bind def
/I{0 exch rmoveto show}bind def
/J{0 exch rmoveto 0 SC 3 -1 roll widthshow}bind def
/K{0 exch rmoveto 0 exch ashow}bind def
/L{0 exch rmoveto 0 exch 0 SC 5 2 roll awidthshow}bind def
/M{rmoveto show}bind def
/N{rmoveto 0 SC 3 -1 roll widthshow}bind def
/O{rmoveto 0 exch ashow}bind def
/P{rmoveto 0 exch 0 SC 5 2 roll awidthshow}bind def
/Q{moveto show}bind def
/R{moveto 0 SC 3 -1 roll widthshow}bind def
/S{moveto 0 exch ashow}bind def
/T{moveto 0 exch 0 SC 5 2 roll awidthshow}bind def
/SF{
findfont exch
[exch dup 0 exch 0 exch neg 0 0]makefont
dup setfont
[exch/setfont cvx]cvx bind def
}bind def
/MF{
findfont
[5 2 roll
0 3 1 roll
neg 0 0]makefont
dup setfont
[exch/setfont cvx]cvx bind def
}bind def
/level0 0 def
/RES 0 def
/PL 0 def
/LS 0 def
/MANUAL{
statusdict begin/manualfeed true store end
}bind def
/PLG{
gsave newpath clippath pathbbox grestore
exch pop add exch pop
}bind def
/BP{
/level0 save def
1 setlinecap
1 setlinejoin
72 RES div dup scale
LS{
90 rotate
}{
0 PL translate
}ifelse
1 -1 scale
}bind def
/EP{
level0 restore
showpage
}bind def
/DA{
newpath arcn stroke
}bind def
/SN{
transform
.25 sub exch .25 sub exch
round .25 add exch round .25 add exch
itransform
}bind def
/DL{
SN
moveto
SN
lineto stroke
}bind def
/DC{
newpath 0 360 arc closepath
}bind def
/TM matrix def
/DE{
TM currentmatrix pop
translate scale newpath 0 0 .5 0 360 arc closepath
TM setmatrix
}bind def
/RC/rcurveto load def
/RL/rlineto load def
/ST/stroke load def
/MT/moveto load def
/CL/closepath load def
/FL{
currentgray exch setgray fill setgray
}bind def
/BL/fill load def
/LW/setlinewidth load def
/RE{
findfont
dup maxlength 1 index/FontName known not{1 add}if dict begin
{
1 index/FID ne{def}{pop pop}ifelse
}forall
/Encoding exch def
dup/FontName exch def
currentdict end definefont pop
}bind def
/DEFS 0 def
/EBEGIN{
moveto
DEFS begin
}bind def
/EEND/end load def
/CNT 0 def
/level1 0 def
/PBEGIN{
/level1 save def
translate
div 3 1 roll div exch scale
neg exch neg exch translate
0 setgray
0 setlinecap
1 setlinewidth
0 setlinejoin
10 setmiterlimit
[]0 setdash
/setstrokeadjust where{
pop
false setstrokeadjust
}if
/setoverprint where{
pop
false setoverprint
}if
newpath
/CNT countdictstack def
userdict begin
/showpage{}def
}bind def
/PEND{
clear
countdictstack CNT sub{end}repeat
level1 restore
}bind def
end def
/setpacking where{
pop
setpacking
}if
%%EndResource
%%IncludeResource: font Times-Roman
%%IncludeResource: font Times-Bold
%%IncludeResource: font Times-Italic
grops begin/DEFS 1 dict def DEFS begin/u{.001 mul}bind def end/RES 72
def/PL 792 def/LS false def/ENC0[/asciicircum/asciitilde/Scaron/Zcaron
/scaron/zcaron/Ydieresis/trademark/quotesingle/.notdef/.notdef/.notdef
/.notdef/.notdef/.notdef/.notdef/.notdef/.notdef/.notdef/.notdef/.notdef
/.notdef/.notdef/.notdef/.notdef/.notdef/.notdef/.notdef/.notdef/.notdef
/.notdef/.notdef/space/exclam/quotedbl/numbersign/dollar/percent
/ampersand/quoteright/parenleft/parenright/asterisk/plus/comma/hyphen
/period/slash/zero/one/two/three/four/five/six/seven/eight/nine/colon
/semicolon/less/equal/greater/question/at/A/B/C/D/E/F/G/H/I/J/K/L/M/N/O
/P/Q/R/S/T/U/V/W/X/Y/Z/bracketleft/backslash/bracketright/circumflex
/underscore/quoteleft/a/b/c/d/e/f/g/h/i/j/k/l/m/n/o/p/q/r/s/t/u/v/w/x/y
/z/braceleft/bar/braceright/tilde/.notdef/quotesinglbase/guillemotleft
/guillemotright/bullet/florin/fraction/perthousand/dagger/daggerdbl
/endash/emdash/ff/fi/fl/ffi/ffl/dotlessi/dotlessj/grave/hungarumlaut
/dotaccent/breve/caron/ring/ogonek/quotedblleft/quotedblright/oe/lslash
/quotedblbase/OE/Lslash/.notdef/exclamdown/cent/sterling/currency/yen
/brokenbar/section/dieresis/copyright/ordfeminine/guilsinglleft
/logicalnot/minus/registered/macron/degree/plusminus/twosuperior
/threesuperior/acute/mu/paragraph/periodcentered/cedilla/onesuperior
/ordmasculine/guilsinglright/onequarter/onehalf/threequarters
/questiondown/Agrave/Aacute/Acircumflex/Atilde/Adieresis/Aring/AE
/Ccedilla/Egrave/Eacute/Ecircumflex/Edieresis/Igrave/Iacute/Icircumflex
/Idieresis/Eth/Ntilde/Ograve/Oacute/Ocircumflex/Otilde/Odieresis
/multiply/Oslash/Ugrave/Uacute/Ucircumflex/Udieresis/Yacute/Thorn
/germandbls/agrave/aacute/acircumflex/atilde/adieresis/aring/ae/ccedilla
/egrave/eacute/ecircumflex/edieresis/igrave/iacute/icircumflex/idieresis
/eth/ntilde/ograve/oacute/ocircumflex/otilde/odieresis/divide/oslash
/ugrave/uacute/ucircumflex/udieresis/yacute/thorn/ydieresis]def
/Times-Italic@0 ENC0/Times-Italic RE/Times-Bold@0 ENC0/Times-Bold RE
/Times-Roman@0 ENC0/Times-Roman RE
%%EndProlog
%%Page: 1 1
%%BeginPageSetup
BP
%%EndPageSetup
/F0 10/Times-Roman@0 SF(MPR)72 48 Q 156.205(OF\(1\) mpatrol)-.4 F
156.205(library MPR)2.5 F(OF\(1\))-.4 E/F1 10.95/Times-Bold@0 SF -.219
(NA)72 84 S(ME).219 E F0(mprof \255 displays pro\214ling information pr\
oduced by the mpatrol library)108 96 Q F1(SYNOPSIS)72 112.8 Q/F2 10
/Times-Bold@0 SF(mpr)108 124.8 Q(of)-.18 E F0([)2.5 E/F3 10
/Times-Italic@0 SF(options)A F0 2.5(][)C F3(\214le)-2.5 E F0(])A F1
(DESCRIPTION)72 141.6 Q F0(The)108 153.6 Q F2(mpr)3.025 E(of)-.18 E F0
.525(command is a tool designed to read a pro\214ling output \214le pro\
duced by the mpatrol library and)3.025 F .27
(display the pro\214ling information that w)108 165.6 R .271
(as obtained.)-.1 F .271
(The pro\214ling information includes summaries of all of)5.271 F .484(\
the memory allocations listed by size and the function that allocated t\
hem and a list of memory leaks with)108 177.6 R .372
(the call stack of the allocating function.)108 189.6 R .372
(It also includes a graph of all memory allocations listed in tab)5.372
F(ular)-.2 E(form, and an optional graph speci\214cation \214le for lat\
er processing by the)108 201.6 Q F2(dot)2.5 E F0
(graph visualisation package.)2.5 E .447(When the)108 218.4 R F2(PR)
2.947 E(OF)-.3 E F0 .447(option is used with the mpatrol library)2.947 F
2.947(,s)-.65 G .447(tatistics for all dynamic memory allocations and)
-2.947 F .779(deallocations are written to a pro\214ling output \214le.)
108 230.4 R .779(The name of this \214le can be changed with the)5.779 F
F2(PR)3.279 E(OF-)-.3 E(FILE)108 242.4 Q F0 .712
(option and the frequenc)3.212 F 3.211(ya)-.15 G 3.211(tw)-3.211 G .711
(hich the \214le is written can be speci\214ed with the)-3.211 F F2 -.5
(AU)3.211 G -.18(TO).5 G(SA).18 E(VE)-1.45 E F0(option.)3.211 E .779
(The bounds for small allocations, medium allocations, lar)108 254.4 R
.779(ge allocations and e)-.18 F .78(xtra lar)-.15 F .78
(ge allocations can be)-.18 F(set with the)108 266.4 Q F2(SMALLBOUND)2.5
E F0(,)A F2(MEDIUMBOUND)2.5 E F0(and)2.5 E F2(LARGEBOUND)2.5 E F0
(options.)2.5 E 1.914(Only allocations and deallocations are recorded, \
with each reallocation being treated as a deallocation)108 283.2 R 1.069
(immediately follo)108 295.2 R 1.069(wed by an allocation.)-.25 F -.15
(Fo)6.069 G 3.569(rf).15 G 1.069
(ull memory allocation pro\214ling support, call stack tra)-3.569 F -.15
(ve)-.2 G(rsal).15 E .093
(must be supported in the mpatrol library and all of the program')108
307.2 R 2.592(ss)-.55 G .092(ymbols must ha)-2.592 F .392 -.15(ve b)-.2
H .092(een successfully read).15 F 1.153
(by the mpatrol library before the program w)108 319.2 R 1.154(as run.)
-.1 F(The)6.154 E F2(mpr)3.654 E(of)-.18 E F0 1.154
(command will attempt to compensate if)3.654 F .318
(either of these requirements are not met, b)108 331.2 R .317
(ut the displayed tables may contain less meaningful information.)-.2 F
(The)108 348 Q F3(\214le)3.366 E F0(ar)3.366 E .866(gument must be a v)
-.18 F .867(alid mpatrol pro\214ling output \214lename b)-.25 F .867
(ut if)-.2 F F3(\214le)3.367 E F0 .867(is omitted then)3.367 F F2(mpr)
3.367 E(of)-.18 E F0(will)3.367 E(use)108 360 Q F3(mpatr)3.057 E(ol.out)
-.45 E F0 .556(as the name of the pro\214ling output \214le to use.)
3.057 F(If)5.556 E F3(\214le)3.056 E F0 .556(is gi)3.056 F -.15(ve)-.25
G 3.056(na).15 G(s)-3.056 E F3<ad>3.056 E F0 .556
(then the standard input)3.056 F
(\214le stream will be used as the pro\214ling output \214le.)108 372 Q
1.012(Much of the functionality of this tool is based upon)108 388.8 R
F2(mpr)3.512 E(of)-.18 E F0 1.012(by Benjamin Zorn and P)3.512 F 1.012
(aul Hil\214nger)-.15 F 3.512(,w)-.4 G(hich)-3.512 E -.1(wa)108 400.8 S
3.642(sw).1 G 1.142(ritten as a research project and ran on MIPS, SP)
-3.642 F 1.142(ARC and V)-.92 F 1.142(AX machines.)-1.35 F(Ho)6.142 E
(we)-.25 E -.15(ve)-.25 G 1.941 -.4(r, t).15 H 1.141(he pro\214ling).4 F
1.502(output \214les are incompatible, the tables displayed ha)108 412.8
R 1.802 -.15(ve a d)-.2 H(if).15 E 1.503(ferent format, and the w)-.25 F
1.503(ay the)-.1 F 4.003(ya)-.15 G 1.503(re imple-)-4.003 F
(mented is entirely dif)108 424.8 Q(ferent.)-.25 E F1(OPTIONS)72 441.6 Q
F2(\255\255addr)108 453.6 Q(esses)-.18 E F0([)2.5 E F2<ad61>A F0(])A
.168(Speci\214es that dif)144 465.6 R .168
(ferent call sites from within the same function are to be dif)-.25 F
.167(ferentiated and that the)-.25 F 1.45
(names of all functions should be displayed with their call site of)144
477.6 R 1.451(fset in bytes.)-.25 F 1.451(This af)6.451 F 1.451
(fects the)-.25 F .119(direct allocation and memory leak tables, as wel\
l as the allocation call graph and the graph speci\214-)144 489.6 R
(cation \214le.)144 501.6 Q F2(\255\255call\255graph)108 518.4 Q F0([)
2.5 E F2<ad76>A F0(])A .591
(Speci\214es that the allocation call graph should be displayed.)144
530.4 R .591(This is not displayed by def)5.591 F .592(ault as it)-.1 F
(can get v)144 542.4 Q(ery lar)-.15 E(ge for e)-.18 E -.15(ve)-.25 G 2.5
(nam).15 G(oderately sized pro\214ling output \214le.)-2.5 E F2
(\255\255counts)108 559.2 Q F0([)2.5 E F2<ad63>A F0(])A .711(Speci\214e\
s that certain tables should be sorted by the number of allocations or \
deallocations rather)144 571.2 R 1.84
(than the total number of bytes allocated or deallocated.)144 583.2 R
1.841(This af)6.841 F 1.841(fects the direct allocation and)-.25 F(memo\
ry leak tables, as well as the allocation call graph and the graph spec\
i\214cation \214le.)144 595.2 Q F2<adad6772617068ad8c6c65>108 612 Q F3
(\214le)2.5 E F0([)2.5 E F2<ad67>A F0(])A .483(Speci\214es that the all\
ocation call graph should also be written to a graph speci\214cation \
\214le for later)144 624 R .165(visualisation with)144 636 R F2(dot)
2.665 E F0 5.165(.I)C(f)-5.165 E F3(\214le)2.665 E F0 .165(is gi)2.665 F
-.15(ve)-.25 G 2.665(na).15 G(s)-2.665 E F3(stdout)2.665 E F0(or)2.665 E
F3(stderr)2.665 E F0 .166(then the corresponding \214le stream will be)
2.665 F(used as the tar)144 648 Q
(get for the graph speci\214cation \214le.)-.18 E F2(\255\255help)108
664.8 Q F0([)2.5 E F2<ad68>A F0(])A
(Displays a quick-reference option summary)144 676.8 Q(.)-.65 E F2
(\255\255leaks)108 693.6 Q F0([)2.5 E F2<ad6c>A F0(])A .423(Speci\214es\
 that memory leaks rather than memory allocations are to be written to \
the graph speci\214-)144 705.6 R(cation \214le.)144 717.6 Q
(This option only af)5 E(fects the output from the)-.25 E F2
<adad6772617068ad8c6c65>2.5 E F0(option.)2.5 E(Release 1.4)72 768 Q 2.5
(8J)157.35 G(anuary 2002)-2.5 E(1)198.45 E EP
%%Page: 2 2
%%BeginPageSetup
BP
%%EndPageSetup
/F0 10/Times-Roman@0 SF(MPR)72 48 Q 156.205(OF\(1\) mpatrol)-.4 F
156.205(library MPR)2.5 F(OF\(1\))-.4 E/F1 10/Times-Bold@0 SF
(\255\255stack\255depth)108 84 Q/F2 10/Times-Italic@0 SF(depth)2.5 E F0
([)2.5 E F1<ad6e>A F0(])A .307(Speci\214es the maximum stack depth to u\
se when calculating if one call site has the same call stack)144 96 R
1.489(as another call site.)144 108 R 1.488(This also speci\214es the m\
aximum number of functions to display in a call)6.488 F 2.692(stack. If)
144 120 R F2(depth)2.692 E F0(is)2.692 E F2(0)2.692 E F0 .192
(then the call stack depth will be unlimited in size.)2.692 F .192
(The def)5.192 F .193(ault call stack depth)-.1 F(is)144 132 Q F2(1)2.5
E F0 5(.T)C(his af)-5 E(fects the memory leak table.)-.25 E F1<adad76>
108 148.8 Q(ersion)-.1 E F0([)2.5 E F1<ad56>A F0(])A(Displays the v)144
160.8 Q(ersion number of the)-.15 E F1(mpr)2.5 E(of)-.18 E F0(command.)
2.5 E/F3 10.95/Times-Bold@0 SF(SEE ALSO)72 177.6 Q F1(mpatr)108 189.6 Q
(ol)-.18 E F0(\(1\),)A F1(mptrace)3.174 E F0(\(1\),)A F1(mleak)3.174 E
F0(\(1\),)A F1(mpsym)3.174 E F0(\(1\),)A F1(mpedit)3.173 E F0(\(1\),)A
F1(hexw)3.173 E(ords)-.1 E F0(\(1\),)A F1(pr)3.173 E(of)-.18 E F0
(\(1\),)A F1(gpr)3.173 E(of)-.18 E F0(\(1\),)A F1(dot)3.173 E F0(\(1\),)
A F1(libm-)3.173 E(patr)108 201.6 Q(ol)-.18 E F0(\(3\),)A F1(libmpalloc)
2.5 E F0(\(3\).)A(The mpatrol manual and reference card.)108 218.4 Q
(http://www)108 235.2 Q(.cbmamig)-.65 E(a.demon.co.uk/mpatrol/)-.05 E F3
-.548(AU)72 252 S(THOR).548 E F0(Graeme S. Ro)108 264 Q 2.5(y<)-.1 G
(graeme.ro)-2.5 E([e-mail]>)-.1 E F3(COPYRIGHT)72 280.8 Q F0(Cop)108
292.8 Q(yright \(C\) 1997-2002 Graeme S. Ro)-.1 E 2.5(y<)-.1 G
(graeme.ro)-2.5 E([e-mail]>)-.1 E .78(This library is free softw)108
309.6 R .78(are; you can redistrib)-.1 F .78
(ute it and/or modify it under the terms of the GNU Library)-.2 F .797
(General Public License as published by the Free Softw)108 321.6 R .797
(are F)-.1 F .797(oundation; either v)-.15 F .797
(ersion 2 of the License, or)-.15 F(\(at your option\) an)108 333.6 Q
2.5(yl)-.15 G(ater v)-2.5 E(ersion.)-.15 E 1.03(This library is distrib)
108 350.4 R 1.031(uted in the hope that it will be useful, b)-.2 F 1.031
(ut WITHOUT ANY W)-.2 F(ARRANTY)-1.2 E 3.531(;w)-.92 G(ithout)-3.531 E
-2.15 -.25(ev e)108 362.4 T 2.73(nt).25 G .23(he implied w)-2.73 F .229
(arranty of MERCHANT)-.1 F .229(ABILITY or FITNESS FOR A P)-.93 F(AR)
-.92 E .229(TICULAR PURPOSE.)-.6 F(See)5.229 E
(the GNU Library General Public License for more details.)108 374.4 Q
-1.1(Yo)108 391.2 S 2.646(us)1.1 G .146(hould ha)-2.646 F .446 -.15
(ve r)-.2 H(ecei).15 E -.15(ve)-.25 G 2.646(dac).15 G(op)-2.646 E 2.646
(yo)-.1 G 2.647(ft)-2.646 G .147
(he GNU Library General Public License along with this library; if not,)
-2.647 F(write to the Free Softw)108 403.2 Q(are F)-.1 E
(oundation, Inc., 59 T)-.15 E
(emple Place, Suite 330, Boston, MA 02111-1307, USA.)-.7 E(Release 1.4)
72 768 Q 2.5(8J)157.35 G(anuary 2002)-2.5 E(2)198.45 E EP
%%Trailer
end
%%EOF