source: rtems/README.cdn-X @ d6c20ff3

4.104.114.84.95
Last change on this file since d6c20ff3 was 83518713, checked in by Joel Sherrill <joel.sherrill@…>, on 04/26/01 at 14:09:17

2001-04-26 Ralf Corsepius <corsepiu@…>

  • README.cdn-X: Update.
  • automake/compile.am: Remove -ansi -fasm from CFLAGS_DEFAULT, add @CPPFLAGS@ to CPPFLAGS.
  • Property mode set to 100644
File size: 2.5 KB
Line 
1Building RTEMS Canadian Cross
2=============================
3
4RTEMS now contains experimental and yet incomplete support for building
5it Canadian Cross.
6
71. Introduction
8---------------
9If you don't know what Canadian Cross Building means, you probably don't want
10to apply it and should consider stop reading here.
11
12Interested readers might want to read Ian Lance Taylor's article at
13http://www.airs.com/ian/configure for underlaying details and working
14principles.
15
16
172. RTEMS
18--------
19Example: Building RTEMS for sparc-rtems under i386-pc-linux-gnu to be hosted
20on a i386-cygwin platform.
21
222.1 Required tools
23------------------
24* A i386-pc-linux-gnu cross sparc-rtems toolchain.
25* A i386-pc-linux-gnu cross i386-cygwin toolchain.
26* A i386-pc-linux-gnu native toolchain.
27
28We further on assume these to be installed to these locations:
29/opt/rtems .. linux cross sparc-rtems toolchain
30/opt/cygwin .. linux cross i386-cygwin cross-toolchain
31/usr .. linux native toolchain and further tools.
32
332.2 Building sparc-rtems
34------------------------
35The first step is to build RTEMS for sparc-rtems under linux.
36
37mkdir build
38cd build
39<path>/rtems/configure [options] \
40--target=sparc-rtems \
41--prefix=/opt/cygwin/rtems/sparc-rtems
42make
43make install
44
45This will build a standard sparc-rtems RTEMS and install it to the given
46PREFIX.
47
482.3 Building i386-cygwin host support
49-------------------------------------
50The next step is to build RTEMS host support for i386-cygwin.
51This basically means to cross-build the host tools contained in RTEMS.
52
53mkdir host
54cd host
55<path>/rtems/configure [options] \
56--target=sparc-rtems \
57--build=`<path>/rtems/config.guess` \
58--host=i386-cygwin \
59--prefix=/opt/cygwin/rtems
60make
61make install
62
63This will build RTEMS host-tools for i386-cygwin and install it to the given
64PREFIX.
65
66
673. Known issues
68---------------
69
70* At present time, building RTEMS Canadian Cross is known to be immature, and
71to require additional work. Do not expect this to work.
72
73* The configure scripts expect to find a native c-compiler called "cc". If
74your host doesn't have such a "cc" (e.g. Cygwin) or has a non-functional
75"cc" (eg. Solaris) try introducing a symlink <functional-cc> -> cc
76(E.g.: ln -s <path-to>/gcc /opt/rtems/bin/cc) and make sure this cc can be
77found on $PATH.
78
79* It will *not* work for all BSPs requiring BSP-specific host-tools
80(Unfortunately, this comprizes i386-rtems/pcx86 and all powerpc BSPs).
81
82* Incomplete support for *_FOR_TARGET, *_FOR_HOST, *_FOR_BUILD environment
83variables.
84
85* The <toplevel>/make/ directory hierarchy is not treated correctly.
Note: See TracBrowser for help on using the repository browser.