mptrace.ps

debug source code under unix platform.

(nts that occurred during a program').15 F 2.774(se)-.55 G -.15(xe)
-2.924 G .273(cution, and can be decoded into tab).15 F(u-)-.2 E
(lar or graphical form, along with an)108 189.6 Q 2.5(yr)-.15 G(ele)-2.5
E -.25(va)-.25 G(nt statistics that can be calculated.).25 E .937
(When the)108 206.4 R F2(TRA)3.437 E(CE)-.55 E F0 .937
(option is used with the mpatrol library)3.437 F 3.437(,s)-.65 G .938
(tatistics for all dynamic memory allocations,)-3.437 F 1.054(reallocat\
ions and deallocations are written to a tracing output \214le.)108 218.4
R 1.053(The name of this \214le can be changed)6.053 F(with the)108
230.4 Q F2(TRA)2.5 E(CEFILE)-.55 E F0(option.)2.5 E .291
(Only allocations, reallocations and deallocations are recorded.)108
247.2 R .292(The intention of tracing is to g)5.291 F .292
(ather concise)-.05 F 1.208(details about each memory allocation e)108
259.2 R -.15(ve)-.25 G 1.208
(nt rather than complete information about some or all memory).15 F
3.375(allocations. As)108 271.2 R 3.375(ar)3.375 G .875(esult, the mpat\
rol log \214les and pro\214ling output \214les contain more detailed in\
formation)-3.375 F .64(about indi)108 283.2 R .639(vidual memory alloca\
tions, whereas the tracing output \214les contain a broader vie)-.25 F
3.139(wo)-.25 G 3.139(fa)-3.139 G(llocation)-3.139 E(beha)108 295.2 Q
(viour throughout the entire program.)-.2 E(The)108 312 Q F3(\214le)
3.234 E F0(ar)3.234 E .734(gument must be a v)-.18 F .734
(alid mpatrol tracing output \214lename b)-.25 F .735(ut if)-.2 F F3
(\214le)3.235 E F0 .735(is omitted then)3.235 F F2(mptrace)3.235 E F0
(will)3.235 E(use)108 324 Q F3(mpatr)3.012 E(ol.tr)-.45 E(ace)-.15 E F0
.512(as the name of the tracing output \214le to use.)3.012 F(If)5.511 E
F3(\214le)3.011 E F0 .511(is gi)3.011 F -.15(ve)-.25 G 3.011(na).15 G(s)
-3.011 E F3<ad>3.011 E F0 .511(then the standard input)3.011 F
(\214le stream will be used as the tracing output \214le.)108 336 Q
3.608(ACs)108 352.8 S 1.108(ource \214le containing a trace-dri)-3.608 F
-.15(ve)-.25 G 3.609(nm).15 G 1.109
(emory allocation simulation program can be written with the)-3.609 F F2
<adad73696dad8c6c65>108 364.8 Q F0 4.44(option. This)4.44 F 1.939
(program will ha)4.44 F 2.239 -.15(ve t)-.2 H 1.939
(he identical memory allocation beha).15 F 1.939(viour to the program)
-.2 F 1.132(which produced the original trace \214le.)108 376.8 R 1.133
(This option can be useful to use if you wish to determine which)6.133 F
(malloc library is most suitable to use for a speci\214c application.)
108 388.8 Q 2.829(At)108 405.6 S .329(race \214le in Heap Allocation T)
-2.829 F .329(race F)-.35 F .329(ormat \(HA)-.15 F .329
(TF\) can also be written out by the)-1.11 F F2(mptrace)2.829 E F0 .328
(command by)2.828 F 1.021(using the)108 417.6 R F2<adad68617466ad8c6c65>
3.521 E F0 3.521(option. It)3.521 F(tak)3.521 E 1.021
(es the name of the HA)-.1 F 1.021
(TF trace \214le to be written as an ar)-1.11 F 1.022(gument and)-.18 F
.931(writes out the HA)108 429.6 R .931(TF v)-1.11 F .931
(ersion of the mpatrol tracing output \214le gi)-.15 F -.15(ve)-.25 G
3.43(na).15 G 3.43(si)-3.43 G .93(nput when it is being processed.)-3.43
F .709(The HA)108 441.6 R .709(TF \214le format is an attempt to standa\
rdise trace \214le formats for memory allocation tracing, and is)-1.11 F
.739(being de)108 453.6 R -.15(ve)-.25 G .739
(loped by Benjamin Zorn and Richard Jones.).15 F .738(There is a HA)
5.738 F .738(TF DTD located in the)-1.11 F F3 -.2(ex)3.238 G(tr).2 E(a)
-.15 E F0(direc-)3.238 E(tory in the mpatrol distrib)108 465.6 Q(ution.)
-.2 E(The)108 482.4 Q F2(mptrace)3.613 E F0 1.113
(command will normally be b)3.613 F 1.113
(uilt with GUI support on UNIX platforms that are running X)-.2 F -.4
(Wi)108 494.4 S(ndo).4 E 2.979(ws. This)-.25 F .478
(means that a graphical memory map display of the heap will be sho)2.979
F .478(wn in a windo)-.25 F 2.978(we)-.25 G -.15(ve)-3.228 G(ry).15 E
(time)108 506.4 Q F2(mptrace)2.557 E F0 .057(is run with the)2.557 F F2
<adad677569>2.557 E F0 2.557(option. This)2.557 F .057
(display is updated e)2.557 F -.15(ve)-.25 G .057(ry time a ne).15 F
2.557(we)-.25 G -.15(ve)-2.807 G .057(nt is read from the).15 F 2.007
(tracing output \214le and by def)108 518.4 R 2.006(ault uses the colou\
r red for internal heap memory \(used by the mpatrol)-.1 F 2.405
(library\), blue for unallocated heap memory)108 530.4 R 4.906(,b)-.65 G
2.406(lack for allocated memory and white for free memory)-4.906 F(.)
-.65 E(Options e)108 542.4 Q(xist to change this colour scheme, as well\
 as the dimensions of the dra)-.15 E(wing area and the windo)-.15 E -.65
(w.)-.25 G .412(By def)108 559.2 R .412
(ault, it is assumed that the start address of the \214rst e)-.1 F -.15
(ve)-.25 G .412(nt that appears in the tracing output \214le is the).15
F .193(base address of the memory map displayed in the windo)108 571.2 R
3.994 -.65(w. I)-.25 H 2.694(ft).65 G .194(he heap gro)-2.694 F .194
(ws do)-.25 F(wnw)-.25 E .194(ards then this assump-)-.1 F .399
(tion will be incorrect \(since nothing will be displayed\) and so the)
108 583.2 R F2(\255\255base)2.899 E F0 .399
(option must be used to specify a)2.899 F .717(reasonable lo)108 595.2 R
.717(wer bound for the \214nal memory map.)-.25 F .718
(In addition, the visible address space displayed in the)5.717 F .508
(memory map is \214x)108 607.2 R .508(ed to a certain size \(4 me)-.15 F
-.05(ga)-.15 G .508(bytes by def).05 F .508(ault\), b)-.1 F .508
(ut this can be changed with the)-.2 F F2(\255\255space)3.007 E F0 2.615
(option. A)108 619.2 R .115(small delay can also be added after dra)
2.615 F .116(wing each memory allocation e)-.15 F -.15(ve)-.25 G .116
(nt through the use of the).15 F F2(\255\255delay)108 631.2 Q F0
(option.)2.5 E 1.281(Note that an)108 648 R 3.781(yo)-.15 G 1.281
(ptions that are speci\214c to the GUI v)-3.781 F 1.28(ersion of)-.15 F
F2(mptrace)3.78 E F0 1.28(are read by the X command line)3.78 F .425
(parser rather than directly by)108 660 R F2(mptrace)2.925 E F0 5.425
(.A)C 2.925(sar)-5.425 G .425(esult the)-2.925 F 2.925(ya)-.15 G .426
(re parsed according to X toolkit rules and do not)-2.925 F 1.001
(appear in the quick-reference option summary produced by the)108 672 R
F2(\255\255help)3.501 E F0 3.5(option. The)3.501 F 1
(application class for)3.5 F(setting)108 684 Q F2(mptrace)2.5 E F0 2.5
(Xr)2.5 G(esources is called)-2.5 E F3(MPT)2.5 E -.15(ra)-.55 G(ce).15 E
F0(.)A .824(The idea for graphically displaying a memory map of the hea\
p comes from the)108 700.8 R F2(xmem)3.324 E F0 .825(tool supplied with)
3.324 F 1.134(the Uni)108 712.8 R -.15(ve)-.25 G 1.133(rsity of T).15 F
1.133(oronto Computer Systems Research Institute malloc library)-.8 F
3.633(,w)-.65 G 1.133(ritten by Mark Moraes.)-3.633 F(Ho)108 724.8 Q(we)
-.25 E -.15(ve)-.25 G 2.754 -.4(r, t).15 H 1.954
(he documentation for that tool remarks that it w).4 F 1.954
(as written as a quick and dirty hack.)-.1 F(The)6.955 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(MPTRA)72 48 Q 142.875(CE\(1\) mpatrol)-.4 F
142.875(library MPTRA)2.5 F(CE\(1\))-.4 E/F1 10/Times-Bold@0 SF(mptrace)
108 84 Q F0
(command is hopefully more stable and contains a lot more functionality)
2.5 E(.)-.65 E/F2 10.95/Times-Bold@0 SF(OPTIONS)72 100.8 Q F1
<adad677569>108 112.8 Q F0([)2.5 E F1<ad77>A F0(])A
(Displays the GUI \(if supported\).)144 124.8 Q F1<adad68617466ad8c6c65>
108 141.6 Q/F3 10/Times-Italic@0 SF(\214le)2.5 E F0([)2.5 E F1<ad48>A F0
(])A(Speci\214es that the trace should also be written to a \214le in H\
eap Allocation T)144 153.6 Q(race F)-.35 E(ormat \(HA)-.15 E(TF\).)-1.11
E F1(\255\255help)108 170.4 Q F0([)2.5 E F1<ad68>A F0(])A
(Displays a quick-reference option summary)144 182.4 Q(.)-.65 E F1
<adad73696dad8c6c65>108 199.2 Q F3(\214le)2.5 E F0([)2.5 E F1<ad53>A F0
(])A .303(Speci\214es that a trace-dri)144 211.2 R -.15(ve)-.25 G 2.803
(nm).15 G .303
(emory allocation simulation program written in C should be written)
-2.803 F(to a \214le.)144 223.2 Q F1(\255\255sour)108 240 Q(ce)-.18 E F0
([)2.5 E F1<ad73>A F0(])A(Displays source-le)144 252 Q -.15(ve)-.25 G
2.5(li).15 G(nformation for each e)-2.5 E -.15(ve)-.25 G
(nt in the tracing table, if a).15 E -.25(va)-.2 G(ilable.).25 E F1
<adad76>108 268.8 Q(erbose)-.1 E F0([)2.5 E F1<ad76>A F0(])A
(Speci\214es that the tracing table should be displayed.)144 280.8 Q F1
<adad76>108 297.6 Q(ersion)-.1 E F0([)2.5 E F1<ad56>A F0(])A
(Displays the v)144 309.6 Q(ersion number of the)-.15 E F1(mptrace)2.5 E
F0(command.)2.5 E F2(GUI OPTIONS)72 326.4 Q F1(\255\255alloc)108 338.4 Q
F3(colour)2.5 E F0
(Speci\214es the colour to use for displaying allocated memory)144 350.4
Q 5(.T)-.65 G(he def)-5 E(ault colour is)-.1 E F3(blac)2.5 E(k)-.2 E F0
(.)A F1(\255\255base)108 367.2 Q F3(addr)2.5 E(ess)-.37 E F0 .393(Speci\
\214es the base address of the visible address space displayed in the m\
emory map.)144 379.2 R .393(The def)5.393 F(ault)-.1 E .508(address is \
calculated at run-time from the start address of the \214rst memory all\
ocation e)144 391.2 R -.15(ve)-.25 G .508(nt in the).15 F
(tracing output \214le.)144 403.2 Q F1(\255\255delay)108 420 Q F3
(length)2.5 E F0 .147(Speci\214es that a small delay of a certain lengt\
h should be added after dra)144 432 R .147(wing each memory alloca-)-.15
F .442(tion e)144 444 R -.15(ve)-.25 G 2.942(nt. The).15 F .442
(delay does not correspond to a speci\214c unit of time, b)2.942 F .442
(ut e)-.2 F .441(xperimentation with the)-.15 F
(length should yield satisf)144 456 Q(actory results.)-.1 E(The def)5 E
(ault delay is)-.1 E F3(0)2.5 E F0(.)A F1<adad6672>108 472.8 Q(ee)-.18 E
F3(colour)2.5 E F0
(Speci\214es the colour to use for displaying free memory)144 484.8 Q 5
(.T)-.65 G(he def)-5 E(ault colour is)-.1 E F3(white)2.5 E F0(.)A F1
(\255\255height)108 501.6 Q F3(size)2.5 E F0
(Speci\214es the height \(in pix)144 513.6 Q(els\) of the dra)-.15 E
(wing area.)-.15 E(The def)5 E(ault height is)-.1 E F3(512)2.5 E F0(.)A
F1(\255\255inter)108 530.4 Q(nal)-.15 E F3(colour)2.5 E F0
(Speci\214es the colour to use for displaying internal heap memory)144
542.4 Q 5(.T)-.65 G(he def)-5 E(ault colour is)-.1 E F3 -.37(re)2.5 G(d)
.37 E F0(.)A F1(\255\255space)108 559.2 Q F3(size)2.5 E F0 .584
(Speci\214es the size \(in me)144 571.2 R -.05(ga)-.15 G .584
(bytes\) of the visible address space displayed in the memory map.).05 F
(The)5.584 E(def)144 583.2 Q(ault size is)-.1 E F3(4)2.5 E F0(.)A F1
(\255\255unalloc)108 600 Q F3(colour)2.5 E F0
(Speci\214es the colour to use for displaying unallocated heap memory)
144 612 Q 5(.T)-.65 G(he def)-5 E(ault colour is)-.1 E F3(blue)2.5 E F0
(.)A F1(\255\255view\255height)108 628.8 Q F3(size)2.5 E F0
(Speci\214es the height \(in pix)144 640.8 Q(els\) of the windo)-.15 E
3.8 -.65(w. T)-.25 H(he def).65 E(ault height is)-.1 E F3(256)2.5 E F0
(.)A F1(\255\255view\255width)108 657.6 Q F3(size)2.5 E F0
(Speci\214es the width \(in pix)144 669.6 Q(els\) of the windo)-.15 E
3.8 -.65(w. T)-.25 H(he def).65 E(ault width is)-.1 E F3(256)2.5 E F0(.)
A F1(\255\255width)108 686.4 Q F3(size)2.5 E F0
(Speci\214es the width \(in pix)144 698.4 Q(els\) of the dra)-.15 E
(wing area.)-.15 E(The def)5 E(ault width is)-.1 E F3(512)2.5 E F0(.)A
(Release 1.4)72 768 Q 2.5(8J)157.35 G(anuary 2002)-2.5 E(2)198.45 E EP
%%Page: 3 3
%%BeginPageSetup
BP
%%EndPageSetup
/F0 10/Times-Roman@0 SF(MPTRA)72 48 Q 142.875(CE\(1\) mpatrol)-.4 F
142.875(library MPTRA)2.5 F(CE\(1\))-.4 E/F1 10.95/Times-Bold@0 SF
(SEE ALSO)72 84 Q/F2 10/Times-Bold@0 SF(mpatr)108 96 Q(ol)-.18 E F0
(\(1\),)A F2(mpr)5.129 E(of)-.18 E F0(\(1\),)A F2(mleak)5.129 E F0
(\(1\),)A F2(mpsym)5.129 E F0(\(1\),)A F2(mpedit)5.129 E F0(\(1\),)A F2
(hexw)5.129 E(ords)-.1 E F0(\(1\),)A F2(X)5.129 E F0(\(1\),)A F2
(libmpatr)5.128 E(ol)-.18 E F0(\(3\),)A F2(libmpal-)5.128 E(loc)108 108
Q F0(\(3\).)A(The mpatrol manual and reference card.)108 124.8 Q
(http://www)108 141.6 Q(.cbmamig)-.65 E(a.demon.co.uk/mpatrol/)-.05 E F1
-.548(AU)72 158.4 S(THOR).548 E F0(Graeme S. Ro)108 170.4 Q 2.5(y<)-.1 G
(graeme.ro)-2.5 E([e-mail]>)-.1 E F1(COPYRIGHT)72 187.2 Q F0(Cop)108
199.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
216 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 228 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 240 Q 2.5
(yl)-.15 G(ater v)-2.5 E(ersion.)-.15 E 1.03(This library is distrib)108
256.8 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 268.8 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 280.8 Q
-1.1(Yo)108 297.6 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 309.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(3)198.45 E EP
%%Trailer
end
%%EOF