| <!DOCTYPE HTML PUBLIC "-//W3C//DTD HTML 4.01//EN"> |
| <HTML |
| ><HEAD |
| ><TITLE |
| >Installation</TITLE |
| ><META |
| NAME="GENERATOR" |
| CONTENT="Modular DocBook HTML Stylesheet Version 1.76b+ |
| "><LINK |
| REL="HOME" |
| TITLE="DejaGnu" |
| HREF="book1.html"><LINK |
| REL="UP" |
| TITLE="Reference" |
| HREF="c1593.html"><LINK |
| REL="PREVIOUS" |
| TITLE="Reference" |
| HREF="c1593.html"><LINK |
| REL="NEXT" |
| TITLE="Builtin Procedures" |
| HREF="x1655.html"></HEAD |
| ><BODY |
| CLASS="SECT1" |
| BGCOLOR="#FFFFFF" |
| TEXT="#000000" |
| LINK="#0000FF" |
| VLINK="#840084" |
| ALINK="#0000FF" |
| ><DIV |
| CLASS="NAVHEADER" |
| ><TABLE |
| SUMMARY="Header navigation 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="c1593.html" |
| ACCESSKEY="P" |
| ><<< Previous</A |
| ></TD |
| ><TD |
| WIDTH="80%" |
| ALIGN="center" |
| VALIGN="bottom" |
| >Reference</TD |
| ><TD |
| WIDTH="10%" |
| ALIGN="right" |
| VALIGN="bottom" |
| ><A |
| HREF="x1655.html" |
| ACCESSKEY="N" |
| >Next >>></A |
| ></TD |
| ></TR |
| ></TABLE |
| ><HR |
| ALIGN="LEFT" |
| WIDTH="100%"></DIV |
| ><DIV |
| CLASS="SECT1" |
| ><H1 |
| CLASS="SECT1" |
| ><A |
| NAME="INSTALLATION" |
| ></A |
| >Installation</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" |
| ></A |
| >Configuring DejaGnu</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.4/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 testsuites; these are available |
| separately. Testsuites 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" |
| ></A |
| >Installing DejaGnu</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 |
| SUMMARY="Footer navigation table" |
| WIDTH="100%" |
| BORDER="0" |
| CELLPADDING="0" |
| CELLSPACING="0" |
| ><TR |
| ><TD |
| WIDTH="33%" |
| ALIGN="left" |
| VALIGN="top" |
| ><A |
| HREF="c1593.html" |
| ACCESSKEY="P" |
| ><<< Previous</A |
| ></TD |
| ><TD |
| WIDTH="34%" |
| ALIGN="center" |
| VALIGN="top" |
| ><A |
| HREF="book1.html" |
| ACCESSKEY="H" |
| >Home</A |
| ></TD |
| ><TD |
| WIDTH="33%" |
| ALIGN="right" |
| VALIGN="top" |
| ><A |
| HREF="x1655.html" |
| ACCESSKEY="N" |
| >Next >>></A |
| ></TD |
| ></TR |
| ><TR |
| ><TD |
| WIDTH="33%" |
| ALIGN="left" |
| VALIGN="top" |
| >Reference</TD |
| ><TD |
| WIDTH="34%" |
| ALIGN="center" |
| VALIGN="top" |
| ><A |
| HREF="c1593.html" |
| ACCESSKEY="U" |
| >Up</A |
| ></TD |
| ><TD |
| WIDTH="33%" |
| ALIGN="right" |
| VALIGN="top" |
| >Builtin Procedures</TD |
| ></TR |
| ></TABLE |
| ></DIV |
| ></BODY |
| ></HTML |
| > |