<!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"
>&#60;&#60;&#60; 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 &#62;&#62;&#62;</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"
>&#60;&#60;&#60; 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 &#62;&#62;&#62;</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
>