mpatrol.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: 5
%%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(MP)72 48 Q -1.11(AT)-.92 G -.4(RO)1.11 G 144.355
(L\(1\) mpatrol).4 F 144.355(library MP)2.5 F -1.11(AT)-.92 G -.4(RO)
1.11 G(L\(1\)).4 E/F1 10.95/Times-Bold@0 SF -.219(NA)72 84 S(ME).219 E
F0(mpatrol \255 runs programs using the mpatrol library)108 96 Q F1
(SYNOPSIS)72 112.8 Q/F2 10/Times-Bold@0 SF(mpatr)108 124.8 Q(ol)-.18 E
F0([)2.5 E/F3 10/Times-Italic@0 SF(options)A F0 2.5(]<)C F3(command)-2.5
E F0 2.5(>[)C F3(ar)-2.5 E(guments)-.37 E F0(])A F1(DESCRIPTION)72 141.6
Q F0(The)108 153.6 Q F2(mpatr)2.608 E(ol)-.18 E F0 .108
(command is used to set v)2.608 F .108(arious mpatrol library)-.25 F F3
(options)2.607 E F0 .107(when running)2.607 F F3(command)2.607 E F0 .107
(with its)2.607 F F3(ar)2.607 E(gu-)-.37 E(ments)108 165.6 Q F0 6.328
(.I)C 3.828(nm)-6.328 G 1.328(ost cases,)-3.828 F F3(command)3.828 E F0
1.329(must ha)3.828 F 1.629 -.15(ve b)-.2 H 1.329(een link).15 F 1.329
(ed with the mpatrol library)-.1 F 3.829(,u)-.65 G 1.329(nless the)
-3.829 F F3(\255\255dynamic)3.829 E F0(option is used in which case)108
177.6 Q F3(command)2.5 E F0(need only ha)2.5 E .3 -.15(ve b)-.2 H
(een dynamically link).15 E(ed.)-.1 E .205
(All mpatrol library diagnostics are sent to the \214le)108 194.4 R F3
(mpatr)2.704 E(ol.%n.lo)-.45 E(g)-.1 E F0 .204
(in the current directory by def)2.704 F .204(ault \(where)-.1 F F3(%n)
108 206.4 Q F0 1.065(is the current process id\) b)3.565 F 1.065
(ut this can be changed using the)-.2 F F2<adad6c6f67ad8c6c65>3.566 E F0
3.566(option. Similarly)3.566 F 3.566(,t)-.65 G 1.066(he def)-3.566 F
(ault)-.1 E(pro\214ling output \214lename is)108 218.4 Q F3(mpatr)2.5 E
(ol.%n.out)-.45 E F0(and the def)2.5 E
(ault tracing output \214lename is)-.1 E F3(mpatr)2.5 E(ol.%n.tr)-.45 E
(ace)-.15 E F0(.)A F1(OPTIONS)72 235.2 Q F0 2.171(All of the follo)108
247.2 R 2.171(wing options \(e)-.25 F(xcept)-.15 E F2(\255\255dynamic)
4.671 E F0(,)A F2(\255\255help)4.671 E F0(,)A F2<adad72>4.671 E
(ead\255en)-.18 E(v)-.4 E F0(,)A F2<adad73686f>4.671 E(w\255en)-.1 E(v)
-.4 E F0(,)A F2<adad746872>4.671 E(eads)-.18 E F0(and)4.67 E F2<adad76>
108 259.2 Q(ersion)-.1 E F0 3.24(\)c)C .74
(orrespond to their listed mpatrol library option.)-3.24 F(See)5.741 E
F2(libmpatr)3.241 E(ol)-.18 E F0 .741(\(3\) for more details on these)B
(options.)108 271.2 Q F2(\255\255alloc\255byte)108 288 Q F0(<)2.5 E F3
(unsigned inte)A -.1(ge)-.4 G(r).1 E F0 2.5(>[)C F2<ad61>-2.5 E F0(])A
([)144 300 Q F2(ALLOCBYTE)A F0 5(]S)C
(peci\214es an 8-bit byte pattern with which to pre\214ll ne)-5 E
(wly-allocated memory)-.25 E(.)-.65 E F2(\255\255alloc\255stop)108 316.8
Q F0(<)2.5 E F3(unsigned inte)A -.1(ge)-.4 G(r).1 E F0 2.5(>[)C F2<ad41>
-2.5 E F0(])A([)144 328.8 Q F2(ALLOCST)A(OP)-.18 E F0 5.276(]S)C .276
(peci\214es an allocation inde)-5.276 F 2.776(xa)-.15 G 2.775(tw)-2.776
G .275(hich to stop the program when it is being allo-)-2.775 F(cated.)
144 340.8 Q F2(\255\255allo)108 357.6 Q<77ad6f8d6f>-.1 E(w)-.1 E F0([)
2.5 E F2<ad4d>A F0(])A([)144 369.6 Q F2(ALLO)A -.1(WO)-.5 G(FLO).1 E(W)
-.5 E F0 5.112(]S)C .113(peci\214es that a w)-5.112 F .113
(arning rather than an error should be produced if an)-.1 F 2.613(ym)
-.15 G(em-)-2.613 E 1.278(ory operation function o)144 381.6 R -.15(ve)
-.15 G(r\215o).15 E 1.278
(ws the boundaries of a memory allocation, and that the operation)-.25 F
(should still be performed.)144 393.6 Q F2(\255\255auto\255sa)108 410.4
Q -.1(ve)-.25 G F0(<)2.6 E F3(unsigned inte)A -.1(ge)-.4 G(r).1 E F0 2.5
(>[)C F2<ad73>-2.5 E F0(])A([)144 422.4 Q F2 -.5(AU)C -.18(TO).5 G(SA)
.18 E(VE)-1.45 E F0 5.178(]S)C .178(peci\214es the frequenc)-5.178 F
2.678(ya)-.15 G 2.678(tw)-2.678 G .179
(hich to periodically write the pro\214ling data to the pro-)-2.678 F
(\214ling output \214le.)144 434.4 Q F2(\255\255check)108 451.2 Q F0(<)
2.5 E F3(unsigned r)A(ang)-.15 E(e)-.1 E F0 2.5(>[)C F2<ad63>-2.5 E F0
(])A([)144 463.2 Q F2(CHECK)A F0 5.526(]S)C .526
(peci\214es a range of allocation indices at which to check the inte)
-5.526 F .526(grity of free memory)-.15 F(and o)144 475.2 Q -.15(ve)-.15
G(r\215o).15 E 2.5(wb)-.25 G(uf)-2.7 E(fers.)-.25 E F2
(\255\255check\255all)108 492 Q F0([)2.5 E F2<ad43>A F0(])A([)144 504 Q
F2(CHECKALL)A F0 9.054(]E)C(qui)-9.054 E -.25(va)-.25 G 4.054
(lent to the).25 F F2(\255\255check\255allocs)6.554 E F0(,)A F2
(\255\255check\255r)6.554 E(eallocs)-.18 E F0(,)A F2
(\255\255check\255fr)6.555 E(ees)-.18 E F0(and)6.555 E F2
(\255\255check\255memory)144 516 Q F0(options speci\214ed together)2.5 E
(.)-.55 E F2(\255\255check\255allocs)108 532.8 Q F0([)144 544.8 Q F2
(CHECKALLOCS)A F0 5(]C)C(hecks that no attempt is made to allocate a bl\
ock of memory of size zero.)-5 E F2(\255\255check\255f)108 561.6 Q(ork)
-.25 E F0([)144 573.6 Q F2(CHECKFORK)A F0 5.321(]C)C .321(hecks at e)
-5.321 F -.15(ve)-.25 G .321
(ry call to see if the process has been fork).15 F .32(ed in case ne)-.1
F 2.82(wl)-.25 G .32(og, pro-)-2.82 F
(\214ling and tracing output \214les need to be started.)144 585.6 Q F2
(\255\255check\255fr)108 602.4 Q(ees)-.18 E F0([)144 614.4 Q F2
(CHECKFREES)A F0 5(]C)C(hecks that no attempt is made to deallocate a)-5
E F2(NULL)2.5 E F0(pointer)2.5 E(.)-.55 E F2(\255\255check\255memory)108
631.2 Q F0([)144 643.2 Q F2(CHECKMEMOR)A(Y)-.35 E F0 5.928(]C)C .928
(hecks that no attempt is made to perform a zero-length memory opera-)
-5.928 F(tion on a)144 655.2 Q F2(NULL)2.5 E F0(pointer)2.5 E(.)-.55 E
F2(\255\255check\255r)108 672 Q(eallocs)-.18 E F0([)144 684 Q F2
(CHECKREALLOCS)A F0 5.85(]C)C .849
(hecks that no attempt is made to reallocate a)-5.85 F F2(NULL)3.349 E
F0 .849(pointer or resize)3.349 F(an e)144 696 Q
(xisting block of memory to size zero.)-.15 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