shared/irq/irq-handler-iterate.c

0001 /* SPDX-License-Identifier: BSD-2-Clause */
0002
0003 /**
0004  * @file
0005  *
0006  * @ingroup RTEMSImplClassicIntr
0007  *
0008  * @brief This source file contains the implementation of
0009  *   rtems_interrupt_handler_iterate().
0010  */
0011
0012 /*
0013  * Copyright (C) 2017, 2021 embedded brains GmbH & Co. KG
0014  *
0015  * Redistribution and use in source and binary forms, with or without
0016  * modification, are permitted provided that the following conditions
0017  * are met:
0018  * 1. Redistributions of source code must retain the above copyright
0019  *    notice, this list of conditions and the following disclaimer.
0020  * 2. Redistributions in binary form must reproduce the above copyright
0021  *    notice, this list of conditions and the following disclaimer in the
0022  *    documentation and/or other materials provided with the distribution.
0023  *
0024  * THIS SOFTWARE IS PROVIDED BY THE COPYRIGHT HOLDERS AND CONTRIBUTORS "AS IS"
0025  * AND ANY EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT LIMITED TO, THE
0026  * IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE
0027  * ARE DISCLAIMED. IN NO EVENT SHALL THE COPYRIGHT OWNER OR CONTRIBUTORS BE
0028  * LIABLE FOR ANY DIRECT, INDIRECT, INCIDENTAL, SPECIAL, EXEMPLARY, OR
0029  * CONSEQUENTIAL DAMAGES (INCLUDING, BUT NOT LIMITED TO, PROCUREMENT OF
0030  * SUBSTITUTE GOODS OR SERVICES; LOSS OF USE, DATA, OR PROFITS; OR BUSINESS
0031  * INTERRUPTION) HOWEVER CAUSED AND ON ANY THEORY OF LIABILITY, WHETHER IN
0032  * CONTRACT, STRICT LIABILITY, OR TORT (INCLUDING NEGLIGENCE OR OTHERWISE)
0033  * ARISING IN ANY WAY OUT OF THE USE OF THIS SOFTWARE, EVEN IF ADVISED OF THE
0034  * POSSIBILITY OF SUCH DAMAGE.
0035  */
0036
0037 #include <bsp/irq-generic.h>
0038
0039 rtems_status_code rtems_interrupt_handler_iterate(
0040   rtems_vector_number                 vector,
0041   rtems_interrupt_per_handler_routine routine,
0042   void                               *arg
0043 )
0044 {
0045   rtems_status_code      sc;
0046   rtems_vector_number    index;
0047   rtems_option           options;
0048   rtems_interrupt_entry *entry;
0049
0050   sc = bsp_interrupt_check_and_lock(
0051     vector,
0052     (rtems_interrupt_handler) routine
0053   );
0054
0055   if ( sc != RTEMS_SUCCESSFUL ) {
0056     return sc;
0057   }
0058
0059   index = bsp_interrupt_dispatch_index( vector );
0060   entry = *bsp_interrupt_get_dispatch_table_slot( index );
0061   options = bsp_interrupt_is_handler_unique( index ) ?
0062     RTEMS_INTERRUPT_UNIQUE : RTEMS_INTERRUPT_SHARED;
0063
0064   while ( entry != NULL ) {
0065     ( *routine )( arg, entry->info, options, entry->handler, entry->arg );
0066     entry = entry->next;
0067   }
0068
0069   bsp_interrupt_unlock();
0070
0071   return RTEMS_SUCCESSFUL;
0072 }