d0ac1c4488
When trying to run the update-gnulib.sh script in gdb, I get this: Error: Wrong automake version (Unescaped left brace in regex is deprecated, passed through in regex; marked by <-- HERE in m/\${ <-- HERE ([^ =:+{}]+)}/ at /opt/automake/1.11.1/bin/automake line 4113.), we need 1.11.1. Aborting. Apparently, it's an issue with a regex in automake that triggers a warning starting with Perl 5.22. It has been fixed in automake 1.15.1. So I think it's a good excuse to bump the versions of autoconf and automake used in the gnulib import. And to avoid requiring multiple builds of autoconf/automake, it was suggested that we bump the required version of those tools for all binutils-gdb. For autoconf, the 2.69 version is universally available, so it's an easy choice. For automake, different distros and distro versions have different automake versions. But 1.15.1 seems to be the most readily available as a package. In any case, it's easy to build it from source. I removed the version checks from AUTOMAKE_OPTIONS and AC_PREREQ, because I don't think they are useful in our case. They only specify a lower bound for the acceptable version of automake/autoconf. That's useful if you let the user choose the version of the tool they want to use, but want to set a minimum version (because you use a feature that was introduced in that version). In our case, we force people to use a specific version anyway. For the autoconf version, we have the check in config/override.m4 that enforces the version we want. It will be one less thing to update next time we change autotools version. I hit a few categories of problems that required some changes. They are described below along with the chosen solutions. Problem 1: configure.ac:17: warning: AM_INIT_AUTOMAKE: two- and three-arguments forms are deprecated. For more info, see: configure.ac:17: http://www.gnu.org/software/automake/manual/automake.html#Modernize-AM_005fINIT_005fAUTOMAKE-invocation Solution 1: Adjust the code based on the example at that URL. Problem 2 (in zlib/): Makefile.am: error: required file './INSTALL' not found Makefile.am: 'automake --add-missing' can install 'INSTALL' Makefile.am: error: required file './NEWS' not found Makefile.am: error: required file './AUTHORS' not found Makefile.am: error: required file './COPYING' not found Makefile.am: 'automake --add-missing' can install 'COPYING' Solution 2: Add the foreign option to AUTOMAKE_OPTIONS. Problem 3: doc/Makefile.am:20: error: support for Cygnus-style trees has been removed Solution 3: Remove the cygnus options. Problem 4: Makefile.am:656: warning: 'INCLUDES' is the old name for 'AM_CPPFLAGS' (or '*_CPPFLAGS') Solution 4: Rename "INCLUDES = " to "AM_CPPFLAGS += " (because AM_CPPFLAGS is already defined earlier). Problem 5: doc/Makefile.am:71: warning: suffix '.texinfo' for Texinfo files is discouraged; use '.texi' instead doc/Makefile.am: warning: Oops! doc/Makefile.am: It appears this file (or files included by it) are triggering doc/Makefile.am: an undocumented, soon-to-be-removed automake hack. doc/Makefile.am: Future automake versions will no longer place in the builddir doc/Makefile.am: (rather than in the srcdir) the generated '.info' files that doc/Makefile.am: appear to be cleaned, by e.g. being listed in CLEANFILES or doc/Makefile.am: DISTCLEANFILES. doc/Makefile.am: If you want your '.info' files to be placed in the builddir doc/Makefile.am: rather than in the srcdir, you have to use the shiny new doc/Makefile.am: 'info-in-builddir' automake option. Solution 5: Rename .texinfo files to .texi. Problem 6: doc/Makefile.am: warning: Oops! doc/Makefile.am: It appears this file (or files included by it) are triggering doc/Makefile.am: an undocumented, soon-to-be-removed automake hack. doc/Makefile.am: Future automake versions will no longer place in the builddir doc/Makefile.am: (rather than in the srcdir) the generated '.info' files that doc/Makefile.am: appear to be cleaned, by e.g. being listed in CLEANFILES or doc/Makefile.am: DISTCLEANFILES. doc/Makefile.am: If you want your '.info' files to be placed in the builddir doc/Makefile.am: rather than in the srcdir, you have to use the shiny new doc/Makefile.am: 'info-in-builddir' automake option. Solution 6: Remove the hack at the bottom of doc/Makefile.am and use the info-in-builddir automake option. Problem 7: doc/Makefile.am:35: error: required file '../texinfo.tex' not found doc/Makefile.am:35: 'automake --add-missing' can install 'texinfo.tex' Solution 7: Use the no-texinfo.tex automake option. We also have one in texinfo/texinfo.tex, not sure if we should point to that, or move it (or a newer version of it added with automake --add-missing) to top-level. Problem 8: Makefile.am:131: warning: source file 'config/tc-aarch64.c' is in a subdirectory, Makefile.am:131: but option 'subdir-objects' is disabled automake: warning: possible forward-incompatibility. automake: At least a source file is in a subdirectory, but the 'subdir-objects' automake: automake option hasn't been enabled. For now, the corresponding output automake: object file(s) will be placed in the top-level directory. However, automake: this behaviour will change in future Automake versions: they will automake: unconditionally cause object files to be placed in the same subdirectory automake: of the corresponding sources. automake: You are advised to start using 'subdir-objects' option throughout your automake: project, to avoid future incompatibilities. Solution 8: Use subdir-objects, that means adjusting references to some .o that will now be in config/. Problem 9: configure.ac:375: warning: AC_LANG_CONFTEST: no AC_LANG_SOURCE call detected in body ../../lib/autoconf/lang.m4:193: AC_LANG_CONFTEST is expanded from... ../../lib/autoconf/general.m4:2601: _AC_COMPILE_IFELSE is expanded from... ../../lib/autoconf/general.m4:2617: AC_COMPILE_IFELSE is expanded from... ../../lib/m4sugar/m4sh.m4:639: AS_IF is expanded from... ../../lib/autoconf/general.m4:2042: AC_CACHE_VAL is expanded from... ../../lib/autoconf/general.m4:2063: AC_CACHE_CHECK is expanded from... configure.ac:375: the top level Solution 9: Use AC_LANG_SOURCE, or use proper quoting. Problem 10 (in intl/): configure.ac:7: warning: AC_COMPILE_IFELSE was called before AC_USE_SYSTEM_EXTENSIONS /usr/share/aclocal/threadlib.m4:36: gl_THREADLIB_EARLY_BODY is expanded from... /usr/share/aclocal/threadlib.m4:29: gl_THREADLIB_EARLY is expanded from... /usr/share/aclocal/threadlib.m4:318: gl_THREADLIB is expanded from... /usr/share/aclocal/lock.m4:9: gl_LOCK is expanded from... /usr/share/aclocal/intl.m4:211: gt_INTL_SUBDIR_CORE is expanded from... /usr/share/aclocal/intl.m4:25: AM_INTL_SUBDIR is expanded from... /usr/share/aclocal/gettext.m4:57: AM_GNU_GETTEXT is expanded from... configure.ac:7: the top level Solution 10: Add AC_USE_SYSTEM_EXTENSIONS in configure.ac. ChangeLog: * libtool.m4: Use AC_LANG_SOURCE. * configure.ac: Remove AC_PREREQ, use AC_LANG_SOURCE. * README-maintainer-mode: Update version requirements. * ar-lib: New file. * test-driver: New file. * configure: Re-generate. bfd/ChangeLog: * Makefile.am (AUTOMAKE_OPTIONS): Remove 1.11. (INCLUDES): Rename to ... (AM_CPPFLAGS): ... this. * configure.ac: Remove AC_PREREQ. * doc/Makefile.am (AUTOMAKE_OPTIONS): Remove 1.9, cygnus, add info-in-builddir no-texinfo.tex. (info_TEXINFOS): Rename bfd.texinfo to bfd.texi. * doc/bfd.texinfo: Rename to ... * doc/bfd.texi: ... this. * Makefile.in: Re-generate. * aclocal.m4: Re-generate. * config.in: Re-generate. * configure: Re-generate. * doc/Makefile.in: Re-generate. binutils/ChangeLog: * configure.ac: Remove AC_PREREQ. * doc/Makefile.am (AUTOMAKE_OPTIONS): Remove cygnus, add info-in-builddir no-texinfo.tex. * Makefile.in: Re-generate. * aclocal.m4: Re-generate. * config.in: Re-generate. * configure: Re-generate. * doc/Makefile.in: Re-generate. config/ChangeLog: * override.m4 (_GCC_AUTOCONF_VERSION): Bump from 2.64 to 2.69. etc/ChangeLog: * configure.in: Remove AC_PREREQ. * configure: Re-generate. gas/ChangeLog: * Makefile.am (AUTOMAKE_OPTIONS): Remove 1.11, add subdir-objects. (TARG_CPU_O, OBJ_FORMAT_O, ATOF_TARG_O): Add config/ prefix. * configure.ac (TARG_CPU_O, OBJ_FORMAT_O, ATOF_TARG_O, emfiles, extra_objects): Add config/ prefix. * doc/as.texinfo: Rename to... * doc/as.texi: ... this. * doc/Makefile.am: Rename as.texinfo to as.texi throughout. Remove DISTCLEANFILES hack. (AUTOMAKE_OPTIONS): Remove 1.8, cygnus, add no-texinfo.tex and info-in-builddir. * Makefile.in: Re-generate. * aclocal.m4: Re-generate. * config.in: Re-generate. * configure: Re-generate. * doc/Makefile.in: Re-generate. gdb/ChangeLog: * common/common-defs.h (PACKAGE_NAME, PACKAGE_VERSION, PACKAGE_STRING, PACKAGE_TARNAME): Undefine. * configure.ac: Remove AC_PREREQ, add missing quoting. * gnulib/configure.ac: Modernize usage of AC_INIT/AM_INIT_AUTOMAKE. Remove AC_PREREQ. * gnulib/update-gnulib.sh (AUTOCONF_VERSION): Bump to 2.69. (AUTOMAKE_VERSION): Bump to 1.15.1. * configure: Re-generate. * config.in: Re-generate. * aclocal.m4: Re-generate. * gnulib/aclocal.m4: Re-generate. * gnulib/config.in: Re-generate. * gnulib/configure: Re-generate. * gnulib/import/Makefile.in: Re-generate. gdb/gdbserver/ChangeLog: * configure.ac: Remove AC_PREREQ, add missing quoting. * configure: Re-generate. * config.in: Re-generate. * aclocal.m4: Re-generate. gdb/testsuite/ChangeLog: * configure.ac: Remove AC_PREREQ. * configure: Re-generate. gold/ChangeLog: * configure.ac: Remove AC_PREREQ, add missing quoting and usage of AC_LANG_SOURCE. * Makefile.in: Re-generate. * aclocal.m4: Re-generate. * configure: Re-generate. * testsuite/Makefile.in: Re-generate. gprof/ChangeLog: * configure.ac: Remove AC_PREREQ. * Makefile.am: Remove DISTCLEANFILES hack. (AUTOMAKE_OPTIONS): Remove 1.11, add info-in-builddir. * Makefile.in: Re-generate. * aclocal.m4: Re-generate. * configure: Re-generate. * gconfig.in: Re-generate. intl/ChangeLog: * configure.ac: Add AC_USE_SYSTEM_EXTENSIONS, remove AC_PREREQ. * configure: Re-generate. * config.h.in: Re-generate. * aclocal.m4: Re-generate. ld/ChangeLog: * configure.ac: Remove AC_PREREQ. * Makefile.am: Remove DISTCLEANFILES hack, rename ld.texinfo to ld.texi, ldint.texinfo to ldint.texi throughout. (AUTOMAKE_OPTIONS): Add info-in-builddir. * README: Rename ld.texinfo to ld.texi, ldint.texinfo to ldint.texi throughout. * gen-doc.texi: Likewise. * h8-doc.texi: Likewise. * ld.texinfo: Rename to ... * ld.texi: ... this. * ldint.texinfo: Rename to ... * ldint.texi: ... this. * Makefile.in: Re-generate. * aclocal.m4: Re-generate. * config.in: Re-generate. * configure: Re-generate. libdecnumber/ChangeLog: * configure.ac: Remove AC_PREREQ. * configure: Re-generate. * aclocal.m4. libiberty/ChangeLog: * configure.ac: Remove AC_PREREQ. * configure: Re-generate. * config.in: Re-generate. opcodes/ChangeLog: * Makefile.am (AUTOMAKE_OPTIONS): Remove 1.11. * configure.ac: Remove AC_PREREQ. * Makefile.in: Re-generate. * aclocal.m4: Re-generate. * configure: Re-generate. readline/ChangeLog.gdb: * configure: Re-generate. * examples/rlfe/configure: Re-generate. sim/ChangeLog: * All configure.ac: Remove AC_PREREQ. * All configure: Re-generate. zlib/ChangeLog.bin-gdb: * configure.ac: Modernize AC_INIT call, remove AC_PREREQ. * Makefile.am (AUTOMAKE_OPTIONS): Remove 1.8, cygnus, add foreign. * Makefile.in: Re-generate. * aclocal.m4: Re-generate. * configure: Re-generate. |
||
---|---|---|
.. | ||
ChangeLog | ||
Makefile.in | ||
NEWS | ||
README.erc32 | ||
README.gdb | ||
README.sis | ||
aclocal.m4 | ||
config.in | ||
configure | ||
configure.ac | ||
erc32.c | ||
exec.c | ||
float.c | ||
func.c | ||
help.c | ||
interf.c | ||
sis.c | ||
sis.h | ||
startsim |
README.sis
SIS - Sparc Instruction Simulator README file (v2.0, 05-02-1996) ------------------------------------------------------------------- 1. Introduction The SIS is a SPARC V7 architecture simulator. It consist of two parts, the simulator core and a user defined memory module. The simulator core executes the instructions while the memory module emulates memory and peripherals. 2. Usage The simulator is started as follows: sis [-uart1 uart_device1] [-uart2 uart_device2] [-nfp] [-freq frequency] [-c batch_file] [files] The default uart devices for SIS are /dev/ptypc and /dev/ptypd. The -uart[1,2] switch can be used to connect the uarts to other devices. Use 'tip /dev/ttypc' to connect a terminal emulator to the uarts. The '-nfp' will disable the simulated FPU, so each FPU instruction will generate a FPU disabled trap. The '-freq' switch can be used to define which "frequency" the simulator runs at. This is used by the 'perf' command to calculated the MIPS figure for a particular configuration. The give frequency must be an integer indicating the frequency in MHz. The -c option indicates that sis commands should be read from 'batch_file' at startup. Files to be loaded must be in one of the supported formats (see INSTALLATION), and will be loaded into the simulated memory. The file formats are automatically recognised. The script 'startsim' will start the simulator in one xterm window and open a terminal emulator (tip) connected to the UART A in a second xterm window. Below is description of commands that are recognized by the simulator. The command-line is parsed using GNU readline. A command history of 64 commands is maintained. Use the up/down arrows to recall previous commands. For more details, see the readline documentation. batch <file> Execute a batch file of SIS commands. +bp <address> Adds an breakpoint at address <address>. bp Prints all breakpoints -bp <num> Deletes breakpoint <num>. Use 'bp' to see which number is assigned to the breakpoints. cont [inst_count] Continue execution at present position, optionally for [inst_count] instructions. dis [addr] [count] Disassemble [count] instructions at address [addr]. Default values for count is 16 and addr is the present address. echo <string> Print <string> to the simulator window. float Prints the FPU registers go <address> [inst_count] The go command will set pc to <address> and npc to <address> + 4, and start execution. No other initialisation will be done. If inst_count is given, execution will stop after the specified number of instructions. help Print a small help menu for the SIS commands. hist [trace_length] Enable the instruction trace buffer. The 'trace_length' last executed instructions will be placed in the trace buffer. A 'hist' command without a trace_length will display the trace buffer. Specifying a zero trace length will disable the trace buffer. load <file_name> Loads a file into simulator memory. mem [addr] [count] Display memory at [addr] for [count] bytes. Same default values as above. quit Exits the simulator. perf [reset] The 'perf' command will display various execution statistics. A 'perf reset' command will reset the statistics. This can be used if statistics shall be calculated only over a part of the program. The 'run' and 'reset' command also resets the statistic information. reg [reg_name] [value] Prints and sets the IU regiters. 'reg' without parameters prints the IU registers. 'reg [reg_name] [value]' sets the corresponding register to [value]. Valid register names are psr, tbr, wim, y, g1-g7, o0-o7 and l0-l7. reset Performs a power-on reset. This command is equal to 'run 0'. run [inst_count] Resets the simulator and starts execution from address 0. If an instruction count is given (inst_count), the simulator will stop after the specified number of instructions. The event queue is emptied but any set breakpoints remain. step Equal to 'trace 1' tra [inst_count] Starts the simulator at the present position and prints each instruction it executes. If an instruction count is given (inst_count), the simulator will stop after the specified number of instructions. Typing a 'Ctrl-C' will interrupt a running simulator. Short forms of the commands are allowed, e.g 'c' 'co' or 'con' are all interpreted as 'cont'. 3. Simulator core The SIS emulates the behavior of the 90C601E and 90C602E sparc IU and FPU from Matra MHS. These are roughly equivalent to the Cypress C601 and C602. The simulator is cycle true, i.e a simulator time is maintained and inremented according the IU and FPU instruction timing. The parallel execution between the IU and FPU is modelled, as well as stalls due to operand dependencies (FPU). The core interacts with the user-defined memory modules through a number of functions. The memory module must provide the following functions: int memory_read(asi,addr,data,ws) int asi; unsigned int addr; unsigned int *data; int *ws; int memory_write(asi,addr,data,sz,ws) int asi; unsigned int addr; unsigned int *data; int sz; int *ws; int sis_memory_read(addr, data, length) unsigned int addr; char *data; unsigned int length; int sis_memory_write(addr, data, length) unsigned int addr; char *data; unsigned int length; int init_sim() int reset() int error_mode(pc) unsigned int pc; memory_read() is used by the simulator to fetch instructions and operands. The address space identifier (asi) and address is passed as parameters. The read data should be assigned to the data pointer (*data) and the number of waitstate to *ws. 'memory_read' should return 0 on success and 1 on failure. A failure will cause a data or instruction fetch trap. memory_read() always reads one 32-bit word. sis_memory_read() is used by the simulator to display and disassemble memory contants. The function should copy 'length' bytes of the simulated memory starting at 'addr' to '*data'. The sis_memory_read() should return 1 on success and 0 on failure. Failure should only be indicated if access to unimplemented memory is attempted. memory_write() is used to write to memory. In addition to the asi and address parameters, the size of the written data is given by 'sz'. The pointer *data points to the data to be written. The 'sz' is coded as follows: sz access type 0 byte 1 halfword 2 word 3 double-word If a double word is written, the most significant word is in data[0] and the least significant in data[1]. sis_memory_write() is used by the simulator during loading of programs. The function should copy 'length' bytes from *data to the simulated memory starting at 'addr'. sis_memory_write() should return 1 on success and 0 on failure. Failure should only be indicated if access to unimplemented memory is attempted. See erc32.c for more details on how to define the memory emulation functions. The 'init_sim' is called once when the simulator is started. This function should be used to perform initialisations of user defined memory or peripherals that only have to be done once, such as opening files etc. The 'reset' is called every time the simulator is reset, i.e. when a 'run' command is given. This function should be used to simulate a power on reset of memory and peripherals. error_mode() is called by the simulator when the IU goes into error mode, typically if a trap is caused when traps are disabled. The memory module can then take actions, such as issue a reset. sys_reset() can be called by the memory module to reset the simulator. A reset will empty the event queue and perform a power-on reset. 4. Events and interrupts The simulator supports an event queue and the generation of processor interrupts. The following functions are available to the user-defined memory module: event(cfunc,arg,delta) void (*cfunc)(); int arg; unsigned int delta; set_int(level,callback,arg) int level; void (*callback)(); int arg; clear_int(level) int level; sim_stop() The 'event' functions will schedule the execution of the function 'cfunc' at time 'now + delta' clock cycles. The parameter 'arg' is passed as a parameter to 'cfunc'. The 'set_int' function set the processor interrupt 'level'. When the interrupt is taken, the function 'callback' is called with the argument 'arg'. This will also clear the interrupt. An interrupt can be cleared before it is taken by calling 'clear_int' with the appropriate interrupt level. The sim_stop function is called each time the simulator stops execution. It can be used to flush buffered devices to get a clean state during single stepping etc. See 'erc32.c' for examples on how to use events and interrupts. 5. Memory module The supplied memory module (erc32.c) emulates the functions of memory and the MEC asic developed for the 90C601/2. It includes the following functions: * UART A & B * Real-time clock * General purpose timer * Interrupt controller * Breakpoint register * Watchpoint register * 512 Kbyte ROM * 4 Mbyte RAM See README.erc32 on how the MEC functions are emulated. For a detailed MEC specification, look at the ERC32 home page at URL: http://www.estec.esa.nl/wsmwww/erc32 6. Compile and linking programs The directory 'examples' contain some code fragments for SIS. The script gccx indicates how the native sunos gcc and linker can be used to produce executables for the simulator. To compile and link the provided 'hello.c', type 'gccx hello.c'. This will build the executable 'hello'. Start the simulator by running 'startsim hello', and issue the command 'run. After the program is terminated, the IU will be force to error mode through a software trap and halt. The programs are linked with a start-up file, srt0.S. This file includes the traptable and window underflow/overflow trap routines. 7. IU and FPU instruction timing. The simulator provides cycle true simulation. The following table shows the emulated instruction timing for 90C601E & 90C602E: Instructions Cycles jmpl, rett 2 load 2 store 3 load double 3 store double 4 other integer ops 1 fabs 2 fadds 4 faddd 4 fcmps 4 fcmpd 4 fdivs 20 fdivd 35 fmovs 2 fmuls 5 fmuld 9 fnegs 2 fsqrts 37 fsqrtd 65 fsubs 4 fsubd 4 fdtoi 7 fdots 3 fitos 6 fitod 6 fstoi 6 fstod 2 The parallel operation between the IU and FPU is modelled. This means that a FPU instruction will execute in parallel with other instructions as long as no data or resource dependency is detected. See the 90C602E data sheet for the various types of dependencies. Tracing using the 'trace' command will display the current simulator time in the left column. This time indicates when the instruction is fetched. If a dependency is detetected, the following fetch will be delayed until the conflict is resolved. The load dependency in the 90C601E is also modelled - if the destination register of a load instruction is used by the following instruction, an idle cycle is inserted. 8. FPU implementation The simulator maps floating-point operations on the hosts floating point capabilities. This means that accuracy and generation of IEEE exceptions is host dependent.