home *** CD-ROM | disk | FTP | other *** search
/ Oakland CPM Archive / oakcpm.iso / sigm / sigmv023.ark / DIS.DOC < prev    next >
Encoding:
Text File  |  1984-04-29  |  4.2 KB  |  130 lines
  1. Z-80/8080 TDL BASED DISASSEMBLER
  2.  
  3. The program will disassemble any Z-80 or 8080 object program
  4. and reconstruct a TDL assembly format compatible source file
  5. on the console or disk. The object file resides in memory at
  6. any location up to the starting address of the disassembler.
  7. Binary files may  be loaded  at any time and  utilities are
  8. provided to manipulate and examine loaded files. Disassembly
  9. may be effected  in multi-segment passes,  with each segment
  10. starting at any location  and ending at  any location within
  11. the range  0000-ORIGIN.  The latter  may or  may not  be the
  12. execution locations   of   the  object   program.  For  each
  13. segment/pass, run-time options may be specified as follows:
  14.  
  15.     [a] Use the  symbol table  for the label
  16.     field and address field (see option g)
  17.  
  18.     [b] Do not  initialize the  symbol table
  19.     nor the disk  source file  (see option i
  20.     for  exception).  Use   this  option  to
  21.     append entries to  the symbol  table and
  22.     new lines to the disk file.
  23.  
  24.     [c] Build symbol  table using  the Lxxxx
  25.     format    for     extended     reference
  26.     instructions. (see options  a and  g for
  27.     execptions)
  28.  
  29.     [d] Generate labels Lxxxx instead of the
  30.     default HEX values xxxxH.
  31.  
  32.     [e] Generate ASCII  characters in quotes
  33.     depending on option  f.  If option f  is
  34.     true,  all  printable  ASCII  characters
  35.     will be placed  in quotes  following the
  36.     .Byte pseudo  opcode.  If  option  f  is
  37.     false, all two operand instructions with
  38.     data will  be followed  as a  comment by
  39.     the quoted ASCII character corresponding
  40.     to the data.
  41.  
  42.     [f] Generate .BYTE pseudo opcode instead
  43.     of  default  assembly   code.  Use  this
  44.     option   for   proper   disassembly   of
  45.     segments consisting of  tables and ASCII
  46.     strings.
  47.  
  48.     [g] Normally the operands  of LXI instr.
  49.     are treated as  2 byte  data rather than
  50.     as an address.  Use this  option to over
  51.     ride this  default.  If  this  option is
  52.     selected, the  2  byte  operand  of  LXI
  53.     instructions will be  used to  build the
  54.     symbol table and  if already  there, the
  55.     symbol entries will be  used in place of
  56.     the default HEX format.
  57.  
  58.     [h] Write/Build  a  reconstructed SOURCE
  59.     FILE in disk and  in a compatible format
  60.     ready for re-assembly  by the  TDL MACRO
  61.     RELOCATING ASSEMBLER. If the source file
  62.     is new, you  will  be  prompted  for the
  63.     filename.
  64.  
  65.     [i] Restart the disk  file regardless of
  66.     option b. Use  this option  to over ride
  67.     the APPEND mode  without  affect  on the
  68.     specified action on the symbol table.
  69.  
  70.     [j] Close the source  file at the normal
  71.     termination of this segment/pass.
  72.  
  73.     [k] Suppress  console  output.  Use this
  74.     option  during  symbol   table  building
  75.     pasess to expedite disassembly.
  76.  
  77. ALL OPTION ARE SELECTED  WITH THE 'O'   COMMAND. ALL OPTIONS
  78. ARE INITIALIZED OFF. EACH TIME THE 'O'  COMMAND IS USED, ALL
  79. DESIRED OPTIONS MUST  BE SELECTED  SINCE THE  COMMAND RESETS
  80. EACH OPTION.
  81.  
  82. The  following   describes   the   command   mode   of   the
  83. disassembler.  All line   editing   features   of   CPM  are
  84. available in the command  mode except Control-C.  DO NOT USE
  85. CONTROL-C TO RETURN TO CPM.
  86.  
  87. RUBOUT        delete and echo the last character typed
  88.  
  89. ctl-U        delete entire line
  90.  
  91. ctl-X        (same as ctl-U)
  92.  
  93. ctl-R        retype current line
  94.  
  95. ctl-E        physical end of line
  96.  
  97. ctl-S        stop the console output temporalily
  98.  
  99. D aaaa,bbbb    Disassemble memory from start address aaaa to
  100.         end address bbbb
  101.  
  102. R drive:file    Read a binary file into memory. All files must
  103.         have a 'COM' extension. Files are loaded at
  104.         start address 100H and the length of the file
  105.         will be displayed at the console.
  106.  
  107. O a,b,c,...    Set runtime options. All options are reset
  108.         with this command and selectively set.
  109.  
  110. Q        Quit session and return to CPM. The number of
  111.         current symbol table entries is displayed.
  112.  
  113. M aaaa,bbbb,cccc    Move memory starting at aaaa and 
  114.             ending at bbbb address cccc.
  115.  
  116. H aaaa,bbbb    Hex math. The sum and difference will be
  117.         displayed.
  118.  
  119. S aaaa,bbbb    Show memory in HEX.
  120.  
  121. T aaaa,bbbb    Type memory in ASCII.
  122.  
  123. C        Close source file. Use this command when write
  124.         errors occur or end of medium.
  125.  
  126.     ---ALL PARAMETERS ARE IN HEX ---
  127.  
  128. AUTHOR: Timothy Mark Burke
  129. DATE:   October, 1979
  130.