Remove make preinstall

A speciality of the RTEMS build system was the make preinstall step.  It
copied header files from arbitrary locations into the build tree.  The
header files were included via the -Bsome/build/tree/path GCC command
line option.

This has at least seven problems:

* The make preinstall step itself needs time and disk space.

* Errors in header files show up in the build tree copy.  This makes it
  hard for editors to open the right file to fix the error.

* There is no clear relationship between source and build tree header
  files.  This makes an audit of the build process difficult.

* The visibility of all header files in the build tree makes it
  difficult to enforce API barriers.  For example it is discouraged to
  use BSP-specifics in the cpukit.

* An introduction of a new build system is difficult.

* Include paths specified by the -B option are system headers.  This
  may suppress warnings.

* The parallel build had sporadic failures on some hosts.

This patch removes the make preinstall step.   All installed header
files are moved to dedicated include directories in the source tree.
Let @RTEMS_CPU@ be the target architecture, e.g. arm, powerpc, sparc,
etc.  Let @RTEMS_BSP_FAMILIY@ be a BSP family base directory, e.g.
erc32, imx, qoriq, etc.

The new cpukit include directories are:

* cpukit/include

* cpukit/score/cpu/@RTEMS_CPU@/include

* cpukit/libnetworking

The new BSP include directories are:

* bsps/include

* bsps/@RTEMS_CPU@/include

* bsps/@RTEMS_CPU@/@RTEMS_BSP_FAMILIY@/include

There are build tree include directories for generated files.

The include directory order favours the most general header file, e.g.
it is not possible to override general header files via the include path
order.

The "bootstrap -p" option was removed.  The new "bootstrap -H" option
should be used to regenerate the "headers.am" files.

Update #3254.

1 files changed, 163 insertions, 0 deletions

diff --git a/cpukit/include/rtems/score/context.h b/cpukit/include/rtems/score/context.h
new file mode 100644
index 0000000000..990a602396
--- /dev/null
+++ b/cpukit/include/rtems/score/context.h
@@ -0,0 +1,163 @@
+/**
+ *  @file  rtems/score/context.h
+ *
+ *  @brief Information About Each Thread's Context
+ *
+ *  This include file contains all information about each thread's context.
+ */
+
+/*
+ *  COPYRIGHT (c) 1989-2011.
+ *  On-Line Applications Research Corporation (OAR).
+ *
+ *  The license and distribution terms for this file may be
+ *  found in the file LICENSE in this distribution or at
+ *  http://www.rtems.org/license/LICENSE.
+ */
+
+#ifndef _RTEMS_SCORE_CONTEXT_H
+#define _RTEMS_SCORE_CONTEXT_H
+
+/**
+ *  @defgroup ScoreContext Context Handler
+ *
+ *  @ingroup Score
+ *
+ *  This handler encapsulates functionality which abstracts thread context
+ *  management in a portable manner.
+ *
+ *  The context switch needed variable is contained in the per cpu
+ *  data structure.
+ */
+/**@{*/
+
+#ifdef __cplusplus
+extern "C" {
+#endif
+
+#include <rtems/score/cpu.h>
+
+/**
+ *  @brief Size of floating point context area.
+ *
+ *  This constant defines the number of bytes required
+ *  to store a full floating point context.
+ */
+#if ( CPU_HARDWARE_FP == TRUE ) || ( CPU_SOFTWARE_FP == TRUE )
+  #define CONTEXT_FP_SIZE CPU_CONTEXT_FP_SIZE
+#else
+  #define CONTEXT_FP_SIZE 0
+#endif
+
+/**
+ *  @brief Initialize context area.
+ *
+ *  This routine initializes @a _the_context such that the stack
+ *  pointer, interrupt level, and entry point are correct for the
+ *  thread's initial state.
+ *
+ *  @param[in] _the_context will be initialized
+ *  @param[in] _stack is the lowest physical address of the thread's
+ *         context
+ *  @param[in] _size is the size in octets of the thread's context
+ *  @param[in] _isr is the ISR enable level for this thread
+ *  @param[in] _entry is this thread's entry point
+ *  @param[in] _is_fp is set to true if this thread has floating point
+ *         enabled
+ *  @param[in] _tls_area The thread-local storage (TLS) area begin.
+ */
+#define _Context_Initialize( _the_context, _stack, _size, _isr, _entry, \
+  _is_fp, _tls_area ) \
+    _CPU_Context_Initialize( _the_context, _stack, _size, _isr, _entry, \
+      _is_fp, _tls_area )
+
+/**
+ *  This macro is invoked from _Thread_Handler to do whatever CPU
+ *  specific magic is required that must be done in the context of
+ *  the thread when it starts.
+ *
+ *  If the CPU architecture does not require any magic, then this
+ *  macro is empty.
+ */
+
+#if defined(_CPU_Context_Initialization_at_thread_begin)
+  #define _Context_Initialization_at_thread_begin() \
+     _CPU_Context_Initialization_at_thread_begin()
+#else
+  #define _Context_Initialization_at_thread_begin()
+#endif
+
+/**
+ *  @brief Perform context switch.
+ *
+ *  This routine saves the current context into the @a _executing
+ *  context record and restores the context specified by @a _heir.
+ *
+ *  @param[in] _executing is the currently executing thread's context
+ *  @param[in] _heir is the context of the thread to be switched to
+ */
+#define _Context_Switch( _executing, _heir ) \
+   _CPU_Context_switch( _executing, _heir )
+
+/**
+ *  @brief Restart currently executing thread.
+ *
+ *  This routine restarts the calling thread by restoring its initial
+ *  stack pointer and returning to the thread's entry point.
+ *
+ *  @param[in] _the_context is the context of the thread to restart
+ */
+#define _Context_Restart_self( _the_context ) \
+   _CPU_Context_Restart_self( _the_context )
+
+/**
+ *  @brief Initialize floating point context area.
+ *
+ *  This routine initializes the floating point context save
+ *  area to contain an initial known state.
+ *
+ *  @param[in] _fp_area is the base address of the floating point
+ *         context save area to initialize.
+ */
+#define _Context_Initialize_fp( _fp_area ) \
+   _CPU_Context_Initialize_fp( _fp_area )
+
+/**
+ *  @brief Restore floating point context area.
+ *
+ *  This routine restores the floating point context contained
+ *  in the @a _fp area.  It is assumed that the current
+ *  floating point context has been saved by a previous invocation
+ *  of @a _Context_Save_fp.
+ *
+ *  @param[in] _fp points to the floating point context area to restore.
+ */
+#define _Context_Restore_fp( _fp ) \
+   _CPU_Context_restore_fp( _fp )
+
+/**
+ *  @brief Save floating point context area.
+ *
+ *  This routine saves the current floating point context
+ *  in the @a _fp area.
+ *
+ *  @param[in] _fp points to the floating point context area to restore.
+ */
+#define _Context_Save_fp( _fp ) \
+   _CPU_Context_save_fp( _fp )
+
+#if defined(_CPU_Context_Destroy)
+  #define _Context_Destroy( _the_thread, _the_context ) \
+    _CPU_Context_Destroy( _the_thread, _the_context )
+#else
+  #define _Context_Destroy( _the_thread, _the_context )
+#endif
+
+#ifdef __cplusplus
+}
+#endif
+
+/**@}*/
+
+#endif
+/* end of include file */