Chipmunk System Setup

The first part of setting up a Chipmunk system is to choose a place in your directory tree for the tools. Chipmunk can be installed in a user directory; you do not need to install it in a public place like /usr/local/. Once you've decided on a place, create a directory called chipmunk. Now move all the Chipmunk tar files to the chipmunk directory, and uncompress them using gzip if necessary.

Next, un-tar the files using the tar command, with the options appropriate for your system. For most Unix systems, the command

tar -xf file.tar

untars the file file.tar. Once this is complete, a directory listing of chipmunk should include the following directories

webdoc/ psys/

as well as some of the following directories, depending on which applications you pickup up.

log/ mosis/ netcmp/ until/ util/ view/ wol/ wolcomp/

At this point, you may wish to continue reading these instructions from the copy of this text in webdoc/. The file you are reading is chipmunk/webdoc/compile/compile.html#place. You can use the Open Local command in your WEB browser to find and open this file.

Chipmunk Compilation

Psys is the first package you should compile; press here for instructions on compiling the Psys package. Once Psys is compiled, you should proceed to compile the other tools in your Chipmunk directory.

The compilation process for Psys also creates the directory chipmunk/bin. The compilation process for all the Chipmunk tools will deposit executables in this directory. Users of Chipmunk tools should put this directory in their path. The compilation process for Psys also creates the directory chipmunk/lib. Many (but not all) Chipmunk tools deposit configuration and example files in this directory.

Once Psys is compiled, you can compile the other Chipmunk tools in any order you like. Click on the package name below for compilation instructions for this package:

Finally, you may want to retrieve a global Makefile for the entire Chipmunk toolset, so that you can recompile all the tools with a single command. Press here to view the Makefile, and use the Save As feature of your browser to pick up a copy. Press here for information about customizing and using the Makefile.

Once the tools are installed, you can start exploring the user documentation for the Chipmunk tools.

Email
lazzaro@cs.berkeley.edu
SMail
UC Berkeley / CS Division / 387 Soda Hall / Berkeley CA 94720