ISR_ADD(9)         NetBSD Kernel Manual (SUN3 Architecture)         ISR_ADD(9)

NNAAMMEE
     iissrr__aadddd, iissrr__aadddd__aauuttoovveecctt, iissrr__aadddd__vveeccttoorreedd, iissrr__aadddd__ccuussttoomm - establish
     interrupt handler

SSYYNNOOPPSSIISS
     ##iinncclluuddee <<mmaacchhiinnee//aauuttooccoonnff..hh>>

     typedef int (*isr_func_t)(void *);

     _v_o_i_d
     iissrr__aadddd__aauuttoovveecctt(_i_s_r___f_u_n_c___t _f_u_n, _v_o_i_d _*_a_r_g, _i_n_t _l_e_v_e_l);

     _v_o_i_d
     iissrr__aadddd__vveeccttoorreedd(_i_s_r___f_u_n_c___t _f_u_n, _v_o_i_d _*_a_r_g, _i_n_t _p_r_i, _i_n_t _v_e_c);

     _v_o_i_d
     iissrr__aadddd__ccuussttoomm(_i_n_t _l_e_v_e_l, _v_o_i_d _*_f_u_n);

DDEESSCCRRIIPPTTIIOONN
     The iissrr__aadddd functions establish interrupt handlers into the system inter-
     rupt dispatch table, typically called during the autoconfiguration pro-
     cess for a device.

     There are two types of interrupts in the Motorola 68000 architecture,
     which differ in the way that an interrupt request is mapped to a dispatch
     function within the interrupt vector table.

     When the CPU detects an asserted signal on one of its interrupt request
     lines, it stops normal instruction execution and begins an interrupt ac-
     knowledge sequence on the system bus.  During this cycle the interrupting
     device directs how the CPU is to dispatch the interrupt request.

     If the interrupting device is sophisticated enough, it provides an 8-bit
     interrupt vector number to the CPU and a ``vectored'' interrupt occurs.
     This vector number points to a vector entry within the interrupt vector
     table to which instruction execution is immediately transfered.

     If the interrupting device cannot provide a vector number, it asserts a
     specialized bus line and an ``autovectored'' interrupt occurs.  The vec-
     tor number to use is determined by adding the interrupt priority (0-6) to
     an autovector base (typically 0x18).

     iissrr__aadddd__aauuttoovveecctt()
                      Adds the function _f_u_n to the list of interrupt handlers
                      to be called during an autovectored interrupt of priori-
                      ty _l_e_v_e_l. The pointer _a_r_g is passed to the function as
                      its first argument.

     iissrr__aadddd__vveeccttoorreedd()
                      Adds the function _f_u_n to the list of interrupt handlers
                      to be called during a vectored interrupts of priority
                      _p_r_i at dispatch vector number _v_e_c. The pointer _a_r_g is
                      passed to the function as its first argument.

     iissrr__aadddd__ccuussttoomm()
                      Establish function _f_u_n as the interrupt handler for vec-
                      tor _l_e_v_e_l. The autovector base number is automatically
                      added to _l_e_v_e_l.

                      _f_u_n is called directly as the dispatch handler and must
                      handle all of the specifics of saving the processor
                      state and returning from a processor exception.  These
                      requirements generally dictate that _f_u_n be written in
                      assembler.

CCOODDEE RREEFFEERREENNCCEESS
     ssrrcc//ssyyss//aarrcchh//ssuunn33//ssuunn33//iissrr..cc

RREEFFEERREENNCCEESS
     MC68030 User's Manual, Third edition, MC68030UM/AD Rev 2, Motorola Inc.

BBUUGGSS
     There is no way to remove a handler once it has been added.

NetBSD                           May 21, 1997                                2