mpsym.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 153.585(MPSYM\(1\) mpatrol)72 48 R 153.585
(library MPSYM\(1\))2.5 F/F1 10.95/Times-Bold@0 SF -.219(NA)72 84 S(ME)
.219 E F0(mpsym \255 locates missing symbolic information in an mpatrol\
 log \214le)108 96 Q F1(SYNOPSIS)72 112.8 Q/F2 10/Times-Bold@0 SF(mpsym)
108 124.8 Q F0([)2.5 E/F3 10/Times-Italic@0 SF(options)A F0 2.5(][)C F3
(pr)-2.5 E -.1(og)-.45 G(\214le).1 E F0([)2.5 E F3(lo)A(g\214le)-.1 E F0
(]])A F1(DESCRIPTION)72 141.6 Q F0(The)108 153.6 Q F2(mpsym)3.365 E F0
.865(command is used to parse a log \214le produced by the mpatrol libr\
ary and uses a deb)3.365 F .864(ugger to)-.2 F .628
(append symbol names and source le)108 165.6 R -.15(ve)-.25 G 3.128(li)
.15 G .628(nformation to code addresses in stack tracebacks.)-3.128 F
.628(This should be)5.628 F .433(used if the)108 177.6 R F2(USEDEB)2.933
E(UG)-.1 E F0 .433
(option is not supported on a particular platform or does not w)2.933 F
.432(ork properly with a)-.1 F .081(speci\214c program.)108 189.6 R .081
(It will replace all e)5.081 F .081(xisting symbols and source le)-.15 F
-.15(ve)-.25 G 2.582(li).15 G .082(nformation associated with the stack)
-2.582 F(tracebacks in the mpatrol log \214le and will display the resu\
lting log \214le on the standard output \214le stream.)108 201.6 Q(The)
108 218.4 Q F3(pr)3.177 E -.1(og)-.45 G(\214le).1 E F0(ar)3.177 E .676
(gument must be the \214lename of the e)-.18 F -.15(xe)-.15 G .676
(cutable \214le that produced the mpatrol log \214le b).15 F .676(ut if)
-.2 F F3(pr)108 230.4 Q -.1(og)-.45 G(\214le).1 E F0 .415
(is omitted then)2.915 F F2(mpsym)2.915 E F0 .415(will use)2.915 F F3
(a.out)2.915 E F0 .415(as the name of the e)2.915 F -.15(xe)-.15 G .416
(cutable \214le to use.).15 F(The)5.416 E F2(mpsym)2.916 E F0(com-)2.916
E .681(mand will read the symbol table and deb)108 242.4 R .68
(ugging sections from this \214le in order to map the code addresses)-.2
F .865
(that appear in the mpatrol log \214le into symbol names and source le)
108 254.4 R -.15(ve)-.25 G 3.365(li).15 G 3.365(nformation. If)-3.365 F
.865(the e)3.365 F -.15(xe)-.15 G .865(cutable \214le).15 F .014
(does not contain a symbol table then no symbol names will be a)108
266.4 R -.25(va)-.2 G .013(ilable and if it does not contain the appro-)
.25 F 2.202(priate deb)108 278.4 R 2.203
(ugging sections then no source le)-.2 F -.15(ve)-.25 G 4.703(li).15 G
2.203(nformation will be a)-4.703 F -.25(va)-.2 G 2.203(ilable either)
.25 F 7.203(.O)-.55 G -.15(bv)-7.203 G(iously).15 E 4.703(,i)-.65 G
4.703(ft)-4.703 G(he)-4.703 E -.15(exe)108 290.4 S 1.451(cutable \214le\
 is not the same as the one that created the mpatrol log \214le then th\
e \214nal output will be).15 F(wrong.)108 302.4 Q(The)108 319.2 Q F3(lo)
3.583 E(g\214le)-.1 E F0(ar)3.583 E 1.084(gument must be a v)-.18 F
1.084(alid mpatrol log \214lename b)-.25 F 1.084(ut if)-.2 F F3(lo)3.584
E(g\214le)-.1 E F0 1.084(is omitted then)3.584 F F2(mpsym)3.584 E F0
1.084(will use)3.584 F F3(mpatr)108 331.2 Q(ol.lo)-.45 E(g)-.1 E F0
1.006(as the name of the log \214le to use, or)3.506 F F3(pr)3.506 E -.1
(og)-.45 G(\214le).1 E(.lo)-.15 E(g)-.1 E F0 1.006(if it can')3.506 F
3.506<748c>-.18 G 1.005(nd that.)-3.506 F(The)6.005 E F2(mpsym)3.505 E
F0(command)3.505 E(mak)108 343.2 Q(es tw)-.1 E 2.5(op)-.1 G(asses o)-2.5
E -.15(ve)-.15 G 2.5(rt).15 G
(he log \214le so the \214le must be randomly-accessable.)-2.5 E(The)108
360 Q F2(mpsym)2.964 E F0 .464(command currently uses)2.964 F F2(gdb)
2.964 E F0 .464(as the deb)2.964 F .464
(ugger with which to obtain the additional information)-.2 F .738
(about the code addresses in the mpatrol log \214le.)108 372 R .738
(It also mak)5.738 F .738(es use of se)-.1 F -.15(ve)-.25 G .737
(ral UNIX te).15 F .737(xt processing com-)-.15 F .32(mands, including)
108 384 R F2(perl)2.82 E F0 .32(if it is installed, in order to e)2.82 F
.32(xtract information from the deb)-.15 F(ugger')-.2 E 2.82(so)-.55 G
.32(utput and from)-2.82 F 1.053(the log \214le.)108 396 R 1.053
(As a result, the)6.053 F F2(mpsym)3.553 E F0 1.053(command is only lik)
3.553 F 1.053(ely to w)-.1 F 1.052(ork on UNIX platforms or on systems)
-.1 F(which ha)108 408 Q .3 -.15(ve t)-.2 H
(he necessary commands installed.).15 E F1(OPTIONS)72 424.8 Q F2
(\255\255help)108 436.8 Q F0([)2.5 E F2<ad68>A F0(])A
(Displays a quick-reference option summary)144 448.8 Q(.)-.65 E F2
(\255\255skip)108 465.6 Q F0([)2.5 E F2<ad73>A F0(])A(Skip symbols mark)
144 477.6 Q(ed as)-.1 E F3(???)2.5 E F0(in the log \214le.)2.5 E F2
<adad76>108 494.4 Q(ersion)-.1 E F0([)2.5 E F2<ad56>A F0(])A
(Displays the v)144 506.4 Q(ersion number of the)-.15 E F2(mpsym)2.5 E
F0(command.)2.5 E F1(SEE ALSO)72 523.2 Q F2(mpatr)108 535.2 Q(ol)-.18 E
F0(\(1\),)A F2(mpr)4.055 E(of)-.18 E F0(\(1\),)A F2(mptrace)4.055 E F0
(\(1\),)A F2(mleak)4.055 E F0(\(1\),)A F2(mpedit)4.055 E F0(\(1\),)A F2
(hexw)4.055 E(ords)-.1 E F0(\(1\),)A F2(gdb)4.055 E F0(\(1\),)A F2(perl)
4.055 E F0(\(1\),)A F2(libmpatr)4.055 E(ol)-.18 E F0(\(3\),)A F2
(libmpalloc)108 547.2 Q F0(\(3\).)A
(The mpatrol manual and reference card.)108 564 Q(http://www)108 580.8 Q
(.cbmamig)-.65 E(a.demon.co.uk/mpatrol/)-.05 E F1 -.548(AU)72 597.6 S
(THOR).548 E F0(Graeme S. Ro)108 609.6 Q 2.5(y<)-.1 G(graeme.ro)-2.5 E
([e-mail]>)-.1 E F1(COPYRIGHT)72 626.4 Q F0(Cop)108 638.4 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 655.2 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 667.2 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 679.2 Q
2.5(yl)-.15 G(ater v)-2.5 E(ersion.)-.15 E 1.031
(This library is distrib)108 696 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
708 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 720 Q
(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 153.585(MPSYM\(1\) mpatrol)72 48 R 153.585
(library MPSYM\(1\))2.5 F -1.1(Yo)108 84 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 96 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