boarddefs.html   [plain text]


<!DOCTYPE HTML PUBLIC "-//W3C//DTD HTML 4.01//EN">
<HTML
><HEAD
><TITLE
>Board Config File Values</TITLE
><META
NAME="GENERATOR"
CONTENT="Modular DocBook HTML Stylesheet Version 1.64
"><LINK
REL="HOME"
TITLE="DejaGnu"
HREF="book1.html"><LINK
REL="UP"
TITLE="Extending DejaGnu"
HREF="extending.html"><LINK
REL="PREVIOUS"
TITLE="Adding A New Board"
HREF="addboard.html"><LINK
REL="NEXT"
TITLE="Writing A Test Case"
HREF="writing.html"></HEAD
><BODY
CLASS="SECT1"
BGCOLOR="#FFFFFF"
TEXT="#000000"
LINK="#0000FF"
VLINK="#840084"
ALINK="#0000FF"
><DIV
CLASS="NAVHEADER"
><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="addboard.html"
>&#60;&#60;&#60; Previous</A
></TD
><TD
WIDTH="80%"
ALIGN="center"
VALIGN="bottom"
>Extending DejaGnu</TD
><TD
WIDTH="10%"
ALIGN="right"
VALIGN="bottom"
><A
HREF="writing.html"
>Next &#62;&#62;&#62;</A
></TD
></TR
></TABLE
><HR
ALIGN="LEFT"
WIDTH="100%"></DIV
><DIV
CLASS="SECT1"
><H1
CLASS="SECT1"
><A
NAME="BOARDDEFS"
>Board Config File Values</A
></H1
><P
>These fields are all in the <SPAN
CLASS="SYMBOL"
>board_info</SPAN
> These are
      all set by using the <TT
CLASS="FUNCTION"
>set_board_info</TT
> procedure. The
      parameters are the field name, followed by the value to set the field
      to.</P
><P
><DIV
CLASS="TABLE"
><A
NAME="AEN1240"
></A
><P
><B
>Table 1. Common Board Info Fields</B
></P
><TABLE
BORDER="1"
BGCOLOR="#E0E0E0"
CELLSPACING="0"
CELLPADDING="4"
CLASS="CALSTABLE"
><THEAD
><TR
><TH
ALIGN="LEFT"
VALIGN="TOP"
>Field</TH
><TH
ALIGN="LEFT"
VALIGN="TOP"
>Sample Value</TH
><TH
ALIGN="LEFT"
VALIGN="TOP"
>Description</TH
></TR
></THEAD
><TBODY
><TR
><TD
ALIGN="LEFT"
VALIGN="TOP"
>compiler</TD
><TD
ALIGN="LEFT"
VALIGN="TOP"
>"[find_gcc]"</TD
><TD
ALIGN="LEFT"
VALIGN="TOP"
>The path to the compiler to use.</TD
></TR
><TR
><TD
ALIGN="LEFT"
VALIGN="TOP"
>cflags</TD
><TD
ALIGN="LEFT"
VALIGN="TOP"
>"-mca"</TD
><TD
ALIGN="LEFT"
VALIGN="TOP"
>Compilation flags for the compiler.</TD
></TR
><TR
><TD
ALIGN="LEFT"
VALIGN="TOP"
>ldflags</TD
><TD
ALIGN="LEFT"
VALIGN="TOP"
>"[libgloss_link_flags] [newlib_link_flags]"</TD
><TD
ALIGN="LEFT"
VALIGN="TOP"
>Linking flags for the compiler.</TD
></TR
><TR
><TD
ALIGN="LEFT"
VALIGN="TOP"
>ldscript</TD
><TD
ALIGN="LEFT"
VALIGN="TOP"
>"-Wl,-Tidt.ld"</TD
><TD
ALIGN="LEFT"
VALIGN="TOP"
>The linker script to use when cross compiling.</TD
></TR
><TR
><TD
ALIGN="LEFT"
VALIGN="TOP"
>libs</TD
><TD
ALIGN="LEFT"
VALIGN="TOP"
>"-lgcc"</TD
><TD
ALIGN="LEFT"
VALIGN="TOP"
>Any additional libraries to link in.</TD
></TR
><TR
><TD
ALIGN="LEFT"
VALIGN="TOP"
>shell_prompt</TD
><TD
ALIGN="LEFT"
VALIGN="TOP"
>"cygmon&#62;"</TD
><TD
ALIGN="LEFT"
VALIGN="TOP"
>The command prompt of the remote shell.</TD
></TR
><TR
><TD
ALIGN="LEFT"
VALIGN="TOP"
>hex_startaddr</TD
><TD
ALIGN="LEFT"
VALIGN="TOP"
>"0xa0020000"</TD
><TD
ALIGN="LEFT"
VALIGN="TOP"
>The Starting address as a string.</TD
></TR
><TR
><TD
ALIGN="LEFT"
VALIGN="TOP"
>start_addr</TD
><TD
ALIGN="LEFT"
VALIGN="TOP"
>0xa0008000</TD
><TD
ALIGN="LEFT"
VALIGN="TOP"
>The starting address as a value.</TD
></TR
><TR
><TD
ALIGN="LEFT"
VALIGN="TOP"
>startaddr</TD
><TD
ALIGN="LEFT"
VALIGN="TOP"
>"a0020000"</TD
><TD
ALIGN="LEFT"
VALIGN="TOP"
>&nbsp;</TD
></TR
><TR
><TD
ALIGN="LEFT"
VALIGN="TOP"
>exit_statuses_bad</TD
><TD
ALIGN="LEFT"
VALIGN="TOP"
>1</TD
><TD
ALIGN="LEFT"
VALIGN="TOP"
>Whether there is an accurate exit status.</TD
></TR
><TR
><TD
ALIGN="LEFT"
VALIGN="TOP"
>reboot_delay</TD
><TD
ALIGN="LEFT"
VALIGN="TOP"
>10</TD
><TD
ALIGN="LEFT"
VALIGN="TOP"
>The delay between power off and power on.</TD
></TR
><TR
><TD
ALIGN="LEFT"
VALIGN="TOP"
>unreliable</TD
><TD
ALIGN="LEFT"
VALIGN="TOP"
>1</TD
><TD
ALIGN="LEFT"
VALIGN="TOP"
>Whether communication with the board is unreliable.</TD
></TR
><TR
><TD
ALIGN="LEFT"
VALIGN="TOP"
>sim</TD
><TD
ALIGN="LEFT"
VALIGN="TOP"
>[find_sim]</TD
><TD
ALIGN="LEFT"
VALIGN="TOP"
>The path to the simulator to use.</TD
></TR
><TR
><TD
ALIGN="LEFT"
VALIGN="TOP"
>objcopy</TD
><TD
ALIGN="LEFT"
VALIGN="TOP"
>$tempfil</TD
><TD
ALIGN="LEFT"
VALIGN="TOP"
>The path to the <B
CLASS="COMMAND"
>objcopy</B
> program.</TD
></TR
><TR
><TD
ALIGN="LEFT"
VALIGN="TOP"
>support_libs</TD
><TD
ALIGN="LEFT"
VALIGN="TOP"
>"${prefix_dir}/i386-coff/"</TD
><TD
ALIGN="LEFT"
VALIGN="TOP"
>Support libraries needed for cross compiling.</TD
></TR
><TR
><TD
ALIGN="LEFT"
VALIGN="TOP"
>addl_link_flags</TD
><TD
ALIGN="LEFT"
VALIGN="TOP"
>"-N"</TD
><TD
ALIGN="LEFT"
VALIGN="TOP"
>Additional link flags, rarely used.</TD
></TR
></TBODY
></TABLE
></DIV
>
	</P
><P
>These fields are used by the GCC and GDB tests, and are mostly
	 only useful to somewhat trying to debug a new board file for one of
	 these tools. Many of these are used only by a few testcases, and their
	 purpose is esoteric. These are listed with sample values as a guide to
	 better guessing if you need to change any of these.</P
><P
><DIV
CLASS="TABLE"
><A
NAME="AEN1316"
></A
><P
><B
>Table 2. Board Info Fields For GCC &#38; GDB</B
></P
><TABLE
BORDER="1"
BGCOLOR="#E0E0E0"
CELLSPACING="0"
CELLPADDING="4"
CLASS="CALSTABLE"
><THEAD
><TR
><TH
ALIGN="LEFT"
VALIGN="TOP"
>Field</TH
><TH
ALIGN="LEFT"
VALIGN="TOP"
>Sample Value</TH
><TH
ALIGN="LEFT"
VALIGN="TOP"
>Description</TH
></TR
></THEAD
><TBODY
><TR
><TD
ALIGN="LEFT"
VALIGN="TOP"
>strip</TD
><TD
ALIGN="LEFT"
VALIGN="TOP"
>$tempfile</TD
><TD
ALIGN="LEFT"
VALIGN="TOP"
>Strip the executable of symbols.</TD
></TR
><TR
><TD
ALIGN="LEFT"
VALIGN="TOP"
>gdb_load_offset</TD
><TD
ALIGN="LEFT"
VALIGN="TOP"
>"0x40050000"</TD
><TD
>&nbsp;</TD
></TR
><TR
><TD
ALIGN="LEFT"
VALIGN="TOP"
>gdb_protocol</TD
><TD
ALIGN="LEFT"
VALIGN="TOP"
>"remote"</TD
><TD
ALIGN="LEFT"
VALIGN="TOP"
>The GDB debugging protocol to use.</TD
></TR
><TR
><TD
ALIGN="LEFT"
VALIGN="TOP"
>gdb_sect_offset</TD
><TD
ALIGN="LEFT"
VALIGN="TOP"
>"0x41000000";</TD
><TD
>&nbsp;</TD
></TR
><TR
><TD
ALIGN="LEFT"
VALIGN="TOP"
>gdb_stub_ldscript</TD
><TD
ALIGN="LEFT"
VALIGN="TOP"
>"-Wl,-Teva-stub.ld"</TD
><TD
ALIGN="LEFT"
VALIGN="TOP"
>The linker script to use with a GDB stub.</TD
></TR
><TR
><TD
ALIGN="LEFT"
VALIGN="TOP"
>gdb_init_command</TD
><TD
ALIGN="LEFT"
VALIGN="TOP"
>"set mipsfpu none"</TD
><TD
>&nbsp;</TD
></TR
><TR
><TD
ALIGN="LEFT"
VALIGN="TOP"
>gdb,cannot_call_functions</TD
><TD
ALIGN="LEFT"
VALIGN="TOP"
>1</TD
><TD
ALIGN="LEFT"
VALIGN="TOP"
>Whether GDB can call functions on the target,</TD
></TR
><TR
><TD
ALIGN="LEFT"
VALIGN="TOP"
>gdb,noargs</TD
><TD
ALIGN="LEFT"
VALIGN="TOP"
>1</TD
><TD
ALIGN="LEFT"
VALIGN="TOP"
>Whether the target can take command line arguments.</TD
></TR
><TR
><TD
ALIGN="LEFT"
VALIGN="TOP"
>gdb,nosignals</TD
><TD
ALIGN="LEFT"
VALIGN="TOP"
>1</TD
><TD
ALIGN="LEFT"
VALIGN="TOP"
>Whether there are signals on the target.</TD
></TR
><TR
><TD
ALIGN="LEFT"
VALIGN="TOP"
>gdb,short_int</TD
><TD
ALIGN="LEFT"
VALIGN="TOP"
>1</TD
><TD
>&nbsp;</TD
></TR
><TR
><TD
ALIGN="LEFT"
VALIGN="TOP"
>gdb,start_symbol</TD
><TD
ALIGN="LEFT"
VALIGN="TOP"
>"_start";</TD
><TD
ALIGN="LEFT"
VALIGN="TOP"
>The starting symbol in the executable.</TD
></TR
><TR
><TD
ALIGN="LEFT"
VALIGN="TOP"
>gdb,target_sim_options</TD
><TD
ALIGN="LEFT"
VALIGN="TOP"
>"-sparclite"</TD
><TD
ALIGN="LEFT"
VALIGN="TOP"
>Special options to pass to the simulator.</TD
></TR
><TR
><TD
ALIGN="LEFT"
VALIGN="TOP"
>gdb,timeout</TD
><TD
ALIGN="LEFT"
VALIGN="TOP"
>540</TD
><TD
ALIGN="LEFT"
VALIGN="TOP"
>Timeout value to use for remote communication.</TD
></TR
><TR
><TD
ALIGN="LEFT"
VALIGN="TOP"
>gdb_init_command</TD
><TD
ALIGN="LEFT"
VALIGN="TOP"
>"print/x \$fsr = 0x0"</TD
><TD
>&nbsp;</TD
></TR
><TR
><TD
ALIGN="LEFT"
VALIGN="TOP"
>gdb_load_offset</TD
><TD
ALIGN="LEFT"
VALIGN="TOP"
>"0x12020000"</TD
><TD
>&nbsp;</TD
></TR
><TR
><TD
ALIGN="LEFT"
VALIGN="TOP"
>gdb_opts</TD
><TD
ALIGN="LEFT"
VALIGN="TOP"
>"--command gdbinit"</TD
><TD
>&nbsp;</TD
></TR
><TR
><TD
ALIGN="LEFT"
VALIGN="TOP"
>gdb_prompt</TD
><TD
ALIGN="LEFT"
VALIGN="TOP"
>"\\(gdb960\\)"</TD
><TD
ALIGN="LEFT"
VALIGN="TOP"
>The prompt GDB is using.</TD
></TR
><TR
><TD
ALIGN="LEFT"
VALIGN="TOP"
>gdb_run_command</TD
><TD
ALIGN="LEFT"
VALIGN="TOP"
>"jump start"</TD
><TD
>&nbsp;</TD
></TR
><TR
><TD
ALIGN="LEFT"
VALIGN="TOP"
>gdb_stub_offset</TD
><TD
ALIGN="LEFT"
VALIGN="TOP"
>"0x12010000"</TD
><TD
>&nbsp;</TD
></TR
><TR
><TD
ALIGN="LEFT"
VALIGN="TOP"
>use_gdb_stub</TD
><TD
ALIGN="LEFT"
VALIGN="TOP"
>1</TD
><TD
ALIGN="LEFT"
VALIGN="TOP"
>Whether to use a GDB stub.</TD
></TR
><TR
><TD
ALIGN="LEFT"
VALIGN="TOP"
>use_vma_offset</TD
><TD
ALIGN="LEFT"
VALIGN="TOP"
>1</TD
><TD
>&nbsp;</TD
></TR
><TR
><TD
ALIGN="LEFT"
VALIGN="TOP"
>wrap_m68k_aout</TD
><TD
ALIGN="LEFT"
VALIGN="TOP"
>1</TD
><TD
>&nbsp;</TD
></TR
><TR
><TD
ALIGN="LEFT"
VALIGN="TOP"
>gcc,no_label_values</TD
><TD
ALIGN="LEFT"
VALIGN="TOP"
>1</TD
><TD
>&nbsp;</TD
></TR
><TR
><TD
ALIGN="LEFT"
VALIGN="TOP"
>gcc,no_trampolines</TD
><TD
ALIGN="LEFT"
VALIGN="TOP"
>1</TD
><TD
>&nbsp;</TD
></TR
><TR
><TD
ALIGN="LEFT"
VALIGN="TOP"
>gcc,no_varargs</TD
><TD
ALIGN="LEFT"
VALIGN="TOP"
>1</TD
><TD
>&nbsp;</TD
></TR
><TR
><TD
ALIGN="LEFT"
VALIGN="TOP"
>gcc,stack_size</TD
><TD
ALIGN="LEFT"
VALIGN="TOP"
>16384</TD
><TD
ALIGN="LEFT"
VALIGN="TOP"
>Stack size to use with some GCC testcases.</TD
></TR
><TR
><TD
ALIGN="LEFT"
VALIGN="TOP"
>ieee_multilib_flags</TD
><TD
ALIGN="LEFT"
VALIGN="TOP"
>"-mieee";</TD
><TD
>&nbsp;</TD
></TR
><TR
><TD
ALIGN="LEFT"
VALIGN="TOP"
>is_simulator</TD
><TD
ALIGN="LEFT"
VALIGN="TOP"
>1</TD
><TD
>&nbsp;</TD
></TR
><TR
><TD
ALIGN="LEFT"
VALIGN="TOP"
>needs_status_wrapper</TD
><TD
ALIGN="LEFT"
VALIGN="TOP"
>1</TD
><TD
>&nbsp;</TD
></TR
><TR
><TD
ALIGN="LEFT"
VALIGN="TOP"
>no_double</TD
><TD
ALIGN="LEFT"
VALIGN="TOP"
>1</TD
><TD
>&nbsp;</TD
></TR
><TR
><TD
ALIGN="LEFT"
VALIGN="TOP"
>no_long_long</TD
><TD
ALIGN="LEFT"
VALIGN="TOP"
>1</TD
><TD
>&nbsp;</TD
></TR
><TR
><TD
ALIGN="LEFT"
VALIGN="TOP"
>noargs</TD
><TD
ALIGN="LEFT"
VALIGN="TOP"
>1</TD
><TD
>&nbsp;</TD
></TR
><TR
><TD
ALIGN="LEFT"
VALIGN="TOP"
>nullstone,lib</TD
><TD
ALIGN="LEFT"
VALIGN="TOP"
>"mips-clock.c"</TD
><TD
>&nbsp;</TD
></TR
><TR
><TD
ALIGN="LEFT"
VALIGN="TOP"
>nullstone,ticks_per_sec</TD
><TD
ALIGN="LEFT"
VALIGN="TOP"
>3782018</TD
><TD
>&nbsp;</TD
></TR
><TR
><TD
ALIGN="LEFT"
VALIGN="TOP"
>sys_speed_value</TD
><TD
ALIGN="LEFT"
VALIGN="TOP"
>200</TD
><TD
>&nbsp;</TD
></TR
><TR
><TD
ALIGN="LEFT"
VALIGN="TOP"
>target_install</TD
><TD
ALIGN="LEFT"
VALIGN="TOP"
>{sh-hms}</TD
><TD
>&nbsp;</TD
></TR
></TBODY
></TABLE
></DIV
>
	</P
></DIV
><DIV
CLASS="NAVFOOTER"
><HR
ALIGN="LEFT"
WIDTH="100%"><TABLE
WIDTH="100%"
BORDER="0"
CELLPADDING="0"
CELLSPACING="0"
><TR
><TD
WIDTH="33%"
ALIGN="left"
VALIGN="top"
><A
HREF="addboard.html"
>&#60;&#60;&#60; Previous</A
></TD
><TD
WIDTH="34%"
ALIGN="center"
VALIGN="top"
><A
HREF="book1.html"
>Home</A
></TD
><TD
WIDTH="33%"
ALIGN="right"
VALIGN="top"
><A
HREF="writing.html"
>Next &#62;&#62;&#62;</A
></TD
></TR
><TR
><TD
WIDTH="33%"
ALIGN="left"
VALIGN="top"
>Adding A New Board</TD
><TD
WIDTH="34%"
ALIGN="center"
VALIGN="top"
><A
HREF="extending.html"
>Up</A
></TD
><TD
WIDTH="33%"
ALIGN="right"
VALIGN="top"
>Writing A Test Case</TD
></TR
></TABLE
></DIV
></BODY
></HTML
>