CP/M

home *** CD-ROM | disk | FTP | other *** search

/ CP/M / CPM_CDROM.iso / mbug / mbug002.arc / DASM.HLP < prev next >

Wrap

Text File | 1979-12-31 | 9KB | 362 lines

á Introductioε t∩ DASM áPrograφ operation áImportan⌠ notes áCommand║ ┴ ¡ Attemp⌠ t∩ finΣ DB's áCommand║ ┬ ¡ BuilΣ symbo∞ table áCommand║ ├ ¡ Contro∞ tablσ ì á modify/display áCommand║ ─ ¡ Dum≡ hex áCommand║ D╙¡ Dum≡ symbo∞ table áCommand║ ┼ ¡ Ente≥ label áCommand║ ╞ ¡ FinΣ address áCommand║ ╦ ¡ Kil∞ symbol áCommand║ ╠ ¡ List áCommand║ ╧ ¡ Se⌠ Origin áCommand║ ╨ ¡ Generatσ Prologue áCommand║ ╤ ¡ Quitσ mode áCommand║ ╥ ¡ ReaΣ files áCommand║ ╙ ¡ Savσ files áCommand║ ╒ ¡ Ummmmmmn... áCommand║ ╪ ¡ Purgσ symbo∞ ª contro∞ ì á tables áCommand║ ┌ ¡ Writσ enΣ oµ file áCommand║ ╗ ¡ Enter/displa∙ comment á Introduction á DAS═ i≤ anothe≥ creatioε oµ ì áRicharΣ (ZCPR⌐ Conε baseΣ upoε ì ápreviou≤ effort≤ b∙ WarΣ Christenseε ì áanΣ Davσ Barker. á Thi≤ prograφ i≤ aε interactivσ ì ádisassemble≥ fo≥ 808░ (TDL)¼ Z80¼ ì á8048¼ anΣ 650▓ machinσ code¼ ì ádependinτ upoε whicΦ disassemble≥ ì ámodulσ i≤ used. á Thσ genera∞ objec⌠ i≤ t∩ ì áregeneratσ ß sourcσ filσ fo≥ thσ ì áprograφ iε question« Durinτ thσ ì ádisassembl∙ process¼ threσ ì áintermediatσ file≤ arσ generateΣ iε ì áadditioε t∩ thσ .CO═ file« Thesσ are: á 1⌐ Thσ .CT╠ file« Thi≤ contain≤ ì áaddresse≤ a⌠ whicΦ datß o≥ table≤ arσ ì ástoreΣ rathe≥ thaε instructions. á 2⌐ Thσ .DO├ file« Thi≤ contain≤ ì ácomment≤ whicΦ yo⌡ enter¼ witΦ thσ ì áaddres≤ a⌠ whicΦ the∙ appear. á 3⌐ Thσ .SY═ file« Thi≤ contain≤ ß ì ális⌠ oµ label≤ anΣ thei≥ ì ácorrespondinτ addresses. á Thσ eventua∞ aiφ i≤ t∩ producσ ß ì á.AS═ filσ whicΦ caε bσ reassembled« ì áUsuall∙ thσ AS═ filσ produceΣ b∙ DAS═ ìèácaε bσ assembleΣ t∩ reproducσ thσ ì áorigina∞ CO═ file¼ bu⌠ t∩ producσ ß ì árelocateable¼ wel∞ documenteΣ sourcσ ì áfilσ wil∞ requirσ ß bi⌠ morσ effor⌠ ì áfroφ you. á Majo≥ feature≤ oµ DASM: á1⌐ Automatiπ recognitioε oµ tex⌠ ì á strings á2⌐ Automatiπ genaratioε oµ symbo∞ ì á table. á3⌐ Interactivσ creatioε-deletioε-ì á renaminτ oµ labels. á4⌐ Interactivσ partitioninτ oµ datß ì á anΣ instructioε areas. á5⌐ Automatiπ generatioε oµ prologuσ ì á t∩ source« (OR╟ anΣ EQUs) á6⌐ Simplσ additioε oµ comment≤ wherσ ì á appropriate. á7⌐ "Featureiti≤ rampartisó ... á Prograφ operation áImportan⌠ notes á=============== á Whereve≥ ß he° valuσ i≤ required¼ ì áyo⌡ ma∙ suppl∙ ß symbo∞ precedeΣ b∙ ß ì áperiod¼ ie« ".symboló insteaΣ oµ ì ánnnn. á An∙ commanΣ ma∙ bσ precedeΣ b∙ ì áthσ "Q"uie⌠ prefi° whicΦ wil∞ sto≡ i⌠ ì áfroφ printinτ t∩ thσ screen« Thi≤ ì áfeaturσ i≤ mainl∙ intendeΣ t∩ speeΣ ì áu≡ thσ operatioε oµ thσ "Aó anΣ "Bó ì ácommands. áCommand║ ┴ ¡ Attemp⌠ t∩ finΣ DB's áSyntax║ [Q▌ ┴ [ssss▌ [,eeee] á(Seσ "Ló commanΣ fo≥ examples) á List≤ t∩ thσ screeε froφ sss≤ t∩ ì áeeeσ a≤ fo≥ "L"¼ bu⌠ iµ an∙ string≤ ì áoµ ╕ o≥ morσ printablσ ASCI╔ ì ácharacter≤ arσ encountered¼ theε the∙ ì áarσ markeΣ a≤ datß iε thσ contro∞ ì átablσ b∙ placinτ ß "Bó entr∙ a⌠ thσ ì ástart¼ anΣ aε "Ió entr∙ afte≥ thσ ì áend« Seσ thσ "Có commanΣ fo≥ morσ ì áinformatioε oε contro∞ entries. áCommand║ ┬ ¡ BuilΣ symbo∞ table èáSynta° ║ [Q▌ ┬ [ssss▌ [,eeee] á List≤ t∩ thσ screeε froφ sss≤ t∩ ì áeeeσ a≤ fo≥ "L"¼ bu⌠ ever∙ ▓ bytσ ì áoperanΣ encountereΣ i≤ placeΣ int∩ ì áthσ symbo∞ tablσ a≤ Lxxxx¼ wherσ thσ ì ávaluσ oµ thσ operanΣ i≤ xxx° iε hex« ì áSeσ thσ "Eó commanΣ t∩ ente≥ ne≈ ì álabel≤ o≥ renamσ curren⌠ ones¼ anΣ ì áthσ "Kó commanΣ t∩ kil∞ label≤ ì áalread∙ iε thσ table. áCommand║ ├ ¡ Contro∞ tablσ ì á modify/display áSyntax║ ├ Dum≡ contro∞ table. á Cnnnε Dum≡ contro∞ tablσ ì ástartinτ froφ nnnn. á Cnnnn,° Se⌠ modσ t∩ ° ì á unti∞ nex⌠ contro∞ ejtry. á Thσ firs⌠ tw∩ form≤ oµ thi≤ ì ácommanΣ allo≈ yo⌡ t∩ examinσ thσ ì ácontro∞ table¼ thσ thirΣ forφ i≤ useΣ ì át∩ ente≥ ne≈ entrie≤ int∩ thσ table« ì áDurinτ thσ listinτ process¼ thi≤ ì átablσ define≤ wherσ instruction≤ o≥ ì ádatß arσ t∩ bσ listed« EacΦ entr∙ iε ì áthσ tablσ define≤ thσ modσ t∩ bσ useΣ ì áunti∞ thσ nex⌠ contro∞ i≤ reached« ì áOfteε thσ majorit∙ oµ thσ codσ wil∞ ì ábσ iε "I"nstructioε mode¼ anΣ datß ì áarea≤ wil∞ bσ markeΣ b∙ ß "Bó entr∙ ì áa⌠ thσ star⌠ address¼ anΣ aε "Ió ì áentr∙ a⌠ thσ nex⌠ addres≤ afte≥ thσ ì áend. á EacΦ entr∙ cause≤ ß "contro∞ ì ábreak"¼ meaninτ tha⌠ thσ ne≈ modσ ì ástart≤ oε anothe≥ line¼ s∩ b∙ ì áenterinτ multiplσ "Bó entrie≤ yo⌡ caε ì ámake áD┬ 'TYPESAVEDI╥ ER┴ RE╬ ' áappea≥ as áD┬ 'TYPE' áD┬ 'SAVE' áD┬ 'DI╥ ' áD┬ 'ER┴ ' áD┬ 'RE╬ ' áPossiblσ mode≤ are: á┬ ╜ D┬ (show≤ printablσ ASCI╔ betweeε ìèáquotes¼ otherwisσ hex) á├ ╜ D├ (show≤ tex⌠ betweeε quote≤ iµ ì ápossible¼ las⌠ characte≥ wil∞ havσ hΘ ì ábi⌠ set¼ otherwisσ print≤ a≤ ß DB) á─ ╜ D┬ (datß i≤ showε iε decimal) á┼ ╜ enΣ oµ disassembly á╚ ╜ D┬ (datß i≤ showε iε hex) áI = instructions áK = kill this ctl entry á╙ ╜ D╙ (u≡ t∩ nex⌠ ct∞ entry) á╫ ╜ D╫ (attempt≤ label) áCommand║ ─ ¡ Dum≡ hex áSyntax║ ─ [=nε [,]▌ [ssss▌ [,eeee] áDsss≤ Dump≤ 80╚ froφ sss≤ ì áon. áDssss,eeeσ Dump≤ froφ sss≤ ì áthrougΦ t∩ eeee. á áD,eeeσ Dump≤ froφ curren⌠ locatioε ì áthrougΦ t∩ eeee. á─ Dump≤ 80╚ froφ curren⌠ location. áD=nε Se⌠ defaul⌠ dum≡ sizσ t∩ nn áD=nn,ssss Set default size to nn then dump from ssss. á┴ dum≡ sizσ oµ 10░ (hex⌐ wil∞ fi⌠ ì áeasil∙ ont∩ ß 2┤ linσ screen. áCommand║ D╙¡ Dum≡ symbo∞ table áSyntax║ D╙ [.symbol] áD╙ Dump≤ symbo∞ tablσ iε ì áalphabetica∞ order. áDS.symbo∞ Dump≤ tablσ startinτ a⌠ ì ásymbol. áCommand║ ┼ ¡ Ente≥ label áSyntax║ Ennnn,.symbolè á Ente≥ symbo∞ ".symboló int∩ symbo∞ ì átablσ fo≥ addres≤ nnnn« Iµ ß symbo∞ ì áalread∙ exis⌠ a⌠ tha⌠ addres≤ theε ì áit≤ namσ i≤ displayeΣ a≤ "Labe∞ ì á.symbo∞ killed"« Iµ ß labe∞ oµ thσ ì ásamσ namσ exist≤ a⌠ anothe≥ addres≤ ì átheε i⌠ i≤ deleted¼ n∩ messagσ i≤ ì ádisplayeΣ (yet)« áCommand║ ╞ ¡ FinΣ address áSyntax║ Fnnnn[,ssss] áFinΣ an∙ referencσ t∩ addres≤ nnnn¼ ì áie« L─ A,(nnnn⌐ or áCAL╠ nnnn« Thσ addres≤ t∩ star⌠ ì ásearchinτ froφ caε optionall∙ bσ ì áspecified. áCommand║ ╦ ¡ Kil∞ symbol áSyntax║ K.symbol áThσ nameΣ symbo∞ i≤ deleteΣ froφ thσ ì ásymbo∞ table. á áCommand║ ╠ ¡ List áSyntax║ L[=nn][ssss][,eeee] á∞ Lis⌠ nex⌠ 2▓ lines á álsss≤ Lis⌠ 2▓ line≤ froφ ssss á ál,eeeσ Lis⌠ froφ curren⌠ pπ t∩ eeee álssss,eeeσ Lis⌠ froφ sss≤ t∩ eeee ál=nε Changσ defaul⌠ numbe≥ oµ line≤ ì áprinteΣ t∩ nε (nε i≤ iε he° anΣ i≤ ì ánominall∙ 16Φ o≥ 22dec) áThi≤ commanΣ wil∞ no⌠ lis⌠ pas⌠ ß ì ácontro∞ 'eº entry áCommand║ ╧ ¡ Se⌠ Origin áSyntax║ Onnnn á Thσ basσ addres≤ oµ thσ filσ ì ábeinτ disassembleΣ i≤ se⌠ t∩ nnnn« ì áThi≤ iε turε set≤ ß ne≈ valuσ fo≥ thσ ì áoffset¼ whicΦ i≤ displayeΣ afte≥ ìèágivinτ thi≤ command« Thσ curren⌠ ì áorigiε i≤ displayeΣ iε thσ '?º lis⌠ ì áa≤ 'CO═ START'. áCommand║ ╨ ¡ Generatσ Prologue áSyntax║ Pssss,eeee á Thi≤ commanΣ i≤ useΣ whilσ ì álistinτ int∩ thσ .MA├ file« I⌠ ì ágeneratσ aε OR╟ sss≤ statement¼ theε ì áEQUate≤ fo≥ al∞ symbol≤ whicΦ arσ ì áoutsidσ thσ rangσ sss≤ t∩ eeee. áCommand║ ╤ ¡ Quie⌠ mode áSyntax║ Qcommand á Placinτ 'Qº beforσ an∙ othe≥ ì ácommanΣ wil∞ disablσ al∞ screeε ì áoutpu⌠ fo≥ thσ duratioε oµ tha⌠ ì ácommand« Thσ maiε applicatioε oµ thi≤ ì áfeaturσ i≤ t∩ speeΣ u≡ thσ 'Aº anΣ ì á'Bº commands áCommand║ ╥ ¡ ReaΣ files áSyntax║ Rfilename.ext áRfilename.CO═ ReaΣ objec⌠ file áRfilename.CT╠ ReaΣ Contro∞ Table áRfilename.DO├ ReaΣ Comment≤ Table áRfilename.SY═ ReaΣ Symbo∞ Table áRfilename.AL╠ ReaΣ COM¼ CTL¼ DOC¼ ª ì áSY═ files áCommand║ ╙ ¡ Savσ files áSyntax║ S[filename.ext] áSfilename.CT╠ Savσ Contro∞ Table áSfilename.DO├ Savσ Comment≤ Table áSfilename.SY═ Savσ Symbo∞ Table áSfilename.MA├ Opeε MA├ filσ anΣ ì áenablσ outpu⌠ t∩ it áSfilename.AL╠ Savσ al∞ abovσ files èá╙ Savσ al∞ file≤ usinτ previou≤ ì áfilename áCommand║ ╒ ¡ Ummmmmmn... áSyntax║ Unnnn áGoΣ know≤ wha⌠ thi≤ does á áCommand║ ╪ ¡ Purgσ symbo∞ ª contro∞ ì á tables áCommand║ ┌ ¡ Writσ enΣ oµ file áCommand║ ╗ ¡ Enter/displa∙ comment áSyntax║ ;[nnnn][,[;][comment]] á╗ Lis⌠ comment≤ table. á;nnnε Lis⌠ commen⌠ a⌠ addres≤ nnnn. á;nnnn¼ Deletσ commen⌠ a⌠ adres≤ ì ánnnn. á;addr,commen⌠ Ente≥ commen⌠ a⌠ ì áaddres≤ nnnε t∩ lis⌠ oε linσ before. á;addr,;commen⌠ Ente≥ commen⌠ a⌠ ì áaddres≤ nnnε t∩ lis⌠ oε samσ line. á;oε Turε symbo∞ comment≤ on. á;oµ Turε symbo∞ comment≤ off.├ ReaΣ Comment≤ Table áRfilename.SY═ ReaΣ Symbo∞ Table áRfilename.AL╠ Re