Here is a paraphrase from Norman Wilson's introduction to the Research 10th edition of UNIX that just about sums up my attitude to REAL:
This system is not packaged for novices. It is assumed that anyone who gets a copy is self-sufficient and can read our manuals and the source code to resolve confusions and problems.
This manual provides guidelines for installing REAL. The table below summarizes the systems on which I know REAL will run. Your mileage may vary.
Create the REAL root directory. Move the compressed tar file to this directory. Then, uncompress and untar the file.
[uncompress | gunzip] REAL5.0.tar.[Z|gz]
tar xvf REAL5.0.tar
You are now ready to configure and make the system. All instructions that follow use filenames relative to this root directory.
Change directory to sim/src. Edit file state.S to extract the assembly code corresponding to your machine, and save it in a file called state.s.
Customize the makefiles for your system. You have to edit three makefiles.
If you are running IRIX 5.2 or greater, you will need to tell the system about the location of the shared library. The command is:
setenv LD_LIBRARY_PATH ../src
You are now ready to configure the system. Change directory to src and type
It is possible the Configure will not work correctly. For example, Configure runs a test that creates archives of length zero and this can cause a core dump on some machines. To avoid this, you should comment out the commands that are causing problems, and determine the defaults manually. It helps to have a Unix guru handy.
At one point, Configure will ask you to do a shell escape to edit config.sh. Here, type in
# This file was produced by running the Configure script.
You have to edit this file to make sure that it describes your system accurately. This is not easy, and unfortunately there is not much I can do to help you with it. Your only consolation is that you will almost surely not have to change anything. I recommend that you just try building the system and only come back to this step if it really blows up on you.
I will now describe the variable names in the file, and you will need to determine if their values are appropriate for your system. In general, the convention used for variable names is that d_XXX means that a #define for XXX will be created in the configuration file nest.h. Command names stand for the particular flavor of command used by your system.
This is followed by definitions for the location of useful commands such as sed, echo, cat, rm, and tr. Modify them if necessary.
`contains' should be your flavor of grep.
`cpp' should be set to your C preprocessor. The Configure script automatically tries cpp, cc -E
`cppminus' is the default flag that you need to give to cpp.
`d_charsprf' is set if sprintf() is of type char.
`d_voidsig' is set if your system defines signal() to be of type (void).
The definition for `libc' is critical, and defines where your C library is.If you have more than one library, then this might be wrong. For example, in UMIPS, it will be set to the SysV library /usr/lib/libc.a, and you actually should have /bsd43/usr/lib/libc.a.
`spitshell' is the command to print data into a file.
`shsharp' is true if `#' can comment out things in your version of shell.
`voidflags' is explained when you do Configure.
Now there are some defines that explore the limits of your operating system. The meanings of these defines are in the file sim/src/nest.h.SH. Take a minute to make sure that they are correct.
`socketlib' is the library that has socket code, if libc.a doesn't. (Solaris has it in libsocket)
`sockethdr' is the place where include files for sockets are kept if they are non-standard.
`mkdep' is the command that will generate makedepends for you. Usually this is /lib/cpp -M, but if that doesn't work, you may have to use /bsd43/bin/cc -M.
`orderlib' is true if the archive command creates unordered libraries.
`ranlib' is the command you need to use to create random libraries (set to `:' if it isn't needed, then the command becomes a comment).
`stackdir' is the direction the stack grows in, 1 is up, -1 is down.
Finally, CONFIG is set to indicate that you have run config.sh.
Next, Configure will do a makedepend for you. This step consists of editing Makefile to automatically add include file dependencies. The `depend' target in Makefile spawns a small ed script that edits Makefile to delete the end of the file, and to append dependencies generated by $mkdep.
Finally, Configure will make the nest.a library as well as the REAL simulator binary (which is called 'simulate'). Ignore any warnings about non-portablity of the code.
If Configure stops in the make nest.a step, simply type make nest.a after fixing whatever problem arose. Then cd ../sim, and type "make depend; make final".
In some cases, when you try to run the simulator, it will crash with an error message: `ADDRESS NOT FOUND!' This means that the file FUNC_TABLE has not been properly created. This file is created by the nm command in the `final' target of sim/sim/makefile, using the file nm.awk. It should look like
You are now ready to begin simulations. The REAL User manual and Programmers manual should help you get started. Good luck !