10 

 

5   Installation

5.1  Prerequisites

The goal of Covered was to create a tool that has very few requirements to allow it to be compiled and run on all platforms. The following is a list of all utilities/resources required to compile Covered. However, Covered is primarily developed on RedHat/Fedora Core Linux and as such is primarily tested by the developers on that platform.

  • gcc (Version 2.96 or higher)
  • flex (Version 2.5.4 or higher)
  • bison (Version 1.28 or higher)
  • GNU make (Version 3.27.1 or higher)
  • GNU gperf (Version 2.7.2 or higher)
  • tcl and tk (Versions 8.4 or higher)

Covered is currently primarily developed on Fedora Core 3 but has been known to compile with 32-bit and 64-bit compilers that contain the general GNU library of tools.

5.2  Downloading source

To download the source files in .tar.gz format, go to the following URL:

http://covered.sourceforge.net/downloads

Double-click on the .tar.gz version that you wish to install. The browser should immediately bring up a window asking if you would like to save to disk or open immediately. Choose the "Save to Disk" option. Another window will pop up, allowing you to choose the directory to store the tarball in. After selecting a directory, click the "Save" button. The download utility will begin downloading the tarball to the selected directory.

5.3  Installing from source

Once you have downloaded a tarball, enter the following to unzip and untar the package:

> gzip -dc tarball_filename | tar xvf -

This will create a directory called covered-version. Change your current directory to this directory and enter the following command:

> ./configure

This command will create the Makefiles/include files necessary for your machine to compile the source code correctly (without the ability to use the global debugging -D option to covered -- use the --enable-debug option to configure to get this ability). If any errors are generated during this command run, it is usually an indication that some program or library is missing from your computer that is necessary for Covered to compile/run. Please install any missing programs/libraries and type this command again. If the configure script completes successfully, you may compile the source with the following command:

> make

This will begin the process of compiling/linking the source code for Covered. This stage may take a while. When the source files have been compiled, the covered executable file will have been created. To install this executable in your /usr/local/bin directory, enter the following command:

> make install

This will install the covered executable and manpage help files. Once covered is installed, make sure that /usr/local/bin is in your environment path. You are now ready to run Covered.