rtems: Create signal implementation header

Move implementation specific parts of signal.h into new header file
signalimpl.h.  The signal.h contains now only the application visible
API.

3 files changed, 69 insertions, 32 deletions

diff --git a/cpukit/rtems/include/rtems/rtems/signal.h b/cpukit/rtems/include/rtems/rtems/signal.h
index 18f31b5ff5..a1b43dd3c6 100644
--- a/cpukit/rtems/include/rtems/rtems/signal.h
+++ b/cpukit/rtems/include/rtems/rtems/signal.h
@@ -1,19 +1,9 @@
 /**
- * @file rtems/rtems/signal.h
+ * @file
  *
- * @defgroup ClassicSignal Signals
- *
- * @ingroup ClassicRTEMS
- * @brief Signal Manager
- *
- * This include file contains all the constants and structures associated
- * with the Signal Manager. This manager provides capabilities required
- * for asynchronous communication between tasks via signal sets.
+ * @ingroup ClassicSignal
  *
- * Directives provided are:
- *
- * + establish an asynchronous signal routine
- * + send a signal set to a task
+ * @brief Signals API
  */
 
 /* COPYRIGHT (c) 1989-2008.
@@ -27,32 +17,26 @@
 #ifndef _RTEMS_RTEMS_SIGNAL_H
 #define _RTEMS_RTEMS_SIGNAL_H
 
-/**
- *  @defgroup ClassicSignal Signals
- *
- *  @ingroup ClassicRTEMS
- *
- *  This encapsulates functionality which XXX
- */
-/**@{*/
-
 #include <rtems/rtems/asr.h>
 #include <rtems/rtems/modes.h>
-#include <rtems/score/object.h>
 #include <rtems/rtems/status.h>
 #include <rtems/rtems/types.h>
 
 #ifdef __cplusplus
 extern "C" {
 #endif
+
 /**
- *  @brief Signal Manager Initialization
+ * @defgroup ClassicSignal Signals
  *
- *  Signal Manager
+ * @ingroup ClassicRTEMS
  *
- *  This routine performs the initialization necessary for this manager.
+ * Directives provided are:
+ *
+ * + establish an asynchronous signal routine
+ * + send a signal set to a task
  */
-void _Signal_Manager_initialization( void );
+/**@{*/
 
 /**
  * @brief RTEMS Catch Signal
@@ -89,15 +73,11 @@ rtems_status_code rtems_signal_send(
   rtems_signal_set signal_set
 );
 
-#if defined(RTEMS_MULTIPROCESSING)
-#include <rtems/rtems/signalmp.h>
-#endif
+/**@}*/
 
 #ifdef __cplusplus
 }
 #endif
 
-/**@}*/
-
 #endif
 /* end of include file */
diff --git a/cpukit/rtems/include/rtems/rtems/signalimpl.h b/cpukit/rtems/include/rtems/rtems/signalimpl.h
new file mode 100644
index 0000000000..41339f1151
--- /dev/null
+++ b/cpukit/rtems/include/rtems/rtems/signalimpl.h
@@ -0,0 +1,53 @@
+/**
+ * @file
+ *
+ * @ingroup ClassicSignalImpl
+ *
+ * @brief Signals Implementation
+ */
+
+/* COPYRIGHT (c) 1989-2008.
+ * 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.com/license/LICENSE.
+ */
+
+#ifndef _RTEMS_RTEMS_SIGNALIMPL_H
+#define _RTEMS_RTEMS_SIGNALIMPL_H
+
+#include <rtems/rtems/signal.h>
+
+#ifdef __cplusplus
+extern "C" {
+#endif
+
+/**
+ * @defgroup ClassicSignalImpl Signals Implementation
+ *
+ * @ingroup ClassicSignal
+ */
+/**@{*/
+
+/**
+ *  @brief Signal Manager Initialization
+ *
+ *  Signal Manager
+ *
+ *  This routine performs the initialization necessary for this manager.
+ */
+void _Signal_Manager_initialization( void );
+
+/**@}*/
+
+#ifdef __cplusplus
+}
+#endif
+
+#if defined(RTEMS_MULTIPROCESSING)
+#include <rtems/rtems/signalmp.h>
+#endif
+
+#endif
+/* end of include file */
diff --git a/cpukit/rtems/include/rtems/rtems/signalmp.h b/cpukit/rtems/include/rtems/rtems/signalmp.h
index 82a7e07ef8..dd1271dd14 100644
--- a/cpukit/rtems/include/rtems/rtems/signalmp.h
+++ b/cpukit/rtems/include/rtems/rtems/signalmp.h
@@ -18,6 +18,10 @@
 #ifndef _RTEMS_RTEMS_SIGNALMP_H
 #define _RTEMS_RTEMS_SIGNALMP_H
 
+#ifndef _RTEMS_RTEMS_SIGNALIMPL_H
+# error "Never use <rtems/rtems/signalmp.h> directly; include <rtems/rtems/signalimpl.h> instead."
+#endif
+
 #ifdef __cplusplus
 extern "C" {
 #endif