gcc/ada/i-vxinco.ads

   1 ------------------------------------------------------------------------------
   2 --                                                                          --
   3 --                 GNAT RUN-TIME LIBRARY (GNARL) COMPONENTS                 --
   4 --                                                                          --
   5 --     I N T E R F A C E S . V X W O R K S . I N T  _ C O N N E C T I O N   --
   6 --                                                                          --
   7 --                                  S p e c                                 --
   8 --                                                                          --
   9 --                        Copyright (C) 2016, AdaCore
  10 --                                                                          --
  11 -- GNARL is free software; you can  redistribute it  and/or modify it under --
  12 -- terms of the  GNU General Public License as published  by the Free Soft- --
  13 -- ware  Foundation;  either version 3,  or (at your option) any later ver- --
  14 -- sion.  GNAT is distributed in the hope that it will be useful, but WITH- --
  15 -- OUT ANY WARRANTY;  without even the  implied warranty of MERCHANTABILITY --
  16 -- or FITNESS FOR A PARTICULAR PURPOSE.                                     --
  17 --                                                                          --
  18 -- As a special exception under Section 7 of GPL version 3, you are granted --
  19 -- additional permissions described in the GCC Runtime Library Exception,   --
  20 -- version 3.1, as published by the Free Software Foundation.               --
  21 --                                                                          --
  22 -- You should have received a copy of the GNU General Public License and    --
  23 -- a copy of the GCC Runtime Library Exception along with this program;     --
  24 -- see the files COPYING3 and COPYING.RUNTIME respectively.  If not, see    --
  25 -- <http://www.gnu.org/licenses/>.                                          --
  26 --                                                                          --
  27 -- GNARL was developed by the GNARL team at Florida State University.       --
  28 -- Extensive contributions were provided by Ada Core Technologies, Inc.     --
  29 --                                                                          --
  30 ------------------------------------------------------------------------------
  31
  32 --  This package provides users with the ability to use a custom routine for
  33 --  connecting hardware interrupts for VxWorks environments that support the
  34 --  capability to handle them. The custom routine must have the same profile
  35 --  as the VxWorks intConnect() routine.
  36
  37 with System;
  38
  39 package Interfaces.VxWorks.Int_Connection is
  40
  41    type Interrupt_Connector is access function
  42      (Vector    : Interrupt_Vector;
  43       Handler   : VOIDFUNCPTR;
  44       Parameter : System.Address := System.Null_Address) return STATUS;
  45    pragma Convention (C, Interrupt_Connector);
  46    --  Convention C for compatibility with intConnect(). User alternatives are
  47    --  likely to be imports of C routines anyway.
  48
  49    procedure Connect (Connector : Interrupt_Connector);
  50    --  Set user-defined interrupt connection routine. Must precede calls to
  51    --  Ada.Interrupts.Attach_Handler, or the default connector from
  52    --  System.OS_Interface (or Interfaces.VxWorks for Ravenscar Cert) will be
  53    --  used. Can be called multiple times to change the connection routine for
  54    --  subsequent calls to Attach_Handler.
  55
  56 end Interfaces.VxWorks.Int_Connection;