doc/html/user-guide/setup-synth-i386linux.html

   1 <!-- Copyright (C) 2003 Red Hat, Inc.                                -->
   2 <!-- This material may be distributed only subject to the terms      -->
   3 <!-- and conditions set forth in the Open Publication License, v1.0  -->
   4 <!-- or later (the latest version is presently available at          -->
   5 <!-- http://www.opencontent.org/openpub/).                           -->
   6 <!-- Distribution of the work or derivative of the work in any       -->
   7 <!-- standard (paper) book form is prohibited unless prior           -->
   8 <!-- permission is obtained from the copyright holder.               -->
   9 <HTML
  10 ><HEAD
  11 ><TITLE
  12 >i386/Linux Synthetic Target Setup</TITLE
  13 ><meta name="MSSmartTagsPreventParsing" content="TRUE">
  14 <META
  15 NAME="GENERATOR"
  16 CONTENT="Modular DocBook HTML Stylesheet Version 1.76b+
  17 "><LINK
  18 REL="HOME"
  19 TITLE="eCos User Guide"
  20 HREF="ecos-user-guide.html"><LINK
  21 REL="UP"
  22 TITLE="Target Setup"
  23 HREF="appendix-target-setup.html"><LINK
  24 REL="PREVIOUS"
  25 TITLE="i386 PC Hardware Setup"
  26 HREF="setup-i386-pc.html"><LINK
  27 REL="NEXT"
  28 TITLE="Real-time characterization"
  29 HREF="real-time-characterization.html"></HEAD
  30 ><BODY
  31 CLASS="SECT1"
  32 BGCOLOR="#FFFFFF"
  33 TEXT="#000000"
  34 LINK="#0000FF"
  35 VLINK="#840084"
  36 ALINK="#0000FF"
  37 ><DIV
  38 CLASS="NAVHEADER"
  39 ><TABLE
  40 SUMMARY="Header navigation table"
  41 WIDTH="100%"
  42 BORDER="0"
  43 CELLPADDING="0"
  44 CELLSPACING="0"
  45 ><TR
  46 ><TH
  47 COLSPAN="3"
  48 ALIGN="center"
  49 >eCos User Guide</TH
  50 ></TR
  51 ><TR
  52 ><TD
  53 WIDTH="10%"
  54 ALIGN="left"
  55 VALIGN="bottom"
  56 ><A
  57 HREF="setup-i386-pc.html"
  58 ACCESSKEY="P"
  59 >Prev</A
  60 ></TD
  61 ><TD
  62 WIDTH="80%"
  63 ALIGN="center"
  64 VALIGN="bottom"
  65 >Appendix A. Target Setup</TD
  66 ><TD
  67 WIDTH="10%"
  68 ALIGN="right"
  69 VALIGN="bottom"
  70 ><A
  71 HREF="real-time-characterization.html"
  72 ACCESSKEY="N"
  73 >Next</A
  74 ></TD
  75 ></TR
  76 ></TABLE
  77 ><HR
  78 ALIGN="LEFT"
  79 WIDTH="100%"></DIV
  80 ><DIV
  81 CLASS="SECT1"
  82 ><H1
  83 CLASS="SECT1"
  84 ><A
  85 NAME="SETUP-SYNTH-I386LINUX">i386/Linux Synthetic Target Setup</H1
  86 ><P
  87 >When building for the synthetic Linux target, the resulting
  88 binaries are native Linux applications with the HAL providing suitable
  89 bindings between the eCos kernel and the Linux kernel.</P
  90 ><DIV
  91 CLASS="NOTE"
  92 ><BLOCKQUOTE
  93 CLASS="NOTE"
  94 ><P
  95 ><B
  96 >Note: </B
  97 >Please be aware that the current implementation of the Linux
  98 synthetic target does not allow thread-aware debugging.</P
  99 ></BLOCKQUOTE
 100 ></DIV
 101 ><P
 102 >These Linux applications cannot be run on a Windows system.
 103 However, it is possible to write a similar HAL emulation for the
 104 Windows kernel if such a testing target is desired.</P
 105 ><DIV
 106 CLASS="SECT2"
 107 ><H2
 108 CLASS="SECT2"
 109 ><A
 110 NAME="AEN4471">Tools</H2
 111 ><P
 112 >For the synthetic target, eCos relies on features not available
 113 in native compilers earlier than gcc-2.95.1. It also requires version
 114 2.9.5 or later of the GNU linker. If you have gcc-2.95.1 or later
 115 and ld version 2.9.5 or later, then you do not need to build new
 116 tools. eCos does not support earlier versions. You can check the compiler
 117 version using <B
 118 CLASS="COMMAND"
 119 >gcc -v</B
 120 >
 121 and the linker version using <B
 122 CLASS="COMMAND"
 123 >ld
 124 -v</B
 125 >.</P
 126 ><P
 127 >If you have native tools that are sufficiently recent for
 128 use with eCos, you should be aware that by default eCos assumes
 129 that the tools <B
 130 CLASS="COMMAND"
 131 >i686-pc-linux-gnu-gcc</B
 132 >, <B
 133 CLASS="COMMAND"
 134 >i686-pc-linux-gnu-ar</B
 135 >,
 136  <B
 137 CLASS="COMMAND"
 138 >i686-pc-linux-gnu-ld</B
 139 >, and <B
 140 CLASS="COMMAND"
 141 >i686-pc-linux-gnu-objcopy</B
 142 > are
 143 on your system and are the correct versions for use with eCos. But
 144 instead, you can tell eCos to use your native tools by editing the
 145 configuration value "Global command prefix" (CYGBLD_GLOBAL_COMMAND_PREFIX)
 146 in your eCos configuration. If left empty (i.e. set to the empty
 147 string) eCos will use your native tools when building.</P
 148 ><P
 149 >If you have any difficulties, it is almost certainly easiest
 150 overall to rebuild the tools as described on: <A
 151 HREF="http://sources.redhat.com/ecos/getstart.html"
 152 TARGET="_top"
 153 >http://sources.redhat.com/ecos/getstart.html</A
 154 ></P
 155 ></DIV
 156 ></DIV
 157 ><DIV
 158 CLASS="NAVFOOTER"
 159 ><HR
 160 ALIGN="LEFT"
 161 WIDTH="100%"><TABLE
 162 SUMMARY="Footer navigation table"
 163 WIDTH="100%"
 164 BORDER="0"
 165 CELLPADDING="0"
 166 CELLSPACING="0"
 167 ><TR
 168 ><TD
 169 WIDTH="33%"
 170 ALIGN="left"
 171 VALIGN="top"
 172 ><A
 173 HREF="setup-i386-pc.html"
 174 ACCESSKEY="P"
 175 >Prev</A
 176 ></TD
 177 ><TD
 178 WIDTH="34%"
 179 ALIGN="center"
 180 VALIGN="top"
 181 ><A
 182 HREF="ecos-user-guide.html"
 183 ACCESSKEY="H"
 184 >Home</A
 185 ></TD
 186 ><TD
 187 WIDTH="33%"
 188 ALIGN="right"
 189 VALIGN="top"
 190 ><A
 191 HREF="real-time-characterization.html"
 192 ACCESSKEY="N"
 193 >Next</A
 194 ></TD
 195 ></TR
 196 ><TR
 197 ><TD
 198 WIDTH="33%"
 199 ALIGN="left"
 200 VALIGN="top"
 201 >i386 PC Hardware Setup</TD
 202 ><TD
 203 WIDTH="34%"
 204 ALIGN="center"
 205 VALIGN="top"
 206 ><A
 207 HREF="appendix-target-setup.html"
 208 ACCESSKEY="U"
 209 >Up</A
 210 ></TD
 211 ><TD
 212 WIDTH="33%"
 213 ALIGN="right"
 214 VALIGN="top"
 215 >Real-time characterization</TD
 216 ></TR
 217 ></TABLE
 218 ></DIV
 219 ></BODY
 220 ></HTML
 221 >