DejaGnu: The GNU Testing Framework
<<< Previous | Reference | Next >>>

# Installation

Once you have the DejaGnu source unpacked and available, you must first configure the software to specify where it is to run (and the associated defaults); then you can proceed to installing it.

## Configuring DejaGnu

It is usually best to configure in a directory separate from the source tree, specifying where to find the source with the optional --srcdir option to configure. DejaGnu uses the GNU autoconf to configure itself. For more info on using autoconf, read the GNU autoconf manual. To configure, execute the `configure` program, no other options are required. For an example, to configure in a seperate tree for objects, execute the configure script from the source tree like this:

            ../dejagnu-1.4.3/configure

DejaGnu doesn't care at config time if it's for testing a native system or a cross system. That is determined at runtime by using the config files.

You may also want to use the configure option --prefix to specify where you want DejaGnu and its supporting code installed. By default, installation is in subdirectories of `/usr/local`, but you can select any alternate directory altdir by including `--prefix`{altdir}} on the configure command line. (This value is captured in the Makefile variables prefix and execprefix}.)

Save for a small number of example tests, the DejaGnu distribution itself does not include any test suites; these are available separately. Test suites for the GNU development tools are included in those releases. After configuring the top-level DejaGnu directory, unpack and configure the test directories for the tools you want to test; then, in each test directory, run make check to build auxiliary programs required by some of the tests, and run the test suites.

## Installing DejaGnu

To install DejaGnu in your filesystem (either in `/usr/local`, or as specified by your --prefix option to configure), execute.

            eg$ make install

make installdoes thes things for DejaGnu:

- Look in the path specified for executables $exec_prefix) for directories called `lib` and `bin`. If these directories do not exist, make install creates them.

- Create another directory in the `share` directory, called `dejagnu`, and copy all the library files into it.

- Create a directory in the `dejagnu/share` directory, called `config`, and copy all the configuration files into it.

- Copy the runtest shell script into `$exec_prefix/bin`.

- Copy `runtest.exp` into `$exec_prefix/lib/dejagnu`. This is the main Tcl code implementing DejaGnu.

<<< Previous | Home | Next >>>
Reference | Up | Builtin Procedures