~ubuntu-branches/ubuntu/feisty/dejagnu/feisty

« back to all changes in this revision

Viewing changes to doc/html/x935.html

  • Committer: Bazaar Package Importer
  • Author(s): Daniel Jacobowitz
  • Date: 2004-02-09 15:07:58 UTC
  • Revision ID: james.westby@ubuntu.com-20040209150758-oaj7r5zrop60v8sb
Tags: upstream-1.4.4
ImportĀ upstreamĀ versionĀ 1.4.4

Show diffs side-by-side

added added

removed removed

Lines of Context:
 
1
<!DOCTYPE HTML PUBLIC "-//W3C//DTD HTML 4.01//EN">
 
2
<HTML
 
3
><HEAD
 
4
><TITLE
 
5
>Board Config File</TITLE
 
6
><META
 
7
NAME="GENERATOR"
 
8
CONTENT="Modular DocBook HTML Stylesheet Version 1.76b+
 
9
"><LINK
 
10
REL="HOME"
 
11
TITLE="DejaGnu"
 
12
HREF="book1.html"><LINK
 
13
REL="UP"
 
14
TITLE="Customizing DejaGnu"
 
15
HREF="c848.html"><LINK
 
16
REL="PREVIOUS"
 
17
TITLE="Global Config File"
 
18
HREF="x916.html"><LINK
 
19
REL="NEXT"
 
20
TITLE="Remote Host Testing"
 
21
HREF="x953.html"></HEAD
 
22
><BODY
 
23
CLASS="SECT1"
 
24
BGCOLOR="#FFFFFF"
 
25
TEXT="#000000"
 
26
LINK="#0000FF"
 
27
VLINK="#840084"
 
28
ALINK="#0000FF"
 
29
><DIV
 
30
CLASS="NAVHEADER"
 
31
><TABLE
 
32
SUMMARY="Header navigation table"
 
33
WIDTH="100%"
 
34
BORDER="0"
 
35
CELLPADDING="0"
 
36
CELLSPACING="0"
 
37
><TR
 
38
><TH
 
39
COLSPAN="3"
 
40
ALIGN="center"
 
41
>DejaGnu: The GNU Testing Framework</TH
 
42
></TR
 
43
><TR
 
44
><TD
 
45
WIDTH="10%"
 
46
ALIGN="left"
 
47
VALIGN="bottom"
 
48
><A
 
49
HREF="x916.html"
 
50
ACCESSKEY="P"
 
51
>&#60;&#60;&#60; Previous</A
 
52
></TD
 
53
><TD
 
54
WIDTH="80%"
 
55
ALIGN="center"
 
56
VALIGN="bottom"
 
57
>Customizing DejaGnu</TD
 
58
><TD
 
59
WIDTH="10%"
 
60
ALIGN="right"
 
61
VALIGN="bottom"
 
62
><A
 
63
HREF="x953.html"
 
64
ACCESSKEY="N"
 
65
>Next &#62;&#62;&#62;</A
 
66
></TD
 
67
></TR
 
68
></TABLE
 
69
><HR
 
70
ALIGN="LEFT"
 
71
WIDTH="100%"></DIV
 
72
><DIV
 
73
CLASS="SECT1"
 
74
><H1
 
75
CLASS="SECT1"
 
76
><A
 
77
NAME="BOARDCONFIG"
 
78
></A
 
79
>Board Config File</H1
 
80
><P
 
81
>The board config file is where board specfic config data
 
82
      is stored. A board config file contains all the higher-level
 
83
      configuration settings. There is a rough inheritance scheme, where it is
 
84
      possible to base a new board description file on an existing one. There
 
85
      are also collections of custom procedures for common environments. For
 
86
      more information on adding a new board config file, go to the <A
 
87
HREF="x1214.html"
 
88
>Adding A New Board</A
 
89
> chapter. </P
 
90
><P
 
91
>An example board config file for a GNU simulator is as
 
92
      follows. <TT
 
93
CLASS="FUNCTION"
 
94
>set_board_info</TT
 
95
> is a procedure that sets the
 
96
      field name to the specified value. The procedures in square brackets
 
97
      <I
 
98
CLASS="EMPHASIS"
 
99
>[]</I
 
100
> are <I
 
101
CLASS="EMPHASIS"
 
102
>helper procedures</I
 
103
>. Thes
 
104
      are used to find parts of a tool chain required to build an executable
 
105
      image that may reside in various locations. This is mostly of use for
 
106
      when the startup code, the standard C lobraries, or the tool chain itself
 
107
      is part of your build tree.</P
 
108
><DIV
 
109
CLASS="EXAMPLE"
 
110
><A
 
111
NAME="AEN943"
 
112
></A
 
113
><P
 
114
><B
 
115
>Example 5. Board Config File</B
 
116
></P
 
117
><TABLE
 
118
BORDER="0"
 
119
BGCOLOR="#E0E0E0"
 
120
WIDTH="100%"
 
121
><TR
 
122
><TD
 
123
><PRE
 
124
CLASS="PROGRAMLISTING"
 
125
>      # This is a list of toolchains that are supported on this board.
 
126
      set_board_info target_install {sparc64-elf}
 
127
 
 
128
      # Load the generic configuration for this board. This will define any
 
129
      # routines needed by the tool to communicate with the board.
 
130
      load_generic_config "sim"
 
131
 
 
132
      # We need this for find_gcc and *_include_flags/*_link_flags.
 
133
      load_base_board_description "basic-sim"
 
134
 
 
135
      # Use long64 by default.
 
136
      process_multilib_options "long64"
 
137
 
 
138
      setup_sim sparc64
 
139
 
 
140
      # We only support newlib on this target. We assume that all multilib
 
141
      # options have been specified before we get here.
 
142
      set_board_info compiler  "[find_gcc]"
 
143
      set_board_info cflags  "[libgloss_include_flags] [newlib_include_flags]"
 
144
      set_board_info ldflags  "[libgloss_link_flags] [newlib_link_flags]"
 
145
      # No linker script.
 
146
      set_board_info ldscript "";
 
147
 
 
148
      # Used by a few gcc.c-torture testcases to delimit how large the
 
149
      # stack can be.
 
150
      set_board_info gcc,stack_size 16384
 
151
      # The simulator doesn't return exit statuses and we need to indicate this
 
152
      # the standard GCC wrapper will work with this target.
 
153
      set_board_info needs_status_wrapper 1
 
154
      # We can't pass arguments to programs.
 
155
      set_board_info noargs 1
 
156
      </PRE
 
157
></TD
 
158
></TR
 
159
></TABLE
 
160
></DIV
 
161
><P
 
162
>There are five helper procedures used in this example. The first
 
163
     one, <TT
 
164
CLASS="FUNCTION"
 
165
>find gcc</TT
 
166
> looks for a copy of the GNU compiler in
 
167
     your build tree, or it uses the one in your path. This will also return
 
168
     the proper transformed name for a cross compiler if you whole build tree
 
169
     is configured for one. The next helper procedures are
 
170
     <TT
 
171
CLASS="FUNCTION"
 
172
>libgloss_include_flags</TT
 
173
> &#38;
 
174
     <TT
 
175
CLASS="FUNCTION"
 
176
>libgloss_link_flags</TT
 
177
>. These return the proper flags to
 
178
     compiler and link an executable image using <A
 
179
HREF="x1655.html#LIBGLOSS"
 
180
>Libgloss</A
 
181
>, the GNU BSP (Board Support Package). The final
 
182
     procedures are <TT
 
183
CLASS="FUNCTION"
 
184
>newlib_include_flag</TT
 
185
> &#38;
 
186
     <TT
 
187
CLASS="FUNCTION"
 
188
>newlib_include_flag</TT
 
189
>. These find the Newlib C
 
190
     library, which is a reentrant standard C library for embedded systems
 
191
     comprising of non GPL'd code.</P
 
192
></DIV
 
193
><DIV
 
194
CLASS="NAVFOOTER"
 
195
><HR
 
196
ALIGN="LEFT"
 
197
WIDTH="100%"><TABLE
 
198
SUMMARY="Footer navigation table"
 
199
WIDTH="100%"
 
200
BORDER="0"
 
201
CELLPADDING="0"
 
202
CELLSPACING="0"
 
203
><TR
 
204
><TD
 
205
WIDTH="33%"
 
206
ALIGN="left"
 
207
VALIGN="top"
 
208
><A
 
209
HREF="x916.html"
 
210
ACCESSKEY="P"
 
211
>&#60;&#60;&#60; Previous</A
 
212
></TD
 
213
><TD
 
214
WIDTH="34%"
 
215
ALIGN="center"
 
216
VALIGN="top"
 
217
><A
 
218
HREF="book1.html"
 
219
ACCESSKEY="H"
 
220
>Home</A
 
221
></TD
 
222
><TD
 
223
WIDTH="33%"
 
224
ALIGN="right"
 
225
VALIGN="top"
 
226
><A
 
227
HREF="x953.html"
 
228
ACCESSKEY="N"
 
229
>Next &#62;&#62;&#62;</A
 
230
></TD
 
231
></TR
 
232
><TR
 
233
><TD
 
234
WIDTH="33%"
 
235
ALIGN="left"
 
236
VALIGN="top"
 
237
>Global Config File</TD
 
238
><TD
 
239
WIDTH="34%"
 
240
ALIGN="center"
 
241
VALIGN="top"
 
242
><A
 
243
HREF="c848.html"
 
244
ACCESSKEY="U"
 
245
>Up</A
 
246
></TD
 
247
><TD
 
248
WIDTH="33%"
 
249
ALIGN="right"
 
250
VALIGN="top"
 
251
>Remote Host Testing</TD
 
252
></TR
 
253
></TABLE
 
254
></DIV
 
255
></BODY
 
256
></HTML
 
257
>
 
 
b'\\ No newline at end of file'