next up previous contents
Next: Debugging Up: Building x-Sim Previous: Building x-Sim

The Steps

  1. Create directory /usr/xkernel and use anonymous FTP to copy file xkernel.tar.Z from cs.arizona.edu/xkernel into this directory. Then type:

    cd /usr/xkernel
    uncompress xkernel.tar.Z
    tar xf xkernel.tar

    This will create several subdirectories in /usr/xkernel. A description of the x-kernel directory hierarchy can be found in /usr/xkernel/README. Note that you can skip this step if you are not the first person to install and use the x-kernel or x-Sim at your site.

  2. Create a directory in which you will build an instance of x-Sim . This is called your build directory, and in general, each different configuration of the x-kernel and x-Sim has its own build directory.

    cd /usr/xkernel/simulator/build
    mkdir solaris
    If directory /usr/xkernel/simulator/build/solaris already exists---because someone else has already followed this procedure---then you have two choices.

    1. Select another name for your build directory (e.g., mydir) and create a directory with this name in directory /usr/xkernel/simulator/build. The catch to this option is that you have to either have write permission in directory /usr/xkernel/simulator/build, or you have to have someone that has write permission create your build directory for you.

    2. Create a build directory in your own home directory; e.g., /usr/llp/xsim/solaris. This is the preferred approach if a lot of different people are going to be building the x-kernel or x-Sim .

    Substitute the name of your build directory, as appropriate, in the rest of the steps.

  3. Copy configuration files into your build directory.
    cd /usr/xkernel/simulator/build/solaris
    cp ../Template/Makefile.solaris Makefile
    cp ../Template/example/* .
    mkdir db
    chmod 664 *

    Note that if your build directory is not in /usr/xkernel/simulator/build, then you will have to use the full path names for these various files rather than the relative path names given above (i.e., /usr/xkernel/simulator/build/Template/example instead of ../Template/example).

  4. Edit the `` XRT ='' line of the Makefile you just copied into your build directory to reflect the root of your x-kernel source tree. Assuming your tree is at /usr/xkernel, this means changing

    XRT = ../../..
    to
    XRT = /usr/xkernel

    Note that this step is necessary only if your build directory is underneath your home directory. It is not necessary if your build directory is in /usr/xkernel/simulator/build since from there, ../../.. already points to the root of the x-kernel source tree.

  5. Put /usr/xkernel/bin/solaris-sparc and /usr/xkernel/bin in your search path. They should appear before /bin and /usr/bin in order to pick up GNU make before the standard Unix make. If you are building x-Sim on a platform other than Solaris, then substitute sunos-sparc or osf1-alpha for solaris-sparc, as appropriate. Also, make sure the GNU C compiler ( gcc) is in your search path. (At Arizona, gcc can be found in directory /usr/local/bin.)

  6. Build libraries necessary for your x-Sim . This could take quite a while.

    cd /usr/xkernel/simulator/build/solaris
    make system

    Note that you can skip this step if you are not the first person to build an x-Sim for this platform.

  7. You are now ready to build your x-Sim .

    cd /usr/xkernel/simulator/build/solaris
    make compose
    make depend
    make

    This sequence should result in the creation of the binary file xkernel in your build directory. Note that you may see what appear to be error messages about missing files (e.g., Makefile.local and DEPS/Makedep.*) when you run make compose. These warnings can be ignored.

  8. You are now ready to run your x-Sim .

    cd /usr/xkernel/simulator/build/solaris
    xsim


next up previous contents
Next: Debugging Up: Building x-Sim Previous: Building x-Sim



Larry Peterson
Tue Jul 1 18:43:36 MST 1997