The release for Linux is available as an RPM archive that can be installed using the rpm tool, or as a compressed tar file containing an installation script. Root privileges are usually required to install the Linux release. For installation instructions without root privileges, see the Section called Installation for a single user without root privileges below.
Using the RPM archive
The RPM archive has a name of the form Jamaica-version-linux- gnu-target.rpm. To install this archive, super user (root) privileges are required:
> su - Password: # |
The actual installation can be performed by using the rpm command:
# rpm -i Jamaica-<version>-linux-gnu-<target>.rpm # |
Using compressed tar archive
The compressed tar archive has a name of the form Jamaica-version- linux-gnu-target.tar.gz. To install this archive, super user (root) privileges are required:
> su Password: # |
Before installation can proceed, the archive should be unpacked using the tar command:
# tar xzf Jamaica-<version>-linux-gnu-<target>.tar.gz # |
The actual installation can then be performed using the provided install script command:
# ./Jamaica.install # |
Jamaica will be installed in /usr/local/jamaica-<version>. A soft-link /usr/local/jamaica will be generated to refer to this directory.
Soft-links for the commands jamaica, jamaicah, jamaicavm and numblocks will be created in the directory /usr/bin so that the tools can be used without having to adjust the PATH environment variable.
If you do not have root permission or you prefer to install Jamaica locally in your home directory instead of in /usr/local, proceed as follows:
You need to install the Jamaica tar-archive named Jamaica-version- linux-gnu-target.tar.gz. First, unpack and install it into the current directory using tar. Then, set the environment variable JAMAICA to the installation directory.
> tar zxf Jamaica-2.0-3-linux-gnu.tar.gz > tar -xpf Jamaica.ss > export JAMAICA=`pwd`/usr/local/jamaica-2.0-3 > export PATH=$JAMAICA/bin:$PATH > jamaica -help jamaica [-help] [-Xhelp] [-version] ... > ... |
In order to complete the installation, the locations of the toolchains need to be specified. This is done by editing the appropriate jamaica.conf files for the target (and possibly also the host). The Jamaica directory structure is shown in the Section called Jamaica Directory structure. The precise location of the configuration file is <JAMAICA>/target/<target>/etc/jamaica.conf. Note that the configuration for the host is also in a target directory! On an x86 Linux system, the directory name for the host is linux-x86, for example. The following changes are required in these files for the host and all targets you will use:
Set the entries Xcc and Xld to the path of the compiler and linker, respectively. For example, for the Gnu C compiler on ARM Linux set Xcc.linux-arm-le = <path to compiler>/arm-linux-gcc. If the compiler or linker are on your default search path, it is sufficient to give the name of the compiler or linker, respectively.
Set the entries Xinclude and XlibraryPaths to the path of the include files and libraries, respectively. For example, for Xinclude.linux-arm-le set Xinclude.linux-arm-le = <path to compiler>/include.