doc/overview/global.html

   1 <HTML
   2 ><HEAD
   3 ><TITLE
   4 >Global Config File</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="Customizing DejaGnu"
  13 HREF="customizing.html"><LINK
  14 REL="PREVIOUS"
  15 TITLE="Customizing DejaGnu"
  16 HREF="customizing.html"><LINK
  17 REL="NEXT"
  18 TITLE="Board Config File"
  19 HREF="boardconfig.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="customizing.html"
  41 >Prev</A
  42 ></TD
  43 ><TD
  44 WIDTH="80%"
  45 ALIGN="center"
  46 VALIGN="bottom"
  47 >Chapter 3. Customizing DejaGnu</TD
  48 ><TD
  49 WIDTH="10%"
  50 ALIGN="right"
  51 VALIGN="bottom"
  52 ><A
  53 HREF="boardconfig.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="GLOBAL"
  67 >Global Config File</A
  68 ></H1
  69 ><P
  70 >The master config file is where all the target specific
  71       config variables get set for a whole site get set. The idea is
  72       that for a centralized testing lab where people have to share a
  73       target between multiple developers. There are settings for both
  74       remote targets and remote hosts.  Here's an example of a Master
  75       Config File (also called the Global config file) for a
  76       <I
  77 CLASS="EMPHASIS"
  78 >canadian cross</I
  79 >. A canadian cross is when
  80       you build and test a cross compiler on a machine other than the
  81       one it's to be hosted on.</P
  82 ><P
  83 >Here we have the config settings for our California
  84       office. Note that all config values are site dependant. Here we
  85       have two sets of values that we use for testing m68k-aout cross
  86       compilers. As both of these target boards has a different
  87       debugging protocol, we test on both of them in sequence.</P
  88 ><DIV
  89 CLASS="EXAMPLE"
  90 ><P
  91 ><B
  92 >Example 3-4. Global Config file</B
  93 ></P
  94 ><TABLE
  95 BORDER="0"
  96 BGCOLOR="#E0E0E0"
  97 WIDTH="100%"
  98 ><TR
  99 ><TD
 100 ><PRE
 101 CLASS="PROGRAMLISTING"
 102 >&#13;      # Make sure we look in the right place for the board description files.
 103       if ![info exists boards_dir] {
 104           set boards_dir {}
 105       }
 106       lappend boards_dir "/nfs/cygint/s1/cygnus/dejagnu/boards"
 107
 108       verbose "Global Config File: target_triplet is $target_triplet" 2
 109       global target_list
 110
 111       case "$target_triplet" in {
 112           { "native" } {
 113               set target_list "unix"
 114           }
 115           { "sparc64-*elf" } {
 116               set target_list "sparc64-sim"
 117           }
 118           { "mips-*elf" } {
 119               set target_list "mips-sim wilma barney"
 120           }
 121           { "mips-lsi-elf" } {
 122               set target_list "mips-lsi-sim{,soft-float,el}"
 123           }
 124           { "sh-*hms" } {
 125               set target_list { "sh-hms-sim" "bloozy" }
 126           }
 127       }
 128       </PRE
 129 ></TD
 130 ></TR
 131 ></TABLE
 132 ></DIV
 133 ><P
 134 >In this case, we have support for several cross compilers,
 135     that all run on this host. For testing on operating systems that
 136     don't support Expect, DejaGnu can be run on the local build
 137     machine, and it can connect to the remote host and run all the
 138     tests for this cross compiler on that host. All the remote OS
 139     requires is a working telnetd.</P
 140 ><P
 141 >As you can see, all one does is set the variable
 142     <SPAN
 143 CLASS="SYMBOL"
 144 >target_list</SPAN
 145 > to the list of targets and options to
 146     test. The simple settings, like for
 147     <I
 148 CLASS="EMPHASIS"
 149 >sparc64-elf</I
 150 > only require setting the name of
 151     the single board config file. The <I
 152 CLASS="EMPHASIS"
 153 >mips-elf</I
 154 >
 155     target is more complicated. Here it sets the list to three target
 156     boards. One is the default mips target, and both
 157     <I
 158 CLASS="EMPHASIS"
 159 >wilma</I
 160 > <I
 161 CLASS="EMPHASIS"
 162 >barney</I
 163 > are
 164     symbolic names for other mips boards. Symbolic names are covered
 165     in the <A
 166 HREF="addboard.html"
 167 ><I
 168 >Adding A New Board</I
 169 ></A
 170 > chapter. The more complicated
 171     example is the one for <I
 172 CLASS="EMPHASIS"
 173 >mips-lsi-elf</I
 174 >. This one
 175     runs the tests with multiple iterations using all possible
 176     combinations of the <TT
 177 CLASS="OPTION"
 178 >--soft-float</TT
 179 > and the
 180     <TT
 181 CLASS="OPTION"
 182 >--el</TT
 183 > (little endian) option. Needless to say,
 184     this last feature is mostly compiler specific.</P
 185 ></DIV
 186 ><DIV
 187 CLASS="NAVFOOTER"
 188 ><HR
 189 ALIGN="LEFT"
 190 WIDTH="100%"><TABLE
 191 WIDTH="100%"
 192 BORDER="0"
 193 CELLPADDING="0"
 194 CELLSPACING="0"
 195 ><TR
 196 ><TD
 197 WIDTH="33%"
 198 ALIGN="left"
 199 VALIGN="top"
 200 ><A
 201 HREF="customizing.html"
 202 >Prev</A
 203 ></TD
 204 ><TD
 205 WIDTH="34%"
 206 ALIGN="center"
 207 VALIGN="top"
 208 ><A
 209 HREF="book1.html"
 210 >Home</A
 211 ></TD
 212 ><TD
 213 WIDTH="33%"
 214 ALIGN="right"
 215 VALIGN="top"
 216 ><A
 217 HREF="boardconfig.html"
 218 >Next</A
 219 ></TD
 220 ></TR
 221 ><TR
 222 ><TD
 223 WIDTH="33%"
 224 ALIGN="left"
 225 VALIGN="top"
 226 >Customizing DejaGnu</TD
 227 ><TD
 228 WIDTH="34%"
 229 ALIGN="center"
 230 VALIGN="top"
 231 ><A
 232 HREF="customizing.html"
 233 >Up</A
 234 ></TD
 235 ><TD
 236 WIDTH="33%"
 237 ALIGN="right"
 238 VALIGN="top"
 239 >Board Config File</TD
 240 ></TR
 241 ></TABLE
 242 ></DIV
 243 ></BODY
 244 ></HTML
 245 >