CS164 Projects at Home

Since many students want to work at home, we are making an effort to provide the necessary files and binaries. Currently, we have distributions for Linux/x86 and Cygwin/Windows/x86. However, please keep two things in mind if you decide to use them:

• Every system is a little different, and there are bound to be incompatibilities here and there. Try to work them out yourself, but if you can't, post a message to the newsgroup and we'll see if we can help.
• The projects are tested and graded by running them on the instructional machines (Solaris/sparc or Solaris/x86). You must verify your project works on one of these platforms. It is not good enough that it worked under Linux or Cygwin/Windows.

Required Software

For C++ projects, you will need gcc, flex (for PA2), and bison (for PA3). If you intend to do the projects in Java, you need JDK 1.2.2 or later, but JLex and CUP are included with the Cool distribution. See also the Software page.

Linux

To run Coolaid, you will need Tcl/Tk version ≥ 8.3 and glibc ≥ 2.3.2.

Windows

For Windows, you need to install Cygwin. Cygwin is a Linux-like environment for Windows, which can be obtained from http://www.cygwin.com. To run Coolaid, you need at least the following additional Cygwin packages:

• tcltk (Libs)
• XFree86-bin (XFree86)
• XFree86-lib (XFree86)
• XFree86-prog (XFree86)

CS164 Distribution

Download

Installation

First, create a directory that will be the root of the CS164 distribution. This directory will serve the same purpose as ~cs164 on the instructional machines. Then, make sure that the environment variable MASTERDIR is set to this directory. For example, include

• export MASTERDIR=/home/user/cs164 (in .bash_login for bash)
• setenv MASTERDIR /home/user/cs164 (in .login for csh)

where /home/user/cs164 is the directory you have crated to be root of the CS164 distribution.

Download the CS164 packages to your root for the CS164 distribution. To unpack the linux distribution, type:

  % cd $MASTERDIR
  % tar xvzf cs164-linux.tar.gz

Similarly, unpack any project distributions from your root for the CS164 distribution. Finally, add ${MASTERDIR}/bin to your path.

To work on the projects, follow the handout instructions substituting your root for ~cs164 where appropriate.

To use Coolaid, you need to make sure your environment variable TCL_LIBRARY is set to where the init.tcl file is located. For example, include

• export TCL_LIBRARY=/usr/share/tcl8.3 (in .bash_login for bash)
• setenv TCL_LIBRARY /usr/share/tcl8.3 (in .login for csh)

where /usr/share/tcl8.3 is where the init.tcl file is located.