ftp.barnyard.co.uk/2015.02.ftp.barnyard.co.uk.tar/ftp.barnyard.co.uk/cpm/walnut-creek-CDROM/MBUG/MBUG023.ARC/DASM16.HLP

Text File | 1979-12-31 | 11KB | 324 lines

Commands summary
General description of DASM
Command details
:Commands summary DASM v 1.6

┴  Attemp⌠ t∩ finΣ DB's
┬  BuilΣ symbo∞ table
├  Contro∞ table addition
─  Dum≡ memory, hex & ascii
┼  Return from last go
╞  FinΣ address
G  Go to another address
H  Display online help
╦  Kil∞ table entry/entries
╠  List source code
╧  Se⌠ origin
╨  Previous block list
╤  Quiet mode
╥  ReaΣ files
╙  Savσ files
V  View table entry/entries
 :  Symbol table addition
╗  Comment table addition
=  Relist
-  Relist starting 1 before
+  Relist starting 1 after
?  Display DASM status

:General description

Majo≥ feature≤ oµ DASM 1.6

1⌐ Automatiπ recognitioε oµ tex⌠ strings
2⌐ Automatiπ generatioε oµ symbo∞ table.
3⌐ Interactivσ creation-deletion-renaminτ oµ labels.
4⌐ Interactivσ partitioninτ oµ datß anΣ instructioε areas.
5⌐ Automatiπ generatioε oµ OR╟, EQUs and END of source file.
6⌐ Simplσ additioε oµ comment≤ wherσ appropriate.
7) Nested "visits" to other areas of code, with easy return.
8⌐ "Featureiti≤ rampartisó ...

DAS═ i≤ anothe≥ creatioε oµ RicharΣ (ZCPR⌐ Conε baseΣ upoε previou≤ effort≤ b∙ ì
WarΣ Christenseε anΣ Davσ Barker.

I⌠ i≤ aε interactivσ disassemble≥ fo≥ 808░ (TDL)¼ Z80¼ 8048¼ or 650▓ machinσ ì
code¼ dependinτ upoε whicΦ disassemble≥ modulσ i≤ used« It≤ purposσ i≤ t∩ ì
generatσ ß sourcσ file« Usuall∙ thσ sourcσ filσ produceΣ b∙ DAS═ caε bσ ì
assembleΣ t∩ reproducσ thσ origina∞ objec⌠ file¼ bu⌠ t∩ producσ ß ì
relocateable¼ wel∞ documenteΣ sourcσ filσ wil∞ requirσ ß bi⌠ morσ effor⌠ froφ ì
you.

A≤ ß genera∞ rule¼ thσ wa∙ t∩ usσ DAS═ i≤ t∩ read(R⌐ thσ relevan⌠ sourcσ file¼ ì
finΣ asciΘ strings(A)¼ symbols(B)¼ adΣ comment≤ etc« theε creatσ ß sourcσ filσ ì
(Sfilename.mac).
èDurinτ thσ disassembl∙ process¼ threσ table≤ arσ generated¼ fo≥ contro∞ ì
points¼ comment≤ anΣ symbols« Thesσ ma∙ bσ saveΣ anΣ loadeΣ a≤ threσ separatσ ì
type≤ oµ file¼ witΦ ß filenamσ yo⌡ specify¼ bu⌠ distinguisheΣ b∙ differen⌠ ì
extensions« Thesσ are:

1⌐ Thσ .CT╠ file« Thi≤ contain≤ addresse≤ a⌠ whicΦ thσ objec⌠ codσ change≤ ì
   type, for example when instructions change to datß o≥ table≤.

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.

Iµ ß filenamσ i≤ includeΣ iε thσ commanΣ line¼ DAS═ wil∞ tr∙ t∩ reaΣ iε thσ ì
specified COM file and the above three files.

:Command details

  notes
á =====

Whereve≥ ß he° valuσ i≤ required¼ yo⌡ ma∙ suppl∙ ß symbo∞ precedeΣ b∙ ß ì
period¼ i.e« ".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ó "Sfile.mac" 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σ ":ó 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║   Cnnnn,°   Se⌠ modσ t∩ ° unti∞ nex⌠ contro∞ entry.

Durinτ thσ listinτ process¼ thσ contro∞ 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σ works same a≤ DB)

┼ ╜ enΣ oµ disassembly

╚ ╜ D┬ (datß i≤ showε iε hex)

I = instructions

╙ ╜ D╙ (u≡ t∩ nex⌠ ct∞ entry)

╫ ╜ D╫ (attempt≤ label)

Seσ thσ "V"ie≈ anΣ "K"il∞ command≤ fo≥ viewinτ anΣ deletinτ contro∞ tablσ ì
entries.


Command║ ─ ¡ Dum≡ memory, both hex & ascii

 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µ 15░ (hex⌐ wil∞ fi⌠ neatly ont∩ ß 2┤ linσ screen.


Command: E - Return to previous disassembly address

Thi≤ commanΣ cause≤ ß returε froφ thσ las⌠ 'go'« Seσ ╟ commanΣ fo≥ ful∞ ì
descriptioε oµ go process«

èCommand║ ╞ ¡ FinΣ address

áSyntax║ F[nnnn][,ssss]

FinΣ an∙ referencσ t∩ addres≤ nnnn¼ ie« L─ A,(nnnn⌐ o≥ CAL╠ nnnn« Thσ addres≤ ì
t∩ star⌠ searchinτ froφ caε optionall∙ bσ specified« Iµ thσ finΣ i≤ t∩ bσ ì
repeated¼ thσ nnnε i≤ no⌠ necessary.

Command║ G ¡ Go to another address for disassembly

 Syntax║ [Q▌ G [ssss▌ [,eeee]á(Seσ "Ló commanΣ fo≥ syntax examples)

Thi≤ commanΣ work≤ jus⌠ likσ ╠ excep⌠ tha⌠ ß pointe≥ i≤ kep⌠ t∩ thσ addres≤ oµ
the area from which it is invoked. When you are finished at the new spot, the
╒ commanΣ return≤ t∩ thσ olΣ spot« U≡ t∩ 1░ level≤ oµ visit≤ arσ retained« An∙
more, and you lose the highest one each time.

Command: H - Help messages display

Command║ ╦ ¡ Kil∞ table entries

áSyntax║ K:[nnnn][,eeee]   symbols kill
         K;[nnnn][,eeee]   comments kill
         KC[nnnn][,eeee]   controls kill

Iµ n∩ value≤ arσ giveε afte≥ thσ ║ etc¼ theε thσ wholσ tablσ i≤ killed« A≤ ì
thi≤ caε bσ nasty¼ yo⌡ arσ prompteΣ t∩ confirm« Iµ onσ valuσ i≤ supplied¼ thσ ì
entr∙ a⌠ tha⌠ addres≤ i≤ deleteΣ froφ thσ table« Iµ ß seconΣ valuσ i≤ supplied,ì
al∞ entries iε thσ rangσ nnnn to eeee arσ deleted« Usefu∞ fo≥ gettinτ riΣ oµ ì
rubbisΦ.
á
Command║ ╠ ¡ List

áSyntax║ L[=nn][ssss][,eeee]

        á∞ Lis⌠ nex⌠ 20 lines
á        lsss≤  Lis⌠ 20 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∙ 14Φ o≥ 20dec)

Thi≤ commanΣ wil∞ no⌠ lis⌠ pas⌠ ß contro∞ 'eº entry


Command║ ╧ ¡ Se⌠ Origin

áSyntax║ O[nnnn]

╧ show≤ curren⌠ origiε value« Defaul⌠ i≤ 100H« Onnnε set≤ thσ basσ addres≤ oµ ì
thσ filσ beinτ disassembleΣ i≤ se⌠ t∩ nnnn« AssociateΣ pointer≤ arσ altereΣ t∩ ì
suit« DAS═ store≤ thi≤ addres≤ witΦ thσ .SY═ file¼ s∩ oncσ altereΣ anΣ saved¼ ì
there is no need for further action.

Command: P - List previous block of codeè
 Syntax  P

Thi≤ i≤ useΣ wheε yo⌡ wisΦ t∩ lis⌠ thσ codσ prio≥ t∩ thσ curren⌠ block¼ thu≤ ì
savinτ yo⌡ thσ troublσ oµ enterinτ Lnnnε wherσ nnnε i≤ somewherσ ofµ thσ to≡ ì
oµ thσ screen« Thσ listeΣ blocδ isn'⌠ alway≤ perfectl∙ adjacen⌠ t∩ thσ curren⌠ ì
block¼ becausσ thσ disassemble≥ can'⌠ worδ backwards¼ anΣ ha≤ t∩ makσ aε ì
intelligen⌠ gues≤ wherσ i⌠ shoulΣ star⌠ from.

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

Afte≥ ß CO═ filσ i≤ loaded¼ thσ tablσ area≤ arσ automaticall∙ allocateΣ t∩ ì
givσ maximuφ possiblσ table space« LengtΦ oµ table≤ ma∙ bσ altereΣ b∙ patchinτ ì
several 2-byte values near the start of DASM.COM - see DASM.MAC for details.


Command║ ╙ ¡ Savσ files

áSyntax║ S[filename.ext]

        áSfilename.CT╠  Savσ Contro∞ Table
        áSfilename.DO├  Savσ Comment≤ Table
        áSfilename.SY═  Savσ Symbo∞ Table
        áSfilename.AL╠  Savσ al∞ abovσ files
         ╙              Savσ al∞ above file≤ usinτ previou≤ filename

     [Q] Sfilename.MAC  ┴ filσ FILENAME.MA├ i≤ openeΣ oε thσ defaul⌠ drive« ì
ááááááááááááááááááááááááOR╟ statemen⌠ i≤ generated¼ a≤ arσ equate≤ fo≥ an∙ ì
áááááááááááááááááááááááásymbol≤ outsidσ thσ limit≤ oµ thσ objec⌠ code« Wheε ì
ááááááááááááááááááááááááfinished, an END statment is added.


Command║   V ¡ View table entries

áSyntax║ V:[nnnn][,eeee]   symbols view
         V;[nnnn][,eeee]   comments view
         VC[nnnn][,eeee]   controls view

Iµ n∩ value≤ arσ giveε afte≥ thσ ║ etc¼ theε thσ wholσ tablσ i≤ shown« Iµ onσ ìèvaluσ i≤ supplied¼ thσ entr∙ a⌠ tha⌠ addres≤ i≤ shown« Iµ ß seconΣ valuσ i≤ ì
supplied¼ al∞ entrie≤ iε thσ rangσ nnnε t∩ eeeσ arσ shown.


Command║ ╪ - EXit to warm boot

Control/C does the same.

Command║ : ¡ Add symbol to table

áSyntax║ :nnnn,name

Enter≤ symbo∞ "nameó int∩ symbo∞ tablσ fo≥ addres≤ nnnn« Iµ ß labe∞ oµ thσ ì
samσ namσ exist≤ a⌠ anothe≥ addres≤ theε yo⌡ arσ prompteΣ fo≥ whethe≥ t∩ kil∞ ì
that label.  Iµ ß symbo∞ alread∙ exist≤ a⌠ addres≤ nnnn theε it≤ namσ i≤ ì
displayeΣ a≤ "Labe∞ oldnamσ killed"«


Command║ ╗ ¡ Add comment to table, toggle symbol comments

 Syntax║ ;nnnn,[;][*]comment

Iµ thσ firs⌠ characte≥ oµ ß commen⌠ i≤ ";ó theε thσ commen⌠ wil∞ bσ listeΣ ì
afte≥ thσ opcodσ a⌠ thσ correspondinτ address« Iµ thσ firs⌠ characte≥ i≤ "*ó ì
theε thσ subsequen⌠ character≤ arσ listeΣ beforσ thσ opcode¼ whicΦ provide≤ ß ì
methoΣ oµ alterinτ thσ sourcσ code« I⌠ ma∙ hel≡ t∩ enΣ sucΦ ß commen⌠ witΦ ì
"<tab>;ó whicΦ turn≤ thσ actua∞ opcodσ int∩ ß comment« Iµ neithe≥ "*ó o≥ ";ó ì
arσ provided¼ thσ commen⌠ wil∞ bσ showε oε thσ linσ abovσ thσ opcode« An∙ ì
commen⌠ ma∙ includσ ß "\ó whicΦ wil∞ causσ ß ne≈ commen⌠ linσ t∩ bσ started.

        ;oε  Turε symbo∞ comment≤ on.

Wheε symbo∞ comment≤ arσ on¼ thσ actua∞ objec⌠ filσ addres≤ correspondinτ t∩ ì
eacΦ symbo∞ i≤ showε oε thσ samσ linσ a≤ thσ symbol¼ afte≥ ß ";".

        ;oµ  Turε symbo∞ comment≤ off.

This is the default situation.

Command:   =   Relist current block

Provide≤ ß quicδ wa∙ oµ relistinτ thσ curren⌠ blocδ afte≥ changinτ thing≤ ì
therein.


Command:  -   Relist starting at address 1 byte earlier

Provide≤ ß quicδ wa∙ t∩ checδ iµ thσ garbagσ yo⌡ arσ lookinτ a⌠ i≤ garbagσ ì
because somehow you have got out of sync with the object code.

Command:  +   Relist starting at address 1 byte later

See above remark on "-" command.