%!PS-Adobe-1.0 %%Creator: quasar:davea (David Anderson) %%Title: stdin (ditroff) %%CreationDate: Sun Apr 16 16:11:22 2006 %%EndComments % Start of psdit.pro -- prolog for ditroff translator % Copyright (c) 1985,1987 Adobe Systems Incorporated. All Rights Reserved. % GOVERNMENT END USERS: See Notice file in TranScript library directory % -- probably /usr/lib/ps/Notice % $Revision: 1.31 $ /$DITroff 140 dict def $DITroff begin /fontnum 1 def /fontsize 10 def /fontheight 10 def /fontslant 0 def /xi {0 72 11 mul translate 72 resolution div dup neg scale 0 0 moveto /fontnum 1 def /fontsize 10 def /fontheight 10 def /fontslant 0 def F /pagesave save def}def /PB{save /psv exch def currentpoint translate resolution 72 div dup neg scale 0 0 moveto}def /PE{psv restore}def /m1 matrix def /m2 matrix def /m3 matrix def /oldmat matrix def /tan{dup sin exch cos div}bind def /point{resolution 72 div mul}bind def /dround {transform round exch round exch itransform}bind def /xT{/devname exch def}def /xr{/mh exch def /my exch def /resolution exch def}def /xp{}def /xs{docsave restore end}def /xt{}def /xf{/fontname exch def /slotno exch def fontnames slotno get fontname eq not {fonts slotno fontname findfont put fontnames slotno fontname put}if}def /xH{/fontheight exch def F}bind def /xS{/fontslant exch def F}bind def /s{/fontsize exch def /fontheight fontsize def F}bind def /f{/fontnum exch def F}bind def /F{fontheight 0 le {/fontheight fontsize def}if fonts fontnum get fontsize point 0 0 fontheight point neg 0 0 m1 astore fontslant 0 ne{1 0 fontslant tan 1 0 0 m2 astore m3 concatmatrix}if makefont setfont .04 fontsize point mul 0 dround pop setlinewidth}bind def /X{exch currentpoint exch pop moveto show}bind def /N{3 1 roll moveto show}bind def /Y{exch currentpoint pop exch moveto show}bind def /S /show load def /ditpush{}def/ditpop{}def /AX{3 -1 roll currentpoint exch pop moveto 0 exch ashow}bind def /AN{4 2 roll moveto 0 exch ashow}bind def /AY{3 -1 roll currentpoint pop exch moveto 0 exch ashow}bind def /AS{0 exch ashow}bind def /MX{currentpoint exch pop moveto}bind def /MY{currentpoint pop exch moveto}bind def /MXY /moveto load def /cb{pop}def % action on unknown char -- nothing for now /n{}def/w{}def /p{pop showpage pagesave restore /pagesave save def}def /abspoint{currentpoint exch pop add exch currentpoint pop add exch}def /dstroke{currentpoint stroke moveto}bind def /Dl{2 copy gsave rlineto stroke grestore rmoveto}bind def /arcellipse{oldmat currentmatrix pop currentpoint translate 1 diamv diamh div scale /rad diamh 2 div def rad 0 rad -180 180 arc oldmat setmatrix}def /Dc{gsave dup /diamv exch def /diamh exch def arcellipse dstroke grestore diamh 0 rmoveto}def /De{gsave /diamv exch def /diamh exch def arcellipse dstroke grestore diamh 0 rmoveto}def /Da{currentpoint /by exch def /bx exch def /fy exch def /fx exch def /cy exch def /cx exch def /rad cx cx mul cy cy mul add sqrt def /ang1 cy neg cx neg atan def /ang2 fy fx atan def cx bx add cy by add 2 copy rad ang1 ang2 arcn stroke exch fx add exch fy add moveto}def /Barray 200 array def % 200 values in a wiggle /D~{mark}def /D~~{counttomark Barray exch 0 exch getinterval astore /Bcontrol exch def pop /Blen Bcontrol length def Blen 4 ge Blen 2 mod 0 eq and {Bcontrol 0 get Bcontrol 1 get abspoint /Ycont exch def /Xcont exch def Bcontrol 0 2 copy get 2 mul put Bcontrol 1 2 copy get 2 mul put Bcontrol Blen 2 sub 2 copy get 2 mul put Bcontrol Blen 1 sub 2 copy get 2 mul put /Ybi /Xbi currentpoint 3 1 roll def def 0 2 Blen 4 sub {/i exch def Bcontrol i get 3 div Bcontrol i 1 add get 3 div Bcontrol i get 3 mul Bcontrol i 2 add get add 6 div Bcontrol i 1 add get 3 mul Bcontrol i 3 add get add 6 div /Xbi Xcont Bcontrol i 2 add get 2 div add def /Ybi Ycont Bcontrol i 3 add get 2 div add def /Xcont Xcont Bcontrol i 2 add get add def /Ycont Ycont Bcontrol i 3 add get add def Xbi currentpoint pop sub Ybi currentpoint exch pop sub rcurveto }for dstroke}if}def end /ditstart{$DITroff begin /nfonts 60 def % NFONTS makedev/ditroff dependent! /fonts[nfonts{0}repeat]def /fontnames[nfonts{()}repeat]def /docsave save def }def % character outcalls /oc {/pswid exch def /cc exch def /name exch def /ditwid pswid fontsize mul resolution mul 72000 div def /ditsiz fontsize resolution mul 72 div def ocprocs name known{ocprocs name get exec}{name cb} ifelse}def /fractm [.65 0 0 .6 0 0] def /fraction {/fden exch def /fnum exch def gsave /cf currentfont def cf fractm makefont setfont 0 .3 dm 2 copy neg rmoveto fnum show rmoveto currentfont cf setfont(\244)show setfont fden show grestore ditwid 0 rmoveto} def /oce {grestore ditwid 0 rmoveto}def /dm {ditsiz mul}def /ocprocs 50 dict def ocprocs begin (14){(1)(4)fraction}def (12){(1)(2)fraction}def (34){(3)(4)fraction}def (13){(1)(3)fraction}def (23){(2)(3)fraction}def (18){(1)(8)fraction}def (38){(3)(8)fraction}def (58){(5)(8)fraction}def (78){(7)(8)fraction}def (sr){gsave .05 dm .16 dm rmoveto(\326)show oce}def (is){gsave 0 .15 dm rmoveto(\362)show oce}def (->){gsave 0 .02 dm rmoveto(\256)show oce}def (<-){gsave 0 .02 dm rmoveto(\254)show oce}def (==){gsave 0 .05 dm rmoveto(\272)show oce}def end % DIThacks fonts for some special chars 50 dict dup begin /FontType 3 def /FontName /DIThacks def /FontMatrix [.001 0.0 0.0 .001 0.0 0.0] def /FontBBox [-220 -280 900 900] def% a lie but ... /Encoding 256 array def 0 1 255{Encoding exch /.notdef put}for Encoding dup 8#040/space put %space dup 8#110/rc put %right ceil dup 8#111/lt put %left top curl dup 8#112/bv put %bold vert dup 8#113/lk put %left mid curl dup 8#114/lb put %left bot curl dup 8#115/rt put %right top curl dup 8#116/rk put %right mid curl dup 8#117/rb put %right bot curl dup 8#120/rf put %right floor dup 8#121/lf put %left floor dup 8#122/lc put %left ceil dup 8#140/sq put %square dup 8#141/bx put %box dup 8#142/ci put %circle dup 8#143/br put %box rule dup 8#144/rn put %root extender dup 8#145/vr put %vertical rule dup 8#146/ob put %outline bullet dup 8#147/bu put %bullet dup 8#150/ru put %rule dup 8#151/ul put %underline pop /DITfd 100 dict def /BuildChar{0 begin /cc exch def /fd exch def /charname fd /Encoding get cc get def /charwid fd /Metrics get charname get def /charproc fd /CharProcs get charname get def charwid 0 fd /FontBBox get aload pop setcachedevice 40 setlinewidth newpath 0 0 moveto gsave charproc grestore end}def /BuildChar load 0 DITfd put %/UniqueID 5 def /CharProcs 50 dict def CharProcs begin /space{}def /.notdef{}def /ru{500 0 rls}def /rn{0 750 moveto 500 0 rls}def /vr{20 800 moveto 0 -770 rls}def /bv{20 800 moveto 0 -1000 rls}def /br{20 770 moveto 0 -1040 rls}def /ul{0 -250 moveto 500 0 rls}def /ob{200 250 rmoveto currentpoint newpath 200 0 360 arc closepath stroke}def /bu{200 250 rmoveto currentpoint newpath 200 0 360 arc closepath fill}def /sq{80 0 rmoveto currentpoint dround newpath moveto 640 0 rlineto 0 640 rlineto -640 0 rlineto closepath stroke}def /bx{80 0 rmoveto currentpoint dround newpath moveto 640 0 rlineto 0 640 rlineto -640 0 rlineto closepath fill}def /ci{355 333 rmoveto currentpoint newpath 333 0 360 arc 50 setlinewidth stroke}def /lt{20 -200 moveto 0 550 rlineto currx 800 2cx s4 add exch s4 a4p stroke}def /lb{20 800 moveto 0 -550 rlineto currx -200 2cx s4 add exch s4 a4p stroke}def /rt{20 -200 moveto 0 550 rlineto currx 800 2cx s4 sub exch s4 a4p stroke}def /rb{20 800 moveto 0 -500 rlineto currx -200 2cx s4 sub exch s4 a4p stroke}def /lk{20 800 moveto 20 300 -280 300 s4 arcto pop pop 1000 sub currentpoint stroke moveto 20 300 4 2 roll s4 a4p 20 -200 lineto stroke}def /rk{20 800 moveto 20 300 320 300 s4 arcto pop pop 1000 sub currentpoint stroke moveto 20 300 4 2 roll s4 a4p 20 -200 lineto stroke}def /lf{20 800 moveto 0 -1000 rlineto s4 0 rls}def /rf{20 800 moveto 0 -1000 rlineto s4 neg 0 rls}def /lc{20 -200 moveto 0 1000 rlineto s4 0 rls}def /rc{20 -200 moveto 0 1000 rlineto s4 neg 0 rls}def end /Metrics 50 dict def Metrics begin /.notdef 0 def /space 500 def /ru 500 def /br 0 def /lt 250 def /lb 250 def /rt 250 def /rb 250 def /lk 250 def /rk 250 def /rc 250 def /lc 250 def /rf 250 def /lf 250 def /bv 250 def /ob 350 def /bu 350 def /ci 750 def /bx 750 def /sq 750 def /rn 500 def /ul 500 def /vr 0 def end DITfd begin /s2 500 def /s4 250 def /s3 333 def /a4p{arcto pop pop pop pop}def /2cx{2 copy exch}def /rls{rlineto stroke}def /currx{currentpoint pop}def /dround{transform round exch round exch itransform} def end end /DIThacks exch definefont pop ditstart (psc)xT 576 1 1 xr 1(Times-Roman)xf 1 f 2(Times-Italic)xf 2 f 3(Times-Bold)xf 3 f 4(Times-BoldItalic)xf 4 f 5(Helvetica)xf 5 f 6(Helvetica-Bold)xf 6 f 7(Courier)xf 7 f 8(Courier-Bold)xf 8 f 9(Symbol)xf 9 f 10(DIThacks)xf 10 f 10 s 1 f xi %%EndProlog %%Page: 1 1 10 s 0 xH 0 xS 1 f 3 f 12 s 1425 672(A)N 1518(Consumer)X 1968(Library)X 2318(Interface)X 2716(to)X 2820(DWARF)X 2 f 11 s 1084 816(UNIX)N 1311(International)X 1799(Programming)X 2314(Languages)X 2722(Special)X 3004(Interest)X 3295(Group)X 3 f 576 1248(1.)N 686(INTRODUCTION)X 1 f 10 s 576 1392(This)N 752(document)X 1102(describes)X 1435(an)X 1545(interface)X 1861(to)X 2 f 1957(libdwarf)X 1 f 2227(,)X 2281(a)X 2351(library)X 2599(of)X 2700(functions)X 3032(to)X 3128(provide)X 3407(access)X 3647(to)X 3743(DWARF)X 576 1488(debugging)N 951(information)X 1366(records,)X 1660(DWARF)X 1986(line)X 2143(number)X 2425(information,)X 2860(DWARF)X 3186(address)X 3464(range)X 3680(and)X 3832(global)X 576 1584(names)N 820(information,)X 1257(weak)X 1466(names)X 1710(information,)X 2147(DWARF)X 2475(frame)X 2702(description)X 3097(information,)X 3534(DWARF)X 3863(static)X 576 1680(function)N 863(names,)X 1108(DWARF)X 1417(static)X 1606(variables,)X 1936(and)X 2072(DWARF)X 2381(type)X 2539(information.)X 3 f 11 s 576 1968(1.1)N 730(Purpose)X 1060(and)X 1224(Scope)X 1 f 10 s 576 2112(The)N 743(purpose)X 1039(of)X 1148(this)X 1305(document)X 1663(is)X 1758(to)X 1862(document)X 2221(a)X 2300(library)X 2557(of)X 2667(functions)X 3008(to)X 3113(access)X 3362(DWARF)X 3694(debugging)X 576 2208(information.)N 1005(There)X 1224(is)X 1308(no)X 1419(effort)X 1629(made)X 1834(in)X 1927(this)X 2073(document)X 2420(to)X 2513(address)X 2785(the)X 2914(creation)X 3204(of)X 3302(these)X 3498(records)X 3766(as)X 3863(those)X 576 2304(issues)N 787(are)X 906(addressed)X 1243(separately.)X 576 2544(Additionally,)N 1022(the)X 1142(focus)X 1338(of)X 1427(this)X 1564(document)X 1902(is)X 1977(the)X 2097(functional)X 2445(interface,)X 2770(and)X 2909(as)X 2999(such,)X 3189(implementation)X 3714(as)X 3804(well)X 3965(as)X 576 2640(optimization)N 1000(issues)X 1211(are)X 1330(intentionally)X 1754(ignored.)X 3 f 11 s 576 2976(1.2)N 730(Document)X 1137(History)X 1 f 10 s 576 3120(A)N 655(document)X 993(was)X 1140(written)X 1389(about)X 1589(1991)X 1771(which)X 1989(had)X 2127(similar)X 2371(layout)X 2593(and)X 2731(interfaces.)X 3086(It)X 3157(was)X 3304(for)X 3420(reading)X 3683(DWARF1.)X 576 3216(The)N 735(authors)X 1005(distributed)X 1381(paper)X 1594(copies)X 1832(to)X 1927(the)X 2058(committee)X 2429(with)X 2604(the)X 2735(clearly)X 2987(expressed)X 3337(intent)X 3552(to)X 3647(propose)X 3934(the)X 576 3312(document)N 912(as)X 999(a)X 1055(supported)X 1391(interface)X 1693(definition.)X 576 3456(SGI)N 729(wrote)X 936(the)X 1058(document)X 1398(you)X 1543(are)X 1667(now)X 1830(reading)X 2096(in)X 2183(1993)X 2368(with)X 2535(a)X 2596(similar)X 2843(layout)X 3068(and)X 3209(content)X 3470(and)X 3611(organization,)X 576 3552(but)N 701(is)X 777(a)X 836(complete)X 1153(rewrite,)X 1424(and)X 1563(with)X 1728(the)X 1849(intent)X 2054(to)X 2139(read)X 2301(DWARF2.)X 2693(The)X 2841(intent)X 3046(is)X 3122(to)X 3207(also)X 3358(cover)X 3559(DWARF3,)X 3930(but)X 576 3648(DWARF3)N 925(is)X 998(not)X 1120(fully)X 1291(covered)X 1566(by)X 1666(this)X 1801(document)X 2137(at)X 2215(this)X 2350(time.)X 3 f 11 s 576 3888(1.3)N 730(Definitions)X 0(Courier)xf 0 f 1 f 10 s 576 4032(DWARF)N 890(debugging)X 1253(information)X 1656(entries)X 1895(\(DIE\))X 2108(are)X 2232(the)X 2355(segments)X 2678(of)X 2770(information)X 3173(placed)X 3408(in)X 3496(the)X 0(Courier)xf 0 f 1 f 0 f 3648(.debug_*)X 1 f 576 4128(sections)N 864(by)X 974(compilers,)X 1340(assemblers,)X 1742(and)X 1888(linkage)X 2154(editors)X 2402(that,)X 2572(in)X 2664(conjunction)X 3072(with)X 3244(line)X 3394(number)X 3669(entries,)X 3933(are)X 576 4224(necessary)N 915(for)X 1035(symbolic)X 1354(source-level)X 1773(debugging.)X 2177(Refer)X 2382(to)X 2470(the)X 2594(document)X 2936(")X 2 f 2969(DWARF)X 3267(Debugging)X 3650(Information)X 576 4320(Format)N 1 f (")S 869(from)X 1045(UI)X 1150(PLSIG)X 1392(for)X 1506(a)X 1562(more)X 1747(complete)X 2061(description)X 2437(of)X 2524(these)X 2709(entries.)X 576 4560(This)N 739(document)X 1076(adopts)X 1306(all)X 1407(the)X 1526(terms)X 1725(and)X 1862(definitions)X 2226(in)X 2310(")X 2 f 2343(DWARF)X 2637(Debugging)X 3015(Information)X 3419(Format)X 1 f (")S 3714(version)X 3972(2.)X 576 4656(It)N 669(focuses)X 953(on)X 1076(the)X 1217(implementation)X 1762(at)X 1863(Silicon)X 2132(Graphics)X 2465(Computer)X 2828(Systems.)X 3177(Although)X 3522(we)X 3659(believe)X 3934(the)X 576 4752(interface)N 878(is)X 951(general)X 1208(enough)X 1464(to)X 1546(be)X 1642(of)X 1729(interest)X 1986(to)X 2069(other)X 2255(vendors)X 2530(too,)X 2673(there)X 2855(are)X 2975(a)X 3032(few)X 3174(places)X 3396(where)X 3614(changes)X 3894(may)X 576 4848(need)N 748(to)X 830(be)X 926(made.)X 3 f 11 s 576 5088(1.4)N 730(Overview)X 1 f 10 s 576 5232(The)N 747(remaining)X 1118(sections)X 1422(of)X 1535(this)X 1696(document)X 2058(describe)X 2373(the)X 2518(proposed)X 2859(interface)X 3188(to)X 0 f 3325(libdwarf)X 1 f (,)S 3776(first)X 3952(by)X 576 5328(describing)N 952(the)X 1092(purpose)X 1387(of)X 1495(additional)X 1856(types)X 2066(defined)X 2348(by)X 2469(the)X 2608(interface,)X 2951(followed)X 3277(by)X 3398(descriptions)X 3826(of)X 3934(the)X 576 5424(available)N 892(operations.)X 1292(This)X 1460(document)X 1802(assumes)X 2095(you)X 2241(are)X 2366(thoroughly)X 2743(familiar)X 3023(with)X 3191(the)X 3315(information)X 3720(contained)X 576 5520(in)N 658(the)X 2 f 776(DWARF)X 1068(Debugging)X 1444(Information)X 1846(Format)X 1 f 2106(document.)X 576 5664(We)N 714(separate)X 1004(the)X 1129(functions)X 1454(into)X 1605(several)X 1860(categories)X 2213(to)X 2302(emphasize)X 2668(that)X 2815(not)X 2944(all)X 3051(consumers)X 3421(want)X 3604(to)X 3693(use)X 3827(all)X 3934(the)X 576 5760(functions.)N 936(We)X 1070(call)X 1208(the)X 1328(categories)X 1676(Debugger,)X 2035(Internal-level,)X 2510(High-level,)X 2895(and)X 3033(Miscellaneous)X 3517(not)X 3640(because)X 3916(one)X 576 5856(is)N 662(more)X 860(important)X 1204(than)X 1375(another)X 1649(but)X 1784(as)X 1884(a)X 1953(way)X 2120(of)X 2220(making)X 2493(the)X 2625(rather)X 2847(large)X 3042(set)X 3165(of)X 3266(function)X 3567(calls)X 3748(easier)X 3970(to)X 576 5952(understand.)N 576 6183(rev)N 699(1.61,)X 879(3)X 939(Apr)X 1084(2006)X 2237(-)X 2284(1)X 2344(-)X 2 p %%Page: 2 2 0(Courier)xf 0 f 10 s 0 xH 0 xS 0 f 1 f 2237 384(-)N 2284(2)X 2344(-)X 576 768(Unless)N 823(otherwise)X 1164(specified,)X 1503(all)X 1612(functions)X 1939(and)X 2084(structures)X 2425(should)X 2667(be)X 2772(taken)X 2975(as)X 3071(being)X 3278(designed)X 3592(for)X 3715(Debugger)X 576 864(consumers.)N 576 1008(The)N 732(Debugger)X 1080(Interface)X 1398(of)X 1496(this)X 1642(library)X 1887(is)X 1971(intended)X 2278(to)X 2372(be)X 2480(used)X 2659(by)X 2771(debuggers.)X 3173(The)X 3330(interface)X 3644(is)X 3729(low-level)X 576 1104(\(close)N 796(to)X 886(dwarf\))X 1129(but)X 1259(suppresses)X 1630(irrelevant)X 1966(detail.)X 2212(A)X 2298(debugger)X 2625(will)X 2777(want)X 2961(to)X 3051(absorb)X 3292(all)X 3399(of)X 3493(some)X 3689(sections)X 3974(at)X 576 1200(startup)N 816(and)X 954(will)X 1100(want)X 1278(to)X 1362(see)X 1487(little)X 1655(or)X 1744(nothing)X 2011(of)X 2101(some)X 2293(sections)X 2574(except)X 2807(at)X 2888(need.)X 3103(And)X 3264(even)X 3439(then)X 3600(will)X 3747(probably)X 576 1296(want)N 754(to)X 838(absorb)X 1074(only)X 1238(the)X 1358(information)X 1758(in)X 1842(a)X 1900(single)X 2113(compilation)X 2517(unit)X 2663(at)X 2743(a)X 2801(time.)X 3005(A)X 3085(debugger)X 3406(does)X 3575(not)X 3698(care)X 3854(about)X 576 1392(implementation)N 1098(details)X 1327(of)X 1414(the)X 1532(library.)X 576 1536(The)N 722(Internal-level)X 1176(Interface)X 1484(is)X 1558(for)X 1673(a)X 1731(DWARF)X 2042(prettyprinter)X 2465(and)X 2603(checker.)X 2916(A)X 2996(thorough)X 3307(prettyprinter)X 3730(will)X 3876(want)X 576 1632(to)N 669(know)X 878(all)X 989(kinds)X 1193(of)X 1291(internal)X 1567(things)X 1793(\(like)X 1971(actual)X 2194(FORM)X 2451(numbers)X 2758(and)X 2905(actual)X 3128(offsets\))X 3400(so)X 3502(it)X 3577(can)X 3720(check)X 3938(for)X 576 1728(appropriate)N 972(structure)X 1283(in)X 1375(the)X 1503(DWARF)X 1822(data)X 1986(and)X 2132(print)X 2314(\(on)X 2452(request\))X 2742(all)X 2853(that)X 3004(internal)X 3280(information)X 3689(for)X 3814(human)X 576 1824(users)N 767(and)X 909(libdwarf)X 1207(authors)X 1469(and)X 1611(compiler-writers.)X 2212(Calls)X 2402(in)X 2490(this)X 2631(interface)X 2939(provide)X 3210(data)X 3370(a)X 3432(debugger)X 3757(does)X 3930(not)X 576 1920(care)N 731(about.)X 576 2064(The)N 721(High-level)X 1084(Interface)X 1391(is)X 1464(for)X 1578(higher)X 1803(level)X 1979(access)X 2205(\(it's)X 2354(not)X 2476(really)X 2679(a)X 2735(high)X 2897(level)X 3073(interface!\).)X 3469(Programs)X 3797(such)X 3965(as)X 576 2160(disassemblers)N 1060(will)X 1223(want)X 1418(to)X 1519(be)X 1634(able)X 1807(to)X 1908(display)X 2178(relevant)X 2476(information)X 2892(about)X 3108(functions)X 3444(and)X 3598(line)X 3756(numbers)X 576 2256(without)N 840(having)X 1078(to)X 1160(invest)X 1371(too)X 1493(much)X 1691(effort)X 1890(in)X 1972(looking)X 2236(at)X 2314(DWARF.)X 576 2400(The)N 721(miscellaneous)X 1195(interface)X 1497(is)X 1570(just)X 1705(what)X 1881(is)X 1954(left)X 2081(over:)X 2266(the)X 2384(error)X 2561(handler)X 2822(functions.)X 576 2544(The)N 735(following)X 1080(is)X 1167(a)X 1237(brief)X 1423(mention)X 1719(of)X 1820(the)X 1952(changes)X 2245(in)X 2341(this)X 2490(libdwarf)X 2796(from)X 2987(the)X 3120(libdwarf)X 3427(draft)X 3614(for)X 3743(DWARF)X 576 2640(Version)N 850(1)X 910(and)X 1046(recent)X 1263(changes.)X 3 f 11 s 576 2784(1.5)N 730(Items)X 961(Changed)X 1 f 10 s 576 2928(Added)N 810(support)X 1070(for)X 1184(various)X 1440(DWARF3)X 1789(features,)X 2084(but)X 2206(primarily)X 2524(a)X 2580(new)X 2734(frame-information)X 3347(interface)X 3650(tailorable)X 3974(at)X 576 3024(run-time)N 963(to)X 1136(more)X 1412(than)X 1661(a)X 1808(single)X 2110(ABI.)X 2398(See)X 2624 0.1397(dwarf_set_frame_rule_inital_value\(\))AX 3916(and)X 576 3120 0.1705(dwarf_set_frame_rule_table_size\(\).)AN 1971(See)X 2317(also)X 2676 0.1830(dwarf_get_fde_info_for_reg3\(\))AX 3916(and)X 576 3216 0.1970(dwarf_get_fde_info_for_cfa_reg3\(\).)AN 1784(\(April)X 2000(2006\))X 576 3360(Added)N 818(support)X 1086(for)X 1208(DWARF3)X 1565(.debug_pubtypes)X 2138(section.)X 2433(Corrected)X 2778(various)X 3042(leaks)X 3236(\(revising)X 3550(dealloc\(\))X 3865(calls,)X 576 3456(adding)N 814(new)X 968(functions\))X 1313(and)X 1449(corrected)X 1769(dwarf_formstring\(\))X 2409(documentation.)X 576 3600(Added)N 826 0.1685(dwarf_srclines_dealloc\(\))AX 1661(as)X 1764(the)X 1898(previous)X 2210(deallocation)X 2639(method)X 2916(documented)X 3345(for)X 3476(data)X 3647(returned)X 3952(by)X 576 3696(dwarf_srclines\(\))N 1123(was)X 1268(incapable)X 1596(of)X 1683(freeing)X 1931(all)X 2031(the)X 2149(allocated)X 2459(storage)X 2711(\(14)X 2838(July)X 2991(2005\).)X 576 3840(dwarf_nextglob\(\),)N 1181(dwarf_globname\(\),)X 1822(and)X 1961(dwarf_globdie\(\))X 2506(were)X 2686(all)X 2789(changed)X 3080(to)X 3165(operate)X 3425(on)X 3529(the)X 3651(items)X 3848(in)X 3934(the)X 576 3936(.debug_pubnames)N 1177(section.)X 576 4080(All)N 707(functions)X 1034(were)X 1220(modified)X 1538(to)X 1629(return)X 1850(solely)X 2070(an)X 2175(error)X 2361(code.)X 2582(Data)X 2763(is)X 2845(returned)X 3142(through)X 3421(pointer)X 3678(arguments.)X 576 4176(This)N 745(makes)X 977(writing)X 1235(safe)X 1392(and)X 1535(correct)X 1786(library-using-code)X 2406(far)X 2523(easier.)X 2778(For)X 2916(justification)X 3325(for)X 3446(this)X 3588(approach,)X 3929(see)X 576 4272(the)N 694(book)X 874(by)X 974(Steve)X 1172(Maguire)X 1464(titled)X 1648("Writing)X 1950(Solid)X 2138(Code")X 2360(at)X 2438(your)X 2605(bookstore.)X 3 f 11 s 576 4608(1.6)N 730(Items)X 961(Removed)X 1 f 10 s 576 4752(Dwarf_Type)N 1007(was)X 1152(removed)X 1453(since)X 1638(types)X 1827(are)X 1946(no)X 2046(longer)X 2271(special.)X 576 4896(dwarf_typeof\(\))N 1083(was)X 1228(removed)X 1529(since)X 1714(types)X 1903(are)X 2022(no)X 2122(longer)X 2347(special.)X 576 5040(Dwarf_Ellist)N 1010(was)X 1155(removed)X 1456(since)X 1641(element)X 1915(lists)X 2063(no)X 2163(longer)X 2388(are)X 2507(a)X 2563(special)X 2806(format.)X 576 5184(Dwarf_Bounds)N 1086(was)X 1231(removed)X 1532(since)X 1717(bounds)X 1968(have)X 2140(been)X 2312(generalized.)X 576 5328(dwarf_nextdie\(\))N 1124(was)X 1279(replaced)X 1582(by)X 1693 0.2321(dwarf_next_cu_header\(\))AX 2515(to)X 2608(reflect)X 2845(the)X 2974(real)X 3126(way)X 3291(DWARF)X 3611(is)X 3695(organized.)X 576 5424(The)N 739(dwarf_nextdie\(\))X 1295(was)X 1458(only)X 1638(useful)X 1872(for)X 2004(getting)X 2264(to)X 2364(compilation)X 2784(unit)X 2946(beginnings,)X 3355(so)X 3463(it)X 3544(does)X 3728(not)X 3867(seem)X 576 5520(harmful)N 850(to)X 932(remove)X 1193(it)X 1257(in)X 1339(favor)X 1529(of)X 1616(a)X 1672(more)X 1857(direct)X 2060(function.)X 576 5664(dwarf_childcnt\(\))N 1136(is)X 1209(removed)X 1510(on)X 1610(grounds)X 1888(that)X 2028(no)X 2128(good)X 2308(use)X 2435(was)X 2580(apparent.)X 576 5808 0.2083(dwarf_prevline\(\))AN 1151(and)X 1297(dwarf_nextline\(\))X 1867(were)X 2055(removed)X 2367(on)X 2478(grounds)X 2767(this)X 2913(is)X 2997(better)X 3211(left)X 3349(to)X 3442(a)X 3509(debugger)X 3839(to)X 3932(do.)X 576 5904(Similarly,)N 913(dwarf_dieline\(\))X 1433(was)X 1578(removed.)X 576 6183(rev)N 699(1.61,)X 879(3)X 939(Apr)X 1084(2006)X 2237(-)X 2284(2)X 2344(-)X 3 p %%Page: 3 3 0(Courier)xf 0 f 10 s 0 xH 0 xS 0 f 1 f 2237 384(-)N 2284(3)X 2344(-)X 576 768(dwarf_is1stline\(\))N 1144(was)X 1289(removed)X 1590(as)X 1677(it)X 1741(was)X 1886(not)X 2008(meaningful)X 2393(for)X 2507(the)X 2625(revised)X 2877(DWARF)X 3186(line)X 3326(operations.)X 576 912(Any)N 739(libdwarf)X 1036(implementation)X 1563(might)X 1774(well)X 1937(decide)X 2172(to)X 2259(support)X 2524(all)X 2629(the)X 2753(removed)X 3060(functionality)X 3495(and)X 3637(to)X 3725(retain)X 3934(the)X 576 1008(DWARF)N 893(Version)X 1175(1)X 1242(meanings)X 1576(of)X 1670(that)X 1817(functionality.)X 2293(This)X 2462(would)X 2689(be)X 2792(difficult)X 3077(because)X 3359(the)X 3484(original)X 3760(libdwarf)X 576 1104(draft)N 759(specification)X 1200(used)X 1378(traditional)X 1738(C)X 1822(library)X 2068(interfaces)X 2413(which)X 2641(confuse)X 2923(the)X 3053(values)X 3290(returned)X 3590(by)X 3702(successful)X 576 1200(calls)N 743(with)X 905(exceptional)X 1295(conditions)X 1648(like)X 1788(failures)X 2049(and)X 2185('no)X 2312(more)X 2497(data')X 2678(indications.)X 3 f 11 s 576 1440(1.7)N 730(Revision)X 1075(History)X 1 f 10 s 576 1584(March)N 806(93)X 1176(Work)X 1379(on)X 1479(DWARF2)X 1828(SGI)X 1977(draft)X 2149(begins)X 576 1728(June)N 743(94)X 1176(The)X 1321(function)X 1608(returns)X 1851(are)X 1970(changed)X 2258(to)X 2340(return)X 2552(an)X 2648(error/success)X 3088(code)X 3260(only.)X 576 1872(April)N 765(2006:)X 1176(Support)X 1449(for)X 1563(DWARF3)X 1912(consumer)X 2244(operations)X 2598(is)X 2671(close)X 2856(to)X 2938(completion.)X 3 f 11 s 576 2160(2.)N 686(Types)X 933(Definitions)X 576 2448(2.1)N 730(General)X 1056(Description)X 1 f 10 s 576 2592(The)N 2 f 733(libdwarf.h)X 1 f 1095(header)X 1342(file)X 1481(contains)X 1780(typedefs)X 2084(and)X 2232(preprocessor)X 2675(definitions)X 3050(of)X 3150(types)X 3352(and)X 3501(symbolic)X 3827(names)X 576 2688(used)N 754(to)X 847 0.4531(reference)AX 1179(objects)X 1437(of)X 2 f 1535(libdwarf)X 1 f 1805(.)X 1856(The)X 2011(types)X 2210(defined)X 2481(by)X 2591(typedefs)X 2893(contained)X 3235(in)X 2 f 3327(libdwarf.h)X 1 f 3687(all)X 3797(use)X 3934(the)X 576 2784(convention)N 952(of)X 1039(adding)X 0 f 1305(Dwarf_)X 1 f 1613(as)X 1700(a)X 1756(prefix)X 1968(and)X 2104(can)X 2236(be)X 2332(placed)X 2562(in)X 2644(three)X 2825(categories:)X 8 s 10 f 634 3024(g)N 10 s 1 f 696(Scalar)X 923(types)X 1118(:)X 1166(The)X 1318(scalar)X 1533(types)X 1729(defined)X 1997(in)X 2 f 2086(libdwarf.h)X 1 f 2443(are)X 2569(defined)X 2837(primarily)X 3162(for)X 3283(notational)X 3630(convenience)X 696 3120(and)N 835(identification.)X 1325(Depending)X 1700(on)X 1803(the)X 1924(individual)X 2271(definition,)X 2624(they)X 2784(are)X 2905(interpreted)X 3275(as)X 3364(a)X 3422(value,)X 3638(a)X 3696(pointer,)X 3965(or)X 696 3216(as)N 783(a)X 839(flag.)X 8 s 10 f 634 3360(g)N 10 s 1 f 696(Aggregate)X 1052(types)X 1242(:)X 1285(Some)X 1488(values)X 1714(can)X 1847(not)X 1970(be)X 2068(represented)X 2461(by)X 2563(a)X 2621(single)X 2834(scalar)X 3044(type;)X 3226(they)X 3386(must)X 3563(be)X 3661(represented)X 696 3456(by)N 796(a)X 852(collection)X 1188(of,)X 1295(or)X 1382(as)X 1469(a)X 1525(union)X 1727(of,)X 1834(scalar)X 2042(and/or)X 2267(aggregate)X 2600(types.)X 8 s 10 f 634 3600(g)N 10 s 1 f 696(Opaque)X 972(types)X 1167(:)X 1215(The)X 1366(complete)X 1686(definition)X 2023(of)X 2116(these)X 2307(types)X 2502(is)X 2581(intentionally)X 3012(omitted;)X 3305(their)X 3479(use)X 3613(is)X 3693(as)X 3787(handles)X 696 3696(for)N 816(query)X 1025(operations,)X 1405(which)X 1627(will)X 1777(yield)X 1963(either)X 2172(an)X 2274(instance)X 2563(of)X 2656(another)X 2923(opaque)X 3181(type)X 3344(to)X 3431(be)X 3532(used)X 3704(in)X 3791(another)X 696 3792(query,)N 919(or)X 1006(an)X 1102(instance)X 1385(of)X 1472(a)X 1528(scalar)X 1736(or)X 1823(aggregate)X 2156(type,)X 2334(which)X 2550(is)X 2623(the)X 2741(actual)X 2953(result.)X 3 f 11 s 576 4080(2.2)N 730(Scalar)X 992(Types)X 1 f 10 s 576 4224(The)N 721(following)X 1052(are)X 1171(the)X 1289(defined)X 1550(by)X 2 f 1650(libdwarf.h)X 1 f 1980(:)X 0 f 576 4560(typedef)N 960(int)X 1872(Dwarf_Bool;)X 576 4656(typedef)N 960(unsigned)X 1392(long)X 1632(long)X 1872(Dwarf_Off;)X 576 4752(typedef)N 960(unsigned)X 1392(long)X 1632(long)X 1872(Dwarf_Unsigned;)X 576 4848(typedef)N 960(unsigned)X 1392(short)X 1872(Dwarf_Half;)X 576 4944(typedef)N 960(unsigned)X 1392(char)X 1872(Dwarf_Small;)X 576 5040(typedef)N 960(signed)X 1296(long)X 1536(long)X 1872(Dwarf_Signed;)X 576 5136(typedef)N 960(unsigned)X 1392(long)X 1632(long)X 1872(Dwarf_Addr;)X 576 5232(typedef)N 960(void)X 1872(*Dwarf_Ptr;)X 576 5328(typedef)N 960(void)X 1296(\(*Dwarf_Handler\)\(Dwarf_Error)X 2688(*error,)X 3072(Dwarf_Ptr)X 3552(errarg\);)X 1 f 576 5568(Dwarf_Ptr)N 959(is)X 1056(an)X 1176(address)X 1462(for)X 1601(use)X 1753(by)X 1878(the)X 2021(host)X 2199(program)X 2516(calling)X 2779(the)X 2922(library,)X 3201(not)X 3348(for)X 3487(representing)X 3929(pc-)X 576 5664(values/addresses)N 1141(within)X 1375(the)X 1503(target)X 1716(object)X 1942(file.)X 2119(Dwarf_Addr)X 2560(is)X 2643(for)X 2767(pc-values)X 3105(within)X 3339(the)X 3467(target)X 3680(object)X 3905(file.)X 576 5760(The)N 732(sample)X 990(scalar)X 1209(type)X 1378(assignments)X 1800(above)X 2023(are)X 2153(for)X 2278(a)X 2 f 2345(libdwarf.h)X 1 f 2707(that)X 2859(can)X 3003(read)X 3174(and)X 3322(write)X 3519(32-bit)X 3742(or)X 3841(64-bit)X 576 5856(binaries)N 880(on)X 1009(a)X 1094(32-bit)X 1334(or)X 1450(64-bit)X 1690(host)X 1872(machine.)X 2233(The)X 2407(types)X 2625(must)X 2829(be)X 2974(defined)X 3264(appropriately)X 3741(for)X 3884(each)X 576 5952(implementation)N 1103(of)X 1195(libdwarf.)X 1532(A)X 1615(description)X 1996(of)X 2088(these)X 2278(scalar)X 2491(types)X 2685(in)X 2772(the)X 2895(SGI/MIPS)X 3257(environment)X 3687(is)X 3766(given)X 3970(in)X 576 6183(rev)N 699(1.61,)X 879(3)X 939(Apr)X 1084(2006)X 2237(-)X 2284(3)X 2344(-)X 4 p %%Page: 4 4 0(Courier)xf 0 f 10 s 0 xH 0 xS 0 f 1 f 2237 384(-)N 2284(4)X 2344(-)X 576 768(Figure)N 805(1.)X 0 f 10 f 854 928(i)N 873(iiiiiiiiiiiiiiiiiiiiiiiiiiiiiiiiiiiiiiiiiiiiiiiiiiiiiiiiiiiiiiiiiiiiiiii)X 3 f 894 1024(NAME)N 1686(SIZE)X 1987(ALIGNMENT)X 2609(PURPOSE)X 10 f 854 1040(i)N 873(iiiiiiiiiiiiiiiiiiiiiiiiiiiiiiiiiiiiiiiiiiiiiiiiiiiiiiiiiiiiiiiiiiiiiiii)X 3 f 894 1136(Dwarf_Bool)N 1756(4)X 2218(4)X 2609(Boolean)X 2904(states)X 894 1232(Dwarf_Off)N 1756(8)X 2218(8)X 2609(Unsigned)X 2948(file)X 3075(offset)X 894 1328(Dwarf_Unsigned)N 1756(8)X 2218(8)X 2609(Unsigned)X 2948(large)X 3142(integer)X 894 1424(Dwarf_Half)N 1756(2)X 2218(2)X 2609(Unsigned)X 2948(medium)X 3248(integer)X 894 1520(Dwarf_Small)N 1756(1)X 2218(1)X 2609(Unsigned)X 2948(small)X 3150(integer)X 894 1616(Dwarf_Signed)N 1756(8)X 2218(8)X 2609(Signed)X 2859(large)X 3053(integer)X 894 1712(Dwarf_Addr)N 1756(8)X 2218(8)X 2609(Program)X 2937(address)X 2609 1808(\(target)N 2862(program\))X 894 1904(Dwarf_Ptr)N 1728(4)X 9 f (|)S 3 f (8)S 2190(4)X 9 f (|)S 3 f (8)S 2609(Dwarf)X 2848(section)X 3104(pointer)X 2609 2000(\(host)N 2798(program\))X 894 2096(Dwarf_Handler)N 1728(4)X 9 f (|)S 3 f (8)S 2190(4)X 9 f (|)S 3 f (8)S 2609(Pointer)X 2883(to)X 2609 2192(error)N 2813(handler)X 3099(function)X 10 f 854 2208(i)N 873(iiiiiiiiiiiiiiiiiiiiiiiiiiiiiiiiiiiiiiiiiiiiiiiiiiiiiiiiiiiiiiiiiiiiiiii)X 854(c)X 2128(c)Y 2048(c)Y 1968(c)Y 1888(c)Y 1808(c)Y 1728(c)Y 1648(c)Y 1568(c)Y 1488(c)Y 1408(c)Y 1328(c)Y 1248(c)Y 1168(c)Y 1088(c)Y 1008(c)Y 3753 2208(c)N 2128(c)Y 2048(c)Y 1968(c)Y 1888(c)Y 1808(c)Y 1728(c)Y 1648(c)Y 1568(c)Y 1488(c)Y 1408(c)Y 1328(c)Y 1248(c)Y 1168(c)Y 1088(c)Y 1008(c)Y 3 f 1909 2304(Figure)N 2156(1.)X 2256(Scalar)X 2494(Types)X 11 s 576 2592(2.3)N 730(Aggregate)X 1137(Types)X 1 f 10 s 576 2736(The)N 731(following)X 1072(aggregate)X 1416(types)X 1616(are)X 1746(defined)X 2018(by)X 2129(the)X 2258(SGI)X 2 f 2418(libdwarf.h)X 1 f 2748(:)X 0 f 2877(Dwarf_Loc)X 1 f (,)S 0 f 3388(Dwarf_Locdesc)X 1 f (,)S 0 f 576 2832(Dwarf_Block)N 1 f (,)S 0 f 1186(Dwarf_Frame_Op)X 1 f (.)S 0 f 1987(Dwarf_Regtable)X 1 f (.)S 2732(While)X 2961(most)X 3149(of)X 0 f 3277(libdwarf)X 1 f 3694(acts)X 3852(on)X 3965(or)X 576 2928(returns)N 819(simple)X 1052(values)X 1277(or)X 1364(opaque)X 1616(pointer)X 1863(types,)X 2072(this)X 2207(small)X 2400(set)X 2509(of)X 2596(structures)X 2928(seems)X 3144(useful.)X 3 f 576 3168(2.3.1)N 776(Location)X 1098(Record)X 1 f 576 3312(The)N 0 f 749(Dwarf_Loc)X 1 f 1201(type)X 1359(identifies)X 1677(a)X 1733(single)X 1944(atom)X 2124(of)X 2211(a)X 2267(location)X 2545(description)X 2921(or)X 3008(a)X 3064(location)X 3342(expression.)X 0 f 576 3552(typedef)N 960(struct)X 1296({)X 960 3648(Dwarf_Small)N 1872(lr_atom;)X 960 3744(Dwarf_Unsigned)N 1872(lr_number;)X 960 3840(Dwarf_Unsigned)N 1872(lr_number2;)X 960 3936(Dwarf_Unsigned)N 1872(lr_offset;)X 576 4032(})N 672(Dwarf_Loc;)X 1 f 576 4272(The)N 0 f 752(lr_atom)X 1 f 1111(identifies)X 1432(the)X 1553(atom)X 1736(corresponding)X 2218(to)X 2303(the)X 0 f 2452(DW_OP_*)X 1 f 2811(definition)X 3145(in)X 2 f 3230(dwarf.h)X 1 f 3499(and)X 3638(it)X 3706(represents)X 576 4368(the)N 694(operation)X 1017(to)X 1099(be)X 1195(performed)X 1550(in)X 1632(order)X 1822(to)X 1904(locate)X 2116(the)X 2234(item)X 2396(in)X 2478(question.)X 576 4608(The)N 0 f 753(lr_number)X 1 f 1209(field)X 1380(is)X 1457(the)X 1579(operand)X 1862(to)X 1948(be)X 2048(used)X 2219(in)X 2305(the)X 2427(calculation)X 2804(specified)X 3119(by)X 3224(the)X 0 f 3375(lr_atom)X 1 f 3736(field;)X 3930(not)X 576 4704(all)N 685(atoms)X 905(use)X 1041(this)X 1185(field.)X 1401(Some)X 1612(atom)X 1801(operations)X 2164(imply)X 2379(signed)X 2617(numbers)X 2922(so)X 3022(it)X 3095(is)X 3177(necessary)X 3519(to)X 3610(cast)X 3763(this)X 3906(to)X 3996(a)X 0 f 576 4800(Dwarf_Signed)N 1 f 1172(type)X 1330(for)X 1444(those)X 1633(operations.)X 576 5040(The)N 0 f 755(lr_number2)X 1 f 1261(field)X 1434(is)X 1513(the)X 1637(second)X 1886(operand)X 2171(specified)X 2488(by)X 2595(the)X 0 f 2748(lr_atom)X 1 f 3111(field;)X 3307(only)X 0 f 3504(DW_OP_BREGX)X 1 f 576 5136(has)N 720(this)X 872(field.)X 1096(Some)X 1315(atom)X 1512(operations)X 1883(imply)X 2106(signed)X 2352(numbers)X 2665(so)X 2773(it)X 2853(may)X 3027(be)X 3139(necessary)X 3488(to)X 3586(cast)X 3747(this)X 3898(to)X 3996(a)X 0 f 576 5232(Dwarf_Signed)N 1 f 1172(type)X 1330(for)X 1444(those)X 1633(operations.)X 576 5472(The)N 0 f 758(lr_offset)X 1 f 1219(field)X 1395(is)X 1477(the)X 1604(byte)X 1772(offset)X 1985(\(within)X 2246(the)X 2374(block)X 2582(the)X 2710(location)X 2998(record)X 3234(came)X 3434(from\))X 3647(of)X 3744(the)X 3872(atom)X 576 5568(specified)N 894(by)X 1002(the)X 0 f 1156(lr_atom)X 1 f 1519(field.)X 1733(This)X 1902(is)X 1982(set)X 2098(on)X 2205(all)X 2312(atoms.)X 2570(This)X 2739(is)X 2819(useful)X 3042(for)X 3163(operations)X 0 f 3552(DW_OP_SKIP)X 1 f 576 5664(and)N 0 f 740(DW_OP_BRA)X 1 f (.)S 576 6183(rev)N 699(1.61,)X 879(3)X 939(Apr)X 1084(2006)X 2237(-)X 2284(4)X 2344(-)X 5 p %%Page: 5 5 0(Courier)xf 0 f 10 s 0 xH 0 xS 0 f 1 f 2237 384(-)N 2284(5)X 2344(-)X 3 f 576 768(2.3.2)N 776(Location)X 1098(Description)X 1 f 576 912(The)N 0 f 751(Dwarf_Locdesc)X 1 f 1397(type)X 1557(represents)X 1905(an)X 2003(ordered)X 2271(list)X 2390(of)X 0 f 2507(Dwarf_Loc)X 1 f 2961(records)X 3220(used)X 3389(in)X 3474(the)X 3595(calculation)X 3970(to)X 576 1008(locate)N 795(an)X 898(item.)X 1107(Note)X 1290(that)X 1437(in)X 1526(many)X 1731(cases,)X 1948(the)X 2073(location)X 2358(can)X 2497(only)X 2666(be)X 2769(calculated)X 3122(at)X 3207(runtime)X 3483(of)X 3577(the)X 3702(associated)X 576 1104(program.)N 0 f 576 1344(typedef)N 960(struct)X 1296({)X 960 1440(Dwarf_Addr)N 1824(ld_lopc;)X 960 1536(Dwarf_Addr)N 1824(ld_hipc;)X 960 1632(Dwarf_Unsigned)N 1824(ld_cents;)X 960 1728(Dwarf_Loc*)N 1824(ld_s;)X 576 1824(})N 672(Dwarf_Locdesc;)X 1 f 576 2064(The)N 0 f 752(ld_lopc)X 1 f 1111(and)X 0 f 1278(ld_hipc)X 1 f 1637(fields)X 1838(provide)X 2106(an)X 2205(address)X 2469(range)X 2671(for)X 2789(which)X 3009(this)X 3148(location)X 3430(descriptor)X 3775(is)X 3852(valid.)X 576 2160(Both)N 757(of)X 850(these)X 1041(fields)X 1244(are)X 1368(set)X 1482(to)X 2 f 1569(zero)X 1 f 1732(if)X 1806(the)X 1929(location)X 2212(descriptor)X 2558(is)X 2636(valid)X 2821(throughout)X 3197(the)X 3320(scope)X 3528(of)X 3620(the)X 3743(item)X 3910(it)X 3979(is)X 576 2256(associated)N 934(with.)X 1144(These)X 1364(addresses)X 1700(are)X 1827(virtual)X 2064(memory)X 2359(addresses,)X 2715(not)X 2845(offsets-from-something.)X 3670(The)X 3823(virtual)X 576 2352(memory)N 867(addresses)X 1199(do)X 1303(not)X 1429(account)X 1703(for)X 1821(dso)X 1956(movement)X 2318(\(none)X 2525(of)X 2616(the)X 2738(pc)X 2838(values)X 3067(from)X 3247(libdwarf)X 3543(do)X 3646(that,)X 3809(it)X 3876(is)X 3952(up)X 576 2448(to)N 658(the)X 776(consumer)X 1108(to)X 1190(do)X 1290(that\).)X 576 2688(The)N 0 f 756(ld_cents)X 1 f 1167(field)X 1341(contains)X 1635(a)X 1698(count)X 1903(of)X 1997(the)X 2122(number)X 2395(of)X 0 f 2518(Dwarf_Loc)X 1 f 2978(entries)X 3220(pointed)X 3488(to)X 3578(by)X 3686(the)X 0 f 3840(ld_s)X 1 f 576 2784(field.)N 576 3024(The)N 0 f 749(ld_s)X 1 f 961(field)X 1128(points)X 1343(to)X 1425(an)X 1521(array)X 1707(of)X 0 f 1822(Dwarf_Loc)X 1 f 2274(records.)X 3 f 576 3264(2.3.3)N 776(Data)X 961(Block)X 1 f 576 3456(The)N 0 f 786(Dwarf_Block)X 1 f 1371(type)X 1566(is)X 1676(used)X 1880(to)X 1999(contain)X 2292(the)X 2447(value)X 2678(of)X 2802(an)X 2936(attribute)X 3261(whose)X 3524(form)X 3738(is)X 3849(either)X 0 f 576 3552(DW_FORM_block1)N 1 f (,)S 0 f 1431(DW_FORM_block2)X 1 f (,)S 0 f 2285(DW_FORM_block4)X 1 f (,)S 0 f 3139(DW_FORM_block8)X 1 f (,)S 3965(or)X 0 f 576 3648(DW_FORM_block)N 1 f (.)S 1260(Its)X 1360(intended)X 1656(use)X 1783(is)X 1856(to)X 1938(deliver)X 2181(the)X 2299(value)X 2493(for)X 2607(an)X 2703(attribute)X 2990(of)X 3077(any)X 3213(of)X 3300(these)X 3485(forms.)X 0 f 576 3888(typedef)N 960(struct)X 1296({)X 960 3984(Dwarf_Unsigned)N 1872(bl_len;)X 960 4080(Dwarf_Ptr)N 1872(bl_data;)X 576 4176(})N 672(Dwarf_Block;)X 1 f 576 4464(The)N 0 f 749(bl_len)X 1 f 1057(field)X 1224(contains)X 1511(the)X 1629(length)X 1849(in)X 1931(bytes)X 2120(of)X 2207(the)X 2325(data)X 2479(pointed)X 2739(to)X 2821(by)X 2921(the)X 0 f 3067(bl_data)X 1 f 3423(field.)X 576 4704(The)N 0 f 752(bl_data)X 1 f 1111(field)X 1281(contains)X 1571(a)X 1630(pointer)X 1880(to)X 1966(the)X 2088(uninterpreted)X 2540(data.)X 2738(Since)X 2940(we)X 3058(use)X 3209(a)X 0 f 3297(Dwarf_Ptr)X 1 f 3753(here)X 3916(one)X 576 4800(must)N 755(copy)X 935(the)X 1057(pointer)X 1308(to)X 1394(some)X 1587(other)X 1776(type)X 1938(\(typically)X 2269(an)X 0 f 2397(unsigned)X 2832(char)X 3075(*)X 1 f (\))S 3173(so)X 3267(one)X 3406(can)X 3541(add)X 3680(increments)X 576 4896(to)N 658(index)X 856(through)X 1125(the)X 1243(data.)X 1437(The)X 1582(data)X 1736(pointed)X 1996(to)X 2078(by)X 0 f 2206(bl_data)X 1 f 2562(is)X 2635(not)X 2757(necessarily)X 3134(at)X 3212(any)X 3348(useful)X 3564(alignment.)X 3 f 576 5136(2.3.4)N 776(Frame)X 1024(Operation)X 1395(Codes:)X 1651(DWARF)X 1974(2)X 1 f 576 5280(This)N 742(interface)X 1048(is)X 1125(adequate)X 1435(for)X 1554(DWARF2)X 1908(but)X 2035(not)X 2162(for)X 2281(DWARF3.)X 2675(A)X 2758(separate)X 3047(interface)X 3354(usable)X 3584(for)X 3703(DWARF3)X 576 5376(and)N 712(for)X 826(DWARF2)X 1175(is)X 1248(described)X 1576(below.)X 576 5520(The)N 744(DWARF2)X 0 f 1144(Dwarf_Frame_Op)X 1 f 1859(type)X 2040(is)X 2136(used)X 2327(to)X 2433(contain)X 2713(the)X 2855(data)X 3033(of)X 3144(a)X 3224(single)X 3459(instruction)X 3845(of)X 3956(an)X 576 5616(instruction-sequence)N 1279(of)X 1385(low-level)X 1727(information)X 2144(from)X 2339(the)X 2476(section)X 2741(containing)X 3117(frame)X 3343(information.)X 3799(This)X 3979(is)X 576 5712(ordinarily)N 912(used)X 1079(by)X 1179(Internal-level)X 1632(Consumers)X 2012(trying)X 2223(to)X 2305(print)X 2476(everything)X 2839(in)X 2921(detail.)X 576 6183(rev)N 699(1.61,)X 879(3)X 939(Apr)X 1084(2006)X 2237(-)X 2284(5)X 2344(-)X 6 p %%Page: 6 6 0(Courier)xf 0 f 10 s 0 xH 0 xS 0 f 1 f 2237 384(-)N 2284(6)X 2344(-)X 0 f 576 768(typedef)N 960(struct)X 1296({)X 960 864(Dwarf_Small)N 1584(fp_base_op;)X 960 960(Dwarf_Small)N 1584(fp_extended_op;)X 960 1056(Dwarf_Half)N 1584(fp_register;)X 960 1152(Dwarf_Signed)N 1584(fp_offset;)X 960 1248(Dwarf_Offset)N 1584(fp_instr_offset;)X 576 1344(})N 672(Dwarf_Frame_Op;)X 576 1584(fp_base_op)N 1 f 1105(is)X 1207(the)X 1354(2-bit)X 1554(basic)X 1768(op)X 1897(code.)X 0 f 2166(fp_extended_op)X 1 f 2887(is)X 2989(the)X 3136(6-bit)X 3336(extended)X 3675(opcode)X 3956(\(if)X 0 f 576 1680(fp_base_op)N 1 f 1076(indicated)X 1390(there)X 1571(was)X 1716(an)X 1812(extended)X 2122(op)X 2222(code\))X 2421(and)X 2557(is)X 2630(zero)X 2789(otherwise.)X 0 f 576 1824(fp_register)N 1 f 1138(is)X 1225(any)X 1375(\(or)X 1503(the)X 1635(first\))X 1825(register)X 2101(value)X 2310(as)X 2412(defined)X 2688(in)X 2785(the)X 0 f 2946(Call)X 3201(Frame)X 3504(Instruction)X 576 1920(Encodings)N 1 f 1028(figure)X 1240(in)X 1322(the)X 0 f 1468(dwarf)X 1 f 1728(document.)X 2104(If)X 2178(not)X 2300(used)X 2467(with)X 2629(the)X 2747(Op)X 2865(it)X 2929(is)X 3002(0.)X 0 f 576 2064(fp_offset)N 1 f 1061(is)X 1167(the)X 1318(address,)X 1632(delta,)X 1861(offset,)X 2117(or)X 2237(second)X 2513(register)X 2807(as)X 2927(defined)X 3222(in)X 3338(the)X 0 f 3518(Call)X 3792(Frame)X 576 2160(Instruction)N 1162(Encodings)X 1 f 1624(figure)X 1846(in)X 1938(the)X 0 f 2094(dwarf)X 1 f 2364(document.)X 2750(If)X 2834(this)X 2979(is)X 3062(an)X 0 f 3196(address)X 1 f 3562(then)X 3730(the)X 3858(value)X 576 2256(should)N 821(be)X 929(cast)X 1086(to)X 0 f 1208(\(Dwarf_Addr\))X 1 f 1816(before)X 2054(being)X 2264(used.)X 2483(In)X 2582(any)X 2730(implementation)X 3264(this)X 3411(field)X 3590(*must*)X 3857(be)X 3965(as)X 576 2352(large)N 758(as)X 846(the)X 965(larger)X 1174(of)X 1262(Dwarf_Signed)X 1751(and)X 1888(Dwarf_Addr)X 2320(for)X 2435(this)X 2571(to)X 2654(work)X 2840(properly.)X 3172(If)X 3246(not)X 3368(used)X 3535(with)X 3697(the)X 3815(op)X 3915(it)X 3979(is)X 576 2448(0.)N 0 f 576 2592(fp_instr_offset)N 1 f 1327(is)X 1411(the)X 1540(byte_offset)X 1932(\(within)X 2194(the)X 2323(instruction)X 2696(stream)X 2941(of)X 3039(the)X 3168(frame)X 3387(instructions\))X 3818(of)X 3917(this)X 576 2688(operation.)N 939(It)X 1008(starts)X 1197(at)X 1275(0)X 1335(for)X 1449(a)X 1505(given)X 1703(frame)X 1911(descriptor.)X 3 f 576 2928(2.3.5)N 776(Frame)X 1024(Regtable:)X 1374(DWARF)X 1697(2)X 1 f 576 3072(This)N 742(interface)X 1048(is)X 1125(adequate)X 1435(for)X 1554(DWARF2)X 1908(but)X 2035(not)X 2162(for)X 2281(DWARF3.)X 2675(A)X 2758(separate)X 3047(interface)X 3354(usable)X 3584(for)X 3703(DWARF3)X 576 3168(and)N 712(for)X 826(DWARF2)X 1175(is)X 1248(described)X 1576(below.)X 576 3312(The)N 0 f 749(Dwarf_Regtable)X 1 f 1442(type)X 1601(is)X 1675(used)X 1843(to)X 1926(contain)X 2183(the)X 2302(register-restore)X 2810(information)X 3209(for)X 3324(all)X 3425(registers)X 3718(at)X 3797(a)X 3854(given)X 576 3408(PC)N 693(value.)X 927(Normally)X 1254(used)X 1421(by)X 1521(debuggers.)X 0 f 576 3552(/*)N 720(DW_REG_TABLE_SIZE)X 1584(must)X 1824(reflect)X 2208(the)X 2400(number)X 2736(of)X 2880(registers)X 624 3648(*\(DW_FRAME_LAST_REG_NUM\))N 1824(as)X 1968(defined)X 2352(in)X 2496(dwarf.h)X 624 3744(*/)N 576 3840(#define)N 960(DW_REG_TABLE_SIZE)X 1872()X 576 3936(typedef)N 960(struct)X 1296({)X 768 4032(struct)N 1104({)X 960 4128(Dwarf_Small)N 1920(dw_offset_relevant;)X 960 4224(Dwarf_Half)N 1920(dw_regnum;)X 960 4320(Dwarf_Addr)N 1920(dw_offset;)X 768 4416(})N 1920(rules[DW_REG_TABLE_SIZE];)X 576 4512(})N 672(Dwarf_Regtable;)X 1 f 576 4656(The)N 721(array)X 907(is)X 980(indexed)X 1254(by)X 1354(register)X 1615(number.)X 1920(The)X 2065(field)X 2232(values)X 2457(for)X 2571(each)X 2739(index)X 2937(are)X 3056(described)X 3384(next.)X 3582(For)X 3713(clarity)X 3938(we)X 576 4752(describe)N 864(the)X 982(field)X 1149(values)X 1374(for)X 1488(index)X 1686(rules[M])X 1987(\(M)X 2105(being)X 2303(any)X 2439(legal)X 2615(array)X 2801(element)X 3075(index\).)X 0 f 576 4896(dw_offset_relevant)N 1 f 1468(is)X 1549(non-zero)X 1863(to)X 1953(indicate)X 2235(the)X 0 f 2389(dw_offset)X 1 f 2849(field)X 3024(is)X 3105(meaningful.)X 3518(If)X 3600(zero)X 3767(then)X 3934(the)X 0 f 576 4992(dw_offset)N 1 f 1028(is)X 1101(zero)X 1260(and)X 1396(should)X 1629(be)X 1725(ignored.)X 0 f 576 5136(dw_regnum)N 1 f 1049(is)X 1143(the)X 1282(register)X 1565(number)X 0 f 1880(applicable.)X 2526(If)X 2692(dw_offset_relevant)X 3626(is)X 3792(zero,)X 576 5232(then)N 830(this)X 1083(is)X 1240(the)X 1445(register)X 1890(number)X 2239(of)X 2396(the)X 2601(register)X 3046(containing)X 3587(the)X 3792(value)X 576 5328(for)N 787(register)X 1238(M.)X 1449(If)X 1612(dw_offset_relevant)X 2543(is)X 2706(non-zero,)X 3205(then)X 3464(this)X 3724(is)X 3888(the)X 576 5424(register)N 1064(number)X 1456(of)X 1656(the)X 1904(register)X 2392(to)X 2592(use)X 2840(as)X 3040(a)X 3192(base)X 3488(\(M)X 3688(may)X 3936(be)X 576 5520(DW_FRAME_CFA_COL,)N 1464(for)X 1680(example\))X 2136(and)X 2352(the)X 2568(dw_offset)X 3072(value)X 3384(applies.)X 3888(The)X 576 5616(value)N 864(of)X 1008(register)X 1440(M)X 1536(is)X 1680(therefore)X 2160(the)X 2352(value)X 2640(of)X 2784(register)X 3216(dw_regnum.)X 576 5760(dw_offset)N 1116(should)X 1512(be)X 1716(ignored)X 2160(if)X 2364(dw_offset_relevant)X 3336(is)X 3540(zero.)X 3936(If)X 576 5856(dw_offset_relevant)N 1504(is)X 1664(non-zero,)X 2160(then)X 2416(the)X 2624(consumer)X 3072(code)X 3328(should)X 3680(add)X 3888(the)X 576 5952(value)N 864(to)X 1008(the)X 1200(value)X 1488(of)X 1632(the)X 1824(register)X 2256(dw_regnum)X 2736(to)X 2880(produce)X 3264(the)X 3456(value.)X 1 f 576 6183(rev)N 699(1.61,)X 879(3)X 939(Apr)X 1084(2006)X 2237(-)X 2284(6)X 2344(-)X 7 p %%Page: 7 7 0(Courier)xf 0 f 10 s 0 xH 0 xS 0 f 1 f 2237 384(-)N 2284(7)X 2344(-)X 3 f 576 768(2.3.6)N 776(Frame)X 1024(Operation)X 1395(Codes:)X 1651(DWARF)X 1974(3)X 2034(\(and)X 2209(DWARF2\))X 1 f 576 912(This)N 738(interface)X 1040(is)X 1113(adequate)X 1419(for)X 1533(DWARF3)X 1882(and)X 2018(for)X 2132(DWARF2.)X 2521(It)X 2590(is)X 2663(new)X 2817(in)X 2899(libdwarf)X 3191(in)X 3273(April)X 3462(2006.)X 576 1056(The)N 741(DWARF2)X 0 f 1138(Dwarf_Frame_Op3)X 1 f 1898(type)X 2076(is)X 2169(used)X 2356(to)X 2458(contain)X 2734(the)X 2873(data)X 3048(of)X 3156(a)X 3233(single)X 3465(instruction)X 3848(of)X 3956(an)X 576 1152(instruction-sequence)N 1279(of)X 1385(low-level)X 1727(information)X 2144(from)X 2339(the)X 2476(section)X 2741(containing)X 3117(frame)X 3343(information.)X 3799(This)X 3979(is)X 576 1248(ordinarily)N 912(used)X 1079(by)X 1179(Internal-level)X 1632(Consumers)X 2012(trying)X 2223(to)X 2305(print)X 2476(everything)X 2839(in)X 2921(detail.)X 0 f 576 1488(typedef)N 960(struct)X 1296({)X 960 1584(Dwarf_Small)N 1728(fp_base_op;)X 960 1680(Dwarf_Small)N 1728(fp_extended_op;)X 960 1776(Dwarf_Half)N 1728(fp_register;)X 960 1968(/*)N 1104(Value)X 1392(may)X 1584(be)X 1728(signed,)X 2112(depends)X 2496(on)X 2640(op.)X 1104 2064(Any)N 1296(applicable)X 1824(data_alignment_factor)X 2880(has)X 1104 2160(not)N 1296(been)X 1536(applied,)X 1968(this)X 2208(is)X 2352(the)X 2592(raw)X 2784(offset.)X 3168(*/)X 960 2256(Dwarf_Unsigned)N 1728(fp_offset_or_block_len;)X 960 2352(Dwarf_Small)N 1728(*fp_expr_block;)X 960 2544(Dwarf_Off)N 1728(fp_instr_offset;)X 576 2640(})N 672(Dwarf_Frame_Op3;)X 576 2880(fp_base_op)N 1 f 1105(is)X 1207(the)X 1354(2-bit)X 1554(basic)X 1768(op)X 1897(code.)X 0 f 2166(fp_extended_op)X 1 f 2887(is)X 2989(the)X 3136(6-bit)X 3336(extended)X 3675(opcode)X 3956(\(if)X 0 f 576 2976(fp_base_op)N 1 f 1076(indicated)X 1390(there)X 1571(was)X 1716(an)X 1812(extended)X 2122(op)X 2222(code\))X 2421(and)X 2557(is)X 2630(zero)X 2789(otherwise.)X 0 f 576 3120(fp_register)N 1 f 1138(is)X 1225(any)X 1375(\(or)X 1503(the)X 1635(first\))X 1825(register)X 2101(value)X 2310(as)X 2412(defined)X 2688(in)X 2785(the)X 0 f 2946(Call)X 3201(Frame)X 3504(Instruction)X 576 3216(Encodings)N 1 f 1028(figure)X 1240(in)X 1322(the)X 0 f 1468(dwarf)X 1 f 1728(document.)X 2104(If)X 2178(not)X 2300(used)X 2467(with)X 2629(the)X 2747(Op)X 2865(it)X 2929(is)X 3002(0.)X 0 f 576 3360(fp_offset_or_block_len)N 1 f 1662(is)X 1745(the)X 1873(address,)X 2164(delta,)X 2370(offset,)X 2603(or)X 2700(second)X 2953(register)X 3224(as)X 3321(defined)X 3592(in)X 3684(the)X 0 f 3840(Call)X 576 3456(Frame)N 869(Instruction)X 1450(Encodings)X 1 f 1906(figure)X 2122(in)X 2208(the)X 0 f 2358(dwarf)X 1 f 2622(document.)X 2982(Or)X 3091(\(depending)X 3476(on)X 3580(the)X 3702(op,)X 3826(it)X 3894(may)X 576 3552(be)N 681(the)X 808(length)X 1037(of)X 1133(the)X 1260(dwarf-expression)X 1848(block)X 2056(pointed)X 2326(to)X 2418(by)X 0 f 2556(fp_expr_block)X 1 f (.)S 3250(If)X 3334(this)X 3479(is)X 3562(an)X 0 f 3696(address)X 1 f 576 3648(then)N 744(the)X 872(value)X 1076(should)X 1319(be)X 1425(cast)X 1580(to)X 0 f 1700(\(Dwarf_Addr\))X 1 f 2306(before)X 2542(being)X 2750(used.)X 2967(In)X 3064(any)X 3210(implementation)X 3741(this)X 3885(field)X 576 3744(*must*)N 836(be)X 937(as)X 1029(large)X 1215(as)X 1307(the)X 1430(larger)X 1643(of)X 1735(Dwarf_Signed)X 2228(and)X 2369(Dwarf_Addr)X 2805(for)X 2924(this)X 3064(to)X 3151(work)X 3341(properly.)X 3678(If)X 3757(not)X 3885(used)X 576 3840(with)N 738(the)X 856(op)X 956(it)X 1020(is)X 1093(0.)X 0 f 576 3984(fp_expr_block)N 1 f 1275(\(if)X 1426(applicable)X 1831(to)X 1968(the)X 2141(op\))X 2323(points)X 2593(to)X 2730(a)X 2841(dwarf-expression)X 3475(block)X 3729(whch)X 3979(is)X 0 f 576 4080(fp_offset_or_block_len)N 1 f 1652(bytes)X 1841(long.)X 0 f 576 4224(fp_instr_offset)N 1 f 1327(is)X 1411(the)X 1540(byte_offset)X 1932(\(within)X 2194(the)X 2323(instruction)X 2696(stream)X 2941(of)X 3039(the)X 3168(frame)X 3387(instructions\))X 3818(of)X 3917(this)X 576 4320(operation.)N 939(It)X 1008(starts)X 1197(at)X 1275(0)X 1335(for)X 1449(a)X 1505(given)X 1703(frame)X 1911(descriptor.)X 3 f 576 4560(2.3.7)N 776(Frame)X 1024(Regtable:)X 1374(DWARF)X 1697(3)X 1 f 576 4704(This)N 738(interface)X 1040(is)X 1113(adequate)X 1419(for)X 1533(DWARF3)X 1882(and)X 2018(for)X 2132(DWARF2.)X 2521(It)X 2590(is)X 2663(new)X 2817(in)X 2899(libdwarf)X 3191(as)X 3278(of)X 3365(April)X 3554(2006.)X 576 4848(The)N 0 f 760(Dwarf_Regtable3)X 1 f 1511(type)X 1680(is)X 1764(used)X 1943(to)X 2037(contain)X 2305(the)X 2435(register-restore)X 2954(information)X 3364(for)X 3490(all)X 3602(registers)X 3906(at)X 3996(a)X 576 4944(given)N 774(PC)X 891(value.)X 1125(Normally)X 1452(used)X 1619(by)X 1719(debuggers.)X 576 6183(rev)N 699(1.61,)X 879(3)X 939(Apr)X 1084(2006)X 2237(-)X 2284(7)X 2344(-)X 8 p %%Page: 8 8 0(Courier)xf 0 f 10 s 0 xH 0 xS 0 f 1 f 2237 384(-)N 2284(8)X 2344(-)X 0 f 576 768(typedef)N 960(struct)X 1296(Dwarf_Regtable_Entry3_s)X 2448({)X 960 864(Dwarf_Small)N 1920(dw_offset_relevant;)X 960 960(Dwarf_Small)N 1920(dw_value_type;)X 960 1056(Dwarf_Half)N 1920(dw_regnum;)X 960 1152(Dwarf_Unsigned)N 1920(dw_offset_or_block_len;)X 960 1248(Dwarf_Ptr)N 1920(dw_block_ptr;)X 576 1344(}Dwarf_Regtable_Entry3;)N 576 1536(typedef)N 960(struct)X 1296(Dwarf_Regtable3_s)X 2160({)X 768 1632(struct)N 1104(Dwarf_Regtable_Entry3_s)X 2352(rt3_cfa_rule;)X 768 1824(Dwarf_Half)N 2352(rt3_reg_table_size;)X 768 1920(struct)N 1104(Dwarf_Regtable_Entry3_s)X 2256(*)X 2352(rt3_rules;)X 576 2016(})N 672(Dwarf_Regtable3;)X 1 f 576 2256(The)N 721(array)X 907(is)X 980(indexed)X 1254(by)X 1354(register)X 1615(number.)X 1920(The)X 2065(field)X 2232(values)X 2457(for)X 2571(each)X 2739(index)X 2937(are)X 3056(described)X 3384(next.)X 3582(For)X 3713(clarity)X 3938(we)X 576 2352(describe)N 921(the)X 1096(field)X 1320(values)X 1602(for)X 1772(index)X 2026(rules[M])X 2383(\(M)X 2557(being)X 2811(any)X 3003(legal)X 3235(array)X 3477(element)X 3807(index\).)X 576 2448(\(DW_FRAME_CFA_COL3)N 1565(DW_FRAME_SAME_VAL,)X 2560(DW_FRAME_UNDEFINED_VAL)X 3772(are)X 3930(not)X 576 2544(legal)N 758(array)X 950(indexes,)X 1241(nor)X 1374(is)X 1453(any)X 1595(index)X 1799(<)X 1870(0)X 1936(or)X 2029(>)X 2100(rt3_reg_table_size\);)X 2767(The)X 2917(caller)X 3141(of)X 3233(routines)X 3516(using)X 3714(this)X 3854(struct)X 576 2640(must)N 756(create)X 975(data)X 1135(space)X 1340(for)X 1460(rt3_reg_table_size)X 2079(entries)X 2319(of)X 2412(struct)X 2616(Dwarf_Regtable_Entry3_s)X 3502(and)X 3644(arrange)X 3912(that)X 576 2736(rt3_rules)N 891(points)X 1116(to)X 1207(that)X 1356(space)X 1564(and)X 1709(that)X 1858(rt3_reg_table_size)X 2480(is)X 2562(set)X 2680(correctly.)X 3035(The)X 3189(caller)X 3397(need)X 3578(not)X 3709(\(but)X 3867(may\))X 576 2832(initialize)N 885(the)X 1012(contents)X 1308(of)X 1404(the)X 1531(rt3_cfa_rule)X 1953(or)X 2049(the)X 2176(rt3_rules)X 2490(array.)X 2725(The)X 2879(following)X 3220(applies)X 3477(to)X 3569(each)X 3747(rt3_rules)X 576 2928(rule)N 721(M:)X 0 f 896 3072(dw_regnum)N 1 f 1469(is)X 1663(the)X 1902(register)X 2284(number)X 2670(applicable.)X 3181(If)X 0 f 3405(dw_regnum)X 1 f 3979(is)X 896 3168(DW_FRAME_UNDEFINED_VAL,)N 2094(then)X 2257(the)X 2380(register)X 2646(I)X 2698(has)X 2830(undefined)X 3176(value.)X 3415(If)X 0 f 3522(dw_regnum)X 1 f 3979(is)X 896 3264(DW_FRAME_SAME_VAL,)N 1852(then)X 2010(the)X 2128(register)X 2389(I)X 2436(has)X 2563(the)X 2681(same)X 2866(value)X 3060(as)X 3147(in)X 3229(the)X 3347(previous)X 3643(frame.)X 896 3408(If)N 0 f 998(dw_regnum)X 1 f 1450(is)X 1523(neither)X 1766(of)X 1853(these)X 2038(two,)X 2198(then)X 2356(the)X 2474(following)X 2805(apply:)X 0 f 896 3552(dw_value_type)N 1 f 1540(determines)X 1912(the)X 2030(meaning)X 2326(of)X 2413(the)X 2532(other)X 2718(fields.)X 2957(It)X 3027(is)X 3101(one)X 3238(of)X 3326(DW_EXPR_OFFSET)X 896 3648(\(0\),)N 1322(DW_EXPR_VAL_OFFSET\(1\),)X 2658(DW_EXPR_EXPRESSION\(2\))X 3965(or)X 896 3744(DW_EXPR_VAL_EXPRESSION\(3\).)N 896 3984(If)N 0 f 999(dw_value_type)X 1 f 1664(is)X 1739(DW_EXPR_OFFSET)X 2467(\(0\))X 2583(then)X 2743(this)X 2880(is)X 2955(as)X 3044(in)X 3128(DWARF2)X 3479(and)X 3617(the)X 3737(offset\(N\))X 896 4080(rule)N 1076(or)X 1178(the)X 1311(register\(R\))X 1693(rule)X 1852(of)X 1953(the)X 2085(DWARF3)X 2448(and)X 2598(DWARF2)X 2961(document)X 3311(applies.)X 3612(The)X 3771(value)X 3979(is)X 896 4176(either:)N 1216 4272(If)N 0 f 1331(dw_offset_relevant)X 1 f 2229(is)X 2316(non-zero,)X 2656(then)X 0 f 2856(dw_regnum)X 1 f 3322(is)X 3409(effectively)X 3787(ignored)X 1216 4368(but)N 1364(must)X 1565(be)X 1687(identical)X 2009(to)X 2117(DW_FRAME_CFA_COL3)X 3047(and)X 3209(the)X 0 f 3381(dw_offset)X 1 f 3858(value)X 1216 4464(applies.)N 1520(The)X 1682(value)X 1893(of)X 1997(register)X 2275(M)X 2383(is)X 2473(therefore)X 2801(the)X 2936(value)X 3148(of)X 3253(CFA)X 3446(plus)X 3617(the)X 3753(value)X 3965(of)X 0 f 1216 4560(dw_offset)N 1 f (.)S 1733(The)X 1883(result)X 2085(of)X 2176(the)X 2298(calculation)X 2674(is)X 2751(the)X 2873(address)X 3138(in)X 3224(memory)X 3515(where)X 3736(the)X 3858(value)X 1216 4656(of)N 1323(register)X 1604(M)X 1715(resides.)X 2018(This)X 2200(is)X 2293(the)X 2431(offset\(N\))X 2766(rule)X 2931(of)X 3038(the)X 3176(DWARF2)X 3546(and)X 3703(DWARF3)X 1216 4752(documents.)N 0 f 1216 4896(dw_offset_relevant)N 1 f 2143(is)X 2259(zero)X 2461(it)X 2568(indicates)X 2916(the)X 0 f 3106(dw_offset)X 1 f 3602(field)X 3813(is)X 3930(not)X 1216 4992(meaningful.)N 1651(The)X 1806(value)X 2010(of)X 2107(register)X 2378(M)X 2479(is)X 2562(the)X 2689(value)X 2892(currently)X 3211(in)X 3302(register)X 0 f 3600(dw_regnum)X 1 f 1216 5088(\(the)N 1363(value)X 1559(DW_FRAME_CFA_COL3)X 2465(must)X 2642(not)X 2766(appear,)X 3023(only)X 3187(real)X 3331(registers\).)X 3693(This)X 3858(is)X 3934(the)X 1216 5184(register\(R\))N 1584(rule)X 1729(of)X 1816(the)X 1934(DWARF3)X 2283(spec.)X 896 5424(If)N 0 f 1003(dw_value_type)X 1 f 1672(is)X 1750(DW_EXPR_OFFSET)X 2481(\(1\))X 2600(then)X 2763(this)X 2904(is)X 2983(the)X 3107(the)X 3231(val_offset\(N\))X 3690(rule)X 3841(of)X 3934(the)X 896 5520(DWARF3)N 1252(spec)X 1422(applies.)X 1716(The)X 1868(calculation)X 2246(is)X 2325(identical)X 2627(to)X 2715(that)X 2861(of)X 2954(DW_EXPR_OFFSET)X 3686(\(0\))X 3806(but)X 3934(the)X 896 5616(value)N 1091(is)X 1165(interpreted)X 1534(as)X 1622(the)X 1741(value)X 1936(of)X 2024(register)X 2286(M)X 2378(\(rather)X 2614(than)X 2773(the)X 2892(address)X 3154(where)X 3372(register)X 3634(M's)X 3784(value)X 3979(is)X 896 5712(stored\).)N 896 5856(If)N 0 f 1004(dw_value_type)X 1 f 1674(is)X 1753(DW_EXPR_EXPRESSION)X 2681(\(2\))X 2801(then)X 2965(this)X 3106(is)X 3185(the)X 3309(the)X 3434(expression\(E\))X 3907(rule)X 896 5952(of)N 983(the)X 1101(DWARF3)X 1450(document.)X 576 6183(rev)N 699(1.61,)X 879(3)X 939(Apr)X 1084(2006)X 2237(-)X 2284(8)X 2344(-)X 9 p %%Page: 9 9 0(Courier)xf 0 f 10 s 0 xH 0 xS 0 f 1 f 2237 384(-)N 2284(9)X 2344(-)X 0 f 1216 768(dw_offset_or_block_len)N 1 f 2293(is)X 2368(the)X 2488(length)X 2710(in)X 2794(bytes)X 2985(of)X 3074(the)X 3194(in-memory)X 3572(block)X 3792(pointed)X 1216 864(at)N 1301(by)X 0 f 1436(dw_block_ptr)X 1 f (.)S 0 f 2135(dw_block_ptr)X 1 f 2738(is)X 2818(a)X 2881(DWARF)X 3196(expression.)X 3605(Evaluate)X 3912(that)X 1216 960(expression)N 1579(and)X 1715(the)X 1833(result)X 2031(is)X 2104(the)X 2222(address)X 2483(where)X 2700(the)X 2818(previous)X 3114(value)X 3308(of)X 3395(register)X 3656(M)X 3747(is)X 3820(found.)X 896 1104(If)N 0 f 1050(dw_value_type)X 1 f 1766(is)X 1891(DW_EXPR_VAL_EXPRESSION)X 3071(\(3\))X 3238(then)X 3449(this)X 3637(is)X 3763(the)X 3934(the)X 896 1200(val_expression\(E\))N 1500(rule)X 1645(of)X 1732(the)X 1850(DWARF3)X 2199(spec.)X 0 f 1216 1344(dw_offset_or_block_len)N 1 f 2293(is)X 2368(the)X 2488(length)X 2710(in)X 2794(bytes)X 2985(of)X 3074(the)X 3194(in-memory)X 3572(block)X 3792(pointed)X 1216 1440(at)N 1301(by)X 0 f 1436(dw_block_ptr)X 1 f (.)S 0 f 2135(dw_block_ptr)X 1 f 2738(is)X 2818(a)X 2881(DWARF)X 3196(expression.)X 3605(Evaluate)X 3912(that)X 1216 1536(expression)N 1579(and)X 1715(the)X 1833(result)X 2031(is)X 2104(the)X 2222(previous)X 2518(value)X 2712(of)X 2799(register)X 3060(M.)X 896 1680(The)N 1052(rule)X 0 f 1236(rt3_cfa_rule)X 1 f 1843(is)X 1927(the)X 2056(current)X 2315(value)X 2520(of)X 2618(the)X 2747(CFA.)X 2954(It)X 3035(is)X 3120(interpreted)X 3500(exactly)X 3764(like)X 3916(any)X 896 1776(register)N 1218(M)X 1370(rule)X 1576(\(as)X 1750(described)X 2138(just)X 2333(above\))X 2632(except)X 2922(that)X 0 f 3150(dw_regnum)X 1 f 3662(cannot)X 3956(be)X 896 1872(CW_FRAME_CFA_REG3)N 2098(or)X 2488(DW_FRAME_UNDEFINED_VAL)X 3965(or)X 896 1968(DW_FRAME_SAME_VAL)N 1832(but)X 1954(must)X 2129(be)X 2225(a)X 2281(real)X 2422(register)X 2683(number.)X 3 f 576 2400(2.3.8)N 776(Macro)X 1024(Details)X 1280(Record)X 1 f 576 2544(The)N 0 f 772(Dwarf_Macro_Details)X 1 f 1727(type)X 1908(gives)X 2120(information)X 2541(about)X 2762(a)X 2841(single)X 3076(entry)X 3285(in)X 3391(the)X 3533(.debug.macinfo)X 576 2640(section.)N 0 f 576 2784(struct)N 912(Dwarf_Macro_Details_s)X 1968({)X 672 2880(Dwarf_Off)N 1296(dmd_offset;)X 672 2976(Dwarf_Small)N 1296(dmd_type;)X 672 3072(Dwarf_Signed)N 1296(dmd_lineno;)X 672 3168(Dwarf_Signed)N 1296(dmd_fileindex;)X 672 3264(char)N 912(*)X 1296(dmd_macro;)X 576 3360(};)N 576 3456(typedef)N 960(struct)X 1296(Dwarf_Macro_Details_s)X 2352(Dwarf_Macro_Details;)X 576 3600(dmd_offset)N 1 f 1076(is)X 1149(the)X 1267(byte)X 1425(offset,)X 1648(within)X 1872(the)X 1990(.debug_macinfo)X 2529(section,)X 2796(of)X 2883(this)X 3018(macro)X 3239(information.)X 0 f 576 3744(dmd_type)N 1 f 984(is)X 1061(the)X 1184(type)X 1347(code)X 1524(of)X 1616(this)X 1756(macro)X 1982(info)X 2136(entry)X 2326(\(or)X 2445(0,)X 2530(the)X 2653(type)X 2816(code)X 2993(indicating)X 3338(that)X 3483(this)X 3623(is)X 3701(the)X 3824(end)X 3965(of)X 576 3840(macro)N 816(information)X 1233(entries)X 1486(for)X 1619(a)X 1694(compilation)X 2115(unit.)X 2318(See)X 0 f 2501(DW_MACINFO_define)X 1 f (,)S 3375(etc)X 3507(in)X 3607(the)X 3743(DWARF)X 576 3936(document.)N 0 f 576 4080(dmd_lineno)N 1 f 1076(is)X 1149(the)X 1267(line)X 1407(number)X 1672(where)X 1889(this)X 2024(entry)X 2209(was)X 2354(found,)X 2581(or)X 2668(0)X 2728(if)X 2797(there)X 2978(is)X 3051(no)X 3151(applicable)X 3501(line)X 3641(number.)X 0 f 576 4224(dmd_fileindex)N 1 f 1242(is)X 1337(the)X 1477(file)X 1626(index)X 1846(of)X 1955(the)X 2095(file)X 2244(involved.)X 2606(This)X 2790(is)X 2885(only)X 3069(guaranteed)X 3465(meaningful)X 3873(on)X 3996(a)X 0 f 576 4320(DW_MACINFO_start_file)N 1639(dmd_type)X 1 f (.)S 2090(Set)X 2219(to)X 2308(-1)X 2402(if)X 2478(unknown)X 2803(\(see)X 2960(the)X 3085(functional)X 3437(interface)X 3746(for)X 3867(more)X 576 4416(details\).)N 0 f 576 4560(dmd_macro)N 1 f 1035(is)X 1115(the)X 1240(applicable)X 1597(string.)X 1846(For)X 1984(a)X 0 f 2075(DW_MACINFO_define)X 1 f 2918(this)X 3060(is)X 3140(the)X 3265(macro)X 3493(name)X 3694(and)X 3838(value.)X 576 4656(For)N 709(a)X 0 f 795(DW_MACINFO_undef)X 1 f (,)S 1604(or)X 1692(this)X 1828(is)X 1902(the)X 2021(macro)X 2243(name.)X 2478(For)X 2610(a)X 0 f 2695(DW_MACINFO_vendor_ext)X 1 f 3724(this)X 3860(is)X 3934(the)X 576 4752(vendor-defined)N 1087(string)X 1289(value.)X 1523(For)X 1654(other)X 0 f 1867(dmd_type)X 1 f (s)S 2302(this)X 2437(is)X 2510(0.)X 3 f 11 s 576 4992(2.4)N 730(Opaque)X 1051(Types)X 1 f 10 s 576 5136(The)N 728(opaque)X 987(types)X 1183(declared)X 1483(in)X 2 f 1572(libdwarf.h)X 1 f 1929(are)X 2055(used)X 2229(as)X 2323(descriptors)X 2702(for)X 2823(queries)X 3082(against)X 3337(DWARF)X 3654(information)X 576 5232(stored)N 797(in)X 884(various)X 1145(debugging)X 1508(sections.)X 1831(Each)X 2017(time)X 2184(an)X 2285(instance)X 2573(of)X 2665(an)X 2765(opaque)X 3021(type)X 3183(is)X 3260(returned)X 3552(as)X 3643(a)X 3703(result)X 3905(of)X 3996(a)X 2 f 576 5328(libdwarf)N 1 f 867(operation)X 1191(\()X 0 f 1218(Dwarf_Debug)X 1 f 1767(excepted\),)X 2121(it)X 2186(should)X 2420(be)X 2517(free'd,)X 2752(using)X 0 f 2975(dwarf_dealloc\(\))X 1 f 3717(when)X 3913(it)X 3979(is)X 576 5424(no)N 686(longer)X 921(of)X 1018(use)X 1155(\(read)X 1351(the)X 1479(following)X 1820(documentation)X 2326(for)X 2450(details,)X 2709(as)X 2805(in)X 2896(at)X 2983(least)X 3159(one)X 3304(case)X 3472(there)X 3662(is)X 3744(a)X 3809(special)X 576 5520(routine)N 888(provided)X 1258(for)X 1437(deallocation)X 1915(and)X 0 f 2145(dwarf_dealloc\(\))X 1 f 2951(is)X 3090(not)X 3278(directly)X 3609(called:)X 3929(see)X 0 f 576 5616(dwarf_srclines\(\))N 1 f (\).)S 1439(Some)X 1649(functions)X 1975(return)X 2195(a)X 2259(number)X 2532(of)X 2627(instances)X 2949(of)X 3044(an)X 3148(opaque)X 3408(type)X 3574(in)X 3664(a)X 3727(block,)X 3952(by)X 576 5712(means)N 811(of)X 908(a)X 974(pointer)X 1231(to)X 1323(the)X 1451(block)X 1659(and)X 1805(a)X 1871(count)X 2080(of)X 2178(the)X 2307(number)X 2583(of)X 2681(opaque)X 2944(descriptors)X 3327(in)X 3420(the)X 3549(block:)X 3800(see)X 3934(the)X 576 5808(function)N 888(description)X 1289(for)X 1428(deallocation)X 1864(rules)X 2064(for)X 2202(such)X 2393(functions.)X 2775(The)X 2944(list)X 3085(of)X 3196(opaque)X 3472(types)X 3685(defined)X 3970(in)X 2 f 576 5904(libdwarf.h)N 1 f 926(that)X 1066(are)X 1185(pertinent)X 1490(to)X 1572(the)X 1690(Consumer)X 2039(Library,)X 2320(and)X 2456(their)X 2623(intended)X 2919(use)X 3046(is)X 3119(described)X 3447(below.)X 576 6183(rev)N 699(1.61,)X 879(3)X 939(Apr)X 1084(2006)X 2237(-)X 2284(9)X 2344(-)X 10 p %%Page: 10 10 0(Courier)xf 0 f 10 s 0 xH 0 xS 0 f 1 f 2217 384(-)N 2264(10)X 2364(-)X 0 f 576 768(typedef)N 960(struct)X 1296(Dwarf_Debug_s*)X 2016(Dwarf_Debug;)X 1 f 576 912(An)N 695(instance)X 979(of)X 1067(the)X 0 f 1214(Dwarf_Debug)X 1 f 1763(type)X 1922(is)X 1996(created)X 2251(as)X 2340(a)X 2398(result)X 2598(of)X 2687(a)X 2745(successful)X 3097(call)X 3235(to)X 0 f 3347(dwarf_init\(\))X 1 f (,)S 3965(or)X 0 f 576 1008(dwarf_elf_init\(\))N 1 f (,)S 1391(and)X 1534(is)X 1614(used)X 1788(as)X 1882(a)X 1945(descriptor)X 2293(for)X 2413(subsequent)X 2795(access)X 3027(to)X 3115(most)X 0 f 3324(libdwarf)X 1 f 3734(functions)X 576 1104(on)N 711(that)X 886(object.)X 1178(The)X 1359(storage)X 1647(pointed)X 1943(to)X 2061(by)X 2197(this)X 2368(descriptor)X 2745(should)X 3014(be)X 3146(not)X 3304(be)X 3436(free'd,)X 3705(using)X 3934(the)X 0 f 576 1200(dwarf_dealloc\(\))N 1 f 1316(function.)X 1643(Instead)X 1895(free)X 2041(it)X 2105(with)X 0 f 2295(dwarf_finish\(\))X 1 f (.)S 0 f 576 1488(typedef)N 960(struct)X 1296(Dwarf_Die_s*)X 1920(Dwarf_Die;)X 1 f 576 1632(An)N 703(instance)X 995(of)X 1091(a)X 0 f 1184(Dwarf_Die)X 1 f 1645(type)X 1812(is)X 1894(returned)X 2191(from)X 2376(a)X 2442(successful)X 2802(call)X 2948(to)X 3040(the)X 0 f 3196(dwarf_siblingof\(\))X 1 f (,)S 0 f 576 1728(dwarf_child)N 1 f (,)S 1175(or)X 0 f 1321(dwarf_offdie\(\))X 1 f 2044(function,)X 2382(and)X 2549(is)X 2653(used)X 2851(as)X 2969(a)X 3056(descriptor)X 3428(for)X 3572(queries)X 3854(about)X 576 1824(information)N 997(related)X 1259(to)X 1364(that)X 1527(DIE.)X 1744(The)X 1912(storage)X 2187(pointed)X 2471(to)X 2577(by)X 2701(this)X 2860(descriptor)X 3225(should)X 3482(be)X 3602(free'd,)X 3859(using)X 0 f 576 1920(dwarf_dealloc\(\))N 1 f 1316(with)X 1478(the)X 1596(allocation)X 1932(type)X 0 f 2118(DW_DLA_DIE)X 1 f 2618(when)X 2812(no)X 2912(longer)X 3137(needed.)X 0 f 576 2160(typedef)N 960(struct)X 1296(Dwarf_Line_s*)X 1968(Dwarf_Line;)X 1 f 576 2304(Instances)N 915(of)X 0 f 1050(Dwarf_Line)X 1 f 1570(type)X 1748(are)X 1887(returned)X 2195(from)X 2391(a)X 2467(successful)X 2837(call)X 2994(to)X 3097(the)X 0 f 3264(dwarf_srclines\(\))X 1 f 576 2400(function,)N 900(and)X 1053(are)X 1189(used)X 1372(as)X 1475(descriptors)X 1863(for)X 1993(queries)X 2261(about)X 2475(source)X 2721(lines.)X 2948(The)X 3109(storage)X 3377(pointed)X 3653(to)X 3751(by)X 3867(these)X 576 2496(descriptors)N 988(should)X 1261(be)X 1397(individually)X 1843(free'd,)X 2116(using)X 0 f 2377(dwarf_dealloc\(\))X 1 f 3157(with)X 3359(the)X 3517(allocation)X 3894(type)X 0 f 576 2592(DW_DLA_LINE)N 1 f 1124(when)X 1318(no)X 1418(longer)X 1643(needed.)X 0 f 576 2832(typedef)N 960(struct)X 1296(Dwarf_Global_s*)X 2064(Dwarf_Global;)X 1 f 576 2976(Instances)N 895(of)X 0 f 1010(Dwarf_Global)X 1 f 1606(type)X 1764(are)X 1883(returned)X 2171(from)X 2347(a)X 2403(successful)X 2753(call)X 2890(to)X 2973(the)X 0 f 3120(dwarf_get_globals\(\))X 1 f 576 3072(function,)N 883(and)X 1019(are)X 1138(used)X 1305(as)X 1392(descriptors)X 1764(for)X 1878(queries)X 2130(about)X 2328(global)X 2548(names)X 2773(\(pubnames\).)X 0 f 576 3312(typedef)N 960(struct)X 1296(Dwarf_Weak_s*)X 1968(Dwarf_Weak;)X 1 f 576 3456(Instances)N 947(of)X 0 f 1114(Dwarf_Weak)X 1 f 1666(type)X 1877(are)X 2049(returned)X 2390(from)X 2619(a)X 2728(successful)X 3131(call)X 3320(to)X 3455(the)X 3626(SGI-specific)X 0 f 576 3552(dwarf_get_weaks\(\))N 1 f 1415(function,)X 1725(and)X 1864(are)X 1986(used)X 2156(as)X 2246(descriptors)X 2621(for)X 2738(queries)X 2993(about)X 3194(weak)X 3386(names.)X 3653(The)X 3800(storage)X 576 3648(pointed)N 858(to)X 962(by)X 1084(these)X 1291(descriptors)X 1685(should)X 1940(be)X 2058(individually)X 2486(free'd,)X 2742(using)X 0 f 2986(dwarf_dealloc\(\))X 1 f 3749(with)X 3934(the)X 576 3744(allocation)N 953(type)X 0 f 1180(DW_DLA_WEAK_CONTEXT)X 1 f 2153(\(or)X 0 f 2336(DW_DLA_WEAK)X 1 f (,)S 2945(an)X 3082(older)X 3308(name,)X 3562(supported)X 3938(for)X 576 3840(compatibility\))N 1049(when)X 1243(no)X 1343(longer)X 1568(needed.)X 0 f 576 4080(typedef)N 960(struct)X 1296(Dwarf_Func_s*)X 1968(Dwarf_Func;)X 1 f 576 4224(Instances)N 947(of)X 0 f 1114(Dwarf_Func)X 1 f 1666(type)X 1877(are)X 2049(returned)X 2390(from)X 2619(a)X 2728(successful)X 3131(call)X 3320(to)X 3455(the)X 3626(SGI-specific)X 0 f 576 4320(dwarf_get_funcs\(\))N 1 f 1412(function,)X 1719(and)X 1855(are)X 1974(used)X 2141(as)X 2228(descriptors)X 2600(for)X 2714(queries)X 2966(about)X 3164(static)X 3353(function)X 3640(names.)X 0 f 576 4560(typedef)N 960(struct)X 1296(Dwarf_Type_s*)X 1968(Dwarf_Type;)X 1 f 576 4704(Instances)N 947(of)X 0 f 1114(Dwarf_Type)X 1 f 1666(type)X 1877(are)X 2049(returned)X 2390(from)X 2619(a)X 2728(successful)X 3131(call)X 3320(to)X 3455(the)X 3626(SGI-specific)X 0 f 576 4800(dwarf_get_types\(\))N 1 f 1412(function,)X 1719(and)X 1855(are)X 1974(used)X 2141(as)X 2228(descriptors)X 2600(for)X 2714(queries)X 2966(about)X 3164(user)X 3318(defined)X 3579(types.)X 0 f 576 5040(typedef)N 960(struct)X 1296(Dwarf_Var_s*)X 1920(Dwarf_Var;)X 1 f 576 5184(Instances)N 951(of)X 0 f 1122(Dwarf_Var)X 1 f 1630(type)X 1845(are)X 2021(returned)X 2366(from)X 2599(a)X 2712(successful)X 3119(call)X 3312(to)X 3451(the)X 3626(SGI-specific)X 0 f 576 5280(dwarf_get_vars\(\))N 1 f 1364(function,)X 1671(and)X 1807(are)X 1926(used)X 2093(as)X 2180(descriptors)X 2552(for)X 2666(queries)X 2918(about)X 3116(static)X 3305(variables.)X 0 f 576 5520(typedef)N 960(struct)X 1296(Dwarf_Error_s*)X 2016(Dwarf_Error;)X 1 f 576 5664(This)N 770(descriptor)X 1143(points)X 1390(to)X 1504(a)X 1592(structure)X 1925(that)X 2097(provides)X 2425(detailed)X 2731(information)X 3161(about)X 3391(errors)X 3631(detected)X 3952(by)X 0 f 576 5760(libdwarf)N 1 f (.)S 1033(Users)X 1249(typically)X 1561(provide)X 1838(a)X 1906(location)X 2196(for)X 0 f 2350(libdwarf)X 1 f 2766(to)X 2860(store)X 3048(this)X 3195(descriptor)X 3548(for)X 3674(the)X 3804(user)X 3970(to)X 576 5856(obtain)N 800(more)X 989(information)X 1391(about)X 1593(the)X 1715(error.)X 1936(The)X 2085(storage)X 2341(pointed)X 2605(to)X 2691(by)X 2796(this)X 2936(descriptor)X 3282(should)X 3520(be)X 3621(free'd,)X 3859(using)X 0 f 576 5952(dwarf_dealloc\(\))N 1 f 1316(with)X 1478(the)X 1596(allocation)X 1932(type)X 0 f 2118(DW_DLA_ERROR)X 1 f 2714(when)X 2908(no)X 3008(longer)X 3233(needed.)X 576 6183(rev)N 699(1.61,)X 879(3)X 939(Apr)X 1084(2006)X 2217(-)X 2264(10)X 2364(-)X 11 p %%Page: 11 11 0(Courier)xf 0 f 10 s 0 xH 0 xS 0 f 1 f 2217 384(-)N 2264(11)X 2364(-)X 0 f 576 768(typedef)N 960(struct)X 1296(Dwarf_Attribute_s*)X 2208(Dwarf_Attribute;)X 1 f 576 912(Instances)N 969(of)X 0 f 1158(Dwarf_Attribute)X 1 f 1972(type)X 2204(are)X 2397(returned)X 2759(from)X 3010(a)X 3141(successful)X 3566(call)X 3777(to)X 3934(the)X 0 f 576 1008(dwarf_attrlist\(\))N 1 f (,)S 1400(or)X 0 f 1531(dwarf_attr\(\))X 1 f 2143(functions,)X 2497(and)X 2649(are)X 2784(used)X 2967(as)X 3070(descriptors)X 3458(for)X 3587(queries)X 3854(about)X 576 1104(attribute)N 897(values.)X 1196(The)X 1375(storage)X 1661(pointed)X 1955(to)X 2071(by)X 2205(this)X 2375(descriptor)X 2751(should)X 3019(be)X 3150(individually)X 3591(free'd,)X 3859(using)X 0 f 576 1200(dwarf_dealloc\(\))N 1 f 1316(with)X 1478(the)X 1596(allocation)X 1932(type)X 0 f 2118(DW_DLA_ATTR)X 1 f 2666(when)X 2860(no)X 2960(longer)X 3185(needed.)X 0 f 576 1440(typedef)N 960(struct)X 1296(Dwarf_Abbrev_s*)X 2064(Dwarf_Abbrev;)X 1 f 576 1584(An)N 698(instance)X 985(of)X 1076(a)X 0 f 1164(Dwarf_Abbrev)X 1 f 1764(type)X 1926(is)X 2003(returned)X 2295(from)X 2476(a)X 2537(successful)X 2892(call)X 3033(to)X 0 f 3148(dwarf_get_abbrev\(\))X 1 f (,)S 576 1680(and)N 727(is)X 815(used)X 997(as)X 1099(a)X 1170(descriptor)X 1526(for)X 1655(queries)X 1922(about)X 2135(abbreviations)X 2602(in)X 2699(the)X 2831(.debug_abbrev)X 3340(section.)X 3641(The)X 3800(storage)X 576 1776(pointed)N 856(to)X 958(by)X 1078(this)X 1233(descriptor)X 1594(should)X 1847(be)X 1963(free'd,)X 2216(using)X 0 f 2457(dwarf_dealloc\(\))X 1 f 3217(with)X 3399(the)X 3537(allocation)X 3894(type)X 0 f 576 1872(DW_DLA_ABBREV)N 1 f 1220(when)X 1414(no)X 1514(longer)X 1739(needed.)X 0 f 576 2112(typedef)N 960(struct)X 1296(Dwarf_Fde_s*)X 1920(Dwarf_Fde;)X 1 f 576 2256(Instances)N 901(of)X 0 f 1022(Dwarf_Fde)X 1 f 1480(type)X 1644(are)X 1769(returned)X 2064(from)X 2247(a)X 2310(successful)X 2667(call)X 2810(to)X 2899(the)X 0 f 3052(dwarf_get_fde_list\(\))X 1 f (,)S 0 f 576 2352(dwarf_get_fde_for_die\(\))N 1 f (,)S 1769(or)X 0 f 1933(dwarf_get_fde_at_pc\(\))X 1 f 3010(functions,)X 3397(and)X 3582(are)X 3750(used)X 3965(as)X 576 2448(descriptors)N 948(for)X 1062(queries)X 1314(about)X 1512(frames)X 1751(descriptors.)X 0 f 576 2688(typedef)N 960(struct)X 1296(Dwarf_Cie_s*)X 1920(Dwarf_Cie;)X 1 f 576 2832(Instances)N 903(of)X 0 f 1026(Dwarf_Cie)X 1 f 1486(type)X 1652(are)X 1779(returned)X 2075(from)X 2259(a)X 2323(successful)X 2681(call)X 2826(to)X 2917(the)X 0 f 3072(dwarf_get_fde_list\(\))X 1 f 576 2928(function,)N 883(and)X 1019(are)X 1138(used)X 1305(as)X 1392(descriptors)X 1764(for)X 1878(queries)X 2130(about)X 2328(information)X 2726(that)X 2866(is)X 2939(common)X 3239(to)X 3321(several)X 3569(frames.)X 0 f 576 3168(typedef)N 960(struct)X 1296(Dwarf_Arange_s*)X 2064(Dwarf_Arange;)X 1 f 576 3312(Instances)N 895(of)X 0 f 1010(Dwarf_Arange)X 1 f 1606(type)X 1765(are)X 1885(returned)X 2174(from)X 2351(successful)X 2702(calls)X 2870(to)X 2953(the)X 0 f 3100(dwarf_get_aranges\(\))X 1 f (,)S 576 3408(or)N 0 f 693(dwarf_get_arange\(\))X 1 f 1579(functions,)X 1919(and)X 2057(are)X 2178(used)X 2346(as)X 2434(descriptors)X 2807(for)X 2922(queries)X 3175(about)X 3374(address)X 3636(ranges.)X 3907(The)X 576 3504(storage)N 835(pointed)X 1102(to)X 1191(by)X 1298(this)X 1440(descriptor)X 1788(should)X 2028(be)X 2132(individually)X 2546(free'd,)X 2787(using)X 0 f 3016(dwarf_dealloc\(\))X 1 f 3764(with)X 3934(the)X 576 3600(allocation)N 912(type)X 0 f 1098(DW_DLA_ARANGE)X 1 f 1742(when)X 1936(no)X 2036(longer)X 2261(needed.)X 3 f 11 s 576 3888(3.)N 686(Error)X 928(Handling)X 1 f 10 s 576 4032(The)N 743(method)X 1025(for)X 1161(detection)X 1497(and)X 1655(disposition)X 2047(of)X 2156(error)X 2355(conditions)X 2730(that)X 2892(arise)X 3086(during)X 3337(access)X 3585(of)X 3694(debugging)X 576 4128(information)N 980(via)X 2 f 1104(libdwarf)X 1 f 1400(is)X 1478(consistent)X 1823(across)X 2049(all)X 2 f 2154(libdwarf)X 1 f 2449(functions)X 2772(that)X 2917(are)X 3041(capable)X 3312(of)X 3404(producing)X 3754(an)X 3855(error.)X 576 4224(This)N 738(section)X 985(describes)X 1304(the)X 1422(method)X 1682(used)X 1849(by)X 2 f 1949(libdwarf)X 1 f 2239(in)X 2321(notifying)X 2634(client)X 2832(programs)X 3155(of)X 3242(error)X 3419(conditions.)X 576 4464(Most)N 766(functions)X 1090(within)X 2 f 1320(libdwarf)X 1 f 1616(accept)X 1848(as)X 1941(an)X 2043(argument)X 2372(a)X 2435(pointer)X 2689(to)X 2778(a)X 0 f 2869(Dwarf_Error)X 1 f 3424(descriptor)X 3772(where)X 3996(a)X 0 f 576 4560(Dwarf_Error)N 1 f 1128(descriptor)X 1473(is)X 1550(stored)X 1770(if)X 1843(an)X 1943(error)X 2124(is)X 2201(detected)X 2492(by)X 2595(the)X 2716(function.)X 3046(Routines)X 3353(in)X 3438(the)X 3559(client)X 3760(program)X 576 4656(that)N 722(provide)X 993(this)X 1134(argument)X 1463(can)X 1601(query)X 1810(the)X 0 f 1963(Dwarf_Error)X 1 f 2518(descriptor)X 2866(to)X 2955(determine)X 3303(the)X 3428(nature)X 3656(of)X 3750(the)X 3875(error)X 576 4752(and)N 712(perform)X 991(appropriate)X 1377(processing.)X 576 4992(A)N 654(client)X 852(program)X 1144(can)X 1276(also)X 1425(specify)X 1677(a)X 1733(function)X 2020(to)X 2103(be)X 2200(invoked)X 2479(upon)X 2660(detection)X 2975(of)X 3063(an)X 3160(error)X 3338(at)X 3417(the)X 3536(time)X 3699(the)X 3818(library)X 576 5088(is)N 650(initialized)X 991(\(see)X 0 f 1170(dwarf_init\(\))X 1 f (\).)S 1834(When)X 2047(a)X 2 f 2104(libdwarf)X 1 f 2395(routine)X 2643(detects)X 2887(an)X 2984(error,)X 3182(this)X 3318(function)X 3605(is)X 3678(called)X 3890(with)X 576 5184(two)N 716(arguments:)X 1092(a)X 1148(code)X 1320(indicating)X 1660(the)X 1778(nature)X 1999(of)X 2086(the)X 2204(error)X 2382(and)X 2519(a)X 2576(pointer)X 2824(provided)X 3130(by)X 3231(the)X 3350(client)X 3549(at)X 3628(initialization)X 576 5280(\(again)N 802(see)X 0 f 958(dwarf_init\(\))X 1 f (\).)S 1626(This)X 1793(pointer)X 2045(argument)X 2373(can)X 2510(be)X 2611(used)X 2783(to)X 2870(relay)X 3056(information)X 3459(between)X 3752(the)X 3875(error)X 576 5376(handler)N 845(and)X 989(other)X 1182(routines)X 1468(of)X 1563(the)X 1689(client)X 1895(program.)X 2235(A)X 2321(client)X 2527(program)X 2827(can)X 2967(specify)X 3227(or)X 3322(change)X 3578(both)X 3748(the)X 3875(error)X 576 5472(handling)N 900(function)X 1211(and)X 1370(the)X 1511(pointer)X 1781(argument)X 2127(after)X 2318(initialization)X 2765(using)X 0 f 3009(dwarf_seterrhand\(\))X 1 f 3916(and)X 0 f 576 5568(dwarf_seterrarg\(\))N 1 f (.)S 576 5808(In)N 670(the)X 796(case)X 963(where)X 2 f 1188(libdwarf)X 1 f 1486(functions)X 1812(are)X 1939(not)X 2069(provided)X 2382(a)X 2446(pointer)X 2701(to)X 2791(a)X 0 f 2883(Dwarf_Error)X 1 f 3439(descriptor,)X 3808(and)X 3952(no)X 576 5904(error)N 765(handling)X 1077(function)X 1376(was)X 1533(provided)X 1850(at)X 1940(initialization,)X 2 f 2396(libdwarf)X 1 f 2697(functions)X 3026(terminate)X 3360(execution)X 3703(by)X 3814(calling)X 576 6183(rev)N 699(1.61,)X 879(3)X 939(Apr)X 1084(2006)X 2217(-)X 2264(11)X 2364(-)X 12 p %%Page: 12 12 0(Courier)xf 0 f 10 s 0 xH 0 xS 0 f 1 f 2217 384(-)N 2264(12)X 2364(-)X 0 f 576 768(abort\(3C\))N 1 f (.)S 576 1008(The)N 721(following)X 1052(lists)X 1200(the)X 1318(processing)X 1681(steps)X 1861(taken)X 2055(upon)X 2235(detection)X 2549(of)X 2636(an)X 2732(error:)X 636 1152(1.)N 776(Check)X 1018(the)X 0 f 1181(error)X 1 f 1458(argument;)X 1820(if)X 1906(not)X 2046(a)X 2 f 2120(NULL)X 1 f 2357(pointer,)X 2642(allocate)X 2930(and)X 3084(initialize)X 3402(a)X 0 f 3504(Dwarf_Error)X 1 f 776 1248(descriptor)N 1135(with)X 1315(information)X 1731(describing)X 2103(the)X 2239(error,)X 2453(place)X 2660(this)X 2812(descriptor)X 3170(in)X 3269(the)X 3404(area)X 3576(pointed)X 3853(to)X 3952(by)X 0 f 776 1344(error)N 1 f (,)S 1056(and)X 1192(return)X 1404(a)X 1460(value)X 1654(indicating)X 1994(an)X 2090(error)X 2267(condition.)X 636 1488(2.)N 776(If)X 859(an)X 0 f 992(errhand)X 1 f 1357(argument)X 1689(was)X 1843(provided)X 2158(to)X 0 f 2278(dwarf_init\(\))X 1 f 2884(at)X 2972(initialization,)X 3426(call)X 0 f 3600(errhand\(\))X 1 f 776 1584(passing)N 1084(it)X 1196(the)X 1362(error)X 1587(descriptor)X 1976(and)X 2160(the)X 2325(value)X 2566(of)X 2700(the)X 0 f 2893(errarg)X 1 f 3248(argument)X 3618(provided)X 3970(to)X 0 f 776 1680(dwarf_init\(\))N 1 f (.)S 1412(If)X 1486(the)X 1604(error)X 1781(handling)X 2081(function)X 2368(returns,)X 2631(return)X 2843(a)X 2899(value)X 3093(indicating)X 3433(an)X 3529(error)X 3706(condition.)X 636 1824(3.)N 776(Terminate)X 1126(program)X 1418(execution)X 1750(by)X 1850(calling)X 0 f 2116(abort\(3C\))X 1 f (.)S 576 2112(In)N 674(all)X 785(cases,)X 1006(it)X 1081(is)X 1165(clear)X 1354(from)X 1542(the)X 1672(value)X 1878(returned)X 2178(from)X 2366(a)X 2434(function)X 2733(that)X 2885(an)X 2993(error)X 3182(occurred)X 3496(in)X 3590(executing)X 3934(the)X 576 2208(function,)N 883(since)X 1068(DW_DLV_ERROR)X 1733(is)X 1806(returned.)X 576 2352(As)N 689(can)X 825(be)X 925(seen)X 1092(from)X 1272(the)X 1394(above)X 1610(steps,)X 1814(the)X 1936(client)X 2138(program)X 2434(can)X 2570(provide)X 2839(an)X 2939(error)X 3120(handler)X 3385(at)X 3467(initialization,)X 3916(and)X 576 2448(still)N 725(provide)X 1000(an)X 0 f 1134(error)X 1 f 1404(argument)X 1737(to)X 2 f 1829(libdwarf)X 1 f 2129(functions)X 2456(when)X 2659(it)X 2732(is)X 2814(not)X 2945(desired)X 3206(to)X 3297(have)X 3478(the)X 3605(error)X 3791(handler)X 576 2544(invoked.)N 576 2784(If)N 665(a)X 0 f 764(libdwarf)X 1 f 1183(function)X 1485(is)X 1573(called)X 1800(with)X 1977(invalid)X 2234(arguments,)X 2624(the)X 2758(behaviour)X 3115(is)X 3204(undefined.)X 3601(In)X 3704(particular,)X 576 2880(supplying)N 920(a)X 0 f 1013(NULL)X 1 f 1234(pointer)X 1490(to)X 1581(a)X 0 f 1674(libdwarf)X 1 f 2087(function)X 2383(\(except)X 2649(where)X 2875(explicitly)X 3206(permitted\),)X 3589(or)X 3684(pointers)X 3970(to)X 576 2976(invalid)N 837(addresses)X 1184(or)X 1290(uninitialized)X 1729(data)X 1902(causes)X 2152(undefined)X 2513(behaviour;)X 2896(the)X 3034(return)X 3266(value)X 3480(in)X 3582(such)X 3769(cases)X 3979(is)X 576 3072(undefined,)N 943(and)X 1085(the)X 1209(function)X 1502(may)X 1666(fail)X 1799(to)X 1887(invoke)X 2131(the)X 2255(caller)X 2460(supplied)X 2757(error)X 2940(handler)X 3207(or)X 3300(to)X 3388(return)X 3606(a)X 3667(meaningful)X 576 3168(error)N 753(number.)X 1058(Implementations)X 1616(also)X 1765(may)X 1923(abort)X 2108(execution)X 2440(for)X 2554(such)X 2721(cases.)X 3 f 11 s 576 3408(3.1)N 730(Returned)X 1108(values)X 1365(in)X 1461(the)X 1600(functional)X 2004(interface)X 1 f 10 s 576 3552(Values)N 823(returned)X 1115(by)X 0 f 1247(libdwarf)X 1 f 1655(functions)X 1977(to)X 2063(indicate)X 2341(success)X 2606(and)X 2746(errors)X 2958(are)X 3081(enumerated)X 3481(in)X 3568(Figure)X 3802(2.)X 3907(The)X 0 f 576 3648(DW_DLV_NO_ENTRY)N 1 f 1324(case)X 1491(is)X 1572(useful)X 1796(for)X 1917(functions)X 2242(need)X 2421(to)X 2510(indicate)X 2791(that)X 2938(while)X 3143(there)X 3331(was)X 3483(no)X 3590(data)X 3751(to)X 3840(return)X 576 3744(there)N 766(was)X 920(no)X 1029(error)X 1215(either.)X 1467(For)X 1607(example,)X 0 f 1956(dwarf_siblingof\(\))X 1 f 2802(may)X 2970(return)X 0 f 3220(DW_DLV_NO_ENTRY)X 1 f 3970(to)X 576 3840(indicate)N 850(that)X 990(that)X 1130(there)X 1311(was)X 1456(no)X 1556(sibling)X 1793(to)X 1875(return.)X 0 f 10 f 1188 3904(i)N 1220(iiiiiiiiiiiiiiiiiiiiiiiiiiiiiiiiiiiiiiiiiiiiiiiiiiiiiii)X 3 f 1228 4000(SYMBOLIC)N 1683(NAME)X 2068(VALUE)X 2468(MEANING)X 10 f 1188 4016(i)N 1220(iiiiiiiiiiiiiiiiiiiiiiiiiiiiiiiiiiiiiiiiiiiiiiiiiiiiiii)X 3 f 1228 4112(DW_DLV_ERROR)N 2188(1)X 2468(Error)X 1228 4208(DW_DLV_OK)N 2188(0)X 2468(Successful)X 2839(call)X 1228 4304(DW_DLV_NO_ENTRY)N 2174(-1)X 2468(No)X 2586(applicable)X 2956(value)X 10 f 1188 4320(i)N 1220(iiiiiiiiiiiiiiiiiiiiiiiiiiiiiiiiiiiiiiiiiiiiiiiiiiiiiii)X 1188(c)X 4304(c)Y 4224(c)Y 4144(c)Y 4064(c)Y 3984(c)Y 3420 4320(c)N 4304(c)Y 4224(c)Y 4144(c)Y 4064(c)Y 3984(c)Y 3 f 1829 4416(Figure)N 2076(2.)X 2176(Error)X 2397(Indications)X 1 f 576 4560(Each)N 757(function)X 1044(in)X 1126(the)X 1244(interface)X 1546(that)X 1686(returns)X 1929(a)X 1985(value)X 2179(returns)X 2422(one)X 2558(of)X 2645(the)X 2763(integers)X 3037(in)X 3119(the)X 3237(above)X 3449(figure.)X 576 4704(If)N 0 f 680(DW_DLV_ERROR)X 1 f 1278(is)X 1353(returned)X 1644(and)X 1783(a)X 1842(pointer)X 2092(to)X 2177(a)X 0 f 2264(Dwarf_Error)X 1 f 2815(pointer)X 3065(is)X 3141(passed)X 3378(to)X 3463(the)X 3584(function,)X 3894(then)X 576 4800(a)N 638(Dwarf_Error)X 1080(handle)X 1320(is)X 1399(returned)X 1693(thru)X 1848(the)X 1972(pointer.)X 2245(No)X 2369(other)X 2560(pointer)X 2813(value)X 3012(in)X 3099(the)X 3222(interface)X 3529(returns)X 3777(a)X 3838(value.)X 576 4896(After)N 987(the)X 0 f 1355(Dwarf_Error)X 1 f 2125(is)X 2420(no)X 2742(longer)X 3189(of)X 3498(interest,)X 3996(a)X 0 f 576 4992(dwarf_dealloc\(dbg,dw_err,DW_DLA_ERROR\))N 1 f 2439(on)X 2558(the)X 2695(error)X 2891(pointer)X 3157(is)X 3248(appropriate)X 3652(to)X 3752(free)X 3916(any)X 576 5088(space)N 775(used)X 942(by)X 1042(the)X 1160(error)X 1337(information.)X 576 5232(If)N 0 f 678(DW_DLV_NO_ENTRY)X 1 f 1418(is)X 1491(returned)X 1779(no)X 1879(pointer)X 2126(value)X 2320(in)X 2402(the)X 2520(interface)X 2822(returns)X 3065(a)X 3121(value.)X 576 5376(If)N 0 f 680(DW_DLV_OK)X 1 f 1134(is)X 1210(returned)X 1521(the)X 0 f 1670(Dwarf_Error)X 1 f 2221(pointer,)X 2491(if)X 2563(supplied,)X 2877(is)X 2953(not)X 3078(touched,)X 3375(but)X 3500(any)X 3639(other)X 3827(values)X 576 5472(to)N 663(be)X 764(returned)X 1057(through)X 1331(pointers)X 1614(are)X 1738(returned.)X 2071(In)X 2163(this)X 2303(case)X 2467(calls)X 2639(\(depending)X 3025(on)X 3130(the)X 3253(exact)X 3447(function)X 3738(returning)X 576 5568(the)N 695(error\))X 900(to)X 0 f 1011(dwarf_dealloc\(\))X 1 f 1752(may)X 1912(be)X 2010(appropriate)X 2398(once)X 2572(the)X 2692(particular)X 3022(pointer)X 3271(returned)X 3561(is)X 3636(no)X 3738(longer)X 3965(of)X 576 5664(interest.)N 576 5808(Pointers)N 863(passed)X 1103(to)X 1191(allow)X 1395(values)X 1626(to)X 1714(be)X 1816(returned)X 2110(thru)X 2265(them)X 2451(are)X 2576(uniformly)X 2922(the)X 3046(last)X 3183(pointers)X 3467(in)X 3555(each)X 3729(argument)X 576 5904(list.)N 576 6183(rev)N 699(1.61,)X 879(3)X 939(Apr)X 1084(2006)X 2217(-)X 2264(12)X 2364(-)X 13 p %%Page: 13 13 0(Courier)xf 0 f 10 s 0 xH 0 xS 0 f 1 f 2217 384(-)N 2264(13)X 2364(-)X 576 768(All)N 703(the)X 826(interface)X 1133(functions)X 1456(are)X 1580(defined)X 1846(from)X 2027(the)X 2150(point)X 2339(of)X 2431(view)X 2612(of)X 2704(the)X 2827 0.1750(writer-of-the-library)AX 3504(\(as)X 3624(is)X 3703(traditional)X 576 864(for)N 696(UN*X)X 936(library)X 1176(documentation\),)X 1725(not)X 1853(from)X 2035(the)X 2159(point)X 2349(of)X 2442(view)X 2624(of)X 2716(the)X 2839(user)X 2998(of)X 3090(the)X 3213(library.)X 3492(The)X 3642(caller)X 3846(might)X 576 960(code:)N 3 f 576 1104(Dwarf_Line)N 1010(line;)X 576 1200(Dwarf_Signed)N 1085(ret_loff;)X 576 1296(Dwarf_Error)N 1076(err;)X 576 1392(int)N 689(retval)X 910(=)X 976 0.1654(dwarf_lineoff\(line,&ret_loff,&err\);)AX 1 f 576 1536(for)N 690(the)X 808(function)X 1095(defined)X 1356(as)X 3 f 576 1680(int)N 689(dwarf_lineoff\(Dwarf_Line)X 1613(line,Dwarf_Signed)X 2266(*return_lineoff,)X 616 1776(Dwarf_Error*)N 1136(err\);)X 1 f 576 1920(and)N 724(this)X 871(document)X 1219(refers)X 1435(to)X 1529(the)X 1659(function)X 1958(as)X 2057(returning)X 2383(the)X 2513(value)X 2719(thru)X 2881(*err)X 3044(or)X 3144(*return_lineoff)X 3663(or)X 3763(uses)X 3934(the)X 576 2016(phrase)N 806("returns)X 1082(in)X 1164(the)X 1282(location)X 1560(pointed)X 1820(to)X 1902(by)X 2002(err".)X 2185(Sometimes)X 2560(other)X 2745(similar)X 2987(phrases)X 3248(are)X 3367(used.)X 3 f 11 s 576 2304(4.)N 686(Memory)X 1030(Management)X 1 f 10 s 576 2448(Several)N 840(of)X 930(the)X 1052(functions)X 1374(that)X 1518(comprise)X 2 f 1836(libdwarf)X 1 f 2130(return)X 2346(pointers)X 2628(\(opaque)X 2911(descriptors\))X 3314(to)X 3400(structures)X 3736(that)X 3880(have)X 576 2544(been)N 757(dynamically)X 1182(allocated)X 1501(by)X 1610(the)X 1737(library.)X 2020(To)X 2138(aid)X 2265(in)X 2356(the)X 2483(management)X 2922(of)X 3018(dynamic)X 3323(memory,)X 3639(the)X 3765(function)X 0 f 576 2640(dwarf_dealloc\(\))N 1 f 1317(is)X 1391(provided)X 1697(to)X 1781(free)X 1929(storage)X 2183(allocated)X 2495(as)X 2584(a)X 2642(result)X 2842(of)X 2931(a)X 2989(call)X 3127(to)X 3211(a)X 2 f 3269(libdwarf)X 1 f 3561(function.)X 3890(This)X 576 2736(section)N 823(describes)X 1142(the)X 1260(strategy)X 1534(that)X 1674(should)X 1907(be)X 2003(taken)X 2197(by)X 2297(a)X 2353(client)X 2551(program)X 2843(in)X 2925(managing)X 3261(dynamic)X 3557(storage.)X 3 f 11 s 576 2976(4.1)N 730(Read-only)X 1138(Properties)X 1 f 10 s 576 3120(All)N 702(pointers)X 984(\(opaque)X 1267(descriptors\))X 1670(returned)X 1962(by)X 2066(or)X 2157(as)X 2248(a)X 2308(result)X 2510(of)X 2601(a)X 2 f 2661(libdwarf)X 2955(Consumer)X 3308(Library)X 1 f 3577(call)X 3718(should)X 3956(be)X 576 3216(assumed)N 874(to)X 958(point)X 1144(to)X 1228(read-only)X 1558(memory.)X 1887(The)X 2034(results)X 2264(are)X 2384(undefined)X 2726(for)X 2 f 2841(libdwarf)X 1 f 3152(clients)X 3382(that)X 3523(attempt)X 3784(to)X 3867(write)X 576 3312(to)N 658(a)X 714(region)X 939(pointed)X 1199(to)X 1281(by)X 1381(a)X 1437(value)X 1631(returned)X 1919(by)X 2019(a)X 2 f 2075(libdwarf)X 2365(Consumer)X 2714(Library)X 1 f 2978(call.)X 3 f 11 s 576 3552(4.2)N 730(Storage)X 1040(Deallocation)X 1 f 10 s 576 3696(See)N 720(the)X 846(section)X 1101("Returned)X 1456(values)X 1690(in)X 1781(the)X 1908(functional)X 2262(interface",)X 2626(above,)X 2867(for)X 2990(the)X 3117(general)X 3383(rules)X 3568(where)X 3794(calls)X 3970(to)X 0 f 576 3792(dwarf_dealloc\(\))N 1 f 1316(is)X 1389(appropriate.)X 576 3936(In)N 674(some)X 874(cases)X 1075(the)X 1204(pointers)X 1493(returned)X 1792(by)X 1903(a)X 2 f 1970(libdwarf)X 1 f 2272(call)X 2420(are)X 2551(pointers)X 2841(to)X 2935(data)X 3101(which)X 3329(is)X 3414(not)X 3548(free-able.)X 3907(The)X 576 4032(library)N 814(knows)X 1047(from)X 1227(the)X 1349(allocation)X 1689(type)X 1851(provided)X 2160(to)X 2246(it)X 2314(whether)X 2597(the)X 2719(space)X 2921(is)X 2997(freeable)X 3280(or)X 3370(not)X 3495(and)X 3634(will)X 3781(not)X 3906(free)X 576 4128(inappropriately)N 1091(when)X 0 f 1318(dwarf_dealloc\(\))X 1 f 2063(is)X 2141(called.)X 2398(So)X 2507(it)X 2576(is)X 2654(vital)X 2821(that)X 0 f 2994(dwarf_dealloc\(\))X 1 f 3739(be)X 3840(called)X 576 4224(with)N 738(the)X 856(proper)X 1086(allocation)X 1422(type.)X 576 4368(For)N 746(most)X 960(storage)X 1251(allocated)X 1600(by)X 2 f 1739(libdwarf)X 1 f 2009(,)X 2088(the)X 2245(client)X 2482(can)X 2654(free)X 2840(the)X 2998(storage)X 3290(for)X 3444(reuse)X 3674(by)X 3814(calling)X 0 f 576 4464(dwarf_dealloc\(\))N 1 f (,)S 1346(providing)X 1687(it)X 1761(with)X 1933(the)X 0 f 2089(Dwarf_Debug)X 1 f 2647(descriptor)X 2998(specifying)X 3361(the)X 3488(object)X 3713(for)X 3836(which)X 576 4560(the)N 707(storage)X 972(was)X 1130(allocated,)X 1473(a)X 1542(pointer)X 1802(to)X 1897(the)X 2029(area)X 2198(to)X 2294(be)X 2404(free-ed,)X 2687(and)X 2837(an)X 2947(identifier)X 3275(that)X 3429(specifies)X 3744(what)X 3934(the)X 576 4656(pointer)N 826(points)X 1044(to)X 1129(\(the)X 1276(allocation)X 1614(type\).)X 1841(For)X 1974(example,)X 2288(to)X 2372(free)X 2520(a)X 0 f 2606(Dwarf_Die)X 3088(die)X 1 f 3254(belonging)X 3596(the)X 3716(the)X 3836(object)X 576 4752(represented)N 991(by)X 0 f 1143(Dwarf_Debug)X 1743(dbg)X 1 f (,)S 1951(allocated)X 2285(by)X 2409(a)X 2489(call)X 2650(to)X 0 f 2785(dwarf_siblingof\(\))X 1 f (,)S 3666(the)X 3809(call)X 3970(to)X 0 f 576 4848(dwarf_dealloc\(\))N 1 f 1316(would)X 1536(be:)X 0 f 656 4992(dwarf_dealloc\(dbg,)N 1568(die,)X 1808(DW_DLA_DIE\);)X 1 f 576 5232(To)N 695(free)X 851(storage)X 1113(allocated)X 1433(in)X 1525(the)X 1653(form)X 1839(of)X 1936(a)X 2002(list)X 2129(of)X 2226(pointers)X 2515(\(opaque)X 2805(descriptors\),)X 3235(each)X 3414(member)X 3708(of)X 3806(the)X 3935(list)X 576 5328(should)N 813(be)X 913(deallocated,)X 1323(followed)X 1632(by)X 1736(deallocation)X 2152(of)X 2243(the)X 2365(actual)X 2581(list)X 2701(itself.)X 2924(The)X 3072(following)X 3406(code)X 3581(fragment)X 3894(uses)X 576 5424(an)N 678(invocation)X 1043(of)X 0 f 1165(dwarf_attrlist\(\))X 1 f 1960(as)X 2054(an)X 2157(example)X 2456(to)X 2545(illustrate)X 2852(a)X 2915(technique)X 3254(that)X 3401(can)X 3540(be)X 3643(used)X 3817(to)X 3906(free)X 576 5520(storage)N 828(from)X 1004(any)X 2 f 1140(libdwarf)X 1 f 1430(routine)X 1677(that)X 1817(returns)X 2060(a)X 2116(list:)X 576 6183(rev)N 699(1.61,)X 879(3)X 939(Apr)X 1084(2006)X 2217(-)X 2264(13)X 2364(-)X 14 p %%Page: 14 14 0(Courier)xf 0 f 10 s 0 xH 0 xS 0 f 1 f 2217 384(-)N 2264(14)X 2364(-)X 0 f 576 768(Dwarf_Unsigned)N 1296(atcnt;)X 576 864(Dwarf_Attribute)N 1344(*atlist;)X 576 960(int)N 768(errv;)X 576 1152(errv)N 816(=)X 912(dwarf_attrlist\(somedie,)X 2064(&atlist,&atcnt,)X 2832(&error\);)X 576 1248(if)N 720(\(errv)X 1008(==)X 1152(DW_DLV_OK\))X 1680({)X 960 1440(for)N 1152(\(i)X 1296(=)X 1392(0;)X 1536(i)X 1632(<)X 1728(atcnt;)X 2064(++i\))X 2304({)X 1344 1536(/*)N 1488(use)X 1680(atlist[i])X 2160(*/)X 1344 1632(dwarf_dealloc\(dbg,)N 2256(atlist[i],)X 2784(DW_DLA_ATTR\);)X 960 1728(})N 960 1824(dwarf_dealloc\(dbg,)N 1872(atlist,)X 2256(DW_DLA_LIST\);)X 576 1920(})N 1 f 576 2160(The)N 0 f 751(Dwarf_Debug)X 1 f 1301(returned)X 1592(from)X 0 f 1799(dwarf_init\(\))X 1 f 2398(or)X 0 f 2516(dwarf_elf_init\(\))X 1 f 3307(cannot)X 3544(be)X 3643(free'd)X 3859(using)X 0 f 576 2256(dwarf_dealloc\(\))N 1 f (.)S 1363(The)X 1515(function)X 0 f 1836(dwarf_finish\(\))X 1 f 2534(will)X 2684(deallocate)X 3036(all)X 3142(dynamic)X 3444(storage)X 3702(associated)X 576 2352(with)N 738(an)X 834(instance)X 1117(of)X 1204(a)X 0 f 1288(Dwarf_Debug)X 1 f 1836(type.)X 2034(In)X 2121(particular,)X 2469(it)X 2533(will)X 2677(deallocate)X 3024(all)X 3125(dynamically)X 3542(allocated)X 3853(space)X 576 2448(associated)N 926(with)X 1088(the)X 0 f 1234(Dwarf_Debug)X 1 f 1782(descriptor,)X 2143(and)X 2279(finally)X 2508(make)X 2702(the)X 2820(descriptor)X 3161(invalid.)X 576 2640(An)N 0 f 738(Dwarf_Error)X 1 f 1302(returned)X 1606(from)X 0 f 1826(dwarf_init\(\))X 1 f 2438(or)X 0 f 2569(dwarf_elf_init\(\))X 1 f 3373(in)X 3471(case)X 3646(of)X 3749(a)X 3822(failure)X 576 2736(cannot)N 816(be)X 918(free'd)X 1137(using)X 0 f 1364(dwarf_dealloc\(\))X 1 f (.)S 2150(The)X 2301(only)X 2469(way)X 2629(to)X 2717(free)X 2869(the)X 0 f 3021(Dwarf_Error)X 1 f 3575(from)X 3757(either)X 3965(of)X 576 2832(those)N 776(calls)X 954(is)X 1039(to)X 1133(use)X 2 f 1272(free\(3\))X 1 f 1523(directly.)X 1840(Every)X 0 f 2092(Dwarf_Error)X 1 f 2652(must)X 2839(be)X 2947(free'd)X 3172(by)X 0 f 3312(dwarf_dealloc\(\))X 1 f 576 2928(except)N 806(those)X 995(returned)X 1283(by)X 0 f 1411(dwarf_init\(\))X 1 f 2007(or)X 0 f 2122(dwarf_elf_init\(\))X 1 f (.)S 576 3168(The)N 721(codes)X 924(that)X 1064(identify)X 1333(the)X 1451(storage)X 1703(pointed)X 1963(to)X 2045(in)X 2127(calls)X 2294(to)X 0 f 2404(dwarf_dealloc\(\))X 1 f 3144(are)X 3263(described)X 3591(in)X 3673(figure)X 3885(3.)X 576 6183(rev)N 699(1.61,)X 879(3)X 939(Apr)X 1084(2006)X 2217(-)X 2264(14)X 2364(-)X 15 p %%Page: 15 15 0(Courier)xf 0 f 10 s 0 xH 0 xS 0 f 1 f 2217 384(-)N 2264(15)X 2364(-)X 3 f 10 f 973 688(i)N 995(iiiiiiiiiiiiiiiiiiiiiiiiiiiiiiiiiiiiiiiiiiiiiiiiiiiiiiiiiiiiiiiiii)X 3 f 1013 784(IDENTIFIER)N 2433(USED)X 2666(TO)X 2801(FREE)X 10 f 973 800(i)N 995(iiiiiiiiiiiiiiiiiiiiiiiiiiiiiiiiiiiiiiiiiiiiiiiiiiiiiiiiiiiiiiiiii)X 3 f 1013 896(DW_DLA_STRING)N 2533(char*)X 1013 992(DW_DLA_LOC)N 2533(Dwarf_Loc)X 1013 1088(DW_DLA_LOCDESC)N 2533(Dwarf_Locdesc)X 1013 1184(DW_DLA_ELLIST)N 2533(Dwarf_Ellist)X 2989(\(not)X 3147(used\))X 1013 1280(DW_DLA_BOUNDS)N 2533(Dwarf_Bounds)X 3068(\(not)X 3226(used\))X 1013 1376(DW_DLA_BLOCK)N 2533(Dwarf_Block)X 1013 1472(DW_DLA_DEBUG)N 2533(Dwarf_Debug)X 3034(\(do)X 3165(not)X 3296(use\))X 1013 1568(DW_DLA_DIE)N 2533(Dwarf_Die)X 1013 1664(DW_DLA_LINE)N 2533(Dwarf_Line)X 1013 1760(DW_DLA_ATTR)N 2533(Dwarf_Attribute)X 1013 1856(DW_DLA_TYPE)N 2533(Dwarf_Type)X 3005(\(not)X 3163(used\))X 1013 1952(DW_DLA_SUBSCR)N 2533(Dwarf_Subscr)X 3047(\(not)X 3205(used\))X 1013 2048(DW_DLA_GLOBAL_CONTEXT)N 2533(Dwarf_Global)X 1013 2144(DW_DLA_ERROR)N 2533(Dwarf_Error)X 1013 2240(DW_DLA_LIST)N 2533(a)X 2593(list)X 2715(of)X 2802(opaque)X 3070(descriptors)X 1013 2336(DW_DLA_LINEBUF)N 2533(Dwarf_Line*)X 3007(\(not)X 3165(used\))X 1013 2432(DW_DLA_ARANGE)N 2533(Dwarf_Arange)X 1013 2528(DW_DLA_ABBREV)N 2533(Dwarf_Abbrev)X 1013 2624(DW_DLA_FRAME_OP)N 2533(Dwarf_Frame_Op)X 1013 2720(DW_DLA_CIE)N 2533(Dwarf_Cie)X 1013 2816(DW_DLA_FDE)N 2533(Dwarf_Fde)X 1013 2912(DW_DLA_LOC_BLOCK)N 2533(Dwarf_Loc)X 2941(Block)X 1013 3008(DW_DLA_FRAME_BLOCK)N 2533(Dwarf_Frame)X 3040(Block)X 3255(\(not)X 3413(used\))X 1013 3104(DW_DLA_FUNC_CONTEXT)N 2533(Dwarf_Func)X 1013 3200(DW_DLA_TYPENAME_CONTEXT)N 2533(Dwarf_Type)X 1013 3296(DW_DLA_VAR_CONTEXT)N 2533(Dwarf_Var)X 1013 3392(DW_DLA_WEAK_CONTEXT)N 2533(Dwarf_Weak)X 1013 3488(DW_DLA_PUBTYPES_CONTEXT)N 2533(Dwarf_Pubtype)X 10 f 973 3504(i)N 995(iiiiiiiiiiiiiiiiiiiiiiiiiiiiiiiiiiiiiiiiiiiiiiiiiiiiiiiiiiiiiiiiii)X 973(c)X 3488(c)Y 3408(c)Y 3328(c)Y 3248(c)Y 3168(c)Y 3088(c)Y 3008(c)Y 2928(c)Y 2848(c)Y 2768(c)Y 2688(c)Y 2608(c)Y 2528(c)Y 2448(c)Y 2368(c)Y 2288(c)Y 2208(c)Y 2128(c)Y 2048(c)Y 1968(c)Y 1888(c)Y 1808(c)Y 1728(c)Y 1648(c)Y 1568(c)Y 1488(c)Y 1408(c)Y 1328(c)Y 1248(c)Y 1168(c)Y 1088(c)Y 1008(c)Y 928(c)Y 848(c)Y 768(c)Y 3635 3504(c)N 3488(c)Y 3408(c)Y 3328(c)Y 3248(c)Y 3168(c)Y 3088(c)Y 3008(c)Y 2928(c)Y 2848(c)Y 2768(c)Y 2688(c)Y 2608(c)Y 2528(c)Y 2448(c)Y 2368(c)Y 2288(c)Y 2208(c)Y 2128(c)Y 2048(c)Y 1968(c)Y 1888(c)Y 1808(c)Y 1728(c)Y 1648(c)Y 1568(c)Y 1488(c)Y 1408(c)Y 1328(c)Y 1248(c)Y 1168(c)Y 1088(c)Y 1008(c)Y 928(c)Y 848(c)Y 768(c)Y 3 f 1542 3600(Figure)N 1789(3.)X 1889(Allocation/Deallocation)X 2709(Identifiers)X 11 s 576 3936(5.)N 686(Functional)X 1115(Interface)X 1 f 10 s 576 4080(This)N 738(section)X 985(describes)X 1305(the)X 1424(functions)X 1743(available)X 2054(in)X 2137(the)X 2 f 2256(libdwarf)X 1 f 2547(library.)X 2822(Each)X 3004(function)X 3292(description)X 3669(includes)X 3957(its)X 576 4176(definition,)N 927(followed)X 1232(by)X 1332(one)X 1468(or)X 1555(more)X 1740(paragraph)X 2082(describing)X 2436(the)X 2554(function's)X 2899(operation.)X 576 4416(The)N 721(following)X 1052(sections)X 1330(describe)X 1618(these)X 1803(functions.)X 3 f 11 s 576 4656(5.1)N 730(Initialization)X 1238(Operations)X 1 f 10 s 576 4800(These)N 802(functions)X 1134(are)X 1267(concerned)X 1632(with)X 1808(preparing)X 2150(an)X 2260(object)X 2490(file)X 2631(for)X 2759(subsequent)X 3149(access)X 3389(by)X 3504(the)X 3637(functions)X 3970(in)X 2 f 576 4896(libdwarf)N 1 f 866(and)X 1002(with)X 1164(releasing)X 1474(allocated)X 1784(resources)X 2108(when)X 2302(access)X 2528(is)X 2601(complete.)X 3 f 576 5136(5.1.1)N 776(dwarf_init\(\))X 1 f 576 6183(rev)N 699(1.61,)X 879(3)X 939(Apr)X 1084(2006)X 2217(-)X 2264(15)X 2364(-)X 16 p %%Page: 16 16 0(Courier)xf 0 f 10 s 0 xH 0 xS 0 f 1 f 2217 384(-)N 2264(16)X 2364(-)X 0 f 576 768(int)N 768(dwarf_init\()X 960 864(int)N 1152(fd,)X 960 960(Dwarf_Unsigned)N 1680(access,)X 960 1056(Dwarf_Handler)N 1632(errhand,)X 960 1152(Dwarf_Ptr)N 1440(errarg,)X 960 1248(Dwarf_Debug)N 1536(*)X 1632(dbg,)X 960 1344(Dwarf_Error)N 1536(*error\))X 1 f 576 1488(When)N 805(it)X 886(returns)X 0 f 1174(DW_DLV_OK)X 1 f (,)S 1663(the)X 1798(function)X 0 f 2130(dwarf_init\(\))X 1 f 2744(returns)X 3025(thru)X 0 f 3220(dbg)X 1 f 3402(a)X 0 f 3504(Dwarf_Debug)X 1 f 576 1584(descriptor)N 919(that)X 1061(represents)X 1409(a)X 1467(handle)X 1703(for)X 1819(accessing)X 2149(debugging)X 2509(records)X 2768(associated)X 3120(with)X 3284(the)X 3404(open)X 3582(file)X 3711(descriptor)X 0 f 576 1680(fd)N 1 f (.)S 0 f 798(DW_DLV_NO_ENTRY)X 1 f 1548(is)X 1632(returned)X 1931(if)X 2011(the)X 2140(object)X 2367(does)X 2545(not)X 2678(contain)X 2945(DWARF)X 3265(debugging)X 3634(information.)X 0 f 576 1776(DW_DLV_ERROR)N 1 f 1192(is)X 1285(returned)X 1593(if)X 1682(an)X 1797(error)X 1993(occurred.)X 2354(The)X 0 f 2546(access)X 1 f 2873(argument)X 3215(indicates)X 3539(what)X 3734(access)X 3979(is)X 576 1872(allowed)N 864(for)X 992(the)X 1124(section.)X 1425(The)X 0 f 1613(DW_DLC_READ)X 1 f 2176(parameter)X 2533(is)X 2621(valid)X 2816(for)X 2945(read)X 3119(access)X 3360(\(only)X 3564(read)X 3738(access)X 3979(is)X 576 1968(defined)N 846(or)X 942(discussed)X 1278(in)X 1369(this)X 1513(document\).)X 1925(The)X 0 f 2107(errhand)X 1 f 2472(argument)X 2804(is)X 2886(a)X 2951(pointer)X 3207(to)X 3297(a)X 3361(function)X 3656(that)X 3804(will)X 3956(be)X 576 2064(invoked)N 867(whenever)X 1213(an)X 1322(error)X 1512(is)X 1598(detected)X 1899(as)X 1999(a)X 2069(result)X 2281(of)X 2382(a)X 2 f 2452(libdwarf)X 1 f 2756(operation.)X 3133(The)X 0 f 3320(errarg)X 1 f 3642(argument)X 3979(is)X 576 2160(passed)N 818(as)X 913(an)X 1017(argument)X 1348(to)X 1438(the)X 0 f 1592(errhand)X 1 f 1956(function.)X 2291(The)X 2444(file)X 2579(descriptor)X 2927(associated)X 3284(with)X 3453(the)X 0 f 3606(fd)X 1 f 3729(argument)X 576 2256(must)N 751(refer)X 924(to)X 1006(an)X 1102(ordinary)X 1394(file)X 1521(\(i.e.)X 1666(not)X 1788(a)X 1844(pipe,)X 2022(socket,)X 2267(device,)X 2517(/proc)X 2702(entry,)X 2907(etc.\),)X 3088(be)X 3184(opened)X 3436(with)X 3599(the)X 3718(at)X 3797(least)X 3965(as)X 576 2352(much)N 779(permission)X 1155(as)X 1247(specified)X 1562(by)X 1667(the)X 0 f 1818(access)X 1 f 2131(argument,)X 2479(and)X 2620(cannot)X 2859(be)X 2960(closed)X 3190(or)X 3281(used)X 3452(as)X 3543(an)X 3643(argument)X 3970(to)X 576 2448(any)N 725(system)X 980(calls)X 1160(by)X 1273(the)X 1404(client)X 1616(until)X 1796(after)X 0 f 2006(dwarf_finish\(\))X 1 f 2712(is)X 2799(called.)X 3065(The)X 3224(seek)X 3401(position)X 3692(of)X 3793(the)X 3925(file)X 576 2544(associated)N 926(with)X 0 f 1116(fd)X 1 f 1232(is)X 1305(undefined)X 1646(upon)X 1826(return)X 2038(of)X 0 f 2153(dwarf_init\(\))X 1 f (.)S 576 2736(With)N 785(SGI)X 963(IRIX,)X 1197(by)X 1326(default)X 1598(it)X 1691(is)X 1793(allowed)X 2096(that)X 2265(the)X 2412(app)X 0 f 2606(close\(\))X 3020(fd)X 1 f 3166(immediately)X 3616(after)X 3814(calling)X 0 f 576 2832(dwarf_init\(\))N 1 f (,)S 1196(but)X 1322(that)X 1466(is)X 1543(not)X 1689(a)X 1749(portable)X 2036(approach)X 2355(\(that)X 2526(it)X 2594(works)X 2814(is)X 2891(an)X 2991(accidental)X 3341(side)X 3493(effect)X 3700(of)X 3790(the)X 3911(fact)X 576 2928(that)N 724(SGI)X 881(IRIX)X 1074(uses)X 0 f 1268(ELF_C_READ_MMAP)X 1 f 2016(in)X 2106(its)X 2209(hidden)X 2455(internal)X 2728(call)X 2872(to)X 0 f 2991(elf_begin\(\))X 1 f (\).)S 3615(The)X 3769(portable)X 576 3024(approach)N 906(is)X 994(to)X 1091(consider)X 1398(that)X 0 f 1581(fd)X 1 f 1712(must)X 1902(be)X 2013(left)X 2155(open)X 2346(till)X 2469(after)X 2652(the)X 2784(corresponding)X 3277(dwarf_finish\(\))X 3775(call)X 3925(has)X 576 3120(returned.)N 576 3312(Since)N 0 f 811(dwarf_init\(\))X 1 f 1416(uses)X 1583(the)X 1710(same)X 1904(error)X 2090(handling)X 2399(processing)X 2771(as)X 2867(other)X 2 f 3062(libdwarf)X 1 f 3362(functions)X 3690(\(see)X 2 f 3850(Error)X 576 3408(Handling)N 1 f 900(above\),)X 1161(client)X 1361(programs)X 1686(will)X 1832(generally)X 2153(supply)X 2388(an)X 0 f 2514(error)X 1 f 2776(parameter)X 3120(to)X 3203(bypass)X 3442(the)X 3561(default)X 3805(actions)X 576 3504(during)N 805(initialization)X 1229(unless)X 1449(the)X 1567(default)X 1810(actions)X 2057(are)X 2176(appropriate.)X 3 f 576 3744(5.1.2)N 776(dwarf_elf_init\(\))X 0 f 576 3888(int)N 768(dwarf_elf_init\()X 960 3984(Elf)N 1152(*)X 1248(elf_file_pointer,)X 960 4080(Dwarf_Unsigned)N 1680(access,)X 960 4176(Dwarf_Handler)N 1632(errhand,)X 960 4272(Dwarf_Ptr)N 1440(errarg,)X 960 4368(Dwarf_Debug)N 1536(*)X 1632(dbg,)X 960 4464(Dwarf_Error)N 1536(*error\))X 1 f 576 4608(The)N 739(function)X 0 f 1072(dwarf_elf_init\(\))X 1 f 1878(is)X 1969(identical)X 2283(to)X 0 f 2412(dwarf_init\(\))X 1 f 3027(except)X 3276(that)X 3435(an)X 3550(open)X 0 f 3773(Elf)X 3984(*)X 1 f 576 4704(pointer)N 833(is)X 916(passed)X 1160(instead)X 1417(of)X 1514(a)X 1580(file)X 1717(descriptor.)X 2108(In)X 2205(systems)X 2487(supporting)X 0 f 2886(ELF)X 1 f 3059(object)X 3284(files)X 3451(this)X 3595(may)X 3762(be)X 3867(more)X 576 4800(space)N 778(or)X 868(time-efficient)X 1328(than)X 1489(using)X 0 f 1713(dwarf_init\(\))X 1 f (.)S 2352(The)X 2500(client)X 2701(is)X 2777(allowed)X 3054(to)X 3139(use)X 3269(the)X 0 f 3419(Elf)X 3615(*)X 1 f 3687(pointer)X 3938(for)X 576 4896(its)N 682(own)X 850(purposes)X 1165(without)X 1439(restriction)X 1794(during)X 2033(the)X 2161(time)X 2333(the)X 0 f 2489(Dwarf_Debug)X 1 f 3047(is)X 3130(open,)X 3336(except)X 3576(that)X 3726(the)X 3854(client)X 576 4992(should)N 809(not)X 0 f 979(elf_end\(\))X 1 f 1431(the)X 1549(pointer)X 1796(till)X 1904(after)X 0 f 2120(dwarf_finish)X 1 f 2716(is)X 2789(called.)X 3 f 576 5232(5.1.3)N 776(dwarf_get_elf\(\))X 0 f 576 5376(int)N 768(dwarf_get_elf\()X 960 5472(Dwarf_Debug)N 1536(dbg,)X 960 5568(Elf)N 1152(**)X 1536(elf,)X 960 5664(Dwarf_Error)N 1536(*error\))X 1 f 576 5808(When)N 789(it)X 855(returns)X 0 f 1128(DW_DLV_OK)X 1 f (,)S 1602(the)X 1722(function)X 0 f 2039(dwarf_get_elf\(\))X 1 f 2781(returns)X 3026(thru)X 3177(the)X 3297(pointer)X 0 f 3574(elf)X 1 f 3740(the)X 0 f 3888(Elf)X 576 5904(*)N 1 f 666(handle)X 921(used)X 1109(to)X 1212(access)X 1459(the)X 1598(object)X 1835(represented)X 2247(by)X 2368(the)X 0 f 2535(Dwarf_Debug)X 1 f 3104(descriptor)X 0 f 3494(dbg)X 1 f (.)S 3719(It)X 3809(returns)X 576 6183(rev)N 699(1.61,)X 879(3)X 939(Apr)X 1084(2006)X 2217(-)X 2264(16)X 2364(-)X 17 p %%Page: 17 17 0(Courier)xf 0 f 10 s 0 xH 0 xS 0 f 1 f 2217 384(-)N 2264(17)X 2364(-)X 0 f 576 768(DW_DLV_ERROR)N 1 f 1172(on)X 1272(error.)X 576 960(Because)N 0 f 906(int)X 1112(dwarf_init\(\))X 1 f 1722(opens)X 1943(an)X 2053(Elf)X 2185(descriptor)X 2540(on)X 2654(its)X 2763(fd)X 2864(and)X 0 f 3042(dwarf_finish\(\))X 1 f 3748(does)X 3930(not)X 576 1056(close)N 769(that)X 917(descriptor,)X 1286(an)X 1390(app)X 1534(should)X 1775(use)X 0 f 1938(dwarf_get_elf)X 1 f 2590(and)X 2734(should)X 2975(call)X 0 f 3147(elf_end)X 1 f 3511(with)X 3680(the)X 3805(pointer)X 576 1152(returned)N 864(thru)X 1013(the)X 0 f 1159(Elf**)X 1 f 1419(handle)X 1653(created)X 1906(by)X 0 f 2034(int)X 2226(dwarf_init\(\))X 1 f (.)S 576 1344(This)N 738(function)X 1025(is)X 1098(not)X 1220(meaningful)X 1605(for)X 1719(a)X 1775(system)X 2017(that)X 2157(does)X 2324(not)X 2446(use)X 2573(the)X 2691(Elf)X 2809(format)X 3043(for)X 3157(objects.)X 3 f 576 1584(5.1.4)N 776(dwarf_finish\(\))X 0 f 576 1728(int)N 768(dwarf_finish\()X 960 1824(Dwarf_Debug)N 1536(dbg,)X 960 1920(Dwarf_Error)N 1536(*error\))X 1 f 576 2064(The)N 728(function)X 0 f 1050(dwarf_finish\(\))X 1 f 1749(releases)X 2031(all)X 2 f 2138(Libdwarf)X 1 f 2457(internal)X 2729(resources)X 3060(associated)X 3417(with)X 3586(the)X 3711(descriptor)X 0 f 576 2160(dbg)N 1 f (,)S 763(and)X 901(invalidates)X 0 f 1298(dbg)X 1 f (.)S 1504(It)X 1575(returns)X 0 f 1848(DW_DLV_ERROR)X 1 f 2446(if)X 2517(there)X 2700(is)X 2775(an)X 2873(error)X 3052(during)X 3283(the)X 3403(finishing)X 3709(operation.)X 576 2256(It)N 645(returns)X 0 f 916(DW_DLV_OK)X 1 f 1368(for)X 1482(a)X 1538(successful)X 1888(operation.)X 576 2448(Because)N 0 f 906(int)X 1112(dwarf_init\(\))X 1 f 1722(opens)X 1943(an)X 2053(Elf)X 2185(descriptor)X 2540(on)X 2654(its)X 2763(fd)X 2864(and)X 0 f 3042(dwarf_finish\(\))X 1 f 3748(does)X 3930(not)X 576 2544(close)N 769(that)X 917(descriptor,)X 1286(an)X 1390(app)X 1534(should)X 1775(use)X 0 f 1938(dwarf_get_elf)X 1 f 2590(and)X 2734(should)X 2975(call)X 0 f 3147(elf_end)X 1 f 3511(with)X 3680(the)X 3805(pointer)X 576 2640(returned)N 864(thru)X 1013(the)X 0 f 1159(Elf**)X 1 f 1419(handle)X 1653(created)X 1906(by)X 0 f 2034(int)X 2226(dwarf_init\(\))X 1 f (.)S 3 f 11 s 576 2880(5.2)N 730(Debugging)X 1158(Information)X 1639(Entry)X 1881(Delivery)X 2221(Operations)X 1 f 10 s 576 3024(These)N 788(functions)X 1106(are)X 1225(concerned)X 1576(with)X 1738(accessing)X 2066(debugging)X 2424(information)X 2822(entries.)X 3 f 576 3264(5.2.1)N 776(Debugging)X 1164(Information)X 1602(Entry)X 1822(Debugger)X 2176(Delivery)X 2486(Operations)X 576 3552(5.2.2)N 776(dwarf_next_cu_header\(\))X 0 f 576 3696(int)N 768(dwarf_next_cu_header\()X 960 3792(Dwarf_debug)N 1536(dbg,)X 960 3888(Dwarf_Unsigned)N 1680(*cu_header_length,)X 960 3984(Dwarf_Half)N 1680(*version_stamp,)X 960 4080(Dwarf_Unsigned)N 1680(*abbrev_offset,)X 960 4176(Dwarf_Half)N 1680(*address_size,)X 960 4272(Dwarf_Unsigned)N 1680(*next_cu_header,)X 960 4368(Dwarf_Error)N 1680(*error\);)X 1 f 576 4512(The)N 722(function)X 0 f 1038(dwarf_next_cu_header\(\))X 1 f 2115(returns)X 0 f 2387(DW_DLV_ERROR)X 1 f 2984(if)X 3054(it)X 3119(fails,)X 3298(and)X 0 f 3463(DW_DLV_OK)X 1 f 3917(if)X 3988(it)X 576 4608(succeeds.)N 576 4752(If)N 679(it)X 772(succeeds,)X 0 f 1155(*next_cu_header)X 1 f 1924(is)X 2026(set)X 2164(to)X 2276(the)X 2424(offset)X 2657(in)X 2769(the)X 2917(.debug_info)X 3352(section)X 3629(of)X 3746(the)X 3894(next)X 576 4848(compilation-unit)N 1144(header)X 1394(if)X 1478(it)X 1557(succeeds.)X 1918(On)X 2051(reading)X 2326(the)X 2458(last)X 2603(compilation-unit)X 3170(header)X 3419(in)X 3515(the)X 3647(.debug_info)X 576 4944(section)N 830(it)X 901(contains)X 1195(the)X 1320(size)X 1472(of)X 1566(the)X 1691(.debug_info)X 2103(section.)X 2397(The)X 2549(next)X 2714(call)X 2858(to)X 0 f 2976(dwarf_next_cu_header\(\))X 1 f 576 5040(returns)N 0 f 875(DW_DLV_NO_ENTRY)X 1 f 1643(without)X 1935(reading)X 2224(a)X 2308(compilation-unit)X 2889(or)X 3004(setting)X 0 f 3292(*next_cu_header)X 1 f (.)S 576 5136(Subsequent)N 967(calls)X 1136(to)X 0 f 1248(dwarf_next_cu_header\(\))X 1 f 2326(repeat)X 2545(the)X 2666(cycle)X 2859(by)X 2962(reading)X 3226(the)X 3347(first)X 3499(compilation-unit)X 576 5232(and)N 712(so)X 803(on.)X 576 5376(The)N 740(other)X 945(values)X 1190(returned)X 1498(through)X 1787(pointers)X 2085(are)X 2224(the)X 2362(values)X 2607(in)X 2709(the)X 2847(compilation-unit)X 3420(header.)X 3715(If)X 3809(any)X 3965(of)X 0 f 576 5472(cu_header_length)N 1 f (,)S 0 f 1430(version_stamp)X 1 f (,)S 0 f 2140(abbrev_offset)X 1 f (,)S 2822(or)X 0 f 2954(address_size)X 1 f 3567(is)X 0 f 3685(NULL)X 1 f (,)S 3934(the)X 576 5568(argument)N 899(is)X 972(ignored)X 1237(\(meaning)X 1560(it)X 1624(is)X 1697(not)X 1819(an)X 1915(error)X 2092(to)X 2174(provide)X 2439(a)X 0 f 2523(NULL)X 1 f 2735(pointer\).)X 576 6183(rev)N 699(1.61,)X 879(3)X 939(Apr)X 1084(2006)X 2217(-)X 2264(17)X 2364(-)X 18 p %%Page: 18 18 0(Courier)xf 0 f 10 s 0 xH 0 xS 0 f 1 f 2217 384(-)N 2264(18)X 2364(-)X 3 f 576 768(5.2.3)N 776(dwarf_siblingof\(\))X 0 f 576 912(int)N 768(dwarf_siblingof\()X 960 1008(Dwarf_Debug)N 1536(dbg,)X 960 1104(Dwarf_Die)N 1440(die,)X 960 1200(Dwarf_Die)N 1440(*return_sib,)X 960 1296(Dwarf_Error)N 1536(*error\))X 1 f 576 1440(The)N 728(function)X 0 f 1051(dwarf_siblingof\(\))X 1 f 1895(returns)X 0 f 2174(DW_DLV_ERROR)X 1 f 2778(and)X 2922(sets)X 3070(the)X 0 f 3224(error)X 1 f 3492(pointer)X 3747(on)X 3855(error.)X 576 1536(If)N 671(there)X 873(is)X 967(no)X 1088(sibling)X 1346(it)X 1431(returns)X 0 f 1723(DW_DLV_NO_ENTRY)X 1 f (.)S 2524(When)X 2757(it)X 2842(succeeds,)X 0 f 3216(dwarf_siblingof\(\))X 1 f 576 1632(returns)N 0 f 848(DW_DLV_OK)X 1 f 1321(and)X 1458(sets)X 0 f 1628(*return_sib)X 1 f 2178(to)X 2262(the)X 0 f 2410(Dwarf_Die)X 1 f 2864(descriptor)X 3207(of)X 3296(the)X 3416(sibling)X 3655(of)X 0 f 3772(die)X 1 f (.)S 3978(If)X 0 f 576 1728(die)N 1 f 742(is)X 2 f 817(NULL)X 1 f 1016(,)X 1058(the)X 0 f 1206(Dwarf_Die)X 1 f 1660(descriptor)X 2003(of)X 2092(the)X 2212(first)X 2363(die)X 2483(in)X 2567(the)X 2686(compilation-unit)X 3240(is)X 3314(returned.)X 3643(This)X 3806(die)X 3925(has)X 576 1824(the)N 0 f 722(DW_TAG_compile_unit)X 1 f 1654(tag.)X 3 f 576 1968(5.2.4)N 776(dwarf_child\(\))X 0 f 576 2112(int)N 768(dwarf_child\()X 960 2208(Dwarf_Die)N 1440(die,)X 960 2304(Dwarf_Die)N 1440(*return_kid,)X 960 2400(Dwarf_Error)N 1536(*error\))X 1 f 576 2544(The)N 725(function)X 0 f 1044(dwarf_child\(\))X 1 f 1692(returns)X 0 f 1967(DW_DLV_ERROR)X 1 f 2567(and)X 2707(sets)X 2851(the)X 0 f 3001(error)X 1 f 3265(die)X 3387(on)X 3492(error.)X 3714(If)X 3793(there)X 3979(is)X 576 2640(no)N 685(child)X 874(it)X 947(returns)X 0 f 1227(DW_DLV_NO_ENTRY)X 1 f (.)S 2015(When)X 2235(it)X 2307(succeeds,)X 0 f 2669(dwarf_child\(\))X 1 f 3321(returns)X 0 f 3600(DW_DLV_OK)X 1 f 576 2736(and)N 734(sets)X 0 f 924(*return_kid)X 1 f 1494(to)X 1598(the)X 0 f 1767(Dwarf_Die)X 1 f 2242(descriptor)X 2606(of)X 2716(the)X 2857(first)X 3029(child)X 3232(of)X 0 f 3370(die)X 1 f (.)S 3597(The)X 3765(function)X 0 f 576 2832(dwarf_siblingof\(\))N 1 f 1427(can)X 1574(be)X 1685(used)X 1867(with)X 2044(the)X 2177(return)X 2404(value)X 2612(of)X 0 f 2741(dwarf_child\(\))X 1 f 3399(to)X 3495(access)X 3735(the)X 3867(other)X 576 2928(children)N 859(of)X 0 f 974(die)X 1 f (.)S 3 f 576 3168(5.2.5)N 776(dwarf_offdie\(\))X 0 f 576 3312(int)N 768(dwarf_offdie\()X 960 3408(Dwarf_Debug)N 1536(dbg,)X 960 3504(Dwarf_Off)N 1440(offset,)X 960 3600(Dwarf_Die)N 1440(*return_die,)X 960 3696(Dwarf_Error)N 1536(*error\))X 1 f 576 3840(The)N 725(function)X 0 f 1045(dwarf_offdie\(\))X 1 f 1742(returns)X 0 f 2018(DW_DLV_ERROR)X 1 f 2619(and)X 2760(sets)X 2905(the)X 0 f 3056(error)X 1 f 3321(die)X 3444(on)X 3549(error.)X 3771(When)X 3988(it)X 576 3936(succeeds,)N 0 f 936(dwarf_offdie\(\))X 1 f 1634(returns)X 0 f 1911(DW_DLV_OK)X 1 f 2369(and)X 2511(sets)X 0 f 2685(*return_die)X 1 f 3239(to)X 3326(the)X 3449(the)X 0 f 3600(Dwarf_Die)X 1 f 576 4032(descriptor)N 918(of)X 1006(the)X 1125(debugging)X 1484(information)X 1883(entry)X 2069(at)X 0 f 2176(offset)X 1 f 2485(in)X 2568(the)X 2687(section)X 2935(containing)X 3294(debugging)X 3654(information)X 576 4128(entries)N 823(i.e)X 934(the)X 1064(.debug_info)X 1481(section.)X 1780(A)X 1870(return)X 2094(of)X 0 f 2221(DW_DLV_NO_ENTRY)X 1 f 2973(means)X 3210(that)X 3362(the)X 0 f 3520(offset)X 1 f 3840(in)X 3934(the)X 576 4224(section)N 831(is)X 912(of)X 1007(a)X 1071(byte)X 1237(containing)X 1603(all)X 1711(0)X 1779(bits,)X 1942(indicating)X 2290(that)X 2438(there)X 2627(is)X 2709(no)X 2818(abbreviation)X 3248(code.)X 3449(Meaning)X 3763(this)X 3907('die)X 576 4320(offset')N 808(is)X 883(not)X 1007(the)X 1127(offset)X 1332(of)X 1421(a)X 1479(real)X 1622(die,)X 1762(but)X 1886(is)X 1961(instead)X 2210(an)X 2308(offset)X 2513(of)X 2602(a)X 2660(null)X 2806(die,)X 2946(a)X 3003(padding)X 3282(die,)X 3421(or)X 3509(of)X 3597(some)X 3787(random)X 576 4416(zero)N 750(byte:)X 945(this)X 1095(should)X 1343(not)X 1480(be)X 1591(returned)X 1894(in)X 1991(normal)X 2253(use.)X 2435(It)X 2519(is)X 2607(the)X 2740(user's)X 2967(responsibility)X 3437(to)X 3534(make)X 3743(sure)X 3912(that)X 0 f 576 4512(offset)N 1 f 886(is)X 961(the)X 1081(start)X 1241(of)X 1329(a)X 1386(valid)X 1567(debugging)X 1926(information)X 2325(entry.)X 2551(The)X 2697(result)X 2896(of)X 2984(passing)X 3245(it)X 3310(an)X 3407(invalid)X 3650(offset)X 3854(could)X 576 4608(be)N 672(chaos.)X 3 f 11 s 576 5040(5.3)N 730(Debugging)X 1158(Information)X 1639(Entry)X 1881(Query)X 2143(Operations)X 1 f 10 s 576 5184(These)N 794(queries)X 1052(return)X 1270(specific)X 1546(information)X 1950(about)X 2154(debugging)X 2519(information)X 2924(entries)X 3165(or)X 3259(a)X 3322(descriptor)X 3670(that)X 3817(can)X 3956(be)X 576 5280(used)N 745(on)X 847(subsequent)X 1225(queries)X 1479(when)X 1675(given)X 1875(a)X 0 f 1961(Dwarf_Die)X 1 f 2415(descriptor.)X 2798(Note)X 2976(that)X 3117(some)X 3307(operations)X 3662(are)X 3782(specific)X 576 5376(to)N 660(debugging)X 1020(information)X 1420(entries)X 1656(that)X 1798(are)X 1919(represented)X 2312(by)X 2414(a)X 0 f 2500(Dwarf_Die)X 1 f 2954(descriptor)X 3298(of)X 3388(a)X 3447(specific)X 3720(type.)X 3921(For)X 576 5472(example,)N 892(not)X 1018(all)X 1122(debugging)X 1484(information)X 1886(entries)X 2124(contain)X 2384(an)X 2484(attribute)X 2775(having)X 3017(a)X 3077(name,)X 3295(so)X 3390(consequently,)X 3857(a)X 3916(call)X 576 5568(to)N 0 f 690(dwarf_diename\(\))X 1 f 1434(using)X 1631(a)X 0 f 1719(Dwarf_Die)X 1 f 2175(descriptor)X 2520(that)X 2664(does)X 2835(not)X 2962(have)X 3139(a)X 3200(name)X 3399(attribute)X 3691(will)X 3840(return)X 0 f 576 5664(DW_DLV_NO_ENTRY)N 1 f (.)S 1362(This)X 1530(is)X 1609(not)X 1737(an)X 1839(error,)X 2042(i.e.)X 2166(calling)X 2410(a)X 2472(function)X 2765(that)X 2911(needs)X 3120(a)X 3182(specific)X 3458(attribute)X 3751(is)X 3829(not)X 3956(an)X 576 5760(error)N 753(for)X 867(a)X 923(die)X 1041(that)X 1181(does)X 1348(not)X 1470(contain)X 1726(that)X 1866(specific)X 2136(attribute.)X 576 6183(rev)N 699(1.61,)X 879(3)X 939(Apr)X 1084(2006)X 2217(-)X 2264(18)X 2364(-)X 19 p %%Page: 19 19 0(Courier)xf 0 f 10 s 0 xH 0 xS 0 f 1 f 2217 384(-)N 2264(19)X 2364(-)X 576 768(There)N 784(are)X 903(several)X 1151(methods)X 1442(that)X 1582(can)X 1714(be)X 1810(used)X 1977(to)X 2059(obtain)X 2279(the)X 2397(value)X 2591(of)X 2678(an)X 2774(attribute)X 3061(in)X 3143(a)X 3199(given)X 3397(die:)X 636 912(1.)N 776(Call)X 0 f 972(dwarf_hasattr\(\))X 1 f 1727(to)X 1824(determine)X 2180(if)X 2264(the)X 2397(debugging)X 2770(information)X 3184(entry)X 3385(has)X 3528(the)X 3662(attribute)X 3965(of)X 776 1008(interest)N 1032(prior)X 1208(to)X 1290(issuing)X 1536(the)X 1654(query)X 1857(for)X 1971(information)X 2369(about)X 2567(the)X 2685(attribute.)X 636 1248(2.)N 776(Supply)X 1026(an)X 0 f 1154(error)X 1 f 1418(argument,)X 1765(and)X 1906(check)X 2119(its)X 2219(value)X 2418(after)X 2591(the)X 2714(call)X 2855(to)X 2942(a)X 3003(query)X 3211(indicates)X 3521(an)X 3622(unsuccessful)X 776 1344(return,)N 1010(to)X 1094(determine)X 1437(the)X 1557(nature)X 1780(of)X 1869(the)X 1989(problem.)X 2318(The)X 0 f 2493(error)X 1 f 2754(argument)X 3078(will)X 3223(indicate)X 3498(whether)X 3778(an)X 3875(error)X 776 1440(occurred,)N 1098(or)X 1185(the)X 1303(specific)X 1573(attribute)X 1860(needed)X 2108(was)X 2253(missing)X 2521(in)X 2603(that)X 2743(die.)X 636 1680(3.)N 776(Arrange)X 1105(to)X 1232(have)X 1450(an)X 1592(error)X 1815(handling)X 2161(function)X 2494(invoked)X 2818(upon)X 3044(detection)X 3404(of)X 3537(an)X 3679(error)X 3902(\(see)X 0 f 776 1776(dwarf_init\(\))N 1 f (\).)S 636 2016(4.)N 776(Call)X 0 f 957(dwarf_attrlist\(\))X 1 f 1745(and)X 1882(iterate)X 2104(through)X 2374(the)X 2493(returned)X 2782(list)X 2900(of)X 2988(attributes,)X 3327(dealing)X 3584(with)X 3747(each)X 3916(one)X 776 2112(as)N 863(appropriate.)X 3 f 576 2400(5.3.1)N 776(dwarf_tag\(\))X 0 f 576 2544(int)N 768(dwarf_tag\()X 960 2640(Dwarf_Die)N 1440(die,)X 960 2736(Dwarf_Half)N 1488(*tagval,)X 960 2832(Dwarf_Error)N 1536(*error\))X 1 f 576 2976(The)N 723(function)X 0 f 1040(dwarf_tag\(\))X 1 f 1590(returns)X 1836(the)X 2 f 1957(tag)X 1 f 2082(of)X 0 f 2200(die)X 1 f 2367(thru)X 2519(the)X 2640(pointer)X 0 f 2938(tagval)X 1 f 3249(if)X 3321(it)X 3388(succeeds.)X 3737(It)X 3809(returns)X 0 f 576 3072(DW_DLV_OK)N 1 f 1028(if)X 1097(it)X 1161(succeeds.)X 1507(It)X 1576(returns)X 0 f 1847(DW_DLV_ERROR)X 1 f 2443(on)X 2543(error.)X 3 f 576 3312(5.3.2)N 776(dwarf_dieoffset\(\))X 0 f 576 3456(int)N 768(dwarf_dieoffset\()X 960 3552(Dwarf_Die)N 1440(die,)X 960 3648(Dwarf_Off)N 1440(*)X 1536(return_offset,)X 960 3744(Dwarf_Error)N 1536(*error\))X 1 f 576 3888(When)N 855(it)X 986(succeeds,)X 1379(the)X 1564(function)X 0 f 1946(dwarf_dieoffset\(\))X 1 f 2849(returns)X 0 f 3188(DW_DLV_OK)X 1 f 3708(and)X 3912(sets)X 0 f 576 3984(*return_offset)N 1 f 1275(to)X 1364(the)X 1489(position)X 1773(of)X 0 f 1895(die)X 1 f 2066(in)X 2155(the)X 2280(section)X 2534(containing)X 2899(debugging)X 3263(information)X 3667(entries)X 3907(\(the)X 0 f 576 4080(return_offset)N 1 f 1223(is)X 1299(a)X 1358(section-relative)X 1876(offset\).)X 2149(In)X 2239(other)X 2427(words,)X 2666(it)X 2733(sets)X 0 f 2904(return_offset)X 1 f 3551(to)X 3636(the)X 3758(offset)X 3965(of)X 576 4176(the)N 718(start)X 900(of)X 1011(the)X 1153(debugging)X 1535(information)X 1957(entry)X 2166(described)X 2518(by)X 0 f 2670(die)X 1 f 2858(in)X 2963(the)X 3104(section)X 3374(containing)X 3755(die's)X 3954(i.e)X 576 4272(.debug_info.)N 1021(It)X 1090(returns)X 0 f 1361(DW_DLV_ERROR)X 1 f 1957(on)X 2057(error.)X 3 f 576 4512(5.3.3)N 776 0.1562(dwarf_die_CU_offset\(\))AX 0 f 576 4656(int)N 768(dwarf_die_CU_offset\()X 960 4752(Dwarf_Die)N 1440(die,)X 960 4848(Dwarf_Off)N 1440(*return_offset,)X 960 4944(Dwarf_Error)N 1536(*error\))X 1 f 576 5088(The)N 721(function)X 0 f 1036(dwarf_die_CU_offset\(\))X 1 f 2064(is)X 2137(similar)X 2379(to)X 0 f 2489(dwarf_dieoffset\(\))X 1 f (,)S 3345(except)X 3575(that)X 3715(it)X 3780(puts)X 3934(the)X 576 5184(offset)N 792(of)X 892(the)X 1023(DIE)X 1190(represented)X 1594(by)X 1707(the)X 0 f 1866(Dwarf_Die)X 2358(die)X 1 f (,)S 2554(from)X 2742(the)X 2872(start)X 3042(of)X 3141(the)X 3271(compilation-unit)X 3836(that)X 3988(it)X 576 5280(belongs)N 845(to)X 927(rather)X 1135(than)X 1293(the)X 1411(start)X 1569(of)X 1656(.debug_info)X 2061(\(the)X 0 f 2234(return_offset)X 1 f 2878(is)X 2951(a)X 3007(CU-relative)X 3406(offset\).)X 3 f 576 5616(5.3.4)N 776(dwarf_diename\(\))X 1 f 576 6183(rev)N 699(1.61,)X 879(3)X 939(Apr)X 1084(2006)X 2217(-)X 2264(19)X 2364(-)X 20 p %%Page: 20 20 0(Courier)xf 0 f 10 s 0 xH 0 xS 0 f 1 f 2217 384(-)N 2264(20)X 2364(-)X 0 f 576 768(int)N 768(dwarf_diename\()X 960 864(Dwarf_Die)N 1440(die,)X 960 960(char)N 1248(**)X 1392(return_name,)X 960 1056(Dwarf_Error)N 1536(*error\))X 1 f 576 1200(When)N 795(it)X 866(succeeds,)X 1200(the)X 1326(function)X 0 f 1649(dwarf_diename\(\))X 1 f 2397(returns)X 0 f 2676(DW_DLV_OK)X 1 f 3136(and)X 3280(sets)X 0 f 3456(*return_name)X 1 f 576 1296(to)N 664(a)X 726(pointer)X 978(to)X 1065(a)X 1126(null-terminated)X 1645(string)X 1852(of)X 1944(characters)X 2296(that)X 2441(represents)X 2792(the)X 2915(name)X 3114(attribute)X 3406(of)X 0 f 3526(die)X 1 f (.)S 3735(It)X 3809(returns)X 0 f 576 1392(DW_DLV_NO_ENTRY)N 1 f 1327(if)X 0 f 1435(die)X 1 f 1610(does)X 1788(not)X 1921(have)X 2104(a)X 2171(name)X 2376(attribute.)X 2714(It)X 2795(returns)X 0 f 3078(DW_DLV_ERROR)X 1 f 3686(if)X 3767(an)X 3875(error)X 576 1488(occurred.)N 925(The)X 1077(storage)X 1336(pointed)X 1602(to)X 1690(by)X 1796(a)X 1858(successful)X 2214(return)X 2432(of)X 0 f 2553(dwarf_diename\(\))X 1 f 3299(should)X 3538(be)X 3640(free'd)X 3859(using)X 576 1584(the)N 694(allocation)X 1030(type)X 0 f 1216(DW_DLA_STRING)X 1 f 1860(when)X 2054(no)X 2154(longer)X 2379(of)X 2466(interest)X 2722(\(see)X 0 f 2900(dwarf_dealloc\(\))X 1 f (\).)S 3 f 576 1824(5.3.5)N 776(dwarf_attrlist\(\))X 0 f 576 1968(int)N 768(dwarf_attrlist\()X 960 2064(Dwarf_Die)N 1440(die,)X 960 2160(Dwarf_Attribute**)N 1824(attrbuf,)X 960 2256(Dwarf_Signed)N 1584(*attrcount,)X 960 2352(Dwarf_Error)N 1536(*error\))X 1 f 576 2496(When)N 794(it)X 864(returns)X 0 f 1141(DW_DLV_OK)X 1 f (,)S 1619(the)X 1743(function)X 0 f 2064(dwarf_attrlist\(\))X 1 f 2858(sets)X 0 f 3032(attrbuf)X 1 f 3394(to)X 3483(point)X 3674(to)X 3763(an)X 3866(array)X 576 2592(of)N 0 f 693(Dwarf_Attribute)X 1 f 1434(descriptors)X 1807(corresponding)X 2287(to)X 2370(each)X 2539(of)X 2627(the)X 2746(attributes)X 3065(in)X 3148(die,)X 3287(and)X 3424(returns)X 3668(the)X 3787(number)X 576 2688(of)N 671(elements)X 984(in)X 1074(the)X 1200(array)X 1394(thru)X 0 f 1579(attrcount)X 1 f (.)S 0 f 2135(DW_DLV_NO_ENTRY)X 1 f 2884(is)X 2966(returned)X 3263(if)X 3341(the)X 3468(count)X 3675(is)X 3757(zero)X 3925(\(no)X 0 f 576 2784(attrbuf)N 1 f 936(is)X 1013(allocated)X 1327(in)X 1413(this)X 1552(case\).)X 0 f 1838(DW_DLV_ERROR)X 1 f 2438(is)X 2514(returned)X 2805(on)X 2908(error.)X 3128(On)X 3249(a)X 3308(successful)X 3661(return)X 3876(from)X 0 f 576 2880(dwarf_attrlist\(\))N 1 f (,)S 1385(each)X 1554(of)X 1642(the)X 0 f 1789(Dwarf_Attribute)X 1 f 2530(descriptors)X 2903(should)X 3138(be)X 3236(individually)X 3644(free'd)X 3859(using)X 0 f 576 2976(dwarf_dealloc\(\))N 1 f 1317(with)X 1480(the)X 1599(allocation)X 1936(type)X 0 f 2123(DW_DLA_ATTR)X 1 f (,)S 2692(followed)X 2998(by)X 3099(free-ing)X 3375(the)X 3493(list)X 3610(pointed)X 3870(to)X 3952(by)X 0 f 576 3072(*attrbuf)N 1 f 992(using)X 0 f 1225(dwarf_dealloc\(\))X 1 f 1977(with)X 2151(the)X 2281(allocation)X 2629(type)X 0 f 2827(DW_DLA_LIST)X 1 f (,)S 3407(when)X 3614(no)X 3727(longer)X 3965(of)X 576 3168(interest)N 832(\(see)X 0 f 1010(dwarf_dealloc\(\))X 1 f (\).)S 576 3360(Freeing)N 841(the)X 959(attrlist:)X 0 f 736 3504(Dwarf_Unsigned)N 1456(atcnt;)X 736 3600(Dwarf_Attribute)N 1504(*atlist;)X 736 3696(int)N 928(errv;)X 736 3888(errv)N 976(=)X 1072(dwarf_attrlist\(somedie,)X 2224(&atlist,&atcnt,)X 2992(&error\);)X 736 3984(if)N 880(\(errv)X 1168(==)X 1312(DW_DLV_OK\))X 1840({)X 1120 4176(for)N 1312(\(i)X 1456(=)X 1552(0;)X 1696(i)X 1792(<)X 1888(atcnt;)X 2224(++i\))X 2464({)X 1504 4272(/*)N 1648(use)X 1840(atlist[i])X 2320(*/)X 1504 4368(dwarf_dealloc\(dbg,)N 2416(atlist[i],)X 2944(DW_DLA_ATTR\);)X 1120 4464(})N 1120 4560(dwarf_dealloc\(dbg,)N 2032(atlist,)X 2416(DW_DLA_LIST\);)X 736 4656(})N 3 f 576 4800(5.3.6)N 776(dwarf_hasattr\(\))X 0 f 576 4944(int)N 768(dwarf_hasattr\()X 960 5040(Dwarf_Die)N 1440(die,)X 960 5136(Dwarf_Half)N 1488(attr,)X 960 5232(Dwarf_Bool)N 1488(*return_bool,)X 960 5328(Dwarf_Error)N 1536(*error\))X 1 f 576 5472(When)N 795(it)X 866(succeeds,)X 1200(the)X 1326(function)X 0 f 1649(dwarf_hasattr\(\))X 1 f 2397(returns)X 0 f 2676(DW_DLV_OK)X 1 f 3136(and)X 3280(sets)X 0 f 3456(*return_bool)X 1 f 576 5568(to)N 2 f 658(non-zero)X 1 f 963(if)X 0 f 1060(die)X 1 f 1224(has)X 1351(the)X 1469(attribute)X 0 f 1784(attr)X 1 f 1996(and)X 2 f 2132(zero)X 1 f 2290(otherwise.)X 2662(If)X 2736(it)X 2800(fails,)X 2978(it)X 3042(returns)X 0 f 3313(DW_DLV_ERROR)X 1 f (.)S 576 6183(rev)N 699(1.61,)X 879(3)X 939(Apr)X 1084(2006)X 2217(-)X 2264(20)X 2364(-)X 21 p %%Page: 21 21 0(Courier)xf 0 f 10 s 0 xH 0 xS 0 f 1 f 2217 384(-)N 2264(21)X 2364(-)X 3 f 576 768(5.3.7)N 776(dwarf_attr\(\))X 0 f 576 912(int)N 768(dwarf_attr\()X 960 1008(Dwarf_Die)N 1440(die,)X 960 1104(Dwarf_Half)N 1488(attr,)X 960 1200(Dwarf_Attribute)N 1728(*return_attr,)X 960 1296(Dwarf_Error)N 1536(*error\))X 1 f 576 1440(When)N 834(it)X 944(returns)X 0 f 1261(DW_DLV_OK)X 1 f (,)S 1779(the)X 1943(function)X 0 f 2304(dwarf_attr\(\))X 1 f 2947(sets)X 0 f 3162(*return_attr)X 1 f 3805(to)X 3934(the)X 0 f 576 1536(Dwarf_Attribute)N 1 f 1320(descriptor)X 1665(of)X 0 f 1784(die)X 1 f 1952(having)X 2194(the)X 2316(attribute)X 0 f 2635(attr)X 1 f (.)S 2891(It)X 2964(returns)X 0 f 3239(DW_DLV_NO_ENTRY)X 1 f 3983(if)X 0 f 576 1632(attr)N 1 f 788(is)X 861(not)X 983(contained)X 1315(in)X 0 f 1425(die)X 1 f (.)S 1629(It)X 1698(returns)X 0 f 1969(DW_DLV_ERROR)X 1 f 2565(if)X 2634(an)X 2730(error)X 2907(occurred.)X 3 f 576 2064(5.3.8)N 776(dwarf_lowpc\(\))X 0 f 576 2208(int)N 768(dwarf_lowpc\()X 960 2304(Dwarf_Die)N 1632(die,)X 960 2400(Dwarf_Addr)N 1536(*)X 1632(return_lowpc,)X 960 2496(Dwarf_Error)N 1536(*)X 1632(error\))X 1 f 576 2640(The)N 727(function)X 0 f 1048(dwarf_lowpc\(\))X 1 f 1698(returns)X 0 f 1975(DW_DLV_OK)X 1 f 2433(and)X 2575(sets)X 0 f 2749(*return_lowpc)X 1 f 3399(to)X 3488(the)X 3613(low)X 3760(program)X 576 2736(counter)N 844(value)X 1045(associated)X 1402(with)X 1571(the)X 0 f 1724(die)X 1 f 1895(descriptor)X 2243(if)X 0 f 2347(die)X 1 f 2517(represents)X 2869(a)X 2931(debugging)X 3295(information)X 3699(entry)X 3890(with)X 576 2832(this)N 744(attribute.)X 1104(It)X 1206(returns)X 0 f 1510(DW_DLV_NO_ENTRY)X 1 f 2284(if)X 0 f 2415(die)X 1 f 2613(does)X 2814(not)X 2970(have)X 3176(this)X 3345(attribute.)X 3706(It)X 3809(returns)X 0 f 576 2928(DW_DLV_ERROR)N 1 f 1172(if)X 1241(an)X 1337(error)X 1514(occurred.)X 3 f 576 3168(5.3.9)N 776(dwarf_highpc\(\))X 0 f 576 3312(int)N 768(dwarf_highpc\()X 960 3408(Dwarf_Die)N 1440(die,)X 960 3504(Dwarf_Addr)N 1536(*)X 1632(return_highpc,)X 960 3600(Dwarf_Error)N 1536(*error\))X 1 f 576 3744(The)N 724(function)X 0 f 1042(dwarf_highpc\(\))X 1 f 1737(returns)X 0 f 2011(DW_DLV_OK)X 1 f 2466(and)X 2605(sets)X 0 f 2776(*return_highpc)X 1 f 3472(the)X 3594(high)X 3760(program)X 576 3840(counter)N 844(value)X 1045(associated)X 1402(with)X 1571(the)X 0 f 1724(die)X 1 f 1895(descriptor)X 2243(if)X 0 f 2347(die)X 1 f 2517(represents)X 2869(a)X 2931(debugging)X 3295(information)X 3699(entry)X 3890(with)X 576 3936(this)N 744(attribute.)X 1104(It)X 1206(returns)X 0 f 1510(DW_DLV_NO_ENTRY)X 1 f 2284(if)X 0 f 2415(die)X 1 f 2613(does)X 2814(not)X 2970(have)X 3176(this)X 3345(attribute.)X 3706(It)X 3809(returns)X 0 f 576 4032(DW_DLV_ERROR)N 1 f 1172(if)X 1241(an)X 1337(error)X 1514(occurred.)X 3 f 576 4272(5.3.10)N 816(dwarf_bytesize\(\))X 0 f 576 4416(Dwarf_Signed)N 1200(dwarf_bytesize\()X 960 4512(Dwarf_Die)N 1776(die,)X 960 4608(Dwarf_Unsigned)N 1728(*return_size,)X 960 4704(Dwarf_Error)N 1728(*error\))X 1 f 576 4848(When)N 811(it)X 898(succeeds,)X 0 f 1275(dwarf_bytesize\(\))X 1 f 2086(returns)X 0 f 2380(DW_DLV_OK)X 1 f 2856(and)X 3016(sets)X 0 f 3208(*return_size)X 1 f 3828(to)X 3934(the)X 576 4944(number)N 841(of)X 928(bytes)X 1117(needed)X 1365(to)X 1447(contain)X 1703(an)X 1799(instance)X 2082(of)X 2169(the)X 2287(aggregate)X 2620(debugging)X 2978(information)X 3376(entry)X 3561(represented)X 3952(by)X 0 f 576 5040(die)N 1 f (.)S 836(It)X 961(returns)X 0 f 1288(DW_DLV_NO_ENTRY)X 1 f 2084(if)X 0 f 2237(die)X 1 f 2457(does)X 2681(not)X 2860(contain)X 3173(the)X 3348(byte)X 3563(size)X 3765(attribute)X 0 f 576 5136(DW_AT_byte_size)N 1 f (.)S 1356(It)X 1425(returns)X 0 f 1696(DW_DLV_ERROR)X 1 f 2292(if)X 2361(an)X 2457(error)X 2634(occurred.)X 3 f 576 5472(5.3.11)N 816(dwarf_bitsize\(\))X 1 f 576 6183(rev)N 699(1.61,)X 879(3)X 939(Apr)X 1084(2006)X 2217(-)X 2264(21)X 2364(-)X 22 p %%Page: 22 22 0(Courier)xf 0 f 10 s 0 xH 0 xS 0 f 1 f 2217 384(-)N 2264(22)X 2364(-)X 0 f 576 768(int)N 768(dwarf_bitsize\()X 960 864(Dwarf_Die)N 1440(die,)X 960 960(Dwarf_Unsigned)N 1728(*return_size,)X 960 1056(Dwarf_Error)N 1536(*error\))X 1 f 576 1200(When)N 789(it)X 854(succeeds,)X 0 f 1209(dwarf_bitsize\(\))X 1 f 1950(returns)X 0 f 2223(DW_DLV_OK)X 1 f 2677(and)X 2815(sets)X 0 f 2985(*return_size)X 1 f 3583(to)X 3667(the)X 3787(number)X 576 1296(of)N 665(bits)X 802(occupied)X 1114(by)X 1216(the)X 1336(bit)X 1442(field)X 1610(value)X 1805(that)X 1946(is)X 2020(an)X 2117(attribute)X 2405(of)X 2493(the)X 2612(given)X 2811(die.)X 2970(It)X 3040(returns)X 0 f 3312(DW_DLV_NO_ENTRY)X 1 f 576 1392(if)N 0 f 684(die)X 1 f 859(does)X 1037(not)X 1170(contain)X 1437(the)X 1566(bit)X 1681(size)X 1837(attribute)X 0 f 2163(DW_AT_bit_size)X 1 f (.)S 2906(It)X 2986(returns)X 0 f 3268(DW_DLV_ERROR)X 1 f 3875(if)X 3956(an)X 576 1488(error)N 753(occurred.)X 3 f 576 1728(5.3.12)N 816(dwarf_bitoffset\(\))X 0 f 576 1872(int)N 768(dwarf_bitoffset\()X 960 1968(Dwarf_Die)N 1440(die,)X 960 2064(Dwarf_Unsigned)N 1728(*return_size,)X 960 2160(Dwarf_Error)N 1536(*error\))X 1 f 576 2304(When)N 806(it)X 888(succeeds,)X 0 f 1260(dwarf_bitoffset\(\))X 1 f 2115(returns)X 0 f 2405(DW_DLV_OK)X 1 f 2876(and)X 3031(sets)X 0 f 3218(*return_size)X 1 f 3833(to)X 3934(the)X 576 2400(number)N 845(of)X 936(bits)X 1075(to)X 1161(the)X 1283(left)X 1414(of)X 1504(the)X 1625(most)X 1803(significant)X 2164(bit)X 2271(of)X 2361(the)X 2482(bit)X 2589(field)X 2759(value.)X 2996(This)X 3161(bit)X 3268(offset)X 3474(is)X 3550(not)X 3675(necessarily)X 576 2496(the)N 703(net)X 830(bit)X 943(offset)X 1155(within)X 1388(the)X 1515(structure)X 1826(or)X 1923(class)X 2109(,)X 2159(since)X 0 f 2382(DW_AT_data_member_location)X 1 f 3660(may)X 3828(give)X 3996(a)X 576 2592(byte)N 738(offset)X 945(to)X 1031(this)X 0 f 1198(DIE)X 1 f 1366(and)X 1506(the)X 1628(bit)X 1735(offset)X 1941(returned)X 2232(through)X 2504(the)X 2625(pointer)X 2875(does)X 3045(not)X 3170(include)X 3429(the)X 3550(bits)X 3688(in)X 3773(the)X 3894(byte)X 576 2688(offset.)N 871(It)X 993(returns)X 0 f 1317(DW_DLV_NO_ENTRY)X 1 f 2110(if)X 0 f 2260(die)X 1 f 2477(does)X 2697(not)X 2872(contain)X 3181(the)X 3352(bit)X 3509(offset)X 3765(attribute)X 0 f 576 2784(DW_AT_bit_offset)N 1 f (.)S 1404(It)X 1473(returns)X 0 f 1744(DW_DLV_ERROR)X 1 f 2340(if)X 2409(an)X 2505(error)X 2682(occurred.)X 3 f 576 3024(5.3.13)N 816(dwarf_srclang\(\))X 0 f 576 3168(int)N 768(dwarf_srclang\()X 960 3264(Dwarf_Die)N 1440(die,)X 960 3360(Dwarf_Unsigned)N 1728(*return_lang,)X 960 3456(Dwarf_Error)N 1536(*error\))X 1 f 576 3600(When)N 803(it)X 882(succeeds,)X 0 f 1251(dwarf_srclang\(\))X 1 f 2007(returns)X 0 f 2294(DW_DLV_OK)X 1 f 2762(and)X 2914(sets)X 0 f 3098(*return_lang)X 1 f 3710(to)X 3808(a)X 3880(code)X 576 3696(indicating)N 933(the)X 1068(source)X 1315(language)X 1642(of)X 1746(the)X 1881(compilation)X 2300(unit)X 2461(represented)X 2869(by)X 2985(the)X 3119(descriptor)X 0 f 3504(die)X 1 f (.)S 3724(It)X 3809(returns)X 0 f 576 3792(DW_DLV_NO_ENTRY)N 1 f 1324(if)X 0 f 1430(die)X 1 f 1603(does)X 1779(not)X 1910(represent)X 2234(a)X 2299(source)X 2538(file)X 2674(debugging)X 3041(information)X 3448(entry)X 3642(\(i.e.)X 3796(contain)X 576 3888(the)N 694(attribute)X 0 f 1009(DW_AT_language)X 1 f (\).)S 1768(It)X 1837(returns)X 0 f 2108(DW_DLV_ERROR)X 1 f 2704(if)X 2773(an)X 2869(error)X 3046(occurred.)X 3 f 576 4128(5.3.14)N 816 0.1985(dwarf_arrayorder\(\))AX 0 f 576 4272(int)N 768(dwarf_arrayorder\()X 960 4368(Dwarf_Die)N 1440(die,)X 960 4464(Dwarf_Unsigned)N 1728(*return_order,)X 960 4560(Dwarf_Error)N 1536(*error\))X 1 f 576 4704(When)N 794(it)X 864(succeeds,)X 0 f 1224(dwarf_arrayorder\(\))X 1 f 2114(returns)X 0 f 2391(DW_DLV_OK)X 1 f 2849(and)X 2991(sets)X 0 f 3166(*return_order)X 1 f 3817(a)X 3880(code)X 576 4800(indicating)N 917(the)X 1036(ordering)X 1329(of)X 1417(the)X 1535(array)X 1721(represented)X 2112(by)X 2212(the)X 2330(descriptor)X 0 f 2699(die)X 1 f (.)S 2903(It)X 2972(returns)X 0 f 3243(DW_DLV_NO_ENTRY)X 1 f 3983(if)X 0 f 576 4896(die)N 1 f 749(does)X 925(not)X 1056(contain)X 1321(the)X 1448(array)X 1644(order)X 1844(attribute)X 0 f 2169(DW_AT_ordering)X 1 f (.)S 2911(It)X 2990(returns)X 0 f 3271(DW_DLV_ERROR)X 1 f 3877(if)X 3956(an)X 576 4992(error)N 753(occurred.)X 3 f 11 s 576 5232(5.4)N 730(Attribute)X 1103(Form)X 1335(Queries)X 1 f 10 s 576 5376(Based)N 800(on)X 908(the)X 1034(attribute's)X 1387(form,)X 1591(these)X 1784(operations)X 2146(are)X 2273(concerned)X 2632(with)X 2802(returning)X 3125(uninterpreted)X 3582(attribute)X 3878(data.)X 576 5472(Since)N 784(it)X 858(is)X 941(not)X 1073(always)X 1326(obvious)X 1609(from)X 1795(the)X 1923(return)X 2145(value)X 2349(of)X 2446(these)X 2641(functions)X 2969(if)X 3048(an)X 3154(error)X 3341(occurred,)X 3673(one)X 3819(should)X 576 5568(always)N 830(supply)X 1074(an)X 0 f 1209(error)X 1 f 1480(parameter)X 1833(or)X 1931(have)X 2114(arranged)X 2427(to)X 2520(have)X 2704(an)X 2812(error)X 3001(handling)X 3313(function)X 3612(invoked)X 3902(\(see)X 0 f 576 5664(dwarf_init\(\))N 1 f (\))S 1209(to)X 1301(determine)X 1652(the)X 1780(validity)X 2054(of)X 2151(the)X 2279(returned)X 2577(value)X 2781(and)X 2927(the)X 3055(nature)X 3286(of)X 3383(any)X 3528(errors)X 3745(that)X 3894(may)X 576 5760(have)N 748(occurred.)X 576 5952(A)N 0 f 740(Dwarf_Attribute)X 1 f 1539(descriptor)X 1939(describes)X 2317(an)X 2472(attribute)X 2818(of)X 2964(a)X 3079(specific)X 3408(die.)X 3625(Thus,)X 3884(each)X 576 6183(rev)N 699(1.61,)X 879(3)X 939(Apr)X 1084(2006)X 2217(-)X 2264(22)X 2364(-)X 23 p %%Page: 23 23 0(Courier)xf 0 f 10 s 0 xH 0 xS 0 f 1 f 2217 384(-)N 2264(23)X 2364(-)X 0 f 576 768(Dwarf_Attribute)N 1 f 1316(descriptor)X 1657(is)X 1730(implicitly)X 2060(associated)X 2410(with)X 2572(a)X 2628(specific)X 2898(die.)X 3 f 576 1008(5.4.1)N 776(dwarf_hasform\(\))X 0 f 576 1152(nt)N 720(dwarf_hasform\()X 960 1248(Dwarf_Attribute)N 1728(attr,)X 960 1344(Dwarf_Half)N 1488(form,)X 960 1440(Dwarf_Bool)N 1536(*return_hasform,)X 960 1536(Dwarf_Error)N 1536(*error\))X 1 f 576 1680(The)N 721(function)X 0 f 1036(dwarf_hasform\(\))X 1 f 1776(returns)X 0 f 2047(DW_DLV_OK)X 1 f 2499(and)X 2655(and)X 2791(puts)X 2944(a)X 2 f 3000(non-zero)X 1 f 596 1776(value)N 805(in)X 902(the)X 0 f 1063(*return_hasform)X 1 f 1818(boolean)X 2107(if)X 2191(the)X 2324(attribute)X 2627(represented)X 3034(by)X 3150(the)X 0 f 3312(Dwarf_Attribute)X 1 f 576 1872(descriptor)N 0 f 954(attr)X 1 f 1175(has)X 1311(the)X 1438(attribute)X 1734(form)X 0 f 1947(form)X 1 f (.)S 2208(If)X 2291(the)X 2418(attribute)X 2714(does)X 2889(not)X 3019(have)X 3199(that)X 3347(form)X 2 f 3531(zero)X 1 f 3697(is)X 3778(put)X 3908(into)X 0 f 576 1968(*return_hasform)N 1 f (.)S 0 f 1412(DW_DLV_ERROR)X 1 f 2008(is)X 2081(returned)X 2369(on)X 2469(error.)X 3 f 576 2208(5.4.2)N 776(dwarf_whatform\(\))X 0 f 576 2352(int)N 768(dwarf_whatform\()X 960 2448(Dwarf_Attribute)N 1728(attr,)X 960 2544(Dwarf_Half)N 1680(*return_form,)X 960 2640(Dwarf_Error)N 1536(*error\))X 1 f 576 2784(When)N 811(it)X 898(succeeds,)X 0 f 1275(dwarf_whatform\(\))X 1 f 2086(returns)X 0 f 2380(DW_DLV_OK)X 1 f 2856(and)X 3016(sets)X 0 f 3208(*return_form)X 1 f 3828(to)X 3934(the)X 576 2880(attribute)N 866(form)X 1045(code)X 1220(of)X 1310(the)X 1431(attribute)X 1721(represented)X 2115(by)X 2218(the)X 0 f 2367(Dwarf_Attribute)X 1 f 3110(descriptor)X 0 f 3482(attr)X 1 f (.)S 3737(It)X 3809(returns)X 0 f 576 2976(DW_DLV_ERROR)N 1 f 1210(on)X 1328(error.)X 1563(An)X 1699(attribute)X 2004(using)X 2215(DW_FORM_indirect)X 2938(effectively)X 3320(has)X 3465(two)X 3624(forms.)X 3890(This)X 576 3072(function)N 869(returns)X 1118(the)X 1242('final')X 1469(form)X 1651(for)X 0 f 1799(DW_FORM_indirect)X 1 f (,)S 2613(not)X 2741(the)X 0 f 2892(DW_FORM_indirect)X 1 f 3685(itself.)X 3890(This)X 576 3168(function)N 863(is)X 936(what)X 1112(most)X 1287(applications)X 1694(will)X 1838(want)X 2014(to)X 2096(call.)X 3 f 576 3408(5.4.3)N 776 0.1761(dwarf_whatform_direct\(\))AX 0 f 576 3552(int)N 768(dwarf_whatform_direct\()X 960 3648(Dwarf_Attribute)N 1728(attr,)X 960 3744(Dwarf_Half)N 1680(*return_form,)X 960 3840(Dwarf_Error)N 1536(*error\))X 1 f 576 3984(When)N 789(it)X 855(succeeds,)X 0 f 1211(dwarf_whatform_direct\(\))X 1 f 2337(returns)X 0 f 2610(DW_DLV_OK)X 1 f 3064(and)X 3202(sets)X 0 f 3372(*return_form)X 1 f 3970(to)X 576 4080(the)N 707(attribute)X 1007(form)X 1196(code)X 1381(of)X 1481(the)X 1612(attribute)X 1912(represented)X 2316(by)X 2428(the)X 0 f 2586(Dwarf_Attribute)X 1 f 3338(descriptor)X 0 f 3719(attr)X 1 f (.)S 3983(It)X 576 4176(returns)N 0 f 887(DW_DLV_ERROR)X 1 f 1523(on)X 1643(error.)X 1881(An)X 2020(attribute)X 2328(using)X 0 f 2570(DW_FORM_indirect)X 1 f 3379(effectively)X 3764(has)X 3912(two)X 576 4272(forms.)N 860(This)X 1059(returns)X 1339(the)X 1494(form)X 1707('directly')X 2063(in)X 2182(the)X 2337(initial)X 2580(form)X 2793(field.)X 3037(So)X 3178(when)X 3409(the)X 3564(form)X 3776(field)X 3979(is)X 0 f 576 4368(DW_FORM_indirect)N 1 f 1369(this)X 1509(call)X 1650(returns)X 1899(the)X 0 f 2051(DW_FORM_indirect)X 1 f 2845(form,)X 3047(which)X 3269(is)X 3348(sometimes)X 3716(useful)X 3938(for)X 576 4464(dump)N 778(utilities.)X 3 f 576 4704(5.4.4)N 776(dwarf_whatattr\(\))X 0 f 576 4848(int)N 768(dwarf_whatattr\()X 960 4944(Dwarf_Attribute)N 1728(attr,)X 960 5040(Dwarf_Half)N 1680(*return_attr,)X 960 5136(Dwarf_Error)N 1536(*error\))X 1 f 576 5280(When)N 811(it)X 898(succeeds,)X 0 f 1275(dwarf_whatattr\(\))X 1 f 2086(returns)X 0 f 2380(DW_DLV_OK)X 1 f 2856(and)X 3016(sets)X 0 f 3208(*return_attr)X 1 f 3828(to)X 3934(the)X 576 5376(attribute)N 870(code)X 1049(represented)X 1447(by)X 1553(the)X 0 f 1705(Dwarf_Attribute)X 1 f 2451(descriptor)X 0 f 2826(attr)X 1 f (.)S 3084(It)X 3159(returns)X 0 f 3456(DW_DLV_ERROR)X 1 f 576 5472(on)N 676(error.)X 3 f 576 5712(5.4.5)N 776 0.2857(dwarf_formref\(\))AX 1 f 576 6183(rev)N 699(1.61,)X 879(3)X 939(Apr)X 1084(2006)X 2217(-)X 2264(23)X 2364(-)X 24 p %%Page: 24 24 0(Courier)xf 0 f 10 s 0 xH 0 xS 0 f 1 f 2217 384(-)N 2264(24)X 2364(-)X 0 f 576 768(int)N 768(dwarf_formref\()X 960 864(Dwarf_Attribute)N 1728(attr,)X 960 960(Dwarf_Off)N 1632(*return_offset,)X 960 1056(Dwarf_Error)N 1536(*error\))X 1 f 576 1200(When)N 790(it)X 856(succeeds,)X 0 f 1212(dwarf_formref\(\))X 1 f 1954(returns)X 0 f 2228(DW_DLV_OK)X 1 f 2683(and)X 2822(sets)X 0 f 2993(*return_offset)X 1 f 3688(to)X 3773(the)X 3894(CU-)X 576 1296(relative)N 839(offset)X 1044(represented)X 1436(by)X 1537(the)X 1656(descriptor)X 0 f 2026(attr)X 1 f 2239(if)X 2309(the)X 2428(form)X 2605(of)X 2693(the)X 2812(attribute)X 3100(belongs)X 3370(to)X 3453(the)X 0 f 3600(REFERENCE)X 1 f 576 1392(class.)N 0 f 850(attr)X 1 f 1064(must)X 1241(be)X 1339(a)X 1397(CU-local)X 1713 0.4028(reference,)AX 2056(not)X 2180(form)X 0 f 2386(DW_FORM_ref_addr)X 1 f (.)S 3216(It)X 3287(is)X 3362(an)X 3460(error)X 3639(for)X 3755(the)X 3876(form)X 576 1488(to)N 666(not)X 796(belong)X 1042(to)X 1132(this)X 1275(class)X 1459(or)X 1553(to)X 1642(be)X 1745(form)X 0 f 1956(DW_FORM_ref_addr)X 1 f (.)S 2791(It)X 2867(returns)X 0 f 3145(DW_DLV_ERROR)X 1 f 3748(on)X 3855(error.)X 576 1584(See)N 712(also)X 0 f 889(dwarf_global_formref)X 1 f 1869(below.)X 3 f 576 1824(5.4.6)N 776(dwarf_global_formref\(\))X 0 f 576 1968(int)N 768(dwarf_global_formref\()X 960 2064(Dwarf_Attribute)N 1728(attr,)X 960 2160(Dwarf_Off)N 1632(*return_offset,)X 960 2256(Dwarf_Error)N 1536(*error\))X 1 f 576 2400(When)N 794(it)X 864(succeeds,)X 0 f 1224(dwarf_global_formref\(\))X 1 f 2306(returns)X 0 f 2583(DW_DLV_OK)X 1 f 3042(and)X 3185(sets)X 0 f 3360(*return_offset)X 1 f 576 2496(to)N 666(the)X 792(.debug_info-section-relative)X 1727(offset)X 1937(represented)X 2335(by)X 2442(the)X 2567(descriptor)X 0 f 2943(attr)X 1 f 3162(if)X 3238(the)X 3363(form)X 3546(of)X 3640(the)X 3765(attribute)X 576 2592(belongs)N 871(to)X 979(the)X 0 f 1152(REFERENCE)X 1 f 1631(class.)X 0 f 1930(attr)X 1 f 2169(can)X 2328(be)X 2451(any)X 2614(legal)X 0 f 2845(REFERENCE)X 1 f 3324(class)X 3527(form)X 3730(including)X 0 f 576 2688(DW_FORM_ref_addr)N 1 f (.)S 1405(It)X 1475(is)X 1549(an)X 1646(error)X 1824(for)X 1939(the)X 2058(form)X 2235(to)X 2318(not)X 2441(belong)X 2680(to)X 2763(this)X 2899(class.)X 3116(It)X 3185(returns)X 0 f 3456(DW_DLV_ERROR)X 1 f 576 2784(on)N 676(error.)X 893(See)X 1029(also)X 0 f 1206(dwarf_formref)X 1 f 1850(above.)X 3 f 576 3024(5.4.7)N 776(dwarf_formaddr\(\))X 0 f 576 3168(int)N 768(dwarf_formaddr\()X 960 3264(Dwarf_Attribute)N 1728(attr,)X 960 3360(Dwarf_Addr)N 1632(*)X 1728(return_addr,)X 960 3456(Dwarf_Error)N 1536(*error\))X 1 f 576 3600(When)N 811(it)X 898(succeeds,)X 0 f 1275(dwarf_formaddr\(\))X 1 f 2086(returns)X 0 f 2380(DW_DLV_OK)X 1 f 2856(and)X 3016(sets)X 0 f 3208(*return_addr)X 1 f 3828(to)X 3934(the)X 576 3696(address)N 839(represented)X 1232(by)X 1334(the)X 1454(descriptor)X 0 f 1825(attr)X 1 f 2039(if)X 2110(the)X 2230(form)X 2408(of)X 2497(the)X 2617(attribute)X 2906(belongs)X 3177(to)X 3261(the)X 0 f 3409(ADDRESS)X 1 f 3766(class.)X 3983(It)X 576 3792(is)N 649(an)X 745(error)X 922(for)X 1036(the)X 1154(form)X 1330(to)X 1412(not)X 1534(belong)X 1772(to)X 1854(this)X 1989(class.)X 2205(It)X 2274(returns)X 0 f 2545(DW_DLV_ERROR)X 1 f 3141(on)X 3241(error.)X 3 f 576 4032(5.4.8)N 776(dwarf_formflag\(\))X 0 f 576 4176(int)N 768(dwarf_formflag\()X 960 4272(Dwarf_Attribute)N 1728(attr,)X 960 4368(Dwarf_Bool)N 1488(*)X 1584(return_bool,)X 960 4464(Dwarf_Error)N 1536(*error\))X 1 f 576 4608(When)N 790(it)X 856(succeeds,)X 0 f 1212(dwarf_formflag\(\))X 1 f 2002(returns)X 0 f 2275(DW_DLV_OK)X 1 f 2729(and)X 2867(sets)X 0 f 3037(*return_bool)X 3663(1)X 1 f 3733(\(i.e.)X 3880(true\))X 576 4704(\(if)N 689(the)X 824(attribute)X 1128(has)X 1272(a)X 1345(non-zero)X 1668(value\))X 1906(or)X 0 f 2038(0)X 1 f 2123(\(i.e.)X 2285(false\))X 2501(\(if)X 2614(the)X 2749(attribute)X 3053(has)X 3197(a)X 3270(zero)X 3446(value\).)X 3724(It)X 3809(returns)X 0 f 576 4800(DW_DLV_ERROR)N 1 f 1172(on)X 1272(error)X 1449(or)X 1536(if)X 1605(the)X 0 f 1751(attr)X 1 f 1963(does)X 2130(not)X 2252(have)X 2424(form)X 2600(flag.)X 3 f 576 5040(5.4.9)N 776(dwarf_formudata\(\))X 0 f 576 5184(int)N 768(dwarf_formudata\()X 960 5280(Dwarf_Attribute)N 1824(attr,)X 960 5376(Dwarf_Unsigned)N 1728(*)X 1824(return_uvalue,)X 960 5472(Dwarf_Error)N 1728(*)X 1824(error\))X 1 f 576 5616(The)N 750(function)X 0 f 1094(dwarf_formudata\(\))X 1 f 1959(returns)X 0 f 2259(DW_DLV_OK)X 1 f 2740(and)X 2905(sets)X 0 f 3102(*return_uvalue)X 1 f 3823(to)X 3934(the)X 0 f 576 5712(Dwarf_Unsigned)N 1 f 1272(value)X 1470(of)X 1561(the)X 1683(attribute)X 1974(represented)X 2369(by)X 2473(the)X 2595(descriptor)X 0 f 2967(attr)X 1 f 3182(if)X 3254(the)X 3375(form)X 3554(of)X 3644(the)X 3765(attribute)X 576 5808(belongs)N 863(to)X 963(the)X 0 f 1127(CONSTANT)X 1 f 1549(class.)X 1783(It)X 1870(is)X 1961(an)X 2075(error)X 2270(for)X 2402(the)X 2538(form)X 2732(to)X 2833(not)X 2974(belong)X 3231(to)X 3332(this)X 3486(class.)X 3721(It)X 3809(returns)X 0 f 576 5904(DW_DLV_ERROR)N 1 f 1172(on)X 1272(error.)X 576 6183(rev)N 699(1.61,)X 879(3)X 939(Apr)X 1084(2006)X 2217(-)X 2264(24)X 2364(-)X 25 p %%Page: 25 25 0(Courier)xf 0 f 10 s 0 xH 0 xS 0 f 1 f 2217 384(-)N 2264(25)X 2364(-)X 3 f 576 768(5.4.10)N 816(dwarf_formsdata\(\))X 0 f 576 912(int)N 768(dwarf_formsdata\()X 960 1008(Dwarf_Attribute)N 1728(attr,)X 960 1104(Dwarf_Signed)N 1632(*)X 1728(return_svalue,)X 960 1200(Dwarf_Error)N 1536(*error\))X 1 f 576 1344(The)N 750(function)X 0 f 1094(dwarf_formsdata\(\))X 1 f 1959(returns)X 0 f 2259(DW_DLV_OK)X 1 f 2740(and)X 2905(sets)X 0 f 3102(*return_svalue)X 1 f 3823(to)X 3934(the)X 0 f 576 1440(Dwarf_Signed)N 1 f 1182(value)X 1386(of)X 1483(the)X 1611(attribute)X 1908(represented)X 2309(by)X 2419(the)X 2547(descriptor)X 0 f 2926(attr)X 1 f 3148(if)X 3227(the)X 3355(form)X 3541(of)X 3638(the)X 3765(attribute)X 576 1536(belongs)N 850(to)X 937(the)X 0 f 1088(CONSTANT)X 1 f 1497(class.)X 1718(It)X 1792(is)X 1870(an)X 1971(error)X 2153(for)X 2272(the)X 2395(form)X 2576(to)X 2663(not)X 2791(belong)X 3035(to)X 3123(this)X 3264(class.)X 3486(If)X 3566(the)X 3690(size)X 3841(of)X 3934(the)X 576 1632(data)N 735(attribute)X 1027 0.4028(referenced)AX 1393(is)X 1471(smaller)X 1732(than)X 1895(the)X 2018(size)X 2168(of)X 2259(the)X 0 f 2409(Dwarf_Signed)X 1 f 3009(type,)X 3191(its)X 3290(value)X 3488(is)X 3565(sign)X 3722(extended.)X 576 1728(It)N 645(returns)X 0 f 916(DW_DLV_ERROR)X 1 f 1512(on)X 1612(error.)X 3 f 576 1968(5.4.11)N 816(dwarf_formblock\(\))X 0 f 576 2112(int)N 768(dwarf_formblock\()X 960 2208(Dwarf_Attribute)N 1728(attr,)X 960 2304(Dwarf_Block)N 1584(**)X 1728(return_block,)X 960 2400(Dwarf_Error)N 1536(*)X 1728(error\))X 1 f 576 2544(The)N 724(function)X 0 f 1042(dwarf_formblock\(\))X 1 f 1882(returns)X 0 f 2157(DW_DLV_OK)X 1 f 2613(and)X 2753(sets)X 0 f 2925(*return_block)X 1 f 3573(to)X 3659(a)X 3719(pointer)X 3970(to)X 576 2640(a)N 0 f 661(Dwarf_Block)X 1 f 1210(structure)X 1512(containing)X 1871(the)X 1989(value)X 2183(of)X 2270(the)X 2388(attribute)X 2675(represented)X 3066(by)X 3166(the)X 3284(descriptor)X 0 f 3653(attr)X 1 f 3865(if)X 3934(the)X 576 2736(form)N 759(of)X 853(the)X 978(attribute)X 1272(belongs)X 1548(to)X 1637(the)X 0 f 1790(BLOCK)X 1 f 2057(class.)X 2280(It)X 2356(is)X 2436(an)X 2540(error)X 2725(for)X 2847(the)X 2973(form)X 3157(to)X 3247(not)X 3377(belong)X 3623(to)X 3713(this)X 3856(class.)X 576 2832(The)N 737(storage)X 1005(pointed)X 1281(to)X 1379(by)X 1495(a)X 1566(successful)X 1931(return)X 2158(of)X 0 f 2288(dwarf_formblock\(\))X 1 f 3139(should)X 3387(be)X 3498(free'd)X 3726(using)X 3934(the)X 576 2928(allocation)N 926(type)X 0 f 1126(DW_DLA_BLOCK)X 1 f (,)S 1776(when)X 1984(no)X 2098(longer)X 2337(of)X 2439(interest)X 2710(\(see)X 0 f 2903(dwarf_dealloc\(\))X 1 f (\).)S 3725(It)X 3809(returns)X 0 f 576 3024(DW_DLV_ERROR)N 1 f 1172(on)X 1272(error.)X 3 f 576 3264(5.4.12)N 816(dwarf_formstring\(\))X 0 f 576 3552(int)N 768(dwarf_formstring\()X 960 3648(Dwarf_Attribute)N 1728(attr,)X 960 3744(char)N 1536(**)X 1728(return_string,)X 960 3840(Dwarf_Error)N 1536(*error\))X 1 f 576 3984(The)N 723(function)X 0 f 1040(dwarf_formstring\(\))X 1 f 1927(returns)X 0 f 2201(DW_DLV_OK)X 1 f 2656(and)X 2795(sets)X 0 f 2966(*return_string)X 1 f 3661(to)X 3746(a)X 3805(pointer)X 576 4080(to)N 662(a)X 722(null-terminated)X 1240(string)X 1446(containing)X 1828(the)X 1950(value)X 2148(of)X 2239(the)X 2361(attribute)X 2652(represented)X 3047(by)X 3151(the)X 3273(descriptor)X 0 f 3646(attr)X 1 f 3862(if)X 3934(the)X 576 4176(form)N 757(of)X 849(the)X 972(attribute)X 1264(belongs)X 1538(to)X 1625(the)X 0 f 1776(STRING)X 1 f 2089(class.)X 2310(It)X 2384(is)X 2462(an)X 2563(error)X 2745(for)X 2864(the)X 2987(form)X 3168(to)X 3255(not)X 3383(belong)X 3627(to)X 3715(this)X 3856(class.)X 576 4272(The)N 734(storage)X 999(pointed)X 1272(to)X 1366(by)X 1478(a)X 1546(successful)X 1908(return)X 2132(of)X 0 f 2259(dwarf_formstring\(\))X 1 f 3155(should)X 3400(not)X 3534(be)X 3642(free'd.)X 3907(The)X 576 4368(pointer)N 847(points)X 1086(into)X 1254(existing)X 1551(DWARF)X 1885(memory)X 2197(and)X 2358(the)X 2501(pointer)X 2773(becomes)X 3099(stale/invalid)X 3535(after)X 3728(a)X 3809(call)X 3970(to)X 0 f 576 4464(dwarf_finish)N 1 f (.)S 0 f 1268(dwarf_formstring\(\))X 1 f 2152(returns)X 0 f 2423(DW_DLV_ERROR)X 1 f 3019(on)X 3119(error.)X 3 f 9 s 576 4704(5.4.12.1)N 846(dwarf_loclist_n\(\))X 0 f 10 s 576 4848(int)N 768(dwarf_loclist_n\()X 960 4944(Dwarf_Attribute)N 1728(attr,)X 960 5040(Dwarf_Locdesc)N 1632(***llbuf,)X 960 5136(Dwarf_Signed)N 1632(*listlen,)X 960 5232(Dwarf_Error)N 1536(*error\))X 1 f 576 5376(The)N 724(function)X 0 f 1042(dwarf_loclist_n\(\))X 1 f 1881(sets)X 0 f 2052(*llbuf)X 1 f 2363(to)X 2448(point)X 2635(to)X 2720(an)X 2819(array)X 3008(of)X 0 f 3126(Dwarf_Locdesc)X 1 f 3774(pointers)X 576 5472(corresponding)N 1059(to)X 1145(each)X 1317(of)X 1408(the)X 1530(location)X 1812(expressions)X 2209(in)X 2294(a)X 2353(location)X 2634(list,)X 2774(and)X 2913(sets)X 0 f 3084(*listlen)X 1 f 3491(to)X 3576(the)X 3697(number)X 3965(of)X 576 5568(elements)N 881(in)X 963(the)X 1081(array)X 1267(and)X 1403(returns)X 0 f 1674(DW_DLV_OK)X 1 f 2126(if)X 2195(the)X 2313(attribute)X 2600(is)X 2673(appropriate.)X 576 5712(This)N 743(is)X 821(the)X 944(preferred)X 1265(function)X 1557(for)X 1676 0.2708(Dwarf_Locdesc)AX 2215(as)X 2307(it)X 2376(is)X 2454(the)X 2577(interface)X 2884(allowing)X 3189(access)X 3420(to)X 3507(an)X 3608(entire)X 3817(loclist.)X 576 5808(\(use)N 731(of)X 0 f 847(dwarf_loclist_n\(\))X 1 f 1684(is)X 1758(suggested)X 2095(as)X 2183(the)X 2302(better)X 2506(interface,)X 2829(though)X 0 f 3100(dwarf_loclist\(\))X 1 f 3840(is)X 3913(still)X 576 5904(supported.\))N 576 6183(rev)N 699(1.61,)X 879(3)X 939(Apr)X 1084(2006)X 2217(-)X 2264(25)X 2364(-)X 26 p %%Page: 26 26 0(Courier)xf 0 f 10 s 0 xH 0 xS 0 f 1 f 2217 384(-)N 2264(26)X 2364(-)X 576 768(It)N 679(returns)X 0 f 984(DW_DLV_ERROR)X 1 f 1614(on)X 1748(error.)X 0 f 2055(dwarf_loclist_n\(\))X 1 f 2926(works)X 3177(on)X 0 f 3340(DW_AT_location)X 1 f (,)S 0 f 576 864(DW_AT_data_member_location)N 1 f (,)S 0 f 2764(DW_AT_vtable_elem_location)X 1 f (,)S 0 f 576 960(DW_AT_string_length)N 1 f (,)S 0 f 1556(DW_AT_use_location)X 1 f (,)S 2460(and)X 0 f 2624(DW_AT_return_addr)X 1 f 3460(attributes.)X 576 1104(Storage)N 846(allocated)X 1161(by)X 1266(a)X 1327(successful)X 1683(call)X 1825(of)X 0 f 1946(dwarf_loclist_n\(\))X 1 f 2788(should)X 3027(be)X 3129(deallocated)X 3521(when)X 3721(no)X 3827(longer)X 576 1200(of)N 666(interest)X 925(\(see)X 0 f 1106(dwarf_dealloc\(\))X 1 f (\).)S 1916(The)X 2064(block)X 2265(of)X 0 f 2383(Dwarf_Loc)X 1 f 2838(structs)X 3070(pointed)X 3333(to)X 3418(by)X 3521(the)X 0 f 3670(ld_s)X 1 f 3885(field)X 576 1296(of)N 738(each)X 0 f 1010(Dwarf_Locdesc)X 1 f 1730(structure)X 2107(should)X 2416(be)X 2588(deallocated)X 3050(with)X 3288(the)X 3482(allocation)X 3894(type)X 0 f 576 1392(DW_DLA_LOC_BLOCK)N 1 f (.)S 1411(and)X 1574(the)X 0 f 1727(llbuf[])X 1 f 2090(space)X 2296(pointed)X 2563(to)X 2651(should)X 2890(be)X 2992(deallocated)X 3384(with)X 3552(allocation)X 3894(type)X 0 f 576 1488(DW_DLA_LOCDESC)N 1 f (.)S 1318(This)X 1490(should)X 1733(be)X 1839(followed)X 2154(by)X 2265(deallocation)X 2688(of)X 2786(the)X 0 f 2943(llbuf)X 1 f 3214(using)X 3418(the)X 3547(allocation)X 3894(type)X 0 f 576 1584(DW_DLA_LIST)N 1 f (.)S 0 f 736 1728(Dwarf_Signed)N 1360(lcnt;)X 736 1824(Dwarf_Locdesc)N 1408(**llbuf;)X 736 1920(int)N 928(lres;)X 736 2112(lres)N 976(=)X 1072(dwarf_loclist_n\(someattr,)X 2320(&llbuf,&lcnt)X 2944(&error\);)X 736 2208(if)N 880(\(lres)X 1168(==)X 1312(DW_DLV_OK\))X 1840({)X 1120 2304(for)N 1312(\(i)X 1456(=)X 1552(0;)X 1696(i)X 1792(<)X 1888(lcnt;)X 2176(++i\))X 2416({)X 1312 2400(/*)N 1456(use)X 1648(llbuf[i])X 2080(*/)X 1312 2592(dwarf_dealloc\(dbg,)N 2224(llbuf[i]->ld_s,)X 2992(DW_DLA_LOC_BLOCK\);)X 1312 2688(dwarf_dealloc\(dbg,llbuf[i],)N 2656(DW_DLA_LOCDESC\);)X 1120 2784(})N 1120 2880(dwarf_dealloc\(dbg,)N 2032(llbuf,)X 2368(DW_DLA_LIST\);)X 736 2976(})N 3 f 9 s 576 3264(5.4.12.2)N 846(dwarf_loclist\(\))X 0 f 10 s 576 3408(int)N 768(dwarf_loclist\()X 960 3504(Dwarf_Attribute)N 1728(attr,)X 960 3600(Dwarf_Locdesc)N 1632(**llbuf,)X 960 3696(Dwarf_Signed)N 1632(*listlen,)X 960 3792(Dwarf_Error)N 1536(*error\))X 1 f 576 3936(The)N 723(function)X 0 f 1040(dwarf_loclist\(\))X 1 f 1782(sets)X 0 f 1952(*llbuf)X 1 f 2262(to)X 2347(point)X 2534(to)X 2619(a)X 0 f 2706(Dwarf_Locdesc)X 1 f 3353(pointer)X 3603(for)X 3720(the)X 3841(single)X 576 4032(location)N 864(expression)X 1237(it)X 1311(can)X 1453(return.)X 1715(It)X 1794(sets)X 0 f 1972(*listlen)X 1 f 2386(to)X 2478(1.)X 2588(and)X 2734(returns)X 0 f 3015(DW_DLV_OK)X 1 f 3477(if)X 3556(the)X 3683(attribute)X 3979(is)X 576 4128(appropriate.)N 576 4272(It)N 649(is)X 727(less)X 872(flexible)X 1142(than)X 0 f 1333(dwarf_loclist_n\(\))X 1 f 2174(in)X 2261(that)X 0 f 2434(dwarf_loclist\(\))X 1 f 3179(can)X 3316(handle)X 3555(a)X 3616(maximum)X 3965(of)X 576 4368(one)N 715(location)X 995(expression,)X 1380(not)X 1504(a)X 1562(full)X 1695(location)X 1975(list.)X 2134(If)X 2210(a)X 2268(location-list)X 2672(is)X 2747(present)X 3001(it)X 3067(returns)X 3312(only)X 3476(the)X 3596(first)X 3747(location-)X 576 4464(list)N 693(entry)X 878(location)X 1156(description.)X 1572(Use)X 0 f 1745(dwarf_loclist_n\(\))X 1 f 2581(instead.)X 576 4608(It)N 691(returns)X 0 f 1008(DW_DLV_ERROR)X 1 f 1650(on)X 1796(error.)X 0 f 2115(dwarf_loclist\(\))X 1 f 2902(works)X 3165(on)X 0 f 3340(DW_AT_location)X 1 f (,)S 0 f 576 4704(DW_AT_data_member_location)N 1 f (,)S 0 f 2764(DW_AT_vtable_elem_location)X 1 f (,)S 0 f 576 4800(DW_AT_string_length)N 1 f (,)S 0 f 1556(DW_AT_use_location)X 1 f (,)S 2460(and)X 0 f 2624(DW_AT_return_addr)X 1 f 3460(attributes.)X 576 4944(Storage)N 846(allocated)X 1162(by)X 1268(a)X 1330(successful)X 1686(call)X 1828(of)X 0 f 1949(dwarf_loclist\(\))X 1 f 2695(should)X 2934(be)X 3036(deallocated)X 3428(when)X 3628(no)X 3734(longer)X 3965(of)X 576 5040(interest)N 835(\(see)X 0 f 1016(dwarf_dealloc\(\))X 1 f (\).)S 1826(The)X 1974(block)X 2175(of)X 0 f 2293(Dwarf_Loc)X 1 f 2748(structs)X 2980(pointed)X 3243(to)X 3328(by)X 3431(the)X 0 f 3580(ld_s)X 1 f 3795(field)X 3965(of)X 576 5136(each)N 0 f 773(Dwarf_Locdesc)X 1 f 1418(structure)X 1720(should)X 1954(be)X 2051(deallocated)X 2438(with)X 2601(the)X 2720(allocation)X 3057(type)X 0 f 3244(DW_DLA_LOC_BLOCK)X 1 f (.)S 576 5232(This)N 738(should)X 971(be)X 1067(followed)X 1372(by)X 1472(deallocation)X 1884(of)X 1971(the)X 0 f 2117(llbuf)X 1 f 2377(using)X 2570(the)X 2688(allocation)X 3024(type)X 0 f 3210(DW_DLA_LOCDESC)X 1 f (.)S 576 6183(rev)N 699(1.61,)X 879(3)X 939(Apr)X 1084(2006)X 2217(-)X 2264(26)X 2364(-)X 27 p %%Page: 27 27 0(Courier)xf 0 f 10 s 0 xH 0 xS 0 f 1 f 2217 384(-)N 2264(27)X 2364(-)X 0 f 736 768(Dwarf_Signed)N 1360(lcnt;)X 736 864(Dwarf_Locdesc)N 1408(*llbuf;)X 736 960(int)N 928(lres;)X 736 1152(lres)N 976(=)X 1072(dwarf_loclist\(someattr,)X 2224(&llbuf,&lcnt)X 2848(&error\);)X 736 1248(if)N 880(\(lres)X 1168(==)X 1312(DW_DLV_OK\))X 1840({)X 1120 1344(/*)N 1264(lcnt)X 1504(is)X 1648(always)X 1984(1,)X 2128(\(and)X 2368(has)X 2560(always)X 2896(been)X 3136(1\))X 3280(*/)X 3424(*/)X 1120 1440(/*)N 1264(use)X 1456(llbuf)X 1744(*/)X 1120 1632(dwarf_dealloc\(dbg,)N 2032(llbuf->ld_s,)X 2656(DW_DLA_LOC_BLOCK\);)X 1120 1728(dwarf_dealloc\(dbg,)N 2032(llbuf,)X 2368(DW_DLA_LOCDESC\);)X 736 1824(/*)N 1120(Earlier)X 1504(version.)X 1936(It)X 2080(works)X 2368(because)X 2752(lcnt)X 2992(is)X 3136(always)X 3472(1.)X 736 1920(*)N 1216(for)X 1408(\(i)X 1552(=)X 1648(0;)X 1792(i)X 1888(<)X 1984(lcnt;)X 2272(++i\))X 2512({)X 736 2016(*)N 1408(/*)X 1552(use)X 1744(llbuf[i])X 2176(*/)X 736 2112(*)N 736 2208(*)N 1408(/*)X 1552(Deallocate)X 2080(Dwarf_Loc)X 2560(block)X 2848(of)X 2992(llbuf[i])X 3424(*/)X 736 2304(*)N 1408(dwarf_dealloc\(dbg,)X 2320(llbuf[i].ld_s,)X 3040(DW_DLA_LOC_BLOCK\);)X 736 2400(*)N 1216(})X 736 2496(*)N 1216(dwarf_dealloc\(dbg,)X 2128(llbuf,)X 2464(DW_DLA_LOCDESC\);)X 736 2592(*/)N 736 2784(})N 3 f 11 s 576 3072(5.5)N 730(Line)X 924(Number)X 1258(Operations)X 1 f 10 s 576 3216(These)N 795(functions)X 1120(are)X 1246(concerned)X 1604(with)X 1773(accessing)X 2108(line)X 2255(number)X 2527(entries,)X 2788(mapping)X 3095(debugging)X 3461(information)X 3867(entry)X 576 3312(objects)N 823(to)X 905(their)X 1072(corresponding)X 1551(source)X 1781(lines,)X 1972(and)X 2108(providing)X 2439(a)X 2495(mechanism)X 2880(for)X 2994(obtaining)X 3316(information)X 3714(about)X 3912(line)X 576 3408(number)N 844(entries.)X 1121(Although,)X 1466(the)X 1587(interface)X 1892(talks)X 2066(of)X 2156("lines")X 2396(what)X 2575(is)X 2651(really)X 2857(meant)X 3076(is)X 3152("statements".)X 3619(In)X 3709(case)X 3871(there)X 576 3504(is)N 652(more)X 839(than)X 999(one)X 1137(statement)X 1466(on)X 1568(the)X 1688(same)X 1875(line,)X 2037(there)X 2220(will)X 2366(be)X 2464(at)X 2544(least)X 2713(one)X 2851(descriptor)X 3194(per)X 3319(statement,)X 3668(all)X 3770(with)X 3934(the)X 576 3600(same)N 765(line)X 909(number.)X 1219(If)X 1298(column)X 1563(number)X 1833(is)X 1911(also)X 2065(being)X 2268(represented)X 2664(they)X 2827(will)X 2976(have)X 3153(the)X 3276(column)X 3541(numbers)X 3842(of)X 3934(the)X 576 3696(start)N 734(of)X 821(the)X 939(statements)X 1297(also)X 1446(represented.)X 576 3840(There)N 792(can)X 932(also)X 1089(be)X 1193(more)X 1386(than)X 1552(one)X 1696(Dwarf_Line)X 2117(per)X 2248(statement.)X 2623(For)X 2762(example,)X 3082(if)X 3159(a)X 3223(file)X 3358(is)X 3439(preprocessed)X 3887(by)X 3996(a)X 576 3936(language)N 902(translator,)X 1261(this)X 1412(could)X 1626(result)X 1840(in)X 1938(translator)X 2277(output)X 2517(showing)X 2824(2)X 2900(or)X 3003(more)X 3204(sets)X 3360(of)X 3463(line)X 3618(numbers)X 3929(per)X 576 4032(translated)N 908(line)X 1048(of)X 1135(output.)X 3 f 576 4272(5.5.1)N 776(Get)X 921(A)X 999(Set)X 1126(of)X 1213(Lines)X 1 f 576 4416(The)N 754(function)X 1074(returns)X 1350(information)X 1781(about)X 2012(every)X 2244(source)X 2507(line)X 2680(for)X 2828(a)X 2918(particular)X 3280(compilation-unit.)X 3907(The)X 576 4512(compilation-unit)N 1129(is)X 1202(specified)X 1512(by)X 1612(the)X 1730(corresponding)X 2209(die.)X 3 f 9 s 576 4656(5.5.1.1)N 810(dwarf_srclines\(\))X 0 f 10 s 576 4800(int)N 768(dwarf_srclines\()X 960 4896(Dwarf_Die)N 1440(die,)X 960 4992(Dwarf_Line)N 1488(**linebuf,)X 960 5088(Dwarf_Signed)N 1584(*linecount,)X 960 5184(Dwarf_Error)N 1536(*error\))X 1 f 576 5328(The)N 721(function)X 0 f 1036(dwarf_srclines\(\))X 1 f 1824(places)X 2045(all)X 2145(line)X 2285(number)X 2550(descriptors)X 2922(for)X 3036(a)X 3092(single)X 3303(compilation)X 3706(unit)X 3851(into)X 3996(a)X 576 5424(single)N 793(block,)X 1017(sets)X 0 f 1191(*linebuf)X 1 f 1601(to)X 1689(point)X 1879(to)X 1967(that)X 2113(block,)X 2337(sets)X 0 f 2511(*linecount)X 1 f 3017(to)X 3105(the)X 3229(number)X 3500(of)X 3593(descriptors)X 3970(in)X 576 5520(this)N 711(block)X 909(and)X 1045(returns)X 0 f 1316(DW_DLV_OK)X 1 f (.)S 1808(The)X 1953(compilation-unit)X 2506(is)X 2579(indicated)X 2894(by)X 2995(the)X 3114(given)X 0 f 3341(die)X 1 f 3506(which)X 3723(must)X 3899(be)X 3996(a)X 576 5616(compilation-unit)N 1130(die.)X 1289(It)X 1359(returns)X 0 f 1631(DW_DLV_ERROR)X 1 f 2228(on)X 2329(error.)X 2547(On)X 2666(successful)X 3017(return,)X 3249(line)X 3389(number)X 3654(information)X 576 5712(should)N 809(be)X 905(free'd)X 1118(using)X 0 f 1339(dwarf_srclines_dealloc\(\))X 1 f 2511(when)X 2705(no)X 2805(longer)X 3030(of)X 3117(interest.)X 576 6183(rev)N 699(1.61,)X 879(3)X 939(Apr)X 1084(2006)X 2217(-)X 2264(27)X 2364(-)X 28 p %%Page: 28 28 0(Courier)xf 0 f 10 s 0 xH 0 xS 0 f 1 f 2217 384(-)N 2264(28)X 2364(-)X 0 f 736 768(Dwarf_Signed)N 1360(cnt;)X 736 864(Dwarf_Line)N 1264(*linebuf;)X 736 960(int)N 928(sres;)X 736 1152(sres)N 976(=)X 1072(dwarf_srclines\(somedie,)X 2224(&linebuf,&cnt,)X 2944(&error\);)X 736 1248(if)N 880(\(sres)X 1168(==)X 1312(DW_DLV_OK\))X 1840({)X 1120 1344(for)N 1312(\(i)X 1456(=)X 1552(0;)X 1696(i)X 1792(<)X 1888(cnt;)X 2128(++i\))X 2368({)X 1504 1440(/*)N 1648(use)X 1840(linebuf[i])X 2368(*/)X 1120 1536(})N 1120 1632(dwarf_srclines_dealloc\(dbg,)N 2464(linebuf,)X 2896(cnt\);)X 736 1728(})N 1 f 576 2016(The)N 736(following)X 1082(dealloc)X 1349(code)X 1536(\(the)X 1696(only)X 1873(documented)X 2300(method)X 2575(before)X 2816(July)X 2984(2005\))X 3206(still)X 3360(works,)X 3611(but)X 3748(does)X 3930(not)X 576 2112(completely)N 957(free)X 1108(all)X 1213(data)X 1371(allocated.)X 1725(The)X 0 f 1902(dwarf_srclines_dealloc\(\))X 1 f 3078(routine)X 3329(was)X 3478(created)X 3735(to)X 3821(fix)X 3934(the)X 576 2208(problem)N 863(of)X 950(incomplete)X 1326(deallocation.)X 0 f 736 2352(Dwarf_Signed)N 1360(cnt;)X 736 2448(Dwarf_Line)N 1264(*linebuf;)X 736 2544(int)N 928(sres;)X 736 2736(sres)N 976(=)X 1072(dwarf_srclines\(somedie,)X 2224(&linebuf,&cnt,)X 2944(&error\);)X 736 2832(if)N 880(\(sres)X 1168(==)X 1312(DW_DLV_OK\))X 1840({)X 1120 2928(for)N 1312(\(i)X 1456(=)X 1552(0;)X 1696(i)X 1792(<)X 1888(cnt;)X 2128(++i\))X 2368({)X 1504 3024(/*)N 1648(use)X 1840(linebuf[i])X 2368(*/)X 1504 3120(dwarf_dealloc\(dbg,)N 2416(linebuf[i],)X 2992(DW_DLA_LINE\);)X 1120 3216(})N 1120 3312(dwarf_dealloc\(dbg,)N 2032(linebuf,)X 2464(DW_DLA_LIST\);)X 736 3408(})N 3 f 576 3696(5.5.2)N 776(Get)X 921(the)X 1048(set)X 1162(of)X 1249(Source)X 1505(File)X 1654(Names)X 1 f 576 3936(The)N 722(function)X 1010(returns)X 1254(the)X 1373(names)X 1599(of)X 1687(the)X 1807(source)X 2039(files)X 2199(that)X 2341(have)X 2515(contributed)X 2902(to)X 2986(the)X 3106(compilation-unit)X 3661(represented)X 576 4032(by)N 676(the)X 794(given)X 992(DIE.)X 1186(Only)X 1366(the)X 1484(source)X 1714(files)X 1872(named)X 2106(in)X 2188(the)X 2306(statement)X 2633(program)X 2925(prologue)X 3230(are)X 3349(returned.)X 0 f 576 4368(int)N 768(dwarf_srcfiles\()X 960 4464(Dwarf_Die)N 1440(die,)X 960 4560(char)N 1200(***srcfiles,)X 960 4656(Dwarf_Signed)N 1584(*srccount,)X 960 4752(Dwarf_Error)N 1536(*error\))X 1 f 576 4896(When)N 805(it)X 886(succeeds)X 0 f 1237(dwarf_srcfiles\(\))X 1 f 2042(returns)X 0 f 2330(DW_DLV_OK)X 1 f 2799(and)X 2952(puts)X 3122(the)X 3258(number)X 3541(of)X 3646(source)X 3894(files)X 576 4992(named)N 820(in)X 912(the)X 1040(statement)X 1377(program)X 1679(prologue)X 1993(indicated)X 2316(by)X 2425(the)X 2552(given)X 0 f 2787(die)X 1 f 2960(into)X 0 f 3141(*srccount)X 1 f (.)S 3642(Source)X 3894(files)X 576 5088(defined)N 898(in)X 1041(the)X 1220(statement)X 1608(program)X 1961(are)X 2141(ignored.)X 2507(The)X 2713(given)X 0 f 3000(die)X 1 f 3225(should)X 3520(have)X 3754(the)X 3934(tag)X 0 f 576 5184(DW_TAG_compile_unit)N 1 f (.)S 1552(The)X 1701(location)X 1983(pointed)X 2247(to)X 2333(by)X 0 f 2465(srcfiles)X 1 f 2873(is)X 2950(set)X 3063(to)X 3148(point)X 3335(to)X 3420(a)X 3479(list)X 3599(of)X 3689(pointers)X 3970(to)X 576 5280(null-terminated)N 1097(strings)X 1337(that)X 1484(name)X 1685(the)X 1810(source)X 2047(files.)X 2253(On)X 2379(a)X 2443(successful)X 2801(return)X 3021(from)X 3205(this)X 3348(function,)X 3663(each)X 3839(of)X 3934(the)X 576 5376(strings)N 834(returned)X 1147(should)X 1405(be)X 1526(individually)X 1957(free'd)X 2195(using)X 0 f 2441(dwarf_dealloc\(\))X 1 f 3206(with)X 3392(the)X 3534(allocation)X 3894(type)X 0 f 576 5472(DW_DLA_STRING)N 1 f 1243(when)X 1460(no)X 1583(longer)X 1831(of)X 1941(interest.)X 2261(This)X 2447(should)X 2704(be)X 2824(followed)X 3153(by)X 3277(free-ing)X 3576(the)X 3718(list)X 3859(using)X 0 f 576 5568(dwarf_dealloc\(\))N 1 f 1319(with)X 1484(the)X 1604(allocation)X 1942(type)X 0 f 2130(DW_DLA_LIST)X 1 f (.)S 2720(It)X 2791(returns)X 0 f 3064(DW_DLV_ERROR)X 1 f 3662(on)X 3764(error.)X 3983(It)X 576 5664(returns)N 0 f 862(DW_DLV_NO_ENTRY)X 1 f 1617(if)X 1701(there)X 1897(is)X 1985(no)X 2100(corresponding)X 2594(statement)X 2936(program)X 3244(\(i.e.,)X 3425(if)X 3510(there)X 3707(is)X 3796(no)X 3912(line)X 576 5760(information\).)N 576 6183(rev)N 699(1.61,)X 879(3)X 939(Apr)X 1084(2006)X 2217(-)X 2264(28)X 2364(-)X 29 p %%Page: 29 29 0(Courier)xf 0 f 10 s 0 xH 0 xS 0 f 1 f 2217 384(-)N 2264(29)X 2364(-)X 0 f 736 768(Dwarf_Signed)N 1360(cnt;)X 736 864(char)N 976(**srcfiles;)X 736 960(int)N 928(res;)X 736 1152(res)N 928(=)X 1024(dwarf_srcfiles\(somedie,)X 2176(&srcfiles,&cnt)X 2896(&error\);)X 736 1248(if)N 880(\(res)X 1120(==)X 1264(DW_DLV_OK\))X 1792({)X 1120 1440(for)N 1312(\(i)X 1456(=)X 1552(0;)X 1696(i)X 1792(<)X 1888(cnt;)X 2128(++i\))X 2368({)X 1504 1536(/*)N 1648(use)X 1840(srcfiles[i])X 2416(*/)X 1504 1632(dwarf_dealloc\(dbg,)N 2416(srcfiles[i],)X 3040(DW_DLA_STRING\);)X 1120 1728(})N 1120 1824(dwarf_dealloc\(dbg,)N 2032(srcfiles,)X 2512(DW_DLA_LIST\);)X 736 1920(})N 3 f 576 2064(5.5.3)N 776(Get)X 921(information)X 1350(about)X 1565(a)X 1625(Single)X 1853(Table)X 2068(Line)X 1 f 576 2208(The)N 792(following)X 1194(functions)X 1583(can)X 1786(be)X 1953(used)X 2191(on)X 2362(the)X 0 f 2579(Dwarf_Line)X 1 f 3150(descriptors)X 3593(returned)X 3952(by)X 0 f 576 2304(dwarf_srclines\(\))N 1 f 1364(to)X 1446(obtain)X 1666(information)X 2064(about)X 2262(the)X 2380(source)X 2610(lines.)X 3 f 9 s 576 2544(5.5.3.1)N 810(dwarf_linebeginstatement\(\))X 0 f 10 s 576 2688(int)N 768(dwarf_linebeginstatement\()X 960 2784(Dwarf_Line)N 1488(line,)X 960 2880(Dwarf_Bool)N 1488(*return_bool,)X 960 2976(Dwarf_Error)N 1536(*error\))X 1 f 576 3120(The)N 726(function)X 0 f 1046(dwarf_linebeginstatement\(\))X 1 f 2319(returns)X 0 f 2595(DW_DLV_OK)X 1 f 3052(and)X 3194(sets)X 0 f 3368(*return_bool)X 1 f 3970(to)X 2 f 576 3216(non-zero)N 1 f 889(\(if)X 0 f 1021(line)X 1 f 1241(represents)X 1595(a)X 1659(line)X 1806(number)X 2078(entry)X 2270(that)X 2417(is)X 2497(marked)X 2765(as)X 2859(beginning)X 3206(a)X 3269(statement\).)X 3670(or)X 2 f 3764(zero)X 1 f 3929(\(\(if)X 0 f 576 3312(line)N 1 f 820(represents)X 1198(a)X 1286(line)X 1458(number)X 1755(entry)X 1972(that)X 2144(is)X 2249(not)X 2404(marked)X 2698(as)X 2818(beginning)X 3191(a)X 3280(statement\).)X 3707(It)X 3809(returns)X 0 f 576 3408(DW_DLV_ERROR)N 1 f 1172(on)X 1272(error.)X 1489(It)X 1558(never)X 1757(returns)X 0 f 2028(DW_DLV_NO_ENTRY)X 1 f (.)S 3 f 9 s 576 3648(5.5.3.2)N 810(dwarf_lineendsequence\(\))X 0 f 10 s 576 3792(int)N 768(dwarf_lineendsequence\()X 960 3888(Dwarf_Line)N 1488(line,)X 960 3984(Dwarf_Bool)N 1488(*return_bool,)X 960 4080(Dwarf_Error)N 1536(*error\))X 1 f 576 4224(The)N 733(function)X 0 f 1060(dwarf_lineendsequence\(\))X 1 f 2197(returns)X 0 f 2481(DW_DLV_OK)X 1 f 2946(and)X 3095(sets)X 0 f 3276(*return_bool)X 2 f 3885(non-)X 576 4320(zero)N 1 f 736(\(in)X 846(which)X 1063(case)X 0 f 1251(line)X 1 f 1464(represents)X 1811(a)X 1868(line)X 2009(number)X 2275(entry)X 2461(that)X 2602(is)X 2676(marked)X 2938(as)X 3026(ending)X 3265(a)X 3322(text)X 3463(sequence\))X 3806(or)X 2 f 3894(zero)X 1 f 576 4416(\(in)N 687(which)X 905(case)X 0 f 1094(line)X 1 f 1308(represents)X 1656(a)X 1714(line)X 1856(number)X 2123(entry)X 2310(that)X 2452(is)X 2527(not)X 2651(marked)X 2914(as)X 3003(ending)X 3244(a)X 3303(text)X 3446(sequence\).)X 3831(A)X 3912(line)X 576 4512(number)N 846(entry)X 1036(that)X 1181(is)X 1259(marked)X 1525(as)X 1617(ending)X 1859(a)X 1919(text)X 2063(sequence)X 2382(is)X 2459(an)X 2559(entry)X 2748(with)X 2914(an)X 3014(address)X 3279(one)X 3419(beyond)X 3679(the)X 3801(highest)X 576 4608(address)N 884(used)X 1098(by)X 1245(the)X 1410(current)X 1705(sequence)X 2067(of)X 2202(line)X 2390(table)X 2614(entries)X 2896(\(that)X 3111(is,)X 3252(the)X 3418(table)X 3642(entry)X 3875(is)X 3996(a)X 576 4704 0.2014(DW_LNE_end_sequence)AN 1417(entry)X 1602(\(see)X 1752(the)X 1870(DWARF)X 2179(specification\)\).)X 576 4848(The)N 742(function)X 0 f 1079(dwarf_lineendsequence\(\))X 1 f 2225(returns)X 0 f 2518(DW_DLV_ERROR)X 1 f 3136(on)X 3258(error.)X 3497(It)X 3588(never)X 3809(returns)X 0 f 576 4944(DW_DLV_NO_ENTRY)N 1 f (.)S 3 f 9 s 576 5184(5.5.3.3)N 810(dwarf_lineno\(\))X 0 f 10 s 576 5328(int)N 768(dwarf_lineno\()X 960 5424(Dwarf_Line)N 1776(line,)X 960 5520(Dwarf_Unsigned)N 1680(*)X 1776(returned_lineno,)X 960 5616(Dwarf_Error)N 1680(*)X 1776(error\))X 1 f 576 5760(The)N 738(function)X 0 f 1070(dwarf_lineno\(\))X 1 f 1779(returns)X 0 f 2067(DW_DLV_OK)X 1 f 2536(and)X 2690(sets)X 0 f 2876(*return_lineno)X 1 f 3586(to)X 3686(the)X 3822(source)X 576 5856(statement)N 913(line)X 1063(number)X 1338(corresponding)X 1827(to)X 1919(the)X 2046(descriptor)X 0 f 2424(line)X 1 f (.)S 2685(It)X 2763(returns)X 0 f 3043(DW_DLV_ERROR)X 1 f 3648(on)X 3757(error.)X 3983(It)X 576 5952(never)N 775(returns)X 0 f 1046(DW_DLV_NO_ENTRY)X 1 f (.)S 576 6183(rev)N 699(1.61,)X 879(3)X 939(Apr)X 1084(2006)X 2217(-)X 2264(29)X 2364(-)X 30 p %%Page: 30 30 0(Courier)xf 0 f 10 s 0 xH 0 xS 0 f 1 f 2217 384(-)N 2264(30)X 2364(-)X 3 f 9 s 576 768(5.5.3.4)N 810(dwarf_line_srcfileno\(\))X 0 f 10 s 576 912(int)N 768(dwarf_line_srcfileno\()X 960 1008(Dwarf_Line)N 1776(line,)X 960 1104(Dwarf_Unsigned)N 1680(*)X 1776(returned_fileno,)X 960 1200(Dwarf_Error)N 1680(*)X 1776(error\))X 1 f 576 1344(The)N 726(function)X 0 f 1046(dwarf_line_srcfileno\(\))X 1 f 2127(returns)X 0 f 2403(DW_DLV_OK)X 1 f 2860(and)X 3002(sets)X 0 f 3176(*returned_fileno)X 1 f 3970(to)X 576 1440(the)N 707(source)X 950(statement)X 1290(line)X 1443(number)X 1721(corresponding)X 2213(to)X 2308(the)X 2439(descriptor)X 0 f 2821(file)X 3073(number)X 1 f (.)S 3433(When)X 3657(the)X 3787(number)X 576 1536(returned)N 867(thru)X 0 f 1047(*returned_fileno)X 1 f 1838(is)X 1914(zero)X 2076(it)X 2143(means)X 2371(the)X 2493(file)X 2624(name)X 2822(is)X 2899(unknown)X 3221(\(see)X 3375(the)X 3497(DWARF2/3)X 3912(line)X 576 1632(table)N 772(specification\).)X 1289(When)X 1521(the)X 1659(number)X 1944(returned)X 2252(thru)X 0 f 2449(*returned_fileno)X 1 f 3257(is)X 3350(non-zero)X 3675(it)X 3758(is)X 3850(a)X 3925(file)X 576 1728(number:)N 911(subtract)X 1213(1)X 1301(from)X 1505(this)X 1668(file)X 1823(number)X 2116(to)X 2226(get)X 2372(an)X 2496(index)X 2722(into)X 2895(the)X 3042(array)X 3257(of)X 3373(strings)X 3635(returned)X 3952(by)X 0 f 576 1824(dwarf_srcfiles\(\))N 1 f 1369(\(verify)X 1613(the)X 1736(resulting)X 2041(index)X 2244(is)X 2322(in)X 2409(range)X 2613(for)X 2732(the)X 2855(array)X 3046(of)X 3137(strings)X 3374(before)X 3604(indexing)X 3908(into)X 576 1920(the)N 722(array)X 936(of)X 1051(strings\).)X 1379(The)X 1552(file)X 1707(number)X 2000(may)X 2186(exceed)X 2458(the)X 2605(size)X 2779(of)X 2895(the)X 3042(array)X 3257(of)X 3373(strings)X 3635(returned)X 3952(by)X 0 f 576 2016(dwarf_srcfiles\(\))N 1 f 1382(because)X 0 f 1703(dwarf_srcfiles\(\))X 1 f 2508(does)X 2692(not)X 2831(return)X 3060(files)X 3235(names)X 3477(defined)X 3755(with)X 3934(the)X 0 f 576 2112(DW_DLE_define_file)N 1 f 1573(operator.)X 1994(The)X 2232(function)X 0 f 2640(dwarf_line_srcfileno\(\))X 1 f 3809(returns)X 0 f 576 2208(DW_DLV_ERROR)N 1 f 1172(on)X 1272(error.)X 1489(It)X 1558(never)X 1757(returns)X 0 f 2028(DW_DLV_NO_ENTRY)X 1 f (.)S 3 f 9 s 576 2448(5.5.3.5)N 810(dwarf_lineaddr\(\))X 0 f 10 s 576 2592(int)N 768(dwarf_lineaddr\()X 960 2688(Dwarf_Line)N 1584(line,)X 960 2784(Dwarf_Addr)N 1536(*return_lineaddr,)X 960 2880(Dwarf_Error)N 1536(*error\))X 1 f 576 3024(The)N 744(function)X 0 f 1082(dwarf_lineaddr\(\))X 1 f 1893(returns)X 0 f 2188(DW_DLV_OK)X 1 f 2664(and)X 2824(sets)X 0 f 3016(*return_lineaddr)X 1 f 3828(to)X 3934(the)X 576 3120(address)N 851(associated)X 1215(with)X 1391(the)X 1523(descriptor)X 0 f 1906(line)X 1 f (.)S 2172(It)X 2255(returns)X 0 f 2540(DW_DLV_ERROR)X 1 f 3170(on)X 3284(error.)X 3515(It)X 3597(never)X 3809(returns)X 0 f 576 3216(DW_DLV_NO_ENTRY)N 1 f (.)S 3 f 9 s 576 3456(5.5.3.6)N 810(dwarf_lineoff\(\))X 0 f 10 s 576 3600(int)N 768(dwarf_lineoff\()X 960 3696(Dwarf_Line)N 1488(line,)X 960 3792(Dwarf_Signed)N 1680(*)X 1776(return_lineoff,)X 960 3888(Dwarf_Error)N 1536(*error\))X 1 f 576 4032(The)N 725(function)X 0 f 1045(dwarf_lineoff\(\))X 1 f 1790(returns)X 0 f 2066(DW_DLV_OK)X 1 f 2523(and)X 2664(sets)X 0 f 2837(*return_lineoff)X 1 f 3582(to)X 3669(the)X 3792(column)X 576 4128(number)N 854(at)X 945(which)X 1174(the)X 1305(statement)X 1645(represented)X 2049(by)X 0 f 2190(line)X 1 f 2414(begins.)X 2695(It)X 2776(sets)X 0 f 2956(return_lineoff)X 1 f 3660(to)X 2 f 3754(-1)X 1 f 3853(if)X 3934(the)X 576 4224(column)N 836(number)X 1101(of)X 1188(the)X 1306(statement)X 1633(is)X 1706(not)X 1828(represented)X 2219(\(meaning)X 2543(the)X 2662(producer)X 2969(library)X 3204(call)X 3341(was)X 3487(given)X 3686(zero)X 3846(as)X 3934(the)X 576 4320(column)N 836(number\).)X 576 4464(On)N 694(error)X 871(it)X 935(returns)X 0 f 1206(DW_DLV_ERROR)X 1 f (.)S 1842(It)X 1911(never)X 2110(returns)X 0 f 2381(DW_DLV_NO_ENTRY)X 1 f (.)S 3 f 9 s 576 4704(5.5.3.7)N 810(dwarf_linesrc\(\))X 0 f 10 s 576 4848(int)N 768(dwarf_linesrc\()X 960 4944(Dwarf_Line)N 1488(line,)X 960 5040(char)N 1248(**)X 1488(return_linesrc,)X 960 5136(Dwarf_Error)N 1536(*error\))X 1 f 576 5280(The)N 724(function)X 0 f 1042(dwarf_linesrc\(\))X 1 f 1786(returns)X 0 f 2061(DW_DLV_OK)X 1 f 2517(and)X 2657(sets)X 0 f 2829(*return_linesrc)X 1 f 3573(to)X 3659(a)X 3719(pointer)X 3970(to)X 576 5376(a)N 640(null-terminated)X 1162(string)X 1371(of)X 1465(characters)X 1819(that)X 1966(represents)X 2319(the)X 2444(name)X 2645(of)X 2739(the)X 2864(source-file)X 3235(where)X 0 f 3487(line)X 1 f 3706(occurs.)X 3983(It)X 576 5472(returns)N 0 f 847(DW_DLV_ERROR)X 1 f 1443(on)X 1543(error.)X 576 5616(If)N 651(the)X 770(applicable)X 1121(file)X 1249(name)X 1444(in)X 1528(the)X 1648(line)X 1790(table)X 1968(Statement)X 2310(Program)X 2608(Prolog)X 2843(does)X 3012(not)X 3136(start)X 3296(with)X 3460(a)X 3518('/')X 3616(character)X 3934(the)X 576 5712(string)N 787(in)X 0 f 906(DW_AT_comp_dir)X 1 f 1607(\(if)X 1712(applicable)X 2071(and)X 2216(present\))X 2503(or)X 2598(the)X 2724(applicable)X 3082(directory)X 3400(name)X 3602(from)X 3786(the)X 3912(line)X 576 5808(Statement)N 927(Program)X 1235(Prolog)X 1480(is)X 1565(prepended)X 1932(to)X 2026(the)X 2156(file)X 2295(name)X 2501(in)X 2595(the)X 2725(line)X 2877(table)X 3065(Statement)X 3417(Program)X 3725(Prolog)X 3970(to)X 576 5904(make)N 770(a)X 826(full)X 957(path.)X 576 6183(rev)N 699(1.61,)X 879(3)X 939(Apr)X 1084(2006)X 2217(-)X 2264(30)X 2364(-)X 31 p %%Page: 31 31 0(Courier)xf 0 f 10 s 0 xH 0 xS 0 f 1 f 2217 384(-)N 2264(31)X 2364(-)X 576 768(The)N 754(storage)X 1039(pointed)X 1332(to)X 1447(by)X 1580(a)X 1669(successful)X 2052(return)X 2297(of)X 0 f 2445(dwarf_linesrc\(\))X 1 f 3218(should)X 3484(be)X 3613(free'd)X 3859(using)X 0 f 576 864(dwarf_dealloc\(\))N 1 f 1326(with)X 1498(the)X 1626(allocation)X 1972(type)X 0 f 2168(DW_DLA_STRING)X 1 f 2822(when)X 3026(no)X 3136(longer)X 3371(of)X 3468(interest.)X 3774(It)X 3853(never)X 576 960(returns)N 0 f 847(DW_DLV_NO_ENTRY)X 1 f (.)S 3 f 9 s 576 1200(5.5.3.8)N 810(dwarf_lineblock\(\))X 0 f 10 s 576 1344(int)N 768(dwarf_lineblock\()X 960 1440(Dwarf_Line)N 1488(line,)X 960 1536(Dwarf_Bool)N 1488(*return_bool,)X 960 1632(Dwarf_Error)N 1536(*error\))X 1 f 576 1776(The)N 723(function)X 0 f 1040(dwarf_lineblock\(\))X 1 f 1879(returns)X 0 f 2153(DW_DLV_OK)X 1 f 2608(and)X 2747(sets)X 0 f 2918(*return_linesrc)X 1 f 3661(to)X 3746(non-zero)X 576 1872(\(i.e.)N 727(true\)\(if)X 981(the)X 1105(line)X 1251(is)X 1330(marked)X 1597(as)X 1689(beginning)X 2034(a)X 2095(basic)X 2285(block\))X 2515(or)X 2607(zero)X 2771(\(i.e.)X 2921(false\))X 3125(\(if)X 3226(the)X 3349(line)X 3494(is)X 3572(marked)X 3838(as)X 3930(not)X 576 1968(beginning)N 916(a)X 972(basic)X 1157(block\).)X 1422(It)X 1491(returns)X 0 f 1762(DW_DLV_ERROR)X 1 f 2358(on)X 2458(error.)X 2675(It)X 2744(never)X 2943(returns)X 0 f 3214(DW_DLV_NO_ENTRY)X 1 f (.)S 3 f 11 s 576 2304(5.6)N 730(Global)X 1008(Name)X 1249(Space)X 1491(Operations)X 1 f 10 s 576 2448(These)N 788(operations)X 1142(operate)X 1399(on)X 1499(the)X 1617(.debug_pubnames)X 2218(section)X 2465(of)X 2552(the)X 2670(debugging)X 3028(information.)X 3 f 576 2688(5.6.1)N 776(Debugger)X 1130(Interface)X 1463(Operations)X 9 s 576 2976(5.6.1.1)N 810(dwarf_get_globals\(\))X 0 f 10 s 576 3120(int)N 768(dwarf_get_globals\()X 960 3216(Dwarf_Debug)N 1536(dbg,)X 960 3312(Dwarf_Global)N 1584(**globals,)X 960 3408(Dwarf_Signed)N 1584(*)X 1680(return_count,)X 960 3504(Dwarf_Error)N 1536(*error\))X 1 f 576 3648(The)N 722(function)X 0 f 1038(dwarf_get_globals\(\))X 1 f 1971(returns)X 0 f 2243(DW_DLV_OK)X 1 f 2696(and)X 2834(sets)X 0 f 3004(*return_count)X 1 f 3650(to)X 3734(the)X 3854(count)X 576 3744(of)N 682(pubnames)X 1046(represented)X 1456(in)X 1557(the)X 1694(section)X 1960(containing)X 2337(pubnames)X 2700(i.e.)X 2836(.debug_pubnames.)X 3495(It)X 3582(also)X 3749(stores)X 3974(at)X 0 f 576 3840(*globals)N 1 f (,)S 1013(a)X 1083(pointer)X 1344(to)X 1440(a)X 1510(list)X 1641(of)X 0 f 1770(Dwarf_Global)X 1 f 2380(descriptors,)X 2786(one)X 2936(for)X 3064(each)X 3246(of)X 3347(the)X 3479(pubnames)X 3838(in)X 3934(the)X 576 3936(.debug_pubnames)N 1184(section.)X 1478(It)X 1553(returns)X 0 f 1830(DW_DLV_ERROR)X 1 f 2432(on)X 2538(error.)X 2761(It)X 2836(returns)X 0 f 3113(DW_DLV_NO_ENTRY)X 1 f 3859(if)X 3934(the)X 576 4032(.debug_pubnames)N 1177(section)X 1424(does)X 1591(not)X 1713(exist.)X 576 4272(On)N 708(a)X 778(successful)X 1142(return)X 1368(from)X 0 f 1586(dwarf_get_globals\(\))X 1 f (,)S 2552(the)X 0 f 2712(Dwarf_Global)X 1 f 3322(descriptors)X 3708(should)X 3956(be)X 576 4368(free'd)N 792(using)X 0 f 1016(dwarf_globals_dealloc\(\))X 1 f (.)S 0 f 2239(dwarf_globals_dealloc\(\))X 1 f 3366(is)X 3442(new)X 3599(as)X 3688(of)X 3777(July)X 3932(15,)X 576 4464(2005)N 756(and)X 892(is)X 965(the)X 1083(preferred)X 1399(approach)X 1714(to)X 1796(freeing)X 2044(this)X 2179(memory..)X 0 f 736 4704(Dwarf_Signed)N 1360(cnt;)X 736 4800(Dwarf_Global)N 1360(*globs;)X 736 4896(int)N 928(res;)X 736 5088(res)N 928(=)X 1024(dwarf_get_globals\(dbg,)X 2128(&globs,&cnt,)X 2752(&error\);)X 736 5184(if)N 880(\(res)X 1120(==)X 1264(DW_DLV_OK\))X 1792({)X 1120 5376(for)N 1312(\(i)X 1456(=)X 1552(0;)X 1696(i)X 1792(<)X 1888(cnt;)X 2128(++i\))X 2368({)X 1504 5472(/*)N 1648(use)X 1840(globs[i])X 2272(*/)X 1120 5568(})N 1120 5664(dwarf_globals_dealloc\(dbg,)N 2416(globs,)X 2752(cnt\);)X 736 5760(})N 1 f 576 6183(rev)N 699(1.61,)X 879(3)X 939(Apr)X 1084(2006)X 2217(-)X 2264(31)X 2364(-)X 32 p %%Page: 32 32 0(Courier)xf 0 f 10 s 0 xH 0 xS 0 f 1 f 2217 384(-)N 2264(32)X 2364(-)X 576 768(The)N 737(following)X 1085(code)X 1274(is)X 1364(deprecated)X 1750(as)X 1854(of)X 1958(July)X 2128(15,)X 2265(2005)X 2462(as)X 2566(it)X 2647(does)X 2831(not)X 2970(free)X 3133(all)X 3250(relevant)X 3546(memory.)X 3890(This)X 576 864(approach)N 915(still)X 1058(works)X 1278(as)X 1369(well)X 1531(as)X 1622(it)X 1690(ever)X 1853(did.)X 2019(On)X 2141(a)X 2201(successful)X 2555(return)X 2771(from)X 0 f 2979(dwarf_get_globals\(\))X 1 f (,)S 3934(the)X 0 f 576 960(Dwarf_Global)N 1 f 1207(descriptors)X 1614(should)X 1882(be)X 2013(individually)X 2454(free'd)X 2703(using)X 0 f 2960(dwarf_dealloc\(\))X 1 f 3736(with)X 3934(the)X 576 1056(allocation)N 930(type)X 0 f 1134(DW_DLA_GLOBAL_CONTEXT)X 1 f (,)S 2199(\(or)X 0 f 2358(DW_DLA_GLOBAL)X 1 f (,)S 3039(an)X 3152(older)X 3354(name,)X 3585(supported)X 3938(for)X 576 1152(compatibility\))N 1050(followed)X 1356(by)X 1457(the)X 1576(deallocation)X 1989(of)X 2077(the)X 2197(list)X 2316(itself)X 2498(with)X 2662(the)X 2782(allocation)X 3120(type)X 0 f 3308(DW_DLA_LIST)X 1 f 3858(when)X 576 1248(the)N 694(descriptors)X 1066(are)X 1185(no)X 1285(longer)X 1510(of)X 1597(interest.)X 0 f 736 1488(Dwarf_Signed)N 1360(cnt;)X 736 1584(Dwarf_Global)N 1360(*globs;)X 736 1680(int)N 928(res;)X 736 1872(res)N 928(=)X 1024(dwarf_get_globals\(dbg,)X 2128(&globs,&cnt,)X 2752(&error\);)X 736 1968(if)N 880(\(res)X 1120(==)X 1264(DW_DLV_OK\))X 1792({)X 1120 2160(for)N 1312(\(i)X 1456(=)X 1552(0;)X 1696(i)X 1792(<)X 1888(cnt;)X 2128(++i\))X 2368({)X 1504 2256(/*)N 1648(use)X 1840(globs[i])X 2272(*/)X 1504 2352(dwarf_dealloc\(dbg,)N 2416(globs[i],)X 2896(DW_DLA_GLOBAL_CONTEXT\);)X 1120 2448(})N 1120 2544(dwarf_dealloc\(dbg,)N 2032(globs,)X 2368(DW_DLA_LIST\);)X 736 2640(})N 3 f 9 s 576 2928(5.6.1.2)N 810(dwarf_globname\(\))X 0 f 10 s 576 3072(int)N 768(dwarf_globname\()X 960 3168(Dwarf_Global)N 1584(global,)X 960 3264(char)N 1200(**)X 1584(return_name,)X 960 3360(Dwarf_Error)N 1536(*error\))X 1 f 576 3504(The)N 727(function)X 0 f 1048(dwarf_globname\(\))X 1 f 1843(returns)X 0 f 2121(DW_DLV_OK)X 1 f 2580(and)X 2723(sets)X 0 f 2898(*return_name)X 1 f 3501(to)X 3590(a)X 3653(pointer)X 3907(to)X 3996(a)X 576 3600(null-terminated)N 1092(string)X 1296(that)X 1437(names)X 1663(the)X 1782(pubname)X 2097(represented)X 2489(by)X 2590(the)X 0 f 2737(Dwarf_Global)X 1 f 3334(descriptor,)X 0 f 3724(global)X 1 f (.)S 576 3696(It)N 645(returns)X 0 f 916(DW_DLV_ERROR)X 1 f 1512(on)X 1612(error.)X 1829(On)X 1947(a)X 2003(successful)X 2353(return)X 2565(from)X 2742(this)X 2878(function,)X 3186(the)X 3305(string)X 3508(should)X 3742(be)X 3839(free'd)X 576 3792(using)N 0 f 804(dwarf_dealloc\(\))X 1 f (,)S 1571(with)X 1740(the)X 1865(allocation)X 2208(type)X 0 f 2401(DW_DLA_STRING)X 1 f 3051(when)X 3251(no)X 3357(longer)X 3588(of)X 3681(interest.)X 3983(It)X 576 3888(never)N 775(returns)X 0 f 1046(DW_DLV_NO_ENTRY)X 1 f (.)S 3 f 9 s 576 4128(5.6.1.3)N 810(dwarf_global_die_offset\(\))X 0 f 10 s 576 4272(int)N 768(dwarf_global_die_offset\()X 960 4368(Dwarf_Global)N 1584(global,)X 960 4464(Dwarf_Off)N 1536(*return_offset,)X 960 4560(Dwarf_Error)N 1536(*error\))X 1 f 576 4704(The)N 732(function)X 0 f 1058(dwarf_global_die_offset\(\))X 1 f 2289(returns)X 0 f 2571(DW_DLV_OK)X 1 f 3034(and)X 3181(sets)X 0 f 3360(*return_offset)X 1 f 576 4800(to)N 663(the)X 786(offset)X 994(in)X 1081(the)X 1203(section)X 1454(containing)X 1816(DIE's,)X 2052(i.e.)X 2174(.debug_info,)X 2603(of)X 2694(the)X 2816(DIE)X 2974(representing)X 3395(the)X 3517(pubname)X 3835(that)X 3979(is)X 576 4896(described)N 916(by)X 1028(the)X 0 f 1186(Dwarf_Global)X 1 f 1794(descriptor,)X 0 f 2195(glob)X 1 f (.)S 2459(It)X 2540(returns)X 0 f 2823(DW_DLV_ERROR)X 1 f 3431(on)X 3543(error.)X 3772(It)X 3853(never)X 576 4992(returns)N 0 f 847(DW_DLV_NO_ENTRY)X 1 f (.)S 3 f 9 s 576 5232(5.6.1.4)N 810(dwarf_global_cu_offset\(\))X 0 f 10 s 576 5376(int)N 768(dwarf_global_cu_offset\()X 960 5472(Dwarf_Global)N 1584(global,)X 960 5568(Dwarf_Off)N 1536(*return_offset,)X 960 5664(Dwarf_Error)N 1536(*error\))X 1 f 576 5808(The)N 726(function)X 0 f 1046(dwarf_global_cu_offset\(\))X 1 f 2223(returns)X 0 f 2499(DW_DLV_OK)X 1 f 2956(and)X 3098(sets)X 0 f 3272(*return_offset)X 1 f 3970(to)X 576 5904(the)N 721(offset)X 951(in)X 1060(the)X 1205(section)X 1479(containing)X 1864(DIE's,)X 2123(i.e.)X 2268(.debug_info,)X 2720(of)X 2834(the)X 2979(compilation-unit)X 3559(header)X 3821(of)X 3934(the)X 576 6183(rev)N 699(1.61,)X 879(3)X 939(Apr)X 1084(2006)X 2217(-)X 2264(32)X 2364(-)X 33 p %%Page: 33 33 0(Courier)xf 0 f 10 s 0 xH 0 xS 0 f 1 f 2217 384(-)N 2264(33)X 2364(-)X 576 768(compilation-unit)N 1137(that)X 1285(contains)X 1580(the)X 1706(pubname)X 2028(described)X 2364(by)X 2472(the)X 0 f 2626(Dwarf_Global)X 1 f 3230(descriptor,)X 0 f 3627(global)X 1 f (.)S 3983(It)X 576 864(returns)N 0 f 847(DW_DLV_ERROR)X 1 f 1443(on)X 1543(error.)X 1760(It)X 1829(never)X 2028(returns)X 0 f 2299(DW_DLV_NO_ENTRY)X 1 f (.)S 3 f 9 s 576 1104(5.6.1.5)N 810(dwarf_get_cu_die_offset_given_cu_header_offset\(\))X 0 f 10 s 576 1248(int)N 768(dwarf_get_cu_die_offset_given_cu_header_offset\()X 960 1344(Dwarf_Debug)N 1536(dbg,)X 960 1440(Dwarf_Off)N 1536(in_cu_header_offset,)X 960 1536(Dwarf_Off)N 1440(*)X 1536(out_cu_die_offset,)X 960 1632(Dwarf_Error)N 1536(*error\))X 1 f 576 1776(The)N 870(function)X 0 f 1335(dwarf_get_cu_die_offset_given_cu_header_offset\(\))X 1 f 3809(returns)X 0 f 576 1872(DW_DLV_OK)N 1 f 1029(and)X 1166(sets)X 0 f 1334(*out_cu_die_offset)X 1 f 2218(to)X 2300(the)X 2418(offset)X 2621(of)X 2708(the)X 2826(compilation-unit)X 3379(DIE)X 3533(given)X 3731(the)X 3849(offset)X 0 f 576 1968(in_cu_header_offset)N 1 f 1512(of)X 1603(a)X 1663(compilation-unit)X 2221(header.)X 2501(It)X 2575(returns)X 0 f 2851(DW_DLV_ERROR)X 1 f 3452(on)X 3557(error.)X 3779(It)X 3853(never)X 576 2064(returns)N 0 f 847(DW_DLV_NO_ENTRY)X 1 f (.)S 576 2352(This)N 747(effectively)X 1120(turns)X 1309(a)X 1374(compilation-unit-header)X 2178(offset)X 2390(into)X 2543(a)X 2609(compilation-unit)X 3172(DIE)X 3336(offset)X 3549(\(by)X 3686(adding)X 3934(the)X 576 2448(size)N 784(of)X 934(the)X 1115(applicable)X 1528(CU)X 1722(header\).)X 2087(This)X 2312(function)X 2662(is)X 2797(also)X 3008(sometimes)X 3432(useful)X 3710(with)X 3934(the)X 0 f 576 2544(dwarf_weak_cu_offset\(\))N 1 f (,)S 0 f 1766(dwarf_func_cu_offset\(\))X 1 f (,)S 0 f 2956(dwarf_type_cu_offset\(\))X 1 f (,)S 576 2640(and)N 0 f 740(int)X 932(dwarf_var_cu_offset\(\))X 1 f 1960(functions.)X 0 f 576 2832(dwarf_get_cu_die_offset_given_cu_header_offset\(\))N 1 f 2900(added)X 3112(Rev)X 3261(1.45,)X 3441(June,)X 3628(2001.)X 576 3024(This)N 740(function)X 1029(is)X 1104(declared)X 1399(as)X 1488('optional')X 1826(in)X 1910(libdwarf.h)X 2265(on)X 2368(IRIX)X 2556(systems)X 2832(so)X 2926(the)X 3047(_MIPS_SYMBOL_PRESENT)X 576 3120(predicate)N 893(may)X 1053(be)X 1151(used)X 1320(at)X 1400(run)X 1529(time)X 1693(to)X 1777(determine)X 2120(if)X 2191(the)X 2311(version)X 2568(of)X 2656(libdwarf)X 2949(linked)X 3170(into)X 3315(an)X 3412(application)X 3789(has)X 3917(this)X 576 3216(function.)N 3 f 9 s 576 3456(5.6.1.6)N 810(dwarf_global_name_offsets\(\))X 0 f 10 s 576 3600(int)N 768(dwarf_global_name_offsets\()X 960 3696(Dwarf_Global)N 1584(global,)X 960 3792(char)N 1392(**return_name,)X 960 3888(Dwarf_Off)N 1440(*die_offset,)X 960 3984(Dwarf_Off)N 1440(*cu_offset,)X 960 4080(Dwarf_Error)N 1536(*error\))X 1 f 576 4224(The)N 732(function)X 0 f 1058(dwarf_global_name_offsets\(\))X 1 f 2385(returns)X 0 f 2667(DW_DLV_OK)X 1 f 3130(and)X 3277(sets)X 0 f 3456(*return_name)X 1 f 576 4320(to)N 692(a)X 782(pointer)X 1063(to)X 1178(a)X 1267(null-terminated)X 1814(string)X 2049(that)X 2222(gives)X 2444(the)X 2595(name)X 2822(of)X 2942(the)X 3093(pubname)X 3440(described)X 3801(by)X 3934(the)X 0 f 576 4416(Dwarf_Global)N 1 f 1211(descriptor)X 0 f 1620(global)X 1 f (.)S 2008(It)X 2117(returns)X 0 f 2428(DW_DLV_ERROR)X 1 f 3064(on)X 3204(error.)X 3461(It)X 3570(never)X 3809(returns)X 0 f 576 4512(DW_DLV_NO_ENTRY)N 1 f (.)S 1365(It)X 1443(also)X 1601(returns)X 1853(in)X 1943(the)X 2069(locations)X 2386(pointed)X 2654(to)X 2744(by)X 0 f 2880(die_offset)X 1 f (,)S 3408(and)X 0 f 3580(cu_offset)X 1 f (,)S 576 4608(the)N 697(offsets)X 934(of)X 1024(the)X 1145(DIE)X 1302(representing)X 1722(the)X 1843(pubname,)X 2180(and)X 2319(the)X 2440(DIE)X 2597(representing)X 3017(the)X 3138(compilation-unit)X 3694(containing)X 576 4704(the)N 717(pubname,)X 1074(respectively.)X 1545(On)X 1686(a)X 1764(successful)X 2136(return)X 2370(from)X 0 f 2596(dwarf_global_name_offsets\(\))X 1 f 3934(the)X 576 4800(storage)N 833(pointed)X 1098(to)X 1185(by)X 0 f 1318(return_name)X 1 f 1871(should)X 2110(be)X 2212(free'd)X 2431(using)X 0 f 2658(dwarf_dealloc\(\))X 1 f (,)S 3424(with)X 3592(the)X 3716(allocation)X 576 4896(type)N 0 f 762(DW_DLA_STRING)X 1 f 1406(when)X 1600(no)X 1700(longer)X 1925(of)X 2012(interest.)X 3 f 11 s 576 5232(5.7)N 730(DWARF3)X 1127(Type)X 1340(Names)X 1615(Operations)X 1 f 10 s 576 5376(Section)N 836(".debug_pubtypes")X 1487(is)X 1560(new)X 1714(in)X 1796(DWARF3.)X 576 5520(These)N 834(functions)X 1198(operate)X 1501(on)X 1647(the)X 1812(.debug_pubtypes)X 2424(section)X 2718(of)X 2852(the)X 3017(debugging)X 3422(information.)X 3907(The)X 576 5616(.debug_pubtypes)N 1146(section)X 1398(contains)X 1690(the)X 1812(names)X 2041(of)X 2132(file-scope)X 2473(user-defined)X 2899(types,)X 3112(the)X 3234(offsets)X 3472(of)X 3563(the)X 0 f 3713(DIE)X 1 f (s)S 3912(that)X 576 5712(represent)N 893(the)X 1013(definitions)X 1378(of)X 1468(those)X 1660(types,)X 1872(and)X 2011(the)X 2132(offsets)X 2369(of)X 2459(the)X 2580(compilation-units)X 3167(that)X 3310(contain)X 3569(the)X 3690(definitions)X 576 5808(of)N 663(those)X 852(types.)X 576 6183(rev)N 699(1.61,)X 879(3)X 939(Apr)X 1084(2006)X 2217(-)X 2264(33)X 2364(-)X 34 p %%Page: 34 34 0(Courier)xf 0 f 10 s 0 xH 0 xS 0 f 1 f 2217 384(-)N 2264(34)X 2364(-)X 3 f 576 768(5.7.1)N 776(Debugger)X 1130(Interface)X 1463(Operations)X 9 s 576 1056(5.7.1.1)N 810(dwarf_get_pubtypes\(\))X 0 f 10 s 576 1200(int)N 768(dwarf_get_pubtypes\()X 960 1296(Dwarf_Debug)N 1536(dbg,)X 960 1392(Dwarf_Type)N 1488(**types,)X 960 1488(Dwarf_Signed)N 1584(*typecount,)X 960 1584(Dwarf_Error)N 1536(*error\))X 1 f 576 1728(The)N 723(function)X 0 f 1040(dwarf_get_pubtypes\(\))X 1 f 2022(returns)X 0 f 2295(DW_DLV_OK)X 1 f 2749(and)X 2887(sets)X 0 f 3057(*typecount)X 1 f 3559(to)X 3643(the)X 3764(count)X 3965(of)X 576 1824(user-defined)N 1047(type)X 1254(names)X 1528(represented)X 1968(in)X 2098(the)X 2264(section)X 2559(containing)X 2965(user-defined)X 3435(type)X 3641(names,)X 3934(i.e.)X 576 1920(.debug_pubtypes.)N 1184(It)X 1256(also)X 1408(stores)X 1618(at)X 0 f 1727(*types)X 1 f (,)S 2058(a)X 2117(pointer)X 2368(to)X 2454(a)X 2514(list)X 2635(of)X 0 f 2754(Dwarf_Pubtype)X 1 f 3402(descriptors,)X 3798(one)X 3938(for)X 576 2016(each)N 753(of)X 849(the)X 976(user-defined)X 1407(type)X 1574(names)X 1808(in)X 1899(the)X 2026(.debug_pubtypes)X 2600(section.)X 2896(It)X 2973(returns)X 0 f 3252(DW_DLV_NOCOUNT)X 1 f 3952(on)X 576 2112(error.)N 793(It)X 862(returns)X 0 f 1133(DW_DLV_NO_ENTRY)X 1 f 1873(if)X 1942(the)X 2060(.debug_pubtypes)X 2625(section)X 2872(does)X 3039(not)X 3161(exist.)X 576 2352(On)N 712(a)X 787(successful)X 1156(return)X 1387(from)X 0 f 1610(dwarf_get_pubtypes\(\))X 1 f (,)S 2629(the)X 0 f 2794(Dwarf_Type)X 1 f 3313(descriptors)X 3704(should)X 3956(be)X 576 2448(free'd)N 843(using)X 0 f 1118(dwarf_types_dealloc\(\))X 1 f (.)S 0 f 2296(dwarf_types_dealloc\(\))X 1 f 3377(is)X 3503(used)X 3723(for)X 3890(both)X 0 f 576 2544(dwarf_get_pubtypes\(\))N 1 f 1556(and)X 0 f 1720(dwarf_get_types\(\))X 1 f 2556(as)X 2643(the)X 2761(data)X 2915(types)X 3104(are)X 3223(the)X 3341(same.)X 0 f 736 2784(Dwarf_Signed)N 1360(cnt;)X 736 2880(Dwarf_Pubtype)N 1408(*types;)X 736 2976(int)N 928(res;)X 736 3168(res)N 928(=)X 1024(dwarf_get_pubtypes\(dbg,)X 2176(&types,&cnt,)X 2800(&error\);)X 736 3264(if)N 880(\(res)X 1120(==)X 1264(DW_DLV_OK\))X 1792({)X 1120 3456(for)N 1312(\(i)X 1456(=)X 1552(0;)X 1696(i)X 1792(<)X 1888(cnt;)X 2128(++i\))X 2368({)X 1504 3552(/*)N 1648(use)X 1840(types[i])X 2272(*/)X 1120 3648(})N 1120 3744(dwarf_types_dealloc\(dbg,)N 2320(types,)X 2656(cnt\);)X 736 3840(})N 3 f 9 s 576 4128(5.7.1.2)N 810(dwarf_pubtypename\(\))X 0 f 10 s 576 4272(int)N 768(dwarf_pubtypename\()X 960 4368(Dwarf_Pubtype)N 1728(type,)X 960 4464(char)N 1488(**return_name,)X 960 4560(Dwarf_Error)N 1536(*error\))X 1 f 576 4704(The)N 728(function)X 0 f 1050(dwarf_pubtypename\(\))X 1 f 1989(returns)X 0 f 2267(DW_DLV_OK)X 1 f 2727(and)X 2871(sets)X 0 f 3047(*return_name)X 1 f 3651(to)X 3741(a)X 3805(pointer)X 576 4800(to)N 682(a)X 762(null-terminated)X 1299(string)X 1524(that)X 1687(names)X 1935(the)X 2076(user-defined)X 2521(type)X 2702(represented)X 3116(by)X 3239(the)X 0 f 3408(Dwarf_Pubtype)X 1 f 576 4896(descriptor,)N 0 f 972(type)X 1 f (.)S 1231(It)X 1307(returns)X 0 f 1585(DW_DLV_ERROR)X 1 f 2188(on)X 2295(error.)X 2519(It)X 2596(never)X 2803(returns)X 0 f 3082(DW_DLV_NO_ENTRY)X 1 f (.)S 3870(On)X 3996(a)X 576 4992(successful)N 940(return)X 1166(from)X 1356(this)X 1505(function,)X 1825(the)X 1956(string)X 2171(should)X 2417(be)X 2526(free'd)X 2752(using)X 0 f 2986(dwarf_dealloc\(\))X 1 f (,)S 3759(with)X 3934(the)X 576 5088(allocation)N 912(type)X 0 f 1098(DW_DLA_STRING)X 1 f 1742(when)X 1936(no)X 2036(longer)X 2261(of)X 2348(interest.)X 3 f 9 s 576 5328(5.7.1.3)N 810(dwarf_pubtype_die_offset\(\))X 0 f 10 s 576 5472(int)N 768(dwarf_pubtype_die_offset\()X 960 5568(Dwarf_Pubtype)N 1632(type,)X 960 5664(Dwarf_Off)N 1488(*return_offset,)X 960 5760(Dwarf_Error)N 1536(*error\))X 1 f 576 5904(The)N 725(function)X 0 f 1044(dwarf_pubtype_die_offset\(\))X 1 f 2316(returns)X 0 f 2591(DW_DLV_OK)X 1 f 3047(and)X 3187(sets)X 0 f 3360(*return_offset)X 1 f 576 6183(rev)N 699(1.61,)X 879(3)X 939(Apr)X 1084(2006)X 2217(-)X 2264(34)X 2364(-)X 35 p %%Page: 35 35 0(Courier)xf 0 f 10 s 0 xH 0 xS 0 f 1 f 2217 384(-)N 2264(35)X 2364(-)X 576 768(to)N 660(the)X 780(offset)X 985(in)X 1068(the)X 1187(section)X 1435(containing)X 1794(DIE's,)X 2027(i.e.)X 2146(.debug_info,)X 2572(of)X 2660(the)X 2779(DIE)X 2934(representing)X 3352(the)X 3471(user-defined)X 3894(type)X 576 864(that)N 722(is)X 801(described)X 1135(by)X 1241(the)X 0 f 1393(Dwarf_Pubtype)X 1 f 2043(descriptor,)X 0 f 2438(type)X 1 f (.)S 2696(It)X 2771(returns)X 0 f 3049(DW_DLV_ERROR)X 1 f 3652(on)X 3759(error.)X 3983(It)X 576 960(never)N 775(returns)X 0 f 1046(DW_DLV_NO_ENTRY)X 1 f (.)S 3 f 9 s 576 1200(5.7.1.4)N 810(dwarf_pubtype_cu_offset\(\))X 0 f 10 s 576 1344(int)N 768(dwarf_pubtype_cu_offset\()X 960 1440(Dwarf_Pubtype)N 1632(type,)X 960 1536(Dwarf_Off)N 1488(*return_offset,)X 960 1632(Dwarf_Error)N 1536(*error\))X 1 f 576 1776(The)N 732(function)X 0 f 1058(dwarf_pubtype_cu_offset\(\))X 1 f 2289(returns)X 0 f 2571(DW_DLV_OK)X 1 f 3034(and)X 3181(sets)X 0 f 3360(*return_offset)X 1 f 576 1872(to)N 678(the)X 816(offset)X 1039(in)X 1141(the)X 1279(section)X 1546(containing)X 1924(DIE's,)X 2176(i.e.)X 2314(.debug_info,)X 2759(of)X 2865(the)X 3002(compilation-unit)X 3574(header)X 3828(of)X 3934(the)X 576 1968(compilation-unit)N 1150(that)X 1312(contains)X 1621(the)X 1761(user-defined)X 2205(type)X 2385(described)X 2735(by)X 2857(the)X 0 f 3025(Dwarf_Pubtype)X 1 f 3691(descriptor,)X 0 f 576 2064(type)N 1 f (.)S 828(It)X 897(returns)X 0 f 1168(DW_DLV_ERROR)X 1 f 1764(on)X 1864(error.)X 2081(It)X 2150(never)X 2349(returns)X 0 f 2620(DW_DLV_NO_ENTRY)X 1 f (.)S 3 f 9 s 576 2304(5.7.1.5)N 810(dwarf_pubtype_name_offsets\(\))X 0 f 10 s 576 2448(int)N 768(dwarf_pubtype_name_offsets\()X 960 2544(Dwarf_Pubtype)N 1728(type,)X 960 2640(char)N 1440(**)X 1584(returned_name,)X 960 2736(Dwarf_Off)N 1440(*)X 1584(die_offset,)X 960 2832(Dwarf_Off)N 1440(*)X 1584(cu_offset,)X 960 2928(Dwarf_Error)N 1536(*error\))X 1 f 576 3072(The)N 829(function)X 0 f 1253(dwarf_pubtype_name_offsets\(\))X 1 f 2726(returns)X 0 f 3106(DW_DLV_OK)X 1 f 3667(and)X 3912(sets)X 0 f 576 3168(*returned_name)N 1 f 1276(to)X 1366(a)X 1430(pointer)X 1685(to)X 1775(a)X 1839(null-terminated)X 2361(string)X 2571(that)X 2719(gives)X 2916(the)X 3042(name)X 3244(of)X 3339(the)X 3465(user-defined)X 3894(type)X 576 3264(described)N 920(by)X 1036(the)X 0 f 1198(Dwarf_Pubtype)X 1 f 1858(descriptor)X 0 f 2243(type)X 1 f (.)S 2511(It)X 2596(also)X 2761(returns)X 3020(in)X 3118(the)X 3252(locations)X 3577(pointed)X 3853(to)X 3952(by)X 0 f 576 3360(die_offset)N 1 f (,)S 1101(and)X 0 f 1270(cu_offset)X 1 f (,)S 1747(the)X 1870(offsets)X 2109(of)X 2201(the)X 2324(DIE)X 2483(representing)X 2905(the)X 3028(user-defined)X 3454(type,)X 3636(and)X 3776(the)X 3898(DIE)X 576 3456(representing)N 1054(the)X 1233(compilation-unit)X 1847(containing)X 2266(the)X 2445(user-defined)X 2928(type,)X 3168(respectively.)X 3678(It)X 3809(returns)X 0 f 576 3552(DW_DLV_ERROR)N 1 f 1203(on)X 1334(error.)X 1581(It)X 1680(never)X 1909(returns)X 0 f 2210(DW_DLV_NO_ENTRY)X 1 f (.)S 3020(On)X 3168(a)X 3254(successful)X 3634(return)X 3876(from)X 0 f 576 3648(dwarf_pubtype_name_offsets\(\))N 1 f 1949(the)X 2076(storage)X 2337(pointed)X 2606(to)X 2698(by)X 0 f 2836(returned_name)X 1 f 3490(should)X 3733(be)X 3839(free'd)X 576 3744(using)N 0 f 797(dwarf_dealloc\(\))X 1 f (,)S 1557(with)X 1719(the)X 1837(allocation)X 2173(type)X 0 f 2359(DW_DLA_STRING)X 1 f 3003(when)X 3197(no)X 3297(longer)X 3522(of)X 3609(interest.)X 3 f 11 s 576 4080(5.8)N 730(User)X 927(Defined)X 1242(Static)X 1479(Variable)X 1829(Names)X 2104(Operations)X 1 f 10 s 576 4224(This)N 738(section)X 985(is)X 1058(SGI)X 1207(specific)X 1477(and)X 1613(is)X 1686(not)X 1808(part)X 1953(of)X 2040(standard)X 2332(DWARF)X 2641(version)X 2897(2.)X 576 4368(These)N 832(functions)X 1195(operate)X 1497(on)X 1642(the)X 1805(.debug_varnames)X 2434(section)X 2726(of)X 2858(the)X 3021(debugging)X 3424(information.)X 3907(The)X 576 4464(.debug_varnames)N 1171(section)X 1429(contains)X 1727(the)X 1856(names)X 2092(of)X 2190(file-scope)X 2538(static)X 2738(variables,)X 3079(the)X 3208(offsets)X 3453(of)X 3551(the)X 0 f 3707(DIE)X 1 f (s)S 3912(that)X 576 4560(represent)N 911(the)X 1049(definitions)X 1431(of)X 1538(those)X 1747(variables,)X 2097(and)X 2253(the)X 2391(offsets)X 2645(of)X 2752(the)X 2891(compilation-units)X 3496(that)X 3657(contain)X 3934(the)X 576 4656(definitions)N 938(of)X 1025(those)X 1214(variables.)X 3 f 11 s 576 5040(5.9)N 730(Weak)X 972(Name)X 1213(Space)X 1455(Operations)X 1 f 10 s 576 5184(These)N 788(operations)X 1142(operate)X 1399(on)X 1499(the)X 1617(.debug_weaknames)X 2268(section)X 2515(of)X 2602(the)X 2720(debugging)X 3078(information.)X 576 5328(These)N 788(operations)X 1142(are)X 1261(SGI)X 1410(specific,)X 1700(not)X 1822(part)X 1967(of)X 2054(standard)X 2346(DWARF.)X 3 f 576 5616(5.9.1)N 776(Debugger)X 1130(Interface)X 1463(Operations)X 1 f 576 6183(rev)N 699(1.61,)X 879(3)X 939(Apr)X 1084(2006)X 2217(-)X 2264(35)X 2364(-)X 36 p %%Page: 36 36 0(Courier)xf 0 f 10 s 0 xH 0 xS 0 f 1 f 2217 384(-)N 2264(36)X 2364(-)X 3 f 9 s 576 768(5.9.1.1)N 810(dwarf_get_weaks\(\))X 0 f 10 s 576 912(int)N 768(dwarf_get_weaks\()X 960 1008(Dwarf_Debug)N 1536(dbg,)X 960 1104(Dwarf_Weak)N 1488(**weaks,)X 960 1200(Dwarf_Signed)N 1584(*weak_count,)X 960 1296(Dwarf_Error)N 1536(*error\))X 1 f 576 1440(The)N 731(function)X 0 f 1057(dwarf_get_weaks\(\))X 1 f 1904(returns)X 0 f 2186(DW_DLV_OK)X 1 f 2649(and)X 2796(sets)X 0 f 2975(*weak_count)X 1 f 3534(to)X 3627(the)X 3756(count)X 3965(of)X 576 1536(weak)N 794(names)X 1047(represented)X 1466(in)X 1576(the)X 1722(section)X 1996(containing)X 2381(weak)X 2598(names)X 2850(i.e.)X 2995(.debug_weaknames.)X 3713(It)X 3809(returns)X 0 f 576 1632(DW_DLV_ERROR)N 1 f 1174(on)X 1276(error.)X 1495(It)X 1567(returns)X 0 f 1841(DW_DLV_NO_ENTRY)X 1 f 2584(if)X 2656(the)X 2777(section)X 3027(does)X 3197(not)X 3322(exist.)X 3536(It)X 3608(also)X 3760(stores)X 3970(in)X 0 f 576 1728(*weaks)N 1 f (,)S 925(a)X 1002(pointer)X 1270(to)X 1373(a)X 1450(list)X 1587(of)X 0 f 1722(Dwarf_Weak)X 1 f 2242(descriptors,)X 2654(one)X 2810(for)X 2944(each)X 3132(of)X 3239(the)X 3377(weak)X 3587(names)X 3832(in)X 3934(the)X 576 1824(.debug_weaknames)N 1227(section.)X 576 2064(On)N 722(a)X 806(successful)X 1184(return)X 1424(from)X 1628(this)X 1791(function,)X 2126(the)X 0 f 2300(Dwarf_Weak)X 1 f 2829(descriptors)X 3230(should)X 3492(be)X 3617(free'd)X 3859(using)X 0 f 576 2160(dwarf_weaks_dealloc\(\))N 1 f 1615(when)X 1820(the)X 1948(data)X 2112(is)X 2195(no)X 2305(longer)X 2540(of)X 2637(interest.)X 0 f 2971(dwarf_weaks_dealloc\(\))X 1 f (is)S 576 2256(new)N 730(as)X 817(of)X 904(July)X 1057(15,)X 1177(2005.)X 0 f 736 2496(Dwarf_Signed)N 1360(cnt;)X 736 2592(Dwarf_Weak)N 1264(*weaks;)X 736 2688(int)N 928(res;)X 736 2880(res)N 928(=)X 1024(dwarf_get_weaks\(dbg,)X 2032(&weaks,&cnt,)X 2656(&error\);)X 736 2976(if)N 880(\(res)X 1120(==)X 1264(DW_DLV_OK\))X 1792({)X 1120 3168(for)N 1312(\(i)X 1456(=)X 1552(0;)X 1696(i)X 1792(<)X 1888(cnt;)X 2128(++i\))X 2368({)X 1504 3264(/*)N 1648(use)X 1840(weaks[i])X 2272(*/)X 1120 3360(})N 1120 3456(dwarf_weaks_dealloc\(dbg,)N 2320(weaks,)X 2656(cnt\);)X 736 3552(})N 1 f 576 4032(The)N 737(following)X 1085(code)X 1274(is)X 1364(deprecated)X 1750(as)X 1854(of)X 1958(July)X 2128(15,)X 2265(2005)X 2462(as)X 2566(it)X 2647(does)X 2831(not)X 2970(free)X 3133(all)X 3250(relevant)X 3546(memory.)X 3890(This)X 576 4128(approach)N 923(still)X 1074(works)X 1302(as)X 1401(well)X 1571(as)X 1670(it)X 1746(ever)X 1917(did.)X 2091(On)X 2221(a)X 2288(successful)X 2649(return)X 2872(from)X 0 f 3087(dwarf_get_weaks\(\))X 1 f 3934(the)X 0 f 576 4224(Dwarf_Weak)N 1 f 1083(descriptors)X 1463(should)X 1704(be)X 1808(individually)X 2222(free'd)X 2443(using)X 0 f 2672(dwarf_dealloc\(\))X 1 f 3420(with)X 3590(the)X 3716(allocation)X 576 4320(type)N 0 f 786(DW_DLA_WEAK_CONTEXT)X 1 f (,)S 1762(\(or)X 0 f 1928(DW_DLA_WEAK)X 1 f (,)S 2519(an)X 2638(older)X 2846(name,)X 3083(supported)X 3442(for)X 3579(compatibility\))X 576 4416(followed)N 881(by)X 981(the)X 1099(deallocation)X 1511(of)X 1598(the)X 1716(list)X 1833(itself)X 2013(with)X 2175(the)X 2293(allocation)X 2630(type)X 0 f 2817(DW_DLA_LIST)X 1 f 3366(when)X 3561(the)X 3680(descriptors)X 576 4512(are)N 695(no)X 795(longer)X 1020(of)X 1107(interest.)X 576 6183(rev)N 699(1.61,)X 879(3)X 939(Apr)X 1084(2006)X 2217(-)X 2264(36)X 2364(-)X 37 p %%Page: 37 37 0(Courier)xf 0 f 10 s 0 xH 0 xS 0 f 1 f 2217 384(-)N 2264(37)X 2364(-)X 0 f 736 768(Dwarf_Signed)N 1360(cnt;)X 736 864(Dwarf_Weak)N 1264(*weaks;)X 736 960(int)N 928(res;)X 736 1152(res)N 928(=)X 1024(dwarf_get_weaks\(dbg,)X 2032(&weaks,&cnt,)X 2656(&error\);)X 736 1248(if)N 880(\(res)X 1120(==)X 1264(DW_DLV_OK\))X 1792({)X 1120 1440(for)N 1312(\(i)X 1456(=)X 1552(0;)X 1696(i)X 1792(<)X 1888(cnt;)X 2128(++i\))X 2368({)X 1504 1536(/*)N 1648(use)X 1840(weaks[i])X 2272(*/)X 1504 1632(dwarf_dealloc\(dbg,)N 2416(weaks[i],)X 2896(DW_DLA_WEAK_CONTEXT\);)X 1120 1728(})N 1120 1824(dwarf_dealloc\(dbg,)N 2032(weaks,)X 2368(DW_DLA_LIST\);)X 736 1920(})N 3 f 9 s 576 2208(5.9.1.2)N 810(dwarf_weakname\(\))X 0 f 10 s 576 2352(int)N 768(dwarf_weakname\()X 960 2448(Dwarf_Weak)N 1488(weak,)X 960 2544(char)N 1344(**)X 1488(return_name,)X 960 2640(Dwarf_Error)N 1536(*error\))X 1 f 576 2784(The)N 727(function)X 0 f 1048(dwarf_weakname\(\))X 1 f 1843(returns)X 0 f 2121(DW_DLV_OK)X 1 f 2580(and)X 2723(sets)X 0 f 2898(*return_name)X 1 f 3501(to)X 3590(a)X 3653(pointer)X 3907(to)X 3996(a)X 576 2880(null-terminated)N 1094(string)X 1300(that)X 1444(names)X 1673(the)X 1795(weak)X 1989(name)X 2187(represented)X 2581(by)X 2684(the)X 0 f 2833(Dwarf_Weak)X 1 f 3336(descriptor,)X 0 f 3728(weak)X 1 f (.)S 3983(It)X 576 2976(returns)N 0 f 852(DW_DLV_ERROR)X 1 f 1453(on)X 1558(error.)X 1780(It)X 1854(never)X 2058(returns)X 0 f 2334(DW_DLV_NO_ENTRY)X 1 f (.)S 3119(On)X 3242(a)X 3303(successful)X 3658(return)X 3876(from)X 576 3072(this)N 746(function,)X 1088(the)X 1241(string)X 1478(should)X 1746(be)X 1877(free'd)X 2125(using)X 0 f 2381(dwarf_dealloc\(\))X 1 f (,)S 3176(with)X 3372(the)X 3524(allocation)X 3894(type)X 0 f 576 3168(DW_DLA_STRING)N 1 f 1220(when)X 1414(no)X 1514(longer)X 1739(of)X 1826(interest.)X 0 f 576 3408(int)N 768(dwarf_weak_die_offset\()X 960 3504(Dwarf_Weak)N 1488(weak,)X 960 3600(Dwarf_Off)N 1488(*return_offset,)X 960 3696(Dwarf_Error)N 1536(*error\))X 1 f 576 3840(The)N 732(function)X 0 f 1058(dwarf_weak_die_offset\(\))X 1 f 2193(returns)X 0 f 2475(DW_DLV_OK)X 1 f 2938(and)X 3086(sets)X 0 f 3266(*return_offset)X 1 f 3970(to)X 576 3936(the)N 699(offset)X 907(in)X 994(the)X 1117(section)X 1369(containing)X 1732(DIE's,)X 1969(i.e.)X 2092(.debug_info,)X 2522(of)X 2614(the)X 2737(DIE)X 2896(representing)X 3318(the)X 3441(weak)X 3636(name)X 3835(that)X 3979(is)X 576 4032(described)N 924(by)X 1044(the)X 0 f 1210(Dwarf_Weak)X 1 f 1730(descriptor,)X 0 f 2139(weak)X 1 f (.)S 2411(It)X 2500(returns)X 0 f 2791(DW_DLV_ERROR)X 1 f 3407(on)X 3527(error.)X 3764(It)X 3853(never)X 576 4128(returns)N 0 f 847(DW_DLV_NO_ENTRY)X 1 f (.)S 3 f 9 s 576 4368(5.9.1.3)N 810(dwarf_weak_cu_offset\(\))X 0 f 10 s 576 4512(int)N 768(dwarf_weak_cu_offset\()X 960 4608(Dwarf_Weak)N 1488(weak,)X 960 4704(Dwarf_Off)N 1488(*return_offset,)X 960 4800(Dwarf_Error)N 1536(*error\))X 1 f 576 4944(The)N 723(function)X 0 f 1040(dwarf_weak_cu_offset\(\))X 1 f 2118(returns)X 0 f 2391(DW_DLV_OK)X 1 f 2845(and)X 2983(sets)X 0 f 3154(*return_offset)X 1 f 3849(to)X 3934(the)X 576 5040(offset)N 784(in)X 871(the)X 994(section)X 1246(containing)X 1609(DIE's,)X 1846(i.e.)X 1969(.debug_info,)X 2399(of)X 2491(the)X 2614(compilation-unit)X 3171(header)X 3410(of)X 3501(the)X 3623(compilation-)X 576 5136(unit)N 748(that)X 917(contains)X 1233(the)X 1380(weak)X 1599(name)X 1822(described)X 2179(by)X 2308(the)X 0 f 2483(Dwarf_Weak)X 1 f 3012(descriptor,)X 0 f 3430(weak)X 1 f (.)S 3711(It)X 3809(returns)X 0 f 576 5232(DW_DLV_ERROR)N 1 f 1172(on)X 1272(error.)X 1489(It)X 1558(never)X 1757(returns)X 0 f 2028(DW_DLV_NO_ENTRY)X 1 f (.)S 3 f 9 s 576 5472(5.9.1.4)N 810(dwarf_weak_name_offsets\(\))X 1 f 10 s 576 6183(rev)N 699(1.61,)X 879(3)X 939(Apr)X 1084(2006)X 2217(-)X 2264(37)X 2364(-)X 38 p %%Page: 38 38 0(Courier)xf 0 f 10 s 0 xH 0 xS 0 f 1 f 2217 384(-)N 2264(38)X 2364(-)X 0 f 576 768(int)N 768(dwarf_weak_name_offsets\()X 960 864(Dwarf_Weak)N 1488(weak,)X 960 960(char)N 1200(**)X 1392(weak_name,)X 960 1056(Dwarf_Off)N 1440(*die_offset,)X 960 1152(Dwarf_Off)N 1440(*cu_offset,)X 960 1248(Dwarf_Error)N 1536(*error\))X 1 f 576 1392(The)N 735(function)X 0 f 1064(dwarf_weak_name_offsets\(\))X 1 f 2298(returns)X 0 f 2583(DW_DLV_OK)X 1 f 3050(and)X 3201(sets)X 0 f 3384(*weak_name)X 1 f 3899(to)X 3996(a)X 576 1488(pointer)N 828(to)X 915(a)X 976(null-terminated)X 1495(string)X 1702(that)X 1847(gives)X 2041(the)X 2163(name)X 2361(of)X 2452(the)X 2574(weak)X 2768(name)X 2966(described)X 3298(by)X 3402(the)X 0 f 3552(Dwarf_Weak)X 1 f 576 1584(descriptor)N 0 f 955(weak)X 1 f (.)S 1217(It)X 1296(also)X 1455(returns)X 1708(in)X 1800(the)X 1928(locations)X 2247(pointed)X 2517(to)X 2609(by)X 0 f 2747(die_offset)X 1 f (,)S 3277(and)X 0 f 3451(cu_offset)X 1 f (,)S 3934(the)X 576 1680(offsets)N 819(of)X 915(the)X 1042(DIE)X 1205(representing)X 1631(the)X 1758(weakname,)X 2150(and)X 2294(the)X 2420(DIE)X 2582(representing)X 3007(the)X 3133(compilation-unit)X 3694(containing)X 576 1776(the)N 770(weakname,)X 1230(respectively.)X 1754(It)X 1899(returns)X 0 f 2246(DW_DLV_ERROR)X 1 f 2918(on)X 3094(error.)X 3387(It)X 3533(never)X 3809(returns)X 0 f 576 1872(DW_DLV_NO_ENTRY)N 1 f (.)S 1377(On)X 1516(a)X 1593(successful)X 1964(return)X 2197(from)X 0 f 2422(dwarf_weak_name_offsets\(\))X 1 f 3662(the)X 3800(storage)X 576 1968(pointed)N 857(to)X 960(by)X 0 f 1109(weak_name)X 1 f 1582(should)X 1836(be)X 1953(free'd)X 2187(using)X 0 f 2430(dwarf_dealloc\(\))X 1 f (,)S 3212(with)X 3396(the)X 3536(allocation)X 3894(type)X 0 f 576 2064(DW_DLA_STRING)N 1 f 1220(when)X 1414(no)X 1514(longer)X 1739(of)X 1826(interest.)X 3 f 11 s 576 2304(5.10)N 774(Static)X 1011(Function)X 1371(Names)X 1646(Operations)X 1 f 10 s 576 2448(This)N 738(section)X 985(is)X 1058(SGI)X 1207(specific)X 1477(and)X 1613(is)X 1686(not)X 1808(part)X 1953(of)X 2040(standard)X 2332(DWARF)X 2641(version)X 2897(2.)X 576 2592(These)N 832(function)X 1163(operate)X 1464(on)X 1608(the)X 1770(.debug_funcnames)X 2438(section)X 2729(of)X 2860(the)X 3022(debugging)X 3424(information.)X 3907(The)X 576 2688(.debug_funcnames)N 1209(section)X 1465(contains)X 1761(the)X 1888(names)X 2122(of)X 2218(static)X 2416(functions)X 2742(defined)X 3011(in)X 3101(the)X 3227(object,)X 3471(the)X 3597(offsets)X 3839(of)X 3934(the)X 0 f 576 2784(DIE)N 1 f (s)S 787(that)X 943(represent)X 1274(the)X 1408(definitions)X 1787(of)X 1891(the)X 2026(corresponding)X 2522(functions,)X 2877(and)X 3030(the)X 3165(offsets)X 3416(of)X 3520(the)X 3655(start)X 3830(of)X 3934(the)X 576 2880(compilation-units)N 1160(that)X 1300(contain)X 1556(the)X 1674(definitions)X 2036(of)X 2123(those)X 2312(functions.)X 3 f 576 3120(5.10.1)N 816(Debugger)X 1170(Interface)X 1503(Operations)X 9 s 576 3408(5.10.1.1)N 846(dwarf_get_funcs\(\))X 0 f 10 s 576 3552(int)N 768(dwarf_get_funcs\()X 960 3648(Dwarf_Debug)N 1536(dbg,)X 960 3744(Dwarf_Func)N 1488(**funcs,)X 960 3840(Dwarf_Signed)N 1584(*func_count,)X 960 3936(Dwarf_Error)N 1536(*error\))X 1 f 576 4080(The)N 731(function)X 0 f 1057(dwarf_get_funcs\(\))X 1 f 1904(returns)X 0 f 2186(DW_DLV_OK)X 1 f 2649(and)X 2796(sets)X 0 f 2975(*func_count)X 1 f 3534(to)X 3627(the)X 3756(count)X 3965(of)X 576 4176(static)N 766(function)X 1054(names)X 1280(represented)X 1672(in)X 1755(the)X 1874(section)X 2122(containing)X 2480(static)X 2669(function)X 2956(names,)X 3201(i.e.)X 3319(.debug_funcnames.)X 3983(It)X 576 4272(also)N 742(stores,)X 986(at)X 0 f 1109(*funcs)X 1 f (,)S 1454(a)X 1527(pointer)X 1791(to)X 1890(a)X 1963(list)X 2097(of)X 0 f 2229(Dwarf_Func)X 1 f 2746(descriptors,)X 3155(one)X 3308(for)X 3439(each)X 3624(of)X 3728(the)X 3863(static)X 576 4368(functions)N 930(in)X 1047(the)X 1200(.debug_funcnames)X 1859(section.)X 2181(It)X 2285(returns)X 0 f 2591(DW_DLV_NOCOUNT)X 1 f 3318(on)X 3453(error.)X 3705(It)X 3809(returns)X 0 f 576 4464(DW_DLV_NO_ENTRY)N 1 f 1316(if)X 1385(the)X 1503(.debug_funcnames)X 2127(section)X 2374(does)X 2541(not)X 2663(exist.)X 576 4608(On)N 704(a)X 771(successful)X 1132(return)X 1355(from)X 0 f 1570(dwarf_get_funcs\(\))X 1 f (,)S 2437(the)X 0 f 2594(Dwarf_Func)X 1 f 3105(descriptors)X 3488(should)X 3732(be)X 3839(free'd)X 576 4704(using)N 0 f 797(dwarf_funcs_dealloc\(\))X 1 f (.)S 0 f 1921(dwarf_funcs_dealloc\(\))X 1 f 2949(is)X 3022(new)X 3176(as)X 3263(of)X 3350(July)X 3503(15,)X 3623(2005.)X 576 6183(rev)N 699(1.61,)X 879(3)X 939(Apr)X 1084(2006)X 2217(-)X 2264(38)X 2364(-)X 39 p %%Page: 39 39 0(Courier)xf 0 f 10 s 0 xH 0 xS 0 f 1 f 2217 384(-)N 2264(39)X 2364(-)X 0 f 736 768(Dwarf_Signed)N 1360(cnt;)X 736 864(Dwarf_Func)N 1264(*funcs;)X 736 960(int)N 928(fres;)X 736 1152(fres)N 976(=)X 1072(dwarf_get_funcs\(dbg,)X 2080(&funcs,)X 2464(&error\);)X 736 1248(if)N 880(\(fres)X 1168(==)X 1312(DW_DLV_OK\))X 1840({)X 1120 1440(for)N 1312(\(i)X 1456(=)X 1552(0;)X 1696(i)X 1792(<)X 1888(cnt;)X 2128(++i\))X 2368({)X 1504 1536(/*)N 1648(use)X 1840(funcs[i])X 2272(*/)X 1120 1632(})N 1120 1728(dwarf_funcs_dealloc\(dbg,)N 2320(funcs,)X 2656(cnt\);)X 736 1824(})N 1 f 576 2208(The)N 737(following)X 1085(code)X 1274(is)X 1364(deprecated)X 1750(as)X 1854(of)X 1958(July)X 2128(15,)X 2265(2005)X 2462(as)X 2566(it)X 2647(does)X 2831(not)X 2970(free)X 3133(all)X 3250(relevant)X 3546(memory.)X 3890(This)X 576 2304(approach)N 922(still)X 1072(works)X 1299(as)X 1397(well)X 1566(as)X 1663(it)X 1737(ever)X 1906(did.)X 2078(On)X 2206(a)X 2272(successful)X 2632(return)X 2854(from)X 0 f 3068(dwarf_get_funcs\(\))X 1 f (,)S 3934(the)X 0 f 576 2400(Dwarf_Func)N 1 f 1083(descriptors)X 1463(should)X 1704(be)X 1808(individually)X 2222(free'd)X 2443(using)X 0 f 2672(dwarf_dealloc\(\))X 1 f 3420(with)X 3590(the)X 3716(allocation)X 576 2496(type)N 0 f 786(DW_DLA_FUNC_CONTEXT)X 1 f (,)S 1762(\(or)X 0 f 1928(DW_DLA_FUNC)X 1 f (,)S 2519(an)X 2638(older)X 2846(name,)X 3083(supported)X 3442(for)X 3579(compatibility\))X 576 2592(followed)N 881(by)X 981(the)X 1099(deallocation)X 1511(of)X 1598(the)X 1716(list)X 1833(itself)X 2013(with)X 2175(the)X 2293(allocation)X 2630(type)X 0 f 2817(DW_DLA_LIST)X 1 f 3366(when)X 3561(the)X 3680(descriptors)X 576 2688(are)N 695(no)X 795(longer)X 1020(of)X 1107(interest.)X 0 f 736 2928(Dwarf_Signed)N 1360(cnt;)X 736 3024(Dwarf_Func)N 1264(*funcs;)X 736 3120(int)N 928(fres;)X 736 3312(fres)N 976(=)X 1072(dwarf_get_funcs\(dbg,)X 2080(&funcs,)X 2464(&error\);)X 736 3408(if)N 880(\(fres)X 1168(==)X 1312(DW_DLV_OK\))X 1840({)X 1120 3600(for)N 1312(\(i)X 1456(=)X 1552(0;)X 1696(i)X 1792(<)X 1888(cnt;)X 2128(++i\))X 2368({)X 1504 3696(/*)N 1648(use)X 1840(funcs[i])X 2272(*/)X 1504 3792(dwarf_dealloc\(dbg,)N 2416(funcs[i],)X 2896(DW_DLA_FUNC_CONTEXT\);)X 1120 3888(})N 1120 3984(dwarf_dealloc\(dbg,)N 2032(funcs,)X 2368(DW_DLA_LIST\);)X 736 4080(})N 3 f 9 s 576 4368(5.10.1.2)N 846(dwarf_funcname\(\))X 0 f 10 s 576 4512(int)N 768(dwarf_funcname\()X 960 4608(Dwarf_Func)N 1488(func,)X 960 4704(char)N 1200(**)X 1488(return_name,)X 960 4800(Dwarf_Error)N 1536(*error\))X 1 f 576 4944(The)N 727(function)X 0 f 1048(dwarf_funcname\(\))X 1 f 1843(returns)X 0 f 2121(DW_DLV_OK)X 1 f 2580(and)X 2723(sets)X 0 f 2898(*return_name)X 1 f 3501(to)X 3590(a)X 3653(pointer)X 3907(to)X 3996(a)X 576 5040(null-terminated)N 1094(string)X 1300(that)X 1444(names)X 1673(the)X 1795(static)X 1988(function)X 2279(represented)X 2673(by)X 2776(the)X 0 f 2925(Dwarf_Func)X 1 f 3428(descriptor,)X 0 f 3820(func)X 1 f (.)S 576 5136(It)N 659(returns)X 0 f 944(DW_DLV_ERROR)X 1 f 1554(on)X 1668(error.)X 1899(It)X 1982(never)X 2195(returns)X 0 f 2480(DW_DLV_NO_ENTRY)X 1 f (.)S 3274(On)X 3406(a)X 3476(successful)X 3840(return)X 576 5232(from)N 771(this)X 925(function,)X 1251(the)X 1388(string)X 1609(should)X 1861(be)X 1976(free'd)X 2207(using)X 0 f 2446(dwarf_dealloc\(\))X 1 f (,)S 3224(with)X 3404(the)X 3540(allocation)X 3894(type)X 0 f 576 5328(DW_DLA_STRING)N 1 f 1220(when)X 1414(no)X 1514(longer)X 1739(of)X 1826(interest.)X 3 f 9 s 576 5568(5.10.1.3)N 846(dwarf_func_die_offset\(\))X 1 f 10 s 576 6183(rev)N 699(1.61,)X 879(3)X 939(Apr)X 1084(2006)X 2217(-)X 2264(39)X 2364(-)X 40 p %%Page: 40 40 0(Courier)xf 0 f 10 s 0 xH 0 xS 0 f 1 f 2217 384(-)N 2264(40)X 2364(-)X 0 f 576 768(int)N 768(dwarf_func_die_offset\()X 960 864(Dwarf_Func)N 1488(func,)X 960 960(Dwarf_Off)N 1488(*return_offset,)X 960 1056(Dwarf_Error)N 1536(*error\))X 1 f 576 1200(The)N 729(function)X 0 f 1053(dwarf_func_die_offset\(\))X 1 f (,)S 2206(returns)X 0 f 2486(DW_DLV_OK)X 1 f 2947(and)X 3092(sets)X 0 f 3269(*return_offset)X 1 f 3970(to)X 576 1296(the)N 699(offset)X 906(in)X 992(the)X 1114(section)X 1365(containing)X 1727(DIE's,)X 1963(i.e.)X 2085(.debug_info,)X 2514(of)X 2605(the)X 2727(DIE)X 2885(representing)X 3306(the)X 3428(static)X 3621(function)X 3912(that)X 576 1392(is)N 661(described)X 1001(by)X 1114(the)X 0 f 1273(Dwarf_Func)X 1 f 1786(descriptor,)X 0 f 2188(func)X 1 f (.)S 2453(It)X 2535(returns)X 0 f 2819(DW_DLV_ERROR)X 1 f 3428(on)X 3541(error.)X 3771(It)X 3853(never)X 576 1488(returns)N 0 f 847(DW_DLV_NO_ENTRY)X 1 f (.)S 3 f 9 s 576 1728(5.10.1.4)N 846(dwarf_func_cu_offset\(\))X 0 f 10 s 576 1872(int)N 768(dwarf_func_cu_offset\()X 960 1968(Dwarf_Func)N 1488(func,)X 960 2064(Dwarf_Off)N 1488(*return_offset,)X 960 2160(Dwarf_Error)N 1536(*error\))X 1 f 576 2304(The)N 723(function)X 0 f 1040(dwarf_func_cu_offset\(\))X 1 f 2118(returns)X 0 f 2391(DW_DLV_OK)X 1 f 2845(and)X 2983(sets)X 0 f 3154(*return_offset)X 1 f 3849(to)X 3934(the)X 576 2400(offset)N 784(in)X 871(the)X 994(section)X 1246(containing)X 1609(DIE's,)X 1846(i.e.)X 1969(.debug_info,)X 2399(of)X 2491(the)X 2614(compilation-unit)X 3171(header)X 3410(of)X 3501(the)X 3623(compilation-)X 576 2496(unit)N 741(that)X 902(contains)X 1211(the)X 1351(static)X 1562(function)X 1871(described)X 2221(by)X 2343(the)X 0 f 2511(Dwarf_Func)X 1 f 3033(descriptor,)X 0 f 3444(func)X 1 f (.)S 3718(It)X 3809(returns)X 0 f 576 2592(DW_DLV_ERROR)N 1 f 1172(on)X 1272(error.)X 1489(It)X 1558(never)X 1757(returns)X 0 f 2028(DW_DLV_NO_ENTRY)X 1 f (.)S 3 f 9 s 576 2832(5.10.1.5)N 846(dwarf_func_name_offsets\(\))X 0 f 10 s 576 2976(int)N 768(dwarf_func_name_offsets\()X 960 3072(Dwarf_Func)N 1488(func,)X 960 3168(char)N 1392(**func_name,)X 960 3264(Dwarf_Off)N 1440(*die_offset,)X 960 3360(Dwarf_Off)N 1440(*cu_offset,)X 960 3456(Dwarf_Error)N 1536(*error\))X 1 f 576 3600(The)N 735(function)X 0 f 1064(dwarf_func_name_offsets\(\))X 1 f 2298(returns)X 0 f 2583(DW_DLV_OK)X 1 f 3050(and)X 3201(sets)X 0 f 3384(*func_name)X 1 f 3899(to)X 3996(a)X 576 3696(pointer)N 857(to)X 973(a)X 1063(null-terminated)X 1611(string)X 1847(that)X 2021(gives)X 2244(the)X 2396(name)X 2624(of)X 2745(the)X 2897(static)X 3120(function)X 3440(described)X 3801(by)X 3934(the)X 0 f 576 3792(Dwarf_Func)N 1 f 1095(descriptor)X 0 f 1484(func)X 1 f (.)S 1756(It)X 1845(also)X 2014(returns)X 2277(in)X 2379(the)X 2517(locations)X 2846(pointed)X 3126(to)X 3228(by)X 0 f 3376(die_offset)X 1 f (,)S 3916(and)X 0 f 576 3888(cu_offset)N 1 f (,)S 1071(the)X 1212(offsets)X 1469(of)X 1579(the)X 1720(DIE)X 1897(representing)X 2337(the)X 2478(static)X 2690(function,)X 3020(and)X 3179(the)X 3319(DIE)X 3495(representing)X 3934(the)X 576 3984(compilation-unit)N 1145(containing)X 1519(the)X 1653(static)X 1858(function,)X 2181(respectively.)X 2645(It)X 2731(returns)X 0 f 3019(DW_DLV_ERROR)X 1 f 3632(on)X 3749(error.)X 3983(It)X 576 4080(never)N 784(returns)X 0 f 1064(DW_DLV_NO_ENTRY)X 1 f (.)S 1852(On)X 1978(a)X 2042(successful)X 2400(return)X 2620(from)X 0 f 2832(dwarf_func_name_offsets\(\))X 1 f 576 4176(the)N 695(storage)X 949(pointed)X 1211(to)X 1295(by)X 0 f 1445(func_name)X 1 f 1899(should)X 2134(be)X 2232(free'd)X 2447(using)X 0 f 2670(dwarf_dealloc\(\))X 1 f (,)S 3432(with)X 3596(the)X 3716(allocation)X 576 4272(type)N 0 f 762(DW_DLA_STRING)X 1 f 1406(when)X 1600(no)X 1700(longer)X 1925(of)X 2012(interest.)X 3 f 11 s 576 4512(5.11)N 774(User)X 971(Defined)X 1286(Type)X 1499(Names)X 1774(Operations)X 1 f 10 s 576 4656(Section)N 840("debug_typenames")X 1529(is)X 1606(SGI)X 1759(specific)X 2033(and)X 2173(is)X 2250(not)X 2376(part)X 2525(of)X 2616(standard)X 2912(DWARF)X 3225(version)X 3485(2.)X 3589(\(However,)X 3956(an)X 576 4752(identical)N 972(section)X 1319(is)X 1492(part)X 1737(of)X 1924(DWARF)X 2332(version)X 2687(3)X 2846(named)X 3179(".debug_pubtypes",)X 3929(see)X 0 f 576 4848(dwarf_get_pubtypes\(\))N 1 f 1556(above.\))X 576 4992(These)N 829(functions)X 1188(operate)X 1486(on)X 1628(the)X 1788(.debug_typenames)X 2449(section)X 2738(of)X 2867(the)X 3027(debugging)X 3427(information.)X 3907(The)X 576 5088(.debug_typenames)N 1196(section)X 1444(contains)X 1732(the)X 1851(names)X 2077(of)X 2164(file-scope)X 2501(user-defined)X 2923(types,)X 3132(the)X 3250(offsets)X 3484(of)X 3571(the)X 0 f 3717(DIE)X 1 f (s)S 3912(that)X 576 5184(represent)N 893(the)X 1013(definitions)X 1378(of)X 1468(those)X 1660(types,)X 1872(and)X 2011(the)X 2132(offsets)X 2369(of)X 2459(the)X 2580(compilation-units)X 3167(that)X 3310(contain)X 3569(the)X 3690(definitions)X 576 5280(of)N 663(those)X 852(types.)X 3 f 576 5520(5.11.1)N 816(Debugger)X 1170(Interface)X 1503(Operations)X 1 f 576 6183(rev)N 699(1.61,)X 879(3)X 939(Apr)X 1084(2006)X 2217(-)X 2264(40)X 2364(-)X 41 p %%Page: 41 41 0(Courier)xf 0 f 10 s 0 xH 0 xS 0 f 1 f 2217 384(-)N 2264(41)X 2364(-)X 3 f 9 s 576 768(5.11.1.1)N 846(dwarf_get_types\(\))X 0 f 10 s 576 912(int)N 768(dwarf_get_types\()X 960 1008(Dwarf_Debug)N 1536(dbg,)X 960 1104(Dwarf_Type)N 1488(**types,)X 960 1200(Dwarf_Signed)N 1584(*typecount,)X 960 1296(Dwarf_Error)N 1536(*error\))X 1 f 576 1440(The)N 736(function)X 0 f 1066(dwarf_get_types\(\))X 1 f 1917(returns)X 0 f 2203(DW_DLV_OK)X 1 f 2670(and)X 2821(sets)X 0 f 3004(*typecount)X 1 f 3519(to)X 3617(the)X 3751(count)X 3965(of)X 576 1536(user-defined)N 1047(type)X 1254(names)X 1528(represented)X 1968(in)X 2098(the)X 2264(section)X 2559(containing)X 2965(user-defined)X 3435(type)X 3641(names,)X 3934(i.e.)X 576 1632(.debug_typenames.)N 1244(It)X 1322(also)X 1480(stores)X 1696(at)X 0 f 1811(*types)X 1 f (,)S 2148(a)X 2213(pointer)X 2470(to)X 2562(a)X 2628(list)X 2755(of)X 0 f 2880(Dwarf_Type)X 1 f 3390(descriptors,)X 3792(one)X 3938(for)X 576 1728(each)N 749(of)X 841(the)X 964(user-defined)X 1391(type)X 1554(names)X 1784(in)X 1871(the)X 1994(.debug_typenames)X 2617(section.)X 2908(It)X 2981(returns)X 0 f 3256(DW_DLV_NOCOUNT)X 1 f 3952(on)X 576 1824(error.)N 793(It)X 862(returns)X 0 f 1133(DW_DLV_NO_ENTRY)X 1 f 1873(if)X 1942(the)X 2060(.debug_typenames)X 2679(section)X 2926(does)X 3093(not)X 3215(exist.)X 576 2160(On)N 704(a)X 771(successful)X 1132(return)X 1355(from)X 0 f 1570(dwarf_get_types\(\))X 1 f (,)S 2437(the)X 0 f 2594(Dwarf_Type)X 1 f 3105(descriptors)X 3488(should)X 3732(be)X 3839(free'd)X 576 2256(using)N 0 f 809(dwarf_types_dealloc\(\))X 1 f (.)S 0 f 1945(dwarf_types_dealloc\(\))X 1 f 2985(is)X 3069(new)X 3234(as)X 3332(of)X 3430(July)X 3594(15,)X 3725(2005)X 3916(and)X 576 2352(frees)N 753(all)X 853(memory)X 1140(allocated)X 1450(by)X 0 f 1578(dwarf_get_types\(\))X 1 f (.)S 0 f 736 2592(Dwarf_Signed)N 1360(cnt;)X 736 2688(Dwarf_Type)N 1264(*types;)X 736 2784(int)N 928(res;)X 736 2976(res)N 928(=)X 1024(dwarf_get_types\(dbg,)X 2032(&types,&cnt,)X 2656(&error\);)X 736 3072(if)N 880(\(res)X 1120(==)X 1264(DW_DLV_OK\))X 1792({)X 1120 3264(for)N 1312(\(i)X 1456(=)X 1552(0;)X 1696(i)X 1792(<)X 1888(cnt;)X 2128(++i\))X 2368({)X 1504 3360(/*)N 1648(use)X 1840(types[i])X 2272(*/)X 1120 3456(})N 1120 3552(dwarf_types_dealloc\(dbg,)N 2320(types,)X 2656(cnt\);)X 736 3648(})N 1 f 576 4128(The)N 737(following)X 1085(code)X 1274(is)X 1364(deprecated)X 1750(as)X 1854(of)X 1958(July)X 2128(15,)X 2265(2005)X 2462(as)X 2566(it)X 2647(does)X 2831(not)X 2970(free)X 3133(all)X 3250(relevant)X 3546(memory.)X 3890(This)X 576 4224(approach)N 922(still)X 1072(works)X 1299(as)X 1397(well)X 1566(as)X 1663(it)X 1737(ever)X 1906(did.)X 2078(On)X 2206(a)X 2272(successful)X 2632(return)X 2854(from)X 0 f 3068(dwarf_get_types\(\))X 1 f (,)S 3934(the)X 0 f 576 4320(Dwarf_Type)N 1 f 1083(descriptors)X 1463(should)X 1704(be)X 1808(individually)X 2222(free'd)X 2443(using)X 0 f 2672(dwarf_dealloc\(\))X 1 f 3420(with)X 3590(the)X 3716(allocation)X 576 4416(type)N 0 f 800(DW_DLA_TYPENAME_CONTEXT)X 1 f (,)S 1982(\(or)X 0 f 2162(DW_DLA_TYPENAME)X 1 f (,)S 2959(an)X 3092(older)X 3314(name,)X 3565(supported)X 3938(for)X 576 4512(compatibility\))N 1050(followed)X 1356(by)X 1457(the)X 1576(deallocation)X 1989(of)X 2077(the)X 2197(list)X 2316(itself)X 2498(with)X 2662(the)X 2782(allocation)X 3120(type)X 0 f 3308(DW_DLA_LIST)X 1 f 3858(when)X 576 4608(the)N 694(descriptors)X 1066(are)X 1185(no)X 1285(longer)X 1510(of)X 1597(interest.)X 576 6183(rev)N 699(1.61,)X 879(3)X 939(Apr)X 1084(2006)X 2217(-)X 2264(41)X 2364(-)X 42 p %%Page: 42 42 0(Courier)xf 0 f 10 s 0 xH 0 xS 0 f 1 f 2217 384(-)N 2264(42)X 2364(-)X 0 f 736 768(Dwarf_Signed)N 1360(cnt;)X 736 864(Dwarf_Type)N 1264(*types;)X 736 960(int)N 928(res;)X 736 1152(res)N 928(=)X 1024(dwarf_get_types\(dbg,)X 2032(&types,&cnt,)X 2656(&error\);)X 736 1248(if)N 880(\(res)X 1120(==)X 1264(DW_DLV_OK\))X 1792({)X 1120 1440(for)N 1312(\(i)X 1456(=)X 1552(0;)X 1696(i)X 1792(<)X 1888(cnt;)X 2128(++i\))X 2368({)X 1504 1536(/*)N 1648(use)X 1840(types[i])X 2272(*/)X 1504 1632(dwarf_dealloc\(dbg,)N 2416(types[i],)X 2896(DW_DLA_TYPENAME_CONTEXT\);)X 1120 1728(})N 1120 1824(dwarf_dealloc\(dbg,)N 2032(types,)X 2368(DW_DLA_LIST\);)X 736 1920(})N 3 f 9 s 576 2208(5.11.1.2)N 846(dwarf_typename\(\))X 0 f 10 s 576 2352(int)N 768(dwarf_typename\()X 960 2448(Dwarf_Type)N 1584(type,)X 960 2544(char)N 1488(**return_name,)X 960 2640(Dwarf_Error)N 1536(*error\))X 1 f 576 2784(The)N 727(function)X 0 f 1048(dwarf_typename\(\))X 1 f 1843(returns)X 0 f 2121(DW_DLV_OK)X 1 f 2580(and)X 2723(sets)X 0 f 2898(*return_name)X 1 f 3501(to)X 3590(a)X 3653(pointer)X 3907(to)X 3996(a)X 576 2880(null-terminated)N 1109(string)X 1329(that)X 1487(names)X 1730(the)X 1866(user-defined)X 2306(type)X 2482(represented)X 2891(by)X 3009(the)X 0 f 3173(Dwarf_Type)X 1 f 3691(descriptor,)X 0 f 576 2976(type)N 1 f (.)S 838(It)X 917(returns)X 0 f 1198(DW_DLV_ERROR)X 1 f 1804(on)X 1915(error.)X 2143(It)X 2223(never)X 2433(returns)X 0 f 2715(DW_DLV_NO_ENTRY)X 1 f (.)S 3506(On)X 3635(a)X 3702(successful)X 576 3072(return)N 791(from)X 969(this)X 1106(function,)X 1415(the)X 1535(string)X 1739(should)X 1974(be)X 2072(free'd)X 2287(using)X 0 f 2510(dwarf_dealloc\(\))X 1 f (,)S 3272(with)X 3436(the)X 3556(allocation)X 3894(type)X 0 f 576 3168(DW_DLA_STRING)N 1 f 1220(when)X 1414(no)X 1514(longer)X 1739(of)X 1826(interest.)X 3 f 9 s 576 3408(5.11.1.3)N 846(dwarf_type_die_offset\(\))X 0 f 10 s 576 3552(int)N 768(dwarf_type_die_offset\()X 960 3648(Dwarf_Type)N 1488(type,)X 960 3744(Dwarf_Off)N 1488(*return_offset,)X 960 3840(Dwarf_Error)N 1536(*error\))X 1 f 576 3984(The)N 732(function)X 0 f 1058(dwarf_type_die_offset\(\))X 1 f 2193(returns)X 0 f 2475(DW_DLV_OK)X 1 f 2938(and)X 3086(sets)X 0 f 3266(*return_offset)X 1 f 3970(to)X 576 4080(the)N 701(offset)X 911(in)X 1000(the)X 1125(section)X 1379(containing)X 1744(DIE's,)X 1983(i.e.)X 2108(.debug_info,)X 2540(of)X 2634(the)X 2759(DIE)X 2919(representing)X 3342(the)X 3466(user-defined)X 3894(type)X 576 4176(that)N 717(is)X 792(described)X 1122(by)X 1224(the)X 0 f 1372(Dwarf_Type)X 1 f 1874(descriptor,)X 0 f 2265(type)X 1 f (.)S 2519(It)X 2590(returns)X 0 f 2863(DW_DLV_ERROR)X 1 f 3461(on)X 3563(error.)X 3782(It)X 3853(never)X 576 4272(returns)N 0 f 847(DW_DLV_NO_ENTRY)X 1 f (.)S 3 f 9 s 576 4512(5.11.1.4)N 846(dwarf_type_cu_offset\(\))X 0 f 10 s 576 4656(int)N 768(dwarf_type_cu_offset\()X 960 4752(Dwarf_Type)N 1488(type,)X 960 4848(Dwarf_Off)N 1488(*return_offset,)X 960 4944(Dwarf_Error)N 1536(*error\))X 1 f 576 5088(The)N 723(function)X 0 f 1040(dwarf_type_cu_offset\(\))X 1 f 2118(returns)X 0 f 2391(DW_DLV_OK)X 1 f 2845(and)X 2983(sets)X 0 f 3154(*return_offset)X 1 f 3849(to)X 3934(the)X 576 5184(offset)N 784(in)X 871(the)X 994(section)X 1246(containing)X 1609(DIE's,)X 1846(i.e.)X 1969(.debug_info,)X 2399(of)X 2491(the)X 2614(compilation-unit)X 3171(header)X 3410(of)X 3501(the)X 3623(compilation-)X 576 5280(unit)N 733(that)X 886(contains)X 1187(the)X 1319(user-defined)X 1755(type)X 1927(described)X 2269(by)X 2383(the)X 0 f 2543(Dwarf_Type)X 1 f 3057(descriptor,)X 0 f 3460(type)X 1 f (.)S 3726(It)X 3809(returns)X 0 f 576 5376(DW_DLV_ERROR)N 1 f 1172(on)X 1272(error.)X 1489(It)X 1558(never)X 1757(returns)X 0 f 2028(DW_DLV_NO_ENTRY)X 1 f (.)S 3 f 9 s 576 5616(5.11.1.5)N 846(dwarf_type_name_offsets\(\))X 1 f 10 s 576 6183(rev)N 699(1.61,)X 879(3)X 939(Apr)X 1084(2006)X 2217(-)X 2264(42)X 2364(-)X 43 p %%Page: 43 43 0(Courier)xf 0 f 10 s 0 xH 0 xS 0 f 1 f 2217 384(-)N 2264(43)X 2364(-)X 0 f 576 768(int)N 768(dwarf_type_name_offsets\()X 960 864(Dwarf_Type)N 1584(type,)X 960 960(char)N 1440(**)X 1584(returned_name,)X 960 1056(Dwarf_Off)N 1440(*)X 1584(die_offset,)X 960 1152(Dwarf_Off)N 1440(*)X 1584(cu_offset,)X 960 1248(Dwarf_Error)N 1536(*error\))X 1 f 576 1392(The)N 732(function)X 0 f 1058(dwarf_type_name_offsets\(\))X 1 f 2289(returns)X 0 f 2571(DW_DLV_OK)X 1 f 3034(and)X 3181(sets)X 0 f 3360(*returned_name)X 1 f 576 1488(to)N 674(a)X 746(pointer)X 1009(to)X 1107(a)X 1179(null-terminated)X 1709(string)X 1927(that)X 2083(gives)X 2288(the)X 2422(name)X 2631(of)X 2733(the)X 2866(user-defined)X 3303(type)X 3476(described)X 3819(by)X 3934(the)X 0 f 576 1584(Dwarf_Type)N 1 f 1095(descriptor)X 0 f 1484(type)X 1 f (.)S 1756(It)X 1845(also)X 2014(returns)X 2277(in)X 2379(the)X 2517(locations)X 2846(pointed)X 3126(to)X 3228(by)X 0 f 3376(die_offset)X 1 f (,)S 3916(and)X 0 f 576 1680(cu_offset)N 1 f (,)S 1064(the)X 1198(offsets)X 1448(of)X 1551(the)X 1685(DIE)X 1854(representing)X 2286(the)X 2419(user-defined)X 2856(type,)X 3049(and)X 3200(the)X 3333(DIE)X 3502(representing)X 3934(the)X 576 1776(compilation-unit)N 1136(containing)X 1501(the)X 1626(user-defined)X 2055(type,)X 2240(respectively.)X 2695(It)X 2771(returns)X 0 f 3049(DW_DLV_ERROR)X 1 f 3652(on)X 3759(error.)X 3983(It)X 576 1872(never)N 784(returns)X 0 f 1064(DW_DLV_NO_ENTRY)X 1 f (.)S 1852(On)X 1978(a)X 2042(successful)X 2400(return)X 2620(from)X 0 f 2832(dwarf_type_name_offsets\(\))X 1 f 576 1968(the)N 709(storage)X 976(pointed)X 1251(to)X 1349(by)X 0 f 1493(returned_name)X 1 f 2153(should)X 2402(be)X 2514(free'd)X 2743(using)X 0 f 2980(dwarf_dealloc\(\))X 1 f (,)S 3756(with)X 3934(the)X 576 2064(allocation)N 912(type)X 0 f 1098(DW_DLA_STRING)X 1 f 1742(when)X 1936(no)X 2036(longer)X 2261(of)X 2348(interest.)X 3 f 11 s 576 2400(5.12)N 774(User)X 971(Defined)X 1286(Static)X 1523(Variable)X 1873(Names)X 2148(Operations)X 1 f 10 s 576 2544(This)N 738(section)X 985(is)X 1058(SGI)X 1207(specific)X 1477(and)X 1613(is)X 1686(not)X 1808(part)X 1953(of)X 2040(standard)X 2332(DWARF)X 2641(version)X 2897(2.)X 576 2688(These)N 832(functions)X 1195(operate)X 1497(on)X 1642(the)X 1805(.debug_varnames)X 2434(section)X 2726(of)X 2858(the)X 3021(debugging)X 3424(information.)X 3907(The)X 576 2784(.debug_varnames)N 1171(section)X 1429(contains)X 1727(the)X 1856(names)X 2092(of)X 2190(file-scope)X 2538(static)X 2738(variables,)X 3079(the)X 3208(offsets)X 3453(of)X 3551(the)X 0 f 3707(DIE)X 1 f (s)S 3912(that)X 576 2880(represent)N 911(the)X 1049(definitions)X 1431(of)X 1538(those)X 1747(variables,)X 2097(and)X 2253(the)X 2391(offsets)X 2645(of)X 2752(the)X 2891(compilation-units)X 3496(that)X 3657(contain)X 3934(the)X 576 2976(definitions)N 938(of)X 1025(those)X 1214(variables.)X 3 f 576 3264(5.12.1)N 816(Debugger)X 1170(Interface)X 1503(Operations)X 9 s 576 3552(5.12.1.1)N 846(dwarf_get_vars\(\))X 0 f 10 s 576 3840(int)N 768(dwarf_get_vars\()X 960 3936(Dwarf_Debug)N 1536(dbg,)X 960 4032(Dwarf_Var)N 1440(**vars,)X 960 4128(Dwarf_Signed)N 1584(*var_count,)X 960 4224(Dwarf_Error)N 1536(*error\))X 1 f 576 4368(The)N 726(function)X 0 f 1046(dwarf_get_vars\(\))X 1 f 1839(returns)X 0 f 2115(DW_DLV_OK)X 1 f 2572(and)X 2713(sets)X 0 f 2886(*var_count)X 1 f 3391(to)X 3478(the)X 3601(count)X 3805(of)X 3898(file-)X 576 4464(scope)N 796(static)X 1002(variable)X 1298(names)X 1540(represented)X 1948(in)X 2047(the)X 2182(section)X 2446(containing)X 2820(file-scope)X 3173(static)X 3378(variable)X 3673(names,)X 3934(i.e.)X 576 4560(.debug_varnames.)N 1205(It)X 1279(also)X 1433(stores,)X 1665(at)X 0 f 1776(*vars)X 1 f (,)S 2061(a)X 2122(pointer)X 2374(to)X 2461(a)X 2522(list)X 2645(of)X 0 f 2766(Dwarf_Var)X 1 f 3224(descriptors,)X 3622(one)X 3764(for)X 3884(each)X 576 4656(of)N 674(the)X 803(file-scope)X 1151(static)X 1351(variable)X 1640(names)X 1875(in)X 1967(the)X 2095(.debug_varnames)X 2689(section.)X 2986(It)X 3065(returns)X 0 f 3346(DW_DLV_ERROR)X 1 f 3952(on)X 576 4752(error.)N 793(It)X 862(returns)X 0 f 1133(DW_DLV_NO_ENTRY)X 1 f 1873(if)X 1942(the)X 2060(.debug_varnames)X 2644(section)X 2891(does)X 3058(not)X 3180(exist.)X 576 4992(The)N 737(following)X 1084(is)X 1173(new)X 1343(as)X 1446(of)X 1549(July)X 1718(15,)X 1854(2005.)X 2090(On)X 2224(a)X 2296(successful)X 2662(return)X 2890(from)X 0 f 3110(dwarf_get_vars\(\))X 1 f (,)S 3934(the)X 0 f 576 5088(Dwarf_Var)N 1 f 1028(descriptors)X 1400(should)X 1633(be)X 1729(free'd)X 1942(using)X 0 f 2163(dwarf_vars_dealloc\(\))X 1 f (.)S 576 6183(rev)N 699(1.61,)X 879(3)X 939(Apr)X 1084(2006)X 2217(-)X 2264(43)X 2364(-)X 44 p %%Page: 44 44 0(Courier)xf 0 f 10 s 0 xH 0 xS 0 f 1 f 2217 384(-)N 2264(44)X 2364(-)X 0 f 736 768(Dwarf_Signed)N 1360(cnt;)X 736 864(Dwarf_Var)N 1216(*vars;)X 736 960(int)N 928(res;)X 736 1152(res)N 928(=)X 1024(dwarf_get_vars\(dbg,)X 1984(&vars,&cnt)X 2512(&error\);)X 736 1248(if)N 880(\(res)X 1120(==)X 1264(DW_DLV_OK\))X 1792({)X 1120 1440(for)N 1312(\(i)X 1456(=)X 1552(0;)X 1696(i)X 1792(<)X 1888(cnt;)X 2128(++i\))X 2368({)X 1504 1536(/*)N 1648(use)X 1840(vars[i])X 2224(*/)X 1120 1632(})N 1120 1728(dwarf_vars_dealloc\(dbg,)N 2272(vars,)X 2560(cnt\);)X 736 1824(})N 1 f 576 2112(The)N 737(following)X 1085(code)X 1274(is)X 1364(deprecated)X 1750(as)X 1854(of)X 1958(July)X 2128(15,)X 2265(2005)X 2462(as)X 2566(it)X 2647(does)X 2831(not)X 2970(free)X 3133(all)X 3250(relevant)X 3546(memory.)X 3890(This)X 576 2208(approach)N 925(still)X 1078(works)X 1308(as)X 1409(well)X 1581(as)X 1682(it)X 1760(ever)X 1933(did.)X 2108(On)X 2239(a)X 2308(successful)X 2671(return)X 2896(from)X 0 f 3113(dwarf_get_vars\(\))X 1 f (,)S 3934(the)X 0 f 576 2304(Dwarf_Var)N 1 f 1040(descriptors)X 1424(should)X 1669(be)X 1778(individually)X 2197(free'd)X 2423(using)X 0 f 2657(dwarf_dealloc\(\))X 1 f 3410(with)X 3585(the)X 3716(allocation)X 576 2400(type)N 0 f 763(DW_DLA_VAR_CONTEXT)X 1 f (,)S 1667(\(or)X 0 f 1809(DW_DLA_VAR)X 1 f (,)S 2329(an)X 2425(older)X 2610(name,)X 2824(supported)X 3160(for)X 3274(compatibility\))X 3747(followed)X 576 2496(by)N 681(the)X 804(deallocation)X 1221(of)X 1313(the)X 1436(list)X 1559(itself)X 1745(with)X 1913(the)X 2037(allocation)X 2379(type)X 0 f 2571(DW_DLA_LIST)X 1 f 3125(when)X 3325(the)X 3449(descriptors)X 3827(are)X 3952(no)X 576 2592(longer)N 801(of)X 888(interest.)X 0 f 736 2832(Dwarf_Signed)N 1360(cnt;)X 736 2928(Dwarf_Var)N 1216(*vars;)X 736 3024(int)N 928(res;)X 736 3216(res)N 928(=)X 1024(dwarf_get_vars\(dbg,)X 1984(&vars,&cnt)X 2512(&error\);)X 736 3312(if)N 880(\(res)X 1120(==)X 1264(DW_DLV_OK\))X 1792({)X 1120 3504(for)N 1312(\(i)X 1456(=)X 1552(0;)X 1696(i)X 1792(<)X 1888(cnt;)X 2128(++i\))X 2368({)X 1504 3600(/*)N 1648(use)X 1840(vars[i])X 2224(*/)X 1504 3696(dwarf_dealloc\(dbg,)N 2416(vars[i],)X 2848(DW_DLA_VAR_CONTEXT\);)X 1120 3792(})N 1120 3888(dwarf_dealloc\(dbg,)N 2032(vars,)X 2320(DW_DLA_LIST\);)X 736 3984(})N 3 f 9 s 576 4272(5.12.1.2)N 846(dwarf_varname\(\))X 0 f 10 s 576 4416(int)N 768(dwarf_varname\()X 960 4512(Dwarf_Var)N 1440(var,)X 960 4608(char)N 1200(**)X 1488(returned_name,)X 960 4704(Dwarf_Error)N 1536(*error\))X 1 f 576 4848(The)N 723(function)X 0 f 1040(dwarf_varname\(\))X 1 f 1783(returns)X 0 f 2057(DW_DLV_OK)X 1 f 2512(and)X 2651(sets)X 0 f 2822(*returned_name)X 1 f 3517(to)X 3602(a)X 3661(pointer)X 3911(to)X 3996(a)X 576 4944(null-terminated)N 1092(string)X 1296(that)X 1438(names)X 1665(the)X 1785(file-scope)X 2124(static)X 2315(variable)X 2596(represented)X 2989(by)X 3091(the)X 0 f 3238(Dwarf_Var)X 1 f 3691(descriptor,)X 0 f 576 5040(var)N 1 f (.)S 794(It)X 877(returns)X 0 f 1162(DW_DLV_ERROR)X 1 f 1772(on)X 1887(error.)X 2119(It)X 2203(never)X 2417(returns)X 0 f 2703(DW_DLV_NO_ENTRY)X 1 f (.)S 3498(On)X 3631(a)X 3702(successful)X 576 5136(return)N 791(from)X 969(this)X 1106(function,)X 1415(the)X 1535(string)X 1739(should)X 1974(be)X 2072(free'd)X 2287(using)X 0 f 2510(dwarf_dealloc\(\))X 1 f (,)S 3272(with)X 3436(the)X 3556(allocation)X 3894(type)X 0 f 576 5232(DW_DLA_STRING)N 1 f 1220(when)X 1414(no)X 1514(longer)X 1739(of)X 1826(interest.)X 3 f 9 s 576 5472(5.12.1.3)N 846(dwarf_var_die_offset\(\))X 1 f 10 s 576 6183(rev)N 699(1.61,)X 879(3)X 939(Apr)X 1084(2006)X 2217(-)X 2264(44)X 2364(-)X 45 p %%Page: 45 45 0(Courier)xf 0 f 10 s 0 xH 0 xS 0 f 1 f 2217 384(-)N 2264(45)X 2364(-)X 0 f 576 768(int)N 768(dwarf_var_die_offset\()X 960 864(Dwarf_Var)N 1584(var,)X 960 960(Dwarf_Off)N 1536(*returned_offset,)X 960 1056(Dwarf_Error)N 1536(*error\))X 1 f 576 1200(The)N 726(function)X 0 f 1046(dwarf_var_die_offset\(\))X 1 f 2127(returns)X 0 f 2403(DW_DLV_OK)X 1 f 2860(and)X 3002(sets)X 0 f 3176(*returned_offset)X 1 f 3970(to)X 576 1296(the)N 705(offset)X 919(in)X 1012(the)X 1141(section)X 1399(containing)X 1767(DIE's,)X 2009(i.e.)X 2137(.debug_info,)X 2572(of)X 2669(the)X 2797(DIE)X 2961(representing)X 3388(the)X 3516(file-scope)X 3863(static)X 576 1392(variable)N 858(that)X 1001(is)X 1077(described)X 1408(by)X 1511(the)X 0 f 1660(Dwarf_Var)X 1 f 2115(descriptor,)X 0 f 2507(var)X 1 f (.)S 2714(It)X 2786(returns)X 0 f 3060(DW_DLV_ERROR)X 1 f 3659(on)X 3762(error.)X 3983(It)X 576 1488(never)N 775(returns)X 0 f 1046(DW_DLV_NO_ENTRY)X 1 f (.)S 3 f 9 s 576 1728(5.12.1.4)N 846(dwarf_var_cu_offset\(\))X 0 f 10 s 576 1872(int)N 768(dwarf_var_cu_offset\()X 960 1968(Dwarf_Var)N 1440(var,)X 960 2064(Dwarf_Off)N 1536(*returned_offset,)X 960 2160(Dwarf_Error)N 1536(*error\))X 1 f 576 2304(The)N 732(function)X 0 f 1058(dwarf_var_cu_offset\(\))X 1 f 2097(returns)X 0 f 2379(DW_DLV_OK)X 1 f 2842(and)X 2990(sets)X 0 f 3170(*returned_offset)X 1 f 3970(to)X 576 2400(the)N 721(offset)X 951(in)X 1060(the)X 1205(section)X 1479(containing)X 1864(DIE's,)X 2123(i.e.)X 2268(.debug_info,)X 2720(of)X 2834(the)X 2979(compilation-unit)X 3559(header)X 3821(of)X 3934(the)X 576 2496(compilation-unit)N 1145(that)X 1302(contains)X 1606(the)X 1741(file-scope)X 2095(static)X 2301(variable)X 2597(described)X 2942(by)X 3059(the)X 0 f 3222(Dwarf_Var)X 1 f 3691(descriptor,)X 0 f 576 2592(var)N 1 f (.)S 780(It)X 849(returns)X 0 f 1120(DW_DLV_ERROR)X 1 f 1716(on)X 1816(error.)X 2033(It)X 2102(never)X 2301(returns)X 0 f 2572(DW_DLV_NO_ENTRY)X 1 f (.)S 3 f 9 s 576 2832(5.12.1.5)N 846(dwarf_var_name_offsets\(\))X 0 f 10 s 576 2976(int)N 768(dwarf_var_name_offsets\()X 960 3072(Dwarf_Var)N 1440(var,)X 960 3168(char)N 1392(**returned_name,)X 960 3264(Dwarf_Off)N 1440(*die_offset,)X 960 3360(Dwarf_Off)N 1440(*cu_offset,)X 960 3456(Dwarf_Error)N 1536(*error\))X 1 f 576 3600(The)N 726(function)X 0 f 1046(dwarf_var_name_offsets\(\))X 1 f 2223(returns)X 0 f 2499(DW_DLV_OK)X 1 f 2956(and)X 3098(sets)X 0 f 3272(*returned_name)X 1 f 3970(to)X 576 3696(a)N 640(pointer)X 895(to)X 985(a)X 1048(null-terminated)X 1569(string)X 1778(that)X 1925(gives)X 2121(the)X 2246(name)X 2447(of)X 2541(the)X 2666(file-scope)X 3010(static)X 3206(variable)X 3492(described)X 3827(by)X 3934(the)X 0 f 576 3792(Dwarf_Var)N 1 f 1055(descriptor)X 0 f 1451(var)X 1 f (.)S 1682(It)X 1778(also)X 1954(returns)X 2224(in)X 2333(the)X 2478(locations)X 2814(pointed)X 3102(to)X 3212(by)X 0 f 3368(die_offset)X 1 f (,)S 3916(and)X 0 f 576 3888(cu_offset)N 1 f (,)S 1056(the)X 1182(offsets)X 1424(of)X 1519(the)X 1645(DIE)X 1807(representing)X 2232(the)X 2358(file-scope)X 2703(static)X 2900(variable,)X 3206(and)X 3349(the)X 3474(DIE)X 3635(representing)X 576 3984(the)N 695(compilation-unit)X 1249(containing)X 1609(the)X 1729(file-scope)X 2068(static)X 2259(variable,)X 2560(respectively.)X 3010(It)X 3081(returns)X 0 f 3354(DW_DLV_ERROR)X 1 f 3952(on)X 576 4080(error.)N 908(It)X 1092(never)X 1405(returns)X 0 f 1790(DW_DLV_NO_ENTRY)X 1 f (.)S 2684(On)X 2916(a)X 3086(successful)X 3550(return)X 3876(from)X 0 f 576 4176(dwarf_var_name_offsets\(\))N 1 f 1756(the)X 1882(storage)X 2142(pointed)X 2410(to)X 2500(by)X 0 f 2637(returned_name)X 1 f 3290(should)X 3532(be)X 3637(free'd)X 3859(using)X 0 f 576 4272(dwarf_dealloc\(\))N 1 f (,)S 1336(with)X 1498(the)X 1616(allocation)X 1952(type)X 0 f 2138(DW_DLA_STRING)X 1 f 2782(when)X 2976(no)X 3076(longer)X 3301(of)X 3388(interest.)X 3 f 11 s 576 4512(5.13)N 774(Macro)X 1045(Information)X 1526(Operations)X 10 s 576 4656(5.13.1)N 816(General)X 1112(Macro)X 1360(Operations)X 9 s 576 4800(5.13.1.1)N 846(dwarf_find_macro_value_start\(\))X 0 f 10 s 576 4944(char)N 816(*dwarf_find_macro_value_start\(char)X 2496(*)X 2592(macro_string\);)X 1 f 576 5088(Given)N 801(a)X 866(macro)X 1096(string)X 1307(in)X 1398(the)X 1525(standard)X 1826(form)X 2011(defined)X 2281(in)X 2372(the)X 2500(DWARF)X 2819(document)X 3165(\("name)X 3429()X 3728(value")X 3965(or)X 576 5184 0.2188("name\(args\)value"\))AN 1499(this)X 1639(returns)X 1887(a)X 1947(pointer)X 2198(to)X 2284(the)X 2406(first)X 2559(byte)X 2721(of)X 2812(the)X 2934(macro)X 3159(value.)X 3397(It)X 3470(does)X 3641(not)X 3767(alter)X 3934(the)X 576 5280(string)N 782(pointed)X 1046(to)X 1132(by)X 1236(macro_string)X 1683(or)X 1774(copy)X 1954(the)X 2076(string:)X 2304(it)X 2372(returns)X 2619(a)X 2680(pointer)X 2932(into)X 3081(the)X 3204(string)X 3411(whose)X 3641(address)X 3907(was)X 576 5376(passed)N 810(in.)X 3 f 576 5520(5.13.2)N 816(Debugger)X 1170(Interface)X 1503(Macro)X 1751(Operations)X 1 f 576 5664(Macro)N 809(information)X 1210(is)X 1286(accessed)X 1591(from)X 1770(the)X 1891(.debug_info)X 2299(section)X 2550(via)X 2672(the)X 2794(DW_AT_macro_info)X 3509(attribute)X 3800(\(whose)X 576 5760(value)N 770(is)X 843(an)X 939(offset)X 1142(into)X 1286(.debug_macinfo\).)X 576 6183(rev)N 699(1.61,)X 879(3)X 939(Apr)X 1084(2006)X 2217(-)X 2264(45)X 2364(-)X 46 p %%Page: 46 46 0(Courier)xf 0 f 10 s 0 xH 0 xS 0 f 1 f 2217 384(-)N 2264(46)X 2364(-)X 576 768(No)N 694(Functions)X 1029(yet)X 1147(defined.)X 3 f 576 912(5.13.3)N 816(Low)X 987(Level)X 1194(Macro)X 1442(Information)X 1880(Operations)X 9 s 576 1056(5.13.3.1)N 846(dwarf_get_macro_details\(\))X 0 f 10 s 576 1200(int)N 768(dwarf_get_macro_details\(Dwarf_Debug)X 2496(/*dbg*/,)X 672 1296(Dwarf_Off)N 1776(macro_offset,)X 672 1392(Dwarf_Unsigned)N 1776(maximum_count,)X 672 1488(Dwarf_Signed)N 1680(*)X 1776(entry_count,)X 672 1584(Dwarf_Macro_Details)N 1632(**)X 1776(details,)X 672 1680(Dwarf_Error)N 1248(*)X 1776(err\);)X 576 1824(dwarf_get_macro_details\(\))N 1 f 1810(returns)X 0 f 2095(DW_DLV_OK)X 1 f 2561(and)X 2711(sets)X 0 f 2893(entry_count)X 1 f 3455(to)X 3552(the)X 3685(number)X 3965(of)X 0 f 576 1920(details)N 1 f 936(records)X 1197(returned)X 1489(through)X 1762(the)X 0 f 1912(details)X 1 f 2272(pointer.)X 2563(The)X 2712(data)X 2870(returned)X 3161(thru)X 0 f 3361(details)X 1 f 3720(should)X 3956(be)X 576 2016(freed)N 764(by)X 866(a)X 924(call)X 1062(to)X 0 f 1175(dwarf_dealloc\(\))X 1 f 1918(with)X 2083(the)X 2204(allocation)X 2543(type)X 0 f 2732(DW_DLA_STRING)X 1 f (.)S 3419(If)X 0 f 3524(DW_DLV_OK)X 1 f 3979(is)X 576 2112(returned,)N 892(the)X 0 f 1046(entry_count)X 1 f 1602(will)X 1754(be)X 1858(at)X 1944(least)X 2119(1,)X 2206(since)X 2398(a)X 2461(compilation)X 2870(unit)X 3021(with)X 3190(macro)X 3418(information)X 3823(but)X 3952(no)X 576 2208(macros)N 828(will)X 972(have)X 1144(at)X 1222(least)X 1389(one)X 1525(macro)X 1746(data)X 1900(byte)X 2058(of)X 2145(0.)X 0 f 576 2352(dwarf_get_macro_details\(\))N 1 f 1808(begins)X 2049(at)X 2139(the)X 0 f 2297(macro_offset)X 1 f 2905(offset)X 3120(you)X 3272(supply)X 3517(and)X 3665(ends)X 3844(at)X 3934(the)X 576 2448(end)N 748(of)X 871(a)X 963(compilation)X 1401(unit)X 1581(or)X 1704(at)X 0 f 1846(maximum_count)X 1 f 2525(detail)X 2758(records)X 3050(\(whichever)X 3467(comes)X 3727(first\).)X 3978(If)X 0 f 576 2544(maximum_count)N 1 f 1220(is)X 1293(0,)X 1373(it)X 1437(is)X 1510(treated)X 1749(as)X 1836(if)X 1905(it)X 1969(were)X 2146(the)X 2264(maximum)X 2608(possible)X 2890(unsigned)X 3199(integer.)X 0 f 576 2688(dwarf_get_macro_details\(\))N 1 f 1821(attempts)X 2137(to)X 2244(set)X 0 f 2406(dmd_fileindex)X 1 f 3075(to)X 3182(the)X 3325(correct)X 3594(file)X 3746(in)X 3853(every)X 0 f 576 2784(details)N 1 f 955(record.)X 1224(If)X 1321(it)X 1408(is)X 1504(unable)X 1761(to)X 1866(do)X 1988(so)X 2101(\(or)X 2237(whenever)X 2592(the)X 2732(current)X 3002(file)X 3151(index)X 3371(is)X 3466(unknown,)X 3826(it)X 3912(sets)X 0 f 576 2880(dmd_fileindex)N 1 f 1220(to)X 1302(-1.)X 0 f 576 3024(dwarf_get_macro_details\(\))N 1 f 1922(returns)X 0 f 2319(DW_DLV_ERROR)X 1 f 3042(on)X 3269(error.)X 3613(It)X 3809(returns)X 0 f 576 3120(DW_DLV_NO_ENTRY)N 1 f 1369(if)X 1490(there)X 1723(is)X 1848(no)X 2000(more)X 2237(macro)X 2510(information)X 2960(at)X 3090(that)X 0 f 3310(macro_offset)X 1 f (.)S 3978(If)X 0 f 576 3216(macro_offset)N 1 f 1172(is)X 1245(passed)X 1479(in)X 1561(as)X 1648(0,)X 1728(a)X 0 f 1812(DW_DLV_NO_ENTRY)X 1 f 2552(return)X 2764(means)X 2989(there)X 3170(is)X 3243(no)X 3343(macro)X 3564(information.)X 0 f 736 3360(Dwarf_Unsigned)N 1456(max)X 1648(=)X 1744(0;)X 736 3456(Dwarf_Off)N 1216(cur_off)X 1600(=)X 1696(0;)X 736 3552(Dwarf_Signed)N 1360(count)X 1648(=)X 1744(0;)X 736 3648(Dwarf_Macro_Details)N 1696(*maclist;)X 736 3744(int)N 928(errv;)X 736 3936(/*)N 880(loop)X 1120(thru)X 1360(all)X 1552(the)X 1744(compilation)X 2320(units)X 2608(macro)X 2896(info)X 3136(*/)X 736 4032(while\(\(errv)N 1312(=)X 1408(dwarf_macro_details\(dbg,)X 2608(cur_off,max,)X 976 4128(&count,&maclist,&error\)\)==)N 2272(DW_DLV_OK\))X 2800({)X 928 4224(for)N 1120(\(i)X 1264(=)X 1360(0;)X 1504(i)X 1600(<)X 1696(count;)X 2032(++i\))X 2272({)X 1024 4320(/*)N 1168(use)X 1360(maclist[i])X 1888(*/)X 928 4416(})N 928 4512(cur_off)N 1312(=)X 1408(maclist[count-1].dmd_offset)X 2752(+)X 2848(1;)X 928 4608(dwarf_dealloc\(dbg,)N 1840(maclist,)X 2272(DW_DLA_STRING\);)X 736 4704(})N 3 f 11 s 576 5088(5.14)N 774(Low)X 962(Level)X 1190(Frame)X 1461(Operations)X 1 f 10 s 576 5232(These)N 814(functions)X 1159(provide)X 1451(information)X 1876(about)X 2101(stack)X 2313(frames)X 2579(to)X 2688(be)X 2811(used)X 3005(to)X 3114(perform)X 3420(stack)X 3632(traces.)X 3907(The)X 576 5328(information)N 979(is)X 1057(an)X 1158(abstraction)X 1535(of)X 1627(a)X 1688(table)X 1868(with)X 2034(a)X 2094(row)X 2243(per)X 2370(instruction)X 2736(and)X 2876(a)X 2936(column)X 3200(per)X 3327(register)X 3592(and)X 3732(a)X 3792(column)X 576 5424(for)N 698(the)X 824(canonical)X 1160(frame)X 1376(address)X 1645(\(CFA,)X 1875(which)X 2099(corresponds)X 2515(to)X 2605(the)X 2731(notion)X 2963(of)X 3058(a)X 3122(frame)X 3338(pointer\),)X 3640(as)X 3735(well)X 3901(as)X 3996(a)X 576 5520(column)N 836(for)X 950(the)X 1068(return)X 1280(address.)X 576 5664(From)N 775(1993-2006)X 1148(the)X 1272(interface)X 1580(we'll)X 1771(here)X 1936(refer)X 2115(to)X 2203(as)X 2296(DWARF2)X 2651(made)X 2851(the)X 2975(CFA)X 3156(be)X 3259(a)X 3322(column)X 3589(in)X 3678(the)X 3803(matrix,)X 576 5760(but)N 716(left)X 861(DW_FRAME_UNDEFINED_VAL,)X 2071(and)X 2224(DW_FRAME_SAME_VAL)X 3177(out)X 3316(of)X 3420(the)X 3555(matrix)X 3801(\(giving)X 576 5856(them)N 762(high)X 930(numbers\).)X 1279(As)X 1394(of)X 1488(the)X 1613(DWARF3)X 1969(interfaces)X 2309(introduced)X 2679(in)X 2768(this)X 2910(document)X 3253(in)X 3342(April)X 3538(2006,)X 3745(there)X 3933(are)X 576 5952(*two*)N 796(interfaces.)X 576 6183(rev)N 699(1.61,)X 879(3)X 939(Apr)X 1084(2006)X 2217(-)X 2264(46)X 2364(-)X 47 p %%Page: 47 47 0(Courier)xf 0 f 10 s 0 xH 0 xS 0 f 1 f 2217 384(-)N 2264(47)X 2364(-)X 576 768(The)N 723(original)X 995(still)X 1137(exists)X 1342(\(see.)X 1535 0.1898(dwarf_get_fde_info_for_reg\(\))AX 2527(and)X 2666 0.1562(dwarf_get_fde_info_for_all_regs\(\))AX 3809(below\))X 576 864(and)N 724(works)X 952(adequately)X 1332(for)X 1458(MIPS/IRIX)X 1863(DWARF2)X 2224(and)X 2372(ABI/ISA)X 2693(sets)X 2844(that)X 2995(are)X 3125(sufficiently)X 3521(similar)X 3774(\(but)X 3934(the)X 576 960(settings)N 840(for)X 954(non-MIPS)X 1307(must)X 1482(be)X 1578(set)X 1687(into)X 1831(libdwarf.h)X 2183(and)X 2319(cannot)X 2553(be)X 2649(changed)X 2937(at)X 3015(runtime\).)X 576 1104(A)N 735(new)X 970(interface)X 1373(set)X 1564(of)X 1733 0.1767(dwarf_get_fde_info_for_reg3\(\),)AX 2864 0.1970(dwarf_get_fde_info_for_cfa_reg3\(\),)AX 576 1200 0.1515(dwarf_get_fde_info_for_all_regs3\(\))AN 2830 0.1357(dwarf_set_frame_rule_inital_value\(\),)AX 576 1296 0.1758(dwarf_set_frame_rule_table_size\(\))AN 1727(is)X 1806(more)X 1997(flexible)X 2268(and)X 2410(should)X 2649(work)X 2840(for)X 2960(many)X 3164(more)X 3355(architectures)X 3792(and)X 3934(the)X 576 1392(setting)N 809(of)X 916(DW_FRAME_CFA_COL)X 1780(and)X 1916(the)X 2034(size)X 2179(of)X 2266(the)X 2384(table)X 2560(can)X 2692(be)X 2788(set)X 2897(at)X 2975(runtime.)X 576 1536(Each)N 757(cell)X 893(in)X 975(the)X 1093(table)X 1269(contains)X 1556(one)X 1692(of)X 1779(the)X 1897(following:)X 636 1776(1.)N 776(A)X 854(register)X 1115(+)X 1180(offset\(a\)\(b\))X 636 2016(2.)N 776(A)X 854 0.2404(register\(c\)\(d\))AX 636 2352(3.)N 776(A)X 854(marker)X 1102(\(DW_FRAME_UNDEFINED_VAL\))X 2329(meaning)X 2 f 2625(register)X 2894(value)X 3088(undefined)X 1 f 636 2592(4.)N 776(A)X 854(marker)X 1102(\(DW_FRAME_SAME_VAL\))X 2092(meaning)X 2 f 2388(register)X 2657(value)X 2851(same)X 3036(as)X 3127(in)X 3209(caller)X 1 f 576 2736(\(a)N 666(old)X 795(DWARF2)X 1152(interface\))X 1489(When)X 1729(the)X 1855(column)X 2123(is)X 2204(DW_FRAME_CFA_COL:)X 3098(the)X 3224(register)X 3493(number)X 3766(is)X 3847(a)X 3911(real)X 576 2832(hardware)N 906(register,)X 1197(not)X 1329(a)X 1394 0.4531(reference)AX 1724(to)X 1815(DW_FRAME_CFA_COL,)X 2708(not)X 2859(DW_FRAME_UNDEFINED_VAL,)X 576 2928(and)N 718(not)X 846(DW_FRAME_SAME_VAL.)X 1828(The)X 1979(CFA)X 2160(rule)X 2311(value)X 2511(should)X 2750(be)X 2852(the)X 2976(stack)X 3167(pointer)X 3421(plus)X 3581(offset)X 3791(0)X 3858(when)X 576 3024(no)N 681(other)X 871(value)X 1070(makes)X 1300(sense.)X 1539(A)X 1622(value)X 1821(of)X 1913(DW_FRAME_SAME_VAL)X 2854(would)X 3079(be)X 3179(semi-logical,)X 3619(but)X 3745(since)X 3934(the)X 576 3120(CFA)N 755(is)X 832(not)X 958(a)X 1018(real)X 1163(register,)X 1448(not)X 1574(really)X 1781(correct.)X 2069(A)X 2152(value)X 2351(of)X 2443(DW_FRAME_UNDEFINED_VAL)X 3621(would)X 3846(imply)X 576 3216(the)N 698(CFA)X 877(is)X 954(undefined)X 1319(--)X 1397(this)X 1536(seems)X 1756(to)X 1842(be)X 1942(a)X 2002(useless)X 2253(notion,)X 2501(as)X 2592(the)X 2714(CFA)X 2893(is)X 2970(a)X 3029(means)X 3257(to)X 3342(finding)X 3596(real)X 3740(registers,)X 576 3312(so)N 669(those)X 861(real)X 1005(registers)X 1300(should)X 1536(be)X 1635(marked)X 1899(DW_FRAME_UNDEFINED_VAL,)X 3095(and)X 3234(the)X 3355(CFA)X 3533(column)X 3796(content)X 576 3408(\(whatever)N 918(register)X 1179(it)X 1243(specifies\))X 1571(becomes)X 1872 0.3295(unreferenced)AX 2313(by)X 2413(anything.)X 576 3552(\(a)N 662(new)X 819(April)X 1011(2006)X 1194(DWARF2/3)X 1608(interface\):)X 1962(The)X 2110(CFA)X 2288(is)X 2364(separately)X 2713(accessible)X 3062(and)X 3201(not)X 3326(part)X 3474(of)X 3565(the)X 3687(table.)X 3907(The)X 576 3648('rule)N 754(number')X 1052(for)X 1172(the)X 1296(CFA)X 1477(is)X 1556(a)X 1618(number)X 1889(outside)X 2145(the)X 2268(table.)X 2489(So)X 2598(the)X 2721(CFA)X 2901(is)X 2979(a)X 3040(marker,)X 3313(not)X 3440(a)X 3501(register)X 3767(number.)X 576 3744(See)N 732(DW_FRAME_CFA_COL3)X 1636(in)X 1718(libdwarf.h)X 2070(and)X 2206 0.1970(dwarf_get_fde_info_for_cfa_reg3\(\).)AX 576 3888(\(b\))N 749(When)X 1020(the)X 1197(column)X 1516(is)X 1648(not)X 1829(DW_FRAME_CFA_COL,)X 2772(the)X 2949('register')X 3323(will)X 3526(and)X 3721(must)X 3956(be)X 576 3984(DW_FRAME_CFA_COL,)N 1469(implying)X 1785(that)X 1933(to)X 2023(get)X 2149(the)X 2275(final)X 2450(location)X 2736(for)X 2858(the)X 2984(column)X 3252(one)X 3396(must)X 3579(add)X 3723(the)X 3849(offset)X 576 4080(here)N 735(plus)X 888(the)X 1006(DW_FRAME_CFA_COL)X 1870(rule)X 2015(value.)X 576 4224(\(c\))N 692(When)X 910(the)X 1034(column)X 1301(is)X 1381(DW_FRAME_CFA_COL,)X 2272(then)X 2437(the)X 2562(register)X 2830(number)X 3102(is)X 3182(\(must)X 3391(be\))X 3521(a)X 3584(real)X 3732(hardware)X 576 4320(register)N 856(.)X 935(If)X 1028(it)X 1111(were)X 1307(DW_FRAME_UNDEFINED_VAL)X 2499(or)X 2605(DW_FRAME_SAME_VAL)X 3560(it)X 3643(would)X 3882(be)X 3996(a)X 576 4416(marker,)N 844(not)X 966(a)X 1022(register)X 1283(number.)X 576 4560(\(d\))N 693(When)X 908(the)X 1029(column)X 1292(is)X 1368(not)X 1493(DW_FRAME_CFA_COL,)X 2380(the)X 2501(register)X 2765(may)X 2926(be)X 3025(a)X 3084(hardware)X 3407(register.)X 3711(It)X 3783(will)X 3930(not)X 576 4656(be)N 672(DW_FRAME_CFA_COL.)X 576 4800(There)N 784(is)X 857(no)X 957('column')X 1271(for)X 1385(DW_FRAME_UNDEFINED_VAL)X 2558(or)X 2645(DW_FRAME_SAME_VAL.)X 576 4992(Figure)N 805(3)X 865(is)X 938(machine)X 1230(dependent)X 1580(and)X 1716(represents)X 2062(MIPS)X 2268(cpu)X 2404(register)X 2665(assignments.)X 576 6183(rev)N 699(1.61,)X 879(3)X 939(Apr)X 1084(2006)X 2217(-)X 2264(47)X 2364(-)X 48 p %%Page: 48 48 0(Courier)xf 0 f 10 s 0 xH 0 xS 0 f 1 f 2217 384(-)N 2264(48)X 2364(-)X 0 f 10 f 824 688(iiiiiiiiiiiiiiiiiiiiiiiiiiiiiiiiiiiiiiiiiiiiiiiiiiiiiiiiiiiiiiiiiiiiiiiiii)N 3 f 864 784(NAME)N 2040(value)X 2352(PURPOSE)X 10 f 824 800(iiiiiiiiiiiiiiiiiiiiiiiiiiiiiiiiiiiiiiiiiiiiiiiiiiiiiiiiiiiiiiiiiiiiiiiiii)N 3 f 864 896(DW_FRAME_CFA_COL)N 2116(0)X 2352(column)X 2625(used)X 2800(for)X 2923(CFA)X 864 992(DW_FRAME_REG1)N 2116(1)X 2352(integer)X 2613(regster)X 2875(1)X 864 1088(DW_FRAME_REG2)N 2116(2)X 2352(integer)X 2613(register)X 2897(2)X 864 1184(---)N 2352(obvious)X 2633(names)X 2871(and)X 3019(values)X 3252(here)X 864 1280(DW_FRAME_REG30)N 2096(30)X 2352(integer)X 2613(register)X 2897(30)X 864 1376(DW_FRAME_REG31)N 2096(31)X 2352(integer)X 2613(register)X 2897(31)X 864 1472(DW_FRAME_FREG0)N 2096(32)X 2352(floating)X 2634(point)X 2831(register)X 3115(0)X 864 1568(DW_FRAME_FREG1)N 2096(33)X 2352(floating)X 2634(point)X 2831(register)X 3115(1)X 864 1664(---)N 2352(obvious)X 2633(names)X 2871(and)X 3019(values)X 3252(here)X 864 1760(DW_FRAME_FREG30)N 2096(62)X 2352(floating)X 2634(point)X 2831(register)X 3115(30)X 864 1856(DW_FRAME_FREG31)N 2096(63)X 2352(floating)X 2634(point)X 2831(register)X 3115(31)X 864 1952(DW_FRAME_RA_COL)N 2096(64)X 2352(column)X 2625(recording)X 2979(ra)X 864 2048(DW_FRAME_UNDEFINED_VAL)N 2056(1034)X 2352(register)X 2636(val)X 2758(undefined)X 864 2144(DW_FRAME_SAME_VAL)N 2056(1035)X 2352(register)X 2636(same)X 2830(as)X 2921(in)X 3007(caller)X 10 f 824 2160(iiiiiiiiiiiiiiiiiiiiiiiiiiiiiiiiiiiiiiiiiiiiiiiiiiiiiiiiiiiiiiiiiiiiiiiiii)N 824(c)X 2128(c)Y 2048(c)Y 1968(c)Y 1888(c)Y 1808(c)Y 1728(c)Y 1648(c)Y 1568(c)Y 1488(c)Y 1408(c)Y 1328(c)Y 1248(c)Y 1168(c)Y 1088(c)Y 1008(c)Y 928(c)Y 848(c)Y 768(c)Y 3784 2160(c)N 2128(c)Y 2048(c)Y 1968(c)Y 1888(c)Y 1808(c)Y 1728(c)Y 1648(c)Y 1568(c)Y 1488(c)Y 1408(c)Y 1328(c)Y 1248(c)Y 1168(c)Y 1088(c)Y 1008(c)Y 928(c)Y 848(c)Y 768(c)Y 3 f 1482 2352(Figure)N 1729(4.)X 1829(Frame)X 2077(Information)X 2515(Rule)X 2695(Assignments)X 1 f 576 2640(The)N 727(following)X 1064(table)X 1246(shows)X 1472(SGI/MIPS)X 1836(specific)X 2113(special)X 2363(cell)X 2506(values:)X 2760(these)X 2952(values)X 3184(mean)X 3385(that)X 3532(the)X 3657(cell)X 3800(has)X 3934(the)X 576 2736(value)N 2 f 772(undefined)X 1 f 1110(or)X 2 f 1199(same)X 1386(value)X 1 f 1582(respectively,)X 2012(rather)X 2222(than)X 2382(containing)X 2742(a)X 2 f 2800(register)X 1 f 3070(or)X 2 f 3158(register+offset)X 1 f 3634(.)X 3695(It)X 3765(assumes)X 576 2832(DW_FRAME_CFA_COL)N 1467(is)X 1567(a)X 1650(table)X 1853(rule,)X 2045(which)X 2289(is)X 2390(not)X 2540(readily)X 2811(accomplished)X 3300(or)X 3415(sensible)X 3721(for)X 3863(some)X 576 2928(architectures.)N 3 f 10 f 934 2992(i)N 953(iiiiiiiiiiiiiiiiiiiiiiiiiiiiiiiiiiiiiiiiiiiiiiiiiiiiiiiiiiiiiiiiiiii)X 3 f 974 3088(NAME)N 2291(value)X 2593(PURPOSE)X 10 f 934 3104(i)N 953(iiiiiiiiiiiiiiiiiiiiiiiiiiiiiiiiiiiiiiiiiiiiiiiiiiiiiiiiiiiiiiiiiiii)X 3 f 974 3200(DW_FRAME_UNDEFINED_VAL)N 2302(1034)X 2593(means)X 2831(undefined)X 3192(value.)X 2593 3296(Not)N 2738(a)X 2798(column)X 3071(or)X 3167(register)X 3451(value)X 974 3392(DW_FRAME_SAME_VAL)N 2302(1035)X 2593(means)X 2831('same)X 3052(value')X 3281(as)X 2593 3488(caller)N 2805(had.)X 2973(Not)X 3118(a)X 3178(column)X 3451(or)X 2593 3584(register)N 2877(value)X 10 f 934 3600(i)N 953(iiiiiiiiiiiiiiiiiiiiiiiiiiiiiiiiiiiiiiiiiiiiiiiiiiiiiiiiiiiiiiiiiiii)X 934(c)X 3552(c)Y 3472(c)Y 3392(c)Y 3312(c)Y 3232(c)Y 3152(c)Y 3072(c)Y 3673 3600(c)N 3552(c)Y 3472(c)Y 3392(c)Y 3312(c)Y 3232(c)Y 3152(c)Y 3072(c)Y 3 f 1540 3696(Figure)N 1787(5.)X 1887(Frame)X 2135(Information)X 2573(Special)X 2837(Values)X 1 f 576 3984(The)N 734(following)X 1078(table)X 1267(shows)X 1500(more)X 1698(general)X 1969(special)X 2226(cell)X 2376(values.)X 2655(These)X 2881(values)X 3120(mean)X 3328(that)X 3482(the)X 3614(cell)X 3764(register-)X 576 4080(number)N 847(refers)X 1057(to)X 1145(the)X 2 f 1269(cfa-register)X 1 f 1669(or)X 2 f 1762(undefined-value)X 1 f 2305(or)X 2 f 2398(same-value)X 1 f 2790(respectively,)X 3224(rather)X 3438(than)X 3602(referring)X 3909(to)X 3996(a)X 2 f 576 4176(register)N 851(in)X 940(the)X 1065(table)X 1 f (.)S 1292(The)X 1444(generality)X 1792(arises)X 2002(from)X 2185(making)X 2452(DW_FRAME_CFA_COL3)X 3363(be)X 3466(outside)X 3724(the)X 3849(set)X 3965(of)X 576 4272(registers)N 868(and)X 1004(making)X 1264(the)X 1382(cfa)X 1501(rule)X 1646(accessible)X 1992(from)X 2168(outside)X 2419(the)X 2537(rule-table.)X 3 f 10 f 576 4336(i)N 596(iiiiiiiiiiiiiiiiiiiiiiiiiiiiiiiiiiiiiiiiiiiiiiiiiiiiiiiiiiiiiiiiiiiiiiiiiiiiiiiiiiiiiiiiiii)X 3 f 616 4432(NAME)N 1933(value)X 2235(PURPOSE)X 10 f 576 4448(i)N 596(iiiiiiiiiiiiiiiiiiiiiiiiiiiiiiiiiiiiiiiiiiiiiiiiiiiiiiiiiiiiiiiiiiiiiiiiiiiiiiiiiiiiiiiiiii)X 3 f 616 4544(DW_FRAME_UNDEFINED_VAL)N 1944(1034)X 2235(means)X 2473(undefined)X 2834(value.)X 2235 4640(Not)N 2380(a)X 2440(column)X 2713(or)X 2809(register)X 3093(value)X 616 4736(DW_FRAME_SAME_VAL)N 1944(1035)X 2235(means)X 2473('same)X 2694(value')X 2923(as)X 2235 4832(caller)N 2447(had.)X 2615(Not)X 2760(a)X 2820(column)X 3093(or)X 2235 4928(register)N 2519(value)X 616 5024(DW_FRAME_CFA_COL3)N 1944(1036)X 2235(means)X 2473('cfa)X 2623(register'is)X 2987(referred)X 3294(to,)X 2235 5120(not)N 2366(a)X 2426(real)X 2580(register,)X 2884(not)X 3015(a)X 3075(column,)X 3368(but)X 3503(the)X 3630(cfa)X 3753(\(the)X 3907(cfa)X 2235 5216(does)N 2406(have)X 2586(a)X 2646(value,)X 2868(but)X 3003(in)X 3089(the)X 3216(DWARF3)X 3579(libdwarf)X 3892(interface)X 2235 5312(it)N 2304(does)X 2475(not)X 2606(have)X 2786(a)X 2846('real)X 3027(register)X 3311(number'\).)X 10 f 576 5328(i)N 596(iiiiiiiiiiiiiiiiiiiiiiiiiiiiiiiiiiiiiiiiiiiiiiiiiiiiiiiiiiiiiiiiiiiiiiiiiiiiiiiiiiiiiiiiiii)X 576(c)X 5296(c)Y 5216(c)Y 5136(c)Y 5056(c)Y 4976(c)Y 4896(c)Y 4816(c)Y 4736(c)Y 4656(c)Y 4576(c)Y 4496(c)Y 4416(c)Y 4236 5328(c)N 5296(c)Y 5216(c)Y 5136(c)Y 5056(c)Y 4976(c)Y 4896(c)Y 4816(c)Y 4736(c)Y 4656(c)Y 4576(c)Y 4496(c)Y 4416(c)Y 9 s 3 f 576 5616(5.14.0.1)N 846(dwarf_get_fde_list\(\))X 1 f 10 s 576 6183(rev)N 699(1.61,)X 879(3)X 939(Apr)X 1084(2006)X 2217(-)X 2264(48)X 2364(-)X 49 p %%Page: 49 49 0(Courier)xf 0 f 10 s 0 xH 0 xS 0 f 1 f 2217 384(-)N 2264(49)X 2364(-)X 0 f 576 768(int)N 768(dwarf_get_fde_list\()X 960 864(Dwarf_Debug)N 1536(dbg,)X 960 960(Dwarf_Cie)N 1440(**cie_data,)X 960 1056(Dwarf_Signed)N 1584(*cie_element_count,)X 960 1152(Dwarf_Fde)N 1440(**fde_data,)X 960 1248(Dwarf_Signed)N 1584(*fde_element_count,)X 960 1344(Dwarf_Error)N 1536(*error\);)X 576 1488(dwarf_get_fde_list\(\))N 1 f 1562(stores)X 1775(a)X 1837(pointer)X 2090(to)X 2178(a)X 2240(list)X 2363(of)X 0 f 2484(Dwarf_Cie)X 1 f 2942(descriptors)X 3320(in)X 0 f 3437(*cie_data)X 1 f (,)S 3916(and)X 576 1584(the)N 695(count)X 894(of)X 982(the)X 1101(number)X 1367(of)X 1455(descriptors)X 1827(in)X 0 f 1937(*cie_element_count)X 1 f (.)S 2861(There)X 3069(is)X 3142(a)X 3198(descriptor)X 3539(for)X 3653(each)X 3821(CIE)X 3970(in)X 576 1680(the)N 724(.debug_frame)X 1218(section.)X 1535(Similarly,)X 1902(it)X 1996(stores)X 2233(a)X 2319(pointer)X 2596(to)X 2708(a)X 2794(list)X 2941(of)X 0 f 3086(Dwarf_Fde)X 1 f 3568(descriptors)X 3970(in)X 0 f 576 1776(*fde_data)N 1 f (,)S 1062(and)X 1212(the)X 1344(count)X 1555(of)X 1655(the)X 1786(number)X 2064(of)X 2164(descriptors)X 2549(in)X 0 f 2672(*fde_element_count)X 1 f (.)S 3609(There)X 3830(is)X 3916(one)X 576 1872(descriptor)N 918(per)X 1042(FDE)X 1214(in)X 1298(the)X 1418(.debug_frame)X 1884(section.)X 0 f 2229(dwarf_get_fde_list\(\))X 1 f 3231(returns)X 0 f 3504(DW_DLV_EROR)X 1 f 576 1968(on)N 685(error.)X 911(It)X 989(returns)X 0 f 1269(DW_DLV_NO_ENTRY)X 1 f 2018(if)X 2096(it)X 2169(cannot)X 2412(find)X 2570(frame)X 2787(entries.)X 3070(It)X 3148(returns)X 0 f 3428(DW_DLV_OK)X 1 f 3888(on)X 3996(a)X 576 2064(successful)N 926(return.)X 576 2208(On)N 766(successful)X 1188(return,)X 1492(structures)X 1896(pointed)X 2228(to)X 2382(by)X 2555(a)X 2684(descriptor)X 3098(should)X 3404(be)X 3573(free'd)X 3859(using)X 0 f 576 2304(dwarf_fde_cie_list_dealloc\(\))N 1 f (.)S 1980(This)X 2142(dealloc)X 2394(approach)X 2709(is)X 2782(new)X 2936(as)X 3023(of)X 3110(July)X 3263(15,)X 3383(2005.)X 0 f 736 2544(Dwarf_Signed)N 1360(cnt;)X 736 2640(Dwarf_Cie)N 1216(*cie_data;)X 736 2736(Dwarf_Signed)N 1360(cie_count;)X 736 2832(Dwarf_Fde)N 1216(*fde_data;)X 736 2928(Dwarf_Signed)N 1360(fde_count;)X 736 3024(int)N 928(fres;)X 736 3216(fres)N 976(=)X 1072(dwarf_get_fde_list\(dbg,&cie_data,&cie_count,)X 1504 3312(&fde_data,&fde_count,&error\);)N 736 3408(if)N 880(\(fres)X 1168(==)X 1312(DW_DLV_OK\))X 1840({)X 1120 3504(dwarf_fde_cie_list_dealloc\(dbg,)N 2656(cie_data,)X 3136(cie_count,)X 1504 3600(fde_data,fde_count\);)N 736 3696(})N 1 f 576 4176(The)N 737(following)X 1085(code)X 1274(is)X 1364(deprecated)X 1750(as)X 1854(of)X 1958(July)X 2128(15,)X 2265(2005)X 2462(as)X 2566(it)X 2647(does)X 2831(not)X 2970(free)X 3133(all)X 3250(relevant)X 3546(memory.)X 3890(This)X 576 4272(approach)N 911(still)X 1050(works)X 1266(as)X 1353(well)X 1511(as)X 1598(it)X 1662(ever)X 1821(did.)X 576 6183(rev)N 699(1.61,)X 879(3)X 939(Apr)X 1084(2006)X 2217(-)X 2264(49)X 2364(-)X 50 p %%Page: 50 50 0(Courier)xf 0 f 10 s 0 xH 0 xS 0 f 1 f 2217 384(-)N 2264(50)X 2364(-)X 0 f 736 768(Dwarf_Signed)N 1360(cnt;)X 736 864(Dwarf_Cie)N 1216(*cie_data;)X 736 960(Dwarf_Signed)N 1360(cie_count;)X 736 1056(Dwarf_Fde)N 1216(*fde_data;)X 736 1152(Dwarf_Signed)N 1360(fde_count;)X 736 1248(int)N 928(fres;)X 736 1440(fres)N 976(=)X 1072(dwarf_get_fde_list\(dbg,&cie_data,&cie_count,)X 1504 1536(&fde_data,&fde_count,&error\);)N 736 1632(if)N 880(\(fres)X 1168(==)X 1312(DW_DLV_OK\))X 1840({)X 1120 1824(for)N 1312(\(i)X 1456(=)X 1552(0;)X 1696(i)X 1792(<)X 1888(cie_count;)X 2416(++i\))X 2656({)X 1504 1920(/*)N 1648(use)X 1840(cie[i])X 2176(*/)X 1504 2016(dwarf_dealloc\(dbg,)N 2416(cie_data[i],)X 3040(DW_DLA_CIE\);)X 1120 2112(})N 1120 2208(for)N 1312(\(i)X 1456(=)X 1552(0;)X 1696(i)X 1792(<)X 1888(fde_count;)X 2416(++i\))X 2656({)X 1504 2304(/*)N 1648(use)X 1840(fde[i])X 2176(*/)X 1504 2400(dwarf_dealloc\(dbg,)N 2416(fde_data[i],)X 3040(DW_DLA_FDE\);)X 1120 2496(})N 1120 2592(dwarf_dealloc\(dbg,)N 2032(cie_data,)X 2512(DW_DLA_LIST\);)X 1120 2688(dwarf_dealloc\(dbg,)N 2032(fde_data,)X 2512(DW_DLA_LIST\);)X 736 2784(})N 3 f 9 s 576 3072(5.14.0.2)N 846(dwarf_get_fde_list_eh\(\))X 0 f 10 s 576 3216(int)N 768(dwarf_get_fde_list_eh\()X 960 3312(Dwarf_Debug)N 1536(dbg,)X 960 3408(Dwarf_Cie)N 1440(**cie_data,)X 960 3504(Dwarf_Signed)N 1584(*cie_element_count,)X 960 3600(Dwarf_Fde)N 1440(**fde_data,)X 960 3696(Dwarf_Signed)N 1584(*fde_element_count,)X 960 3792(Dwarf_Error)N 1536(*error\);)X 576 3936(dwarf_get_fde_list_eh\(\))N 1 f 1787(is)X 1947(identical)X 2330(to)X 0 f 2527(dwarf_get_fde_list\(\))X 1 f 3594(except)X 3912(that)X 0 f 576 4032(dwarf_get_fde_list_eh\(\))N 1 f 1704(reads)X 1898(the)X 2020(GNU)X 2218(ecgs)X 2385(section)X 2636(named)X 2874(.eh_frame)X 3222(\(C++)X 3416(exception)X 3752(handling)X 576 4128(information\).)N 0 f 576 4320(dwarf_get_fde_list_eh\(\))N 1 f 1706(stores)X 1919(a)X 1981(pointer)X 2234(to)X 2322(a)X 2384(list)X 2507(of)X 0 f 2628(Dwarf_Cie)X 1 f 3086(descriptors)X 3464(in)X 0 f 3580(*cie_data)X 1 f (,)S 576 4416(and)N 719(the)X 844(count)X 1049(of)X 1143(the)X 1268(number)X 1540(of)X 1634(descriptors)X 2013(in)X 0 f 2130(*cie_element_count)X 1 f (.)S 3061(There)X 3276(is)X 3355(a)X 3417(descriptor)X 3764(for)X 3884(each)X 576 4512(CIE)N 736(in)X 829(the)X 958(.debug_frame)X 1434(section.)X 1733(Similarly,)X 2082(it)X 2158(stores)X 2377(a)X 2445(pointer)X 2704(to)X 2798(a)X 2866(list)X 2995(of)X 0 f 3122(Dwarf_Fde)X 1 f 3586(descriptors)X 3970(in)X 0 f 576 4608(*fde_data)N 1 f (,)S 1062(and)X 1212(the)X 1344(count)X 1555(of)X 1655(the)X 1786(number)X 2064(of)X 2164(descriptors)X 2549(in)X 0 f 2672(*fde_element_count)X 1 f (.)S 3609(There)X 3830(is)X 3916(one)X 576 4704(descriptor)N 918(per)X 1042(FDE)X 1214(in)X 1298(the)X 1418(.debug_frame)X 1884(section.)X 0 f 2229(dwarf_get_fde_list\(\))X 1 f 3231(returns)X 0 f 3504(DW_DLV_EROR)X 1 f 576 4800(on)N 703(error.)X 947(It)X 1043(returns)X 0 f 1341(DW_DLV_NO_ENTRY)X 1 f 2108(if)X 2204(it)X 2295(cannot)X 2555(find)X 2730(exception)X 3088(handling)X 3414(entries.)X 3714(It)X 3809(returns)X 0 f 576 4896(DW_DLV_OK)N 1 f 1028(on)X 1128(a)X 1184(successful)X 1534(return.)X 576 5136(On)N 766(successful)X 1188(return,)X 1492(structures)X 1896(pointed)X 2228(to)X 2382(by)X 2555(a)X 2684(descriptor)X 3098(should)X 3404(be)X 3573(free'd)X 3859(using)X 0 f 576 5232(dwarf_fde_cie_list_dealloc\(\))N 1 f (.)S 1980(This)X 2142(dealloc)X 2394(approach)X 2709(is)X 2782(new)X 2936(as)X 3023(of)X 3110(July)X 3263(15,)X 3383(2005.)X 576 6183(rev)N 699(1.61,)X 879(3)X 939(Apr)X 1084(2006)X 2217(-)X 2264(50)X 2364(-)X 51 p %%Page: 51 51 0(Courier)xf 0 f 10 s 0 xH 0 xS 0 f 1 f 2217 384(-)N 2264(51)X 2364(-)X 0 f 736 768(Dwarf_Signed)N 1360(cnt;)X 736 864(Dwarf_Cie)N 1216(*cie_data;)X 736 960(Dwarf_Signed)N 1360(cie_count;)X 736 1056(Dwarf_Fde)N 1216(*fde_data;)X 736 1152(Dwarf_Signed)N 1360(fde_count;)X 736 1248(int)N 928(fres;)X 736 1440(fres)N 976(=)X 1072(dwarf_get_fde_list\(dbg,&cie_data,&cie_count,)X 1504 1536(&fde_data,&fde_count,&error\);)N 736 1632(if)N 880(\(fres)X 1168(==)X 1312(DW_DLV_OK\))X 1840({)X 1120 1728(dwarf_fde_cie_list_dealloc\(dbg,)N 2656(cie_data,)X 3136(cie_count,)X 1504 1824(fde_data,fde_count\);)N 736 1920(})N 3 f 9 s 576 2304(5.14.0.3)N 846(dwarf_get_cie_of_fde\(\))X 0 f 10 s 576 2448(int)N 768(dwarf_get_cie_of_fde\(Dwarf_Fde)X 2256(fde,)X 960 2544(Dwarf_Cie)N 1440(*cie_returned,)X 960 2640(Dwarf_Error)N 1536(*error\);)X 576 2784(dwarf_get_cie_of_fde\(\))N 1 f 1668(stores)X 1891(a)X 0 f 1991(Dwarf_Cie)X 1 f 2459(into)X 2619(the)X 0 f 2802(Dwarf_Cie)X 1 f 3271(that)X 0 f 3456(cie_returned)X 1 f 576 2880(points)N 791(at.)X 576 3072(If)N 673(one)X 832(has)X 982(called)X 1217(dwarf_get_fde_list)X 1866(and)X 2025(does)X 2215(not)X 2360(wish)X 2554(to)X 2659 0.2321(dwarf_dealloc\(\))AX 3216(all)X 3340(the)X 3482(individual)X 3850(FDEs)X 576 3168(immediately,)N 1023(one)X 1166(must)X 1348(also)X 1504(avoid)X 1709(dwarf_dealloc-ing)X 2325(the)X 2450(CIEs)X 2636(for)X 2756(those)X 2951(FDEs)X 3159(not)X 3287(immediately)X 3713(dealloc'd.)X 576 3264(Failing)N 824(to)X 908(observe)X 1180(this)X 1317(restriction)X 1664(will)X 1810(cause)X 2011(the)X 2152(FDE\(s\))X 2411(not)X 2536(dealloced)X 2867(to)X 2952(become)X 3225(invalid:)X 3492(an)X 3591(FDE)X 3765(contains)X 576 3360(\(hidden)N 857(in)X 955(it\))X 1062(a)X 1134(CIE)X 1299(pointer)X 1562(which)X 1794(will)X 1954(be)X 2066(be)X 2178(invalid)X 2436(\(stale,)X 2666(pointing)X 2968(to)X 3066(freed)X 3268(memory\))X 3598(if)X 3682(the)X 3815(CIE)X 3979(is)X 576 3456(dealloc'd.)N 941(The)X 1092(invalid)X 1340(CIE)X 1495(pointer)X 1748(internal)X 2019(to)X 2107(the)X 2231(FDE)X 2408(cannot)X 2648(be)X 2751(detected)X 3046(as)X 3140(invalid)X 3389(by)X 3496(libdwarf.)X 3835(If)X 3916(one)X 576 3552(later)N 739(passes)X 964(an)X 1060(FDE)X 1231(with)X 1393(a)X 1449(stale)X 1616(internal)X 1881(CIE)X 2030(pointer)X 2277(to)X 2359(one)X 2495(of)X 2582(the)X 2700(routines)X 2978(taking)X 3198(an)X 3294(FDE)X 3465(as)X 3552(input)X 3736(the)X 3854(result)X 576 3648(will)N 720(be)X 816(failure)X 1046(of)X 1133(the)X 1251(call)X 1387(\(returning)X 1728(DW_DLV_ERROR\))X 2420(at)X 2499(best)X 2649(and)X 2786(it)X 2851(is)X 2925(possible)X 3208(a)X 3265(coredump)X 3607(or)X 3695(worse)X 3908(will)X 576 3744(happpen)N 868(\(eventually\).)X 0 f 576 4032(dwarf_get_cie_of_fde\(\))N 1 f 1653(returns)X 0 f 1925(DW_DLV_OK)X 1 f 2378(if)X 2448(it)X 2513(is)X 2587(successful)X 2939(\(it)X 3032(will)X 3178(be)X 3276(unless)X 3498(fde)X 3623(is)X 3698(the)X 3818(NULL)X 576 4128(pointer\).)N 890(It)X 959(returns)X 0 f 1230(DW_DLV_ERROR)X 1 f 1826(if)X 1895(the)X 2013(fde)X 2136(is)X 2209(invalid)X 2451(\(NULL\).)X 576 4368(Each)N 0 f 809(Dwarf_Fde)X 1 f 1285(descriptor)X 1650(describes)X 1993(information)X 2415(about)X 2637(the)X 2779(frame)X 3011(for)X 3149(a)X 3229(particular)X 3582(subroutine)X 3965(or)X 576 4464(function.)N 0 f 576 4656(int)N 768(dwarf_get_fde_for_die)X 1 f 1796(is)X 1869(SGI/MIPS)X 2226(specific.)X 3 f 9 s 576 4896(5.14.0.4)N 846(dwarf_get_fde_for_die\(\))X 0 f 10 s 576 5040(int)N 768(dwarf_get_fde_for_die\()X 960 5136(Dwarf_Debug)N 1536(dbg,)X 960 5232(Dwarf_Die)N 1440(die,)X 960 5328(Dwarf_Fde)N 1440(*)X 1584(return_fde,)X 960 5424(Dwarf_Error)N 1536(*error\))X 1 f 576 5568(When)N 788(it)X 853(succeeds,)X 0 f 1208(dwarf_get_fde_for_die\(\))X 1 f 2333(returns)X 0 f 2605(DW_DLV_OK)X 1 f 3058(and)X 3195(sets)X 0 f 3364(*return_fde)X 1 f 3913(to)X 3996(a)X 0 f 576 5664(Dwarf_Fde)N 1 f 1070(descriptor)X 1453(representing)X 1912(frame)X 2162(information)X 2602(for)X 2758(the)X 2918(given)X 0 f 3186(die)X 1 f (.)S 3432(It)X 3543(looks)X 3778(for)X 3934(the)X 0 f 576 5760(DW_AT_MIPS_fde)N 1 f 1269(attribute)X 1557(in)X 1640(the)X 1759(given)X 0 f 1986(die)X 1 f (.)S 2191(If)X 2266(it)X 2331(finds)X 2512(it,)X 2597(is)X 2671(uses)X 2830(the)X 2949(value)X 3144(of)X 3232(the)X 3351(attribute)X 3640(as)X 3729(the)X 3849(offset)X 576 5856(in)N 682(the)X 824(.debug_frame)X 1312(section)X 1583(where)X 1824(the)X 1966(FDE)X 2161(begins.)X 2454(If)X 2552(there)X 2757(is)X 2854(no)X 0 f 3006(DW_AT_MIPS_fde)X 1 f 3722(it)X 3809(returns)X 0 f 576 5952(DW_DLV_NO_ENTRY)N 1 f (.)S 1356(If)X 1430(there)X 1611(is)X 1684(an)X 1780(error)X 1957(it)X 2021(returns)X 0 f 2292(DW_DLV_ERROR)X 1 f (.)S 576 6183(rev)N 699(1.61,)X 879(3)X 939(Apr)X 1084(2006)X 2217(-)X 2264(51)X 2364(-)X 52 p %%Page: 52 52 0(Courier)xf 0 f 10 s 0 xH 0 xS 0 f 1 f 2217 384(-)N 2264(52)X 2364(-)X 3 f 9 s 576 768(5.14.0.5)N 846(dwarf_get_fde_range\(\))X 0 f 10 s 576 912(int)N 768(dwarf_get_fde_range\()X 960 1008(Dwarf_Fde)N 1440(fde,)X 960 1104(Dwarf_Addr)N 1488(*low_pc,)X 960 1200(Dwarf_Unsigned)N 1680(*func_length,)X 960 1296(Dwarf_Ptr)N 1440(*fde_bytes,)X 960 1392(Dwarf_Unsigned)N 1680(*fde_byte_length,)X 960 1488(Dwarf_Off)N 1440(*cie_offset,)X 960 1584(Dwarf_Signed)N 1584(*cie_index,)X 960 1680(Dwarf_Off)N 1440(*fde_offset,)X 960 1776(Dwarf_Error)N 1536(*error\);)X 1 f 576 1920(On)N 699(success,)X 0 f 1013(dwarf_get_fde_range\(\))X 1 f 2046(returns)X 0 f 2323(DW_DLV_OK)X 1 f (.)S 2821(The)X 2972(location)X 3256(pointed)X 3522(to)X 3610(by)X 0 f 3744(low_pc)X 1 f 576 2016(is)N 652(set)X 764(to)X 849(the)X 970(low)X 1113(pc)X 1211(value)X 1407(for)X 1523(this)X 1660(function.)X 1989(The)X 2136(location)X 2416(pointed)X 2678(to)X 2762(by)X 0 f 2892(func_length)X 1 f 3442(is)X 3517(set)X 3628(to)X 3712(the)X 3832(length)X 576 2112(of)N 672(the)X 799(function)X 1095(in)X 1186(bytes.)X 1424(This)X 1595(is)X 1677(essentially)X 2044(the)X 2171(length)X 2400(of)X 2496(the)X 2623(text)X 2773(section)X 3030(for)X 3154(the)X 3282(function.)X 3619(The)X 3774(location)X 576 2208(pointed)N 841(to)X 928(by)X 0 f 1061(fde_bytes)X 1 f 1518(is)X 1596(set)X 1710(to)X 1797(the)X 1920(address)X 2186(where)X 2408(the)X 2531(FDE)X 2707(begins)X 2940(in)X 3026(the)X 3148(.debug_frame)X 3616(section.)X 3907(The)X 576 2304(location)N 860(pointed)X 1126(to)X 1214(by)X 0 f 1348(fde_byte_length)X 1 f 2095(is)X 2175(set)X 2291(to)X 2380(the)X 2505(length)X 2732(in)X 2821(bytes)X 3017(of)X 3111(the)X 3236(portion)X 3494(of)X 3588(.debug_frame)X 576 2400(for)N 691(this)X 827(FDE.)X 1039(This)X 1202(is)X 1276(the)X 1395(same)X 1581(as)X 1669(the)X 1787(value)X 1981(returned)X 2269(by)X 0 f 2397(dwarf_get_fde_range)X 1 f (.)S 3369(The)X 3514(location)X 3792(pointed)X 576 2496(to)N 666(by)X 0 f 802(cie_offset)X 1 f 1310(is)X 1391(set)X 1508(to)X 1598(the)X 1724(offset)X 1935(in)X 2025(the)X 2151(.debug_frame)X 2623(section)X 2878(of)X 2973(the)X 3100(CIE)X 3258(used)X 3434(by)X 3543(this)X 3687(FDE.)X 3907(The)X 576 2592(location)N 864(pointed)X 1134(to)X 1226(by)X 0 f 1364(cie_index)X 1 f 1826(is)X 1909(set)X 2028(to)X 2120(the)X 2248(index)X 2456(of)X 2553(the)X 2681(CIE)X 2840(used)X 3017(by)X 3127(this)X 3271(FDE.)X 3491(The)X 3645(index)X 3852(is)X 3934(the)X 576 2688(index)N 774(of)X 861(the)X 979(CIE)X 1128(in)X 1210(the)X 1328(list)X 1445(pointed)X 1705(to)X 1787(by)X 0 f 1915(cie_data)X 1 f 2319(as)X 2406(set)X 2516(by)X 2617(the)X 2736(function)X 0 f 3052(dwarf_get_fde_list\(\))X 1 f (.)S 576 2784(However,)N 915(if)X 987(the)X 1108(function)X 0 f 1426(dwarf_get_fde_for_die\(\))X 1 f 2553(was)X 2701(used)X 2871(to)X 2956(obtain)X 3179(the)X 3300(given)X 0 f 3529(fde)X 1 f (,)S 3716(this)X 3854(index)X 576 2880(may)N 734(not)X 856(be)X 952(correct.)X 1236(The)X 1381(location)X 1659(pointed)X 1919(to)X 2001(by)X 0 f 2129(fde_offset)X 1 f 2629(is)X 2702(set)X 2811(to)X 2893(the)X 3011(offset)X 3214(of)X 3301(the)X 3419(start)X 3577(of)X 3664(this)X 3799(FDE)X 3970(in)X 576 2976(the)N 694(.debug_frame)X 1158(section.)X 0 f 1501(dwarf_get_fde_range\(\))X 1 f 2529(returns)X 0 f 2800(DW_DLV_ERROR)X 1 f 3396(on)X 3496(error.)X 3 f 9 s 576 3216(5.14.0.6)N 846(dwarf_get_cie_info\(\))X 0 f 10 s 576 3360(int)N 768(dwarf_get_cie_info\()X 960 3456(Dwarf_Cie)N 1728(cie,)X 960 3552(Dwarf_Unsigned)N 1680(*bytes_in_cie,)X 960 3648(Dwarf_Small)N 1680(*version,)X 960 3744(char)N 1632(**augmenter,)X 960 3840(Dwarf_Unsigned)N 1680(*code_alignment_factor,)X 960 3936(Dwarf_Signed)N 1584(*data_alignment_factor,)X 960 4032(Dwarf_Half)N 1680(*return_address_register_rule,)X 960 4128(Dwarf_Ptr)N 1680(*initial_instructions,)X 960 4224(Dwarf_Unsigned)N 1680(*initial_instructions_length,)X 960 4320(Dwarf_Error)N 1680(*error\);)X 576 4464(dwarf_get_cie_info\(\))N 1 f 1563(is)X 1643(primarily)X 1968(for)X 2090(Internal-level)X 2551(Interface)X 2866(consumers.)X 3277(If)X 3359(successful,)X 3737(it)X 3809(returns)X 0 f 576 4560(DW_DLV_OK)N 1 f 1033(and)X 1174(sets)X 0 f 1347(*bytes_in_cie)X 1 f 1996(to)X 2083(the)X 2206(number)X 2476(of)X 2568(bytes)X 2762(in)X 2849(the)X 2972(portion)X 3228(of)X 3320(the)X 3443(frames)X 3687(section)X 3938(for)X 576 4656(the)N 697(CIE)X 849(represented)X 1243(by)X 1346(the)X 1467(given)X 0 f 1696(Dwarf_Cie)X 1 f 2151(descriptor,)X 0 f 2543(cie)X 1 f (.)S 2750(The)X 2898(other)X 3086(fields)X 3287(are)X 3409(directly)X 3678(taken)X 3876(from)X 576 4752(the)N 694(cie)X 808(and)X 944(returned,)X 1252(via)X 1370(the)X 1488(pointers)X 1766(to)X 1848(the)X 1966(caller.)X 2205(It)X 2274(returns)X 0 f 2545(DW_DLV_ERROR)X 1 f 3141(on)X 3241(error.)X 3 f 9 s 576 4992(5.14.0.7)N 846(dwarf_get_fde_instr_bytes\(\))X 0 f 10 s 576 5136(int)N 768(dwarf_get_fde_instr_bytes\()X 960 5232(Dwarf_Fde)N 1440(fde,)X 960 5328(Dwarf_Ptr)N 1440(*outinstrs,)X 960 5424(Dwarf_Unsigned)N 1680(*outlen,)X 960 5520(Dwarf_Error)N 1536(*error\);)X 576 5664(dwarf_get_fde_instr_bytes\(\))N 1 f 1892(returns)X 0 f 2163(DW_DLV_OK)X 1 f 2615(and)X 2751(sets)X 0 f 2919(*outinstrs)X 1 f 3419(to)X 3501(a)X 3557(pointer)X 3804(to)X 3886(a)X 3943(set)X 576 5760(of)N 666(bytes)X 858(which)X 1077(are)X 1199(the)X 1320(actual)X 1535(frame)X 1746(instructions)X 2142(for)X 2259(this)X 2397(fde.)X 2563(It)X 2634(also)X 2785(sets)X 0 f 2955(*outlen)X 1 f 3313(to)X 3397(the)X 3517(length,)X 3759(in)X 3843(bytes,)X 576 5856(of)N 669(the)X 793(frame)X 1007(instructions.)X 1446(It)X 1521(returns)X 0 f 1798(DW_DLV_ERROR)X 1 f 2401(on)X 2508(error.)X 2732(It)X 2808(never)X 3014(returns)X 0 f 3292(DW_DLV_NO_ENTRY)X 1 f (.)S 576 5952(The)N 730(intent)X 941(is)X 1023(to)X 1114(allow)X 1321(low-level)X 1653(consumers)X 2024(like)X 2172(a)X 2236(dwarf-dumper)X 2724(to)X 2814(print)X 2993(the)X 3119(bytes)X 3316(in)X 3406(some)X 3603(fashion.)X 3907(The)X 576 6183(rev)N 699(1.61,)X 879(3)X 939(Apr)X 1084(2006)X 2217(-)X 2264(52)X 2364(-)X 53 p %%Page: 53 53 0(Courier)xf 0 f 10 s 0 xH 0 xS 0 f 1 f 2217 384(-)N 2264(53)X 2364(-)X 576 768(memory)N 863(pointed)X 1123(to)X 1205(by)X 0 f 1333(outinstrs)X 1 f 1785(must)X 1960(not)X 2082(be)X 2178(changed)X 2466(and)X 2602(there)X 2783(is)X 2856(nothing)X 3120(to)X 3202(free.)X 3 f 9 s 576 1008(5.14.0.8)N 846(dwarf_get_fde_info_for_reg\(\))X 1 f 10 s 576 1152(This)N 794(interface)X 1152(is)X 1281(suitable)X 1606(for)X 1776(DWARF2)X 2182(but)X 2361(is)X 2491(not)X 2670(sufficient)X 3050(for)X 3221(DWARF3.)X 3667(See)X 0 f 3888(int)X 576 1248(dwarf_get_fde_info_for_reg3)N 1 f (.)S 0 f 576 1392(int)N 768(dwarf_get_fde_info_for_reg\()X 960 1488(Dwarf_Fde)N 1440(fde,)X 960 1584(Dwarf_Half)N 1488(table_column,)X 960 1680(Dwarf_Addr)N 1488(pc_requested,)X 960 1776(Dwarf_Signed)N 1584(*offset_relevant,)X 960 1872(Dwarf_Signed)N 1584(*register_num,)X 960 1968(Dwarf_Signed)N 1584(*offset,)X 960 2064(Dwarf_Addr)N 1488(*row_pc,)X 960 2160(Dwarf_Error)N 1536(*error\);)X 576 2304(dwarf_get_fde_info_for_reg\(\))N 1 f 1946(returns)X 0 f 2224(DW_DLV_OK)X 1 f 2683(and)X 2826(sets)X 0 f 3001(*offset_relevant)X 1 f 3796(to)X 3885(non-)X 576 2400(zero)N 759(if)X 852(the)X 994(offset)X 1221(is)X 1318(relevant)X 1621(for)X 1759(the)X 1901(row)X 2070(specified)X 2404(by)X 0 f 2556(pc_requested)X 1 f 3176(and)X 3336(column)X 3619(specified)X 3952(by)X 0 f 576 2496(table_column)N 1 f (,)S 1198(for)X 1318(the)X 1442(FDE)X 1619(specified)X 1935(by)X 0 f 2069(fde)X 1 f (.)S 2279(The)X 2430(intent)X 2639(is)X 2719(to)X 2808(return)X 3027(the)X 3152(rule)X 3304(for)X 3425(the)X 3550(given)X 3755(pc)X 3858(value)X 576 2592(and)N 721(register.)X 1031(The)X 1185(location)X 1472(pointed)X 1741(to)X 1832(by)X 0 f 1969(register_num)X 1 f 2574(is)X 2656(set)X 2774(to)X 2865(the)X 2992(register)X 3262(value)X 3465(for)X 3588(the)X 3714(rule.)X 3907(The)X 576 2688(location)N 856(pointed)X 1118(to)X 1202(by)X 0 f 1332(offset)X 1 f 1643(is)X 1719(set)X 1831(to)X 1916(the)X 2037(offset)X 2243(value)X 2440(for)X 2557(the)X 2678(rule.)X 2866(If)X 2943(offset)X 3149(is)X 3225(not)X 3350(relevant)X 3632(for)X 3749(this)X 3887(rule,)X 0 f 576 2784(*offset_relevant)N 1 f 1368(is)X 1445(set)X 1558(to)X 1644(zero.)X 1847(Since)X 2049(more)X 2237(than)X 2398(one)X 2537(pc)X 2636(value)X 2833(will)X 2980(have)X 3155(rows)X 3334(with)X 3499(identical)X 3798(entries,)X 576 2880(the)N 711(user)X 882(may)X 1057(want)X 1250(to)X 1349(know)X 1564(the)X 1699(earliest)X 1968(pc)X 2081(value)X 2292(after)X 2477(which)X 2710(the)X 2845(rules)X 3038(for)X 3170(all)X 3288(the)X 3424(columns)X 3733(remained)X 576 2976(unchanged.)N 987(Recall)X 1215(that)X 1358(in)X 1443(the)X 1564(virtual)X 1796(table)X 1975(that)X 2118(the)X 2239(frame)X 2450(information)X 2851(represents)X 3199(there)X 3382(may)X 3542(be)X 3640(one)X 3778(or)X 3867(more)X 576 3072(table)N 761(rows)X 946(with)X 1117(identical)X 1422(data)X 1585(\(each)X 1789(such)X 1965(table)X 2150(row)X 2304(at)X 2391(a)X 2456(different)X 2762(pc)X 2867(value\).)X 3137(Given)X 3362(a)X 0 f 3456(pc_requested)X 1 f 576 3168(which)N 801(refers)X 1014(to)X 1105(a)X 1170(pc)X 1275(in)X 1366(such)X 1542(a)X 1606(group)X 1821(of)X 1916(identical)X 2220(rows,)X 2424(the)X 2550(location)X 2836(pointed)X 3104(to)X 3194(by)X 0 f 3330(row_pc)X 1 f 3646(is)X 3727(set)X 3844(to)X 3934(the)X 576 3264(lowest)N 818(pc)X 927(value)X 1134(within)X 1371(the)X 1502(group)X 1722(of)X 1842(identical)X 2151(rows.)X 2380(The)X 2558(value)X 2765(put)X 2901(in)X 0 f 3025(*register_num)X 1 f 3683(any)X 3833(of)X 3934(the)X 0 f 576 3360(DW_FRAME_*)N 1 f 1076(table)X 1252(columns)X 1543(values)X 1768(specified)X 2078(in)X 0 f 2188(libdwarf.h)X 1 f 2688(or)X 0 f 2803(dwarf.h)X 1 f (.)S 0 f 576 3552(dwarf_get_fde_info_for_reg)N 1 f 1844(returns)X 0 f 2115(DW_DLV_ERROR)X 1 f 2711(if)X 2780(there)X 2961(is)X 3034(an)X 3130(error.)X 576 3744(It)N 645(is)X 718(usable)X 943(with)X 1105(either)X 0 f 1336(dwarf_get_fde_n\(\))X 1 f 2172(or)X 0 f 2287(dwarf_get_fde_at_pc\(\))X 1 f (.)S 3 f 9 s 576 3984(5.14.0.9)N 846(dwarf_get_fde_info_for_all_regs\(\))X 0 f 10 s 576 4128(int)N 768(dwarf_get_fde_info_for_all_regs\()X 960 4224(Dwarf_Fde)N 1440(fde,)X 960 4320(Dwarf_Addr)N 1488(pc_requested,)X 960 4416(Dwarf_Regtable)N 1680(*reg_table,)X 960 4512(Dwarf_Addr)N 1488(*row_pc,)X 960 4608(Dwarf_Error)N 1536(*error\);)X 576 4752(dwarf_get_fde_info_for_all_regs\(\))N 1 f 2196(returns)X 0 f 2483(DW_DLV_OK)X 1 f 2951(and)X 3103(sets)X 0 f 3287(*reg_table)X 1 f 3803(for)X 3934(the)X 576 4848(row)N 721(specified)X 1031(by)X 0 f 1159(pc_requested)X 1 f 1755(for)X 1869(the)X 1987(FDE)X 2158(specified)X 2468(by)X 0 f 2596(fde)X 1 f (.)S 576 4992(The)N 724(intent)X 929(is)X 1005(to)X 1090(return)X 1305(the)X 1426(rules)X 1605(for)X 1722(decoding)X 2039(all)X 2142(the)X 2263(registers,)X 2578(given)X 2779(a)X 2839(pc)X 2939(value.)X 0 f 3233(reg_table)X 1 f 3689(is)X 3766(an)X 3866(array)X 576 5088(of)N 674(rules,)X 881(one)X 1028(for)X 1153(each)X 1332(register)X 1604(specified)X 1925(in)X 0 f 2045(dwarf.h)X 1 f (.)S 2431(The)X 2586(rule)X 2741(for)X 2865(each)X 3043(register)X 3314(contains)X 3611(three)X 3802(items)X 4005(-)X 0 f 576 5184(dw_regnum)N 1 f 1033(which)X 1254(denotes)X 1524(the)X 1647(register)X 1913(value)X 2112(for)X 2231(that)X 2376(rule,)X 0 f 2574(dw_offset)X 1 f 3032(which)X 3254(denotes)X 3525(the)X 3649(offset)X 3858(value)X 576 5280(for)N 695(that)X 840(rule)X 990(and)X 0 f 1159(dw_offset_relevant)X 1 f 2048(which)X 2269(is)X 2347(set)X 2461(to)X 2548(zero)X 2712(if)X 2786(offset)X 2994(is)X 3072(not)X 3199(relevant)X 3483(for)X 3602(that)X 3747(rule.)X 3916(See)X 0 f 576 5376(dwarf_get_fde_info_fo_reg\(\))N 1 f 1892(for)X 2006(a)X 2062(description)X 2438(of)X 0 f 2553(row_pc)X 1 f (.)S 0 f 576 5520(dwarf_get_fde_info_for_all_regs)N 1 f 2084(returns)X 0 f 2355(DW_DLV_ERROR)X 1 f 2951(if)X 3020(there)X 3201(is)X 3274(an)X 3370(error.)X 0 f 576 5664(int)N 768(dwarf_get_fde_info_for_all_regs)X 1 f 2276(is)X 2349(SGI/MIPS)X 2706(specific.)X 576 6183(rev)N 699(1.61,)X 879(3)X 939(Apr)X 1084(2006)X 2217(-)X 2264(53)X 2364(-)X 54 p %%Page: 54 54 0(Courier)xf 0 f 10 s 0 xH 0 xS 0 f 1 f 2217 384(-)N 2264(54)X 2364(-)X 3 f 9 s 576 768(5.14.0.10)N 882(dwarf_set_frame_rule_table_size\(\))X 1 f 10 s 576 912(This)N 738(allows)X 967(consumers)X 1330(to)X 1412(set)X 1521(the)X 1639(size)X 1784(of)X 1871(the)X 1989(\(internal)X 2281(to)X 2364(libdwarf\))X 2684(rule)X 2830(table.)X 3047(It)X 3117(should)X 3351(be)X 3448(at)X 3527(least)X 3695(as)X 3783(large)X 3965(as)X 576 1008(the)N 704(number)X 979(of)X 1076(real)X 1227(registers)X 1529(in)X 1621(the)X 1748(ABI)X 1915(which)X 2140(is)X 2222(to)X 2313(be)X 2418(read)X 2586(in)X 2677(for)X 2800(the)X 2927 0.1830(dwarf_get_fde_info_for_reg3\(\))AX 3965(or)X 576 1104 0.1515(dwarf_get_fde_info_for_all_regs3\(\))AN 1768(functions)X 2098(to)X 2192(work)X 2389(properly.)X 2733(It)X 2814(must)X 3002(be)X 3111(less)X 3264(than)X 3435(the)X 3566(marker)X 3827(values)X 576 1200(DW_FRAME_UNDEFINED_VAL,)N 1769(DW_FRAME_SAME_VAL,)X 2725(DW_FRAME_CFA_COL3.)X 0 f 576 1344(Dwarf_Half)N 576 1440(dwarf_set_frame_rule_table_size\(Dwarf_Debug)N 2688(dbg,)X 1008 1536(Dwarf_Half)N 1536(value\);)X 576 1776(ddwarf_set_frame_rule_table_size\(\))N 1 f 2237(sets)X 2386(the)X 2513(value)X 0 f 2744(value)X 1 f 3013(as)X 3109(the)X 3236(size)X 3391(of)X 3488(libdwarf-internal)X 576 1872(rules)N 754(tables)X 983(of)X 0 f 1100(dbg)X 1 f (.)S 1305(The)X 1451(function)X 1739(returns)X 1983(the)X 2102(previous)X 2399(value)X 2594(of)X 2682(the)X 2801(rules)X 2978(table)X 3155(size)X 3301(setting)X 3535(\(taken)X 3757(from)X 3934(the)X 0 f 576 1968(dbg)N 1 f 740(structure\).)X 3 f 9 s 576 2208(5.14.0.11)N 882(dwarf_set_frame_rule_inital_value\(\))X 1 f 10 s 576 2352(This)N 748(allows)X 987(consumers)X 1360(to)X 1452(set)X 1572(the)X 1701(initial)X 1918(value)X 2123(for)X 2248(rows)X 2435(in)X 2528(the)X 2657(frame)X 2876(tables.)X 3134(By)X 3258(default)X 3512(it)X 3587(is)X 3671(taken)X 3876(from)X 576 2448(libdwarf.h)N 1057(and)X 1322(is)X 1524(DW_FRAME_REG_INITIAL_VALUE)X 2969(\(which)X 3340(itself)X 3648(is)X 3849(either)X 576 2544(DW_FRAME_SAME_VAL)N 1571(or)X 1718(DW_FRAME_UNDEFINED_VAL\).)X 3018(The)X 3223(MIPS/IRIX)X 3676(default)X 3979(is)X 576 2640(DW_FRAME_SAME_VAL.)N 1553(Comsumer)X 1925(code)X 2098(should)X 2332(set)X 2441(this)X 2576(appropriately)X 3024(and)X 3160(for)X 3274(many)X 3472(architectures)X 3903(\(but)X 576 2736(probably)N 881(not)X 1003(MIPS\))X 1236(DW_FRAME_UNDEFINED_VAL)X 2409(is)X 2482(an)X 2578(appropriate)X 2964(setting.)X 0 f 576 2880(Dwarf_Half)N 576 2976(dwarf_set_frame_rule_inital_value\(Dwarf_Debug)N 2784(dbg,)X 1008 3072(Dwarf_Half)N 1536(value\);)X 576 3312(dwarf_set_frame_rule_inital_value\(\))N 1 f 2294(sets)X 2452(the)X 2588(value)X 0 f 2828(value)X 1 f 3106(as)X 3211(the)X 3347(initial)X 3571(value)X 3784(for)X 3917(this)X 0 f 576 3408(dbg)N 1 f 741(when)X 936(initializing)X 1303(rules)X 1480(tables.)X 1728(The)X 1873(function)X 2160(returns)X 2403(the)X 2521(previous)X 2817(value)X 3011(of)X 3098(the)X 3216(initial)X 3422(setting)X 3655(\(taken)X 3876(from)X 576 3504(the)N 0 f 722(dbg)X 1 f 886(structure\).)X 3 f 9 s 576 3936(5.14.0.12)N 882(dwarf_get_fde_info_for_reg3\(\))X 1 f 10 s 576 4080(This)N 745(interface)X 1055(is)X 1136(suitable)X 1413(for)X 1535(DWARF3)X 1892(and)X 2036(DWARF2.)X 2433(It)X 2510(returns)X 2761(the)X 2887(values)X 3120(for)X 3242(a)X 3306(particular)X 3642(real)X 3791(register)X 576 4176(\(Not)N 743(for)X 857(the)X 975(CFA)X 1150(register,)X 1431(see)X 1554 0.2031(dwarf_get_fde_info_for_cfa_reg3\(\))AX 2722(below\).)X 0 f 576 4320(int)N 768(dwarf_get_fde_info_for_reg3\()X 960 4416(Dwarf_Fde)N 1440(fde,)X 960 4512(Dwarf_Half)N 1488(table_column,)X 960 4608(Dwarf_Addr)N 1488(pc_requested,)X 960 4704(Dwarf_Small)N 1584(*value_type,)X 960 4800(Dwarf_Signed)N 1584(*offset_relevant,)X 960 4896(Dwarf_Signed)N 1584(*register_num,)X 960 4992(Dwarf_Signed)N 1584(*offset_or_block_len,)X 960 5088(Dwarf_Ptr)N 1584(*block_ptr,)X 960 5184(Dwarf_Addr)N 1584(*row_pc,)X 960 5280(Dwarf_Error)N 1584(*error\);)X 576 5424(dwarf_get_fde_info_for_re3\(\))N 1 f 1955(returns)X 0 f 2241(DW_DLV_OK)X 1 f 2708(on)X 2823(success.)X 3139(It)X 3223(sets)X 0 f 3406(*value_type)X 1 f 3970(to)X 576 5520(one)N 750(of)X 895(DW_EXPR_OFFSET)X 1659(\(0\),)X 1830(DW_EXPR_VAL_OFFSET\(1\),)X 2912(DW_EXPR_EXPRESSION\(2\))X 3965(or)X 576 5616(DW_EXPR_VAL_EXPRESSION\(3\).)N 1842(On)X 1965(call,)X 0 f 2154(table_column)X 1 f 2755(must)X 2936(be)X 3038(set)X 3153(to)X 3241(the)X 3365(register)X 3632(number)X 3903(of)X 3996(a)X 576 5712(real)N 861(register.)X 1285(Not)X 1568(the)X 1829(cfa)X 2091('register')X 2549(or)X 2779(DW_FRAME_SAME_VALUE)X 3965(or)X 576 5808(DW_FRAME_UNDEFINED_VALUE.)N 576 6183(rev)N 699(1.61,)X 879(3)X 939(Apr)X 1084(2006)X 2217(-)X 2264(54)X 2364(-)X 55 p %%Page: 55 55 0(Courier)xf 0 f 10 s 0 xH 0 xS 0 f 1 f 2217 384(-)N 2264(55)X 2364(-)X 576 768(if)N 0 f 673(*value_type)X 1 f 1221(has)X 1348(the)X 1466(value)X 1660(DW_EXPR_OFFSET)X 2386(\(0\))X 2500(then:)X 896 912(It)N 980(sets)X 0 f 1163(*offset_relevant)X 1 f 1966(to)X 2063(non-zero)X 2384(if)X 2468(the)X 2601(offset)X 2819(is)X 2907(relevant)X 3201(for)X 3331(the)X 3465(row)X 3626(specified)X 3952(by)X 0 f 896 1008(pc_requested)N 1 f 1512(and)X 1667(column)X 1946(specified)X 2275(by)X 0 f 2422(table_column)X 1 f 3037(or,)X 3163(for)X 3296(the)X 3433(FDE)X 3623(specified)X 3952(by)X 0 f 896 1104(fde)N 1 f (.)S 1102(In)X 1191(this)X 1328(case)X 1509(the)X 0 f 1678(*register_num)X 1 f 2325(will)X 2472(be)X 2571(set)X 2683(to)X 2768(DW_FRAME_CFA_COL3.)X 3715(This)X 3880(is)X 3956(an)X 896 1200(offset\(N\))N 1268(rule)X 1470(as)X 1614(specified)X 1981(in)X 2120(the)X 2295(DWARF3/2)X 2762(documents.)X 3225(Adding)X 3541(the)X 3715(value)X 3965(of)X 0 f 896 1296(*offset_or_block_len)N 1 f 1887(to)X 1980(the)X 2109(value)X 2314(of)X 2413(the)X 2543(CFA)X 2730(register)X 3003(gives)X 3204(the)X 3334(address)X 3607(of)X 3706(a)X 3774(location)X 896 1392(holding)N 1160(the)X 1278(previous)X 1574(value)X 1768(of)X 1855(register)X 0 f 2144(table_column)X 1 f (.)S 896 1632(If)N 973(offset)X 1179(is)X 1255(not)X 1380(relevant)X 1662(for)X 1779(this)X 1917(rule,)X 0 f 2113(*offset_relevant)X 1 f 2904(is)X 2980(set)X 3092(to)X 3177(zero.)X 0 f 3408(*register_num)X 1 f 896 1728(will)N 1044(be)X 1143(set)X 1255(to)X 1340(the)X 1461(number)X 1729(of)X 1819(the)X 1940(real)X 2084(register)X 2348(holding)X 2615(the)X 2736(value)X 2933(of)X 3023(the)X 0 f 3172(table_column)X 1 f 3771(register.)X 896 1824(This)N 1058(is)X 1131(the)X 1249(register\(R\))X 1617(rule)X 1762(as)X 1849(specifified)X 2208(in)X 2290(DWARF3/2)X 2701(documents.)X 896 1968(The)N 1049(intent)X 1259(is)X 1340(to)X 1430(return)X 1650(the)X 1777(rule)X 1931(for)X 2054(the)X 2181(given)X 2388(pc)X 2493(value)X 2696(and)X 2841(register.)X 3151(The)X 3305(location)X 3592(pointed)X 3861(to)X 3952(by)X 0 f 896 2064(register_num)N 1 f 1494(is)X 1569(set)X 1680(to)X 1764(the)X 1884(register)X 2147(value)X 2343(for)X 2459(the)X 2579(rule.)X 2766(The)X 2913(location)X 3193(pointed)X 3455(to)X 3539(by)X 0 f 3669(offset)X 1 f 3979(is)X 896 2160(set)N 1011(to)X 1099(the)X 1223(offset)X 1432(value)X 1632(for)X 1752(the)X 1876(rule.)X 2067(Since)X 2271(more)X 2462(than)X 2627(one)X 2770(pc)X 2873(value)X 3074(will)X 3225(have)X 3404(rows)X 3587(with)X 3756(identical)X 896 2256(entries,)N 1154(the)X 1275(user)X 1432(may)X 1593(want)X 1772(to)X 1857(know)X 2058(the)X 2179(earliest)X 2434(pc)X 2533(value)X 2730(after)X 2901(which)X 3120(the)X 3241(rules)X 3420(for)X 3537(all)X 3640(the)X 3761(columns)X 896 2352(remained)N 1220(unchanged.)X 1633(Recall)X 1863(that)X 2008(in)X 2095(the)X 2218(virtual)X 2452(table)X 2633(that)X 2778(the)X 2901(frame)X 3115(information)X 3519(represents)X 3871(there)X 896 2448(may)N 1059(be)X 1160(one)X 1301(or)X 1393(more)X 1583(table)X 1764(rows)X 1945(with)X 2111(identical)X 2411(data)X 2569(\(each)X 2768(such)X 2939(table)X 3119(row)X 3268(at)X 3350(a)X 3410(different)X 3711(pc)X 3811(value\).)X 896 2544(Given)N 1119(a)X 0 f 1210(pc_requested)X 1 f 1813(which)X 2036(refers)X 2247(to)X 2336(a)X 2399(pc)X 2502(in)X 2591(such)X 2766(a)X 2830(group)X 3045(of)X 3140(identical)X 3444(rows,)X 3648(the)X 3774(location)X 896 2640(pointed)N 1156(to)X 1238(by)X 0 f 1366(row_pc)X 1 f 1674(is)X 1747(set)X 1856(to)X 1938(the)X 2056(lowest)X 2285(pc)X 2381(value)X 2575(within)X 2799(the)X 2917(group)X 3124(of)X 3231(identical)X 3527(rows.)X 576 2976(If)N 0 f 678(*value_type)X 1 f 1226(has)X 1353(the)X 1471(value)X 1665(DW_EXPR_VAL_OFFSET)X 2596(\(1\))X 2710(then:)X 896 3072(This)N 1110(will)X 1306(be)X 1455(a)X 1564(val_offset\(N\))X 2070(rule)X 2268(as)X 2408(specified)X 2771(in)X 2906(the)X 3077(DWARF3/2)X 3541(documents)X 3961(so)X 0 f 896 3168(*offset_relevant)N 1 f 1753(will)X 1966(be)X 2131(non)X 2339(zero.)X 2606(The)X 2819(calculation)X 3279(is)X 3420(identical)X 3784(to)X 3934(the)X 896 3264(DW_EXPR_OFFSET)N 1645(\(0\))X 1782(calculation)X 2177(with)X 0 f 2410(*offset_relevant)X 1 f 3221(non-zero,)X 3570(but)X 3716(the)X 3858(value)X 896 3360(resulting)N 1202(is)X 1281(the)X 1405(actual)X 0 f 1651(table_column)X 1 f 2253(value)X 2453(\(rather)X 2694(than)X 2858(the)X 2982(address)X 3249(where)X 3471(the)X 3594(value)X 3793(may)X 3956(be)X 896 3456(found\).)N 576 3600(If)N 0 f 678(*value_type)X 1 f 1226(has)X 1353(the)X 1471(value)X 1665(DW_EXPR_EXPRESSION)X 2587(\(1\))X 2701(then:)X 0 f 944 3696(*offset_or_block_len)N 1 f 1924(is)X 1997(set)X 2107(to)X 2190(the)X 2309(length)X 2530(in)X 2613(bytes)X 2803(of)X 2891(a)X 2948(block)X 3147(of)X 3235(memory)X 3523(with)X 3686(a)X 3743(DWARF)X 896 3792(expression)N 1264(in)X 1351(the)X 1474(block.)X 0 f 1773(*block_ptr)X 1 f 2278(is)X 2356(set)X 2469(to)X 2555(point)X 2743(at)X 2825(the)X 2947(block)X 3149(of)X 3240(memory.)X 3571(The)X 3720(consumer)X 896 3888(code)N 1079(should)X 1343(evaluate)X 1642(the)X 1771(block)X 1980(as)X 2078(a)X 2145(DWARF-expression.)X 2855(The)X 3011(result)X 3220(is)X 3304(the)X 3433(address)X 3705(where)X 3934(the)X 896 3984(previous)N 1192(value)X 1386(of)X 1473(the)X 1591(register)X 1852(may)X 2010(be)X 2106(found.)X 2353(This)X 2515(is)X 2588(a)X 2644(DWARF3/2)X 3055(expression\(E\))X 3521(rule.)X 576 4128(If)N 0 f 678(*value_type)X 1 f 1226(has)X 1353(the)X 1471(value)X 1665(DW_EXPR_VAL_EXPRESSION)X 2792(\(1\))X 2906(then:)X 896 4224(The)N 1048(calculation)X 1427(is)X 1507(exactly)X 1766(as)X 1860(for)X 1981(DW_EXPR_EXPRESSION)X 2911(\(1\))X 3033(but)X 3163(the)X 3289(result)X 3495(of)X 3590(the)X 3716(DWARF-)X 896 4320(expression)N 1262(evaluation)X 1618(is)X 1693(the)X 1813(value)X 2009(of)X 2098(the)X 0 f 2286(table_column)X 1 f 2884(\(not)X 3035(the)X 3155(address)X 3418(of)X 3507(the)X 3627(value\).)X 3890(This)X 896 4416(is)N 969(a)X 1025(DWARF3/2)X 1436(val_expression\(E\))X 2040(rule.)X 0 f 576 4608(dwarf_get_fde_info_for_reg)N 1 f 1845(returns)X 0 f 2117(DW_DLV_ERROR)X 1 f 2714(if)X 2784(there)X 2966(is)X 3040(an)X 3137(error)X 3315(and)X 3452(if)X 3522(there)X 3704(is)X 3778(an)X 3875(error)X 576 4704(only)N 738(the)X 0 f 884(error)X 1 f 1144(pointer)X 1391(is)X 1464(set,)X 1593(none)X 1769(of)X 1856(the)X 1974(other)X 2159(output)X 2383(arguments)X 2737(are)X 2856(touched.)X 576 4896(It)N 645(is)X 718(usable)X 943(with)X 1105(either)X 0 f 1336(dwarf_get_fde_n\(\))X 1 f 2172(or)X 0 f 2287(dwarf_get_fde_at_pc\(\))X 1 f (.)S 3 f 9 s 576 5232(5.14.0.13)N 882(dwarf_get_fde_info_for_cfa_reg3\(\))X 1 f 10 s 576 6183(rev)N 699(1.61,)X 879(3)X 939(Apr)X 1084(2006)X 2217(-)X 2264(55)X 2364(-)X 56 p %%Page: 56 56 0(Courier)xf 0 f 10 s 0 xH 0 xS 0 f 1 f 2217 384(-)N 2264(56)X 2364(-)X 0 f 596 768(int)N 788(dwarf_get_fde_info_for_cfa_reg3\(Dwarf_Fde)X 2804(fde,)X 864 864(Dwarf_Addr)N 1824(pc_requested,)X 864 960(Dwarf_Small)N 1440(*)X 1824(value_type,)X 864 1056(Dwarf_Signed*)N 1824(offset_relevant,)X 864 1152(Dwarf_Signed*)N 1824(register_num,)X 864 1248(Dwarf_Signed*)N 1824(offset_or_block_len,)X 864 1344(Dwarf_Ptr)N 1440(*)X 1824(block_ptr)X 2304(,)X 864 1440(Dwarf_Addr)N 1440(*)X 1824(row_pc_out,)X 864 1536(Dwarf_Error)N 1440(*)X 1824(error\))X 1 f 576 1680(This)N 739(is)X 813(identical)X 1110(to)X 0 f 1241(dwarf_get_fde_info_for_reg3\(\))X 1 f 2654(except)X 2885(the)X 3004(returned)X 3293(values)X 3520(are)X 3641(for)X 3757(the)X 3877(CFA)X 576 1776(rule.)N 764(So)X 871(register)X 1135(number)X 0 f 1431(*register_num)X 1 f 2078(will)X 2225(be)X 2324(set)X 2436(to)X 2520(a)X 2578(real)X 2721(register,)X 3004(not)X 3128(DW_FRAME_CFA_COL3,)X 576 1872(DW_FRAME_SAME_VALUE,)N 1639(or)X 1726(DW_FRAME_UNDEFINED_VALUE.)X 3 f 9 s 576 2304(5.14.0.14)N 882(dwarf_get_fde_info_for_all_regs3\(\))X 0 f 10 s 576 2448(int)N 768(dwarf_get_fde_info_for_all_regs3\()X 960 2544(Dwarf_Fde)N 1440(fde,)X 960 2640(Dwarf_Addr)N 1488(pc_requested,)X 960 2736(Dwarf_Regtable3)N 1728(*reg_table,)X 960 2832(Dwarf_Addr)N 1488(*row_pc,)X 960 2928(Dwarf_Error)N 1536(*error\))X 576 3072(dwarf_get_fde_info_for_all_regs3\(\))N 1 f 2237(returns)X 0 f 2517(DW_DLV_OK)X 1 f 2978(and)X 3123(sets)X 0 f 3300(*reg_table)X 1 f 3810(for)X 3934(the)X 576 3168(row)N 729(specified)X 1047(by)X 0 f 1183(pc_requested)X 1 f 1787(for)X 1909(the)X 2035(FDE)X 2214(specified)X 2532(by)X 0 f 2668(fde)X 1 f (.)S 2880(The)X 3033(intent)X 3242(is)X 3322(to)X 3411(return)X 3630(the)X 3755(rules)X 3938(for)X 576 3264(decoding)N 893(all)X 996(the)X 1117(registers,)X 1432(given)X 1633(a)X 1692(pc)X 1791(value.)X 0 f 2085(reg_table)X 1 f 2541(is)X 2618(an)X 2718(array)X 2908(of)X 2999(rules,)X 3199(the)X 3321(array)X 3511(size)X 3660(specifed)X 3952(by)X 576 3360(the)N 696(caller.)X 936(plus)X 1090(a)X 1147(rule)X 1293(for)X 1408(the)X 1527(CFA.)X 1743(The)X 1889(rule)X 2035(for)X 2150(the)X 2269(cfa)X 2389(returned)X 2678(in)X 0 f 2809(*reg_table)X 1 f 3310(defines)X 3563(the)X 3682(CFA)X 3858(value)X 576 3456(at)N 0 f 719(pc_requested)X 1 f 1332(The)X 1494(rule)X 1656(for)X 1787(each)X 1972(register)X 2250(contains)X 2574(several)X 2839(values)X 3081(that)X 3238(enable)X 3485(the)X 3620(consumer)X 3970(to)X 576 3552(determine)N 946(the)X 1093(previous)X 1418(value)X 1641(of)X 1757(the)X 1904(register)X 2194(\(see)X 2373(the)X 2520(earlier)X 2775(documentation)X 3299(of)X 3414(Dwarf_Regtable3\).)X 0 f 576 3648(dwarf_get_fde_info_for_reg3\(\))N 1 f 2053(and)X 2235(the)X 2399(Dwarf_Regtable3)X 3036(documentation)X 3578(above)X 3836(for)X 3996(a)X 576 3744(description)N 952(of)X 1039(the)X 1157(values)X 1382(for)X 1496(each)X 1664(row.)X 0 f 576 3936(dwarf_get_fde_info_for_all_regs)N 1 f 2084(returns)X 0 f 2355(DW_DLV_ERROR)X 1 f 2951(if)X 3020(there)X 3201(is)X 3274(an)X 3370(error.)X 576 4128(It's)N 703(up)X 803(to)X 885(the)X 1003(caller)X 1202(to)X 1284(allocate)X 1554(space)X 1753(for)X 0 f 1895(*reg_table)X 1 f 2395(and)X 2531(initialize)X 2831(it)X 2895(properly.)X 3 f 9 s 576 4560(5.14.0.15)N 882(dwarf_get_fde_n\(\))X 0 f 10 s 576 4704(int)N 864(dwarf_get_fde_n\()X 960 4800(Dwarf_Fde)N 1440(*fde_data,)X 960 4896(Dwarf_Unsigned)N 1680(fde_index,)X 960 4992(Dwarf_Fde)N 1680(*returned_fde)X 960 5088(Dwarf_Error)N 1536(*error\))X 576 5232(dwarf_get_fde_n\(\))N 1 f 1454(returns)X 0 f 1767(DW_DLV_OK)X 1 f 2261(and)X 2439(sets)X 0 f 2649(returned_fde)X 1 f 3287(to)X 3411(the)X 0 f 3600(Dwarf_Fde)X 1 f 576 5328(descriptor)N 948(whose)X 1204(index)X 1433(is)X 0 f 1565(fde_index)X 1 f 2048(in)X 2161(the)X 2310(table)X 2517(of)X 0 f 2663(Dwarf_Fde)X 1 f 3146(descriptors)X 3549(pointed)X 3840(to)X 3952(by)X 0 f 576 5424(fde_data)N 1 f (.)S 1030(The)X 1185(index)X 1393(starts)X 1592(with)X 1764(0.)X 1874(Returns)X 0 f 2181(DW_DLV_NO_ENTRY)X 1 f 2931(if)X 3010(the)X 3139(index)X 3348(does)X 3526(not)X 3659(exist)X 3841(in)X 3934(the)X 576 5520(table)N 753(of)X 0 f 869(Dwarf_Fde)X 1 f 1322(descriptors.)X 1735(Returns)X 0 f 2033(DW_DLV_ERROR)X 1 f 2630(if)X 2700(there)X 2882(is)X 2956(an)X 3053(error.)X 3271(This)X 3434(function)X 3722(cannot)X 3956(be)X 576 5616(used)N 812(unless)X 1101(the)X 1289(block)X 1557(of)X 0 f 1742(Dwarf_Fde)X 1 f 2264(descriptors)X 2706(has)X 2903(been)X 3145(created)X 3468(by)X 3638(a)X 3764(call)X 3970(to)X 0 f 576 5712(dwarf_get_fde_list\(\))N 1 f (.)S 576 6183(rev)N 699(1.61,)X 879(3)X 939(Apr)X 1084(2006)X 2217(-)X 2264(56)X 2364(-)X 57 p %%Page: 57 57 0(Courier)xf 0 f 10 s 0 xH 0 xS 0 f 1 f 2217 384(-)N 2264(57)X 2364(-)X 3 f 9 s 576 768(5.14.0.16)N 882(dwarf_get_fde_at_pc\(\))X 0 f 10 s 576 912(int)N 864(dwarf_get_fde_at_pc\()X 960 1008(Dwarf_Fde)N 1440(*fde_data,)X 960 1104(Dwarf_Addr)N 1488(pc_of_interest,)X 960 1200(Dwarf_Fde)N 1440(*returned_fde,)X 960 1296(Dwarf_Addr)N 1488(*lopc,)X 960 1392(Dwarf_Addr)N 1488(*hipc,)X 960 1488(Dwarf_Error)N 1536(*error\))X 576 1632(dwarf_get_fde_at_pc\(\))N 1 f 1629(returns)X 0 f 1926(DW_DLV_OK)X 1 f 2404(and)X 2566(sets)X 0 f 2760(returned_fde)X 1 f 3382(to)X 3490(a)X 0 f 3600(Dwarf_Fde)X 1 f 576 1728(descriptor)N 918(for)X 1033(a)X 1090(function)X 1378(which)X 1594(contains)X 1881(the)X 1999(pc)X 2095(value)X 2289(specified)X 2599(by)X 0 f 2727(pc_of_interest)X 1 f (.)S 3459(In)X 3546(addition,)X 3848(it)X 3912(sets)X 576 1824(the)N 694(locations)X 1003(pointed)X 1263(to)X 1345(by)X 0 f 1473(lopc)X 1 f 1685(and)X 0 f 1849(hipc)X 1 f 2062(to)X 2145(the)X 2264(low)X 2405(address)X 2667(and)X 2804(the)X 2923(high)X 3086(address)X 3348(covered)X 3624(by)X 3725(this)X 3861(FDE,)X 576 1920(respectively.)N 1094(It)X 1233(returns)X 0 f 1574(DW_DLV_ERROR)X 1 f 2240(on)X 2410(error.)X 2696(It)X 2834(returns)X 0 f 3174(DW_DLV_NO_ENTRY)X 1 f 3983(if)X 0 f 576 2016(pc_of_interest)N 1 f 1283(is)X 1371(not)X 1508(in)X 1605(any)X 1756(of)X 1858(the)X 1992(FDEs)X 2210(represented)X 2617(by)X 2733(the)X 2867(block)X 3081(of)X 0 f 3212(Dwarf_Fde)X 1 f 3680(descriptors)X 576 2112(pointed)N 837(to)X 920(by)X 0 f 1049(fde_data)X 1 f (.)S 1494(This)X 1657(function)X 1945(cannot)X 2180(be)X 2277(used)X 2445(unless)X 2666(the)X 2785(block)X 2984(of)X 0 f 3100(Dwarf_Fde)X 1 f 3553(descriptors)X 3925(has)X 576 2208(been)N 748(created)X 1001(by)X 1101(a)X 1157(call)X 1293(to)X 0 f 1403(dwarf_get_fde_list\(\))X 1 f (.)S 3 f 9 s 576 2448(5.14.0.17)N 882(dwarf_expand_frame_instructions\(\))X 0 f 10 s 576 2592(int)N 768(dwarf_expand_frame_instructions\()X 960 2688(Dwarf_Debug)N 1536(dbg,)X 960 2784(Dwarf_Ptr)N 1440(instruction,)X 960 2880(Dwarf_Unsigned)N 1680(i_length,)X 960 2976(Dwarf_Frame_Op)N 1680(**returned_op_list,)X 960 3072(Dwarf_Signed)N 1680(*)X 1776(returned_op_count,)X 960 3168(Dwarf_Error)N 1536(*error\);)X 576 3312(dwarf_expand_frame_instructions\(\))N 1 f 2183(is)X 2259(a)X 2318(High-level)X 2684(interface)X 2989(function)X 3279(which)X 3498(expands)X 3784(a)X 3844(frame)X 576 3408(instruction)N 950(byte)X 1120(stream)X 1366(into)X 1521(an)X 1628(array)X 1825(of)X 0 f 1951(Dwarf_Frame_Op)X 1 f 2654(structures.)X 3037(To)X 3157(indicate)X 3442(success,)X 3734(it)X 3809(returns)X 0 f 576 3504(DW_DLV_OK)N 1 f (.)S 1072(The)X 1222(address)X 1488(where)X 1710(the)X 1833(byte)X 1996(stream)X 2235(begins)X 2469(is)X 2547(specified)X 2862(by)X 0 f 2995(instruction)X 1 f (,)S 3568(and)X 3709(the)X 3832(length)X 576 3600(of)N 668(the)X 790(byte)X 952(stream)X 1190(is)X 1267(specified)X 1581(by)X 0 f 1713(i_length)X 1 f (.)S 2161(The)X 2310(location)X 2592(pointed)X 2856(to)X 2942(by)X 0 f 3074(returned_op_list)X 1 f 3866(is)X 3943(set)X 576 3696(to)N 663(point)X 852(to)X 939(a)X 1000(table)X 1181(of)X 0 f 1301(returned_op_count)X 1 f 2142(pointers)X 2425(to)X 0 f 2540(Dwarf_Frame_Op)X 1 f 3237(which)X 3458(contain)X 3720(the)X 3844(frame)X 576 3792(instructions)N 1027(in)X 1167(the)X 1343(byte)X 1558(stream.)X 1889(It)X 2015(returns)X 0 f 2343(DW_DLV_ERROR)X 1 f 2996(on)X 3153(error.)X 3427(It)X 3553(never)X 3809(returns)X 0 f 576 3888(DW_DLV_NO_ENTRY)N 1 f (.)S 1392(After)X 1618(a)X 1710(successful)X 2096(return,)X 2364(the)X 2518(array)X 2740(of)X 2864(structures)X 3233(should)X 3503(be)X 3636(freed)X 3859(using)X 0 f 576 3984(dwarf_dealloc\(\))N 1 f 1329(with)X 1504(the)X 1635(allocation)X 1984(type)X 0 f 2183(DW_DLA_FRAME_BLOCK)X 1 f 3080(\(when)X 3314(they)X 3485(are)X 3616(no)X 3728(longer)X 3965(of)X 576 4080(interest\).)N 0 f 736 4320(Dwarf_Signed)N 1360(cnt;)X 736 4416(Dwarf_Frame_Op)N 1456(*frameops;)X 736 4512(Dwarf_Ptr)N 1216(instruction;)X 736 4608(Dwarf_Unsigned)N 1456(len;)X 736 4704(int)N 928(res;)X 736 4896(res)N 928(=)X 1024(expand_frame_instructions\(dbg,instruction,len,)X 3280(&frameops,&cnt,)X 4048(&error\);)X 736 4992(if)N 880(\(res)X 1120(==)X 1264(DW_DLV_OK\))X 1792({)X 1120 5184(for)N 1312(\(i)X 1456(=)X 1552(0;)X 1696(i)X 1792(<)X 1888(cnt;)X 2128(++i\))X 2368({)X 1504 5280(/*)N 1648(use)X 1840(frameops[i])X 2416(*/)X 1120 5376(})N 1120 5472(dwarf_dealloc\(dbg,)N 2032(frameops,)X 2512(DW_DLA_FRAME_BLOCK\);)X 736 5568(})N 3 f 9 s 576 5712(5.14.0.18)N 882(dwarf_get_fde_exception_info\(\))X 1 f 10 s 576 6183(rev)N 699(1.61,)X 879(3)X 939(Apr)X 1084(2006)X 2217(-)X 2264(57)X 2364(-)X 58 p %%Page: 58 58 0(Courier)xf 0 f 10 s 0 xH 0 xS 0 f 1 f 2217 384(-)N 2264(58)X 2364(-)X 0 f 576 768(int)N 768(dwarf_get_fde_exception_info\()X 768 864(Dwarf_Fde)N 1248(fde,)X 768 960(Dwarf_Signed)N 1392(*)X 1488(offset_into_exception_tables,)X 768 1056(Dwarf_Error)N 1344(*)X 1440(error\);)X 576 1200(dwarf_get_fde_exception_info\(\))N 1 f 2040(is)X 2117(an)X 2217(IRIX)X 2406(specific)X 2680(function)X 2971(which)X 3191(returns)X 3438(an)X 3539(exception)X 3876(table)X 576 1296(signed)N 890(offset)X 1177(thru)X 0 f 1438(offset_into_exception_tables)X 1 f (.)S 2926(The)X 3155(function)X 3526(never)X 3809(returns)X 0 f 576 1392(DW_DLV_NO_ENTRY)N 1 f (.)S 1367(If)X 0 f 1480(DW_DLV_NO_ENTRY)X 1 f 2231(is)X 2315(NULL)X 2561(the)X 2691(function)X 2990(returns)X 0 f 3273(DW_DLV_ERROR)X 1 f (.)S 3921(For)X 576 1488(non-IRIX)N 919(objects)X 1177(the)X 1306(offset)X 1520(returned)X 1819(will)X 1974(always)X 2228(be)X 2335(zero.)X 2545(For)X 2687(non-C++)X 3008(objects)X 3266(the)X 3395(offset)X 3609(returned)X 3908(will)X 576 1584(always)N 826(be)X 929(zero.)X 1135(The)X 1287(meaning)X 1590(of)X 1684(the)X 1809(offset)X 2019(and)X 2162(the)X 2287(content)X 2550(of)X 2644(the)X 2769(tables)X 2983(is)X 3064(not)X 3194(defined)X 3463(in)X 3553(this)X 3696(document.)X 576 1680(The)N 721(applicable)X 1071(CIE)X 1220(augmentation)X 1676(string)X 1878(\(see)X 2028(above\))X 2267(determines)X 2639(whether)X 2918(the)X 3036(value)X 3230(returned)X 3518(has)X 3645(meaning.)X 3 f 11 s 576 1920(5.15)N 774(Location)X 1129(Expression)X 1567(Evaluation)X 1 f 10 s 576 2160(An)N 699("interpreter")X 1125(which)X 1346(evaluates)X 1670(a)X 1731(location)X 2014(expression)X 2383(is)X 2462(required)X 2756(in)X 2844(any)X 2986(debugger.)X 3351(There)X 3565(is)X 3644(no)X 3750(interface)X 576 2256(defined)N 837(here)X 996(at)X 1074(this)X 1209(time.)X 576 2496(One)N 744(problem)X 1045(with)X 1221(defining)X 1522(an)X 1632(interface)X 1948(is)X 2035(that)X 2189(operations)X 2557(are)X 2690(machine)X 2996(dependent:)X 3382(they)X 3554(depend)X 3820(on)X 3934(the)X 576 2592(interpretation)N 1029(of)X 1117(register)X 1379(numbers)X 1676(and)X 1813(the)X 1932(methods)X 2224(of)X 2312(getting)X 2554(values)X 2779(from)X 2955(the)X 3073(environment)X 3498(the)X 3616(expression)X 3979(is)X 576 2688(applied)N 832(to.)X 576 2928(It)N 645(would)X 865(be)X 961(desirable)X 1271(to)X 1353(specify)X 1605(an)X 1701(interface.)X 3 f 576 3168(5.15.1)N 816(Location)X 1138(List)X 1291(Internal-level)X 1774(Interface)X 9 s 576 3456(5.15.1.1)N 846(dwarf_get_loclist_entry\(\))X 0 f 10 s 576 3600(int)N 768(dwarf_get_loclist_entry\()X 960 3696(Dwarf_Debug)N 1536(dbg,)X 960 3792(Dwarf_Unsigned)N 1680(offset,)X 960 3888(Dwarf_Addr)N 1488(*hipc_offset,)X 960 3984(Dwarf_Addr)N 1488(*lopc_offset,)X 960 4080(Dwarf_Ptr)N 1440(*data,)X 960 4176(Dwarf_Unsigned)N 1680(*entry_len,)X 960 4272(Dwarf_Unsigned)N 1680(*next_entry,)X 960 4368(Dwarf_Error)N 1536(*error\))X 576 4512(dwarf_dwarf_get_loclist_entry\(\))N 1 f 2285(returns)X 0 f 2757(DW_DLV_OK)X 1 f 3411(if)X 3682(successful.)X 0 f 576 4608(DW_DLV_NO_ENTRY)N 1 f 1325(is)X 1407(returned)X 1704(when)X 1907(the)X 2034(offset)X 2246(passed)X 2489(in)X 2580(is)X 2662(beyond)X 2927(the)X 3054(end)X 3199(of)X 3295(the)X 3422(.debug_loc)X 3805(section)X 576 4704(\(expected)N 918(if)X 996(you)X 1145(start)X 1312(at)X 1399(offset)X 1611(zero)X 1779(and)X 1924(proceed)X 2208(thru)X 2366(all)X 2475(the)X 2602(entries\).)X 0 f 2968(DW_DLV_ERROR)X 1 f 3573(is)X 3655(returned)X 3952(on)X 576 4800(error.)N 805(The)X 962(function)X 1261(reads)X 1463(a)X 1531(location)X 1821(list)X 1950(entry)X 2147(starting)X 2419(at)X 0 f 2537(offset)X 1 f 2857(and)X 3005(returns)X 3260(through)X 3541(pointers)X 3831(\(when)X 576 4896(successful\))N 963(the)X 1091(high)X 1263(pc)X 0 f 1397(hipc_offset)X 1 f (,)S 1975(low)X 2126(pc)X 0 f 2261(lopc_offset)X 1 f (,)S 2840(a)X 2907(pointer)X 3165(to)X 3258(the)X 3387(location)X 3676(description)X 576 4992(data)N 0 f 766(data)X 1 f (,)S 1005(the)X 1130(length)X 1357(of)X 1451(the)X 1576(location)X 1861(description)X 2244(data)X 0 f 2433(entry_len)X 1 f (,)S 2912(and)X 3055(the)X 3180(offset)X 3390(of)X 3484(the)X 3609(next)X 3774(location)X 576 5088(description)N 952(entry)X 0 f 1165(next_entry)X 1 f (.)S 576 5232(The)N 0 f 758(hipc_offset)X 1 f (,)S 1335(low)X 1484(pc)X 0 f 1617(lopc_offset)X 1 f 2174(are)X 2302(offsets)X 2545(from)X 2730(the)X 2857(beginning)X 3207(of)X 3304(the)X 3432(current)X 3690(procedure,)X 576 5328(not)N 698(genuine)X 972(pc)X 1068(values.)X 3 f 11 s 576 5568(5.16)N 774(Abbreviations)X 1329(access)X 1 f 10 s 576 5712(These)N 788(are)X 907(Internal-level)X 1360(Interface)X 1667(functions.)X 2025(Debuggers)X 2393(can)X 2525(ignore)X 2750(this.)X 576 6183(rev)N 699(1.61,)X 879(3)X 939(Apr)X 1084(2006)X 2217(-)X 2264(58)X 2364(-)X 59 p %%Page: 59 59 0(Courier)xf 0 f 10 s 0 xH 0 xS 0 f 1 f 2217 384(-)N 2264(59)X 2364(-)X 3 f 576 768(5.16.1)N 816(dwarf_get_abbrev\(\))X 0 f 576 912(int)N 768(dwarf_get_abbrev\()X 960 1008(Dwarf_Debug)N 1536(dbg,)X 960 1104(Dwarf_Unsigned)N 1680(offset,)X 960 1200(Dwarf_Abbrev)N 1680(*returned_abbrev,)X 960 1296(Dwarf_Unsigned)N 1680(*length,)X 960 1392(Dwarf_Unsigned)N 1680(*attr_count,)X 960 1488(Dwarf_Error)N 1536(*error\))X 1 f 576 1632(The)N 750(function)X 0 f 1094(dwarf_get_abbrev\(\))X 1 f 2007(returns)X 0 f 2307(DW_DLV_OK)X 1 f 2788(and)X 2954(sets)X 0 f 3152(*returned_abbrev)X 1 f 3970(to)X 0 f 576 1728(Dwarf_Abbrev)N 1 f 1191(descriptor)X 1551(for)X 1684(an)X 1798(abbreviation)X 2237(at)X 2333(offset)X 0 f 2582(*offset)X 1 f 2956(in)X 3056(the)X 3192(abbreviations)X 3662(section)X 3927(\(i.e)X 576 1824(.debug_abbrev\))N 1108(on)X 1219(success.)X 1531(The)X 1687(user)X 1852(is)X 1936(responsible)X 2332(for)X 2457(making)X 2728(sure)X 2893(that)X 3044(a)X 3111(valid)X 3302(abbreviation)X 3734(begins)X 3974(at)X 0 f 576 1920(offset)N 1 f 888(in)X 974(the)X 1096(abbreviations)X 1552(section.)X 1843(The)X 1992(location)X 2274(pointed)X 2538(to)X 2624(by)X 0 f 2756(length)X 1 f 3068(is)X 3145(set)X 3258(to)X 3344(the)X 3465(length)X 3688(in)X 3773(bytes)X 3965(of)X 576 2016(the)N 708(abbreviation)X 1143(in)X 1240(the)X 1373(abbreviations)X 1840(section.)X 2142(The)X 2302(location)X 2595(pointed)X 2870(to)X 2967(by)X 0 f 3110(attr_count)X 1 f 3625(is)X 3713(set)X 3837(to)X 3934(the)X 576 2112(number)N 846(of)X 938(attributes)X 1261(in)X 1348(the)X 1471(abbreviation.)X 1937(An)X 2060(abbreviation)X 2486(entry)X 2676(with)X 2843(a)X 2904(length)X 3128(of)X 3219(1)X 3283(is)X 3360(the)X 3482(0)X 3546(byte)X 3708(of)X 3799(the)X 3921(last)X 576 2208(abbreviation)N 1000(entry)X 1188(of)X 1278(a)X 1338(compilation)X 1744(unit.)X 0 f 1988(dwarf_get_abbrev\(\))X 1 f 2876(returns)X 0 f 3151(DW_DLV_ERROR)X 1 f 3751(on)X 3855(error.)X 576 2304(If)N 684(the)X 836(call)X 1006(succeeds,)X 1366(the)X 1518(storage)X 1804(pointed)X 2098(to)X 2214(by)X 0 f 2376(*returned_abbrev)X 1 f 3198(should)X 3464(be)X 3593(free'd,)X 3859(using)X 0 f 576 2400(dwarf_dealloc\(\))N 1 f 1316(with)X 1478(the)X 1596(allocation)X 1932(type)X 0 f 2118(DW_DLA_ABBREV)X 1 f 2762(when)X 2956(no)X 3056(longer)X 3281(needed.)X 3 f 576 2736(5.16.2)N 816(dwarf_get_abbrev_tag\(\))X 0 f 576 2880(int)N 768(dwarf_get_abbrev_tag\()X 960 2976(Dwarf_abbrev)N 1584(abbrev,)X 960 3072(Dwarf_Half)N 1536(*return_tag,)X 960 3168(Dwarf_Error)N 1536(*error\);)X 1 f 576 3312(If)N 653(successful,)X 0 f 1054(dwarf_get_abbrev_tag\(\))X 1 f 2133(returns)X 0 f 2407(DW_DLV_OK)X 1 f 2862(and)X 3001(sets)X 0 f 3172(*return_tag)X 1 f 3723(to)X 3808(the)X 2 f 3930(tag)X 1 f 576 3408(of)N 663(the)X 781(given)X 979(abbreviation.)X 1440(It)X 1509(returns)X 0 f 1780(DW_DLV_ERROR)X 1 f 2376(on)X 2476(error.)X 2693(It)X 2762(never)X 2961(returns)X 0 f 3232(DW_DLV_NO_ENTRY)X 1 f (.)S 3 f 576 3648(5.16.3)N 816(dwarf_get_abbrev_code\(\))X 0 f 576 3792(int)N 768(dwarf_get_abbrev_code\()X 960 3888(Dwarf_abbrev)N 1776(abbrev,)X 960 3984(Dwarf_Unsigned)N 1728(*return_code,)X 960 4080(Dwarf_Error)N 1728(*error\);)X 1 f 576 4224(If)N 656(successful,)X 0 f 1060(dwarf_get_abbrev_code\(\))X 1 f 2190(returns)X 0 f 2467(DW_DLV_OK)X 1 f 2925(and)X 3067(sets)X 0 f 3242(*return_code)X 1 f 3845(to)X 3934(the)X 576 4320(abbreviation)N 1017(code)X 1209(of)X 1316(the)X 1454(given)X 1672(abbreviation.)X 2153(It)X 2242(returns)X 0 f 2533(DW_DLV_ERROR)X 1 f 3148(on)X 3267(error.)X 3503(It)X 3591(never)X 3809(returns)X 0 f 576 4416(DW_DLV_NO_ENTRY)N 1 f (.)S 3 f 576 4656(5.16.4)N 816(dwarf_get_abbrev_children_flag\(\))X 0 f 576 4800(int)N 768(dwarf_get_abbrev_children_flag\()X 960 4896(Dwarf_Abbrev)N 1584(abbrev,)X 960 4992(Dwarf_Signed)N 1632(*returned_flag,)X 960 5088(Dwarf_Error)N 1536(*error\))X 1 f 576 5232(The)N 797(function)X 0 f 1189(dwarf_get_abbrev_children_flag\(\))X 1 f 2822(returns)X 0 f 3170(DW_DLV_OK)X 1 f 3699(and)X 3912(sets)X 0 f 576 5328(returned_flag)N 1 f 1243(to)X 0 f 1376(DW_children_no)X 1 f 2091(\(if)X 2210(the)X 2351(given)X 2572(abbreviation)X 3016(indicates)X 3344(that)X 3507(a)X 3586(die)X 3727(with)X 3912(that)X 576 5424(abbreviation)N 1000(has)X 1130(no)X 1233(children\))X 1546(or)X 0 f 1664(DW_children_yes)X 1 f 2407(\(if)X 2506(the)X 2628(given)X 2830(abbreviation)X 3255(indicates)X 3564(that)X 3708(a)X 3768(die)X 3890(with)X 576 5520(that)N 716(abbreviation)X 1137(has)X 1264(a)X 1320(child\).)X 1567(It)X 1636(returns)X 0 f 1907(DW_DLV_ERROR)X 1 f 2503(on)X 2603(error.)X 576 6183(rev)N 699(1.61,)X 879(3)X 939(Apr)X 1084(2006)X 2217(-)X 2264(59)X 2364(-)X 60 p %%Page: 60 60 0(Courier)xf 0 f 10 s 0 xH 0 xS 0 f 1 f 2217 384(-)N 2264(60)X 2364(-)X 3 f 576 768(5.16.5)N 816 0.1359(dwarf_get_abbrev_entry\(\))AX 0 f 576 912(int)N 768(dwarf_get_abbrev_entry\()X 960 1008(Dwarf_Abbrev)N 1584(abbrev,)X 960 1104(Dwarf_Signed)N 1584(index,)X 960 1200(Dwarf_Half)N 1584(*attr_num,)X 960 1296(Dwarf_Signed)N 1584(*form,)X 960 1392(Dwarf_Off)N 1440(*offset,)X 960 1488(Dwarf_Error)N 1536(*error\))X 1 f 576 1728(If)N 667(successful,)X 0 f 1082(dwarf_get_abbrev_entry\(\))X 1 f 2271(returns)X 0 f 2559(DW_DLV_OK)X 1 f 3028(and)X 3181(sets)X 0 f 3366(*attr_num)X 1 f 3835(to)X 3934(the)X 576 1824(attribute)N 872(code)X 1052(of)X 1147(the)X 1273(attribute)X 1568(whose)X 1801(index)X 2007(is)X 2088(specified)X 2406(by)X 0 f 2542(index)X 1 f 2810(in)X 2900(the)X 3026(given)X 3232(abbreviation.)X 3701(The)X 3854(index)X 576 1920(starts)N 767(at)X 847(0.)X 949(The)X 1096(location)X 1376(pointed)X 1638(to)X 1722(by)X 0 f 1852(form)X 1 f 2066(is)X 2141(set)X 2252(to)X 2336(the)X 2456(form)X 2634(of)X 2724(the)X 2845(attribute.)X 3175(The)X 3323(location)X 3604(pointed)X 3867(to)X 3952(by)X 0 f 576 2016(offset)N 1 f 930(is)X 1049(set)X 1204(to)X 1332(the)X 1496(byte)X 1700(offset)X 1949(of)X 2081(the)X 2244(attribute)X 2576(in)X 2703(the)X 2866(abbreviations)X 3363(section.)X 3695(It)X 3809(returns)X 0 f 576 2112(DW_DLV_NO_ENTRY)N 1 f 1316(if)X 1385(the)X 1503(index)X 1701(specified)X 2011(is)X 2084(outside)X 2335(the)X 2453(range)X 2652(of)X 2739(attributes)X 3058(in)X 3141(this)X 3277(abbreviation.)X 3739(It)X 3809(returns)X 0 f 576 2208(DW_DLV_ERROR)N 1 f 1172(on)X 1272(error.)X 3 f 11 s 576 2448(5.17)N 774(String)X 1031(Section)X 1327(Operations)X 1 f 10 s 576 2592(The)N 738(.debug_str)X 1111(section)X 1376(contains)X 1681(only)X 1861(strings.)X 2152(Debuggers)X 2538(need)X 2728(never)X 2945(use)X 3090(this)X 3243(interface:)X 3585(it)X 3667(is)X 3758(only)X 3938(for)X 576 2688(debugging)N 934(problems)X 1252(with)X 1414(the)X 1532(string)X 1734(section)X 1981(itself.)X 3 f 576 2928(5.17.1)N 816(dwarf_get_str\(\))X 0 f 576 3072(int)N 768(dwarf_get_str\()X 960 3168(Dwarf_Debug)N 1632(dbg,)X 960 3264(Dwarf_Off)N 1632(offset,)X 960 3360(char)N 1536(**string,)X 960 3456(Dwarf_Signed)N 1584(*returned_str_len,)X 960 3552(Dwarf_Error)N 1584(*error\))X 1 f 576 3696(The)N 744(function)X 0 f 1082(dwarf_get_str\(\))X 1 f 1845(returns)X 0 f 2140(DW_DLV_OK)X 1 f 2616(and)X 2776(sets)X 0 f 2968(*returned_str_len)X 1 f 3828(to)X 3934(the)X 576 3792(length)N 800(of)X 891(the)X 1013(string,)X 1238(not)X 1363(counting)X 1666(the)X 1787(null)X 1934(terminator,)X 2311(that)X 2454(begins)X 2686(at)X 2767(the)X 2888(offset)X 3094(specified)X 3407(by)X 0 f 3538(offset)X 1 f 3849(in)X 3934(the)X 576 3888(.debug_str)N 933(section.)X 1221(The)X 1367(location)X 1646(pointed)X 1907(to)X 1990(by)X 0 f 2119(string)X 1 f 2428(is)X 2502(set)X 2612(to)X 2695(a)X 2752(pointer)X 3000(to)X 3083(this)X 3219(string.)X 3462(The)X 3608(next)X 3767(string)X 3970(in)X 576 3984(the)N 705(.debug_str)X 1072(section)X 1330(begins)X 1570(at)X 1659(the)X 1788(previous)X 0 f 2123(offset)X 1 f 2442(+)X 2518(1)X 2589(+)X 0 f 2692(*returned_str_len)X 1 f (.)S 3578(A)X 3666(zero-length)X 576 4080(string)N 782(is)X 859(NOT)X 1048(the)X 1170(end)X 1310(of)X 1401(the)X 1523(section.)X 1814(If)X 1892(there)X 2077(is)X 2155(no)X 2260(.debug_str)X 2621(section,)X 0 f 2921(DW_DLV_NO_ENTRY)X 1 f 3666(is)X 3744(returned.)X 576 4176(If)N 654(there)X 839(is)X 916(an)X 1016(error,)X 0 f 1245(DW_DLV_ERROR)X 1 f 1845(is)X 1922(returned.)X 2254(If)X 2332(we)X 2450(are)X 2572(at)X 2653(the)X 2774(end)X 2913(of)X 3003(the)X 3124(section)X 3374(\(that)X 3544(is,)X 0 f 3668(offset)X 1 f 3979(is)X 576 4272(one)N 712(past)X 861(the)X 979(end)X 1115(of)X 1202(the)X 1320(section\))X 0 f 1622(DW_DLV_NO_ENTRY)X 1 f 2362(is)X 2435(returned.)X 2763(If)X 2837(the)X 0 f 2983(offset)X 1 f 3292(is)X 3366(some)X 3556(other)X 3742(too-large)X 576 4368(value)N 770(then)X 0 f 956(DW_DLV_ERROR)X 1 f 1552(is)X 1625(returned.)X 3 f 11 s 576 4608(5.18)N 774(Address)X 1103(Range)X 1364(Operations)X 1 f 10 s 576 4752(These)N 791(functions)X 1112(provide)X 1380(information)X 1781(about)X 1982(address)X 2246(ranges.)X 2519(Address)X 2805(ranges)X 3038(map)X 3199(ranges)X 3432(of)X 3522(pc)X 3621(values)X 3849(to)X 3934(the)X 576 4848(corresponding)N 1055(compilation-unit)X 1608(die)X 1726(that)X 1866(covers)X 2096(the)X 2214(address)X 2475(range.)X 3 f 576 5088(5.18.1)N 816(dwarf_get_aranges\(\))X 0 f 576 5232(int)N 768(dwarf_get_aranges\()X 960 5328(Dwarf_Debug)N 1536(dbg,)X 960 5424(Dwarf_Arange)N 1584(**aranges,)X 960 5520(Dwarf_Signed)N 1584(*)X 1680(returned_arange_count,)X 960 5616(Dwarf_Error)N 1536(*error\))X 1 f 576 5760(The)N 901(function)X 0 f 1397(dwarf_get_aranges\(\))X 1 f 2510(returns)X 0 f 2962(DW_DLV_OK)X 1 f 3595(and)X 3912(sets)X 0 f 576 5856(*returned_arange_count)N 1 f 1672(to)X 1774(the)X 1912(count)X 2130(of)X 2236(the)X 2373(number)X 2657(of)X 2763(address)X 3043(ranges)X 3292(in)X 3393(the)X 3530(.debug_aranges)X 576 5952(section.)N 873(It)X 953(sets)X 0 f 1132(*aranges)X 1 f 1547(to)X 1640(point)X 1835(to)X 1928(a)X 1995(block)X 2204(of)X 0 f 2330(Dwarf_Arange)X 1 f 2937(descriptors,)X 3340(one)X 3487(for)X 3612(each)X 3791(address)X 576 6183(rev)N 699(1.61,)X 879(3)X 939(Apr)X 1084(2006)X 2217(-)X 2264(60)X 2364(-)X 61 p %%Page: 61 61 0(Courier)xf 0 f 10 s 0 xH 0 xS 0 f 1 f 2217 384(-)N 2264(61)X 2364(-)X 576 768(range.)N 856(It)X 965(returns)X 0 f 1276(DW_DLV_ERROR)X 1 f 1912(on)X 2052(error.)X 2309(It)X 2418(returns)X 0 f 2729(DW_DLV_NO_ENTRY)X 1 f 3509(if)X 3618(there)X 3839(is)X 3952(no)X 576 864(.debug_aranges)N 1098(section.)X 0 f 736 1104(Dwarf_Signed)N 1360(cnt;)X 736 1200(Dwarf_Arange)N 1360(*arang;)X 736 1296(int)N 928(res;)X 736 1488(res)N 928(=)X 1024(dwarf_get_aranges\(dbg,)X 2128(&arang,&cnt,)X 2752(&error\);)X 736 1584(if)N 880(\(res)X 1120(==)X 1264(DW_DLV_OK\))X 1792({)X 1120 1776(for)N 1312(\(i)X 1456(=)X 1552(0;)X 1696(i)X 1792(<)X 1888(cnt;)X 2128(++i\))X 2368({)X 1504 1872(/*)N 1648(use)X 1840(arang[i])X 2272(*/)X 1504 1968(dwarf_dealloc\(dbg,)N 2416(arang[i],)X 2896(DW_DLA_ARANGE\);)X 1120 2064(})N 1120 2160(dwarf_dealloc\(dbg,)N 2032(arang,)X 2368(DW_DLA_LIST\);)X 736 2256(})N 576 2640(int)N 768(dwarf_get_arange\()X 960 2736(Dwarf_Arange)N 1584(*aranges,)X 960 2832(Dwarf_Unsigned)N 1680(arange_count,)X 960 2928(Dwarf_Addr)N 1488(address,)X 960 3024(Dwarf_Arange)N 1584(*returned_arange,)X 960 3120(Dwarf_Error)N 1536(*error\);)X 1 f 576 3264(The)N 723(function)X 0 f 1040(dwarf_get_arange\(\))X 1 f 1926(takes)X 2113(as)X 2202(input)X 2388(a)X 2446(pointer)X 2695(to)X 2779(a)X 2837(block)X 3037(of)X 0 f 3155(Dwarf_Arange)X 1 f 3754(pointers,)X 576 3360(and)N 720(a)X 784(count)X 990(of)X 1085(the)X 1211(number)X 1483(of)X 1577(descriptors)X 1956(in)X 2045(the)X 2170(block.)X 2415(It)X 2491(then)X 2656(searches)X 2956(for)X 3077(the)X 3202(descriptor)X 3550(that)X 3697(covers)X 3934(the)X 576 3456(given)N 0 f 825(address)X 1 f (.)S 1244(If)X 1341(it)X 1428(finds)X 1631(one,)X 1810(it)X 1897(returns)X 0 f 2191(DW_DLV_OK)X 1 f 2666(and)X 2825(sets)X 0 f 3016(*returned_arange)X 1 f 3828(to)X 3934(the)X 576 3552(descriptor.)N 986(It)X 1084(returns)X 0 f 1384(DW_DLV_ERROR)X 1 f 2008(on)X 2136(error.)X 2381(It)X 2478(returns)X 0 f 2777(DW_DLV_NO_ENTRY)X 1 f 3545(if)X 3642(there)X 3851(is)X 3952(no)X 576 3648(.debug_aranges)N 1098(entry)X 1283(covering)X 1584(that)X 1724(address.)X 3 f 576 3984(5.18.2)N 816 0.1458(dwarf_get_cu_die_offset\(\))AX 0 f 576 4128(int)N 768(dwarf_get_cu_die_offset\()X 960 4224(Dwarf_Arange)N 1584(arange,)X 960 4320(Dwarf_Off)N 1536(*returned_cu_die_offset,)X 960 4416(Dwarf_Error)N 1536(*error\);)X 1 f 576 4560(The)N 730(function)X 0 f 1054(dwarf_get_cu_die_offset\(\))X 1 f 2283(takes)X 2477(a)X 0 f 2570(Dwarf_Arange)X 1 f 3175(descriptor)X 3526(as)X 3623(input,)X 3837(and)X 3983(if)X 576 4656(successful)N 964(returns)X 0 f 1273(DW_DLV_OK)X 1 f 1762(and)X 1935(sets)X 0 f 2140(*returned_cu_die_offset)X 1 f 3301(to)X 3420(the)X 3575(offset)X 3815(in)X 3934(the)X 576 4752(.debug_info)N 985(section)X 1236(of)X 1327(the)X 1449(compilation-unit)X 2006(DIE)X 2164(for)X 2283(the)X 2406(compilation-unit)X 2964(represented)X 3360(by)X 3465(the)X 3588(given)X 3791(address)X 576 4848(range.)N 815(It)X 884(returns)X 0 f 1155(DW_DLV_ERROR)X 1 f 1751(on)X 1851(error.)X 3 f 576 5088(5.18.3)N 816 0.1397(dwarf_get_arange_cu_header_offset\(\))AX 0 f 576 5232(int)N 768(dwarf_get_arange_cu_header_offset\()X 960 5328(Dwarf_Arange)N 1584(arange,)X 960 5424(Dwarf_Off)N 1536(*returned_cu_header_offset,)X 960 5520(Dwarf_Error)N 1536(*error\))X 1 f 576 5664(The)N 724(function)X 0 f 1042(dwarf_get_arange_cu_header_offset\(\))X 1 f 2745(takes)X 2933(a)X 0 f 3020(Dwarf_Arange)X 1 f 3620(descriptor)X 3965(as)X 576 5760(input,)N 782(and)X 920(if)X 991(successful)X 1343(returns)X 0 f 1616(DW_DLV_OK)X 1 f 2070(and)X 2208(sets)X 0 f 2378(*returned_cu_header_offset)X 1 f 3647(to)X 3730(the)X 3849(offset)X 576 5856(in)N 660(the)X 780(.debug_info)X 1187(section)X 1437(of)X 1527(the)X 1648(compilation-unit)X 2204(header)X 2442(for)X 2559(the)X 2680(compilation-unit)X 3236(represented)X 3630(by)X 3733(the)X 3854(given)X 576 5952(address)N 837(range.)X 1076(It)X 1145(returns)X 0 f 1416(DW_DLV_ERROR)X 1 f 2012(on)X 2112(error.)X 576 6183(rev)N 699(1.61,)X 879(3)X 939(Apr)X 1084(2006)X 2217(-)X 2264(61)X 2364(-)X 62 p %%Page: 62 62 0(Courier)xf 0 f 10 s 0 xH 0 xS 0 f 1 f 2217 384(-)N 2264(62)X 2364(-)X 576 768(This)N 738(function)X 1025(added)X 1237(Rev)X 1386(1.45,)X 1566(June,)X 1753(2001.)X 576 960(This)N 740(function)X 1029(is)X 1104(declared)X 1399(as)X 1488('optional')X 1826(in)X 1910(libdwarf.h)X 2265(on)X 2368(IRIX)X 2556(systems)X 2832(so)X 2926(the)X 3047(_MIPS_SYMBOL_PRESENT)X 576 1056(predicate)N 893(may)X 1053(be)X 1151(used)X 1320(at)X 1400(run)X 1529(time)X 1693(to)X 1777(determine)X 2120(if)X 2191(the)X 2311(version)X 2568(of)X 2656(libdwarf)X 2949(linked)X 3170(into)X 3315(an)X 3412(application)X 3789(has)X 3917(this)X 576 1152(function.)N 3 f 576 1584(5.18.4)N 816(dwarf_get_arange_info\(\))X 0 f 576 1728(int)N 768(dwarf_get_arange_info\()X 960 1824(Dwarf_Arange)N 1584(arange,)X 960 1920(Dwarf_Addr)N 1488(*start,)X 960 2016(Dwarf_Unsigned)N 1680(*length,)X 960 2112(Dwarf_Off)N 1440(*cu_die_offset,)X 960 2208(Dwarf_Error)N 1536(*error\))X 1 f 576 2352(The)N 725(function)X 0 f 1044(dwarf_get_arange_info\(\))X 1 f 2172(returns)X 0 f 2447(DW_DLV_OK)X 1 f 2903(and)X 3043(stores)X 3255(the)X 3378(starting)X 3643(value)X 3842(of)X 3934(the)X 576 2448(address)N 840(range)X 1042(in)X 1127(the)X 1248(location)X 1529(pointed)X 1792(to)X 1877(by)X 0 f 2008(start)X 1 f (,)S 2291(the)X 2412(length)X 2635(of)X 2724(the)X 2844(address)X 3107(range)X 3308(in)X 3392(the)X 3512(location)X 3792(pointed)X 576 2544(to)N 661(by)X 0 f 792(length)X 1 f (,)S 1123(and)X 1262(the)X 1383(offset)X 1589(in)X 1674(the)X 1795(.debug_info)X 2204(section)X 2455(of)X 2546(the)X 2668(compilation-unit)X 3225(DIE)X 3383(for)X 3501(the)X 3623(compilation-)X 576 2640(unit)N 720(represented)X 1111(by)X 1211(the)X 1329(address)X 1590(range.)X 1829(It)X 1898(returns)X 0 f 2169(DW_DLV_ERROR)X 1 f 2765(on)X 2865(error.)X 3 f 11 s 576 2880(5.19)N 774(General)X 1100(Low)X 1288(Level)X 1516(Operations)X 1 f 10 s 576 3024(This)N 738(function)X 1025(is)X 1098(low-level)X 1421(and)X 1557(intended)X 1853(for)X 1967(use)X 2094(only)X 2256(by)X 2356(programs)X 2679(such)X 2846(as)X 2933(dwarf-dumpers.)X 3 f 576 3264(5.19.1)N 816(dwarf_get_address_size\(\))X 0 f 576 3408(int)N 768(dwarf_get_address_size\(Dwarf_Debug)X 2448(dbg,)X 960 3504(Dwarf_Half)N 1536(*addr_size,)X 960 3600(Dwarf_Error)N 1536(*error\))X 1 f 576 3744(The)N 761(function)X 0 f 1116(dwarf_get_address_size\(\))X 1 f 2328(returns)X 0 f 2640(DW_DLV_OK)X 1 f 3133(on)X 3274(success)X 3576(and)X 3753(sets)X 3934(the)X 0 f 576 3840(*addr_size)N 1 f 1083(to)X 1172(the)X 1297(size)X 1449(in)X 1538(bytes)X 1734(of)X 1828(an)X 1931(address.)X 2239(In)X 2333(case)X 2498(of)X 2591(error,)X 2794(it)X 2864(returns)X 0 f 3141(DW_DLV_ERROR)X 1 f 3743(and)X 3885(does)X 576 3936(not)N 698(set)X 0 f 835(*addr_size)X 1 f (.)S 3 f 11 s 576 4272(5.20)N 774(Utility)X 1036(Operations)X 1 f 10 s 576 4416(These)N 792(functions)X 1114(aid)X 1236(in)X 1322(the)X 1444(management)X 1878(of)X 1969(errors)X 2181(encountered)X 2598(when)X 2796(using)X 2993(functions)X 3315(in)X 3401(the)X 2 f 3523(libdwarf)X 1 f 3818(library)X 576 4512(and)N 712(releasing)X 1022(memory)X 1309(allocated)X 1619(as)X 1706(a)X 1762(result)X 1960(of)X 2047(a)X 2 f 2103(libdwarf)X 1 f 2393(operation.)X 3 f 576 4752(5.20.1)N 816(dwarf_errno\(\))X 0 f 576 4896(Dwarf_Unsigned)N 1296(dwarf_errno\()X 960 4992(Dwarf_Error)N 1536(error\))X 1 f 576 5136(The)N 746(function)X 0 f 1086(dwarf_errno\(\))X 1 f 1755(returns)X 2023(the)X 2166(error)X 2368(number)X 2658(corresponding)X 3162(to)X 3269(the)X 3413(error)X 3616(specified)X 3952(by)X 0 f 576 5232(error)N 1 f (.)S 3 f 576 5472(5.20.2)N 816 0.2404(dwarf_errmsg\(\))AX 0 f 576 5616(const)N 864(char*)X 1152(dwarf_errmsg\()X 960 5712(Dwarf_Error)N 1536(error\))X 1 f 576 5856(The)N 762(function)X 0 f 1118(dwarf_errmsg\(\))X 1 f 1851(returns)X 2135(a)X 2232(pointer)X 2520(to)X 2643(a)X 2741(null-terminated)X 3297(error)X 3516(message)X 3850(string)X 576 5952(corresponding)N 1061(to)X 1149(the)X 1273(error)X 1456(specified)X 1772(by)X 0 f 1906(error)X 1 f (.)S 2212(The)X 2362(string)X 2569(returned)X 2862(by)X 0 f 2995(dwarf_errmsg\(\))X 1 f 3692(should)X 3930(not)X 576 6183(rev)N 699(1.61,)X 879(3)X 939(Apr)X 1084(2006)X 2217(-)X 2264(62)X 2364(-)X 63 p %%Page: 63 63 0(Courier)xf 0 f 10 s 0 xH 0 xS 0 f 1 f 2217 384(-)N 2264(63)X 2364(-)X 576 768(be)N 672(deallocated)X 1058(using)X 0 f 1279(dwarf_dealloc\(\))X 1 f (.)S 576 1008(The)N 723(set)X 834(of)X 923(errors)X 1133(enumerated)X 1530(in)X 1614(Figure)X 1845(3)X 1908(below)X 2127(were)X 2307(defined)X 2571(in)X 2656(Dwarf)X 2885(1.)X 2988(These)X 3203(errors)X 3414(are)X 3536(not)X 3661(used)X 3831(by)X 3934(the)X 576 1104(current)N 824(implementation)X 1346(of)X 1433(Dwarf)X 1659(2.)X 0 f 10 f 606 1168 -0.0476(iiiiiiiiiiiiiiiiiiiiiiiiiiiiiiiiiiiiiiiiiiiiiiiiiiiiiiiiiiiiiiiiiiiiiiiiiiiiiiiiiiiii)AN 3 f 646 1264(SYMBOLIC)N 1101(NAME)X 1466(DESCRIPTION)X 10 f 606 1280 -0.0476(iiiiiiiiiiiiiiiiiiiiiiiiiiiiiiiiiiiiiiiiiiiiiiiiiiiiiiiiiiiiiiiiiiiiiiiiiiiiiiiiiiiii)AN 3 f 646 1376(DW_DLE_NE)N 1466(No)X 1584(error)X 1788(\(0\))X 646 1472(DW_DLE_VMM)N 1466(Version)X 1753(of)X 1840(DWARF)X 2163(information)X 2592(newer)X 2822(than)X 2997(libdwarf)X 646 1568(DW_DLE_MAP)N 1466(Memory)X 1781(map)X 1952(failure)X 646 1664(DW_DLE_LEE)N 1466(Propagation)X 1908(of)X 1995(libelf)X 2188(error)X 646 1760(DW_DLE_NDS)N 1466(No)X 1584(debug)X 1812(section)X 646 1856(DW_DLE_NLS)N 1466(No)X 1584(line)X 1728(section)X 646 1952(DW_DLE_ID)N 1466(Requested)X 1842(information)X 2271(not)X 2402(associated)X 2769(with)X 2940(descriptor)X 646 2048(DW_DLE_IOF)N 1466(I/O)X 1601(failure)X 646 2144(DW_DLE_MAF)N 1466(Memory)X 1781(allocation)X 2134(failure)X 646 2240(DW_DLE_IA)N 1466(Invalid)X 1729(argument)X 646 2336(DW_DLE_MDE)N 1466(Mangled)X 1788(debugging)X 2162(entry)X 646 2432(DW_DLE_MLE)N 1466(Mangled)X 1788(line)X 1932(number)X 2223(entry)X 646 2528(DW_DLE_FNO)N 1466(File)X 1615(descriptor)X 1987(does)X 2158(not)X 2289(refer)X 2480(to)X 2567(an)X 2671(open)X 2855(file)X 646 2624(DW_DLE_FNR)N 1466(File)X 1615(is)X 1688(not)X 1819(a)X 1879(regular)X 2153(file)X 646 2720(DW_DLE_FWA)N 1466(File)X 1615(is)X 1688(opened)X 1952(with)X 2123(wrong)X 2361(access)X 646 2816(DW_DLE_NOB)N 1466(File)X 1615(is)X 1688(not)X 1819(an)X 1923(object)X 2153(file)X 646 2912(DW_DLE_MOF)N 1466(Mangled)X 1788(object)X 2018(file)X 2145(header)X 646 3008(DW_DLE_EOLL)N 1466(End)X 1627(of)X 1714(location)X 2005(list)X 2127(entries)X 646 3104(DW_DLE_NOLL)N 1466(No)X 1584(location)X 1875(list)X 1997(section)X 646 3200(DW_DLE_BADOFF)N 1466(Invalid)X 1729(offset)X 646 3296(DW_DLE_EOS)N 1466(End)X 1627(of)X 1714(section)X 646 3392(DW_DLE_ATRUNC)N 1466(Abbreviations)X 1970(section)X 2226(appears)X 2517(truncated)X 646 3488(DW_DLE_BADBITC)N 1466(Address)X 1766(size)X 1911(passed)X 2157(to)X 2244(dwarf)X 2469(bad)X 10 f 606 3504 -0.0476(iiiiiiiiiiiiiiiiiiiiiiiiiiiiiiiiiiiiiiiiiiiiiiiiiiiiiiiiiiiiiiiiiiiiiiiiiiiiiiiiiiiii)AN 606(c)X 3488(c)Y 3408(c)Y 3328(c)Y 3248(c)Y 3168(c)Y 3088(c)Y 3008(c)Y 2928(c)Y 2848(c)Y 2768(c)Y 2688(c)Y 2608(c)Y 2528(c)Y 2448(c)Y 2368(c)Y 2288(c)Y 2208(c)Y 2128(c)Y 2048(c)Y 1968(c)Y 1888(c)Y 1808(c)Y 1728(c)Y 1648(c)Y 1568(c)Y 1488(c)Y 1408(c)Y 1328(c)Y 1248(c)Y 4002 3504(c)N 3488(c)Y 3408(c)Y 3328(c)Y 3248(c)Y 3168(c)Y 3088(c)Y 3008(c)Y 2928(c)Y 2848(c)Y 2768(c)Y 2688(c)Y 2608(c)Y 2528(c)Y 2448(c)Y 2368(c)Y 2288(c)Y 2208(c)Y 2128(c)Y 2048(c)Y 1968(c)Y 1888(c)Y 1808(c)Y 1728(c)Y 1648(c)Y 1568(c)Y 1488(c)Y 1408(c)Y 1328(c)Y 1248(c)Y 3 f 1676 3600(Figure)N 1923(6.)X 2023(List)X 2176(of)X 2263(Dwarf)X 2502(Error)X 2723(Codes)X 1 f 576 3840(The)N 734(set)X 856(of)X 956(errors)X 1178(returned)X 1480(by)X 1594(SGI)X 0 f 1785(Libdwarf)X 1 f 2203(functions)X 2535(is)X 2622(listed)X 2829(below.)X 3099(Some)X 3315(of)X 3416(the)X 3548(errors)X 3770(are)X 3903(SGI)X 576 3936(specific.)N 576 6183(rev)N 699(1.61,)X 879(3)X 939(Apr)X 1084(2006)X 2217(-)X 2264(63)X 2364(-)X 64 p %%Page: 64 64 0(Courier)xf 0 f 10 s 0 xH 0 xS 0 f 1 f 2217 384(-)N 2264(64)X 2364(-)X 3 f 10 f 576 688(i)N 586(iiiiiiiiiiiiiiiiiiiiiiiiiiiiiiiiiiiiiiiiiiiiiiiiiiiiiiiiiiiiiiiiiiiiiiiiiiiiiiiiiiiiiiiii)X 3 f 616 784(SYMBOLIC)N 1071(NAME)X 2402(DESCRIPTION)X 10 f 576 800(i)N 586(iiiiiiiiiiiiiiiiiiiiiiiiiiiiiiiiiiiiiiiiiiiiiiiiiiiiiiiiiiiiiiiiiiiiiiiiiiiiiiiiiiiiiiiii)X 3 f 616 896(DW_DLE_DBG_ALLOC)N 2402(Could)X 2630(not)X 2761(allocate)X 3044(Dwarf_Debug)X 3545(struct)X 616 992(DW_DLE_FSTAT_ERROR)N 2402(Error)X 2623(in)X 2709(fstat\(\)-ing)X 3068(object)X 616 1088(DW_DLE_FSTAT_MODE_ERROR)N 2402(Error)X 2623(in)X 2709(mode)X 2916(of)X 3003(object)X 3233(file)X 616 1184(DW_DLE_INIT_ACCESS_WRONG)N 2402(Incorrect)X 2744(access)X 2974(to)X 3061(dwarf_init\(\))X 616 1280(DW_DLE_ELF_BEGIN_ERROR)N 2402(Error)X 2623(in)X 2709(elf_begin\(\))X 3094(on)X 3198(object)X 616 1376(DW_DLE_ELF_GETEHDR_ERROR)N 2402(Error)X 2623(in)X 2709(elf_getehdr\(\))X 3171(on)X 3275(object)X 616 1472(DW_DLE_ELF_GETSHDR_ERROR)N 2402(Error)X 2623(in)X 2709(elf_getshdr\(\))X 3166(on)X 3270(object)X 616 1568(DW_DLE_ELF_STRPTR_ERROR)N 2402(Error)X 2623(in)X 2709(elf_strptr\(\))X 3109(on)X 3213(object)X 616 1664(DW_DLE_DEBUG_INFO_DUPLICATE)N 2402(Multiple)X 2715(.debug_info)X 3136(sections)X 616 1760(DW_DLE_DEBUG_INFO_NULL)N 2402(No)X 2520(data)X 2691(in)X 2777(.debug_info)X 3198(section)X 616 1856(DW_DLE_DEBUG_ABBREV_DUPLICATE)N 2402(Multiple)X 2715(.debug_abbrev)X 3243(sections)X 616 1952(DW_DLE_DEBUG_ABBREV_NULL)N 2402(No)X 2520(data)X 2691(in)X 2777(.debug_abbrev)X 3305(section)X 616 2048(DW_DLE_DEBUG_ARANGES_DUPLICATE)N 2402(Multiple)X 2715(.debug_arange)X 3239(sections)X 616 2144(DW_DLE_DEBUG_ARANGES_NULL)N 2402(No)X 2520(data)X 2691(in)X 2777(.debug_arange)X 3301(section)X 616 2240(DW_DLE_DEBUG_LINE_DUPLICATE)N 2402(Multiple)X 2715(.debug_line)X 3127(sections)X 616 2336(DW_DLE_DEBUG_LINE_NULL)N 2402(No)X 2520(data)X 2691(in)X 2777(.debug_line)X 3189(section)X 616 2432(DW_DLE_DEBUG_LOC_DUPLICATE)N 2402(Multiple)X 2715(.debug_loc)X 3101(sections)X 616 2528(DW_DLE_DEBUG_LOC_NULL)N 2402(No)X 2520(data)X 2691(in)X 2777(.debug_loc)X 3163(section)X 616 2624(DW_DLE_DEBUG_MACINFO_DUPLICATE)N 2402(Multiple)X 2715(.debug_macinfo)X 3279(sections)X 616 2720(DW_DLE_DEBUG_MACINFO_NULL)N 2402(No)X 2520(data)X 2691(in)X 2777(.debug_macinfo)X 3341(section)X 616 2816(DW_DLE_DEBUG_PUBNAMES_DUPLICATE)N 2402(Multiple)X 2715(.debug_pubnames)X 3353(sections)X 616 2912(DW_DLE_DEBUG_PUBNAMES_NULL)N 2402(No)X 2520(data)X 2691(in)X 2777(.debug_pubnames)X 3415(section)X 616 3008(DW_DLE_DEBUG_STR_DUPLICATE)N 2402(Multiple)X 2715(.debug_str)X 3097(sections)X 616 3104(DW_DLE_DEBUG_STR_NULL)N 2402(No)X 2520(data)X 2691(in)X 2777(.debug_str)X 3159(section)X 616 3200(DW_DLE_CU_LENGTH_ERROR)N 2402(Length)X 2666(of)X 2753(compilation-unit)X 3341(bad)X 616 3296(DW_DLE_VERSION_STAMP_ERROR)N 2402(Incorrect)X 2744(Version)X 3031(Stamp)X 616 3392(DW_DLE_ABBREV_OFFSET_ERROR)N 2402(Offset)X 2632(in)X 2718(.debug_abbrev)X 3246(bad)X 616 3488(DW_DLE_ADDRESS_SIZE_ERROR)N 2402(Size)X 2560(of)X 2647(addresses)X 2996(in)X 3082(target)X 3308(bad)X 616 3584(DW_DLE_DEBUG_INFO_PTR_NULL)N 2402(Pointer)X 2676(into)X 2829(.debug_info)X 3250(in)X 3336(DIE)X 3498(null)X 616 3680(DW_DLE_DIE_NULL)N 2402(Null)X 2568(Dwarf_Die)X 616 3776(DW_DLE_STRING_OFFSET_BAD)N 2402(Offset)X 2632(in)X 2718(.debug_str)X 3100(bad)X 616 3872(DW_DLE_DEBUG_LINE_LENGTH_BAD)N 2402(Length)X 2666(of)X 2753(.debug_line)X 3165(segment)X 3466(bad)X 616 3968(DW_DLE_LINE_PROLOG_LENGTH_BAD)N 2402(Length)X 2666(of)X 2753(.debug_line)X 3165(prolog)X 3407(bad)X 616 4064(DW_DLE_LINE_NUM_OPERANDS_BAD)N 2402(Number)X 2707(of)X 2794(operands)X 3129(to)X 3216(line)X 3360(instr)X 3540(bad)X 616 4160(DW_DLE_LINE_SET_ADDR_ERROR)N 2402(Error)X 2623(in)X 2709(DW_LNE_set_address)X 3507(instruction)X 616 4256(DW_DLE_LINE_EXT_OPCODE_BAD)N 2402(Error)X 2623(in)X 2709(DW_EXTENDED_OPCODE)X 3733(instruction)X 616 4352(DW_DLE_DWARF_LINE_NULL)N 2402(Null)X 2568(Dwarf_line)X 2971(argument)X 616 4448(DW_DLE_INCL_DIR_NUM_BAD)N 2402(Error)X 2623(in)X 2709(included)X 3021(directory)X 3358(for)X 3481(given)X 3683(line)X 616 4544(DW_DLE_LINE_FILE_NUM_BAD)N 2402(File)X 2551(number)X 2842(in)X 2928(.debug_line)X 3340(bad)X 616 4640(DW_DLE_ALLOC_FAIL)N 2402(Failed)X 2635(to)X 2722(allocate)X 3005(required)X 3323(structs)X 616 4736(DW_DLE_DBG_NULL)N 2402(Null)X 2568(Dwarf_Debug)X 3069(argument)X 616 4832(DW_DLE_DEBUG_FRAME_LENGTH_BAD)N 2402(Error)X 2623(in)X 2709(length)X 2942(of)X 3029(frame)X 616 4928(DW_DLE_FRAME_VERSION_BAD)N 2402(Bad)X 2559(version)X 2828(stamp)X 3057(for)X 3180(frame)X 616 5024(DW_DLE_CIE_RET_ADDR_REG_ERROR)N 2402(Bad)X 2559(register)X 2843(specified)X 3161(for)X 3284(return)X 3527(address)X 616 5120(DW_DLE_FDE_NULL)N 2402(Null)X 2568(Dwarf_Fde)X 2976(argument)X 616 5216(DW_DLE_FDE_DBG_NULL)N 2402(No)X 2520(Dwarf_Debug)X 3021(associated)X 3388(with)X 3559(FDE)X 616 5312(DW_DLE_CIE_NULL)N 2402(Null)X 2568(Dwarf_Cie)X 2963(argument)X 616 5408(DW_DLE_CIE_DBG_NULL)N 2402(No)X 2520(Dwarf_Debug)X 3021(associated)X 3388(with)X 3559(CIE)X 616 5504(DW_DLE_FRAME_TABLE_COL_BAD)N 2402(Bad)X 2559(column)X 2832(in)X 2918(frame)X 3144(table)X 3333(specified)X 10 f 576 5520(i)N 586(iiiiiiiiiiiiiiiiiiiiiiiiiiiiiiiiiiiiiiiiiiiiiiiiiiiiiiiiiiiiiiiiiiiiiiiiiiiiiiiiiiiiiiiii)X 576(c)X 5488(c)Y 5408(c)Y 5328(c)Y 5248(c)Y 5168(c)Y 5088(c)Y 5008(c)Y 4928(c)Y 4848(c)Y 4768(c)Y 4688(c)Y 4608(c)Y 4528(c)Y 4448(c)Y 4368(c)Y 4288(c)Y 4208(c)Y 4128(c)Y 4048(c)Y 3968(c)Y 3888(c)Y 3808(c)Y 3728(c)Y 3648(c)Y 3568(c)Y 3488(c)Y 3408(c)Y 3328(c)Y 3248(c)Y 3168(c)Y 3088(c)Y 3008(c)Y 2928(c)Y 2848(c)Y 2768(c)Y 2688(c)Y 2608(c)Y 2528(c)Y 2448(c)Y 2368(c)Y 2288(c)Y 2208(c)Y 2128(c)Y 2048(c)Y 1968(c)Y 1888(c)Y 1808(c)Y 1728(c)Y 1648(c)Y 1568(c)Y 1488(c)Y 1408(c)Y 1328(c)Y 1248(c)Y 1168(c)Y 1088(c)Y 1008(c)Y 928(c)Y 848(c)Y 768(c)Y 4146 5520(c)N 5488(c)Y 5408(c)Y 5328(c)Y 5248(c)Y 5168(c)Y 5088(c)Y 5008(c)Y 4928(c)Y 4848(c)Y 4768(c)Y 4688(c)Y 4608(c)Y 4528(c)Y 4448(c)Y 4368(c)Y 4288(c)Y 4208(c)Y 4128(c)Y 4048(c)Y 3968(c)Y 3888(c)Y 3808(c)Y 3728(c)Y 3648(c)Y 3568(c)Y 3488(c)Y 3408(c)Y 3328(c)Y 3248(c)Y 3168(c)Y 3088(c)Y 3008(c)Y 2928(c)Y 2848(c)Y 2768(c)Y 2688(c)Y 2608(c)Y 2528(c)Y 2448(c)Y 2368(c)Y 2288(c)Y 2208(c)Y 2128(c)Y 2048(c)Y 1968(c)Y 1888(c)Y 1808(c)Y 1728(c)Y 1648(c)Y 1568(c)Y 1488(c)Y 1408(c)Y 1328(c)Y 1248(c)Y 1168(c)Y 1088(c)Y 1008(c)Y 928(c)Y 848(c)Y 768(c)Y 3 f 1440 5616(Figure)N 1687(7.)X 1787(List)X 1940(of)X 2027(Dwarf)X 2266(2)X 2326(Error)X 2547(Codes)X 2776(\(continued\))X 1 f 576 6183(rev)N 699(1.61,)X 879(3)X 939(Apr)X 1084(2006)X 2217(-)X 2264(64)X 2364(-)X 65 p %%Page: 65 65 0(Courier)xf 0 f 10 s 0 xH 0 xS 0 f 1 f 2217 384(-)N 2264(65)X 2364(-)X 3 f 10 f 576 688(i)N 608(iiiiiiiiiiiiiiiiiiiiiiiiiiiiiiiiiiiiiiiiiiiiiiiiiiiiiiiiiiiiiiiiiiiiiiiiiiiiiiiiiiiiiiiiiii)X 3 f 616 784(SYMBOLIC)N 1071(NAME)X 2465(DESCRIPTION)X 10 f 576 800(i)N 608(iiiiiiiiiiiiiiiiiiiiiiiiiiiiiiiiiiiiiiiiiiiiiiiiiiiiiiiiiiiiiiiiiiiiiiiiiiiiiiiiiiiiiiiiiii)X 3 f 616 896(DW_DLE_PC_NOT_IN_FDE_RANGE)N 2465(PC)X 2592(requested)X 2946(not)X 3077(in)X 3163(address)X 3445(range)X 3661(of)X 3748(FDE)X 616 992(DW_DLE_CIE_INSTR_EXEC_ERROR)N 2465(Error)X 2686(in)X 2772(executing)X 3117(instructions)X 3541(in)X 3627(CIE)X 616 1088(DW_DLE_FRAME_INSTR_EXEC_ERROR)N 2465(Error)X 2686(in)X 2772(executing)X 3117(instructions)X 3541(in)X 3627(FDE)X 616 1184(DW_DLE_FDE_PTR_NULL)N 2465(Null)X 2631(Pointer)X 2905(to)X 2992(Dwarf_Fde)X 3400(specified)X 616 1280(DW_DLE_RET_OP_LIST_NULL)N 2465(No)X 2583(location)X 2874(to)X 2961(store)X 3151(pointer)X 3420(to)X 3507(Dwarf_Frame_Op)X 616 1376(DW_DLE_LINE_CONTEXT_NULL)N 2465(Dwarf_Line)X 2899(has)X 3034(no)X 3138(context)X 616 1472(DW_DLE_DBG_NO_CU_CONTEXT)N 2465(dbg)X 2613(has)X 2748(no)X 2852(CU)X 2988(context)X 3258(for)X 3381(dwarf_siblingof\(\))X 616 1568(DW_DLE_DIE_NO_CU_CONTEXT)N 2465(Dwarf_Die)X 2860(has)X 2995(no)X 3099(CU)X 3235(context)X 616 1664(DW_DLE_FIRST_DIE_NOT_CU)N 2465(First)X 2650(DIE)X 2812(in)X 2898(CU)X 3034(not)X 3165(DW_TAG_compilation_unit)X 616 1760(DW_DLE_NEXT_DIE_PTR_NULL)N 2465(Error)X 2686(in)X 2772(moving)X 3045(to)X 3132(next)X 3299(DIE)X 3461(in)X 3547(.debug_info)X 616 1856(DW_DLE_DEBUG_FRAME_DUPLICATE)N 2465(Multiple)X 2778(.debug_frame)X 3272(sections)X 616 1952(DW_DLE_DEBUG_FRAME_NULL)N 2465(No)X 2583(data)X 2754(in)X 2840(.debug_frame)X 3334(section)X 616 2048(DW_DLE_ABBREV_DECODE_ERROR)N 2465(Error)X 2686(in)X 2772(decoding)X 3098(abbreviation)X 616 2144(DW_DLE_DWARF_ABBREV_NULL)N 2465(Null)X 2631(Dwarf_Abbrev)X 3168(specified)X 616 2240(DW_DLE_ATTR_NULL)N 2465(Null)X 2631(Dwarf_Attribute)X 3231(specified)X 616 2336(DW_DLE_DIE_BAD)N 2465(DIE)X 2627(bad)X 616 2432(DW_DLE_DIE_ABBREV_BAD)N 2465(No)X 2583(abbreviation)X 3038(found)X 3257(for)X 3380(code)X 3556(in)X 3642(DIE)X 616 2528(DW_DLE_ATTR_FORM_BAD)N 2465(Inappropriate)X 2969(attribute)X 3292(form)X 3482(for)X 3605(attribute)X 616 2624(DW_DLE_ATTR_NO_CU_CONTEXT)N 2465(No)X 2583(CU)X 2719(context)X 2989(for)X 3112(Dwarf_Attribute)X 3712(struct)X 616 2720(DW_DLE_ATTR_FORM_SIZE_BAD)N 2465(Size)X 2623(of)X 2710(block)X 2916(in)X 3002(attribute)X 3325(value)X 3527(bad)X 616 2816(DW_DLE_ATTR_DBG_NULL)N 2465(No)X 2583(Dwarf_Debug)X 3084(for)X 3207(Dwarf_Attribute)X 3807(struct)X 616 2912(DW_DLE_BAD_REF_FORM)N 2465(Inappropriate)X 2969(form)X 3159(for)X 3282 0.4219(reference)AX 3625(attribute)X 616 3008(DW_DLE_ATTR_FORM_OFFSET_BAD)N 2465(Offset)X 2695 0.4219(reference)AX 3038(attribute)X 3361(outside)X 3625(current)X 3904(CU)X 616 3104(DW_DLE_LINE_OFFSET_BAD)N 2465(Offset)X 2695(of)X 2782(lines)X 2957(for)X 3080(current)X 3359(CU)X 3495(outside)X 3759(.debug_line)X 616 3200(DW_DLE_DEBUG_STR_OFFSET_BAD)N 2465(Offset)X 2695(into)X 2848(.debug_str)X 3230(past)X 3392(its)X 3492(end)X 616 3296(DW_DLE_STRING_PTR_NULL)N 2465(Pointer)X 2739(to)X 2826(pointer)X 3095(into)X 3248(.debug_str)X 3630(NULL)X 616 3392(DW_DLE_PUBNAMES_VERSION_ERROR)N 2465(Version)X 2752(stamp)X 2981(of)X 3068(pubnames)X 3438(incorrect)X 616 3488(DW_DLE_PUBNAMES_LENGTH_BAD)N 2465(Read)X 2663(pubnames)X 3033(past)X 3195(end)X 3339(of)X 3426(.debug_pubnames)X 616 3584(DW_DLE_GLOBAL_NULL)N 2465(Null)X 2631(Dwarf_Global)X 3140(specified)X 616 3680(DW_DLE_GLOBAL_CONTEXT_NULL)N 2465(No)X 2583(context)X 2853(for)X 2976(Dwarf_Global)X 3485(given)X 616 3776(DW_DLE_DIR_INDEX_BAD)N 2465(Error)X 2686(in)X 2772(directory)X 3109(index)X 3315(read)X 616 3872(DW_DLE_LOC_EXPR_BAD)N 2465(Bad)X 2622(operator)X 2941(read)X 3117(for)X 3240(location)X 3531(expression)X 616 3968(DW_DLE_DIE_LOC_EXPR_BAD)N 2465(Expected)X 2801(block)X 3007(value)X 3209(for)X 3332(attribute)X 3655(not)X 3786(found)X 616 4064(DW_DLE_OFFSET_BAD)N 2465(Offset)X 2695(for)X 2818(next)X 2985(compilation-unit)X 3573(in)X 3659(.debug_info)X 4080(bad)X 616 4160(DW_DLE_MAKE_CU_CONTEXT_FAIL)N 2465(Could)X 2693(not)X 2824(make)X 3031(CU)X 3167(context)X 616 4256(DW_DLE_ARANGE_OFFSET_BAD)N 2465(Offset)X 2695(into)X 2848(.debug_info)X 3269(in)X 3355(.debug_aranges)X 3910(bad)X 616 4352(DW_DLE_SEGMENT_SIZE_BAD)N 2465(Segment)X 2779(size)X 2924(should)X 3169(be)X 3269(0)X 3329(for)X 3452(MIPS)X 3672(processors)X 616 4448(DW_DLE_ARANGE_LENGTH_BAD)N 2465(Length)X 2729(of)X 2816(arange)X 3072(section)X 3328(in)X 3414(.debug_arange)X 3938(bad)X 616 4544(DW_DLE_ARANGE_DECODE_ERROR)N 2465(Aranges)X 2770(do)X 2874(not)X 3005(end)X 3149(at)X 3236(end)X 3380(of)X 3467(.debug_aranges)X 616 4640(DW_DLE_ARANGES_NULL)N 2465(NULL)X 2707(pointer)X 2976(to)X 3063(Dwarf_Arange)X 3596(specified)X 616 4736(DW_DLE_ARANGE_NULL)N 2465(NULL)X 2707(Dwarf_Arange)X 3240(specified)X 616 4832(DW_DLE_NO_FILE_NAME)N 2465(No)X 2583(file)X 2710(name)X 2917(for)X 3040(Dwarf_Line)X 3474(struct)X 616 4928(DW_DLE_NO_COMP_DIR)N 2465(No)X 2583(Compilation)X 3029(directory)X 3366(for)X 3489(compilation-unit)X 616 5024(DW_DLE_CU_ADDRESS_SIZE_BAD)N 2465(CU)X 2601(header)X 2857(address)X 3139(size)X 3284(not)X 3415(match)X 3649(Elf)X 3771(class)X 616 5120(DW_DLE_ELF_GETIDENT_ERROR)N 2465(Error)X 2686(in)X 2772(elf_getident\(\))X 3247(on)X 3351(object)X 616 5216(DW_DLE_NO_AT_MIPS_FDE)N 2465(DIE)X 2627(does)X 2798(not)X 2929(have)X 3109(DW_AT_MIPS_fde)X 3805(attribute)X 616 5312(DW_DLE_NO_CIE_FOR_FDE)N 2465(No)X 2583(CIE)X 2745(specified)X 3063(for)X 3186(FDE)X 616 5408(DW_DLE_DIE_ABBREV_LIST_NULL)N 2465(No)X 2583(abbreviation)X 3038(for)X 3161(the)X 3288(code)X 3464(in)X 3550(DIE)X 3712(found)X 616 5504(DW_DLE_DEBUG_FUNCNAMES_DUPLICATE)N 2465(Multiple)X 2778(.debug_funcnames)X 3435(sections)X 616 5600(DW_DLE_DEBUG_FUNCNAMES_NULL)N 2465(No)X 2583(data)X 2754(in)X 2840(.debug_funcnames)X 3497(section)X 10 f 576 5616(i)N 608(iiiiiiiiiiiiiiiiiiiiiiiiiiiiiiiiiiiiiiiiiiiiiiiiiiiiiiiiiiiiiiiiiiiiiiiiiiiiiiiiiiiiiiiiiii)X 576(c)X 5568(c)Y 5488(c)Y 5408(c)Y 5328(c)Y 5248(c)Y 5168(c)Y 5088(c)Y 5008(c)Y 4928(c)Y 4848(c)Y 4768(c)Y 4688(c)Y 4608(c)Y 4528(c)Y 4448(c)Y 4368(c)Y 4288(c)Y 4208(c)Y 4128(c)Y 4048(c)Y 3968(c)Y 3888(c)Y 3808(c)Y 3728(c)Y 3648(c)Y 3568(c)Y 3488(c)Y 3408(c)Y 3328(c)Y 3248(c)Y 3168(c)Y 3088(c)Y 3008(c)Y 2928(c)Y 2848(c)Y 2768(c)Y 2688(c)Y 2608(c)Y 2528(c)Y 2448(c)Y 2368(c)Y 2288(c)Y 2208(c)Y 2128(c)Y 2048(c)Y 1968(c)Y 1888(c)Y 1808(c)Y 1728(c)Y 1648(c)Y 1568(c)Y 1488(c)Y 1408(c)Y 1328(c)Y 1248(c)Y 1168(c)Y 1088(c)Y 1008(c)Y 928(c)Y 848(c)Y 768(c)Y 4248 5616(c)N 5568(c)Y 5488(c)Y 5408(c)Y 5328(c)Y 5248(c)Y 5168(c)Y 5088(c)Y 5008(c)Y 4928(c)Y 4848(c)Y 4768(c)Y 4688(c)Y 4608(c)Y 4528(c)Y 4448(c)Y 4368(c)Y 4288(c)Y 4208(c)Y 4128(c)Y 4048(c)Y 3968(c)Y 3888(c)Y 3808(c)Y 3728(c)Y 3648(c)Y 3568(c)Y 3488(c)Y 3408(c)Y 3328(c)Y 3248(c)Y 3168(c)Y 3088(c)Y 3008(c)Y 2928(c)Y 2848(c)Y 2768(c)Y 2688(c)Y 2608(c)Y 2528(c)Y 2448(c)Y 2368(c)Y 2288(c)Y 2208(c)Y 2128(c)Y 2048(c)Y 1968(c)Y 1888(c)Y 1808(c)Y 1728(c)Y 1648(c)Y 1568(c)Y 1488(c)Y 1408(c)Y 1328(c)Y 1248(c)Y 1168(c)Y 1088(c)Y 1008(c)Y 928(c)Y 848(c)Y 768(c)Y 3 f 1440 5712(Figure)N 1687(8.)X 1787(List)X 1940(of)X 2027(Dwarf)X 2266(2)X 2326(Error)X 2547(Codes)X 2776(\(continued\))X 1 f 576 6183(rev)N 699(1.61,)X 879(3)X 939(Apr)X 1084(2006)X 2217(-)X 2264(65)X 2364(-)X 66 p %%Page: 66 66 0(Courier)xf 0 f 10 s 0 xH 0 xS 0 f 1 f 2217 384(-)N 2264(66)X 2364(-)X 3 f 10 f 576 688(i)N 577(iiiiiiiiiiiiiiiiiiiiiiiiiiiiiiiiiiiiiiiiiiiiiiiiiiiiiiiiiiiiiiiiiiiiiiiiiiiiiiiiiiiiiiiiiiii)X 3 f 616 784(SYMBOLIC)N 1071(NAME)X 2717(DESCRIPTION)X 10 f 576 800(i)N 577(iiiiiiiiiiiiiiiiiiiiiiiiiiiiiiiiiiiiiiiiiiiiiiiiiiiiiiiiiiiiiiiiiiiiiiiiiiiiiiiiiiiiiiiiiiii)X 3 f 616 896(DW_DLE_DEBUG_FUNCNAMES_VERSION_ERROR)N 2717(Version)X 3004(stamp)X 3233(in)X 3319(.debug_funcnames)X 3976(bad)X 616 992(DW_DLE_DEBUG_FUNCNAMES_LENGTH_BAD)N 2717(Length)X 2981(error)X 3185(in)X 3271(reading)X 3553(.debug_funcnames)X 616 1088(DW_DLE_FUNC_NULL)N 2717(NULL)X 2959(Dwarf_Func)X 3411(specified)X 616 1184(DW_DLE_FUNC_CONTEXT_NULL)N 2717(No)X 2835(context)X 3105(for)X 3228(Dwarf_Func)X 3680(struct)X 616 1280(DW_DLE_DEBUG_TYPENAMES_DUPLICATE)N 2717(Multiple)X 3030(.debug_typenames)X 3683(sections)X 616 1376(DW_DLE_DEBUG_TYPENAMES_NULL)N 2717(No)X 2835(data)X 3006(in)X 3092(.debug_typenames)X 3745(section)X 616 1472(DW_DLE_DEBUG_TYPENAMES_VERSION_ERROR)N 2717(Version)X 3004(stamp)X 3233(in)X 3319(.debug_typenames)X 3972(bad)X 616 1568(DW_DLE_DEBUG_TYPENAMES_LENGTH_BAD)N 2717(Length)X 2981(error)X 3185(in)X 3271(reading)X 3553(.debug_typenames)X 616 1664(DW_DLE_TYPE_NULL)N 2717(NULL)X 2959(Dwarf_Type)X 3411(specified)X 616 1760(DW_DLE_TYPE_CONTEXT_NULL)N 2717(No)X 2835(context)X 3105(for)X 3228(Dwarf_Type)X 3680(given)X 616 1856(DW_DLE_DEBUG_VARNAMES_DUPLICATE)N 2717(Multiple)X 3030(.debug_varnames)X 3652(sections)X 616 1952(DW_DLE_DEBUG_VARNAMES_NULL)N 2717(No)X 2835(data)X 3006(in)X 3092(.debug_varnames)X 3714(section)X 616 2048(DW_DLE_DEBUG_VARNAMES_VERSION_ERROR)N 2717(Version)X 3004(stamp)X 3233(in)X 3319(.debug_varnames)X 3941(bad)X 616 2144(DW_DLE_DEBUG_VARNAMES_LENGTH_BAD)N 2717(Length)X 2981(error)X 3185(in)X 3271(reading)X 3553(.debug_varnames)X 616 2240(DW_DLE_VAR_NULL)N 2717(NULL)X 2959(Dwarf_Var)X 3372(specified)X 616 2336(DW_DLE_VAR_CONTEXT_NULL)N 2717(No)X 2835(context)X 3105(for)X 3228(Dwarf_Var)X 3641(given)X 616 2432(DW_DLE_DEBUG_WEAKNAMES_DUPLICATE)N 2717(Multiple)X 3030(.debug_weaknames)X 3714(section)X 616 2528(DW_DLE_DEBUG_WEAKNAMES_NULL)N 2717(No)X 2835(data)X 3006(in)X 3092(.debug_varnames)X 3714(section)X 616 2624(DW_DLE_DEBUG_WEAKNAMES_VERSION_ERROR)N 2717(Version)X 3004(stamp)X 3233(in)X 3319(.debug_varnames)X 3941(bad)X 616 2720(DW_DLE_DEBUG_WEAKNAMES_LENGTH_BAD)N 2717(Length)X 2981(error)X 3185(in)X 3271(reading)X 3553(.debug_weaknames)X 616 2816(DW_DLE_WEAK_NULL)N 2717(NULL)X 2959(Dwarf_Weak)X 3438(specified)X 616 2912(DW_DLE_WEAK_CONTEXT_NULL)N 2717(No)X 2835(context)X 3105(for)X 3228(Dwarf_Weak)X 3707(given)X 10 f 576 2928(i)N 577(iiiiiiiiiiiiiiiiiiiiiiiiiiiiiiiiiiiiiiiiiiiiiiiiiiiiiiiiiiiiiiiiiiiiiiiiiiiiiiiiiiiiiiiiiiii)X 576(c)X 2848(c)Y 2768(c)Y 2688(c)Y 2608(c)Y 2528(c)Y 2448(c)Y 2368(c)Y 2288(c)Y 2208(c)Y 2128(c)Y 2048(c)Y 1968(c)Y 1888(c)Y 1808(c)Y 1728(c)Y 1648(c)Y 1568(c)Y 1488(c)Y 1408(c)Y 1328(c)Y 1248(c)Y 1168(c)Y 1088(c)Y 1008(c)Y 928(c)Y 848(c)Y 768(c)Y 4257 2928(c)N 2848(c)Y 2768(c)Y 2688(c)Y 2608(c)Y 2528(c)Y 2448(c)Y 2368(c)Y 2288(c)Y 2208(c)Y 2128(c)Y 2048(c)Y 1968(c)Y 1888(c)Y 1808(c)Y 1728(c)Y 1648(c)Y 1568(c)Y 1488(c)Y 1408(c)Y 1328(c)Y 1248(c)Y 1168(c)Y 1088(c)Y 1008(c)Y 928(c)Y 848(c)Y 768(c)Y 3 f 1646 3024(Figure)N 1893(9.)X 1993(List)X 2146(of)X 2233(Dwarf)X 2472(2)X 2532(Error)X 2753(Codes)X 1 f 576 3264(This)N 738(list)X 855(of)X 943(errors)X 1152(is)X 1226(not)X 1349(necessarily)X 1727(complete;)X 2064(additional)X 2405(errors)X 2614(might)X 2821(be)X 2918(added)X 3131(when)X 3326(functionality)X 3756(to)X 3839(create)X 576 3360(debugging)N 950(information)X 1364(entries)X 1614(are)X 1749(added)X 1977(to)X 2 f 2075(libdwarf)X 1 f 2381(and)X 2533(by)X 2649(the)X 2783(implementors)X 3259(of)X 2 f 3362(libdwarf)X 1 f 3667(to)X 3764(describe)X 576 3456(internal)N 845(errors)X 1057(not)X 1184(addressed)X 1526(by)X 1631(the)X 1754(above)X 1971(list.)X 2133(Some)X 2340(of)X 2432(the)X 2555(above)X 2772(errors)X 2985(may)X 3148(be)X 3249(unused.)X 3541(Errors)X 3767(may)X 3930(not)X 576 3552(have)N 748(the)X 866(same)X 1051(meaning)X 1347(in)X 1429(different)X 1726(implementations.)X 3 f 576 3792(5.20.3)N 816(dwarf_seterrhand\(\))X 0 f 576 3936(Dwarf_Handler)N 1248(dwarf_seterrhand\()X 960 4032(Dwarf_Debug)N 1536(dbg,)X 960 4128(Dwarf_Handler)N 1632(errhand\))X 1 f 576 4272(The)N 757(function)X 0 f 1108(dwarf_seterrhand\(\))X 1 f 2028(replaces)X 2348(the)X 2503(error)X 2717(handler)X 3015(\(see)X 0 f 3230(dwarf_init\(\))X 1 f (\))S 3890(with)X 0 f 576 4368(errhand)N 1 f (.)S 972(The)X 1117(old)X 1239(error)X 1416(handler)X 1677(is)X 1750(returned.)X 2078(This)X 2240(function)X 2527(is)X 2600(currently)X 2910(unimplemented.)X 3 f 576 4608(5.20.4)N 816 0.2578(dwarf_seterrarg\(\))AX 0 f 576 4752(Dwarf_Ptr)N 1056(dwarf_seterrarg\()X 960 4848(Dwarf_Debug)N 1536(dbg,)X 960 4944(Dwarf_Ptr)N 1440(errarg\))X 1 f 576 5088(The)N 726(function)X 0 f 1046(dwarf_seterrarg\(\))X 1 f 1888(replaces)X 2178(the)X 2302(pointer)X 2555(to)X 2643(the)X 2767(error)X 2950(handler)X 3217(communication)X 3741(area)X 3902(\(see)X 0 f 576 5184(dwarf_init\(\))N 1 f (\))S 1219(with)X 0 f 1429(errarg)X 1 f (.)S 1797(A)X 1895(pointer)X 2162(to)X 2264(the)X 2402(old)X 2544(area)X 2719(is)X 2812(returned.)X 3160(This)X 3342(function)X 3649(is)X 3742(currently)X 576 5280(unimplemented.)N 3 f 576 5520(5.20.5)N 816(dwarf_dealloc\(\))X 1 f 576 6183(rev)N 699(1.61,)X 879(3)X 939(Apr)X 1084(2006)X 2217(-)X 2264(66)X 2364(-)X 67 p %%Page: 67 67 0(Courier)xf 0 f 10 s 0 xH 0 xS 0 f 1 f 2217 384(-)N 2264(67)X 2364(-)X 0 f 576 768(void)N 816(dwarf_dealloc\()X 960 864(Dwarf_Debug)N 1536(dbg,)X 960 960(void*)N 1248(space,)X 960 1056(Dwarf_Unsigned)N 1680(type\))X 1 f 576 1200(The)N 730(function)X 0 f 1054(dwarf_dealloc)X 1 f 1707(frees)X 1893(the)X 2020(dynamic)X 2325(storage)X 2586(pointed)X 2856(to)X 2948(by)X 0 f 3086(space)X 1 f (,)S 3376(and)X 3522(allocated)X 3842(to)X 3934(the)X 576 1296(given)N 0 f 810(Dwarf_Debug)X 1 f (.)S 1406(The)X 1559(argument)X 0 f 1918(type)X 1 f 2138(is)X 2219(an)X 2323(integer)X 2573(code)X 2752(that)X 2899(specifies)X 3207(the)X 3332(allocation)X 3675(type)X 3840(of)X 3934(the)X 576 1392(region)N 801(pointed)X 1061(to)X 1143(by)X 1243(the)X 0 f 1389(space)X 1 f (.)S 1689(Refer)X 1888(to)X 1970(section)X 2217(4)X 2277(for)X 2391(details)X 2620(on)X 2 f 2720(libdwarf)X 1 f 3010(memory)X 3297(management.)X 576 6183(rev)N 699(1.61,)X 879(3)X 939(Apr)X 1084(2006)X 2217(-)X 2264(67)X 2364(-)X 68 p %%Page: 68 68 0(Courier)xf 0 f 10 s 0 xH 0 xS 0 f 1 f 2217 384(-)N 2264(68)X 2364(-)X 576 6183(rev)N 699(1.61,)X 879(3)X 939(Apr)X 1084(2006)X 2217(-)X 2264(68)X 2364(-)X 69 p %%Page: 69 69 0(Courier)xf 0 f 10 s 0 xH 0 xS 0 f 1 f 2095 768(CONTENTS)N 576 1008(1.)N 676(INTRODUCTION)X 3 f 1371(.)X 1477(.)X 1583(.)X 1689(.)X 1795(.)X 1901(.)X 2007(.)X 2113(.)X 2219(.)X 2325(.)X 2431(.)X 2537(.)X 2643(.)X 2749(.)X 2855(.)X 2961(.)X 3067(.)X 3173(.)X 3279(.)X 3385(.)X 3491(.)X 3597(.)X 3703(.)X 3809(.)X 1 f 3992(1)X 676 1104(1.1)N 856(Purpose)X 1134(and)X 1270(Scope)X 3 f 1583(.)X 1689(.)X 1795(.)X 1901(.)X 2007(.)X 2113(.)X 2219(.)X 2325(.)X 2431(.)X 2537(.)X 2643(.)X 2749(.)X 2855(.)X 2961(.)X 3067(.)X 3173(.)X 3279(.)X 3385(.)X 3491(.)X 3597(.)X 3703(.)X 3809(.)X 1 f 3992(1)X 676 1200(1.2)N 856(Document)X 1210(History)X 3 f 1583(.)X 1689(.)X 1795(.)X 1901(.)X 2007(.)X 2113(.)X 2219(.)X 2325(.)X 2431(.)X 2537(.)X 2643(.)X 2749(.)X 2855(.)X 2961(.)X 3067(.)X 3173(.)X 3279(.)X 3385(.)X 3491(.)X 3597(.)X 3703(.)X 3809(.)X 1 f 3992(1)X 676 1296(1.3)N 856(Definitions)X 3 f 1265(.)X 1371(.)X 1477(.)X 1583(.)X 1689(.)X 1795(.)X 1901(.)X 2007(.)X 2113(.)X 2219(.)X 2325(.)X 2431(.)X 2537(.)X 2643(.)X 2749(.)X 2855(.)X 2961(.)X 3067(.)X 3173(.)X 3279(.)X 3385(.)X 3491(.)X 3597(.)X 3703(.)X 3809(.)X 1 f 3992(1)X 676 1392(1.4)N 856(Overview)X 3 f 1265(.)X 1371(.)X 1477(.)X 1583(.)X 1689(.)X 1795(.)X 1901(.)X 2007(.)X 2113(.)X 2219(.)X 2325(.)X 2431(.)X 2537(.)X 2643(.)X 2749(.)X 2855(.)X 2961(.)X 3067(.)X 3173(.)X 3279(.)X 3385(.)X 3491(.)X 3597(.)X 3703(.)X 3809(.)X 1 f 3992(1)X 676 1488(1.5)N 856(Items)X 1054(Changed)X 3 f 1477(.)X 1583(.)X 1689(.)X 1795(.)X 1901(.)X 2007(.)X 2113(.)X 2219(.)X 2325(.)X 2431(.)X 2537(.)X 2643(.)X 2749(.)X 2855(.)X 2961(.)X 3067(.)X 3173(.)X 3279(.)X 3385(.)X 3491(.)X 3597(.)X 3703(.)X 3809(.)X 1 f 3992(2)X 676 1584(1.6)N 856(Items)X 1054(Removed)X 3 f 1477(.)X 1583(.)X 1689(.)X 1795(.)X 1901(.)X 2007(.)X 2113(.)X 2219(.)X 2325(.)X 2431(.)X 2537(.)X 2643(.)X 2749(.)X 2855(.)X 2961(.)X 3067(.)X 3173(.)X 3279(.)X 3385(.)X 3491(.)X 3597(.)X 3703(.)X 3809(.)X 1 f 3992(2)X 676 1680(1.7)N 856(Revision)X 1160(History)X 3 f 1477(.)X 1583(.)X 1689(.)X 1795(.)X 1901(.)X 2007(.)X 2113(.)X 2219(.)X 2325(.)X 2431(.)X 2537(.)X 2643(.)X 2749(.)X 2855(.)X 2961(.)X 3067(.)X 3173(.)X 3279(.)X 3385(.)X 3491(.)X 3597(.)X 3703(.)X 3809(.)X 1 f 3992(3)X 576 1824(2.)N 676(Types)X 892(Definitions)X 3 f 1371(.)X 1477(.)X 1583(.)X 1689(.)X 1795(.)X 1901(.)X 2007(.)X 2113(.)X 2219(.)X 2325(.)X 2431(.)X 2537(.)X 2643(.)X 2749(.)X 2855(.)X 2961(.)X 3067(.)X 3173(.)X 3279(.)X 3385(.)X 3491(.)X 3597(.)X 3703(.)X 3809(.)X 1 f 3992(3)X 676 1920(2.1)N 856(General)X 1131(Description)X 3 f 1583(.)X 1689(.)X 1795(.)X 1901(.)X 2007(.)X 2113(.)X 2219(.)X 2325(.)X 2431(.)X 2537(.)X 2643(.)X 2749(.)X 2855(.)X 2961(.)X 3067(.)X 3173(.)X 3279(.)X 3385(.)X 3491(.)X 3597(.)X 3703(.)X 3809(.)X 1 f 3992(3)X 676 2016(2.2)N 856(Scalar)X 1077(Types)X 3 f 1371(.)X 1477(.)X 1583(.)X 1689(.)X 1795(.)X 1901(.)X 2007(.)X 2113(.)X 2219(.)X 2325(.)X 2431(.)X 2537(.)X 2643(.)X 2749(.)X 2855(.)X 2961(.)X 3067(.)X 3173(.)X 3279(.)X 3385(.)X 3491(.)X 3597(.)X 3703(.)X 3809(.)X 1 f 3992(3)X 676 2112(2.3)N 856(Aggregate)X 1211(Types)X 3 f 1477(.)X 1583(.)X 1689(.)X 1795(.)X 1901(.)X 2007(.)X 2113(.)X 2219(.)X 2325(.)X 2431(.)X 2537(.)X 2643(.)X 2749(.)X 2855(.)X 2961(.)X 3067(.)X 3173(.)X 3279(.)X 3385(.)X 3491(.)X 3597(.)X 3703(.)X 3809(.)X 1 f 3992(4)X 856 2208(2.3.1)N 1096(Location)X 1401(Record)X 3 f 1689(.)X 1795(.)X 1901(.)X 2007(.)X 2113(.)X 2219(.)X 2325(.)X 2431(.)X 2537(.)X 2643(.)X 2749(.)X 2855(.)X 2961(.)X 3067(.)X 3173(.)X 3279(.)X 3385(.)X 3491(.)X 3597(.)X 3703(.)X 3809(.)X 1 f 3992(4)X 856 2304(2.3.2)N 1096(Location)X 1401(Description)X 3 f 1901(.)X 2007(.)X 2113(.)X 2219(.)X 2325(.)X 2431(.)X 2537(.)X 2643(.)X 2749(.)X 2855(.)X 2961(.)X 3067(.)X 3173(.)X 3279(.)X 3385(.)X 3491(.)X 3597(.)X 3703(.)X 3809(.)X 1 f 3992(5)X 856 2400(2.3.3)N 1096(Data)X 1268(Block)X 3 f 1583(.)X 1689(.)X 1795(.)X 1901(.)X 2007(.)X 2113(.)X 2219(.)X 2325(.)X 2431(.)X 2537(.)X 2643(.)X 2749(.)X 2855(.)X 2961(.)X 3067(.)X 3173(.)X 3279(.)X 3385(.)X 3491(.)X 3597(.)X 3703(.)X 3809(.)X 1 f 3992(5)X 856 2496(2.3.4)N 1096(Frame)X 1321(Operation)X 1662(Codes:)X 1904(DWARF)X 2213(2)X 3 f 2325(.)X 2431(.)X 2537(.)X 2643(.)X 2749(.)X 2855(.)X 2961(.)X 3067(.)X 3173(.)X 3279(.)X 3385(.)X 3491(.)X 3597(.)X 3703(.)X 3809(.)X 1 f 3992(5)X 856 2592(2.3.5)N 1096(Frame)X 1321(Regtable:)X 1648(DWARF)X 1957(2)X 3 f 2113(.)X 2219(.)X 2325(.)X 2431(.)X 2537(.)X 2643(.)X 2749(.)X 2855(.)X 2961(.)X 3067(.)X 3173(.)X 3279(.)X 3385(.)X 3491(.)X 3597(.)X 3703(.)X 3809(.)X 1 f 3992(6)X 856 2688(2.3.6)N 1096(Frame)X 1321(Operation)X 1662(Codes:)X 1904(DWARF)X 2213(3)X 2273(\(and)X 2436(DWARF2\))X 3 f 2855(.)X 2961(.)X 3067(.)X 3173(.)X 3279(.)X 3385(.)X 3491(.)X 3597(.)X 3703(.)X 3809(.)X 1 f 3992(7)X 856 2784(2.3.7)N 1096(Frame)X 1321(Regtable:)X 1648(DWARF)X 1957(3)X 3 f 2113(.)X 2219(.)X 2325(.)X 2431(.)X 2537(.)X 2643(.)X 2749(.)X 2855(.)X 2961(.)X 3067(.)X 3173(.)X 3279(.)X 3385(.)X 3491(.)X 3597(.)X 3703(.)X 3809(.)X 1 f 3992(7)X 856 2880(2.3.8)N 1096(Macro)X 1326(Details)X 1573(Record)X 3 f 1901(.)X 2007(.)X 2113(.)X 2219(.)X 2325(.)X 2431(.)X 2537(.)X 2643(.)X 2749(.)X 2855(.)X 2961(.)X 3067(.)X 3173(.)X 3279(.)X 3385(.)X 3491(.)X 3597(.)X 3703(.)X 3809(.)X 1 f 3992(9)X 676 2976(2.4)N 856(Opaque)X 1126(Types)X 3 f 1371(.)X 1477(.)X 1583(.)X 1689(.)X 1795(.)X 1901(.)X 2007(.)X 2113(.)X 2219(.)X 2325(.)X 2431(.)X 2537(.)X 2643(.)X 2749(.)X 2855(.)X 2961(.)X 3067(.)X 3173(.)X 3279(.)X 3385(.)X 3491(.)X 3597(.)X 3703(.)X 3809(.)X 1 f 3992(9)X 576 3120(3.)N 676(Error)X 866(Handling)X 3 f 1265(.)X 1371(.)X 1477(.)X 1583(.)X 1689(.)X 1795(.)X 1901(.)X 2007(.)X 2113(.)X 2219(.)X 2325(.)X 2431(.)X 2537(.)X 2643(.)X 2749(.)X 2855(.)X 2961(.)X 3067(.)X 3173(.)X 3279(.)X 3385(.)X 3491(.)X 3597(.)X 3703(.)X 3809(.)X 1 f 3952(11)X 676 3216(3.1)N 856(Returned)X 1170(values)X 1395(in)X 1477(the)X 1595(functional)X 1940(interface)X 3 f 2325(.)X 2431(.)X 2537(.)X 2643(.)X 2749(.)X 2855(.)X 2961(.)X 3067(.)X 3173(.)X 3279(.)X 3385(.)X 3491(.)X 3597(.)X 3703(.)X 3809(.)X 1 f 3952(12)X 576 3360(4.)N 676(Memory)X 972(Management)X 3 f 1477(.)X 1583(.)X 1689(.)X 1795(.)X 1901(.)X 2007(.)X 2113(.)X 2219(.)X 2325(.)X 2431(.)X 2537(.)X 2643(.)X 2749(.)X 2855(.)X 2961(.)X 3067(.)X 3173(.)X 3279(.)X 3385(.)X 3491(.)X 3597(.)X 3703(.)X 3809(.)X 1 f 3952(13)X 676 3456(4.1)N 856(Read-only)X 1210(Properties)X 3 f 1583(.)X 1689(.)X 1795(.)X 1901(.)X 2007(.)X 2113(.)X 2219(.)X 2325(.)X 2431(.)X 2537(.)X 2643(.)X 2749(.)X 2855(.)X 2961(.)X 3067(.)X 3173(.)X 3279(.)X 3385(.)X 3491(.)X 3597(.)X 3703(.)X 3809(.)X 1 f 3952(13)X 676 3552(4.2)N 856(Storage)X 1121(Deallocation)X 3 f 1583(.)X 1689(.)X 1795(.)X 1901(.)X 2007(.)X 2113(.)X 2219(.)X 2325(.)X 2431(.)X 2537(.)X 2643(.)X 2749(.)X 2855(.)X 2961(.)X 3067(.)X 3173(.)X 3279(.)X 3385(.)X 3491(.)X 3597(.)X 3703(.)X 3809(.)X 1 f 3952(13)X 576 3696(5.)N 676(Functional)X 1038(Interface)X 3 f 1371(.)X 1477(.)X 1583(.)X 1689(.)X 1795(.)X 1901(.)X 2007(.)X 2113(.)X 2219(.)X 2325(.)X 2431(.)X 2537(.)X 2643(.)X 2749(.)X 2855(.)X 2961(.)X 3067(.)X 3173(.)X 3279(.)X 3385(.)X 3491(.)X 3597(.)X 3703(.)X 3809(.)X 1 f 3952(15)X 676 3792(5.1)N 856(Initialization)X 1285(Operations)X 3 f 1689(.)X 1795(.)X 1901(.)X 2007(.)X 2113(.)X 2219(.)X 2325(.)X 2431(.)X 2537(.)X 2643(.)X 2749(.)X 2855(.)X 2961(.)X 3067(.)X 3173(.)X 3279(.)X 3385(.)X 3491(.)X 3597(.)X 3703(.)X 3809(.)X 1 f 3952(15)X 856 3888(5.1.1)N 1096(dwarf_init\(\))X 3 f 1583(.)X 1689(.)X 1795(.)X 1901(.)X 2007(.)X 2113(.)X 2219(.)X 2325(.)X 2431(.)X 2537(.)X 2643(.)X 2749(.)X 2855(.)X 2961(.)X 3067(.)X 3173(.)X 3279(.)X 3385(.)X 3491(.)X 3597(.)X 3703(.)X 3809(.)X 1 f 3952(15)X 856 3984(5.1.2)N 1096(dwarf_elf_init\(\))X 3 f 1689(.)X 1795(.)X 1901(.)X 2007(.)X 2113(.)X 2219(.)X 2325(.)X 2431(.)X 2537(.)X 2643(.)X 2749(.)X 2855(.)X 2961(.)X 3067(.)X 3173(.)X 3279(.)X 3385(.)X 3491(.)X 3597(.)X 3703(.)X 3809(.)X 1 f 3952(16)X 856 4080(5.1.3)N 1096 0.2232(dwarf_get_elf\(\))AX 3 f 1689(.)X 1795(.)X 1901(.)X 2007(.)X 2113(.)X 2219(.)X 2325(.)X 2431(.)X 2537(.)X 2643(.)X 2749(.)X 2855(.)X 2961(.)X 3067(.)X 3173(.)X 3279(.)X 3385(.)X 3491(.)X 3597(.)X 3703(.)X 3809(.)X 1 f 3952(16)X 856 4176(5.1.4)N 1096(dwarf_finish\(\))X 3 f 1689(.)X 1795(.)X 1901(.)X 2007(.)X 2113(.)X 2219(.)X 2325(.)X 2431(.)X 2537(.)X 2643(.)X 2749(.)X 2855(.)X 2961(.)X 3067(.)X 3173(.)X 3279(.)X 3385(.)X 3491(.)X 3597(.)X 3703(.)X 3809(.)X 1 f 3952(17)X 676 4272(5.2)N 856(Debugging)X 1232(Information)X 1635(Entry)X 1833(Delivery)X 2134(Operations)X 3 f 2537(.)X 2643(.)X 2749(.)X 2855(.)X 2961(.)X 3067(.)X 3173(.)X 3279(.)X 3385(.)X 3491(.)X 3597(.)X 3703(.)X 3809(.)X 1 f 3952(17)X 856 4368(5.2.1)N 1096(Debugging)X 1472(Information)X 1875(Entry)X 2073(Debugger)X 2410(Delivery)X 2711(Operations)X 3 f 3173(.)X 3279(.)X 3385(.)X 3491(.)X 3597(.)X 3703(.)X 3809(.)X 1 f 3952(17)X 856 4464(5.2.2)N 1096 0.2321(dwarf_next_cu_header\(\))AX 3 f 2007(.)X 2113(.)X 2219(.)X 2325(.)X 2431(.)X 2537(.)X 2643(.)X 2749(.)X 2855(.)X 2961(.)X 3067(.)X 3173(.)X 3279(.)X 3385(.)X 3491(.)X 3597(.)X 3703(.)X 3809(.)X 1 f 3952(17)X 856 4560(5.2.3)N 1096(dwarf_siblingof\(\))X 3 f 1795(.)X 1901(.)X 2007(.)X 2113(.)X 2219(.)X 2325(.)X 2431(.)X 2537(.)X 2643(.)X 2749(.)X 2855(.)X 2961(.)X 3067(.)X 3173(.)X 3279(.)X 3385(.)X 3491(.)X 3597(.)X 3703(.)X 3809(.)X 1 f 3952(18)X 856 4656(5.2.4)N 1096(dwarf_child\(\))X 3 f 1583(.)X 1689(.)X 1795(.)X 1901(.)X 2007(.)X 2113(.)X 2219(.)X 2325(.)X 2431(.)X 2537(.)X 2643(.)X 2749(.)X 2855(.)X 2961(.)X 3067(.)X 3173(.)X 3279(.)X 3385(.)X 3491(.)X 3597(.)X 3703(.)X 3809(.)X 1 f 3952(18)X 856 4752(5.2.5)N 1096 0.2500(dwarf_offdie\(\))AX 3 f 1689(.)X 1795(.)X 1901(.)X 2007(.)X 2113(.)X 2219(.)X 2325(.)X 2431(.)X 2537(.)X 2643(.)X 2749(.)X 2855(.)X 2961(.)X 3067(.)X 3173(.)X 3279(.)X 3385(.)X 3491(.)X 3597(.)X 3703(.)X 3809(.)X 1 f 3952(18)X 676 4848(5.3)N 856(Debugging)X 1232(Information)X 1635(Entry)X 1833(Query)X 2054(Operations)X 3 f 2537(.)X 2643(.)X 2749(.)X 2855(.)X 2961(.)X 3067(.)X 3173(.)X 3279(.)X 3385(.)X 3491(.)X 3597(.)X 3703(.)X 3809(.)X 1 f 3952(18)X 856 4944(5.3.1)N 1096(dwarf_tag\(\))X 3 f 1583(.)X 1689(.)X 1795(.)X 1901(.)X 2007(.)X 2113(.)X 2219(.)X 2325(.)X 2431(.)X 2537(.)X 2643(.)X 2749(.)X 2855(.)X 2961(.)X 3067(.)X 3173(.)X 3279(.)X 3385(.)X 3491(.)X 3597(.)X 3703(.)X 3809(.)X 1 f 3952(19)X 856 5040(5.3.2)N 1096 0.2109(dwarf_dieoffset\(\))AX 3 f 1795(.)X 1901(.)X 2007(.)X 2113(.)X 2219(.)X 2325(.)X 2431(.)X 2537(.)X 2643(.)X 2749(.)X 2855(.)X 2961(.)X 3067(.)X 3173(.)X 3279(.)X 3385(.)X 3491(.)X 3597(.)X 3703(.)X 3809(.)X 1 f 3952(19)X 856 5136(5.3.3)N 1096 0.1625(dwarf_die_CU_offset\(\))AX 3 f 1901(.)X 2007(.)X 2113(.)X 2219(.)X 2325(.)X 2431(.)X 2537(.)X 2643(.)X 2749(.)X 2855(.)X 2961(.)X 3067(.)X 3173(.)X 3279(.)X 3385(.)X 3491(.)X 3597(.)X 3703(.)X 3809(.)X 1 f 3952(19)X 856 5232(5.3.4)N 1096 0.2321(dwarf_diename\(\))AX 3 f 1795(.)X 1901(.)X 2007(.)X 2113(.)X 2219(.)X 2325(.)X 2431(.)X 2537(.)X 2643(.)X 2749(.)X 2855(.)X 2961(.)X 3067(.)X 3173(.)X 3279(.)X 3385(.)X 3491(.)X 3597(.)X 3703(.)X 3809(.)X 1 f 3952(19)X 856 5328(5.3.5)N 1096(dwarf_attrlist\(\))X 3 f 1689(.)X 1795(.)X 1901(.)X 2007(.)X 2113(.)X 2219(.)X 2325(.)X 2431(.)X 2537(.)X 2643(.)X 2749(.)X 2855(.)X 2961(.)X 3067(.)X 3173(.)X 3279(.)X 3385(.)X 3491(.)X 3597(.)X 3703(.)X 3809(.)X 1 f 3952(20)X 856 5424(5.3.6)N 1096(dwarf_hasattr\(\))X 3 f 1689(.)X 1795(.)X 1901(.)X 2007(.)X 2113(.)X 2219(.)X 2325(.)X 2431(.)X 2537(.)X 2643(.)X 2749(.)X 2855(.)X 2961(.)X 3067(.)X 3173(.)X 3279(.)X 3385(.)X 3491(.)X 3597(.)X 3703(.)X 3809(.)X 1 f 3952(20)X 856 5520(5.3.7)N 1096(dwarf_attr\(\))X 3 f 1583(.)X 1689(.)X 1795(.)X 1901(.)X 2007(.)X 2113(.)X 2219(.)X 2325(.)X 2431(.)X 2537(.)X 2643(.)X 2749(.)X 2855(.)X 2961(.)X 3067(.)X 3173(.)X 3279(.)X 3385(.)X 3491(.)X 3597(.)X 3703(.)X 3809(.)X 1 f 3952(21)X 856 5616(5.3.8)N 1096(dwarf_lowpc\(\))X 3 f 1689(.)X 1795(.)X 1901(.)X 2007(.)X 2113(.)X 2219(.)X 2325(.)X 2431(.)X 2537(.)X 2643(.)X 2749(.)X 2855(.)X 2961(.)X 3067(.)X 3173(.)X 3279(.)X 3385(.)X 3491(.)X 3597(.)X 3703(.)X 3809(.)X 1 f 3952(21)X 856 5712(5.3.9)N 1096(dwarf_highpc\(\))X 3 f 1689(.)X 1795(.)X 1901(.)X 2007(.)X 2113(.)X 2219(.)X 2325(.)X 2431(.)X 2537(.)X 2643(.)X 2749(.)X 2855(.)X 2961(.)X 3067(.)X 3173(.)X 3279(.)X 3385(.)X 3491(.)X 3597(.)X 3703(.)X 3809(.)X 1 f 3952(21)X 856 5808(5.3.10)N 1096 0.2083(dwarf_bytesize\(\))AX 3 f 1689(.)X 1795(.)X 1901(.)X 2007(.)X 2113(.)X 2219(.)X 2325(.)X 2431(.)X 2537(.)X 2643(.)X 2749(.)X 2855(.)X 2961(.)X 3067(.)X 3173(.)X 3279(.)X 3385(.)X 3491(.)X 3597(.)X 3703(.)X 3809(.)X 1 f 3952(21)X 856 5904(5.3.11)N 1096(dwarf_bitsize\(\))X 3 f 1689(.)X 1795(.)X 1901(.)X 2007(.)X 2113(.)X 2219(.)X 2325(.)X 2431(.)X 2537(.)X 2643(.)X 2749(.)X 2855(.)X 2961(.)X 3067(.)X 3173(.)X 3279(.)X 3385(.)X 3491(.)X 3597(.)X 3703(.)X 3809(.)X 1 f 3952(21)X 2246 6183(-)N 2293(i)X 2335(-)X 70 p %%Page: 70 70 0(Courier)xf 0 f 10 s 0 xH 0 xS 0 f 1 f 856 768(5.3.12)N 1096(dwarf_bitoffset\(\))X 3 f 1689(.)X 1795(.)X 1901(.)X 2007(.)X 2113(.)X 2219(.)X 2325(.)X 2431(.)X 2537(.)X 2643(.)X 2749(.)X 2855(.)X 2961(.)X 3067(.)X 3173(.)X 3279(.)X 3385(.)X 3491(.)X 3597(.)X 3703(.)X 3809(.)X 1 f 3952(22)X 856 864(5.3.13)N 1096 0.2321(dwarf_srclang\(\))AX 3 f 1689(.)X 1795(.)X 1901(.)X 2007(.)X 2113(.)X 2219(.)X 2325(.)X 2431(.)X 2537(.)X 2643(.)X 2749(.)X 2855(.)X 2961(.)X 3067(.)X 3173(.)X 3279(.)X 3385(.)X 3491(.)X 3597(.)X 3703(.)X 3809(.)X 1 f 3952(22)X 856 960(5.3.14)N 1096 0.3088(dwarf_arrayorder\(\))AX 3 f 1795(.)X 1901(.)X 2007(.)X 2113(.)X 2219(.)X 2325(.)X 2431(.)X 2537(.)X 2643(.)X 2749(.)X 2855(.)X 2961(.)X 3067(.)X 3173(.)X 3279(.)X 3385(.)X 3491(.)X 3597(.)X 3703(.)X 3809(.)X 1 f 3952(22)X 676 1056(5.4)N 856(Attribute)X 1165(Form)X 1358(Queries)X 3 f 1689(.)X 1795(.)X 1901(.)X 2007(.)X 2113(.)X 2219(.)X 2325(.)X 2431(.)X 2537(.)X 2643(.)X 2749(.)X 2855(.)X 2961(.)X 3067(.)X 3173(.)X 3279(.)X 3385(.)X 3491(.)X 3597(.)X 3703(.)X 3809(.)X 1 f 3952(22)X 856 1152(5.4.1)N 1096 0.2232(dwarf_hasform\(\))AX 3 f 1689(.)X 1795(.)X 1901(.)X 2007(.)X 2113(.)X 2219(.)X 2325(.)X 2431(.)X 2537(.)X 2643(.)X 2749(.)X 2855(.)X 2961(.)X 3067(.)X 3173(.)X 3279(.)X 3385(.)X 3491(.)X 3597(.)X 3703(.)X 3809(.)X 1 f 3952(23)X 856 1248(5.4.2)N 1096 0.2167(dwarf_whatform\(\))AX 3 f 1795(.)X 1901(.)X 2007(.)X 2113(.)X 2219(.)X 2325(.)X 2431(.)X 2537(.)X 2643(.)X 2749(.)X 2855(.)X 2961(.)X 3067(.)X 3173(.)X 3279(.)X 3385(.)X 3491(.)X 3597(.)X 3703(.)X 3809(.)X 1 f 3952(23)X 856 1344(5.4.3)N 1096 0.1875(dwarf_whatform_direct\(\))AX 3 f 2007(.)X 2113(.)X 2219(.)X 2325(.)X 2431(.)X 2537(.)X 2643(.)X 2749(.)X 2855(.)X 2961(.)X 3067(.)X 3173(.)X 3279(.)X 3385(.)X 3491(.)X 3597(.)X 3703(.)X 3809(.)X 1 f 3952(23)X 856 1440(5.4.4)N 1096 0.2083(dwarf_whatattr\(\))AX 3 f 1689(.)X 1795(.)X 1901(.)X 2007(.)X 2113(.)X 2219(.)X 2325(.)X 2431(.)X 2537(.)X 2643(.)X 2749(.)X 2855(.)X 2961(.)X 3067(.)X 3173(.)X 3279(.)X 3385(.)X 3491(.)X 3597(.)X 3703(.)X 3809(.)X 1 f 3952(23)X 856 1536(5.4.5)N 1096 0.2857(dwarf_formref\(\))AX 3 f 1689(.)X 1795(.)X 1901(.)X 2007(.)X 2113(.)X 2219(.)X 2325(.)X 2431(.)X 2537(.)X 2643(.)X 2749(.)X 2855(.)X 2961(.)X 3067(.)X 3173(.)X 3279(.)X 3385(.)X 3491(.)X 3597(.)X 3703(.)X 3809(.)X 1 f 3952(23)X 856 1632(5.4.6)N 1096 0.1905(dwarf_global_formref\(\))AX 3 f 2007(.)X 2113(.)X 2219(.)X 2325(.)X 2431(.)X 2537(.)X 2643(.)X 2749(.)X 2855(.)X 2961(.)X 3067(.)X 3173(.)X 3279(.)X 3385(.)X 3491(.)X 3597(.)X 3703(.)X 3809(.)X 1 f 3952(24)X 856 1728(5.4.7)N 1096 0.2417(dwarf_formaddr\(\))AX 3 f 1795(.)X 1901(.)X 2007(.)X 2113(.)X 2219(.)X 2325(.)X 2431(.)X 2537(.)X 2643(.)X 2749(.)X 2855(.)X 2961(.)X 3067(.)X 3173(.)X 3279(.)X 3385(.)X 3491(.)X 3597(.)X 3703(.)X 3809(.)X 1 f 3952(24)X 856 1824(5.4.8)N 1096 0.2250(dwarf_formflag\(\))AX 3 f 1795(.)X 1901(.)X 2007(.)X 2113(.)X 2219(.)X 2325(.)X 2431(.)X 2537(.)X 2643(.)X 2749(.)X 2855(.)X 2961(.)X 3067(.)X 3173(.)X 3279(.)X 3385(.)X 3491(.)X 3597(.)X 3703(.)X 3809(.)X 1 f 3952(24)X 856 1920(5.4.9)N 1096 0.2188(dwarf_formudata\(\))AX 3 f 1795(.)X 1901(.)X 2007(.)X 2113(.)X 2219(.)X 2325(.)X 2431(.)X 2537(.)X 2643(.)X 2749(.)X 2855(.)X 2961(.)X 3067(.)X 3173(.)X 3279(.)X 3385(.)X 3491(.)X 3597(.)X 3703(.)X 3809(.)X 1 f 3952(24)X 856 2016(5.4.10)N 1096 0.2109(dwarf_formsdata\(\))AX 3 f 1795(.)X 1901(.)X 2007(.)X 2113(.)X 2219(.)X 2325(.)X 2431(.)X 2537(.)X 2643(.)X 2749(.)X 2855(.)X 2961(.)X 3067(.)X 3173(.)X 3279(.)X 3385(.)X 3491(.)X 3597(.)X 3703(.)X 3809(.)X 1 f 3952(25)X 856 2112(5.4.11)N 1096(dwarf_formblock\(\))X 3 f 1795(.)X 1901(.)X 2007(.)X 2113(.)X 2219(.)X 2325(.)X 2431(.)X 2537(.)X 2643(.)X 2749(.)X 2855(.)X 2961(.)X 3067(.)X 3173(.)X 3279(.)X 3385(.)X 3491(.)X 3597(.)X 3703(.)X 3809(.)X 1 f 3952(25)X 856 2208(5.4.12)N 1096(dwarf_formstring\(\))X 3 f 1795(.)X 1901(.)X 2007(.)X 2113(.)X 2219(.)X 2325(.)X 2431(.)X 2537(.)X 2643(.)X 2749(.)X 2855(.)X 2961(.)X 3067(.)X 3173(.)X 3279(.)X 3385(.)X 3491(.)X 3597(.)X 3703(.)X 3809(.)X 1 f 3952(25)X 1096 2304(5.4.12.1)N 1436(dwarf_loclist_n\(\))X 3 f 2113(.)X 2219(.)X 2325(.)X 2431(.)X 2537(.)X 2643(.)X 2749(.)X 2855(.)X 2961(.)X 3067(.)X 3173(.)X 3279(.)X 3385(.)X 3491(.)X 3597(.)X 3703(.)X 3809(.)X 1 f 3952(25)X 1096 2400(5.4.12.2)N 1436(dwarf_loclist\(\))X 3 f 2007(.)X 2113(.)X 2219(.)X 2325(.)X 2431(.)X 2537(.)X 2643(.)X 2749(.)X 2855(.)X 2961(.)X 3067(.)X 3173(.)X 3279(.)X 3385(.)X 3491(.)X 3597(.)X 3703(.)X 3809(.)X 1 f 3952(26)X 676 2496(5.5)N 856(Line)X 1023(Number)X 1306(Operations)X 3 f 1795(.)X 1901(.)X 2007(.)X 2113(.)X 2219(.)X 2325(.)X 2431(.)X 2537(.)X 2643(.)X 2749(.)X 2855(.)X 2961(.)X 3067(.)X 3173(.)X 3279(.)X 3385(.)X 3491(.)X 3597(.)X 3703(.)X 3809(.)X 1 f 3952(27)X 856 2592(5.5.1)N 1096(Get)X 1232(A)X 1310(Set)X 1432(of)X 1519(Lines)X 3 f 1795(.)X 1901(.)X 2007(.)X 2113(.)X 2219(.)X 2325(.)X 2431(.)X 2537(.)X 2643(.)X 2749(.)X 2855(.)X 2961(.)X 3067(.)X 3173(.)X 3279(.)X 3385(.)X 3491(.)X 3597(.)X 3703(.)X 3809(.)X 1 f 3952(27)X 1096 2688(5.5.1.1)N 1436(dwarf_srclines\(\))X 3 f 2007(.)X 2113(.)X 2219(.)X 2325(.)X 2431(.)X 2537(.)X 2643(.)X 2749(.)X 2855(.)X 2961(.)X 3067(.)X 3173(.)X 3279(.)X 3385(.)X 3491(.)X 3597(.)X 3703(.)X 3809(.)X 1 f 3952(27)X 856 2784(5.5.2)N 1096(Get)X 1232(the)X 1350(set)X 1459(of)X 1546(Source)X 1789(File)X 1933(Names)X 3 f 2219(.)X 2325(.)X 2431(.)X 2537(.)X 2643(.)X 2749(.)X 2855(.)X 2961(.)X 3067(.)X 3173(.)X 3279(.)X 3385(.)X 3491(.)X 3597(.)X 3703(.)X 3809(.)X 1 f 3952(28)X 856 2880(5.5.3)N 1096(Get)X 1232(information)X 1630(about)X 1828(a)X 1884(Single)X 2108(Table)X 2311(Line)X 3 f 2537(.)X 2643(.)X 2749(.)X 2855(.)X 2961(.)X 3067(.)X 3173(.)X 3279(.)X 3385(.)X 3491(.)X 3597(.)X 3703(.)X 3809(.)X 1 f 3952(29)X 1096 2976(5.5.3.1)N 1436(dwarf_linebeginstatement\(\))X 3 f 2431(.)X 2537(.)X 2643(.)X 2749(.)X 2855(.)X 2961(.)X 3067(.)X 3173(.)X 3279(.)X 3385(.)X 3491(.)X 3597(.)X 3703(.)X 3809(.)X 1 f 3952(29)X 1096 3072(5.5.3.2)N 1436 0.2102(dwarf_lineendsequence\(\))AX 3 f 2325(.)X 2431(.)X 2537(.)X 2643(.)X 2749(.)X 2855(.)X 2961(.)X 3067(.)X 3173(.)X 3279(.)X 3385(.)X 3491(.)X 3597(.)X 3703(.)X 3809(.)X 1 f 3952(29)X 1096 3168(5.5.3.3)N 1436(dwarf_lineno\(\))X 3 f 2007(.)X 2113(.)X 2219(.)X 2325(.)X 2431(.)X 2537(.)X 2643(.)X 2749(.)X 2855(.)X 2961(.)X 3067(.)X 3173(.)X 3279(.)X 3385(.)X 3491(.)X 3597(.)X 3703(.)X 3809(.)X 1 f 3952(29)X 1096 3264(5.5.3.4)N 1436 0.1607(dwarf_line_srcfileno\(\))AX 3 f 2219(.)X 2325(.)X 2431(.)X 2537(.)X 2643(.)X 2749(.)X 2855(.)X 2961(.)X 3067(.)X 3173(.)X 3279(.)X 3385(.)X 3491(.)X 3597(.)X 3703(.)X 3809(.)X 1 f 3952(30)X 1096 3360(5.5.3.5)N 1436 0.2083(dwarf_lineaddr\(\))AX 3 f 2113(.)X 2219(.)X 2325(.)X 2431(.)X 2537(.)X 2643(.)X 2749(.)X 2855(.)X 2961(.)X 3067(.)X 3173(.)X 3279(.)X 3385(.)X 3491(.)X 3597(.)X 3703(.)X 3809(.)X 1 f 3952(30)X 1096 3456(5.5.3.6)N 1436(dwarf_lineoff\(\))X 3 f 2007(.)X 2113(.)X 2219(.)X 2325(.)X 2431(.)X 2537(.)X 2643(.)X 2749(.)X 2855(.)X 2961(.)X 3067(.)X 3173(.)X 3279(.)X 3385(.)X 3491(.)X 3597(.)X 3703(.)X 3809(.)X 1 f 3952(30)X 1096 3552(5.5.3.7)N 1436(dwarf_linesrc\(\))X 3 f 2007(.)X 2113(.)X 2219(.)X 2325(.)X 2431(.)X 2537(.)X 2643(.)X 2749(.)X 2855(.)X 2961(.)X 3067(.)X 3173(.)X 3279(.)X 3385(.)X 3491(.)X 3597(.)X 3703(.)X 3809(.)X 1 f 3952(30)X 1096 3648(5.5.3.8)N 1436(dwarf_lineblock\(\))X 3 f 2113(.)X 2219(.)X 2325(.)X 2431(.)X 2537(.)X 2643(.)X 2749(.)X 2855(.)X 2961(.)X 3067(.)X 3173(.)X 3279(.)X 3385(.)X 3491(.)X 3597(.)X 3703(.)X 3809(.)X 1 f 3952(31)X 676 3744(5.6)N 856(Global)X 1094(Name)X 1306(Space)X 1518(Operations)X 3 f 2007(.)X 2113(.)X 2219(.)X 2325(.)X 2431(.)X 2537(.)X 2643(.)X 2749(.)X 2855(.)X 2961(.)X 3067(.)X 3173(.)X 3279(.)X 3385(.)X 3491(.)X 3597(.)X 3703(.)X 3809(.)X 1 f 3952(31)X 856 3840(5.6.1)N 1096(Debugger)X 1433(Interface)X 1740(Operations)X 3 f 2219(.)X 2325(.)X 2431(.)X 2537(.)X 2643(.)X 2749(.)X 2855(.)X 2961(.)X 3067(.)X 3173(.)X 3279(.)X 3385(.)X 3491(.)X 3597(.)X 3703(.)X 3809(.)X 1 f 3952(31)X 1096 3936(5.6.1.1)N 1436(dwarf_get_globals\(\))X 3 f 2219(.)X 2325(.)X 2431(.)X 2537(.)X 2643(.)X 2749(.)X 2855(.)X 2961(.)X 3067(.)X 3173(.)X 3279(.)X 3385(.)X 3491(.)X 3597(.)X 3703(.)X 3809(.)X 1 f 3952(31)X 1096 4032(5.6.1.2)N 1436(dwarf_globname\(\))X 3 f 2113(.)X 2219(.)X 2325(.)X 2431(.)X 2537(.)X 2643(.)X 2749(.)X 2855(.)X 2961(.)X 3067(.)X 3173(.)X 3279(.)X 3385(.)X 3491(.)X 3597(.)X 3703(.)X 3809(.)X 1 f 3952(32)X 1096 4128(5.6.1.3)N 1436 0.1406(dwarf_global_die_offset\(\))AX 3 f 2325(.)X 2431(.)X 2537(.)X 2643(.)X 2749(.)X 2855(.)X 2961(.)X 3067(.)X 3173(.)X 3279(.)X 3385(.)X 3491(.)X 3597(.)X 3703(.)X 3809(.)X 1 f 3952(32)X 1096 4224(5.6.1.4)N 1436 0.1576(dwarf_global_cu_offset\(\))AX 3 f 2325(.)X 2431(.)X 2537(.)X 2643(.)X 2749(.)X 2855(.)X 2961(.)X 3067(.)X 3173(.)X 3279(.)X 3385(.)X 3491(.)X 3597(.)X 3703(.)X 3809(.)X 1 f 3952(32)X 1096 4320(5.6.1.5)N 1436 0.1622(dwarf_get_cu_die_offset_given_cu_header_offset\(\))AX 3 f 3173(.)X 3279(.)X 3385(.)X 3491(.)X 3597(.)X 3703(.)X 3809(.)X 1 f 3952(33)X 1096 4416(5.6.1.6)N 1436 0.1442(dwarf_global_name_offsets\(\))AX 3 f 2431(.)X 2537(.)X 2643(.)X 2749(.)X 2855(.)X 2961(.)X 3067(.)X 3173(.)X 3279(.)X 3385(.)X 3491(.)X 3597(.)X 3703(.)X 3809(.)X 1 f 3952(33)X 676 4512(5.7)N 856(DWARF3)X 1205(Type)X 1390(Names)X 1633(Operations)X 3 f 2113(.)X 2219(.)X 2325(.)X 2431(.)X 2537(.)X 2643(.)X 2749(.)X 2855(.)X 2961(.)X 3067(.)X 3173(.)X 3279(.)X 3385(.)X 3491(.)X 3597(.)X 3703(.)X 3809(.)X 1 f 3952(33)X 856 4608(5.7.1)N 1096(Debugger)X 1433(Interface)X 1740(Operations)X 3 f 2219(.)X 2325(.)X 2431(.)X 2537(.)X 2643(.)X 2749(.)X 2855(.)X 2961(.)X 3067(.)X 3173(.)X 3279(.)X 3385(.)X 3491(.)X 3597(.)X 3703(.)X 3809(.)X 1 f 3952(34)X 1096 4704(5.7.1.1)N 1436(dwarf_get_pubtypes\(\))X 3 f 2219(.)X 2325(.)X 2431(.)X 2537(.)X 2643(.)X 2749(.)X 2855(.)X 2961(.)X 3067(.)X 3173(.)X 3279(.)X 3385(.)X 3491(.)X 3597(.)X 3703(.)X 3809(.)X 1 f 3952(34)X 1096 4800(5.7.1.2)N 1436 0.1806(dwarf_pubtypename\(\))AX 3 f 2219(.)X 2325(.)X 2431(.)X 2537(.)X 2643(.)X 2749(.)X 2855(.)X 2961(.)X 3067(.)X 3173(.)X 3279(.)X 3385(.)X 3491(.)X 3597(.)X 3703(.)X 3809(.)X 1 f 3952(34)X 1096 4896(5.7.1.3)N 1436 0.1450(dwarf_pubtype_die_offset\(\))AX 3 f 2431(.)X 2537(.)X 2643(.)X 2749(.)X 2855(.)X 2961(.)X 3067(.)X 3173(.)X 3279(.)X 3385(.)X 3491(.)X 3597(.)X 3703(.)X 3809(.)X 1 f 3952(34)X 1096 4992(5.7.1.4)N 1436 0.1615(dwarf_pubtype_cu_offset\(\))AX 3 f 2431(.)X 2537(.)X 2643(.)X 2749(.)X 2855(.)X 2961(.)X 3067(.)X 3173(.)X 3279(.)X 3385(.)X 3491(.)X 3597(.)X 3703(.)X 3809(.)X 1 f 3952(35)X 1096 5088(5.7.1.5)N 1436 0.1481(dwarf_pubtype_name_offsets\(\))AX 3 f 2537(.)X 2643(.)X 2749(.)X 2855(.)X 2961(.)X 3067(.)X 3173(.)X 3279(.)X 3385(.)X 3491(.)X 3597(.)X 3703(.)X 3809(.)X 1 f 3952(35)X 676 5184(5.8)N 856(User)X 1028(Defined)X 1307(Static)X 1509(Variable)X 1806(Names)X 2049(Operations)X 3 f 2537(.)X 2643(.)X 2749(.)X 2855(.)X 2961(.)X 3067(.)X 3173(.)X 3279(.)X 3385(.)X 3491(.)X 3597(.)X 3703(.)X 3809(.)X 1 f 3952(35)X 676 5280(5.9)N 856(Weak)X 1064(Name)X 1276(Space)X 1488(Operations)X 3 f 1901(.)X 2007(.)X 2113(.)X 2219(.)X 2325(.)X 2431(.)X 2537(.)X 2643(.)X 2749(.)X 2855(.)X 2961(.)X 3067(.)X 3173(.)X 3279(.)X 3385(.)X 3491(.)X 3597(.)X 3703(.)X 3809(.)X 1 f 3952(35)X 856 5376(5.9.1)N 1096(Debugger)X 1433(Interface)X 1740(Operations)X 3 f 2219(.)X 2325(.)X 2431(.)X 2537(.)X 2643(.)X 2749(.)X 2855(.)X 2961(.)X 3067(.)X 3173(.)X 3279(.)X 3385(.)X 3491(.)X 3597(.)X 3703(.)X 3809(.)X 1 f 3952(35)X 1096 5472(5.9.1.1)N 1436 0.2266(dwarf_get_weaks\(\))AX 3 f 2113(.)X 2219(.)X 2325(.)X 2431(.)X 2537(.)X 2643(.)X 2749(.)X 2855(.)X 2961(.)X 3067(.)X 3173(.)X 3279(.)X 3385(.)X 3491(.)X 3597(.)X 3703(.)X 3809(.)X 1 f 3952(36)X 1096 5568(5.9.1.2)N 1436 0.2833(dwarf_weakname\(\))AX 3 f 2113(.)X 2219(.)X 2325(.)X 2431(.)X 2537(.)X 2643(.)X 2749(.)X 2855(.)X 2961(.)X 3067(.)X 3173(.)X 3279(.)X 3385(.)X 3491(.)X 3597(.)X 3703(.)X 3809(.)X 1 f 3952(37)X 1096 5664(5.9.1.3)N 1436 0.2321(dwarf_weak_cu_offset\(\))AX 3 f 2325(.)X 2431(.)X 2537(.)X 2643(.)X 2749(.)X 2855(.)X 2961(.)X 3067(.)X 3173(.)X 3279(.)X 3385(.)X 3491(.)X 3597(.)X 3703(.)X 3809(.)X 1 f 3952(37)X 1096 5760(5.9.1.4)N 1436 0.2083(dwarf_weak_name_offsets\(\))AX 3 f 2431(.)X 2537(.)X 2643(.)X 2749(.)X 2855(.)X 2961(.)X 3067(.)X 3173(.)X 3279(.)X 3385(.)X 3491(.)X 3597(.)X 3703(.)X 3809(.)X 1 f 3952(37)X 676 5856(5.10)N 856(Static)X 1058(Function)X 1362(Names)X 1605(Operations)X 3 f 2007(.)X 2113(.)X 2219(.)X 2325(.)X 2431(.)X 2537(.)X 2643(.)X 2749(.)X 2855(.)X 2961(.)X 3067(.)X 3173(.)X 3279(.)X 3385(.)X 3491(.)X 3597(.)X 3703(.)X 3809(.)X 1 f 3952(38)X 856 5952(5.10.1)N 1096(Debugger)X 1433(Interface)X 1740(Operations)X 3 f 2219(.)X 2325(.)X 2431(.)X 2537(.)X 2643(.)X 2749(.)X 2855(.)X 2961(.)X 3067(.)X 3173(.)X 3279(.)X 3385(.)X 3491(.)X 3597(.)X 3703(.)X 3809(.)X 1 f 3952(38)X 2235 6183(-)N 2282(ii)X 2346(-)X 71 p %%Page: 71 71 0(Courier)xf 0 f 10 s 0 xH 0 xS 0 f 1 f 1096 768(5.10.1.1)N 1436 0.2031(dwarf_get_funcs\(\))AX 3 f 2113(.)X 2219(.)X 2325(.)X 2431(.)X 2537(.)X 2643(.)X 2749(.)X 2855(.)X 2961(.)X 3067(.)X 3173(.)X 3279(.)X 3385(.)X 3491(.)X 3597(.)X 3703(.)X 3809(.)X 1 f 3952(38)X 1096 864(5.10.1.2)N 1436 0.2583(dwarf_funcname\(\))AX 3 f 2113(.)X 2219(.)X 2325(.)X 2431(.)X 2537(.)X 2643(.)X 2749(.)X 2855(.)X 2961(.)X 3067(.)X 3173(.)X 3279(.)X 3385(.)X 3491(.)X 3597(.)X 3703(.)X 3809(.)X 1 f 3952(39)X 1096 960(5.10.1.3)N 1436 0.1932(dwarf_func_die_offset\(\))AX 3 f 2325(.)X 2431(.)X 2537(.)X 2643(.)X 2749(.)X 2855(.)X 2961(.)X 3067(.)X 3173(.)X 3279(.)X 3385(.)X 3491(.)X 3597(.)X 3703(.)X 3809(.)X 1 f 3952(39)X 1096 1056(5.10.1.4)N 1436 0.2143(dwarf_func_cu_offset\(\))AX 3 f 2325(.)X 2431(.)X 2537(.)X 2643(.)X 2749(.)X 2855(.)X 2961(.)X 3067(.)X 3173(.)X 3279(.)X 3385(.)X 3491(.)X 3597(.)X 3703(.)X 3809(.)X 1 f 3952(40)X 1096 1152(5.10.1.5)N 1436 0.1927(dwarf_func_name_offsets\(\))AX 3 f 2431(.)X 2537(.)X 2643(.)X 2749(.)X 2855(.)X 2961(.)X 3067(.)X 3173(.)X 3279(.)X 3385(.)X 3491(.)X 3597(.)X 3703(.)X 3809(.)X 1 f 3952(40)X 676 1248(5.11)N 856(User)X 1028(Defined)X 1307(Type)X 1492(Names)X 1735(Operations)X 3 f 2219(.)X 2325(.)X 2431(.)X 2537(.)X 2643(.)X 2749(.)X 2855(.)X 2961(.)X 3067(.)X 3173(.)X 3279(.)X 3385(.)X 3491(.)X 3597(.)X 3703(.)X 3809(.)X 1 f 3952(40)X 856 1344(5.11.1)N 1096(Debugger)X 1433(Interface)X 1740(Operations)X 3 f 2219(.)X 2325(.)X 2431(.)X 2537(.)X 2643(.)X 2749(.)X 2855(.)X 2961(.)X 3067(.)X 3173(.)X 3279(.)X 3385(.)X 3491(.)X 3597(.)X 3703(.)X 3809(.)X 1 f 3952(40)X 1096 1440(5.11.1.1)N 1436(dwarf_get_types\(\))X 3 f 2113(.)X 2219(.)X 2325(.)X 2431(.)X 2537(.)X 2643(.)X 2749(.)X 2855(.)X 2961(.)X 3067(.)X 3173(.)X 3279(.)X 3385(.)X 3491(.)X 3597(.)X 3703(.)X 3809(.)X 1 f 3952(41)X 1096 1536(5.11.1.2)N 1436 0.2167(dwarf_typename\(\))AX 3 f 2113(.)X 2219(.)X 2325(.)X 2431(.)X 2537(.)X 2643(.)X 2749(.)X 2855(.)X 2961(.)X 3067(.)X 3173(.)X 3279(.)X 3385(.)X 3491(.)X 3597(.)X 3703(.)X 3809(.)X 1 f 3952(42)X 1096 1632(5.11.1.3)N 1436 0.1648(dwarf_type_die_offset\(\))AX 3 f 2325(.)X 2431(.)X 2537(.)X 2643(.)X 2749(.)X 2855(.)X 2961(.)X 3067(.)X 3173(.)X 3279(.)X 3385(.)X 3491(.)X 3597(.)X 3703(.)X 3809(.)X 1 f 3952(42)X 1096 1728(5.11.1.4)N 1436 0.1845(dwarf_type_cu_offset\(\))AX 3 f 2325(.)X 2431(.)X 2537(.)X 2643(.)X 2749(.)X 2855(.)X 2961(.)X 3067(.)X 3173(.)X 3279(.)X 3385(.)X 3491(.)X 3597(.)X 3703(.)X 3809(.)X 1 f 3952(42)X 1096 1824(5.11.1.5)N 1436 0.1667(dwarf_type_name_offsets\(\))AX 3 f 2431(.)X 2537(.)X 2643(.)X 2749(.)X 2855(.)X 2961(.)X 3067(.)X 3173(.)X 3279(.)X 3385(.)X 3491(.)X 3597(.)X 3703(.)X 3809(.)X 1 f 3952(42)X 676 1920(5.12)N 856(User)X 1028(Defined)X 1307(Static)X 1509(Variable)X 1806(Names)X 2049(Operations)X 3 f 2537(.)X 2643(.)X 2749(.)X 2855(.)X 2961(.)X 3067(.)X 3173(.)X 3279(.)X 3385(.)X 3491(.)X 3597(.)X 3703(.)X 3809(.)X 1 f 3952(43)X 856 2016(5.12.1)N 1096(Debugger)X 1433(Interface)X 1740(Operations)X 3 f 2219(.)X 2325(.)X 2431(.)X 2537(.)X 2643(.)X 2749(.)X 2855(.)X 2961(.)X 3067(.)X 3173(.)X 3279(.)X 3385(.)X 3491(.)X 3597(.)X 3703(.)X 3809(.)X 1 f 3952(43)X 1096 2112(5.12.1.1)N 1436 0.2167(dwarf_get_vars\(\))AX 3 f 2113(.)X 2219(.)X 2325(.)X 2431(.)X 2537(.)X 2643(.)X 2749(.)X 2855(.)X 2961(.)X 3067(.)X 3173(.)X 3279(.)X 3385(.)X 3491(.)X 3597(.)X 3703(.)X 3809(.)X 1 f 3952(43)X 1096 2208(5.12.1.2)N 1436 0.2768(dwarf_varname\(\))AX 3 f 2113(.)X 2219(.)X 2325(.)X 2431(.)X 2537(.)X 2643(.)X 2749(.)X 2855(.)X 2961(.)X 3067(.)X 3173(.)X 3279(.)X 3385(.)X 3491(.)X 3597(.)X 3703(.)X 3809(.)X 1 f 3952(44)X 1096 2304(5.12.1.3)N 1436 0.2024(dwarf_var_die_offset\(\))AX 3 f 2325(.)X 2431(.)X 2537(.)X 2643(.)X 2749(.)X 2855(.)X 2961(.)X 3067(.)X 3173(.)X 3279(.)X 3385(.)X 3491(.)X 3597(.)X 3703(.)X 3809(.)X 1 f 3952(44)X 1096 2400(5.12.1.4)N 1436 0.2250(dwarf_var_cu_offset\(\))AX 3 f 2219(.)X 2325(.)X 2431(.)X 2537(.)X 2643(.)X 2749(.)X 2855(.)X 2961(.)X 3067(.)X 3173(.)X 3279(.)X 3385(.)X 3491(.)X 3597(.)X 3703(.)X 3809(.)X 1 f 3952(45)X 1096 2496(5.12.1.5)N 1436 0.2011(dwarf_var_name_offsets\(\))AX 3 f 2431(.)X 2537(.)X 2643(.)X 2749(.)X 2855(.)X 2961(.)X 3067(.)X 3173(.)X 3279(.)X 3385(.)X 3491(.)X 3597(.)X 3703(.)X 3809(.)X 1 f 3952(45)X 676 2592(5.13)N 856(Macro)X 1086(Information)X 1489(Operations)X 3 f 1901(.)X 2007(.)X 2113(.)X 2219(.)X 2325(.)X 2431(.)X 2537(.)X 2643(.)X 2749(.)X 2855(.)X 2961(.)X 3067(.)X 3173(.)X 3279(.)X 3385(.)X 3491(.)X 3597(.)X 3703(.)X 3809(.)X 1 f 3952(45)X 856 2688(5.13.1)N 1096(General)X 1371(Macro)X 1601(Operations)X 3 f 2007(.)X 2113(.)X 2219(.)X 2325(.)X 2431(.)X 2537(.)X 2643(.)X 2749(.)X 2855(.)X 2961(.)X 3067(.)X 3173(.)X 3279(.)X 3385(.)X 3491(.)X 3597(.)X 3703(.)X 3809(.)X 1 f 3952(45)X 1096 2784(5.13.1.1)N 1436 0.1552(dwarf_find_macro_value_start\(\))AX 3 f 2537(.)X 2643(.)X 2749(.)X 2855(.)X 2961(.)X 3067(.)X 3173(.)X 3279(.)X 3385(.)X 3491(.)X 3597(.)X 3703(.)X 3809(.)X 1 f 3952(45)X 856 2880(5.13.2)N 1096(Debugger)X 1433(Interface)X 1740(Macro)X 1970(Operations)X 3 f 2431(.)X 2537(.)X 2643(.)X 2749(.)X 2855(.)X 2961(.)X 3067(.)X 3173(.)X 3279(.)X 3385(.)X 3491(.)X 3597(.)X 3703(.)X 3809(.)X 1 f 3952(45)X 856 2976(5.13.3)N 1096(Low)X 1263(Level)X 1466(Macro)X 1696(Information)X 2099(Operations)X 3 f 2537(.)X 2643(.)X 2749(.)X 2855(.)X 2961(.)X 3067(.)X 3173(.)X 3279(.)X 3385(.)X 3491(.)X 3597(.)X 3703(.)X 3809(.)X 1 f 3952(46)X 1096 3072(5.13.3.1)N 1436 0.1562(dwarf_get_macro_details\(\))AX 3 f 2431(.)X 2537(.)X 2643(.)X 2749(.)X 2855(.)X 2961(.)X 3067(.)X 3173(.)X 3279(.)X 3385(.)X 3491(.)X 3597(.)X 3703(.)X 3809(.)X 1 f 3952(46)X 676 3168(5.14)N 856(Low)X 1023(Level)X 1226(Frame)X 1451(Operations)X 3 f 1901(.)X 2007(.)X 2113(.)X 2219(.)X 2325(.)X 2431(.)X 2537(.)X 2643(.)X 2749(.)X 2855(.)X 2961(.)X 3067(.)X 3173(.)X 3279(.)X 3385(.)X 3491(.)X 3597(.)X 3703(.)X 3809(.)X 1 f 3952(46)X 1096 3264(5.14.0.1)N 1436(dwarf_get_fde_list\(\))X 3 f 2219(.)X 2325(.)X 2431(.)X 2537(.)X 2643(.)X 2749(.)X 2855(.)X 2961(.)X 3067(.)X 3173(.)X 3279(.)X 3385(.)X 3491(.)X 3597(.)X 3703(.)X 3809(.)X 1 f 3952(48)X 1096 3360(5.14.0.2)N 1436(dwarf_get_fde_list_eh\(\))X 3 f 2325(.)X 2431(.)X 2537(.)X 2643(.)X 2749(.)X 2855(.)X 2961(.)X 3067(.)X 3173(.)X 3279(.)X 3385(.)X 3491(.)X 3597(.)X 3703(.)X 3809(.)X 1 f 3952(50)X 1096 3456(5.14.0.3)N 1436 0.2143(dwarf_get_cie_of_fde\(\))AX 3 f 2325(.)X 2431(.)X 2537(.)X 2643(.)X 2749(.)X 2855(.)X 2961(.)X 3067(.)X 3173(.)X 3279(.)X 3385(.)X 3491(.)X 3597(.)X 3703(.)X 3809(.)X 1 f 3952(51)X 1096 3552(5.14.0.4)N 1436 0.1989(dwarf_get_fde_for_die\(\))AX 3 f 2325(.)X 2431(.)X 2537(.)X 2643(.)X 2749(.)X 2855(.)X 2961(.)X 3067(.)X 3173(.)X 3279(.)X 3385(.)X 3491(.)X 3597(.)X 3703(.)X 3809(.)X 1 f 3952(51)X 1096 3648(5.14.0.5)N 1436 0.2375(dwarf_get_fde_range\(\))AX 3 f 2325(.)X 2431(.)X 2537(.)X 2643(.)X 2749(.)X 2855(.)X 2961(.)X 3067(.)X 3173(.)X 3279(.)X 3385(.)X 3491(.)X 3597(.)X 3703(.)X 3809(.)X 1 f 3952(52)X 1096 3744(5.14.0.6)N 1436 0.1776(dwarf_get_cie_info\(\))AX 3 f 2219(.)X 2325(.)X 2431(.)X 2537(.)X 2643(.)X 2749(.)X 2855(.)X 2961(.)X 3067(.)X 3173(.)X 3279(.)X 3385(.)X 3491(.)X 3597(.)X 3703(.)X 3809(.)X 1 f 3952(52)X 1096 3840(5.14.0.7)N 1436 0.1250(dwarf_get_fde_instr_bytes\(\))AX 3 f 2431(.)X 2537(.)X 2643(.)X 2749(.)X 2855(.)X 2961(.)X 3067(.)X 3173(.)X 3279(.)X 3385(.)X 3491(.)X 3597(.)X 3703(.)X 3809(.)X 1 f 3952(52)X 1096 3936(5.14.0.8)N 1436 0.1898(dwarf_get_fde_info_for_reg\(\))AX 3 f 2537(.)X 2643(.)X 2749(.)X 2855(.)X 2961(.)X 3067(.)X 3173(.)X 3279(.)X 3385(.)X 3491(.)X 3597(.)X 3703(.)X 3809(.)X 1 f 3952(53)X 1096 4032(5.14.0.9)N 1436 0.1562(dwarf_get_fde_info_for_all_regs\(\))AX 3 f 2643(.)X 2749(.)X 2855(.)X 2961(.)X 3067(.)X 3173(.)X 3279(.)X 3385(.)X 3491(.)X 3597(.)X 3703(.)X 3809(.)X 1 f 3952(53)X 1096 4128(5.14.0.10)N 1436 0.1758(dwarf_set_frame_rule_table_size\(\))AX 3 f 2643(.)X 2749(.)X 2855(.)X 2961(.)X 3067(.)X 3173(.)X 3279(.)X 3385(.)X 3491(.)X 3597(.)X 3703(.)X 3809(.)X 1 f 3952(54)X 1096 4224(5.14.0.11)N 1436 0.1397(dwarf_set_frame_rule_inital_value\(\))AX 3 f 2749(.)X 2855(.)X 2961(.)X 3067(.)X 3173(.)X 3279(.)X 3385(.)X 3491(.)X 3597(.)X 3703(.)X 3809(.)X 1 f 3952(54)X 1096 4320(5.14.0.12)N 1436 0.1830(dwarf_get_fde_info_for_reg3\(\))AX 3 f 2537(.)X 2643(.)X 2749(.)X 2855(.)X 2961(.)X 3067(.)X 3173(.)X 3279(.)X 3385(.)X 3491(.)X 3597(.)X 3703(.)X 3809(.)X 1 f 3952(54)X 1096 4416(5.14.0.13)N 1436 0.2031(dwarf_get_fde_info_for_cfa_reg3\(\))AX 3 f 2643(.)X 2749(.)X 2855(.)X 2961(.)X 3067(.)X 3173(.)X 3279(.)X 3385(.)X 3491(.)X 3597(.)X 3703(.)X 3809(.)X 1 f 3952(55)X 1096 4512(5.14.0.14)N 1436 0.1515(dwarf_get_fde_info_for_all_regs3\(\))AX 3 f 2643(.)X 2749(.)X 2855(.)X 2961(.)X 3067(.)X 3173(.)X 3279(.)X 3385(.)X 3491(.)X 3597(.)X 3703(.)X 3809(.)X 1 f 3952(56)X 1096 4608(5.14.0.15)N 1436 0.2109(dwarf_get_fde_n\(\))AX 3 f 2113(.)X 2219(.)X 2325(.)X 2431(.)X 2537(.)X 2643(.)X 2749(.)X 2855(.)X 2961(.)X 3067(.)X 3173(.)X 3279(.)X 3385(.)X 3491(.)X 3597(.)X 3703(.)X 3809(.)X 1 f 3952(56)X 1096 4704(5.14.0.16)N 1436 0.2062(dwarf_get_fde_at_pc\(\))AX 3 f 2219(.)X 2325(.)X 2431(.)X 2537(.)X 2643(.)X 2749(.)X 2855(.)X 2961(.)X 3067(.)X 3173(.)X 3279(.)X 3385(.)X 3491(.)X 3597(.)X 3703(.)X 3809(.)X 1 f 3952(57)X 1096 4800(5.14.0.17)N 1436 0.1367(dwarf_expand_frame_instructions\(\))AX 3 f 2643(.)X 2749(.)X 2855(.)X 2961(.)X 3067(.)X 3173(.)X 3279(.)X 3385(.)X 3491(.)X 3597(.)X 3703(.)X 3809(.)X 1 f 3952(57)X 1096 4896(5.14.0.18)N 1436 0.1552(dwarf_get_fde_exception_info\(\))AX 3 f 2537(.)X 2643(.)X 2749(.)X 2855(.)X 2961(.)X 3067(.)X 3173(.)X 3279(.)X 3385(.)X 3491(.)X 3597(.)X 3703(.)X 3809(.)X 1 f 3952(57)X 676 4992(5.15)N 856(Location)X 1161(Expression)X 1537(Evaluation)X 3 f 2007(.)X 2113(.)X 2219(.)X 2325(.)X 2431(.)X 2537(.)X 2643(.)X 2749(.)X 2855(.)X 2961(.)X 3067(.)X 3173(.)X 3279(.)X 3385(.)X 3491(.)X 3597(.)X 3703(.)X 3809(.)X 1 f 3952(58)X 856 5088(5.15.1)N 1096(Location)X 1401(List)X 1545(Internal-level)X 1998(Interface)X 3 f 2431(.)X 2537(.)X 2643(.)X 2749(.)X 2855(.)X 2961(.)X 3067(.)X 3173(.)X 3279(.)X 3385(.)X 3491(.)X 3597(.)X 3703(.)X 3809(.)X 1 f 3952(58)X 1096 5184(5.15.1.1)N 1436(dwarf_get_loclist_entry\(\))X 3 f 2325(.)X 2431(.)X 2537(.)X 2643(.)X 2749(.)X 2855(.)X 2961(.)X 3067(.)X 3173(.)X 3279(.)X 3385(.)X 3491(.)X 3597(.)X 3703(.)X 3809(.)X 1 f 3952(58)X 676 5280(5.16)N 856(Abbreviations)X 1330(access)X 3 f 1583(.)X 1689(.)X 1795(.)X 1901(.)X 2007(.)X 2113(.)X 2219(.)X 2325(.)X 2431(.)X 2537(.)X 2643(.)X 2749(.)X 2855(.)X 2961(.)X 3067(.)X 3173(.)X 3279(.)X 3385(.)X 3491(.)X 3597(.)X 3703(.)X 3809(.)X 1 f 3952(58)X 856 5376(5.16.1)N 1096 0.2279(dwarf_get_abbrev\(\))AX 3 f 1795(.)X 1901(.)X 2007(.)X 2113(.)X 2219(.)X 2325(.)X 2431(.)X 2537(.)X 2643(.)X 2749(.)X 2855(.)X 2961(.)X 3067(.)X 3173(.)X 3279(.)X 3385(.)X 3491(.)X 3597(.)X 3703(.)X 3809(.)X 1 f 3952(59)X 856 5472(5.16.2)N 1096 0.1964(dwarf_get_abbrev_tag\(\))AX 3 f 2007(.)X 2113(.)X 2219(.)X 2325(.)X 2431(.)X 2537(.)X 2643(.)X 2749(.)X 2855(.)X 2961(.)X 3067(.)X 3173(.)X 3279(.)X 3385(.)X 3491(.)X 3597(.)X 3703(.)X 3809(.)X 1 f 3952(59)X 856 5568(5.16.3)N 1096 0.2216(dwarf_get_abbrev_code\(\))AX 3 f 2007(.)X 2113(.)X 2219(.)X 2325(.)X 2431(.)X 2537(.)X 2643(.)X 2749(.)X 2855(.)X 2961(.)X 3067(.)X 3173(.)X 3279(.)X 3385(.)X 3491(.)X 3597(.)X 3703(.)X 3809(.)X 1 f 3952(59)X 856 5664(5.16.4)N 1096 0.1734(dwarf_get_abbrev_children_flag\(\))AX 3 f 2325(.)X 2431(.)X 2537(.)X 2643(.)X 2749(.)X 2855(.)X 2961(.)X 3067(.)X 3173(.)X 3279(.)X 3385(.)X 3491(.)X 3597(.)X 3703(.)X 3809(.)X 1 f 3952(59)X 856 5760(5.16.5)N 1096 0.1957(dwarf_get_abbrev_entry\(\))AX 3 f 2007(.)X 2113(.)X 2219(.)X 2325(.)X 2431(.)X 2537(.)X 2643(.)X 2749(.)X 2855(.)X 2961(.)X 3067(.)X 3173(.)X 3279(.)X 3385(.)X 3491(.)X 3597(.)X 3703(.)X 3809(.)X 1 f 3952(60)X 676 5856(5.17)N 856(String)X 1071(Section)X 1331(Operations)X 3 f 1795(.)X 1901(.)X 2007(.)X 2113(.)X 2219(.)X 2325(.)X 2431(.)X 2537(.)X 2643(.)X 2749(.)X 2855(.)X 2961(.)X 3067(.)X 3173(.)X 3279(.)X 3385(.)X 3491(.)X 3597(.)X 3703(.)X 3809(.)X 1 f 3952(60)X 856 5952(5.17.1)N 1096(dwarf_get_str\(\))X 3 f 1689(.)X 1795(.)X 1901(.)X 2007(.)X 2113(.)X 2219(.)X 2325(.)X 2431(.)X 2537(.)X 2643(.)X 2749(.)X 2855(.)X 2961(.)X 3067(.)X 3173(.)X 3279(.)X 3385(.)X 3491(.)X 3597(.)X 3703(.)X 3809(.)X 1 f 3952(60)X 2224 6183(-)N 2271(iii)X 2357(-)X 72 p %%Page: 72 72 0(Courier)xf 0 f 10 s 0 xH 0 xS 0 f 1 f 676 768(5.18)N 856(Address)X 1139(Range)X 1364(Operations)X 3 f 1795(.)X 1901(.)X 2007(.)X 2113(.)X 2219(.)X 2325(.)X 2431(.)X 2537(.)X 2643(.)X 2749(.)X 2855(.)X 2961(.)X 3067(.)X 3173(.)X 3279(.)X 3385(.)X 3491(.)X 3597(.)X 3703(.)X 3809(.)X 1 f 3952(60)X 856 864(5.18.1)N 1096 0.2361(dwarf_get_aranges\(\))AX 3 f 1901(.)X 2007(.)X 2113(.)X 2219(.)X 2325(.)X 2431(.)X 2537(.)X 2643(.)X 2749(.)X 2855(.)X 2961(.)X 3067(.)X 3173(.)X 3279(.)X 3385(.)X 3491(.)X 3597(.)X 3703(.)X 3809(.)X 1 f 3952(60)X 856 960(5.18.2)N 1096 0.1719(dwarf_get_cu_die_offset\(\))AX 3 f 2007(.)X 2113(.)X 2219(.)X 2325(.)X 2431(.)X 2537(.)X 2643(.)X 2749(.)X 2855(.)X 2961(.)X 3067(.)X 3173(.)X 3279(.)X 3385(.)X 3491(.)X 3597(.)X 3703(.)X 3809(.)X 1 f 3952(61)X 856 1056(5.18.3)N 1096 0.2243(dwarf_get_arange_cu_header_offset\(\))AX 3 f 2431(.)X 2537(.)X 2643(.)X 2749(.)X 2855(.)X 2961(.)X 3067(.)X 3173(.)X 3279(.)X 3385(.)X 3491(.)X 3597(.)X 3703(.)X 3809(.)X 1 f 3952(61)X 856 1152(5.18.4)N 1096 0.2045(dwarf_get_arange_info\(\))AX 3 f 2007(.)X 2113(.)X 2219(.)X 2325(.)X 2431(.)X 2537(.)X 2643(.)X 2749(.)X 2855(.)X 2961(.)X 3067(.)X 3173(.)X 3279(.)X 3385(.)X 3491(.)X 3597(.)X 3703(.)X 3809(.)X 1 f 3952(62)X 676 1248(5.19)N 856(General)X 1131(Low)X 1298(Level)X 1501(Operations)X 3 f 1901(.)X 2007(.)X 2113(.)X 2219(.)X 2325(.)X 2431(.)X 2537(.)X 2643(.)X 2749(.)X 2855(.)X 2961(.)X 3067(.)X 3173(.)X 3279(.)X 3385(.)X 3491(.)X 3597(.)X 3703(.)X 3809(.)X 1 f 3952(62)X 856 1344(5.19.1)N 1096 0.1848(dwarf_get_address_size\(\))AX 3 f 2007(.)X 2113(.)X 2219(.)X 2325(.)X 2431(.)X 2537(.)X 2643(.)X 2749(.)X 2855(.)X 2961(.)X 3067(.)X 3173(.)X 3279(.)X 3385(.)X 3491(.)X 3597(.)X 3703(.)X 3809(.)X 1 f 3952(62)X 676 1440(5.20)N 856(Utility)X 1084(Operations)X 3 f 1583(.)X 1689(.)X 1795(.)X 1901(.)X 2007(.)X 2113(.)X 2219(.)X 2325(.)X 2431(.)X 2537(.)X 2643(.)X 2749(.)X 2855(.)X 2961(.)X 3067(.)X 3173(.)X 3279(.)X 3385(.)X 3491(.)X 3597(.)X 3703(.)X 3809(.)X 1 f 3952(62)X 856 1536(5.20.1)N 1096 0.2917(dwarf_errno\(\))AX 3 f 1689(.)X 1795(.)X 1901(.)X 2007(.)X 2113(.)X 2219(.)X 2325(.)X 2431(.)X 2537(.)X 2643(.)X 2749(.)X 2855(.)X 2961(.)X 3067(.)X 3173(.)X 3279(.)X 3385(.)X 3491(.)X 3597(.)X 3703(.)X 3809(.)X 1 f 3952(62)X 856 1632(5.20.2)N 1096 0.2404(dwarf_errmsg\(\))AX 3 f 1689(.)X 1795(.)X 1901(.)X 2007(.)X 2113(.)X 2219(.)X 2325(.)X 2431(.)X 2537(.)X 2643(.)X 2749(.)X 2855(.)X 2961(.)X 3067(.)X 3173(.)X 3279(.)X 3385(.)X 3491(.)X 3597(.)X 3703(.)X 3809(.)X 1 f 3952(62)X 856 1728(5.20.3)N 1096 0.2426(dwarf_seterrhand\(\))AX 3 f 1795(.)X 1901(.)X 2007(.)X 2113(.)X 2219(.)X 2325(.)X 2431(.)X 2537(.)X 2643(.)X 2749(.)X 2855(.)X 2961(.)X 3067(.)X 3173(.)X 3279(.)X 3385(.)X 3491(.)X 3597(.)X 3703(.)X 3809(.)X 1 f 3952(66)X 856 1824(5.20.4)N 1096 0.2812(dwarf_seterrarg\(\))AX 3 f 1795(.)X 1901(.)X 2007(.)X 2113(.)X 2219(.)X 2325(.)X 2431(.)X 2537(.)X 2643(.)X 2749(.)X 2855(.)X 2961(.)X 3067(.)X 3173(.)X 3279(.)X 3385(.)X 3491(.)X 3597(.)X 3703(.)X 3809(.)X 1 f 3952(66)X 856 1920(5.20.5)N 1096 0.2321(dwarf_dealloc\(\))AX 3 f 1689(.)X 1795(.)X 1901(.)X 2007(.)X 2113(.)X 2219(.)X 2325(.)X 2431(.)X 2537(.)X 2643(.)X 2749(.)X 2855(.)X 2961(.)X 3067(.)X 3173(.)X 3279(.)X 3385(.)X 3491(.)X 3597(.)X 3703(.)X 3809(.)X 1 f 3952(66)X 2226 6183(-)N 2273(iv)X 2355(-)X 73 p %%Page: 73 73 0(Courier)xf 0 f 10 s 0 xH 0 xS 0 f 1 f 1982 1056(LIST)N 2171(OF)X 2293(FIGURES)X 576 1296(Figure)N 805(1.)X 905(Scalar)X 1126(Types)X 3 f 1371(.)X 1477(.)X 1583(.)X 1689(.)X 1795(.)X 1901(.)X 2007(.)X 2113(.)X 2219(.)X 2325(.)X 2431(.)X 2537(.)X 2643(.)X 2749(.)X 2855(.)X 2961(.)X 3067(.)X 3173(.)X 3279(.)X 3385(.)X 3491(.)X 3597(.)X 3703(.)X 3809(.)X 1 f 3992(4)X 576 1440(Figure)N 805(2.)X 905(Error)X 1095(Indications)X 3 f 1583(.)X 1689(.)X 1795(.)X 1901(.)X 2007(.)X 2113(.)X 2219(.)X 2325(.)X 2431(.)X 2537(.)X 2643(.)X 2749(.)X 2855(.)X 2961(.)X 3067(.)X 3173(.)X 3279(.)X 3385(.)X 3491(.)X 3597(.)X 3703(.)X 3809(.)X 1 f 3952(12)X 576 1584(Figure)N 805(3.)X 905(Allocation/Deallocation)X 1695(Identifiers)X 3 f 2113(.)X 2219(.)X 2325(.)X 2431(.)X 2537(.)X 2643(.)X 2749(.)X 2855(.)X 2961(.)X 3067(.)X 3173(.)X 3279(.)X 3385(.)X 3491(.)X 3597(.)X 3703(.)X 3809(.)X 1 f 3952(15)X 576 1728(Figure)N 805(4.)X 905(Frame)X 1130(Information)X 1533(Rule)X 1704(Assignments)X 3 f 2219(.)X 2325(.)X 2431(.)X 2537(.)X 2643(.)X 2749(.)X 2855(.)X 2961(.)X 3067(.)X 3173(.)X 3279(.)X 3385(.)X 3491(.)X 3597(.)X 3703(.)X 3809(.)X 1 f 3952(48)X 576 1872(Figure)N 805(5.)X 905(Frame)X 1130(Information)X 1533(Special)X 1789(Values)X 3 f 2113(.)X 2219(.)X 2325(.)X 2431(.)X 2537(.)X 2643(.)X 2749(.)X 2855(.)X 2961(.)X 3067(.)X 3173(.)X 3279(.)X 3385(.)X 3491(.)X 3597(.)X 3703(.)X 3809(.)X 1 f 3952(48)X 576 2016(Figure)N 805(6.)X 905(List)X 1049(of)X 1136(Dwarf)X 1362(Error)X 1552(Codes)X 3 f 1795(.)X 1901(.)X 2007(.)X 2113(.)X 2219(.)X 2325(.)X 2431(.)X 2537(.)X 2643(.)X 2749(.)X 2855(.)X 2961(.)X 3067(.)X 3173(.)X 3279(.)X 3385(.)X 3491(.)X 3597(.)X 3703(.)X 3809(.)X 1 f 3952(63)X 576 2160(Figure)N 805(7.)X 905(List)X 1049(of)X 1136(Dwarf)X 1362(2)X 1422(Error)X 1612(Codes)X 1832(\(continued\))X 3 f 2325(.)X 2431(.)X 2537(.)X 2643(.)X 2749(.)X 2855(.)X 2961(.)X 3067(.)X 3173(.)X 3279(.)X 3385(.)X 3491(.)X 3597(.)X 3703(.)X 3809(.)X 1 f 3952(64)X 576 2304(Figure)N 805(8.)X 905(List)X 1049(of)X 1136(Dwarf)X 1362(2)X 1422(Error)X 1612(Codes)X 1832(\(continued\))X 3 f 2325(.)X 2431(.)X 2537(.)X 2643(.)X 2749(.)X 2855(.)X 2961(.)X 3067(.)X 3173(.)X 3279(.)X 3385(.)X 3491(.)X 3597(.)X 3703(.)X 3809(.)X 1 f 3952(65)X 576 2448(Figure)N 805(9.)X 905(List)X 1049(of)X 1136(Dwarf)X 1362(2)X 1422(Error)X 1612(Codes)X 3 f 1901(.)X 2007(.)X 2113(.)X 2219(.)X 2325(.)X 2431(.)X 2537(.)X 2643(.)X 2749(.)X 2855(.)X 2961(.)X 3067(.)X 3173(.)X 3279(.)X 3385(.)X 3491(.)X 3597(.)X 3703(.)X 3809(.)X 1 f 3952(66)X 2237 6183(-)N 2284(v)X 2344(-)X 74 p %%Page: 74 74 0(Courier)xf 0 f 10 s 0 xH 0 xS 0 f 1 f 3 f 12 s 1425 576(A)N 1518(Consumer)X 1968(Library)X 2318(Interface)X 2716(to)X 2820(DWARF)X 2 f 11 s 1084 720(UNIX)N 1311(International)X 1799(Programming)X 2314(Languages)X 2722(Special)X 3004(Interest)X 3295(Group)X 10 s 2115 1152(ABSTRACT)N 1 f 576 1392(This)N 745(document)X 1089(describes)X 1416(an)X 1520(interface)X 1830(to)X 1920(a)X 1984(library)X 2226(of)X 2321(functions)X 2647(to)X 2737(access)X 2971(DWARF)X 3288(debugging)X 3654(information)X 576 1488(entries)N 827(and)X 980(DWARF)X 1306(line)X 1463(number)X 1745(information)X 2160(\(and)X 2340(other)X 2542(DWARF2/3)X 2970(information\).)X 3452(It)X 3537(does)X 3720(not)X 3858(make)X 576 1584(recommendations)N 1173(as)X 1267(to)X 1356(how)X 1522(the)X 1648(functions)X 1974(described)X 2310(in)X 2400(this)X 2543(document)X 2887(should)X 3128(be)X 3232(implemented)X 3678(nor)X 3813(does)X 3988(it)X 576 1680(suggest)N 836(possible)X 1118(optimizations.)X 576 1824(The)N 721(document)X 1057(is)X 1130(oriented)X 1413(to)X 1495(reading)X 1756(DWARF)X 2065(version)X 2321(2)X 2381(and)X 2517(version)X 2773(3.)X 2873(There)X 3081(are)X 3200(certain)X 3439(sections)X 3717(which)X 3933(are)X 576 1920(SGI-specific)N 1015(\(those)X 1244(are)X 1376(clearly)X 1628(identified)X 1968(in)X 2063(the)X 2194(document\).)X 2610(The)X 2768(DWARF)X 3090(Committee)X 3478(has)X 3617(not)X 3751(finalized)X 576 2016(DWARF3)N 925(at)X 1003(this)X 1138(writing.)X 576 2160(In)N 674(the)X 803(mid)X 958(1990's)X 1207(this)X 1353(document)X 1700(and)X 1847(the)X 1976(library)X 2221(it)X 2296(describes)X 2626(was)X 2782(made)X 2987(available)X 3308(on)X 3420(the)X 3550(Internet.)X 3872(Unix)X 576 2256(International)N 1009(was)X 1157(disbanded)X 1505(in)X 1589(the)X 1709(1990's)X 1949(and)X 2087(no)X 2189(longer)X 2416(exists.)X 2660(In)X 2749(2005)X 2951(the)X 3071(DWARF)X 3382(committee)X 3742(began)X 3956(an)X 576 2352(affiliation)N 1118(with)X 1487(FreeStandards.org.)X 2340(See)X 2683 0.1121("http://www.freestandards.org")AX 3916(and)X 576 2448 0.1250("http://dwarf.freestandards.org".)AN 576 2592(This)N 738(document)X 1074(is)X 1147(subject)X 1394(to)X 1476(change.)X 576 2736(rev)N 699(1.61,)X 879(3)X 939(Apr)X 1084(2006)X 10 f 576 5568(hhhhhhhhhhhh)N 8 s 1 f 576 5664(0.)N 672(UNIX)X 847(is)X 906(a)X 950(registered)X 1217(trademark)X 1491(of)X 1560(UNIX)X 1735(System)X 1940(Laboratories,)X 2294(Inc.)X 2423(in)X 2489(the)X 2583(United)X 2773(States)X 2942(and)X 3050(other)X 3197(countries.)X 75 p %%Page: 75 75 0(Courier)xf 0 f 8 s 0 xH 0 xS 0 f 1 f 75 p %%Trailer xt xs