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, 0 insertions, 166 deletions

diff --git a/cpukit/score/include/rtems/score/watchdog.h b/cpukit/score/include/rtems/score/watchdog.h
deleted file mode 100644
index dbb092bbef..0000000000
--- a/cpukit/score/include/rtems/score/watchdog.h
+++ /dev/null
@@ -1,166 +0,0 @@
-/**
- *  @file  rtems/score/watchdog.h
- *
- *  @brief Constants and Structures Associated with Watchdog Timers
- *
- *  This include file contains all the constants and structures associated
- *  with watchdog timers.   This Handler provides mechanisms which can be
- *  used to initialize and manipulate watchdog timers.
- */
-
-/*
- *  COPYRIGHT (c) 1989-2009.
- *  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_WATCHDOG_H
-#define _RTEMS_SCORE_WATCHDOG_H
-
-#include <rtems/score/basedefs.h>
-#include <rtems/score/chain.h>
-#include <rtems/score/rbtree.h>
-
-struct Per_CPU_Control;
-
-#ifdef __cplusplus
-extern "C" {
-#endif
-
-/**
- *  @defgroup ScoreWatchdog Watchdog Handler
- *
- *  @ingroup Score
- *
- *  This handler encapsulates functionality related to the scheduling of
- *  watchdog functions to be called at specific times in the future.
- *
- *  @note This handler does not have anything to do with hardware watchdog
- *        timers.
- */
-/**@{*/
-
-typedef struct Watchdog_Control Watchdog_Control;
-
-/**
- *  @brief Type is used to specify the length of intervals.
- *
- *  This type is used to specify the length of intervals.
- */
-typedef uint32_t   Watchdog_Interval;
-
-/**
- * @brief Special watchdog ticks value to indicate an infinite wait.
- */
-#define WATCHDOG_NO_TIMEOUT 0
-
-/**
- *  @brief Return type from a Watchdog Service Routine.
- *
- *  This type defines the return type from a Watchdog Service Routine.
- */
-typedef void Watchdog_Service_routine;
-
-/**
- *  @brief Pointer to a watchdog service routine.
- *
- *  This type define a pointer to a watchdog service routine.
- */
-typedef Watchdog_Service_routine
-  ( *Watchdog_Service_routine_entry )( Watchdog_Control * );
-
-/**
- * @brief The watchdog header to manage scheduled watchdogs.
- */
-typedef struct {
-  /**
-   * @brief Red-black tree of scheduled watchdogs sorted by expiration time.
-   */
-  RBTree_Control Watchdogs;
-
-  /**
-   * @brief The scheduled watchdog with the earliest expiration time or NULL in
-   * case no watchdog is scheduled.
-   */
-  RBTree_Node *first;
-} Watchdog_Header;
-
-/**
- *  @brief The control block used to manage each watchdog timer.
- *
- *  The following record defines the control block used
- *  to manage each watchdog timer.
- */
-struct Watchdog_Control {
-  /**
-   * @brief Nodes for the watchdog.
-   */
-  union {
-    /**
-     * @brief this field is a red-black tree node structure and allows this to
-     * be placed on a red-black tree used to manage the scheduled watchdogs.
-     */
-    RBTree_Node RBTree;
-
-    /**
-     * @brief this field is a chain node structure and allows this to be placed
-     * on a chain used to manage pending watchdogs by the timer server.
-     */
-    Chain_Node Chain;
-  } Node;
-
-#if defined(RTEMS_SMP)
-  /** @brief This field references the processor of this watchdog control. */
-  struct Per_CPU_Control *cpu;
-#endif
-
-  /** @brief This field is the function to invoke. */
-  Watchdog_Service_routine_entry routine;
-
-  /** @brief This field is the expiration time point. */
-  uint64_t expire;
-};
-
-/**
- * @brief The watchdog ticks counter.
- *
- * With a 1ms watchdog tick, this counter overflows after 50 days since boot.
- */
-extern volatile Watchdog_Interval _Watchdog_Ticks_since_boot;
-
-/**
- * @brief The watchdog nanoseconds per tick.
- *
- * This constant is defined by the application configuration via
- * <rtems/confdefs.h>.
- */
-extern const uint32_t _Watchdog_Nanoseconds_per_tick;
-
-/**
- * @brief The watchdog ticks per second.
- *
- * This constant is defined by the application configuration via
- * <rtems/confdefs.h>.
- */
-extern const uint32_t _Watchdog_Ticks_per_second;
-
-/**
- * @brief The maximum number of seconds representable in the monotonic watchdog
- * format.
- *
- * This constant is defined by the application configuration via
- * <rtems/confdefs.h>.
- */
-extern const uint64_t _Watchdog_Monotonic_max_seconds;
-
-/**@}*/
-
-#ifdef __cplusplus
-}
-#endif
-
-#endif
-/* end of include file */