@c @c COPYRIGHT (c) 1988-1996. @c On-Line Applications Research Corporation (OAR). @c All rights reserved. @c @c $Id$ @c @ifinfo @node Installation Procedure, Installation Procedure Introduction, Introduction Documentation, Top @end ifinfo @chapter Installation Procedure @ifinfo @menu * Installation Procedure Introduction:: * Installation Procedure RTEMS FTP Site Organization:: * Installation Procedure Unarchiving the RTEMS and GNU Components:: * Installation Procedure Installing a Cross-Development GNU Toolset:: * Installation Procedure Installing RTEMS:: @end menu @end ifinfo @ifinfo @node Installation Procedure Introduction, Installation Procedure RTEMS FTP Site Organization, Installation Procedure, Installation Procedure @end ifinfo @section Introduction This chapter describes the process of installing and configuring RTEMS and a cross-development environment based on freely available tools and libraries. @ifinfo @node Installation Procedure RTEMS FTP Site Organization, Installation Procedure Unarchiving the RTEMS and GNU Components, Installation Procedure Introduction, Installation Procedure @end ifinfo @section RTEMS FTP Site Organization RTEMS is distributed only via anonymous ftp. This section will discuss how to navigate the RTEMS ftp site and unarchive the files in the RTEMS and GNU package distributions. All example commands will be given in a shell independent fashion unless otherwise noted. Throughout the rest of this manual will be used as the parent of components within the RTEMS distribution. For persons using the ftp distribution found on the primary ftp site for RTEMS, is ftp://ftp.OARcorp.com/oarcorp/rtems/@value{RTEMS-RELEASE}. The archive files for RTEMS Release @value{RTEMS-RELEASE} are found under the directory . This directory contains the files which comprise this relase as well as any patches which may be required for other tools. The complete source code and documentation set for the C language implementation of RTEMS is provided. Documentation other than this on-line version is available to OAR support customers. Please contact OAR for more information. @ifinfo @node Installation Procedure Unarchiving the RTEMS and GNU Components, Installation Procedure Installing a Cross-Development GNU Toolset, Installation Procedure RTEMS FTP Site Organization, Installation Procedure @end ifinfo @section Unarchiving the RTEMS and GNU Components Many of the components of the RTEMS release are "tarred, zipped" files and have the .tar.gz or .tgz extension. The GNU zip package is required to unarchives these files on the RTEMS ftp site. If this package is not installed, the source can be found in the files ftp://prep.ai.mit.edu/pub/gnu/gzip-1.2.4.shar or ftp://prep.ai.mit.edu/pub/gnu/gzip-1.2.4.tar. It may be restored using a command similar to the following: @example @group tar xvf gzip-1.2.4.tar OR sh gzip-1.2.4.shar @end group @end example This will create a subdirectory gzip-1.2.4 in the current directory. Please examine the files README and INSTALL and follow the instructions provided there. [Note: The GNU tools follow a standard packaging procedure They will unarchive into a directory based on the package name and version number. For detailed instructions on compilation and installation of the GNU tools, please refer to the instructions for each GNU tool.] Files which have been "tarred, zipped" (i.e. .tar.gz or .tgz extension) may be unarchived with a command similar to one of the following: @example @group gzcat .tgz | tar xvof - OR gunzip -c .tgz | tar xvof - OR gtar xzvf .tgz @end group @end example NOTE: gunzip -c is equivalent to gzcat, while gtar is GNU tar. Given that the necessary utility programs are installed, any of the above commands will extract the contents of .tar.gz into the current directory. All of the RTEMS components will be extracted into the subdirectory rtems-@value{RTEMS-RELEASE}. To view the contents of a component without restoring any files, use a command similar to the following: @example @group gzcat .tgz | tar tvf - @end group @end example @ifinfo @node Installation Procedure Installing a Cross-Development GNU Toolset, Installation Procedure Installing RTEMS, Installation Procedure Unarchiving the RTEMS and GNU Components, Installation Procedure @end ifinfo @section Installing a Cross-Development GNU Toolset This sections describes how to build and install the FSF GNU tools for use as a cross-compilation system. These tools are used by the RTEMS developers. Every effort has been made to make these instructions accurate and complete. However, it is recommended that the individual doing the installation read the appropriate installation notes for each of the tools in the cross toolset. This will help insure that there are no special requirements for a particular host. If the host and target processors are the same, then it may be possible to use the host development tools. An example of this scenario is using a SPARC based workstation to develop an RTEMS application for the SPARC processor. Although the native toolset is useable in this scenario, it is ultimately more desirable to build a toolset specifically for the embedded environment. Instructions for building a cross environment using the GNU tools is provided in the crossgcc FAQ available from ftp.cygnus.com in /pub/embedded/crossgcc. It is recommended that the user following these instructions. After the cross development toolset has been built and installed, it will be necessary to modify the environment of each RTEMS application developer to reflect at least the path of the newly installed cross development toolset. The documentation for the FSF GNU and Cygnus tools is formatted using TeX. The RTEMS developers use TeX 3.14t3 to format the manuals for their own use. This document does not contain instructions on the acquisition or installation of TeX and supporting tools. NOTE: For "UNIX" processors, the native compiler binary utilities should be used. @ifinfo @node Installation Procedure Installing RTEMS, Development Environment Status, Installation Procedure Installing a Cross-Development GNU Toolset, Installation Procedure @end ifinfo @section Installing RTEMS For instructions on building and installing RTEMS, please refer to the file README.configure in the source distribution.