path: root/doc
diff options
authorJoel Sherrill <>2000-05-08 16:14:25 +0000
committerJoel Sherrill <>2000-05-08 16:14:25 +0000
commit0fcd2cecd36fbc8c04ab3378e0bfbf9ef3252951 (patch)
tree97aaac77c2fe2833e62208db068e7c23f5a0c8a4 /doc
parentde8e1873b1c65d49704661e3eae61198fb475b5b (diff)
Now sharing the "buildrt.t" or Building RTEMS chapter with the
C version of Getting Started.
Diffstat (limited to 'doc')
2 files changed, 4 insertions, 142 deletions
diff --git a/doc/started_ada/ b/doc/started_ada/
index e1d7fc37e9..6aed6bdb55 100644
--- a/doc/started_ada/
+++ b/doc/started_ada/
@@ -22,6 +22,9 @@ FILES= tversions.texi
info_TEXINFOS = started_ada.texi
+buildrt.t: $(top_srcdir)/started/buildrt.t
+ $(LN_S) $<
intro.texi: intro.t tversions.texi
$(BMENU) -c -p "Top" \
-u "Top" \
@@ -53,3 +56,4 @@ gdb.texi: gdb.t tversions.texi
-n "" $<
+CLEANFILES += buildrt.t
diff --git a/doc/started_ada/buildrt.t b/doc/started_ada/buildrt.t
deleted file mode 100644
index 9d5b95e150..0000000000
--- a/doc/started_ada/buildrt.t
+++ /dev/null
@@ -1,142 +0,0 @@
-@c COPYRIGHT (c) 1988-1999.
-@c On-Line Applications Research Corporation (OAR).
-@c All rights reserved.
-@c $Id$
-@chapter Building RTEMS
-@section Unpack the RTEMS Source
-Use the following command sequence to unpack the RTEMS source into the
-tools directory:
-cd tools
-tar xzf ../archive/@value{RTEMS-TAR}
-@end example
-@section Add <INSTALL_POINT>/bin to Executable PATH
-In order to compile RTEMS, you must have the cross compilation toolset
-in your search patch. The following command appends the directory
-where the tools were installed in the previous chapter:
-@end example
-@b{NOTE:} The above command is in Bourne shell (@code{sh}) syntax and should
-work with the Korn (@code{ksh}) and GNU Bourne Again Shell (@code{bash}).
-It will not work with the C Shell (@code{csh})or derivatives of the C Shell.
-@section Verifying the Operation of the Cross Toolset
-In order to insure that the cross-compiler is invoking the correct
-subprograms (like @code{as} and @code{ld}), one can test assemble
-a small program. When in verbose more, @code{gcc} prints out information
-showing where it found the subprograms it invokes. Place the following
-function in a file named @code{f.c}:
-int f( int x )
- return x + 1;
-@end example
-Then assemble the file using a command similar to the following:
-m68k-rtems-gcc -v -S f.c
-@end example
-Where @code{m68k-rtems-gcc} should be changed to match the installed
-name of your cross compiler. The result of this command will be
-a sequence of output showing where the cross-compiler searched for
-and found its subcomponents. Verify that these paths correspond
-to your <INSTALL_POINT>.
-@b{NOTE:} One of the most common installation errors is for the
-cross-compiler not to be able to find the cross assembler and default
-to using the native @code{as}. This can result in very confusing
-error messages.
-@section Generate RTEMS for a Specific Target and BSP
-@subsection Using the bit_rtems script
-The simplest way to build RTEMS is to use the @code{bit_rtems} script.
-This script interprets the settings in the @code{user.cfg} file to
-enable or disable the various RTEMS options.
-This script is invoked as follows:
-./bit_rtems CPU [BSP]
-@end example
-Where CPU is one of the RTEMS supported CPU families from the following
-@itemize @bullet
-@item hppa1.1
-@item i386
-@item i386-elf
-@item i386-go32
-@item i960
-@item m68k
-@item mips64orion
-@item powerpc
-@item sh
-@item sparc
-@end itemize
-BSP is a supported BSP for the selected CPU family. The list of
-supported BSPs may be found in the file
-in the RTEMS source tree. If the BSP parameter is not specified,
-then all supported BSPs for the selected CPU family will be built.
-@b{NOTE:} The POSIX API must be enabled to use GNAT/RTEMS.
-@subsection Using the RTEMS configure Script Directly
-Make a build directory under tools and build the RTEMS product in this
-directory. The ../@value{RTEMS-UNTAR}/configure
-command has numerous command line
-arguments. These arguments are discussed in detail in documentation that
-comes with the RTEMS distribution. In the installation described in the
-section "Unpack the RTEMS source", these configuration options can be found
-in the file tools/@value{RTEMS-UNTAR}/README.configure.
-The GNAT/RTEMS run-time implementation is based on the POSIX API. Thus
-the RTEMS configuration for a GNAT/RTEMS environment MUST include the
-@code{--enable-posix} flag.
-The following shows the command sequence required to configure,
-compile, and install RTEMS with the POSIX API enabled.
-RTEMS will be built to target the @code{BOARD_SUPPORT_PACKAGE} board.
-mkdir build-rtems
-cd build-rtems
-../@value{RTEMS-UNTAR}/configure --target=<TARGET_CONFIGURATION> \
- --enable-posix \
- --enable-rtemsbsp=<BOARD_SUPPORT_PACKAGE>\
- --prefix=<INSTALL_POINT>
-make all install
-@end example
-Where the list of currently supported of <TARGET_CONFIGURATION>'s and
-<BOARD_SUPPORT_PACKAGE>'s can be found in
-<INSTALL_POINT> is the installation point from the previous step
-"Modify the bit_ada Script" in the build of the tools.
-NOTE: The @code{make} utility used should be GNU make.