gcc/ada/libgnat/s-soliin.ads

   1 ------------------------------------------------------------------------------
   2 --                                                                          --
   3 --                         GNAT COMPILER COMPONENTS                         --
   4 --                                                                          --
   5 --          S Y S T E M . S O F T _ L I N K S . I N I T I A L I Z E         --
   6 --                                                                          --
   7 --                                 S p e c                                  --
   8 --                                                                          --
   9 --            Copyright (C) 2017, Free Software Foundation, Inc.            --
  10 --                                                                          --
  11 -- GNAT 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 -- GNAT was originally developed  by the GNAT team at  New York University. --
  28 -- Extensive contributions were provided by Ada Core Technologies Inc.      --
  29 --                                                                          --
  30 ------------------------------------------------------------------------------
  31
  32 --  This package exists to initialize the TSD record of the main task and in
  33 --  the process, allocate and initialize the secondary stack for the main task.
  34 --  The initialization routine is contained within its own package because
  35 --  System.Soft_Links and System.Secondary_Stack are both Preelaborate packages
  36 --  that are the parents to other Preelaborate System packages.
  37
  38 --  Ideally, the secondary stack would be set up via __gnat_runtime_initialize
  39 --  to have the secondary stack active as early as possible and to remove the
  40 --  awkwardness of System.Soft_Links depending on a non-Preelaborate package.
  41 --  However, as this procedure only exists from 2014, for bootstrapping
  42 --  purposes the elaboration mechanism is used instead to perform these
  43 --  functions.
  44
  45 package System.Soft_Links.Initialize is
  46    pragma Elaborate_Body;
  47    --  Allow this package to have a body
  48 end System.Soft_Links.Initialize;