jgrasp handbook

DRAFT, February 18, 2003, Page 73
installed on your system, and a soft link to the jgrasp startup script (for command line execution) will be
created in /usr/bin or your $HOME/bin directory.
If you want to create a "normal" OS X application, copy the "jgrasp/bin/macosx/jGRASP Control
Shell.app" directory, then move the original "jgrasp" directory into the new "jGRASP Control
Shell.app/Contents/Resources" directory.
8.7 Installing on x86 Linux, SPARC Solaris
Unzip the distribution file in the directory where you wish to install jGRASP. This will create a jgrasp
directory containing all the files. You may want to add the "bin" subdirectory of this directory to your
execution path or create a soft link to .../jgrasp/bin/jgrasp from a directory on the executable path.
8.8 Installing on Other Systems
Unzip the distribution file in the directory where you wish to install jGRASP. All the functions of jGRASP
will work except for the compile and run functions.
If you are on a Unix system other than Linux or Solaris, you can build a "wedge" program in order to use
the compile and run functions of jGRASP (C compiler and knowledge of how to use it is necessary). The
source can be found at jgrasp/src/linux_run.c . The executable must be jgrasp/jbin/sys_run . The source
for a client-server shell can be found at jgrasp/src/linux_exec.c . That executable can have any name; it is
only used externally. For the best chance of success, compile with default optimization.
Please contact us if you succeed in doing this. We can incorporate your executables in a future release of
jGRASP.
If you are on a system other than Windows or a UNIX variant and have a good knowledge of system
programming on your system, you can build a wedge based on the UNIX wedge sources found in
jgrasp/src . The executable must be jgrasp/jbin/sys_run.
8.9 Network Administration
jGRASP supports common settings for all users on a network. The common settings directory can be
specified at installation time if using the self-extracting exe on Windows. Otherwise, in the "data" directory
of the installation, edit the file called "admin". Specify the directory to be used for administrator settings in
this file. This should be the only contents of the file, and not be followed by a line feed or carriage return.
Use a full path to specify the directory. This directory must be accessible and readable by all users, and
writable only for administrators. You should select a location outside the jGRASP distribution, so that you
can continue to use the settings after upgrading.
When an administrator (anyone with write access in the common settings directory) runs jGRASP, menu
items that allow you to change administrator settings will appear on the control panel settings menu. Also,
when copying or creating compiler environments, you will have the choice of creating them for all users or
just the current user.
9 Running jGRASP
jGRASP requires a Java 1.2 or better virtual machine and system classes to run. You can get the latest
JDK from Sun Microsystems.
You will probably need about 48 Megs of memory to run jGRASP, but this depends on the virtual
machine, jit compiler, and which other applications you run concurrently.