URL https://opencores.org/ocsvn/openrisc_me/openrisc_me/trunk

Subversion Repositories openrisc_me

[/] [openrisc/] [trunk/] [rtos/] [ecos-2.0/] [doc/] [html/] [user-guide/] [notation-and-conventions.html] - Blame information for rev 446

Go to most recent revision | Details | Compare with Previous | View Log


<!-- Copyright (C) 2003 Red Hat, Inc.                                -->
<!-- This material may be distributed only subject to the terms      -->
<!-- and conditions set forth in the Open Publication License, v1.0  -->
<!-- or later (the latest version is presently available at          -->
<!-- http://www.opencontent.org/openpub/).                           -->
<!-- Distribution of the work or derivative of the work in any       -->
<!-- standard (paper) book form is prohibited unless prior           -->
<!-- permission is obtained from the copyright holder.               -->
<HTML
><HEAD
><TITLE
>Notation and Conventions</TITLE
><meta name="MSSmartTagsPreventParsing" content="TRUE">
<META
NAME="GENERATOR"
CONTENT="Modular DocBook HTML Stylesheet Version 1.76b+
"><LINK
REL="HOME"
TITLE="eCos User Guide"
HREF="ecos-user-guide.html"><LINK
REL="UP"
TITLE="Introduction"
HREF="user-guide-introduction.html"><LINK
REL="PREVIOUS"
TITLE="Previous License"
HREF="ecos-licensing-previous.html"><LINK
REL="NEXT"
TITLE="Directory and File System Conventions"
HREF="directory-and-file-system-conventions.html"></HEAD
><BODY
CLASS="CHAPTER"
BGCOLOR="#FFFFFF"
TEXT="#000000"
LINK="#0000FF"
VLINK="#840084"
ALINK="#0000FF"
><DIV
CLASS="NAVHEADER"
><TABLE
SUMMARY="Header navigation table"
WIDTH="100%"
BORDER="0"
CELLPADDING="0"
CELLSPACING="0"
><TR
><TH
COLSPAN="3"
ALIGN="center"
>eCos User Guide</TH
></TR
><TR
><TD
WIDTH="10%"
ALIGN="left"
VALIGN="bottom"
><A
HREF="ecos-licensing-previous.html"
ACCESSKEY="P"
>Prev</A
></TD
><TD
WIDTH="80%"
ALIGN="center"
VALIGN="bottom"
></TD
><TD
WIDTH="10%"
ALIGN="right"
VALIGN="bottom"
><A
HREF="directory-and-file-system-conventions.html"
ACCESSKEY="N"
>Next</A
></TD
></TR
></TABLE
><HR
ALIGN="LEFT"
WIDTH="100%"></DIV
><DIV
CLASS="CHAPTER"
><H1
><A
NAME="NOTATION-AND-CONVENTIONS">Chapter 4. Notation and Conventions</H1
><DIV
CLASS="TOC"
><DL
><DT
><B
>Table of Contents</B
></DT
><DT
><A
HREF="notation-and-conventions.html#GDB-AND-GCC-COMMAND-NOTATION"
>GDB and GCC Command Notation</A
></DT
><DT
><A
HREF="directory-and-file-system-conventions.html"
>Directory and File System Conventions</A
></DT
><DT
><A
HREF="version-conventions.html"
>Version Conventions</A
></DT
></DL
></DIV
><P
>Since there are many supported target architectures, notation
conventions are used in this manual to avoid repeating instructions
that are very similar.</P
><DIV
CLASS="SECT1"
><H1
CLASS="SECT1"
><A
NAME="GDB-AND-GCC-COMMAND-NOTATION">GDB and GCC Command Notation</H1
><P
>Cross-development commands like <B
CLASS="COMMAND"
>gcc</B
> and
<B
CLASS="COMMAND"
>gdb</B
> will be shown with a
<TT
CLASS="REPLACEABLE"
><I
>TARGET-</I
></TT
> prefix. You need to replace
<TT
CLASS="REPLACEABLE"
><I
>TARGET-</I
></TT
> with the correct prefix before
using the command. Just using <B
CLASS="COMMAND"
>gcc</B
> or
<B
CLASS="COMMAND"
>gdb</B
> will use the tools for the host, which is not
(usually) what you want.</P
><P
>For example use <B
CLASS="COMMAND"
>arm-elf-gcc</B
> and
<B
CLASS="COMMAND"
>arm-elf-gdb</B
> for ARM, Thumb, and StrongARM targets.
Use <B
CLASS="COMMAND"
>xscale-elf-gcc</B
> and
<B
CLASS="COMMAND"
>xscale-elf-gdb</B
> for Intel Xscale targets.
Use <B
CLASS="COMMAND"
>i386-elf-gcc</B
> and
<B
CLASS="COMMAND"
>i386-elf-gdb</B
> for IA32 targets. And so on, the exact
prefix to use is shown in the documentation for each target.</P
><P
>Note that some versions of the GCC cross compiler generate
executable files with the <TT
CLASS="FILENAME"
>.exe</TT
> suffix on Windows,
but not on Linux. The suffix <TT
CLASS="FILENAME"
>.exe</TT
> will be omitted
from executable file names, so you will see <TT
CLASS="FILENAME"
>hello</TT
>
instead of <TT
CLASS="FILENAME"
>hello.exe</TT
>.</P
></DIV
></DIV
><DIV
CLASS="NAVFOOTER"
><HR
ALIGN="LEFT"
WIDTH="100%"><TABLE
SUMMARY="Footer navigation table"
WIDTH="100%"
BORDER="0"
CELLPADDING="0"
CELLSPACING="0"
><TR
><TD
WIDTH="33%"
ALIGN="left"
VALIGN="top"
><A
HREF="ecos-licensing-previous.html"
ACCESSKEY="P"
>Prev</A
></TD
><TD
WIDTH="34%"
ALIGN="center"
VALIGN="top"
><A
HREF="ecos-user-guide.html"
ACCESSKEY="H"
>Home</A
></TD
><TD
WIDTH="33%"
ALIGN="right"
VALIGN="top"
><A
HREF="directory-and-file-system-conventions.html"
ACCESSKEY="N"
>Next</A
></TD
></TR
><TR
><TD
WIDTH="33%"
ALIGN="left"
VALIGN="top"
>Previous License</TD
><TD
WIDTH="34%"
ALIGN="center"
VALIGN="top"
><A
HREF="user-guide-introduction.html"
ACCESSKEY="U"
>Up</A
></TD
><TD
WIDTH="33%"
ALIGN="right"
VALIGN="top"
>Directory and File System Conventions</TD
></TR
></TABLE
></DIV
></BODY
></HTML
>

Line No.	Rev	Author	Line
1	28	unneback	`<!-- 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			`>`

Browse

Tools

Subversion Repositories openrisc_me

[/] [openrisc/] [trunk/] [rtos/] [ecos-2.0/] [doc/] [html/] [user-guide/] [notation-and-conventions.html] - Blame information for rev 446