source: rtems/doc/develenv/direct.texi @ 1e524995

4.104.114.84.95
Last change on this file since 1e524995 was 1e524995, checked in by Joel Sherrill <joel.sherrill@…>, on Feb 6, 1998 at 2:14:30 PM

Updated copyrights

  • Property mode set to 100644
File size: 22.1 KB
Line 
1@c
2@c  COPYRIGHT (c) 1988-1998.
3@c  On-Line Applications Research Corporation (OAR).
4@c  All rights reserved.
5@c
6@c  $Id$
7@c
8
9@ifinfo
10@node Directory Structure, Directory Structure Suites, Introduction, Top
11@end ifinfo
12@chapter Directory Structure
13@ifinfo
14@menu
15* Directory Structure Suites::
16@end menu
17@end ifinfo
18
19The RTEMS directory structure is designed to meet
20the following requirements:
21
22@itemize @bullet
23@item encourage development of modular components.
24
25@item isolate processor and target dependent code, while
26allowing as much common source code as possible to be shared
27across multiple processors and targets.
28
29@item allow multiple RTEMS users to perform simultaneous
30compilation of RTEMS and its support facilities for different
31processors and targets.
32@end itemize
33
34The resulting directory structure has processor and
35target dependent source files isolated from generic files.  When
36RTEMS is built, object directories and an install point will be
37automatically created based upon the target BSP selected.  The
38placement of object files based upon the selected BSP name
39insures that object files are not mixed across CPUs or targets.
40This in combination with the make files allows the specific
41compilation options to be tailored for a particular target
42board.  For example, the efficiency of the memory subsystem for
43a particular target board may be sensitive to the alignment of
44data structures, while on another target board with the same
45processor memory may be very limited.  For the first target, the
46options could specify very strict alignment requirements, while
47on the second the data structures could be "packed" to conserve
48memory.  It is impossible to achieve this degree of flexibility
49without providing source code.
50@ifinfo
51@node Directory Structure Suites, C Suites, Directory Structure, Directory Structure
52@end ifinfo
53@section Suites
54@ifinfo
55@menu
56* C Suites::
57* Executive Source Directory::
58* Support Library Source Directory::
59* Test Suite Source Directory::
60@end menu
61@end ifinfo
62
63The RTEMS source tree is organized based on the
64following four variables:
65
66@itemize @bullet
67@item language,
68
69@item target processor,
70
71@item target board, and
72
73@item compiler vendor (Ada only).
74@end itemize
75
76The language may be either C or Ada and there is
77currently nothing shared between the source trees for these two
78implementations of RTEMS.  The user generally selects the
79subdirectory for the implementation they are using and ignores
80that for the other implementation.  The only exceptions to this
81normally occurs when comparing the source code for the two
82implementations or when porting both to a new CPU or target
83board.  The following shows the top level RTEMS directory
84structure which includes directories for each language
85implementation and a language independent source documentation
86directory.  The source documentation directory is currently not
87supported.
88
89@c
90@c  Tree 1 - Top Level
91@c
92
93@ifset use-ascii
94@example
95@group
96                      RTEMS
97                        |
98+-----------------------+-----------------------+
99|                                               |
100c                                              doc
101@end group
102@end example
103@end ifset
104
105@ifset use-tex
106@sp 1
107
108@tex
109{\parskip=0pt\offinterlineskip%
110\hskip 15.0em
111\hskip 1.25em\hbox to 3.00em{\hss{RTEMS}\hss}%
112\vrule width0em height1.972ex depth0.812ex\par\penalty10000
113\hskip 15.0em
114\hskip 2.75em\vrule width.04em%
115\vrule width0em height1.500ex depth0.500ex\par\penalty10000
116\hskip 15.0em
117\hskip 0.25em\vrule width2.50em height-0.407ex depth0.500ex%
118\vrule width.04em\vrule width2.50em height-0.407ex depth0.500ex%
119\vrule width0em height1.500ex depth0.500ex\par\penalty10000
120\hskip 15.0em
121\hskip 0.25em\vrule width.04em%
122\hskip 4.92em\vrule width.04em%
123\vrule width0em height1.500ex depth0.500ex\par\penalty10000
124\hskip 15.0em
125\hskip 0.00em\hbox to 0.50em{\hss{c}\hss}%
126\hskip 1.50em\hbox to 1.50em{\hss{   }\hss}%
127\hskip 1.00em\hbox to 1.50em{\hss{doc}\hss}%
128\vrule width0em height1.972ex depth0.812ex\par}
129@end tex
130@end ifset
131
132@c
133@c for now continue to use the ascii
134@c
135@ifset use-html
136@example
137@group
138                      RTEMS
139                        |
140+-----------------------+-----------------------+
141|                                               |
142c                                              doc
143@end group
144@end example
145@html
146@end html
147@end ifset
148
149Each of the following sections will describe the
150contents of the directories in the RTEMS source
151tree.
152
153@ifinfo
154@node C Suites, Executive Source Directory, Directory Structure Suites, Directory Structure Suites
155@end ifinfo
156@subsection C Suites
157
158The following table lists the suites currently included with the
159C implementation of RTEMS and the directory in which they may be located:
160
161@ifset use-texinfo-tables
162@table @code
163@item Support Libraries (BSPs, C library, CPU support)
164$RTEMS_ROOT/c/src/lib
165
166@item Single Processor Tests
167$RTEMS_ROOT/c/src/tests/sptests
168
169@item Timing Tests
170$RTEMS_ROOT/c/src/tests/tmtests
171
172@item Multiprocessor Tests
173$RTEMS_ROOT/c/src/tests/mptests
174
175@item Sample Applications
176$RTEMS_ROOT/c/src/tests/samples
177
178@item RTEMS Build Tools
179$RTEMS_SRC_BASE/c/build_tools
180
181@item Make Support
182$RTEMS_ROOT/c/make
183@end table
184@end ifset
185
186@ifclear use-texinfo-tables
187@html
188<CENTER>
189  <TABLE COLS=2 WIDTH="80%" BORDER=2>
190<TR><TD ALIGN=center>Support Libraries (BSPs, C library, CPU support)</TD>
191    <TD ALIGN=center>$RTEMS_ROOT/c/src/lib</TD></TR>
192<TR><TD ALIGN=center>Single Processor Tests</TD>
193    <TD ALIGN=center>$RTEMS_ROOT/c/src/tests/sptests</TD></TR>
194<TR><TD ALIGN=center>Timing Tests</TD>
195    <TD ALIGN=center>$RTEMS_ROOT/c/src/tests/tmtests</TD></TR>
196<TR><TD ALIGN=center>Multiprocessor Tests</TD>
197    <TD ALIGN=center>$RTEMS_ROOT/c/src/tests/mptests</TD></TR>
198<TR><TD ALIGN=center>Sample Applications</TD>
199    <TD ALIGN=center>$RTEMS_ROOT/c/src/tests/samples</TD></TR>
200<TR><TD ALIGN=center>RTEMS Build Tools</TD>
201    <TD ALIGN=center>$RTEMS_SRC_BASE/c/build_tools</TD></TR>
202<TR><TD ALIGN=center>Make Support</TD>
203    <TD ALIGN=center>$RTEMS_ROOT/c/make</TD></TR>
204  </TABLE>
205</CENTER>
206@end html
207@end ifclear
208
209
210The top level directory structure for the C implementation of RTEMS
211is as follows:
212
213@c
214@c  Tree 2 - Top C Level
215@c
216
217@ifset use-ascii
218@example
219@group
220                     C
221                     |
222    +----------+-----------+----------+
223    |          |           |          |
224build_tools   make        src   update_tools
225@end group
226@end example
227@end ifset
228
229@ifset use-tex
230@sp 1
231
232@tex
233{\parskip=0pt\offinterlineskip%
234\hskip 08.0em
235\hskip 13.00em\hbox to 0.50em{\hss{C}\hss}%
236\vrule width0em height1.972ex depth0.812ex\par\penalty10000
237\hskip 08.0em
238\hskip 13.25em\vrule width.04em%
239\vrule width0em height1.500ex depth0.500ex\par\penalty10000
240\hskip 08.0em
241\hskip 1.75em\vrule width11.50em height-0.407ex depth0.500ex%
242\vrule width.04em\vrule width11.50em height-0.407ex depth0.500ex%
243\vrule width0em height1.500ex depth0.500ex\par\penalty10000
244\hskip 08.0em
245\hskip 1.75em\vrule width.04em%
246\hskip 5.71em\vrule width.04em%
247\hskip 5.71em\vrule width.04em%
248\hskip 5.71em\vrule width.04em%
249\hskip 5.71em\vrule width.04em%
250\vrule width0em height1.500ex depth0.500ex\par\penalty10000
251\hskip 08.0em
252\hskip 0.00em\hbox to 3.50em{\hss{Modules}\hss}%
253\hskip 1.00em\hbox to 6.00em{\hss{build\_tools}\hss}%
254\hskip 1.75em\hbox to 2.00em{\hss{make}\hss}%
255\hskip 4.00em\hbox to 1.50em{\hss{src}\hss}%
256\hskip 1.75em\hbox to 6.50em{\hss{update\_tools}\hss}%
257\vrule width0em height1.972ex depth0.812ex\par}
258@end tex
259@end ifset
260
261@ifset use-html
262@example
263@group
264                     C
265                     |
266    +----------+-----------+----------+
267    |          |           |          |
268build_tools   make        src   update_tools
269@end group
270@end example
271@html
272@end html
273@end ifset
274
275This directory contains the subdirectories which
276contain the entire C implementation of the RTEMS executive. 
277The "build-tools" directory contains an assortment of support tools
278for the RTEMS development environment.  Two subdirectories exist
279under "build-tools" which contain scripts (executables) and
280source for the support tools.  The "make" directory contains
281configuration files and subdirectories which provide a robust
282host and cross-target makefile system supporting the building of
283the  executive for numerous application environments.  The
284"update_tools" directory contains utilities which aid in the
285updating from a previous version to the current version of the
286RTEMS executive.
287
288The "src" directory structure for the C implementation of RTEMS is as follows:
289
290@c
291@c  Tree 3 - Top C src Level
292@c
293
294@ifset use-ascii
295@example
296@group
297                     C Source
298                         |
299 +-----------------------+-----------------------+
300 |                       |                       |
301exec                    lib                    tests
302@end group
303@end example
304@end ifset
305
306@ifset use-tex
307@sp 1
308
309@tex
310{\parskip=0pt\offinterlineskip%
311\hskip 15.0em
312\hskip 2.00em\hbox to 4.00em{\hss{C Source}\hss}%
313\vrule width0em height1.972ex depth0.812ex\par\penalty10000
314\hskip 15.0em
315\hskip 4.00em\vrule width.04em%
316\vrule width0em height1.500ex depth0.500ex\par\penalty10000
317\hskip 15.0em
318\hskip 1.00em\vrule width3.00em height-0.407ex depth0.500ex%
319\vrule width.04em\vrule width3.00em height-0.407ex depth0.500ex%
320\vrule width0em height1.500ex depth0.500ex\par\penalty10000
321\hskip 15.0em
322\hskip 1.00em\vrule width.04em%
323\hskip 2.96em\vrule width.04em%
324\hskip 2.96em\vrule width.04em%
325\vrule width0em height1.500ex depth0.500ex\par\penalty10000
326\hskip 15.0em
327\hskip 0.00em\hbox to 2.00em{\hss{exec}\hss}%
328\hskip 1.25em\hbox to 1.50em{\hss{lib}\hss}%
329\hskip 1.00em\hbox to 2.50em{\hss{tests}\hss}%
330\vrule width0em height1.972ex depth0.812ex\par}
331@end tex
332@end ifset
333
334@ifset use-html
335@example
336@group
337                     C Source
338                         |
339 +-----------------------+-----------------------+
340 |                       |                       |
341exec                    lib                    tests
342@end group
343@end example
344@html
345@end html
346@end ifset
347
348This directory contains all source files that
349comprises the RTEMS executive, supported target board support
350packages, and the RTEMS Test Suite.
351
352@ifinfo
353@node Executive Source Directory, Support Library Source Directory, C Suites, Directory Structure Suites
354@end ifinfo
355@subsection Executive Source Directory
356
357The "exec" directory structure for the C implementation is as follows:
358
359@c
360@c  Tree 4 - C Executive Tree
361@c
362
363@ifset use-ascii
364@example
365@group
366                    C Executive
367                         |
368  +-----------+----------+-----------+----------+
369  |           |          |           |          |
370posix       rtems       sapi       score     wrapup
371@end group
372@end example
373@end ifset
374
375@ifset use-tex
376@sp 1
377
378@tex
379{\parskip=0pt\offinterlineskip%
380\hskip 10.0em
381\hskip 6.00em\hbox to 5.50em{\hss{C Executive}\hss}%
382\vrule width0em height1.972ex depth0.812ex\par\penalty10000
383\hskip 10.0em
384\hskip 8.75em\vrule width.04em%
385\vrule width0em height1.500ex depth0.500ex\par\penalty10000
386\hskip 10.0em
387\hskip 1.25em\vrule width7.50em height-0.407ex depth0.500ex%
388\vrule width.04em\vrule width7.50em height-0.407ex depth0.500ex%
389\vrule width0em height1.500ex depth0.500ex\par\penalty10000
390\hskip 10.0em
391\hskip 1.25em\vrule width.04em%
392\hskip 3.71em\vrule width.04em%
393\hskip 3.71em\vrule width.04em%
394\hskip 3.71em\vrule width.04em%
395\hskip 3.71em\vrule width.04em%
396\vrule width0em height1.500ex depth0.500ex\par\penalty10000
397\hskip 10.0em
398\hskip 0.00em\hbox to 2.50em{\hss{posix}\hss}%
399\hskip 1.25em\hbox to 2.50em{\hss{rtems}\hss}%
400\hskip 1.50em\hbox to 2.00em{\hss{sapi}\hss}%
401\hskip 1.50em\hbox to 2.50em{\hss{score}\hss}%
402\hskip 1.00em\hbox to 3.00em{\hss{wrapup}\hss}%
403\vrule width0em height1.972ex depth0.812ex\par}
404@end tex
405@end ifset
406
407@ifset use-html
408                    C Executive
409                         |
410  +-----------+----------+-----------+----------+
411  |           |          |           |          |
412posix       rtems       sapi       score     wrapup
413@html
414@end html
415@end ifset
416
417This directory contains a set of subdirectories which
418contains the source files comprising the executive portion of
419the RTEMS development environment.  At this point the API
420specific and "supercore" source code files are separated into
421distinct directory trees.  The "rtems" and the "posix"
422subdirectories contain the C language source files for each
423module comprising the respective API.  Also included in this
424directory are the subdirectories "sapi" and "score" which are
425the supercore modules.  Within the "score" directory the CPU
426dependent modules are found.
427
428The "cpu" directory contains a subdirectory for each
429target CPU supported by the @value{RELEASE} release of the RTEMS
430executive.  Each processor directory contains the CPU dependent
431code necessary to host RTEMS.  The "no_cpu" directory provides a
432starting point for developing a new port to an unsupported
433processor.  The files contained within the "no_cpu" directory
434may also be used as a reference for the other ports to specific
435processors.
436
437@ifinfo
438@node Support Library Source Directory, Test Suite Source Directory, Executive Source Directory, Directory Structure Suites
439@end ifinfo
440@subsection Support Library Source Directory
441
442The "lib" directory contains the support libraries and BSPS. 
443Board support packages (BSPs), processor environment start up code,
444C library support, the KA9Q TCP/IP stack, common BSP header files,
445and miscellaneous support functions are provided in the subdirectories.
446These are combined with the RTEMS executive object to form the single
447RTEMS library which installed. 
448
449@c
450@c  Tree 6 - Libraries
451@c
452
453
454The "libbsp" directory contains a directory for each CPU family supported
455by RTEMS.  Beneath each CPU directory is a directory for each BSP for that
456processor family.
457
458@c
459@c  Tree 7 - C BSP Library
460@c
461
462The "libbsp" directory provides all the BSPs provided with this
463release of the RTEMS executive.  The subdirectories are
464divided,  as discussed previously, based on specific processor
465family, then further breaking down into specific target board
466environments.  The "shmdr" subdirectory provides the
467implementation of a shared memory driver which supports the
468multiprocessing portion of the executive.  In addition, two
469starting point subdirectories are provided for reference.  The
470"no_cpu" subdirectory provides a template BSP which can be used
471to develop a specific BSP for an unsupported target board.  The
472"stubdr" subdirectory provides stubbed out BSPs.  These files
473may aid in preliminary testing of the RTEMS development
474environment that has been built for no particular target in mind.
475
476Below each CPU dependent directory is a directory for each target BSP
477supported in this release.
478
479Each BSP provides the modules which comprise an RTEMS BSP.  The
480modules are separated into the subdirectories "clock", "console",
481"include", "shmsupp", "startup", and "timer" as shown in the following
482figure:
483
484@c
485@c  Tree 8 - Each BSP
486@c
487
488@ifset use-ascii
489@example
490@group
491                           Each BSP
492                               |
493  +-----------+----------+-----+-----+----------+----------+
494  |           |          |           |          |          |
495clock      console    include     shmsupp    startup     timer
496@end group
497@end example
498@end ifset
499
500@ifset use-tex
501@sp 1
502
503@tex
504{\parskip=0pt\offinterlineskip%
505\hskip 10.0em
506\hskip 10.25em\hbox to 4.50em{\hss{Each BSP}\hss}%
507\vrule width0em height1.972ex depth0.812ex\par\penalty10000
508\hskip 10.0em
509\hskip 12.50em\vrule width.04em%
510\vrule width0em height1.500ex depth0.500ex\par\penalty10000
511\hskip 10.0em
512\hskip 1.25em\vrule width11.25em height-0.407ex depth0.500ex%
513\vrule width.04em\vrule width11.25em height-0.407ex depth0.500ex%
514\vrule width0em height1.500ex depth0.500ex\par\penalty10000
515\hskip 10.0em
516\hskip 1.25em\vrule width.04em%
517\hskip 4.46em\vrule width.04em%
518\hskip 4.46em\vrule width.04em%
519\hskip 4.46em\vrule width.04em%
520\hskip 4.46em\vrule width.04em%
521\hskip 4.46em\vrule width.04em%
522\vrule width0em height1.500ex depth0.500ex\par\penalty10000
523\hskip 10.0em
524\hskip 0.00em\hbox to 2.50em{\hss{clock}\hss}%
525\hskip 1.50em\hbox to 3.50em{\hss{console}\hss}%
526\hskip 1.00em\hbox to 3.50em{\hss{include}\hss}%
527\hskip 1.00em\hbox to 3.50em{\hss{shmsupp}\hss}%
528\hskip 1.00em\hbox to 3.50em{\hss{startup}\hss}%
529\hskip 1.50em\hbox to 2.50em{\hss{timer}\hss}%
530\vrule width0em height1.972ex depth0.812ex\par}
531@end tex
532@end ifset
533
534@ifset use-html
535                           Each BSP
536                               |
537  +-----------+----------+-----+-----+----------+----------+
538  |           |          |           |          |          |
539clock      console    include     shmsupp    startup     timer
540@html
541@end html
542@end ifset
543
544@ifinfo
545@node Test Suite Source Directory, Sample Applications, Support Library Source Directory, Directory Structure Suites
546@end ifinfo
547@subsection Test Suite Source Directory
548
549The "tests" directory structure for the C
550implementation is as follows:
551
552@c
553@c  Tree 9 - C Tests
554@c
555
556@ifset use-ascii
557@example
558@group
559                                C Tests
560                                   |
561   +----------+---------+----------+---------+---------+---------+
562   |          |         |          |         |         |         |
563libtests   sptests   support    tmtests   mptests    tools    samples
564@end group
565@end example
566@end ifset
567
568@ifset use-tex
569@sp 1
570
571@tex
572{\parskip=0pt\offinterlineskip%
573\hskip 05.0em
574\hskip 14.50em\hbox to 3.50em{\hss{C Tests}\hss}%
575\vrule width0em height1.972ex depth0.812ex\par\penalty10000
576\hskip 05.0em
577\hskip 16.25em\vrule width.04em%
578\vrule width0em height1.500ex depth0.500ex\par\penalty10000
579\hskip 05.0em
580\hskip 2.00em\vrule width14.25em height-0.407ex depth0.500ex%
581\vrule width.04em\vrule width14.25em height-0.407ex depth0.500ex%
582\vrule width0em height1.500ex depth0.500ex\par\penalty10000
583\hskip 05.0em
584\hskip 2.00em\vrule width.04em%
585\hskip 4.71em\vrule width.04em%
586\hskip 4.71em\vrule width.04em%
587\hskip 4.71em\vrule width.04em%
588\hskip 4.71em\vrule width.04em%
589\hskip 4.71em\vrule width.04em%
590\hskip 4.71em\vrule width.04em%
591\vrule width0em height1.500ex depth0.500ex\par\penalty10000
592\hskip 05.0em
593\hskip 0.00em\hbox to 4.00em{\hss{libtests}\hss}%
594\hskip 1.00em\hbox to 3.50em{\hss{sptests}\hss}%
595\hskip 1.25em\hbox to 3.50em{\hss{support}\hss}%
596\hskip 1.25em\hbox to 3.50em{\hss{tmtests}\hss}%
597\hskip 1.25em\hbox to 3.50em{\hss{mptests}\hss}%
598\hskip 1.75em\hbox to 2.50em{\hss{tools}\hss}%
599\hskip 1.75em\hbox to 3.50em{\hss{samples}\hss}%
600\vrule width0em height1.972ex depth0.812ex\par}
601@end tex
602@end ifset
603
604@ifset use-html
605                                C Tests
606                                   |
607   +----------+---------+----------+---------+---------+---------+
608   |          |         |          |         |         |         |
609libtests   sptests   support    tmtests   mptests    tools    samples
610@html
611@end html
612@end ifset
613
614This directory provides the entire RTEMS Test Suite
615which includes the single processor tests, multiprocessor tests,
616timing tests, library tests, and sample tests.   Additionally,
617subdirectories for support functions and test related header
618files are provided.
619
620The "sptests" subdirectory consists of twenty-four
621tests designed to cover the entire executive code.  The
622"spfatal" test will verify any code associated with the
623occurrence of a fatal error.   Also provided is a test which
624will determine the size of the RTEMS executive.
625
626The multiprocessor test are provided in "mptests".
627Fourteen tests are provided in this subdirectory which address
628two node configurations and cover the multiprocessor code found
629in RTEMS.
630
631Tests that time each directive and a set of critical
632executive functions are provided in the "tmtests" subdirectory.
633Within this subdirectory  thirty-one tests are provided along
634with a subdirectory to contain each targets timing results.
635
636The "samples" directory structure for the C
637implementation is as follows:
638
639@c
640@c  Tree 10 - C Samples
641@c
642
643@ifset use-ascii
644@example
645@group
646                            C Samples
647                                |
648   +-----------+----------+-----+-----+----------+----------+
649   |           |          |           |          |          |
650base_mp     base_sp    cdtest       hello     paranoia    ticker
651@end group
652@end example
653@end ifset
654
655@ifset use-tex
656@sp 1
657
658@tex
659{\parskip=0pt\offinterlineskip%
660\hskip 05.0em
661\hskip 12.25em\hbox to 4.50em{\hss{C Samples}\hss}%
662\vrule width0em height1.972ex depth0.812ex\par\penalty10000
663\hskip 05.0em
664\hskip 14.50em\vrule width.04em%
665\vrule width0em height1.500ex depth0.500ex\par\penalty10000
666\hskip 05.0em
667\hskip 2.00em\vrule width12.50em height-0.407ex depth0.500ex%
668\vrule width.04em\vrule width12.50em height-0.407ex depth0.500ex%
669\vrule width0em height1.500ex depth0.500ex\par\penalty10000
670\hskip 05.0em
671\hskip 2.00em\vrule width.04em%
672\hskip 4.96em\vrule width.04em%
673\hskip 4.96em\vrule width.04em%
674\hskip 4.96em\vrule width.04em%
675\hskip 4.96em\vrule width.04em%
676\hskip 4.96em\vrule width.04em%
677\vrule width0em height1.500ex depth0.500ex\par\penalty10000
678\hskip 05.0em
679\hskip 0.00em\hbox to 4.00em{\hss{base\_mp}\hss}%
680\hskip 1.00em\hbox to 4.00em{\hss{base\_sp}\hss}%
681\hskip 1.50em\hbox to 3.00em{\hss{cdtest}\hss}%
682\hskip 2.25em\hbox to 2.50em{\hss{hello}\hss}%
683\hskip 1.75em\hbox to 4.00em{\hss{paranoia}\hss}%
684\hskip 1.50em\hbox to 3.00em{\hss{ticker}\hss}%
685\vrule width0em height1.972ex depth0.812ex\par}
686@end tex
687@end ifset
688
689@ifset use-html
690                            C Samples
691                                |
692   +-----------+----------+-----+-----+----------+----------+
693   |           |          |           |          |          |
694base_mp     base_sp    cdtest       hello     paranoia    ticker
695@html
696@end html
697@end ifset
698
699This directory provides sample application tests
700which aid in the testing a newly built RTEMS environment, a new
701BSP, or as starting points for the development of an application
702using the RTEMS executive.  A Hello World test is provided in
703the subdirectory "hello".  This test is helpful when testing new
704versions of RTEMS, BSPs, or modifications to any portion of the
705RTEMS development environment.  The "ticker" subdirectory
706provides a test for verification of clock chip device drivers of
707BSPs.  A simple single processor test similar to those in the
708single processor test suite is provided in "base_sp".  A simple
709two node multiprocessor test capable of testing an newly
710developed MPCI layer is provided in "base_mp".  The "cdtest"
711subdirectory provides a simple C++ application using
712constructors and destructors.   The final sample test is a
713public domain floating point and math library toolset test is
714provided in "paranoia".
Note: See TracBrowser for help on using the repository browser.