TheCedarDebugToolVersion4.2Releaseas[Indigo]Documentation>DebugTool.tioga,.pressCamefrom[Indigo]Manual>DebugTool.tioga,.pressLasteditedbyBirrellonJune14,19832:24pmbyHorningonJune7,19834:23pmAbstract:ThistoolappearsautomaticallyinCoCedar,andmaybecreatedinthenormalCedarenvironmentwiththe"Debug"command.Thetoolcanbesetuptoinspecttheenvironmentinwhichitisrunning,ortoteledebuganinstanceofCedarrunningonanothermachine.InCoCedar,thetoolcanbeusedtolookatthenormalCedarenvironmentwhichhasbeenstoppedbyoutloadingittodisk.Thetoolallowsyoutoinspectandmodifythestateofparallelprocesses,andtoenumeratethesetofloadedpackagesandmodules.XEROXXeroxCorporationPaloAltoResearchCenter3333CoyoteHillRoadPaloAlto,California94304DRAFTForInternalXeroxUseOnlyDRAFTpН ЛО^kНєН`qН ЛОYuНrН ЛОTНosН╛ОTП-Н1БrН ЛОRьН LsН╛ОRьП*Н0rН ЛОQ0Н│sН╛ОQ0НЁНН(НрН FН#ЦН'Н╛ОO┴НЁНWН~Н(Н уН$sН'ґtН ЛОHЛsНDОHЛН!ОHЛН│НpН Н& Н'пН.gН1VН4{Н6≥Н;ШН=╙Н@6НE+Н ЛОGD НvН╙НBН Н%ЕН(ЛН+ИН.зН1Н3|Н5╡Н7└Н<ЎН?V НGАН ЛОE²ННJН╧НwН3НыН ÷Н"·Н(qН*Н.]Н3╦Н5бН;НA]НBЫН ЛОCЖН╣НБНН`Н=Н@Н╨Н ╡Н#|Н(╞Н-R Н6 Н:⌡Н=їНA НG┴Н ЛОBN НSН╡Н▀НН*Н,Н"фН%╡Н'▀Н,йН/лН4╘Н7GН:ЫН<рНB Н ЛО@їНзН·НЗН└НМН╠Н!▐Н(;Н+)uН ЛО8├sН(НО8├Н-0 Н(НО6чН,IН/XН5ЫН(НО57Н,▀Н1■Н4Н(НО3░Н,IН/╩ Н6gqН ЛО JН²НCНYН РН'·Н,0Н1┴Н4.ЬTVm$^THECEDARDEBUGTOOL2TheCedarDebugToolIntroductionThistoolappearsautomaticallyinCoCedar,whereitisinitiallysetuptolookatthenormalCedarenvironment,whichwasoutloadedtodiskwhenyouswappedtoCoCedar.Thetoolcanbecreatedwiththe"Debug"command.Ifyougivethecommandwithnoarguments,itcreatesatoolforinspectingtheenvironmentinwhichthetoolisexecuting.Ifyougivethecommandwiththenameofanothermachineasargument,itcreatesatoolforteledebuggingthatmachine.Theenvironmentwhichthetoolislookingatiscalledthetool's"client".Mostofthetoolisconcernedwithlookingattheparallelprocessesoftheclient;therearealsoafewfacilitiesnotrelatedtoprocesses.Non-process-relatedfacilitiesAtthebottomrightcornerofthemenuarethe"Screen"and"Kill"commands.Thesehavenoeffectiftheclientisthecurrentlyexecutingenvironment.InCoCedar,the"Screen"commandswapsbacktotheclienttoallowyoutolookattheclientdisplay(forabout20seconds,oruntilyoupressthe"swat"key);whenteledebugging,thgiscausesthemachinewhichisbeingdebuggedtoshowtheclient'sscreen.InCoCedar,the"Kill"commandissimilartopressingthebootbutton;whenteledebugging,itissimilartopressingthebootbuttononthemachinewhichisbeingdebugged.Atthebottomleftofthemenuare"ListLoadState"and"ListContext"."ListLoadState"enumeratesthecurrentlyloadedconfigurationsintheclient.Ifyoutypethenameofaconfigurationasthetextbesidethe"Context"button,thenclick"ListContext",itwillenumeratethemodulesinthatconfiguration.ProcessesTheprocessfacilitiesarebasedontheconceptof"freezing"aprocessatsomepointonitscallstack.Thismeansthattheprocesscontinuesexecutionnormally,butwhenitreturnstothatpointonitscallstack,theprocesswillstopexecutinguntilitisthawed.Ofcourse,thereisthespecialcasewhereyoufreezetheprocessatitscurrentframe,soitstopsexecutingimmediately.TheDebugToolallowsyoutofreezeandthawprocesses,andtolookatthefrozenframesofprocesses(evenwhiletherestoftheprocessisstillexecuting).Thereisnowaytolookataprocess(orpartofaprocess)thatisn'tfrozen.Therearefour"Freeze"buttons:"All",whichfreezesallprocessesattheircurrentframe;"Ready",whichfreezesallreadyprocessesattheircurrentframe(i.e.processesthataren'tsuspendedforamonitorlock,conditionvariablewaitorfault);"Process"whichfreezestheprocesswhosenumber(PSBindex)isgiveninoctalasthetextbesidethe"PsbIndex"buttonontherightoftheviewer.Finally,the"Context"buttonwillfreezeallprocessesassociatedwithaperticularconfigurationormodule,freezingthemattheboundaryofthecontext.Moreprecisely,"Context"enumeratesallprocesses,anddetermineseveryprocessthathassomewhereonitscallstackaframewithinthespecifiedmoduleorconfiguration;eachsuchprocessisfrozenatthepointwherecontrolwouldreturntowithinthemoduleorconfiguration;anyprocesscurrentlyexecuting(orwaitingorfaulted)withinthemoduleorconfigurationstopsexecutingimmediately.IfyouclicktheRIGHTmousebuttononthe"FreezeContext"button,thentheentirecallstackofeachsuchprocessisfrozen.ExaminingfrozenprocessesForeachprocessthatisfrozen,theDebugTooldisplaysthreebuttons,labelledwith"Adjust","Thaw",andadescriptionoftheprocess'scurrentstate.Thestatesaysthingslike"ready"or"waitingCV"or"pageFault",followedbythenameoftheframeatwhichtheprocessisfrozenandthepriorityoftheprocess.Thereisnowaytolookatnon-frozenframesoftheprocess.The"ready","waitingCV",etc.arewrappedinparenthesesiftheprocess'scurrentframeisnotfrozen(i.e.iftheprocessisstillexecuting).IfyouclicktheLEFTmousebuttonontheprocess-statebutton,DebugToolgivesabriefsummaryofCEDAR4.2vН!jОgwН"QОgН#7ОgvН$ZОgwН%XОgvН)ОgwН*'ОgvН-mОgwН.UОgsНHDОgxН ЛО^УН WН&yН ЛО[іvНўОXXНхН∙Н║Н Н!цН'МН,Н-\Н.хН3хН5ЕН7ЬН9їН<юН>YН@╧НEwН ЛОV╟НLНRНВН\Н!Н#ЙН'≈Н*GН/ФН1█Н7ўН:Н=DН?хНA╡НFtН ЛОU НFН(НшНXН НЯН"KН(їН+╪Н-╪ Н4ҐН6Н:▐Н;ЁН>{Н@╡ НG/Н ЛОSb НЯН∙Н≤ННН╠Н Н$┼Н&Н(╞Н+▓Н-ХН4?Н7OН9╔Н=ZН? НD Н ЛОQ╨Н░ННUНяНЯНЄНГН&ЄН)xН/JН2 Н:Н>!Н@wНC:НD⌡Н ЛОPН─НХНшН6НшНOНсН!┬Н#ЦН&╛Н(Н.їН1ЎН6ґН8AН:°Н?│НE{НG/Н ЛОNlН&Н╞ННоНЫН≥ НЭН"qН'Н(╡ yН ЛОKН= vНўОGнНкНLН8Н╛ННЬН"zН&}Н(РН+tН1sН4LН8²Н?ЭНD НG┴Н ЛОF'Н тНRНнН╚Н3Н╞Н╘Н%ПН.sН0_Н6╔Н9!Н?НE≤Н ЛОDН 0НшН8НУН║НGНШНіН!ҐН#RН%╞Н)lН.Н0оН4ўН6░Н;ЭН=ҐНAНC╣НG/Н ЛОBьН_НЮН█ НЁН!ЩН&/Н(├Н.Н2 Н3mН70Н=sН?НB⌡НDРН ЛОA1Н┘Н]Н▌НЖН.Н#≈Н%Н)≥Н+PН0╟Н3Н6QН;DН? НH9Н ЛО?┴НeНЬНЄНН┤НеН!DН#XН%еН+WН/rН0ЛН4дН<Н>Н@}НESНGжН ЛО=БНfНbНпН] Н╚Н }Н$ Н*cН-П Н5> Н<║Н?НEН ЛО<; НЧНгНAНsННБН# Н%┤Н)bН+5Н,zН5Н6пН9KН<Н@|НBВН ЛО:⌠НІНэНН┼НйН Н"кН)░Н+ОН1sН3!Н5П yН ЛО7DvНўО3ЖНtН7 Н┬НйН⌡Н!▐Н#чН(ЦН*▀ Н1Н24Н6ЖН8}Н;ЪН?█НA┌НCKНEдН ЛО2NН НgНCН╠Н⌠Н!лН(Н.GН0жН4 Н5ЧН:юН<|Н?YНCНEНGН ЛО0їН кН>Н&НЕНСН!1Н$▀Н%УН'uН,╙Н.оН3┼Н7'Н8їН;Н?╙НB╛НFьН ЛО/Н ЭН^Н5НяН╞Н{Н!мН#■Н$НН(oН.²Н6оН9╙Н@ЖНE&НGЮН ЛО-XННЩН─ НЭНзН╞Н"НН$ґН'3Н+²Н0>Н2Н8BН<(Н@НB┬НEPНG/Н ЛО+╠НрНPН НН$Н╒Н!╨Н$єН&eН)░Н+;Н,wН1]Н3╛Н6╒Н8mН9╘Н?НAХНDТН ЛО* НН■НбНгН`Н#∙Н'мН,┤Н.═Н4гН6┴Н9ЗН>МНC├Н ЛО(bН ХНhНFНЪНКНrН"╗Н'`Н+EН-ХН3тН6▒Н:aНA НC5НDMН ЛО&╩Н MН}НцНмН║Н!ЮН(/Н,MН0НН3^Н8BН<─НAҐНEKН ЛО%Н∙Н├zНqО%Н!О%vНО%НіО%НЛН┬Н}Н ЧН# Н+AН/ОН22Н4оН8^Н:SН<ПНAИНG/Н ЛО#lН┴НЪН╞НаН╣Н#╦ Н*)Н-HН.w Н4╠Н=(Н>ЯНDNН ЛО!еН cНИН5НXНЪНKН eН$ Н*Н0█ Н7цН9═ Н?ДНB┬ Н ЛО Н НhН1Н═НаН аН"√Н%Н(┬Н)╛Н-²Н1шН45Н9КН>ЕН@ё Н ЛОvНЪННгНН:НЄНУН!vН%pН*Н.Н2$Н3ЄН7шН:Н>ЩН@ё Н ЛОоНuН0НУНН,Н#ХН%⌠Н*²Н.иН1Н5ЫН7єН?ЪНCdН ЛО(ННіНaН║wНО(НыО(vН >О(Н!gО(Н$°Н)Н+Н-─Н2╟Н8°Н=jН@■НBЬНFИН ЛО─Н _ННIНzНNН╨yН ЛО1НцНПvНўОЦН≤ННН)НсН!ўН$MН+тН1JН5Н:═Н@НCeН ЛО;Н^НЫН НЭН≤НшН#oН(Н+┬Н.CН1XН4Н8Н:╘Н?╦НA_ Н ЛО■НіНаН[НMН╒Н!WН#Н%\Н)HН*жН.зН1/Н5ЫН7ZН;■Н>AН@√НE│НG/Н ЛО МНННdН_Н,НоНчНk Н&fН*жН,└Н.ьН3ЫН6фН─Н?ОНB■ Н ЛО ·Н├НVН╘wН!О ·НзО ·vН┐О ·НґО ·НУН Н"·Н%Н-(Н2 Н9kН<УН>7НA║НGЇН&tОЩwН'rОЩН(+ОЩН+" +TVm$зTHECEDARDEBUGTOOL3theprocess'scallstack(fromthepointatwhichitisfrozen).IfyouclicktheRIGHTmousebuttonthere,DebugToolwillcreateanactionareaforthatprocess,whichallowsyoutolookatthefrozenpartsofthecall-stackinmoredetail.The"Thaw"buttonassociatedwithafrozenprocesswillun-freezetheentireprocess.IfyouclicktheLEFTmousebuttononthe"Adjust"button,itwillchangethepointatwhichtheprocess'scall-stackisfrozentobetheboundaryofthemoduleorconfigurationspecifiedinthetextfor"Context"attherightoftheviewer.CLickingtheRIGHTmousebuttontherewillfreezetheentirecallstackoftheprocess.Youcan'tthaworadjustaprocesswhileithasanactionareaproceedtheactionareafirst.They'rereallyfrozen!Ifyouresumeanoutloadedclient(forexample,byproceedingtheactionthatinvokedtheworld-swapdebugger)whilesomeprocessesarefrozen,theyreallyarefrozenwhentheclientresumes.Thiscanbeimportantwhendebuggingparallelcomputations,butitcanbedangerous.Inparticular,bewareofresumingtheclientwhilecriticalsystemprocessesarefrozen!StyleYouwillfindtheDebugToolmorepleasantifyouusethefullpowerofitsprocessenumerationfacilities.Youshouldveryrarelyneedtouse"FreezeAll".Almostalways,youknowwhatsetofmodulesorconfigurationsyou'redebugging;ifyoufreezejusttheprocessesassociatedwiththem,DebugToolwilldothefilteringforyouandyouwon'thavesomuchtroubledecidingwhatprocesstolookat.BugsTherearestillseveralbugs.Pleaseletanimplementorknowifsomethingdoesn'twork.IfCoCedarbreaks,however,youstillhaveachancetolookatyouroutloadedclient.IfCoCedarhasbeeninvokedbyaclientandyouhaven'tresumedtheclientatall(e.g.UserScreen),youcanrestartthedebuggerwithoutlosingtheclientoutloadbybootingyourDebuggervolumewiththe"W"switch.(CoCedardoesthisautomaticallyinthesituationwhereCoPilotsays"inloadedtwice,clicktoboot").Alternatively,youcanreinstallCoCedarbybootingyourdebuggervolumewithnoswitches,inwhichcaseafteroutloadingitselfthedebuggerwillbootyourphysicalvolume.SymboltablesJustlikeCedar,CoCedaroftenmanagestofindthecorrectsymboltableautomaticallyusingtheversionmaps.However,thisisunlikelytobetrueforthemodulesyou'redebugging.CoCedarwillnotautomaticallylookatfilesontheclientvolumeyou'llneedtofetchthemexplicitlyontothedebuggervolumeusingBringOver,ortheClientFileTool.CEDAR4.2vН!jОgwН"QОgН#7ОgvН$ZОgwН%XОgvН)ОgwН*'ОgvН-mОgwН.UОgsНHDОgvН ЛО_'НDНЛНoНзН╡Н Н!║Н#1Н'7Н(├Н)ИН.ЖН0pН3Н6RwН8╙О_'Н9~О_'vН<ыО_'Н>О_'НA+НE∙Н ЛО]НHННН НLН!XН#╘Н&▀Н+йН/КН4,Н6ЖН8╦Н;ЕН=▒Н@НDZНGжН ЛО[ьНw Н∙НnН,НzН}Н$чН){ Н0Н3XН4ґН9Н>Н@ЯНG/Н ЛОZ1Н ЙН'Н╩Н└НяwНBОZ1НШОZ1vН ÷ОZ1Н!иОZ1Н%Н)▌Н+їН.Н3ШН8вН:?Н<ЭНAІНD'НGьН ЛОX┴Н НxН8 Н:Н╣Н"Н#фН%фН(5Н.zН0BН2╠Н7юН9■НBНGАН ЛОVБНDНУН+Н╪НMНіНПН ╒Н"ШН'╟Н-╔wН/ЧОVБН0рОVБvН4-ОVБН5WОVБН8─Н<КН@mНCНGН ЛОU;Н щНlНДН║НН5Н HН#÷Н'Н(иН,эН. Н2БН6°Н7ЖН:pННя НХНB Н ∙Н"Н$НН)Н+чН.^Н4| Н; Н>DНBFН ЛОsНBBНCЎН ЛО4(Н║Н─Н:НчН(НUН"ЙН$°Н'╦Н)TН,▓Н3Н7Н8║Н>uН@ННDMН ЛО2│Н Н UН8ННЙНЮН!▒Н$Н'УН)╟Н+бН.ФН7"Н9ШН<╘НAНC├Н ЛО0ыНИНшН+НэНмН╨Н$ІН'БН.4Н3Н6Н8jН;║Н@#НF_Н ЛО/2Н┼НЫНєНН≈Н"╛Н'╗Н*┤Н0ыН4бН7ЗН9╔Н>T НFьН ЛО-▀НjН■НXНGНEН!sН'oН,LН/ZН1SН7Н8ёН<єН?├НBЄ Н ЛО+ЦН HН╗Н╠Н\Н█НхН$yН ЛО(∙НуvНўО%FНіНpННПН ёН&[Н()Н+6Н-╣Н2fН7MН:уНCgНG/Н ЛО#÷Н╩Н╧НУН·НН"eН$Н&Н(ЧН+CН-╙Н36Н7v Н>▐НDgНGН ЛО!ВНdН┌НННН─Н"EН+ЕН/GН0ЗН4rН8 Н=ЛНA!НC├Н ЛО PНуН Н▐НSН╡Н&tОЩwН'rОЩН(+ОЩН+"Ъ┬TVm$Р Ъ TIMESROMANЧ÷ Ъ TIMESROMANЧ÷Ъ TIMESROMANЧYЪ TIMESROMANЧФЪ TIMESROMANЧ÷ЪLOGOЭЄЪ HELVETICAЧ÷Ъ HELVETICAЧ÷Ъ HELVETICAЧФЪ HELVETICAЧЪ HELVETICAЩ┘% ▐ иj/⌡HЬЪЪЪЪЪЪЪЪЪЪЪЪЪЪЪЪЪЪЪЪЪЪЪЪЪЪЪЪЪЪЪЪЪЪЪЪЪЪЪЪЪЪЪЪЪЪЪЪЪЪЪЪЪЪЪЪЪЪЪЪЪЪЪЪЪЪЪЪЪЪЪЪЪЪЪЪЪЪЪЪЪЪЪЪЪЪЪЪЪЪЪЪЪЪЪЪЪЪЪЪЪЪЪЪЪЪЪЪЪЪЪЪЪЪЪЪЪЪЪЪЪЪЪЪЪЪЪЪЪЪЪЪЪЪЪЪЪЪЪЪЪЪЪЪЪЪЪЪЪЪЪЪЪЪЪЪЪЪЪЪЪЪЪЪЪЪЪЪЪЪЪЪЪЪЪЪЪЪЪЪЪЪЪЪЪЪЪЪЪЪЪЪЪЪЪЪЪЪЪЪЪЪЪЪЪЪЪЪЪЪЪЪЪЪЪЪЪЪЪЪЪЪЪЪЪЪЪЪЪЪЪЪЪЪЪЪDebugTool.tioga14-Jun-83 15:02:32