source: rtems/doc/started/sample.t @ bb4b574

4.104.114.84.95
Last change on this file since bb4b574 was bb4b574, checked in by Joel Sherrill <joel.sherrill@…>, on Apr 25, 2000 at 1:15:14 PM

Merged changes from 4.5 branch and removed that branch.

  • Property mode set to 100644
File size: 1.6 KB
Line 
1@c
2@c  COPYRIGHT (c) 1988-1999.
3@c  On-Line Applications Research Corporation (OAR).
4@c  All rights reserved.
5@c
6@c  $Id$
7@c
8
9@chapter Building the Sample Application
10
11@section Unpack the Sample Application
12
13Use the following command to unarchive the sample application:
14
15@example
16cd tools
17tar xzf ../archive/hello_world_c.tgz
18@end example
19
20@section Set the Environment Variable RTEMS_MAKEFILE_PATH
21
22It must point to the appropriate directory containing RTEMS build for our
23target and board support package combination.
24
25@example
26export RTEMS_MAKEFILE_PATH = \
27<INSTALLATION_POINT>/rtems/<BOARD_SUPPORT_PACKAGE>
28@end example
29
30Where <INSTALLATION_POINT> and <BOARD_SUPPORT_PACKAGE> are those used when
31configuring and installing RTEMS.
32
33@section Build the Sample Application
34
35Use the following command to start the build of the sample application:
36
37@example
38cd tools/hello_world_c
39make
40@end example
41
42NOTE: GNU make is the preferred @code{make} utility.  Other @code{make}
43implementations may work but all testing is done with GNU make.
44
45If no errors are detected during the sample application build, it is
46reasonable to assume that the build of the GNU C/C++ Cross Compiler Tools
47for RTEMS and RTEMS itself for the selected host and target
48combination was done properly.
49
50@section Application Executable
51
52If the sample application has successfully been build, then the application
53executable is placed in the following directory:
54
55@example
56tools/hello_world_c/o-optimize/<filename>.exe
57@end example
58
59How this executable is downloaded to the target board is very dependent
60on the BOARD_SUPPORT_PACKAGE selected.
Note: See TracBrowser for help on using the repository browser.