<!DOCTYPE HTML PUBLIC "-//W3C//DTD HTML 4.01//EN"> <HTML ><HEAD ><TITLE >Installation</TITLE ><META NAME="GENERATOR" CONTENT="Modular DocBook HTML Stylesheet Version 1.64 "><LINK REL="HOME" TITLE="DejaGnu" HREF="book1.html"><LINK REL="UP" TITLE="Reference" HREF="reference.html"><LINK REL="PREVIOUS" TITLE="Reference" HREF="reference.html"><LINK REL="NEXT" TITLE="Builtin Procedures" HREF="builtins.html"></HEAD ><BODY CLASS="SECT1" BGCOLOR="#FFFFFF" TEXT="#000000" LINK="#0000FF" VLINK="#840084" ALINK="#0000FF" ><DIV CLASS="NAVHEADER" ><TABLE WIDTH="100%" BORDER="0" CELLPADDING="0" CELLSPACING="0" ><TR ><TH COLSPAN="3" ALIGN="center" >DejaGnu: The GNU Testing Framework</TH ></TR ><TR ><TD WIDTH="10%" ALIGN="left" VALIGN="bottom" ><A HREF="reference.html" ><<< Previous</A ></TD ><TD WIDTH="80%" ALIGN="center" VALIGN="bottom" >Reference</TD ><TD WIDTH="10%" ALIGN="right" VALIGN="bottom" ><A HREF="builtins.html" >Next >>></A ></TD ></TR ></TABLE ><HR ALIGN="LEFT" WIDTH="100%"></DIV ><DIV CLASS="SECT1" ><H1 CLASS="SECT1" ><A NAME="INSTALLATION" >Installation</A ></H1 ><P >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.</P ><DIV CLASS="SECT2" ><H2 CLASS="SECT2" ><A NAME="CONFIGURING" >Configuring DejaGnu</A ></H2 ><P >It is usually best to configure in a directory separate from the source tree, specifying where to find the source with the optional <I CLASS="EMPHASIS" >--srcdir</I > option to <I CLASS="EMPHASIS" >configure</I >. DejaGnu uses the GNU <I CLASS="EMPHASIS" >autoconf</I > to configure itself. For more info on using autoconf, read the GNU autoconf manual. To configure, execute the <TT CLASS="FILENAME" >configure</TT > 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:</P ><TABLE BORDER="0" BGCOLOR="#E0E0E0" WIDTH="100%" ><TR ><TD ><PRE CLASS="SCREEN" > ../dejagnu-1.4.3/configure </PRE ></TD ></TR ></TABLE ><P >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.</P ><P >You may also want to use the <B CLASS="COMMAND" >configure</B > option <I CLASS="EMPHASIS" >--prefix</I > to specify where you want DejaGnu and its supporting code installed. By default, installation is in subdirectories of <TT CLASS="FILENAME" >/usr/local</TT >, but you can select any alternate directory <SPAN CLASS="SYMBOL" >altdir</SPAN > by including <TT CLASS="OPTION" >--prefix</TT >{altdir}} on the <B CLASS="COMMAND" >configure</B > command line. (This value is captured in the Makefile variables <I CLASS="EMPHASIS" >prefix</I > and <I CLASS="EMPHASIS" >exec</I >prefix}.)</P ><P >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 <I CLASS="EMPHASIS" >make check</I > to build auxiliary programs required by some of the tests, and run the test suites.</P ></DIV ><DIV CLASS="SECT2" ><H2 CLASS="SECT2" ><A NAME="INSTALLING" >Installing DejaGnu</A ></H2 ><P >To install DejaGnu in your filesystem (either in <TT CLASS="FILENAME" >/usr/local</TT >, or as specified by your <I CLASS="EMPHASIS" >--prefix</I > option to <I CLASS="EMPHASIS" >configure</I >), execute.</P ><TABLE BORDER="0" BGCOLOR="#E0E0E0" WIDTH="100%" ><TR ><TD ><PRE CLASS="SCREEN" > eg$ make install </PRE ></TD ></TR ></TABLE ><P ><I CLASS="EMPHASIS" >make install</I >does thes things for DejaGnu:</P ><P ></P ><UL ><LI STYLE="list-style-type: disc" ><P >Look in the path specified for executables <SPAN CLASS="SYMBOL" >$exec_prefix</SPAN >) for directories called <TT CLASS="FILENAME" >lib</TT > and <TT CLASS="FILENAME" >bin</TT >. If these directories do not exist, <I CLASS="EMPHASIS" >make install</I > creates them.</P ></LI ><LI STYLE="list-style-type: disc" ><P >Create another directory in the <TT CLASS="FILENAME" >share</TT > directory, called <TT CLASS="FILENAME" >dejagnu</TT >, and copy all the library files into it.</P ></LI ><LI STYLE="list-style-type: disc" ><P >Create a directory in the <TT CLASS="FILENAME" >dejagnu/share</TT > directory, called <TT CLASS="FILENAME" >config</TT >, and copy all the configuration files into it.</P ></LI ><LI STYLE="list-style-type: disc" ><P >Copy the <I CLASS="EMPHASIS" >runtest</I > shell script into <TT CLASS="FILENAME" >$exec_prefix/bin</TT >.</P ></LI ><LI STYLE="list-style-type: disc" ><P >Copy <TT CLASS="FILENAME" >runtest.exp</TT > into <TT CLASS="FILENAME" >$exec_prefix/lib/dejagnu</TT >. This is the main Tcl code implementing DejaGnu.</P ></LI ></UL ></DIV ></DIV ><DIV CLASS="NAVFOOTER" ><HR ALIGN="LEFT" WIDTH="100%"><TABLE WIDTH="100%" BORDER="0" CELLPADDING="0" CELLSPACING="0" ><TR ><TD WIDTH="33%" ALIGN="left" VALIGN="top" ><A HREF="reference.html" ><<< Previous</A ></TD ><TD WIDTH="34%" ALIGN="center" VALIGN="top" ><A HREF="book1.html" >Home</A ></TD ><TD WIDTH="33%" ALIGN="right" VALIGN="top" ><A HREF="builtins.html" >Next >>></A ></TD ></TR ><TR ><TD WIDTH="33%" ALIGN="left" VALIGN="top" >Reference</TD ><TD WIDTH="34%" ALIGN="center" VALIGN="top" ><A HREF="reference.html" >Up</A ></TD ><TD WIDTH="33%" ALIGN="right" VALIGN="top" >Builtin Procedures</TD ></TR ></TABLE ></DIV ></BODY ></HTML >