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-2018, 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
45package System.Soft_Links.Initialize is
46   pragma Elaborate_Body;
47   --  Allow this package to have a body
48end System.Soft_Links.Initialize;
49