summaryrefslogtreecommitdiffstats
path: root/cpukit/score/include/rtems/bspsmp.h
diff options
context:
space:
mode:
Diffstat (limited to 'cpukit/score/include/rtems/bspsmp.h')
-rw-r--r--cpukit/score/include/rtems/bspsmp.h29
1 files changed, 16 insertions, 13 deletions
diff --git a/cpukit/score/include/rtems/bspsmp.h b/cpukit/score/include/rtems/bspsmp.h
index fa1b65b815..dc747e00d2 100644
--- a/cpukit/score/include/rtems/bspsmp.h
+++ b/cpukit/score/include/rtems/bspsmp.h
@@ -26,6 +26,8 @@
/**
* @defgroup RTEMS BSP SMP Interface
*
+ * @ingroup Score
+ *
* This defines the interface between RTEMS and the BSP for
* SMP support. The interface uses the term primary
* to refer to the "boot" processor and secondary to refer
@@ -47,7 +49,7 @@ extern "C" {
#ifndef ASM
/**
- * @brief Maximum Number of CPUs in SMP System
+ * @brief Maximum number of CPUs in SMP system.
*
* This variable is set during the SMP initialization sequence to
* indicate the Maximum number of CPUs in this system.
@@ -55,7 +57,7 @@ extern "C" {
extern uint32_t rtems_configuration_smp_maximum_processors;
/**
- * @brief Initialize Secondary CPUs
+ * @brief Initialize secondary CPUs.
*
* This method is invoked by RTEMS during initialization to bring the
* secondary CPUs out of reset.
@@ -63,7 +65,7 @@ extern uint32_t rtems_configuration_smp_maximum_processors;
* @param [in] maximum is the maximum number of CPU cores that RTEMS
* can handle
*
- * @return This method returns the number of cores available in the
+ * @retval This method returns the number of cores available in the
* system.
*/
int bsp_smp_initialize(
@@ -71,17 +73,17 @@ int bsp_smp_initialize(
);
/**
- * @brief Obtain Current CPU Index
+ * @brief Obtain current CPU index.
*
* This method is invoked by RTEMS when it needs to know the index
* of the CPU it is executing on.
*
- * @return This method returns the current CPU index.
+ * @retval This method returns the current CPU index.
*/
int bsp_smp_processor_id(void) RTEMS_COMPILER_PURE_ATTRIBUTE;
/**
- * @brief Make Request of Another CPU
+ * @brief Make request of another CPU.
*
* This method is invoked by RTEMS when it needs to make a request
* of another CPU. It should be implemented using some type of
@@ -96,7 +98,7 @@ void rtems_smp_send_message(
);
/**
- * @brief Generate a Interprocessor Broadcast Interrupt
+ * @brief Generate an interprocessor broadcast interrupt.
*
* This method is invoked when RTEMS wants to let all of the other
* CPUs know that it has sent them message. CPUs not including
@@ -110,7 +112,7 @@ void rtems_smp_send_message(
void bsp_smp_broadcast_interrupt(void);
/**
- * @brief Generate a Interprocessor Interrupt
+ * @brief Generate a interprocessor interrupt.
*
* This method is invoked by RTEMS to let @a cpu know that it
* has sent it a message.
@@ -122,7 +124,7 @@ void bsp_smp_interrupt_cpu(
);
/**
- * @brief Obtain CPU Core Number
+ * @brief Obtain CPU core number.
*
* This method is invoked by RTEMS when it needs to know which core
* number it is executing on. This is used when it needs to perform
@@ -130,7 +132,7 @@ void bsp_smp_interrupt_cpu(
* the other cores. For example, it may need to realize it needs to
* preempt a thread on another node.
*
- * @return This method returns the Id of the current CPU core.
+ * @retval This method returns the Id of the current CPU core.
*/
int bsp_smp_processor_id( void );
@@ -145,7 +147,7 @@ int bsp_smp_processor_id( void );
void bsp_smp_secondary_cpu_initialize(int cpu);
/**
- * @brief RTEMS SMP Secondary CPU Initialize
+ * @brief Initialize secondary CPU and coordinates.
*
* This method is the C entry point which secondary CPUs should
* arrange to call. It performs OS initialization for the secondary
@@ -166,7 +168,7 @@ void rtems_smp_secondary_cpu_initialize(void);
void rtems_smp_initialize_per_cpu(int cpu);
/**
- * @brief RTEMS SMP Proccess Interrupt
+ * @brief Process the incoming interprocessor request.
*
* This is the method called by the BSP's interrupt handler
* to process the incoming interprocessor request.
@@ -189,6 +191,7 @@ void bsp_smp_wait_for(
#define bsp_smp_processor_id() 0
#endif
+/**@}*/
#endif
-/* end of include file */
+/* end of include file */ \ No newline at end of file