ToCedarUsersDateDecember13,1983FromRussAtkinsonLocationPARCSubjectListerdocumentationOrganizationCSLXEROXListerDocumentationListerisaprogramtoproducehumanreadablefilesfrombcdfilesproducedbytheCompilerandBinder.Listerregistersavarietyofcommands,eachofwhichproducesadifferentsetofinformationfromagivenlistofbcdfiles.Eachcommandtakesalistoffilesasarguments.Thedefaultinputfileextensionisbcd.Theoutputfileextensionisderivedfromthecommandname,andisgivenwiththedescriptionofeachcommand.Therearenoswitchesoroptions.Eachlistingfilestartswithinformationaboutthebcdfilebeingexamined.Asanexample,forthecommand"bcdListLister"theoutputfileisLister.bcdList,whichstartswithLister.bcdListobject:Lister.bcd{4365c935458b}source:Lister.config{00008a129bc4(October24,19837:14pm)}creator:{0c0b0003000f}Theversionstampsareprintedinhexadecimal.Inthecaseofsourcefiles,theversionstampsarealsointerpretedascreatedates.Thecreatoristheversionstampofthecompilerorbinderthatproducedthebcdfile.AsaCedarcomponent,ListerisdescribedbyLister.df.ThetoolisnamedLister.bcd.Theregisteredcommandsarelistedbelow.BcdListerThiscommandsliststhecontentsofabcdfile,whichmaycontainmultiplemodules.TheextensionfortheproducedfileisbcdList.Theinformationproducedincludes:Configurations-forbcdfilesproducedbytheBinder,thisgroupgivesinformationabouttheconfigurationsinthebcdfile.Imports-liststhedefinitionsmodulesthatareimportedbythebcdfile.Exports-liststhedefinitionsmodulesthatareexportedbythebcdfile.Exportedvariables-liststhevariables(ifany)thatareexportedbythebcdfile.Modules-liststhemodulesthatarecontainedbythebcdfile.Anexamplelistingfollows:CodeListerImpl[14],file:CodeListerImpl[4],config:Lister[0]switches:bc-jlns,packageable,p _/q1_/ p(_/q3C_/9<$p [Sq1[Sp([Sq3C[Sp Wwq1Ww p(Ww q3CWwr SAs JY q F +#(+/|2Z5y;=@F D^ww, '+,,178L>@7B B S}1o( @; pq! )/,047=8t>@;?e@;qB3@;E > ]`%/)N, -1;4]6 =?B < AHo :q ^a #' ),/3 :x<>DG/ 8M!V#%+.-2:5 6 o4 m o28 % %+[-03o1 . 7p& '),6/-05F8:?DfF , r#$$'+014c:4<@Co +G K ( Ci k$& -*024e8 @^CD '%%u !Zq   j !F#&*-28 >bA7GR d KltAddqdd &I,it v qvv '&)K+037;p C$G/ u t qA %7(*Y0L2G47Tt qJ %@(*b024y7&t q-N% &),/4696;t q,N!#*?,;.1G46Spaces-BodyListerThiscommandsliststhebodiesofasinglemodulebcdfile.TheextensionfortheproducedfileisbodyList.Eachbodylistingentrygivesthenameoftheprocedure(ifany),theentrypoint(forprocedures),theframeaddress(fornestedprocedures),thecontextindex,andthenestinglevelofthebody.AnexampleofthefirstfewentriesinCodeListerImpl.bodyListis:Body:CodeListerImpl,ep:0,attrs:--ncontext:20,level:2Body:DigestFGT,ep:1,attrs:x--context:34,level:2Body:AddMyEntry,ep:6,frameaddr:10,attrs:x--context:0,level:3Body:(anon)context:56,level:3Body:(anon)context:58,level:3Body:AddBodyFGT,ep:4,frameaddr:26,attrs:x-ncontext:60,level:3CodeListerThiscommandsliststhecodeofasinglemodulebcdfile.TheextensionfortheproducedfileiscodeList.Theoutputshowssourcestatements(providedthattheappropriatesourceisavailable),followedbythecodeproducedbythosesourcestatements.AnexampleprocedurefromCodeListerImplis:wf ( xHDfv_, g/! "&d] B"%&)j,1B6x9D[ $v&*Z48yX  "@ ' -| 3a 8 > D V [ ! ' ,b 1 7 vS>yQmI vPFPNXLyL"%(+.147:=@|CrFiKP"%(+.147:=@|Crt GqxGG : %H*T-"/u577:=K?t EqzEE"k t CqC/CU u > q ;P /=(3 !h%|*-{14:Z<?HEH#t 9q99e $_'+-/68 wn!+[(G  #'D)- &j#O![W[_ \ S$I'*<-[u  q p e|"a'H),/57:%@-B~tCpDmpqHp  ;J Y&)w+ 3;78 ?E1G/ " 3SO= $'&,3"6 @rTVm$Inter-OfficeMemorandum3GetByte:PROC[pc:CARDINAL]RETURNS[BYTE]={Entrypoint:14,Framesize:111657B,E3536B:[167B]LINKB12B1660B,E3540B:[34B]PL1w:LONGPOINTERTOPrincOps.InstWord=codebase+pc/2;1660B,O3541B:[65B]LIN11661B,E3542B:[263B]SHIFT1661B,O3543B:[56B]LI01662B,E3544B:[10B]LL01662B,O3545B:[114B]RDB21B1663B,O3547B:[264B]DADD1664B,E3550B:[162B]SLDB6BRETURN[IFpcMOD2=0THENw.evenbyteELSEw.oddbyte];};1665B,E3552B:[11B]LL11665B,O3553B:[57B]LI11666B,E3554B:[260B]AND1666B,O3555B:[245B]JZNEB10B(3565B)1667B,O3557B:[21B]LLDB6B1670B,O3561B:[56B]LI01671B,E3562B:[153B]RSTRL0B1672B,E3564B:[204B]J6(3572B)1672B,O3565B:[21B]LLDB6B1673B,O3567B:[56B]LI01674B,E3570B:[153B]RSTRL1B1675B,E3572B:[343B]RETInstructions:21,Bytes:30ExportsListerThiscommandsliststheexportsofabcdfile,whichmaycontainmultiplemodules.TheextensionfortheproducedfileisexportsList.FGTListerThiscommandsliststhefinegraintableofasinglemodulebcdfile.TheextensionfortheproducedfileisfgtList.GlobalFramesListerThiscommandsliststheglobalframesofabcdfile,whichmaycontainmultiplemodules.TheextensionfortheproducedfileisglobalFramesList.RTBcdListerThiscommandsliststheruntimetypesinformationforabcdfile,whichmaycontainmultiplemodules.TheextensionfortheproducedfileisrtBcdList.ShortBcdListerwf ( xHDfu^v^p^N^vM^p^^v!G^p".^#^v(:^p(^)V^v+^,^.h\ i$[F=[F&[F.E[FY=Y&YWpWsWWLWveW(`*E0"2VMiVM&VMT=T&TRiR&RQU=QU&QUOiO&O.EONiN&NL\=L\&L\.EL\pJv+JpJJv6JpJ-JvtJpJ {Jv#J p*J+hJv-J I Gd=Gd&GdEiE&ED=D&DBkiBk&Bk.EBk1@i@&@.E@?i?&?=s==s&=s.E=s;=;&;1;:#i:#&:#.E:#8{i8{&8{6=6&6.E65*=5*&5*3 $u - q *g # #&d*x-2f7>PA.GR ( KltA(( q('(#R%( u %pq "  X7#M%&U*S/f2&58{>@Co y Ut y0 yq y y' u )q  x!@"#&)J-F085:n@Cp 2 )t~2.2q"2#2)"+- u  q  J! )j+,/2D6S9X>8C    t!t!q&(R-~/2; u 1TVm$Inter-OfficeMemorandum4Thiscommandsliststhecontentsofabcdfile,whichmaycontainmultiplemodules.TheextensionfortheproducedfileisbcdList.ThelistinghasslightlylessinformationthanthatproducedbyBcdLister.SymbolListerThiscommandsliststhebodiesofasinglemodulebcdfile.TheextensionfortheproducedfileissymbolList.UnboundListerThiscommandsliststheunboundexportsforabcdfile,whichmaycontainmultiplemodules.Theoutputgoestothecommandoutputstream,ratherthantoafile.Thiscommandisusefultodetermineifthereareexportedfileswithsomeoftheirentriesunbound.UsingListerThiscommandgeneratesaDIRECTORYclauseforasinglemodulebcdfile.TheextensionfortheproducedfileisusingList.Theresultsmaynotbeentirelycorrect,yetshouldbequiteclose(unfortunately,theinformationinthebcdfilemaybeambiguous).TheintentionisforpeopletodevelopmoduleswithoutusingUSINGclauses,thentousethiscommandtogeneratethoseclauses.WherethereareextranamesormissingnamesintheclausesthecompilerwillgeneratesufficientmessagestoallowrepairoftheUSINGclausesin(typically)asinglepass.wf ( xHDfq _/ j !F#&*-28 >bA7GR ] KltA]]q]]"%L*, 447Z:(@HBD u Z9 q V /=(3 !h%|*-{14:Z<?HEH#t UC q:UCUC; u Q q N +5$'(W+).2B5k:o@ F L]v# R%)&,K-/!2d5};=HA_C  KW M) ":%)u H q D @pDfDq##D'u)+P/u47;N>`DG/ C'tlC)CqCC #%',1F3g79<@) Ak k a. " +z.r4n58V<>D  ?p?r?q? v"%w+-r26;@TCF >8Lj"$w*:,2z 8>d@CG