mleak.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: 1
%%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 154.155(MLEAK\(1\) mpatrol)72 48 R 154.155
(library MLEAK\(1\))2.5 F/F1 10.95/Times-Bold@0 SF -.219(NA)72 84 S(ME)
.219 E F0(mleak \255 locates memory leaks in an mpatrol log \214le)108
96 Q F1(SYNOPSIS)72 112.8 Q/F2 10/Times-Bold@0 SF(mleak)108 124.8 Q 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(mleak)3.716 E F0
1.215(command is used to display all unfreed memory allocations from a \
log \214le produced by the)3.716 F .107(mpatrol library)108 165.6 R
5.107(.T)-.65 G .107(his should be used if the mpatrol library could no\
t \214nish writing the log \214le due to abnor)-5.107 F(-)-.2 E .171
(mal program termination \(which w)108 177.6 R .171(ould pre)-.1 F -.15
(ve)-.25 G .171(nt the).15 F F2(SHO)2.671 E(WUNFREED)-.5 E F0 .171
(option from w)2.671 F .17(orking\), b)-.1 F .17(ut note that)-.2 F
(some of the unfreed allocations might ha)108 189.6 Q .3 -.15(ve b)-.2 H
(een freed if the program had terminated successfully).15 E(.)-.65 E
(The)108 206.4 Q F2(mleak)4.292 E F0 1.793
(command scans through an mpatrol log \214le looking for lines be)4.292
F 1.793(ginning with)-.15 F F3(ALLOC:)4.293 E F0(and)4.293 E F3(FREE:)
108 218.4 Q F0 -.2(bu)2.764 G 2.764(ti).2 G .264(gnores lines be)-2.764
F .264(ginning with)-.15 F F3(REALLOC:)2.764 E F0 2.764(,s)C 2.764(oo)
-2.764 G .264(nly the)-2.764 F F2(LOGALLOCS)2.764 E F0(and)2.764 E F2
(LOGFREES)2.763 E F0(options)2.763 E 1.283
(are necessary when running a program link)108 230.4 R 1.283
(ed with the mpatrol library)-.1 F 6.283(.N)-.65 G 1.284
(ote that as a result of this, no)-6.283 F .453(attempt is made to acco\
unt for resizing of memory allocations and so the total amount of memor\
y used by)108 242.4 R
(the resulting unfreed allocations may not be entirely accurate.)108
254.4 Q .975(This command will also read the unfreed allocations table \
produced by the)108 271.2 R F2(SHO)3.475 E(WUNFREED)-.5 E F0 .975
(option in)3.475 F .562(the log \214le if one is present.)108 283.2 R
.562(The entries in the table will be compared with the currently alloc\
ated entries)5.562 F(and will be added if not already present.)108 295.2
Q(The)108 312 Q F3(\214le)2.551 E F0(ar)2.551 E .051(gument must be a v)
-.18 F .051(alid mpatrol log \214lename b)-.25 F .051(ut if)-.2 F F3
(\214le)2.551 E F0 .051(is omitted then)2.551 F F2(mleak)2.551 E F0 .051
(will use)2.551 F F3(mpatr)2.552 E(ol.lo)-.45 E(g)-.1 E F0 .318
(as the name of the log \214le to use.)108 324 R(The)5.317 E F2(mleak)
2.817 E F0 .317(command mak)2.817 F .317(es tw)-.1 F 2.817(op)-.1 G .317
(asses o)-2.817 F -.15(ve)-.15 G 2.817(rt).15 G .317
(he log \214le so the \214le must)-2.817 F(be randomly-accessable.)108
336 Q(If)5 E F3(\214le)2.5 E F0(is gi)2.5 E -.15(ve)-.25 G 2.5(na).15 G
(s)-2.5 E F3<ad>2.5 E F0
(then the standard input \214le stream will be used as the log \214le.)
2.5 E F1(OPTIONS)72 352.8 Q F2(\255\255help)108 364.8 Q F0([)2.5 E F2
<ad68>A F0(])A(Displays a quick-reference option summary)144 376.8 Q(.)
-.65 E F2(\255\255ignor)108 393.6 Q(e)-.18 E F0([)2.5 E F2<ad69>A F0(])A
(Speci\214es that the list of unfreed allocations in the log \214le sho\
uld be ignored.)144 405.6 Q F2(\255\255max\255stack)108 422.4 Q F3
(depth)2.5 E F0([)2.5 E F2<ad6e>A F0(])A .755(Speci\214es the maximum s\
tack depth to display for each unfreed memory allocation.)144 434.4 R
(If)5.756 E F3(depth)3.256 E F0(is)3.256 E F3(0)3.256 E F0
(then the call stack depth will be unlimited in size.)144 446.4 Q
(The def)5 E(ault call stack depth is)-.1 E F3(0)2.5 E F0(.)A F2<adad76>
108 463.2 Q(ersion)-.1 E F0([)2.5 E F2<ad56>A F0(])A(Displays the v)144
475.2 Q(ersion number of the)-.15 E F2(mleak)2.5 E F0(command.)2.5 E F1
(SEE ALSO)72 492 Q F2(mpatr)108 504 Q(ol)-.18 E F0(\(1\),)A F2(mpr)2.5 E
(of)-.18 E F0(\(1\),)A F2(mptrace)2.5 E F0(\(1\),)A F2(mpsym)2.5 E F0
(\(1\),)A F2(mpedit)2.5 E F0(\(1\),)A F2(hexw)2.5 E(ords)-.1 E F0
(\(1\),)A F2(libmpatr)2.5 E(ol)-.18 E F0(\(3\),)A F2(libmpalloc)2.5 E F0
(\(3\).)A(The mpatrol manual and reference card.)108 520.8 Q(http://www)
108 537.6 Q(.cbmamig)-.65 E(a.demon.co.uk/mpatrol/)-.05 E F1 -.548(AU)72
554.4 S(THOR).548 E F0(Graeme S. Ro)108 566.4 Q 2.5(y<)-.1 G(graeme.ro)
-2.5 E([e-mail]>)-.1 E F1(COPYRIGHT)72 583.2 Q F0(Cop)108 595.2 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 612 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 624 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 636 Q 2.5
(yl)-.15 G(ater v)-2.5 E(ersion.)-.15 E 1.031(This library is distrib)
108 652.8 R 1.031(uted in the hope that it will be useful, b)-.2 F 1.03
(ut WITHOUT ANY W)-.2 F(ARRANTY)-1.2 E 3.53(;w)-.92 G(ithout)-3.53 E
-2.15 -.25(ev e)108 664.8 T 2.729(nt).25 G .229(he implied w)-2.729 F
.229(arranty of MERCHANT)-.1 F .229(ABILITY or FITNESS FOR A P)-.93 F
(AR)-.92 E .23(TICULAR PURPOSE.)-.6 F(See)5.23 E
(the GNU Library General Public License for more details.)108 676.8 Q
-1.1(Yo)108 693.6 S 2.647(us)1.1 G .147(hould ha)-2.647 F .447 -.15
(ve r)-.2 H(ecei).15 E -.15(ve)-.25 G 2.647(dac).15 G(op)-2.647 E 2.647
(yo)-.1 G 2.647(ft)-2.647 G .146
(he GNU Library General Public License along with this library; if not,)
-2.647 F(write to the Free Softw)108 705.6 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(1)198.45 E EP
%%Trailer
end
%%EOF