chiark - git - mdw - ssr/blob - StraySrc/Hammer/sh/diss

   1 ;
   2 ; diss.s
   3 ;
   4 ; Superior Disassembly of ARM instructions
   5 ;
   6 ; © 1994-1998 Straylight
   7 ;
   8
   9 ;----- Licensing note -------------------------------------------------------
  10 ;
  11 ; This file is part of Straylight's Sledgehammer debugger.
  12 ;
  13 ; Sledgehammer is free software; you can redistribute it and/or modify
  14 ; it under the terms of the GNU General Public License as published by
  15 ; the Free Software Foundation; either version 2, or (at your option)
  16 ; any later version.
  17 ;
  18 ; Sledgehammer is distributed in the hope that it will be useful,
  19 ; but WITHOUT ANY WARRANTY; without even the implied warranty of
  20 ; MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.  See the
  21 ; GNU General Public License for more details.
  22 ;
  23 ; You should have received a copy of the GNU General Public License
  24 ; along with Sledgehammer.  If not, write to the Free Software Foundation,
  25 ; 59 Temple Place - Suite 330, Boston, MA 02111-1307, USA.
  26
  27 ;----- Overview -------------------------------------------------------------
  28 ;
  29 ; Functions provided:
  30 ;
  31 ;   diss_setOptions
  32 ;   diss_address
  33 ;   diss_disassemble
  34 ;   diss_regTable
  35 ;   diss_init
  36
  37 ; --- diss_setOptions ---
  38 ;
  39 ; On entry:     R0 == new options field
  40 ;
  41 ; On exit:      --
  42 ;
  43 ; Use:          Sets up the new display options for the disassembly
  44
  45                 IMPORT  diss_setOptions
  46
  47 ; --- diss_address ---
  48 ;
  49 ; On entry:     R0 == address to start disassembly
  50 ;
  51 ; On exit:      --
  52 ;
  53 ; Use:          Initialises the disassembly to start at the given address
  54
  55                 IMPORT  diss_address
  56
  57 ; --- diss_disassemble ---
  58 ;
  59 ; On entry:     R0 == address of the instruction
  60 ;
  61 ; On exit:      R0 == pointer to buffer containing disassembly of
  62 ;               next instruction
  63 ;
  64 ; Use:          Disassembles the instruction pointered to, and places
  65 ;               the resulting string in the returned buffer.
  66
  67                 IMPORT  diss_disassemble
  68
  69 ; --- diss_regTable ---
  70 ;
  71 ; On entry:     --
  72 ;
  73 ; On exit:      R0 == pointer to register table
  74 ;
  75 ; Use:          Returns a pointer to the register name table, so that the
  76 ;               assembler can get its grubby paws on it.
  77
  78                 IMPORT  diss_regTable
  79
  80 ; --- diss_init ---
  81 ;
  82 ; On entry:     R12 == pointer to workspace
  83 ;
  84 ; On exit:      --
  85 ;
  86 ; Use:          Initialises the disassembler segment nicely.
  87
  88                 IMPORT  diss_init
  89
  90 ;----- That's all, folks ----------------------------------------------------
  91
  92                 END