bsps/irq: bsp_interrupt_vector_enable()

Return a status code for bsp_interrupt_vector_enable().

Update #3269.

1 files changed, 10 insertions, 6 deletions

diff --git a/bsps/include/bsp/irq-generic.h b/bsps/include/bsp/irq-generic.h
index c7888b5be4..8cd771ca16 100644
--- a/bsps/include/bsp/irq-generic.h
+++ b/bsps/include/bsp/irq-generic.h
@@ -258,20 +258,24 @@ rtems_status_code bsp_interrupt_vector_is_enabled(
 );
 
 /**
- * @brief Enables the interrupt vector with number @a vector.
+ * @brief Enables the interrupt vector.
  *
  * This function shall enable the vector at the corresponding facility (in most
  * cases the interrupt controller).  It will be called then the first handler
  * is installed for the vector in bsp_interrupt_handler_install() for example.
  *
  * @note The implementation should use
- * bsp_interrupt_assert(bsp_interrupt_is_valid_vector(vector)) to valdiate the
- * vector number.
+ * bsp_interrupt_assert( bsp_interrupt_is_valid_vector( vector ) ) to validate
+ * the vector number in ::RTEMS_DEBUG configurations.
  *
- * @note You must not install or remove an interrupt handler in this function.
- * This may result in a deadlock.
+ * @param vector is the interrupt vector number.
+ *
+ * @retval ::RTEMS_SUCCESSFUL The requested operation was successful.
+ *
+ * @retval ::RTEMS_UNSATISFIED The request to enable the interrupt vector has
+ *   not been satisfied.
  */
-void bsp_interrupt_vector_enable(rtems_vector_number vector);
+rtems_status_code bsp_interrupt_vector_enable( rtems_vector_number vector );
 
 /**
  * @brief Disables the interrupt vector with number @a vector.