home *** CD-ROM | disk | FTP | other *** search
/ Geek Gadgets 1 / ADE-1.bin / ade-dist / gdb-4.16-base.tgz / gdb-4.16-base.tar / fsf / gdb / sim / arm / README.orig < prev    next >
Text File  |  1995-05-24  |  2KB  |  58 lines
  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.