bsps/irq: bsp_interrupt_vector_enable()

Return a status code for bsp_interrupt_vector_enable().

Update #3269.
This commit is contained in:
Sebastian Huber
2021-07-26 19:57:30 +02:00
parent deb5afb2f2
commit bc86a5fa84
37 changed files with 94 additions and 45 deletions
+10 -6
View File
@@ -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.