Installation

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.