sim/arm/README.orig

   1 This is the README file for ARMulator version 1.0, an ARM6 instruction
   2 emulator.
   3
   4 Configuration:
   5         The armulator has one configuration option, the default endianness
   6         of the processor.  This can be changed by building with ENDIAN=BIGEND
   7         to produce a big-endian variant.  The debugger can also select the
   8         endianness at run-time.
   9
  10 Build instructions:
  11
  12         This program is known to compile using GCC 2.6.0 on a Sun4.  Other
  13         builds are untested.  It almost certainly will not work on non-32bit
  14         machines.
  15
  16         To build the program simply type make in the source directory,
  17         followed by "make install"
  18
  19 Using the emulator:
  20
  21         The emulator runs as a separate process, and communicates with a
  22         debugger via tcp.  To start the emulator type
  23                 armul <socknum>
  24         where socknum is any number between 1024 and 65535.  If the socket is
  25         already in use, armul will exit with an error.
  26
  27         This version of armul has been designed to work with gdb-4.13
  28         with the ARM/RDP/RDI extensions added (available separately).  To
  29         connect gdb to the ARMulator, start gdb and type
  30                 target arm <hostname>:<socknum>
  31         where hostname is the name of the machine on which the armulator
  32         is running, and socknum is the socket number specified when armul
  33         was started.
  34
  35 IMPORTANT:
  36
  37         This program is free software; you can redistribute it and/or modify
  38         it under the terms of the GNU General Public License as published by
  39         the Free Software Foundation; either version 2 of the License, or
  40         (at your option) any later version.
  41
  42         This program is distributed in the hope that it will be useful,
  43         but WITHOUT ANY WARRANTY; without even the implied warranty of
  44         MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.  See the
  45         GNU General Public License for more details.
  46
  47         You should have received a copy of the GNU General Public License
  48         along with this program; if not, write to the Free Software
  49         Foundation, Inc., 675 Mass Ave, Cambridge, MA 02139, USA.
  50
  51         Advanced RISC Machines welcomes bug reports for this package,
  52         but no undertaking can be made to provide support or reply to email.
  53         Bugs should be sent to:
  54                 armgnu@armltd.co.uk
  55
  56
  57
  58