home *** CD-ROM | disk | FTP | other *** search
/ Oakland CPM Archive / oakcpm.iso / sigm / sigmv068.ark / ZESOURCE.DOC < prev   
Text File  |  1984-04-29  |  3KB  |  62 lines
  1.             ZESOURCE
  2.           disassembler for Z-80 programs
  3.         Version 2.0 by Dave Barker
  4.  
  5. Let me open this file with a note of appreciation to Ward Christensen
  6. who wrote RESOURCE for 8080 programs.  ZESOURCE is a modification to
  7. Ward's original program (CPMUG vol. 42) to give it the capability of
  8. disassembling Z-80 object into TDL mnemonic source files.  Thanks to
  9. Ward this must be the most powerful disassembler available for 8080/Z-80
  10. code.  (Note: ZESOURCE still runs on an 8080 machine)
  11.  
  12. A file called Z80TEST.COM was used to test ZSOURCE.  When Z80TEST.COM
  13. is disassembled it will result in what would be an alphabetic listing
  14. of all of the Z-80 opcodes if the mnemonics were Zilog's instead of
  15. TDL's.  This object file should agree exactly with the listings that 
  16. Zilog has in their 'Z-80 CPU Programming Reference Card' and in the
  17. back of 'Z-80 Assembly Language Programming Manual'.
  18.  
  19. It should be pointed out that ZSOURCE will generate TDL opcode mnemonics
  20. but not TDL pseudo-op mnemonics.  The pseudo-op mnemonics are the same
  21. as those generated by RESOURCE (ORG, DB, DW, DS, and EQU).  If one is
  22. using a TDL type of assembler it is a simple matter to use .OPSYN to
  23. equate ORG with .LOC, DB with .BYTE, etc.
  24.  
  25. The primary documentation for ZESOURCE is Ward's RESOURCE.DOC (CPMUG
  26. 42.19).  Listed below is a description of the enhancements added to
  27. ZESOURCE.COM:
  28.  
  29.     1.Disassembly to TDL mnemonics
  30.  
  31.     2.Typing 'Rfilename.ALL' will cause the .DOC, .SYM, and .CTL
  32.       files to all be read in for 'filename'.  If one of the files
  33.       is missing from the disk the read operation will abort. 
  34.       Note also that the 'Uxxxx' command must still be used prior 
  35.       to using 'R'.
  36.  
  37.     3.Typing 'Sfilename.ALL' will cause all three of the files
  38.       mentioned above to be saved.
  39.  
  40.     4.When the 'E' command is used to create a new symbol the existing
  41.       symbol at that address (if there is one) will be automatically
  42.       killed with a message sent to the console so stating.  If there
  43.       is more than one symbol at that address (impossible if the
  44.       .SYM file was created under ZESOURCE) only the first in the
  45.       table will be killed.
  46.  
  47.     5.Use of 'L' command in the format 'L=xx,addr' causes the new
  48.       default length, xx, to take effect immediately (this is a bug
  49.       in CPMUG 42.18).
  50.  
  51. As time and ambition are available it is planned to modify ZESOURCE to
  52. produce Zilog mnemonics.
  53.  
  54. Any questions, suggestions, or (ugh!) bugs?  If so:
  55.  
  56.                     Dave Barker
  57.                     2293 Ralston Ave.
  58.                     Simi Valley, CA 93063
  59.                     (805)-526-2438
  60.  
  61. Or leave a message on CP/M-Net (tm) at (805)-527-9321.
  62.