doc/overview/installation.html

   1 <HTML
   2 ><HEAD
   3 ><TITLE
   4 >Installation</TITLE
   5 ><META
   6 NAME="GENERATOR"
   7 CONTENT="Modular DocBook HTML Stylesheet Version 1.44"><LINK
   8 REL="HOME"
   9 TITLE="DejaGnu"
  10 HREF="book1.html"><LINK
  11 REL="UP"
  12 TITLE="Reference"
  13 HREF="reference.html"><LINK
  14 REL="PREVIOUS"
  15 TITLE="Reference"
  16 HREF="reference.html"><LINK
  17 REL="NEXT"
  18 TITLE="Builtin Procedures"
  19 HREF="builtins.html"></HEAD
  20 ><BODY
  21 ><DIV
  22 CLASS="NAVHEADER"
  23 ><TABLE
  24 WIDTH="100%"
  25 BORDER="0"
  26 CELLPADDING="0"
  27 CELLSPACING="0"
  28 ><TR
  29 ><TH
  30 COLSPAN="3"
  31 ALIGN="center"
  32 >DejaGnu: The GNU Testing Framework</TH
  33 ></TR
  34 ><TR
  35 ><TD
  36 WIDTH="10%"
  37 ALIGN="left"
  38 VALIGN="bottom"
  39 ><A
  40 HREF="reference.html"
  41 >Prev</A
  42 ></TD
  43 ><TD
  44 WIDTH="80%"
  45 ALIGN="center"
  46 VALIGN="bottom"
  47 >Chapter 5. Reference</TD
  48 ><TD
  49 WIDTH="10%"
  50 ALIGN="right"
  51 VALIGN="bottom"
  52 ><A
  53 HREF="builtins.html"
  54 >Next</A
  55 ></TD
  56 ></TR
  57 ></TABLE
  58 ><HR
  59 ALIGN="LEFT"
  60 WIDTH="100%"></DIV
  61 ><DIV
  62 CLASS="SECT1"
  63 ><H1
  64 CLASS="SECT1"
  65 ><A
  66 NAME="INSTALLATION"
  67 >Installation</A
  68 ></H1
  69 ><P
  70 >Once you have the DejaGnu source unpacked and available, you must
  71     first configure the software to specify where it is to run (and the
  72     associated defaults); then you can proceed to installing it.</P
  73 ><DIV
  74 CLASS="SECT2"
  75 ><H2
  76 CLASS="SECT2"
  77 ><A
  78 NAME="CONFIGURING"
  79 >Configuring DejaGnu</A
  80 ></H2
  81 ><P
  82 >It is usually best to configure in a directory separate from the
  83       source tree, specifying where to find the source with the optional
  84       <I
  85 CLASS="EMPHASIS"
  86 >--srcdir</I
  87 > option to
  88       <I
  89 CLASS="EMPHASIS"
  90 >configure</I
  91 >. DejaGnu uses the GNU
  92       <I
  93 CLASS="EMPHASIS"
  94 >autoconf</I
  95 > to configure itself. For more info on using
  96       autoconf, read the GNU autoconf manual. To configure, execute the
  97       <TT
  98 CLASS="FILENAME"
  99 >configure</TT
 100 > program, no other options are
 101       required. For an example, to configure in a seperate tree for objects,
 102       execute the configure script from the source tree like this:</P
 103 ><TABLE
 104 BORDER="0"
 105 BGCOLOR="#E0E0E0"
 106 WIDTH="100%"
 107 ><TR
 108 ><TD
 109 ><PRE
 110 CLASS="SCREEN"
 111 >        ../dejagnu-1.4/configure
 112       </PRE
 113 ></TD
 114 ></TR
 115 ></TABLE
 116 ><P
 117 >DejaGnu doesn't care at config time if it's for testing a native
 118       system or a cross system. That is determined at runtime by using the
 119       config files.</P
 120 ><P
 121 >You may also want to use the <B
 122 CLASS="COMMAND"
 123 >configure</B
 124 > option
 125       <I
 126 CLASS="EMPHASIS"
 127 >--prefix</I
 128 > to specify where you want DejaGnu and its
 129       supporting code installed.  By default, installation is in subdirectories
 130       of <TT
 131 CLASS="FILENAME"
 132 >/usr/local</TT
 133 >, but you can select any alternate
 134       directory <SPAN
 135 CLASS="SYMBOL"
 136 >altdir</SPAN
 137 > by including
 138       <TT
 139 CLASS="OPTION"
 140 >--prefix</TT
 141 >{altdir}} on the
 142       <B
 143 CLASS="COMMAND"
 144 >configure</B
 145 > command line. (This value is captured in
 146       the Makefile variables <I
 147 CLASS="EMPHASIS"
 148 >prefix</I
 149 > and
 150       <I
 151 CLASS="EMPHASIS"
 152 >exec</I
 153 >prefix}.)</P
 154 ><P
 155 >Save for a small number of example tests, the DejaGnu distribution
 156       itself does not include any test suites; these are available
 157       separately. Test suites for the GNU development tools are included in
 158       those releases. After configuring the top-level DejaGnu directory, unpack
 159       and configure the test directories for the tools you want to test; then,
 160       in each test directory, run <I
 161 CLASS="EMPHASIS"
 162 >make check</I
 163 > to build
 164       auxiliary programs required by some of the tests, and run the test
 165       suites.</P
 166 ></DIV
 167 ><DIV
 168 CLASS="SECT2"
 169 ><H2
 170 CLASS="SECT2"
 171 ><A
 172 NAME="INSTALLING"
 173 >Installing DejaGnu</A
 174 ></H2
 175 ><P
 176 >To install DejaGnu in your filesystem (either in
 177       <TT
 178 CLASS="FILENAME"
 179 >/usr/local</TT
 180 >, or as specified by your
 181       <I
 182 CLASS="EMPHASIS"
 183 >--prefix</I
 184 > option to <I
 185 CLASS="EMPHASIS"
 186 >configure</I
 187 >),
 188       execute.</P
 189 ><TABLE
 190 BORDER="0"
 191 BGCOLOR="#E0E0E0"
 192 WIDTH="100%"
 193 ><TR
 194 ><TD
 195 ><PRE
 196 CLASS="SCREEN"
 197 >        eg$ make install
 198       </PRE
 199 ></TD
 200 ></TR
 201 ></TABLE
 202 ><P
 203 ><I
 204 CLASS="EMPHASIS"
 205 >make install</I
 206 >does thes things for
 207       DejaGnu:</P
 208 ><P
 209 ></P
 210 ><UL
 211 ><LI
 212 STYLE="list-style-type: disc"
 213 ><P
 214 >Look in the path specified for executables
 215           <SPAN
 216 CLASS="SYMBOL"
 217 >$exec_prefix</SPAN
 218 >) for directories called
 219           <TT
 220 CLASS="FILENAME"
 221 >lib</TT
 222 > and <TT
 223 CLASS="FILENAME"
 224 >bin</TT
 225 >. If these
 226           directories do not exist, <I
 227 CLASS="EMPHASIS"
 228 >make install</I
 229 > creates
 230           them.</P
 231 ></LI
 232 ><LI
 233 STYLE="list-style-type: disc"
 234 ><P
 235 >Create another directory in the
 236         <TT
 237 CLASS="FILENAME"
 238 >share</TT
 239 > directory, called
 240         <TT
 241 CLASS="FILENAME"
 242 >dejagnu</TT
 243 >, and copy all the library files into
 244         it.</P
 245 ></LI
 246 ><LI
 247 STYLE="list-style-type: disc"
 248 ><P
 249 >Create a directory in the
 250         <TT
 251 CLASS="FILENAME"
 252 >dejagnu/share</TT
 253 > directory, called
 254         <TT
 255 CLASS="FILENAME"
 256 >config</TT
 257 >, and copy all the configuration files into
 258         it.</P
 259 ></LI
 260 ><LI
 261 STYLE="list-style-type: disc"
 262 ><P
 263 >Copy the <I
 264 CLASS="EMPHASIS"
 265 >runtest</I
 266 > shell script into
 267         <TT
 268 CLASS="FILENAME"
 269 >$exec_prefix/bin</TT
 270 >.</P
 271 ></LI
 272 ><LI
 273 STYLE="list-style-type: disc"
 274 ><P
 275 >Copy <TT
 276 CLASS="FILENAME"
 277 >runtest.exp</TT
 278 > into
 279         <TT
 280 CLASS="FILENAME"
 281 >$exec_prefix/lib/dejagnu</TT
 282 >. This is the main Tcl
 283         code implementing DejaGnu.</P
 284 ></LI
 285 ></UL
 286 ></DIV
 287 ></DIV
 288 ><DIV
 289 CLASS="NAVFOOTER"
 290 ><HR
 291 ALIGN="LEFT"
 292 WIDTH="100%"><TABLE
 293 WIDTH="100%"
 294 BORDER="0"
 295 CELLPADDING="0"
 296 CELLSPACING="0"
 297 ><TR
 298 ><TD
 299 WIDTH="33%"
 300 ALIGN="left"
 301 VALIGN="top"
 302 ><A
 303 HREF="reference.html"
 304 >Prev</A
 305 ></TD
 306 ><TD
 307 WIDTH="34%"
 308 ALIGN="center"
 309 VALIGN="top"
 310 ><A
 311 HREF="book1.html"
 312 >Home</A
 313 ></TD
 314 ><TD
 315 WIDTH="33%"
 316 ALIGN="right"
 317 VALIGN="top"
 318 ><A
 319 HREF="builtins.html"
 320 >Next</A
 321 ></TD
 322 ></TR
 323 ><TR
 324 ><TD
 325 WIDTH="33%"
 326 ALIGN="left"
 327 VALIGN="top"
 328 >Reference</TD
 329 ><TD
 330 WIDTH="34%"
 331 ALIGN="center"
 332 VALIGN="top"
 333 ><A
 334 HREF="reference.html"
 335 >Up</A
 336 ></TD
 337 ><TD
 338 WIDTH="33%"
 339 ALIGN="right"
 340 VALIGN="top"
 341 >Builtin Procedures</TD
 342 ></TR
 343 ></TABLE
 344 ></DIV
 345 ></BODY
 346 ></HTML
 347 >