doc/html/user-guide/notation-and-conventions.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 >Notation and Conventions</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="Introduction"
  23 HREF="user-guide-introduction.html"><LINK
  24 REL="PREVIOUS"
  25 TITLE="Previous License"
  26 HREF="ecos-licensing-previous.html"><LINK
  27 REL="NEXT"
  28 TITLE="Directory and File System Conventions"
  29 HREF="directory-and-file-system-conventions.html"></HEAD
  30 ><BODY
  31 CLASS="CHAPTER"
  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="ecos-licensing-previous.html"
  58 ACCESSKEY="P"
  59 >Prev</A
  60 ></TD
  61 ><TD
  62 WIDTH="80%"
  63 ALIGN="center"
  64 VALIGN="bottom"
  65 ></TD
  66 ><TD
  67 WIDTH="10%"
  68 ALIGN="right"
  69 VALIGN="bottom"
  70 ><A
  71 HREF="directory-and-file-system-conventions.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="CHAPTER"
  82 ><H1
  83 ><A
  84 NAME="NOTATION-AND-CONVENTIONS">Chapter 4. Notation and Conventions</H1
  85 ><DIV
  86 CLASS="TOC"
  87 ><DL
  88 ><DT
  89 ><B
  90 >Table of Contents</B
  91 ></DT
  92 ><DT
  93 ><A
  94 HREF="notation-and-conventions.html#GDB-AND-GCC-COMMAND-NOTATION"
  95 >GDB and GCC Command Notation</A
  96 ></DT
  97 ><DT
  98 ><A
  99 HREF="directory-and-file-system-conventions.html"
 100 >Directory and File System Conventions</A
 101 ></DT
 102 ><DT
 103 ><A
 104 HREF="version-conventions.html"
 105 >Version Conventions</A
 106 ></DT
 107 ></DL
 108 ></DIV
 109 ><P
 110 >Since there are many supported target architectures, notation
 111 conventions are used in this manual to avoid repeating instructions
 112 that are very similar.</P
 113 ><DIV
 114 CLASS="SECT1"
 115 ><H1
 116 CLASS="SECT1"
 117 ><A
 118 NAME="GDB-AND-GCC-COMMAND-NOTATION">GDB and GCC Command Notation</H1
 119 ><P
 120 >Cross-development commands like <B
 121 CLASS="COMMAND"
 122 >gcc</B
 123 > and
 124 <B
 125 CLASS="COMMAND"
 126 >gdb</B
 127 > will be shown with a
 128 <TT
 129 CLASS="REPLACEABLE"
 130 ><I
 131 >TARGET-</I
 132 ></TT
 133 > prefix. You need to replace
 134 <TT
 135 CLASS="REPLACEABLE"
 136 ><I
 137 >TARGET-</I
 138 ></TT
 139 > with the correct prefix before
 140 using the command. Just using <B
 141 CLASS="COMMAND"
 142 >gcc</B
 143 > or
 144 <B
 145 CLASS="COMMAND"
 146 >gdb</B
 147 > will use the tools for the host, which is not
 148 (usually) what you want.</P
 149 ><P
 150 >For example use <B
 151 CLASS="COMMAND"
 152 >arm-elf-gcc</B
 153 > and
 154 <B
 155 CLASS="COMMAND"
 156 >arm-elf-gdb</B
 157 > for ARM, Thumb, and StrongARM targets.
 158 Use <B
 159 CLASS="COMMAND"
 160 >xscale-elf-gcc</B
 161 > and
 162 <B
 163 CLASS="COMMAND"
 164 >xscale-elf-gdb</B
 165 > for Intel Xscale targets.
 166 Use <B
 167 CLASS="COMMAND"
 168 >i386-elf-gcc</B
 169 > and
 170 <B
 171 CLASS="COMMAND"
 172 >i386-elf-gdb</B
 173 > for IA32 targets. And so on, the exact
 174 prefix to use is shown in the documentation for each target.</P
 175 ><P
 176 >Note that some versions of the GCC cross compiler generate
 177 executable files with the <TT
 178 CLASS="FILENAME"
 179 >.exe</TT
 180 > suffix on Windows,
 181 but not on Linux. The suffix <TT
 182 CLASS="FILENAME"
 183 >.exe</TT
 184 > will be omitted
 185 from executable file names, so you will see <TT
 186 CLASS="FILENAME"
 187 >hello</TT
 188 >
 189 instead of <TT
 190 CLASS="FILENAME"
 191 >hello.exe</TT
 192 >.</P
 193 ></DIV
 194 ></DIV
 195 ><DIV
 196 CLASS="NAVFOOTER"
 197 ><HR
 198 ALIGN="LEFT"
 199 WIDTH="100%"><TABLE
 200 SUMMARY="Footer navigation table"
 201 WIDTH="100%"
 202 BORDER="0"
 203 CELLPADDING="0"
 204 CELLSPACING="0"
 205 ><TR
 206 ><TD
 207 WIDTH="33%"
 208 ALIGN="left"
 209 VALIGN="top"
 210 ><A
 211 HREF="ecos-licensing-previous.html"
 212 ACCESSKEY="P"
 213 >Prev</A
 214 ></TD
 215 ><TD
 216 WIDTH="34%"
 217 ALIGN="center"
 218 VALIGN="top"
 219 ><A
 220 HREF="ecos-user-guide.html"
 221 ACCESSKEY="H"
 222 >Home</A
 223 ></TD
 224 ><TD
 225 WIDTH="33%"
 226 ALIGN="right"
 227 VALIGN="top"
 228 ><A
 229 HREF="directory-and-file-system-conventions.html"
 230 ACCESSKEY="N"
 231 >Next</A
 232 ></TD
 233 ></TR
 234 ><TR
 235 ><TD
 236 WIDTH="33%"
 237 ALIGN="left"
 238 VALIGN="top"
 239 >Previous License</TD
 240 ><TD
 241 WIDTH="34%"
 242 ALIGN="center"
 243 VALIGN="top"
 244 ><A
 245 HREF="user-guide-introduction.html"
 246 ACCESSKEY="U"
 247 >Up</A
 248 ></TD
 249 ><TD
 250 WIDTH="33%"
 251 ALIGN="right"
 252 VALIGN="top"
 253 >Directory and File System Conventions</TD
 254 ></TR
 255 ></TABLE
 256 ></DIV
 257 ></BODY
 258 ></HTML
 259 >