Modify a pre-existing program

Modify a program or library.

NOTE: This section on modifications is incomplete.

Install a program or library.

Programs and libraries can be installed to your sandbox or the shared public $G installation directories. The installation directory is named install_$GARCH; where $GARCH is the platform name (e.g. install_linux or install_WIN32). By default the installation directory is at the top of your sandbox; which can be your home directory or in the $G user area.

Advanced users can designate any installation location by setting the $GTO variable. This variable should be used with caution and you should fully understand its usage before setting it. When it is not set the make files will prevent you from building or installing programs into any sub-directory of the public $G area. This helps protects public areas from accidental corruption.

To set up an installation directory in your sandbox first you need to create the directory. If you do not want to use either of the default locations you will also need to set the GTO variable to the parent directory.

> mkdir   -p   $GROOT/users/$USER/my_sandbox/install_$GARCH/
> setenv  GTO  $GROOT/users/$USER/my_sandbox

When you run make install software will be copied to the $GTO/install_$GARCH/ directory. Then you can install and test software in your sandbox without interfering with the public $G installations.

After you are confident the software works you can install it in the public area by setting GTO to G. Always unset this when you are done to avoid unintentionally corrupting the public installations.

> setenv  GTO  $G         # Allow installs into $G.
> make install            # Copy files to:  $G/install_$GARCH
> unsetenv  GTO           # GTO considered harmful.