OSDN Git Service

Minor comment updates.
[pf3gnuchains/gcc-fork.git] / gcc / ada / a-tasatt.adb
1 ------------------------------------------------------------------------------
2 --                                                                          --
3 --                        GNAT RUN-TIME COMPONENTS                          --
4 --                                                                          --
5 --                  A D A . T A S K _ A T T R I B U T E S                   --
6 --                                                                          --
7 --                                 B o d y                                  --
8 --                                                                          --
9 --             Copyright (C) 1991-1994, Florida State University            --
10 --                     Copyright (C) 1995-2009, AdaCore                     --
11 --                                                                          --
12 -- GNARL is free software; you can  redistribute it  and/or modify it under --
13 -- terms of the  GNU General Public License as published  by the Free Soft- --
14 -- ware  Foundation;  either version 2,  or (at your option) any later ver- --
15 -- sion. GNARL is distributed in the hope that it will be useful, but WITH- --
16 -- OUT ANY WARRANTY;  without even the  implied warranty of MERCHANTABILITY --
17 -- or FITNESS FOR A PARTICULAR PURPOSE.  See the GNU General Public License --
18 -- for  more details.  You should have  received  a copy of the GNU General --
19 -- Public License  distributed with GNARL; see file COPYING.  If not, write --
20 -- to  the  Free Software Foundation,  51  Franklin  Street,  Fifth  Floor, --
21 -- Boston, MA 02110-1301, USA.                                              --
22 --                                                                          --
23 -- As a special exception,  if other files  instantiate  generics from this --
24 -- unit, or you link  this unit with other files  to produce an executable, --
25 -- this  unit  does not  by itself cause  the resulting  executable  to  be --
26 -- covered  by the  GNU  General  Public  License.  This exception does not --
27 -- however invalidate  any other reasons why  the executable file  might be --
28 -- covered by the  GNU Public License.                                      --
29 --                                                                          --
30 -- GNARL was developed by the GNARL team at Florida State University.       --
31 -- Extensive contributions were provided by Ada Core Technologies, Inc.     --
32 --                                                                          --
33 ------------------------------------------------------------------------------
34
35 --  The following notes are provided in case someone decides the implementation
36 --  of this package is too complicated, or too slow. Please read this before
37 --  making any "simplifications".
38
39 --  Correct implementation of this package is more difficult than one might
40 --  expect. After considering (and coding) several alternatives, we settled on
41 --  the present compromise. Things we do not like about this implementation
42 --  include:
43
44 --  - It is vulnerable to bad Task_Id values, to the extent of possibly
45 --    trashing memory and crashing the runtime system.
46
47 --  - It requires dynamic storage allocation for each new attribute value,
48 --    except for types that happen to be the same size as System.Address, or
49 --    shorter.
50
51 --  - Instantiations at other than the library level rely on being able to
52 --    do down-level calls to a procedure declared in the generic package body.
53 --    This makes it potentially vulnerable to compiler changes.
54
55 --  The main implementation issue here is that the connection from task to
56 --  attribute is a potential source of dangling references.
57
58 --  When a task goes away, we want to be able to recover all the storage
59 --  associated with its attributes. The Ada mechanism for this is finalization,
60 --  via controlled attribute types. For this reason, the ARM requires
61 --  finalization of attribute values when the associated task terminates.
62
63 --  This finalization must be triggered by the tasking runtime system, during
64 --  termination of the task. Given the active set of instantiations of
65 --  Ada.Task_Attributes is dynamic, the number and types of attributes
66 --  belonging to a task will not be known until the task actually terminates.
67 --  Some of these types may be controlled and some may not. The RTS must find
68 --  some way to determine which of these attributes need finalization, and
69 --  invoke the appropriate finalization on them.
70
71 --  One way this might be done is to create a special finalization chain for
72 --  each task, similar to the finalization chain that is used for controlled
73 --  objects within the task. This would differ from the usual finalization
74 --  chain in that it would not have a LIFO structure, since attributes may be
75 --  added to a task at any time during its lifetime. This might be the right
76 --  way to go for the longer term, but at present this approach is not open,
77 --  since GNAT does not provide such special finalization support.
78
79 --  Lacking special compiler support, the RTS is limited to the normal ways an
80 --  application invokes finalization, i.e.
81
82 --  a) Explicit call to the procedure Finalize, if we know the type has this
83 --     operation defined on it. This is not sufficient, since we have no way
84 --     of determining whether a given generic formal Attribute type is
85 --     controlled, and no visibility of the associated Finalize procedure, in
86 --     the generic body.
87
88 --  b) Leaving the scope of a local object of a controlled type. This does not
89 --     help, since the lifetime of an instantiation of Ada.Task_Attributes
90 --     does not correspond to the lifetimes of the various tasks which may
91 --     have that attribute.
92
93 --  c) Assignment of another value to the object. This would not help, since
94 --     we then have to finalize the new value of the object.
95
96 --  d) Unchecked deallocation of an object of a controlled type. This seems to
97 --     be the only mechanism available to the runtime system for finalization
98 --     of task attributes.
99
100 --  We considered two ways of using unchecked deallocation, both based on a
101 --  linked list of that would hang from the task control block.
102
103 --  In the first approach the objects on the attribute list are all derived
104 --  from one controlled type, say T, and are linked using an access type to
105 --  T'Class. The runtime system has an Ada.Unchecked_Deallocation for T'Class
106 --  with access type T'Class, and uses this to deallocate and finalize all the
107 --  items in the list. The limitation of this approach is that each
108 --  instantiation of the package Ada.Task_Attributes derives a new record
109 --  extension of T, and since T is controlled (RM 3.9.1 (3)), instantiation is
110 --  only allowed at the library level.
111
112 --  In the second approach the objects on the attribute list are of unrelated
113 --  but structurally similar types. Unchecked conversion is used to circument
114 --  Ada type checking. Each attribute-storage node contains not only the
115 --  attribute value and a link for chaining, but also a pointer to descriptor
116 --  for the corresponding instantiation of Task_Attributes. The instantiation
117 --  descriptor contains pointer to a procedure that can do the correct
118 --  deallocation and finalization for that type of attribute. On task
119 --  termination, the runtime system uses the pointer to call the appropriate
120 --  deallocator.
121
122 --  While this gets around the limitation that instantations be at the library
123 --  level, it relies on an implementation feature that may not always be safe,
124 --  i.e. that it is safe to call the Deallocate procedure for an instantiation
125 --  of Ada.Task_Attributes that no longer exists. In general, it seems this
126 --  might result in dangling references.
127
128 --  Another problem with instantiations deeper than the library level is that
129 --  there is risk of storage leakage, or dangling references to reused storage.
130 --  That is, if an instantiation of Ada.Task_Attributes is made within a
131 --  procedure, what happens to the storage allocated for attributes, when the
132 --  procedure call returns? Apparently (RM 7.6.1 (4)) any such objects must be
133 --  finalized, since they will no longer be accessible, and in general one
134 --  would expect that the storage they occupy would be recovered for later
135 --  reuse. (If not, we would have a case of storage leakage.) Assuming the
136 --  storage is recovered and later reused, we have potentially dangerous
137 --  dangling references. When the procedure containing the instantiation of
138 --  Ada.Task_Attributes returns, there may still be unterminated tasks with
139 --  associated attribute values for that instantiation. When such tasks
140 --  eventually terminate, the RTS will attempt to call the Deallocate procedure
141 --  on them. If the corresponding storage has already been deallocated, when
142 --  the master of the access type was left, we have a potential disaster. This
143 --  disaster is compounded since the pointer to Deallocate is probably through
144 --  a "trampoline" which will also have been destroyed.
145
146 --  For this reason, we arrange to remove all dangling references before
147 --  leaving the scope of an instantiation. This is ugly, since it requires
148 --  traversing the list of all tasks, but it is no more ugly than a similar
149 --  traversal that we must do at the point of instantiation in order to
150 --  initialize the attributes of all tasks. At least we only need to do these
151 --  traversals if the type is controlled.
152
153 --  We chose to defer allocation of storage for attributes until the Reference
154 --  function is called or the attribute is first set to a value different from
155 --  the default initial one. This allows a potential savings in allocation,
156 --  for attributes that are not used by all tasks.
157
158 --  For efficiency, we reserve space in the TCB for a fixed number of direct-
159 --  access attributes. These are required to be of a size that fits in the
160 --  space of an object of type System.Address. Because we must use unchecked
161 --  bitwise copy operations on these values, they cannot be of a controlled
162 --  type, but that is covered automatically since controlled objects are too
163 --  large to fit in the spaces.
164
165 --  We originally deferred initialization of these direct-access attributes,
166 --  just as we do for the indirect-access attributes, and used a per-task bit
167 --  vector to keep track of which attributes were currently defined for that
168 --  task. We found that the overhead of maintaining this bit-vector seriously
169 --  slowed down access to the attributes, and made the fetch operation non-
170 --  atomic, so that even to read an attribute value required locking the TCB.
171 --  Therefore, we now initialize such attributes for all existing tasks at the
172 --  time of the attribute instantiation, and initialize existing attributes for
173 --  each new task at the time it is created.
174
175 --  The latter initialization requires a list of all the instantiation
176 --  descriptors. Updates to this list, as well as the bit-vector that is used
177 --  to reserve slots for attributes in the TCB, require mutual exclusion. That
178 --  is provided by the Lock/Unlock_RTS.
179
180 --  One special problem that added complexity to the design is that the per-
181 --  task list of indirect attributes contains objects of different types. We
182 --  use unchecked pointer conversion to link these nodes together and access
183 --  them, but the records may not have identical internal structure. Initially,
184 --  we thought it would be enough to allocate all the common components of
185 --  the records at the front of each record, so that their positions would
186 --  correspond. Unfortunately, GNAT adds "dope" information at the front
187 --  of a record, if the record contains any controlled-type components.
188 --
189 --  This means that the offset of the fields we use to link the nodes is at
190 --  different positions on nodes of different types. To get around this, each
191 --  attribute storage record consists of a core node and wrapper. The core
192 --  nodes are all of the same type, and it is these that are linked together
193 --  and generally "seen" by the RTS. Each core node contains a pointer to its
194 --  own wrapper, which is a record that contains the core node along with an
195 --  attribute value, approximately as follows:
196
197 --    type Node;
198 --    type Node_Access is access all Node;
199 --    type Wrapper;
200 --    type Access_Wrapper is access all Wrapper;
201 --    type Node is record
202 --       Next    : Node_Access;
203 --       ...
204 --       Wrapper : Access_Wrapper;
205 --    end record;
206 --    type Wrapper is record
207 --       Dummy_Node : aliased Node;
208 --       Value      : aliased Attribute;  --  the generic formal type
209 --    end record;
210
211 --  Another interesting problem is with the initialization of the instantiation
212 --  descriptors. Originally, we did this all via the Initialize procedure of
213 --  the descriptor type and code in the package body. It turned out that the
214 --  Initialize procedure needed quite a bit of information, including the size
215 --  of the attribute type, the initial value of the attribute (if it fits in
216 --  the TCB), and a pointer to the deallocator procedure. These needed to be
217 --  "passed" in via access discriminants. GNAT was having trouble with access
218 --  discriminants, so all this work was moved to the package body.
219
220 --  Note that references to objects declared in this package body must in
221 --  general use 'Unchecked_Access instead of 'Access as the package can be
222 --  instantiated from within a local context.
223
224 with System.Error_Reporting;
225 with System.Storage_Elements;
226 with System.Task_Primitives.Operations;
227 with System.Tasking;
228 with System.Tasking.Initialization;
229 with System.Tasking.Task_Attributes;
230
231 with Ada.Exceptions;
232 with Ada.Unchecked_Conversion;
233 with Ada.Unchecked_Deallocation;
234
235 pragma Elaborate_All (System.Tasking.Task_Attributes);
236 --  To ensure the initialization of object Local (below) will work
237
238 package body Ada.Task_Attributes is
239
240    use System.Error_Reporting,
241        System.Tasking.Initialization,
242        System.Tasking,
243        System.Tasking.Task_Attributes,
244        Ada.Exceptions;
245
246    package POP renames System.Task_Primitives.Operations;
247
248    ---------------------------
249    -- Unchecked Conversions --
250    ---------------------------
251
252    --  The following type corresponds to Dummy_Wrapper, declared in
253    --  System.Tasking.Task_Attributes.
254
255    type Wrapper;
256    type Access_Wrapper is access all Wrapper;
257
258    pragma Warnings (Off);
259    --  We turn warnings off for the following To_Attribute_Handle conversions,
260    --  since these are used only for small attributes where we know that there
261    --  are no problems with alignment, but the compiler will generate warnings
262    --  for the occurrences in the large attribute case, even though they will
263    --  not actually be used.
264
265    function To_Attribute_Handle is new Ada.Unchecked_Conversion
266      (System.Address, Attribute_Handle);
267    function To_Direct_Attribute_Element is new Ada.Unchecked_Conversion
268      (System.Address, Direct_Attribute_Element);
269    --  For reference to directly addressed task attributes
270
271    type Access_Integer_Address is access all
272      System.Storage_Elements.Integer_Address;
273
274    function To_Attribute_Handle is new Ada.Unchecked_Conversion
275      (Access_Integer_Address, Attribute_Handle);
276    --  For reference to directly addressed task attributes
277
278    pragma Warnings (On);
279    --  End warnings off region for directly addressed attribute conversions
280
281    function To_Access_Address is new Ada.Unchecked_Conversion
282      (Access_Node, Access_Address);
283    --  To store pointer to list of indirect attributes
284
285    pragma Warnings (Off);
286    function To_Access_Wrapper is new Ada.Unchecked_Conversion
287      (Access_Dummy_Wrapper, Access_Wrapper);
288    pragma Warnings (On);
289    --  To fetch pointer to actual wrapper of attribute node. We turn off
290    --  warnings since this may generate an alignment warning. The warning can
291    --  be ignored since Dummy_Wrapper is only a non-generic standin for the
292    --  real wrapper type (we never actually allocate objects of type
293    --  Dummy_Wrapper).
294
295    function To_Access_Dummy_Wrapper is new Ada.Unchecked_Conversion
296      (Access_Wrapper, Access_Dummy_Wrapper);
297    --  To store pointer to actual wrapper of attribute node
298
299    function To_Task_Id is new Ada.Unchecked_Conversion
300      (Task_Identification.Task_Id, Task_Id);
301    --  To access TCB of identified task
302
303    type Local_Deallocator is access procedure (P : in out Access_Node);
304
305    function To_Lib_Level_Deallocator is new Ada.Unchecked_Conversion
306      (Local_Deallocator, Deallocator);
307    --  To defeat accessibility check
308
309    ------------------------
310    -- Storage Management --
311    ------------------------
312
313    procedure Deallocate (P : in out Access_Node);
314    --  Passed to the RTS via unchecked conversion of a pointer to permit
315    --  finalization and deallocation of attribute storage nodes.
316
317    --------------------------
318    -- Instantiation Record --
319    --------------------------
320
321    Local : aliased Instance;
322    --  Initialized in package body
323
324    type Wrapper is record
325       Dummy_Node : aliased Node;
326
327       Value : aliased Attribute := Initial_Value;
328       --  The generic formal type, may be controlled
329    end record;
330
331    --  A number of unchecked conversions involving Wrapper_Access sources are
332    --  performed in this unit. We have to ensure that the designated object is
333    --  always strictly enough aligned.
334
335    for Wrapper'Alignment use Standard'Maximum_Alignment;
336
337    procedure Free is
338       new Ada.Unchecked_Deallocation (Wrapper, Access_Wrapper);
339
340    procedure Deallocate (P : in out Access_Node) is
341       T : Access_Wrapper := To_Access_Wrapper (P.Wrapper);
342    begin
343       Free (T);
344    end Deallocate;
345
346    ---------------
347    -- Reference --
348    ---------------
349
350    function Reference
351      (T    : Task_Identification.Task_Id := Task_Identification.Current_Task)
352       return Attribute_Handle
353    is
354       TT            : constant Task_Id := To_Task_Id (T);
355       Error_Message : constant String  := "Trying to get the reference of a ";
356
357    begin
358       if TT = null then
359          Raise_Exception (Program_Error'Identity, Error_Message & "null task");
360       end if;
361
362       if TT.Common.State = Terminated then
363          Raise_Exception (Tasking_Error'Identity,
364            Error_Message & "terminated task");
365       end if;
366
367       --  Directly addressed case
368
369       if Local.Index /= 0 then
370
371          --  Return the attribute handle. Warnings off because this return
372          --  statement generates alignment warnings for large attributes
373          --  (but will never be executed in this case anyway).
374
375          pragma Warnings (Off);
376          return
377            To_Attribute_Handle (TT.Direct_Attributes (Local.Index)'Address);
378          pragma Warnings (On);
379
380       --  Not directly addressed
381
382       else
383          declare
384             P       : Access_Node := To_Access_Node (TT.Indirect_Attributes);
385             W       : Access_Wrapper;
386             Self_Id : constant Task_Id := POP.Self;
387
388          begin
389             Defer_Abort (Self_Id);
390             POP.Lock_RTS;
391
392             while P /= null loop
393                if P.Instance = Access_Instance'(Local'Unchecked_Access) then
394                   POP.Unlock_RTS;
395                   Undefer_Abort (Self_Id);
396                   return To_Access_Wrapper (P.Wrapper).Value'Access;
397                end if;
398
399                P := P.Next;
400             end loop;
401
402             --  Unlock the RTS here to follow the lock ordering rule that
403             --  prevent us from using new (i.e the Global_Lock) while holding
404             --  any other lock.
405
406             POP.Unlock_RTS;
407             W := new Wrapper'
408                   ((null, Local'Unchecked_Access, null), Initial_Value);
409             POP.Lock_RTS;
410
411             P := W.Dummy_Node'Unchecked_Access;
412             P.Wrapper := To_Access_Dummy_Wrapper (W);
413             P.Next := To_Access_Node (TT.Indirect_Attributes);
414             TT.Indirect_Attributes := To_Access_Address (P);
415             POP.Unlock_RTS;
416             Undefer_Abort (Self_Id);
417             return W.Value'Access;
418
419          exception
420             when others =>
421                POP.Unlock_RTS;
422                Undefer_Abort (Self_Id);
423                raise;
424          end;
425       end if;
426
427       pragma Assert (Shutdown ("Should never get here in Reference"));
428       return null;
429
430    exception
431       when Tasking_Error | Program_Error =>
432          raise;
433
434       when others =>
435          raise Program_Error;
436    end Reference;
437
438    ------------------
439    -- Reinitialize --
440    ------------------
441
442    procedure Reinitialize
443      (T : Task_Identification.Task_Id := Task_Identification.Current_Task)
444    is
445       TT            : constant Task_Id := To_Task_Id (T);
446       Error_Message : constant String  := "Trying to Reinitialize a ";
447
448    begin
449       if TT = null then
450          Raise_Exception (Program_Error'Identity, Error_Message & "null task");
451       end if;
452
453       if TT.Common.State = Terminated then
454          Raise_Exception (Tasking_Error'Identity,
455            Error_Message & "terminated task");
456       end if;
457
458       if Local.Index /= 0 then
459          Set_Value (Initial_Value, T);
460       else
461          declare
462             P, Q    : Access_Node;
463             W       : Access_Wrapper;
464             Self_Id : constant Task_Id := POP.Self;
465
466          begin
467             Defer_Abort (Self_Id);
468             POP.Lock_RTS;
469             Q := To_Access_Node (TT.Indirect_Attributes);
470
471             while Q /= null loop
472                if Q.Instance = Access_Instance'(Local'Unchecked_Access) then
473                   if P = null then
474                      TT.Indirect_Attributes := To_Access_Address (Q.Next);
475                   else
476                      P.Next := Q.Next;
477                   end if;
478
479                   W := To_Access_Wrapper (Q.Wrapper);
480                   Free (W);
481                   POP.Unlock_RTS;
482                   Undefer_Abort (Self_Id);
483                   return;
484                end if;
485
486                P := Q;
487                Q := Q.Next;
488             end loop;
489
490             POP.Unlock_RTS;
491             Undefer_Abort (Self_Id);
492
493          exception
494             when others =>
495                POP.Unlock_RTS;
496                Undefer_Abort (Self_Id);
497                raise;
498          end;
499       end if;
500
501    exception
502       when Tasking_Error | Program_Error =>
503          raise;
504
505       when others =>
506          raise Program_Error;
507    end Reinitialize;
508
509    ---------------
510    -- Set_Value --
511    ---------------
512
513    procedure Set_Value
514      (Val : Attribute;
515       T   : Task_Identification.Task_Id := Task_Identification.Current_Task)
516    is
517       TT            : constant Task_Id := To_Task_Id (T);
518       Error_Message : constant String  := "Trying to Set the Value of a ";
519
520    begin
521       if TT = null then
522          Raise_Exception (Program_Error'Identity, Error_Message & "null task");
523       end if;
524
525       if TT.Common.State = Terminated then
526          Raise_Exception (Tasking_Error'Identity,
527            Error_Message & "terminated task");
528       end if;
529
530       --  Directly addressed case
531
532       if Local.Index /= 0 then
533
534          --  Set attribute handle, warnings off, because this code can generate
535          --  alignment warnings with large attributes (but of course will not
536          --  be executed in this case, since we never have direct addressing in
537          --  such cases).
538
539          pragma Warnings (Off);
540          To_Attribute_Handle
541             (TT.Direct_Attributes (Local.Index)'Address).all := Val;
542          pragma Warnings (On);
543          return;
544       end if;
545
546       --  Not directly addressed
547
548       declare
549          P       : Access_Node := To_Access_Node (TT.Indirect_Attributes);
550          W       : Access_Wrapper;
551          Self_Id : constant Task_Id := POP.Self;
552
553       begin
554          Defer_Abort (Self_Id);
555          POP.Lock_RTS;
556
557          while P /= null loop
558
559             if P.Instance = Access_Instance'(Local'Unchecked_Access) then
560                To_Access_Wrapper (P.Wrapper).Value := Val;
561                POP.Unlock_RTS;
562                Undefer_Abort (Self_Id);
563                return;
564             end if;
565
566             P := P.Next;
567          end loop;
568
569          --  Unlock RTS here to follow the lock ordering rule that prevent us
570          --  from using new (i.e the Global_Lock) while holding any other lock.
571
572          POP.Unlock_RTS;
573          W := new Wrapper'((null, Local'Unchecked_Access, null), Val);
574          POP.Lock_RTS;
575          P := W.Dummy_Node'Unchecked_Access;
576          P.Wrapper := To_Access_Dummy_Wrapper (W);
577          P.Next := To_Access_Node (TT.Indirect_Attributes);
578          TT.Indirect_Attributes := To_Access_Address (P);
579
580          POP.Unlock_RTS;
581          Undefer_Abort (Self_Id);
582
583       exception
584          when others =>
585             POP.Unlock_RTS;
586             Undefer_Abort (Self_Id);
587             raise;
588       end;
589
590    exception
591       when Tasking_Error | Program_Error =>
592          raise;
593
594       when others =>
595          raise Program_Error;
596    end Set_Value;
597
598    -----------
599    -- Value --
600    -----------
601
602    function Value
603      (T : Task_Identification.Task_Id := Task_Identification.Current_Task)
604       return Attribute
605    is
606       TT            : constant Task_Id := To_Task_Id (T);
607       Error_Message : constant String  := "Trying to get the Value of a ";
608
609    begin
610       if TT = null then
611          Raise_Exception (Program_Error'Identity, Error_Message & "null task");
612       end if;
613
614       if TT.Common.State = Terminated then
615          Raise_Exception
616            (Program_Error'Identity, Error_Message & "terminated task");
617       end if;
618
619       --  Directly addressed case
620
621       if Local.Index /= 0 then
622
623          --  Get value of attribute. We turn Warnings off, because for large
624          --  attributes, this code can generate alignment warnings. But of
625          --  course large attributes are never directly addressed so in fact
626          --  we will never execute the code in this case.
627
628          pragma Warnings (Off);
629          return To_Attribute_Handle
630            (TT.Direct_Attributes (Local.Index)'Address).all;
631          pragma Warnings (On);
632       end if;
633
634       --  Not directly addressed
635
636       declare
637          P       : Access_Node;
638          Result  : Attribute;
639          Self_Id : constant Task_Id := POP.Self;
640
641       begin
642          Defer_Abort (Self_Id);
643          POP.Lock_RTS;
644          P := To_Access_Node (TT.Indirect_Attributes);
645
646          while P /= null loop
647             if P.Instance = Access_Instance'(Local'Unchecked_Access) then
648                Result := To_Access_Wrapper (P.Wrapper).Value;
649                POP.Unlock_RTS;
650                Undefer_Abort (Self_Id);
651                return Result;
652             end if;
653
654             P := P.Next;
655          end loop;
656
657          POP.Unlock_RTS;
658          Undefer_Abort (Self_Id);
659          return Initial_Value;
660
661       exception
662          when others =>
663             POP.Unlock_RTS;
664             Undefer_Abort (Self_Id);
665             raise;
666       end;
667
668    exception
669       when Tasking_Error | Program_Error =>
670          raise;
671
672       when others =>
673          raise Program_Error;
674    end Value;
675
676 --  Start of elaboration code for package Ada.Task_Attributes
677
678 begin
679    --  This unchecked conversion can give warnings when alignments are
680    --  incorrect, but they will not be used in such cases anyway, so the
681    --  warnings can be safely ignored.
682
683    pragma Warnings (Off);
684    Local.Deallocate := To_Lib_Level_Deallocator (Deallocate'Access);
685    pragma Warnings (On);
686
687    declare
688       Two_To_J : Direct_Index_Vector;
689       Self_Id  : constant Task_Id := POP.Self;
690    begin
691       Defer_Abort (Self_Id);
692
693       --  Need protection for updating links to per-task initialization and
694       --  finalization routines, in case some task is being created or
695       --  terminated concurrently.
696
697       POP.Lock_RTS;
698
699       --  Add this instantiation to the list of all instantiations
700
701       Local.Next := System.Tasking.Task_Attributes.All_Attributes;
702       System.Tasking.Task_Attributes.All_Attributes :=
703         Local'Unchecked_Access;
704
705       --  Try to find space for the attribute in the TCB
706
707       Local.Index := 0;
708       Two_To_J := 1;
709
710       if Attribute'Size <= System.Address'Size then
711          for J in Direct_Index_Range loop
712             if (Two_To_J and In_Use) = 0 then
713
714                --  Reserve location J for this attribute
715
716                In_Use := In_Use or Two_To_J;
717                Local.Index := J;
718
719                --  This unchecked conversion can give a warning when the
720                --  alignment is incorrect, but it will not be used in such
721                --  a case anyway, so the warning can be safely ignored.
722
723                pragma Warnings (Off);
724                To_Attribute_Handle (Local.Initial_Value'Access).all :=
725                  Initial_Value;
726                pragma Warnings (On);
727
728                exit;
729             end if;
730
731             Two_To_J := Two_To_J * 2;
732          end loop;
733       end if;
734
735       --  Attribute goes directly in the TCB
736
737       if Local.Index /= 0 then
738          --  Replace stub for initialization routine that is called at task
739          --  creation.
740
741          Initialization.Initialize_Attributes_Link :=
742            System.Tasking.Task_Attributes.Initialize_Attributes'Access;
743
744          --  Initialize the attribute, for all tasks
745
746          declare
747             C : System.Tasking.Task_Id := System.Tasking.All_Tasks_List;
748          begin
749             while C /= null loop
750                C.Direct_Attributes (Local.Index) :=
751                  To_Direct_Attribute_Element
752                    (System.Storage_Elements.To_Address (Local.Initial_Value));
753                C := C.Common.All_Tasks_Link;
754             end loop;
755          end;
756
757       --  Attribute goes into a node onto a linked list
758
759       else
760          --  Replace stub for finalization routine called at task termination
761
762          Initialization.Finalize_Attributes_Link :=
763            System.Tasking.Task_Attributes.Finalize_Attributes'Access;
764       end if;
765
766       POP.Unlock_RTS;
767       Undefer_Abort (Self_Id);
768    end;
769 end Ada.Task_Attributes;