From 6d3d425dbd239fdb9a65a2a0a9834db8a657346c Mon Sep 17 00:00:00 2001 From: Joel Sherrill Date: Sat, 11 Apr 1998 14:54:20 +0000 Subject: Now a passable Ada manual --- doc/started_ada/buildrt.t | 29 +++++++++++++++-------------- 1 file changed, 15 insertions(+), 14 deletions(-) (limited to 'doc/started_ada/buildrt.t') diff --git a/doc/started_ada/buildrt.t b/doc/started_ada/buildrt.t index daaf72f88b..2dd76b54fd 100644 --- a/doc/started_ada/buildrt.t +++ b/doc/started_ada/buildrt.t @@ -9,7 +9,7 @@ @chapter Building RTEMS -@section Unpack the RTEMS source +@section Unpack the RTEMS Source Use the following command sequence to unpack the RTEMS source into the tools directory: @@ -19,7 +19,7 @@ cd tools tar xzf ../arc/@value{RTEMS-TAR} @end example -@section Add the bin directory under the install point to the default PATH +@section Add /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 @@ -29,11 +29,11 @@ where the tools were installed in the previous chapter: export PATH=$PATH:/bin @end example -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. +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 Generate RTEMS for a specific target and board support package +@section Generate RTEMS for a Specific Target and BSP Make a build directory under tools and build the RTEMS product in this directory. The ../@value{RTEMS-UNTAR}/configure @@ -43,28 +43,29 @@ comes with the RTEMS distribution. In the installation described in the section "Unpack the RTEMS source", these configuration options can be found in 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, KA9Q TCP/IP, -and C++ support disabled. RTEMS will be built to target -the @code{BOARD_SUPPORT_PACKAGE} board. +compile, and install RTEMS with the POSIX API enabled. +RTEMS will be built to target the @code{BOARD_SUPPORT_PACKAGE} board. @example mkdir build-rtems cd build-rtems ../@value{RTEMS-UNTAR}/configure --target= \ - --disable-posix --disable-ka9q --disable-cxx \ + --enable-posix \ --enable-rtemsbsp=\ --prefix= gmake all install @end example -Where: - -The list of currently supported of 's and +Where the list of currently supported of 's and 's can be found in tools/@value{RTEMS-UNTAR}/README.configure. is the installation point from the previous step -"Modify the bit script" in the build of the tools. +"Modify the bit_ada Script" in the build of the tools. -- cgit v1.2.3