source: rtems/README.cdn-X @ acdb6558

4.104.114.84.95
Last change on this file since acdb6558 was 48ad47cc, checked in by Joel Sherrill <joel.sherrill@…>, on 03/01/01 at 20:46:21

2001-02-22 Ralf Corsepius <corsepiu@…>

  • configure.in: Reworked for Canadian Cross support.
  • Makefile.am: Reflect changes to configure.in.
  • config.guess, config.sub: Update from subversions.gnu.org.
  • README.cdn-X: New file.
  • tools/Makefile.am: Remove build, tools from SUBDIRS.
  • Property mode set to 100644
File size: 2.4 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
162. RTEMS
17--------
18Example: Building RTEMS for sparc-rtems under i386-pc-linux-gnu to be hosted
19on a i386-cygwin platform.
20
212.1 Required tools
22------------------
23* A i386-pc-linux-gnu cross sparc-rtems toolchain.
24* A i386-pc-linux-gnu cross i386-cygwin toolchain.
25* A i386-pc-linux-gnu native toolchain.
26
27We further on assume these to be installed to these locations:
28/opt/rtems .. linux cross sparc-rtems toolchain
29/opt/i386-cygwin .. linux cross i386-cygwin cross toolchain
30/usr .. linux native toolchain and further tools.
31
322.2 Building sparc-rtems
33------------------------
34The first step is to build RTEMS for sparc-rtems under linux.
35
36mkdir build
37cd build
38<path>/rtems/configure [options] \
39--target=sparc-rtems \
40--prefix=/opt/i386-cygwin/rtems/sparc-rtems
41make
42make install
43
44This will build a standard sparc-rtems RTEMS to the given PREFIX.
45
46
472.3 Building i386-cygwin host support
48-------------------------------------
49The next step is to build RTEMS host support for i386-cygwin.
50This basically means to cross-build the host tools contained in RTEMS.
51
52mkdir host
53cd host
54<path>/rtems/configure [options] \
55--target=sparc-rtems \
56--build=`<path>/rtems/config.guess` \
57--host=i386-cygwin \
58--prefix=/opt/i386-cygwin/rtems
59
603. Known issues
61---------------
62
63* At present time, building RTEMS Canadian Cross is known to be immature, and
64to require additional work. Do not expect this to work.
65
66* The configure scripts expect to find a native c-compiler called "cc". If
67your host doesn't have such a "cc" (e.g. Cygwin) or has a non-functional
68"cc" (eg. Solaris) try introducing a symlink <functional-cc> -> cc.
69(Eg. ln -s <path-to>/gcc /opt/rtems/bin/cc) and make sure this cc can be
70found on $PATH.
71
72* It will *not* work for all targets requiring BSP-specific host-tools
73(Unfortunately, this comprizes i386-rtems/pcx86 and all powerpc BSPs).
74
75* Incomplete support for *_FOR_TARGET, *_FOR_HOST, *_FOR_BUILD environment
76variables.
77
78* The <toplevel>/make/ directory hierarchy is not treated correctly.
Note: See TracBrowser for help on using the repository browser.