1 ------------------------------------------------------------------------------
3 -- GNAT COMPILER COMPONENTS --
9 -- Copyright (C) 1992-2011, Free Software Foundation, Inc. --
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. See the GNU General Public License --
17 -- for more details. You should have received a copy of the GNU General --
18 -- Public License distributed with GNAT; see file COPYING3. If not, go to --
19 -- http://www.gnu.org/licenses for a complete copy of the license. --
21 -- GNAT was originally developed by the GNAT team at New York University. --
22 -- Extensive contributions were provided by Ada Core Technologies Inc. --
24 ------------------------------------------------------------------------------
27 with Binde; use Binde;
28 with Casing; use Casing;
29 with Fname; use Fname;
30 with Gnatvsn; use Gnatvsn;
32 with Namet; use Namet;
34 with Osint; use Osint;
35 with Osint.B; use Osint.B;
36 with Output; use Output;
37 with Rident; use Rident;
38 with Table; use Table;
39 with Targparm; use Targparm;
40 with Types; use Types;
42 with System.OS_Lib; use System.OS_Lib;
43 with System.WCh_Con; use System.WCh_Con;
45 with GNAT.Heap_Sort_A; use GNAT.Heap_Sort_A;
47 package body Bindgen is
49 Statement_Buffer : String (1 .. 1000);
50 -- Buffer used for constructing output statements
53 -- Last location in Statement_Buffer currently set
55 With_DECGNAT : Boolean := False;
56 -- Flag which indicates whether the program uses the DECGNAT library
57 -- (presence of the unit DEC).
59 With_GNARL : Boolean := False;
60 -- Flag which indicates whether the program uses the GNARL library
61 -- (presence of the unit System.OS_Interface)
63 Num_Elab_Calls : Nat := 0;
64 -- Number of generated calls to elaboration routines
66 System_Restrictions_Used : Boolean;
67 -- Flag indicating whether the unit System.Restrictions is in the closure
68 -- of the partition. This is set by Check_System_Restrictions_Used, and
69 -- is used to determine whether or not to initialize the restrictions
70 -- information in the body of the binder generated file (we do not want
71 -- to do this unconditionally, since it drags in the System.Restrictions
72 -- unit unconditionally, which is unpleasand, especially for ZFP etc.)
74 Dispatching_Domains_Used : Boolean;
75 -- Flag indicating whether multiprocessor dispatching domains are used in
76 -- the closure of the partition. This is set by
77 -- Check_Dispatching_Domains_Used, and is used to call the routine to
78 -- disallow the creation of new dispatching domains just before calling
79 -- the main procedure from the environment task.
81 Lib_Final_Built : Boolean := False;
82 -- Flag indicating whether the finalize_library rountine has been built
84 CodePeer_Wrapper_Name : constant String := "call_main_subprogram";
85 -- For CodePeer, introduce a wrapper subprogram which calls the
86 -- user-defined main subprogram.
88 ----------------------------------
89 -- Interface_State Pragma Table --
90 ----------------------------------
92 -- This table assembles the interface state pragma information from
93 -- all the units in the partition. Note that Bcheck has already checked
94 -- that the information is consistent across units. The entries
95 -- in this table are n/u/r/s for not set/user/runtime/system.
97 package IS_Pragma_Settings is new Table.Table (
98 Table_Component_Type => Character,
99 Table_Index_Type => Int,
100 Table_Low_Bound => 0,
101 Table_Initial => 100,
102 Table_Increment => 200,
103 Table_Name => "IS_Pragma_Settings");
105 -- This table assembles the Priority_Specific_Dispatching pragma
106 -- information from all the units in the partition. Note that Bcheck has
107 -- already checked that the information is consistent across units.
108 -- The entries in this table are the upper case first character of the
109 -- policy name, e.g. 'F' for FIFO_Within_Priorities.
111 package PSD_Pragma_Settings is new Table.Table (
112 Table_Component_Type => Character,
113 Table_Index_Type => Int,
114 Table_Low_Bound => 0,
115 Table_Initial => 100,
116 Table_Increment => 200,
117 Table_Name => "PSD_Pragma_Settings");
119 ----------------------
120 -- Run-Time Globals --
121 ----------------------
123 -- This section documents the global variables that set from the
124 -- generated binder file.
126 -- Main_Priority : Integer;
127 -- Time_Slice_Value : Integer;
128 -- Heap_Size : Natural;
129 -- WC_Encoding : Character;
130 -- Locking_Policy : Character;
131 -- Queuing_Policy : Character;
132 -- Task_Dispatching_Policy : Character;
133 -- Priority_Specific_Dispatching : System.Address;
134 -- Num_Specific_Dispatching : Integer;
135 -- Restrictions : System.Address;
136 -- Interrupt_States : System.Address;
137 -- Num_Interrupt_States : Integer;
138 -- Unreserve_All_Interrupts : Integer;
139 -- Exception_Tracebacks : Integer;
140 -- Zero_Cost_Exceptions : Integer;
141 -- Detect_Blocking : Integer;
142 -- Default_Stack_Size : Integer;
143 -- Leap_Seconds_Support : Integer;
144 -- Main_CPU : Integer;
146 -- Main_Priority is the priority value set by pragma Priority in the main
147 -- program. If no such pragma is present, the value is -1.
149 -- Time_Slice_Value is the time slice value set by pragma Time_Slice in the
150 -- main program, or by the use of a -Tnnn parameter for the binder (if both
151 -- are present, the binder value overrides). The value is in milliseconds.
152 -- A value of zero indicates that time slicing should be suppressed. If no
153 -- pragma is present, and no -T switch was used, the value is -1.
155 -- Heap_Size is the heap to use for memory allocations set by use of a
156 -- -Hnn parameter for the binder or by the GNAT$NO_MALLOC_64 logical.
157 -- Valid values are 32 and 64. This switch is only effective on VMS.
159 -- WC_Encoding shows the wide character encoding method used for the main
160 -- program. This is one of the encoding letters defined in
161 -- System.WCh_Con.WC_Encoding_Letters.
163 -- Locking_Policy is a space if no locking policy was specified for the
164 -- partition. If a locking policy was specified, the value is the upper
165 -- case first character of the locking policy name, for example, 'C' for
168 -- Queuing_Policy is a space if no queuing policy was specified for the
169 -- partition. If a queuing policy was specified, the value is the upper
170 -- case first character of the queuing policy name for example, 'F' for
173 -- Task_Dispatching_Policy is a space if no task dispatching policy was
174 -- specified for the partition. If a task dispatching policy was specified,
175 -- the value is the upper case first character of the policy name, e.g. 'F'
176 -- for FIFO_Within_Priorities.
178 -- Priority_Specific_Dispatching is the address of a string used to store
179 -- the task dispatching policy specified for the different priorities in
180 -- the partition. The length of this string is determined by the last
181 -- priority for which such a pragma applies (the string will be a null
182 -- string if no specific dispatching policies were used). If pragma were
183 -- present, the entries apply to the priorities in sequence from the first
184 -- priority. The value stored is the upper case first character of the
185 -- policy name, or 'F' (for FIFO_Within_Priorities) as the default value
186 -- for those priority ranges not specified.
188 -- Num_Specific_Dispatching is length of the Priority_Specific_Dispatching
189 -- string. It will be set to zero if no Priority_Specific_Dispatching
190 -- pragmas are present.
192 -- Restrictions is the address of a null-terminated string specifying the
193 -- restrictions information for the partition. The format is identical to
194 -- that of the parameter string found on R lines in ali files (see Lib.Writ
195 -- spec in lib-writ.ads for full details). The difference is that in this
196 -- context the values are the cumulative ones for the entire partition.
198 -- Interrupt_States is the address of a string used to specify the
199 -- cumulative results of Interrupt_State pragmas used in the partition.
200 -- The length of this string is determined by the last interrupt for which
201 -- such a pragma is given (the string will be a null string if no pragmas
202 -- were used). If pragma were present the entries apply to the interrupts
203 -- in sequence from the first interrupt, and are set to one of four
204 -- possible settings: 'n' for not specified, 'u' for user, 'r' for run
205 -- time, 's' for system, see description of Interrupt_State pragma for
208 -- Num_Interrupt_States is the length of the Interrupt_States string. It
209 -- will be set to zero if no Interrupt_State pragmas are present.
211 -- Unreserve_All_Interrupts is set to one if at least one unit in the
212 -- partition had a pragma Unreserve_All_Interrupts, and zero otherwise.
214 -- Exception_Tracebacks is set to one if the -E parameter was present
215 -- in the bind and to zero otherwise. Note that on some targets exception
216 -- tracebacks are provided by default, so a value of zero for this
217 -- parameter does not necessarily mean no trace backs are available.
219 -- Zero_Cost_Exceptions is set to one if zero cost exceptions are used for
220 -- this partition, and to zero if longjmp/setjmp exceptions are used.
222 -- Detect_Blocking indicates whether pragma Detect_Blocking is active or
223 -- not. A value of zero indicates that the pragma is not present, while a
224 -- value of 1 signals its presence in the partition.
226 -- Default_Stack_Size is the default stack size used when creating an Ada
227 -- task with no explicit Storage_Size clause.
229 -- Leap_Seconds_Support denotes whether leap seconds have been enabled or
230 -- disabled. A value of zero indicates that leap seconds are turned "off",
231 -- while a value of one signifies "on" status.
233 -- Main_CPU is the processor set by pragma CPU in the main program. If no
234 -- such pragma is present, the value is -1.
236 procedure WBI (Info : String) renames Osint.B.Write_Binder_Info;
237 -- Convenient shorthand used throughout
239 -----------------------
240 -- Local Subprograms --
241 -----------------------
243 procedure Check_File_In_Partition
246 -- If the file indicated by File_Name is in the partition the Flag is set
247 -- to True, False otherwise.
249 procedure Check_System_Restrictions_Used;
250 -- Sets flag System_Restrictions_Used (Set to True if and only if the unit
251 -- System.Restrictions is present in the partition, otherwise False).
253 procedure Check_Dispatching_Domains_Used;
254 -- Sets flag Dispatching_Domains_Used to True when using the unit
255 -- System.Multiprocessors.Dispatching_Domains is present in the partition,
256 -- otherwise set to False.
258 procedure Gen_Adainit;
259 -- Generates the Adainit procedure
261 procedure Gen_Adafinal;
262 -- Generate the Adafinal procedure
264 procedure Gen_CodePeer_Wrapper;
265 -- For CodePeer, generate wrapper which calls user-defined main subprogram
267 procedure Gen_Elab_Calls;
268 -- Generate sequence of elaboration calls
270 procedure Gen_Elab_Externals;
271 -- Generate sequence of external declarations for elaboration
273 procedure Gen_Elab_Order;
274 -- Generate comments showing elaboration order chosen
276 procedure Gen_Finalize_Library;
277 -- Generate a sequence of finalization calls to elaborated packages
280 -- Generate procedure main
282 procedure Gen_Object_Files_Options;
283 -- Output comments containing a list of the full names of the object
284 -- files to be linked and the list of linker options supplied by
285 -- Linker_Options pragmas in the source.
287 procedure Gen_Output_File_Ada (Filename : String);
288 -- Generate Ada output file
290 procedure Gen_Restrictions;
291 -- Generate initialization of restrictions variable
293 procedure Gen_Versions;
294 -- Output series of definitions for unit versions
296 function Get_Ada_Main_Name return String;
297 -- This function is used for the Ada main output to compute a usable name
298 -- for the generated main program. The normal main program name is
299 -- Ada_Main, but this won't work if the user has a unit with this name.
300 -- This function tries Ada_Main first, and if there is such a clash, then
301 -- it tries Ada_Name_01, Ada_Name_02 ... Ada_Name_99 in sequence.
303 function Get_Main_Unit_Name (S : String) return String;
304 -- Return the main unit name corresponding to S by replacing '.' with '_'
306 function Get_Main_Name return String;
307 -- This function is used in the main output case to compute the correct
308 -- external main program. It is "main" by default, unless the flag
309 -- Use_Ada_Main_Program_Name_On_Target is set, in which case it is the name
310 -- of the Ada main name without the "_ada". This default can be overridden
311 -- explicitly using the -Mname binder switch.
313 function Get_WC_Encoding return Character;
314 -- Return wide character encoding method to set as WC_Encoding in output.
315 -- If -W has been used, returns the specified encoding, otherwise returns
316 -- the encoding method used for the main program source. If there is no
317 -- main program source (-z switch used), returns brackets ('b').
319 function Has_Finalizer return Boolean;
320 -- Determine whether the current unit has at least one library-level
323 function Lt_Linker_Option (Op1, Op2 : Natural) return Boolean;
324 -- Compare linker options, when sorting, first according to
325 -- Is_Internal_File (internal files come later) and then by
326 -- elaboration order position (latest to earliest).
328 procedure Move_Linker_Option (From : Natural; To : Natural);
329 -- Move routine for sorting linker options
331 procedure Resolve_Binder_Options;
332 -- Set the value of With_GNARL and With_DECGNAT. The latter only on VMS
333 -- since it tests for a package named "dec" which might cause a conflict
334 -- on non-VMS systems.
336 procedure Set_Char (C : Character);
337 -- Set given character in Statement_Buffer at the Last + 1 position
338 -- and increment Last by one to reflect the stored character.
340 procedure Set_Int (N : Int);
341 -- Set given value in decimal in Statement_Buffer with no spaces
342 -- starting at the Last + 1 position, and updating Last past the value.
343 -- A minus sign is output for a negative value.
345 procedure Set_Boolean (B : Boolean);
346 -- Set given boolean value in Statement_Buffer at the Last + 1 position
347 -- and update Last past the value.
349 procedure Set_IS_Pragma_Table;
350 -- Initializes contents of IS_Pragma_Settings table from ALI table
352 procedure Set_Main_Program_Name;
353 -- Given the main program name in Name_Buffer (length in Name_Len)
354 -- generate the name of the routine to be used in the call. The name
355 -- is generated starting at Last + 1, and Last is updated past it.
357 procedure Set_Name_Buffer;
358 -- Set the value stored in positions 1 .. Name_Len of the Name_Buffer
360 procedure Set_PSD_Pragma_Table;
361 -- Initializes contents of PSD_Pragma_Settings table from ALI table
363 procedure Set_String (S : String);
364 -- Sets characters of given string in Statement_Buffer, starting at the
365 -- Last + 1 position, and updating last past the string value.
367 procedure Set_String_Replace (S : String);
368 -- Replaces the last S'Length characters in the Statement_Buffer with
369 -- the characters of S. The caller must ensure that these characters do
370 -- in fact exist in the Statement_Buffer.
372 type Qualification_Mode is (Dollar_Sign, Dot, Double_Underscores);
374 procedure Set_Unit_Name (Mode : Qualification_Mode := Double_Underscores);
375 -- Given a unit name in the Name_Buffer, copy it into Statement_Buffer,
376 -- starting at the Last + 1 position and update Last past the value.
377 -- Depending on parameter Mode, a dot (.) can be qualified into double
378 -- underscores (__), a dollar sign ($) or left as is.
380 procedure Set_Unit_Number (U : Unit_Id);
381 -- Sets unit number (first unit is 1, leading zeroes output to line
382 -- up all output unit numbers nicely as required by the value, and
383 -- by the total number of units.
385 procedure Write_Statement_Buffer;
386 -- Write out contents of statement buffer up to Last, and reset Last to 0
388 procedure Write_Statement_Buffer (S : String);
389 -- First writes its argument (using Set_String (S)), then writes out the
390 -- contents of statement buffer up to Last, and reset Last to 0
392 ------------------------------------
393 -- Check_Dispatching_Domains_Used --
394 ------------------------------------
396 procedure Check_Dispatching_Domains_Used is
398 Check_File_In_Partition ("s-mudido.ads", Dispatching_Domains_Used);
399 end Check_Dispatching_Domains_Used;
401 -----------------------------
402 -- Check_File_In_Partition --
403 -----------------------------
405 procedure Check_File_In_Partition
410 for J in Units.First .. Units.Last loop
411 if Get_Name_String (Units.Table (J).Sfile) = File_Name then
418 end Check_File_In_Partition;
420 ------------------------------------
421 -- Check_System_Restrictions_Used --
422 ------------------------------------
424 procedure Check_System_Restrictions_Used is
426 Check_File_In_Partition ("s-restri.ads", System_Restrictions_Used);
427 end Check_System_Restrictions_Used;
433 procedure Gen_Adafinal is
435 WBI (" procedure " & Ada_Final_Name.all & " is");
438 and Bind_Main_Program
439 and not CodePeer_Mode
441 WBI (" procedure s_stalib_adafinal;");
442 Set_String (" pragma Import (C, s_stalib_adafinal, ");
443 Set_String ("""system__standard_library__adafinal"");");
444 Write_Statement_Buffer;
449 if not CodePeer_Mode then
450 WBI (" if not Is_Elaborated then");
453 WBI (" Is_Elaborated := False;");
456 -- On non-virtual machine targets, finalization is done differently
457 -- depending on whether this is the main program or a library.
459 if VM_Target = No_VM and then not CodePeer_Mode then
460 if Bind_Main_Program then
461 WBI (" s_stalib_adafinal;");
462 elsif Lib_Final_Built then
463 WBI (" finalize_library;");
468 -- Pragma Import C cannot be used on virtual machine targets, therefore
469 -- call the runtime finalization routine directly. Similarly in CodePeer
470 -- mode, where imported functions are ignored.
473 WBI (" System.Standard_Library.Adafinal;");
476 WBI (" end " & Ada_Final_Name.all & ";");
484 procedure Gen_Adainit is
485 Main_Priority : Int renames ALIs.Table (ALIs.First).Main_Priority;
486 Main_CPU : Int renames ALIs.Table (ALIs.First).Main_CPU;
489 -- Declare the access-to-subprogram type used for initialization of
490 -- of __gnat_finalize_library_objects. This is declared at library
491 -- level for compatibility with the type used in System.Soft_Links.
492 -- The import of the soft link which performs library-level object
493 -- finalization is not needed for VM targets; regular Ada is used in
494 -- that case. For restricted run-time libraries (ZFP and Ravenscar)
495 -- tasks are non-terminating, so we do not want finalization.
497 if not Suppress_Standard_Library_On_Target
498 and then VM_Target = No_VM
499 and then not CodePeer_Mode
500 and then not Configurable_Run_Time_On_Target
502 WBI (" type No_Param_Proc is access procedure;");
506 WBI (" procedure " & Ada_Init_Name.all & " is");
508 -- In CodePeer mode, simplify adainit procedure by only calling
509 -- elaboration procedures.
511 if CodePeer_Mode then
514 -- If the standard library is suppressed, then the only global variables
515 -- that might be needed (by the Ravenscar profile) are the priority and
516 -- the processor for the environment task.
518 elsif Suppress_Standard_Library_On_Target then
519 if Main_Priority /= No_Main_Priority then
520 WBI (" Main_Priority : Integer;");
521 WBI (" pragma Import (C, Main_Priority," &
522 " ""__gl_main_priority"");");
526 if Main_CPU /= No_Main_CPU then
527 WBI (" Main_CPU : Integer;");
528 WBI (" pragma Import (C, Main_CPU," &
529 " ""__gl_main_cpu"");");
535 if Main_Priority /= No_Main_Priority then
536 Set_String (" Main_Priority := ");
537 Set_Int (Main_Priority);
539 Write_Statement_Buffer;
542 if Main_CPU /= No_Main_CPU then
543 Set_String (" Main_CPU := ");
546 Write_Statement_Buffer;
549 if Main_Priority = No_Main_Priority
550 and then Main_CPU = No_Main_CPU
555 -- Normal case (standard library not suppressed). Set all global values
556 -- used by the run time.
559 WBI (" Main_Priority : Integer;");
560 WBI (" pragma Import (C, Main_Priority, " &
561 """__gl_main_priority"");");
562 WBI (" Time_Slice_Value : Integer;");
563 WBI (" pragma Import (C, Time_Slice_Value, " &
564 """__gl_time_slice_val"");");
565 WBI (" WC_Encoding : Character;");
566 WBI (" pragma Import (C, WC_Encoding, ""__gl_wc_encoding"");");
567 WBI (" Locking_Policy : Character;");
568 WBI (" pragma Import (C, Locking_Policy, " &
569 """__gl_locking_policy"");");
570 WBI (" Queuing_Policy : Character;");
571 WBI (" pragma Import (C, Queuing_Policy, " &
572 """__gl_queuing_policy"");");
573 WBI (" Task_Dispatching_Policy : Character;");
574 WBI (" pragma Import (C, Task_Dispatching_Policy, " &
575 """__gl_task_dispatching_policy"");");
576 WBI (" Priority_Specific_Dispatching : System.Address;");
577 WBI (" pragma Import (C, Priority_Specific_Dispatching, " &
578 """__gl_priority_specific_dispatching"");");
579 WBI (" Num_Specific_Dispatching : Integer;");
580 WBI (" pragma Import (C, Num_Specific_Dispatching, " &
581 """__gl_num_specific_dispatching"");");
582 WBI (" Main_CPU : Integer;");
583 WBI (" pragma Import (C, Main_CPU, " &
584 """__gl_main_cpu"");");
586 WBI (" Interrupt_States : System.Address;");
587 WBI (" pragma Import (C, Interrupt_States, " &
588 """__gl_interrupt_states"");");
589 WBI (" Num_Interrupt_States : Integer;");
590 WBI (" pragma Import (C, Num_Interrupt_States, " &
591 """__gl_num_interrupt_states"");");
592 WBI (" Unreserve_All_Interrupts : Integer;");
593 WBI (" pragma Import (C, Unreserve_All_Interrupts, " &
594 """__gl_unreserve_all_interrupts"");");
596 if Exception_Tracebacks then
597 WBI (" Exception_Tracebacks : Integer;");
598 WBI (" pragma Import (C, Exception_Tracebacks, " &
599 """__gl_exception_tracebacks"");");
602 WBI (" Zero_Cost_Exceptions : Integer;");
603 WBI (" pragma Import (C, Zero_Cost_Exceptions, " &
604 """__gl_zero_cost_exceptions"");");
605 WBI (" Detect_Blocking : Integer;");
606 WBI (" pragma Import (C, Detect_Blocking, " &
607 """__gl_detect_blocking"");");
608 WBI (" Default_Stack_Size : Integer;");
609 WBI (" pragma Import (C, Default_Stack_Size, " &
610 """__gl_default_stack_size"");");
611 WBI (" Leap_Seconds_Support : Integer;");
612 WBI (" pragma Import (C, Leap_Seconds_Support, " &
613 """__gl_leap_seconds_support"");");
615 -- Import entry point for elaboration time signal handler
616 -- installation, and indication of if it's been called previously.
619 WBI (" procedure Install_Handler;");
620 WBI (" pragma Import (C, Install_Handler, " &
621 """__gnat_install_handler"");");
623 WBI (" Handler_Installed : Integer;");
624 WBI (" pragma Import (C, Handler_Installed, " &
625 """__gnat_handler_installed"");");
627 -- The import of the soft link which performs library-level object
628 -- finalization is not needed for VM targets; regular Ada is used in
629 -- that case. For restricted run-time libraries (ZFP and Ravenscar)
630 -- tasks are non-terminating, so we do not want finalization.
632 if VM_Target = No_VM and then not Configurable_Run_Time_On_Target then
634 WBI (" Finalize_Library_Objects : No_Param_Proc;");
635 WBI (" pragma Import (C, Finalize_Library_Objects, " &
636 """__gnat_finalize_library_objects"");");
639 -- Import entry point for environment feature enable/disable
640 -- routine, and indication that it's been called previously.
642 if OpenVMS_On_Target then
644 WBI (" procedure Set_Features;");
645 WBI (" pragma Import (C, Set_Features, " &
646 """__gnat_set_features"");");
648 WBI (" Features_Set : Integer;");
649 WBI (" pragma Import (C, Features_Set, " &
650 """__gnat_features_set"");");
652 if Opt.Heap_Size /= 0 then
654 WBI (" Heap_Size : Integer;");
655 WBI (" pragma Import (C, Heap_Size, " &
656 """__gl_heap_size"");");
658 Write_Statement_Buffer;
662 -- Initialize stack limit variable of the environment task if the
663 -- stack check method is stack limit and stack check is enabled.
665 if Stack_Check_Limits_On_Target
666 and then (Stack_Check_Default_On_Target or Stack_Check_Switch_Set)
669 WBI (" procedure Initialize_Stack_Limit;");
670 WBI (" pragma Import (C, Initialize_Stack_Limit, " &
671 """__gnat_initialize_stack_limit"");");
674 -- Special processing when main program is CIL function/procedure
676 if VM_Target = CLI_Target
677 and then Bind_Main_Program
678 and then not No_Main_Subprogram
682 -- Function case, use Set_Exit_Status to report the returned
683 -- status code, since that is the only mechanism available.
685 if ALIs.Table (ALIs.First).Main_Program = Func then
686 WBI (" Result : Integer;");
687 WBI (" procedure Set_Exit_Status (Code : Integer);");
688 WBI (" pragma Import (C, Set_Exit_Status, " &
689 """__gnat_set_exit_status"");");
691 WBI (" function Ada_Main_Program return Integer;");
696 WBI (" procedure Ada_Main_Program;");
699 Get_Name_String (Units.Table (First_Unit_Entry).Uname);
700 Name_Len := Name_Len - 2;
701 WBI (" pragma Import (CIL, Ada_Main_Program, """
702 & Name_Buffer (1 .. Name_Len) & "."
703 & Get_Main_Unit_Name (Name_Buffer (1 .. Name_Len)) & """);");
706 -- When dispatching domains are used then we need to signal it
707 -- before calling the main procedure.
709 if Dispatching_Domains_Used then
710 WBI (" procedure Freeze_Dispatching_Domains;");
711 WBI (" pragma Import");
712 WBI (" (Ada, Freeze_Dispatching_Domains, " &
713 """__gnat_freeze_dispatching_domains"");");
717 WBI (" if Is_Elaborated then");
720 WBI (" Is_Elaborated := True;");
722 Set_String (" Main_Priority := ");
723 Set_Int (Main_Priority);
725 Write_Statement_Buffer;
727 Set_String (" Time_Slice_Value := ");
729 if Task_Dispatching_Policy_Specified = 'F'
730 and then ALIs.Table (ALIs.First).Time_Slice_Value = -1
734 Set_Int (ALIs.Table (ALIs.First).Time_Slice_Value);
738 Write_Statement_Buffer;
740 Set_String (" WC_Encoding := '");
741 Set_Char (Get_WC_Encoding);
744 Write_Statement_Buffer;
746 Set_String (" Locking_Policy := '");
747 Set_Char (Locking_Policy_Specified);
749 Write_Statement_Buffer;
751 Set_String (" Queuing_Policy := '");
752 Set_Char (Queuing_Policy_Specified);
754 Write_Statement_Buffer;
756 Set_String (" Task_Dispatching_Policy := '");
757 Set_Char (Task_Dispatching_Policy_Specified);
759 Write_Statement_Buffer;
763 WBI (" Priority_Specific_Dispatching :=");
764 WBI (" Local_Priority_Specific_Dispatching'Address;");
766 Set_String (" Num_Specific_Dispatching := ");
767 Set_Int (PSD_Pragma_Settings.Last + 1);
769 Write_Statement_Buffer;
771 Set_String (" Main_CPU := ");
774 Write_Statement_Buffer;
776 WBI (" Interrupt_States := Local_Interrupt_States'Address;");
778 Set_String (" Num_Interrupt_States := ");
779 Set_Int (IS_Pragma_Settings.Last + 1);
781 Write_Statement_Buffer;
783 Set_String (" Unreserve_All_Interrupts := ");
785 if Unreserve_All_Interrupts_Specified then
792 Write_Statement_Buffer;
794 if Exception_Tracebacks then
795 WBI (" Exception_Tracebacks := 1;");
798 Set_String (" Zero_Cost_Exceptions := ");
800 if Zero_Cost_Exceptions_Specified then
807 Write_Statement_Buffer;
809 Set_String (" Detect_Blocking := ");
811 if Detect_Blocking then
818 Write_Statement_Buffer;
820 Set_String (" Default_Stack_Size := ");
821 Set_Int (Default_Stack_Size);
823 Write_Statement_Buffer;
825 Set_String (" Leap_Seconds_Support := ");
827 if Leap_Seconds_Support then
834 Write_Statement_Buffer;
836 -- Generate call to Install_Handler
838 -- In .NET, when binding with -z, we don't install the signal handler
839 -- to let the caller handle the last exception handler.
841 if VM_Target /= CLI_Target
842 or else Bind_Main_Program
845 WBI (" if Handler_Installed = 0 then");
846 WBI (" Install_Handler;");
850 -- Generate call to Set_Features
852 if OpenVMS_On_Target then
854 WBI (" if Features_Set = 0 then");
855 WBI (" Set_Features;");
858 -- Features_Set may twiddle the heap size according to a logical
859 -- name, but the binder switch must override.
861 if Opt.Heap_Size /= 0 then
862 Set_String (" Heap_Size := ");
863 Set_Int (Opt.Heap_Size);
865 Write_Statement_Buffer;
870 -- Generate call to set Initialize_Scalar values if active
872 if Initialize_Scalars_Used then
874 Set_String (" System.Scalar_Values.Initialize ('");
875 Set_Char (Initialize_Scalars_Mode1);
877 Set_Char (Initialize_Scalars_Mode2);
879 Write_Statement_Buffer;
882 -- Generate assignment of default secondary stack size if set
884 if Sec_Stack_Used and then Default_Sec_Stack_Size /= -1 then
886 Set_String (" System.Secondary_Stack.");
887 Set_String ("Default_Secondary_Stack_Size := ");
888 Set_Int (Opt.Default_Sec_Stack_Size);
890 Write_Statement_Buffer;
893 -- Initialize stack limit variable of the environment task if the
894 -- stack check method is stack limit and stack check is enabled.
896 if Stack_Check_Limits_On_Target
897 and then (Stack_Check_Default_On_Target or Stack_Check_Switch_Set)
900 WBI (" Initialize_Stack_Limit;");
903 -- On CodePeer, the finalization of library objects is not relevant
905 if CodePeer_Mode then
908 -- On virtual machine targets, or on non-virtual machine ones if this
909 -- is the main program case, attach finalize_library to the soft link.
910 -- Do it only when not using a restricted run time, in which case tasks
911 -- are non-terminating, so we do not want library-level finalization.
913 elsif (VM_Target /= No_VM or else Bind_Main_Program)
914 and then not Configurable_Run_Time_On_Target
915 and then not Suppress_Standard_Library_On_Target
919 if VM_Target = No_VM then
920 if Lib_Final_Built then
921 Set_String (" Finalize_Library_Objects := ");
922 Set_String ("finalize_library'access;");
924 Set_String (" Finalize_Library_Objects := null;");
927 -- On VM targets use regular Ada to set the soft link
930 if Lib_Final_Built then
932 (" System.Soft_Links.Finalize_Library_Objects");
933 Set_String (" := finalize_library'access;");
936 (" System.Soft_Links.Finalize_Library_Objects");
937 Set_String (" := null;");
941 Write_Statement_Buffer;
944 -- Generate elaboration calls
946 if not CodePeer_Mode then
952 -- From this point, no new dispatching domain can be created.
954 if Dispatching_Domains_Used then
955 WBI (" Freeze_Dispatching_Domains;");
958 -- Case of main program is CIL function or procedure
960 if VM_Target = CLI_Target
961 and then Bind_Main_Program
962 and then not No_Main_Subprogram
964 -- For function case, use Set_Exit_Status to set result
966 if ALIs.Table (ALIs.First).Main_Program = Func then
967 WBI (" Result := Ada_Main_Program;");
968 WBI (" Set_Exit_Status (Result);");
973 WBI (" Ada_Main_Program;");
977 WBI (" end " & Ada_Init_Name.all & ";");
981 --------------------------
982 -- Gen_CodePeer_Wrapper --
983 --------------------------
985 procedure Gen_CodePeer_Wrapper is
986 Callee_Name : constant String := "Ada_Main_Program";
989 if ALIs.Table (ALIs.First).Main_Program = Proc then
990 WBI (" procedure " & CodePeer_Wrapper_Name & " is ");
992 WBI (" " & Callee_Name & ";");
995 WBI (" function " & CodePeer_Wrapper_Name & " return Integer is");
997 WBI (" return " & Callee_Name & ";");
1000 WBI (" end " & CodePeer_Wrapper_Name & ";");
1002 end Gen_CodePeer_Wrapper;
1004 --------------------
1005 -- Gen_Elab_Calls --
1006 --------------------
1008 procedure Gen_Elab_Calls is
1009 Check_Elab_Flag : Boolean;
1012 for E in Elab_Order.First .. Elab_Order.Last loop
1014 Unum : constant Unit_Id := Elab_Order.Table (E);
1015 U : Unit_Record renames Units.Table (Unum);
1017 Unum_Spec : Unit_Id;
1018 -- This is the unit number of the spec that corresponds to
1019 -- this entry. It is the same as Unum except when the body
1020 -- and spec are different and we are currently processing
1021 -- the body, in which case it is the spec (Unum + 1).
1024 if U.Utype = Is_Body then
1025 Unum_Spec := Unum + 1;
1030 -- Nothing to do if predefined unit in no run time mode
1032 if No_Run_Time_Mode and then Is_Predefined_File_Name (U.Sfile) then
1035 -- Likewise if this is an interface to a stand alone library
1037 elsif U.SAL_Interface then
1040 -- Case of no elaboration code
1042 -- In CodePeer mode, we special case subprogram bodies which
1043 -- are handled in the 'else' part below, and lead to a call to
1044 -- <subp>'Elab_Subp_Body.
1047 and then (not CodePeer_Mode
1048 or else U.Utype = Is_Spec
1049 or else U.Utype = Is_Spec_Only
1050 or else U.Unit_Kind /= 's')
1053 -- In the case of a body with a separate spec, where the
1054 -- separate spec has an elaboration entity defined, this is
1055 -- where we increment the elaboration entity.
1057 if U.Utype = Is_Body
1058 and then Units.Table (Unum_Spec).Set_Elab_Entity
1059 and then not CodePeer_Mode
1062 Set_Unit_Number (Unum_Spec);
1064 -- The AAMP target has no notion of shared libraries, and
1065 -- there's no possibility of reelaboration, so we treat the
1066 -- the elaboration var as a flag instead of a counter and
1069 if AAMP_On_Target then
1070 Set_String (" := 1;");
1072 -- Otherwise (normal case), increment elaboration counter
1075 Set_String (" := E");
1076 Set_Unit_Number (Unum_Spec);
1077 Set_String (" + 1;");
1080 Write_Statement_Buffer;
1082 -- In the special case where the target is AAMP and the unit is
1083 -- a spec with a body, the elaboration entity is initialized
1084 -- here. This is done because it's the only way to accomplish
1085 -- initialization of such entities, as there is no mechanism
1086 -- provided for initializing global variables at load time on
1089 elsif AAMP_On_Target
1090 and then U.Utype = Is_Spec
1091 and then Units.Table (Unum_Spec).Set_Elab_Entity
1094 Set_Unit_Number (Unum_Spec);
1095 Set_String (" := 0;");
1096 Write_Statement_Buffer;
1099 -- Here if elaboration code is present. If binding a library
1100 -- or if there is a non-Ada main subprogram then we generate:
1102 -- if uname_E = 0 then
1103 -- uname'elab_[spec|body];
1105 -- uname_E := uname_E + 1;
1107 -- Otherwise, elaboration routines are called unconditionally:
1109 -- uname'elab_[spec|body];
1110 -- uname_E := uname_E + 1;
1112 -- The uname_E increment is skipped if this is a separate spec,
1113 -- since it will be done when we process the body.
1115 -- In CodePeer mode, we do not generate any reference to xxx_E
1116 -- variables, only calls to 'Elab* subprograms.
1119 -- In the special case where the target is AAMP and the unit is
1120 -- a spec with a body, the elaboration entity is initialized
1121 -- here. This is done because it's the only way to accomplish
1122 -- initialization of such entities, as there is no mechanism
1123 -- provided for initializing global variables at load time on
1127 and then U.Utype = Is_Spec
1128 and then Units.Table (Unum_Spec).Set_Elab_Entity
1131 Set_Unit_Number (Unum_Spec);
1132 Set_String (" := 0;");
1133 Write_Statement_Buffer;
1138 and then (Force_Checking_Of_Elaboration_Flags
1139 or Interface_Library_Unit
1140 or not Bind_Main_Program);
1142 if Check_Elab_Flag then
1143 Set_String (" if E");
1144 Set_Unit_Number (Unum_Spec);
1145 Set_String (" = 0 then");
1146 Write_Statement_Buffer;
1151 Get_Decoded_Name_String_With_Brackets (U.Uname);
1153 if VM_Target = CLI_Target and then U.Unit_Kind /= 's' then
1154 if Name_Buffer (Name_Len) = 's' then
1155 Name_Buffer (Name_Len - 1 .. Name_Len + 12) :=
1158 Name_Buffer (Name_Len - 1 .. Name_Len + 12) :=
1162 Name_Len := Name_Len + 12;
1165 if Name_Buffer (Name_Len) = 's' then
1166 Name_Buffer (Name_Len - 1 .. Name_Len + 8) :=
1168 Name_Len := Name_Len + 8;
1170 -- Special case in CodePeer mode for subprogram bodies
1171 -- which correspond to CodePeer 'Elab_Subp_Body special
1174 elsif U.Unit_Kind = 's' and CodePeer_Mode then
1175 Name_Buffer (Name_Len - 1 .. Name_Len + 13) :=
1177 Name_Len := Name_Len + 13;
1180 Name_Buffer (Name_Len - 1 .. Name_Len + 8) :=
1182 Name_Len := Name_Len + 8;
1186 Set_Casing (U.Icasing);
1189 Write_Statement_Buffer;
1191 if Check_Elab_Flag then
1195 if U.Utype /= Is_Spec
1196 and then not CodePeer_Mode
1199 Set_Unit_Number (Unum_Spec);
1201 -- The AAMP target has no notion of shared libraries, and
1202 -- there's no possibility of reelaboration, so we treat the
1203 -- the elaboration var as a flag instead of a counter and
1206 if AAMP_On_Target then
1207 Set_String (" := 1;");
1209 -- Otherwise (normal case), increment elaboration counter
1212 Set_String (" := E");
1213 Set_Unit_Number (Unum_Spec);
1214 Set_String (" + 1;");
1217 Write_Statement_Buffer;
1224 ------------------------
1225 -- Gen_Elab_Externals --
1226 ------------------------
1228 procedure Gen_Elab_Externals is
1230 if CodePeer_Mode then
1234 for E in Elab_Order.First .. Elab_Order.Last loop
1236 Unum : constant Unit_Id := Elab_Order.Table (E);
1237 U : Unit_Record renames Units.Table (Unum);
1240 -- Check for Elab_Entity to be set for this unit
1242 if U.Set_Elab_Entity
1244 -- Don't generate reference for stand alone library
1246 and then not U.SAL_Interface
1248 -- Don't generate reference for predefined file in No_Run_Time
1249 -- mode, since we don't include the object files in this case
1253 and then Is_Predefined_File_Name (U.Sfile))
1257 Set_Unit_Number (Unum);
1260 when No_VM | JVM_Target =>
1261 Set_String (" : Short_Integer; pragma Import (Ada, ");
1263 Set_String (" : Short_Integer; pragma Import (CIL, ");
1267 Set_Unit_Number (Unum);
1268 Set_String (", """);
1269 Get_Name_String (U.Uname);
1271 -- In the case of JGNAT we need to emit an Import name that
1272 -- includes the class name (using '$' separators in the case
1273 -- of a child unit name).
1275 if VM_Target /= No_VM then
1276 for J in 1 .. Name_Len - 2 loop
1277 if VM_Target = CLI_Target
1278 or else Name_Buffer (J) /= '.'
1280 Set_Char (Name_Buffer (J));
1286 if VM_Target /= CLI_Target or else U.Unit_Kind = 's' then
1289 Set_String ("_pkg.");
1292 -- If the unit name is very long, then split the
1293 -- Import link name across lines using "&" (occurs
1294 -- in some C2 tests).
1296 if 2 * Name_Len + 60 > Hostparm.Max_Line_Length then
1297 Set_String (""" &");
1298 Write_Statement_Buffer;
1304 Set_String ("_E"");");
1305 Write_Statement_Buffer;
1311 end Gen_Elab_Externals;
1313 --------------------
1314 -- Gen_Elab_Order --
1315 --------------------
1317 procedure Gen_Elab_Order is
1319 WBI (" -- BEGIN ELABORATION ORDER");
1321 for J in Elab_Order.First .. Elab_Order.Last loop
1322 Set_String (" -- ");
1323 Get_Name_String (Units.Table (Elab_Order.Table (J)).Uname);
1325 Write_Statement_Buffer;
1328 WBI (" -- END ELABORATION ORDER");
1332 --------------------------
1333 -- Gen_Finalize_Library --
1334 --------------------------
1336 procedure Gen_Finalize_Library is
1339 Uspec : Unit_Record;
1342 procedure Gen_Header;
1343 -- Generate the header of the finalization routine
1349 procedure Gen_Header is
1351 WBI (" procedure finalize_library is");
1353 -- The following flag is used to check for library-level exceptions
1354 -- raised during finalization. Symbol comes from System.Soft_Links.
1355 -- VM targets use regular Ada to reference the entity.
1357 if VM_Target = No_VM then
1358 WBI (" LE_Set : Boolean;");
1360 Set_String (" pragma Import (Ada, LE_Set, ");
1361 Set_String ("""__gnat_library_exception_set"");");
1362 Write_Statement_Buffer;
1368 -- Start of processing for Gen_Finalize_Library
1371 if CodePeer_Mode then
1375 for E in reverse Elab_Order.First .. Elab_Order.Last loop
1376 Unum := Elab_Order.Table (E);
1377 U := Units.Table (Unum);
1379 -- Dealing with package bodies is a little complicated. In such
1380 -- cases we must retrieve the package spec since it contains the
1381 -- spec of the body finalizer.
1383 if U.Utype = Is_Body then
1385 Uspec := Units.Table (Unum);
1390 Get_Name_String (Uspec.Uname);
1392 -- We are only interested in non-generic packages
1394 if U.Unit_Kind /= 'p' or else U.Is_Generic then
1397 -- That aren't an interface to a stand alone library
1399 elsif U.SAL_Interface then
1402 -- Case of no finalization
1404 elsif not U.Has_Finalizer then
1406 -- The only case in which we have to do something is if this
1407 -- is a body, with a separate spec, where the separate spec
1408 -- has a finalizer. In that case, this is where we decrement
1409 -- the elaboration entity.
1411 if U.Utype = Is_Body and then Uspec.Has_Finalizer then
1412 if not Lib_Final_Built then
1414 Lib_Final_Built := True;
1418 Set_Unit_Number (Unum);
1419 Set_String (" := E");
1420 Set_Unit_Number (Unum);
1421 Set_String (" - 1;");
1422 Write_Statement_Buffer;
1426 if not Lib_Final_Built then
1428 Lib_Final_Built := True;
1433 -- procedure F<Count>;
1435 Set_String (" declare");
1436 Write_Statement_Buffer;
1438 Set_String (" procedure F");
1441 Write_Statement_Buffer;
1444 -- pragma Import (CIL, F<Count>,
1445 -- "xx.yy_pkg.xx__yy__finalize_[body|spec]");
1446 -- -- for .NET targets
1448 -- pragma Import (Java, F<Count>,
1449 -- "xx$yy.xx__yy__finalize_[body|spec]");
1450 -- -- for JVM targets
1452 -- pragma Import (Ada, F<Count>,
1453 -- "xx__yy__finalize_[body|spec]");
1454 -- -- for default targets
1456 if VM_Target = CLI_Target then
1457 Set_String (" pragma Import (CIL, F");
1458 elsif VM_Target = JVM_Target then
1459 Set_String (" pragma Import (Java, F");
1461 Set_String (" pragma Import (Ada, F");
1465 Set_String (", """);
1467 -- Perform name construction
1469 -- .NET xx.yy_pkg.xx__yy__finalize
1471 if VM_Target = CLI_Target then
1472 Set_Unit_Name (Mode => Dot);
1473 Set_String ("_pkg.");
1475 -- JVM xx$yy.xx__yy__finalize
1477 elsif VM_Target = JVM_Target then
1478 Set_Unit_Name (Mode => Dollar_Sign);
1482 -- Default xx__yy__finalize
1485 Set_String ("__finalize_");
1487 -- Package spec processing
1489 if U.Utype = Is_Spec
1490 or else U.Utype = Is_Spec_Only
1492 Set_String ("spec");
1494 -- Package body processing
1497 Set_String ("body");
1500 Set_String (""");");
1501 Write_Statement_Buffer;
1503 -- If binding a library or if there is a non-Ada main subprogram
1504 -- then we generate:
1507 -- uname_E := uname_E - 1;
1508 -- if uname_E = 0 then
1513 -- Otherwise, finalization routines are called unconditionally:
1516 -- uname_E := uname_E - 1;
1520 -- The uname_E decrement is skipped if this is a separate spec,
1521 -- since it will be done when we process the body.
1525 if U.Utype /= Is_Spec then
1527 Set_Unit_Number (Unum);
1528 Set_String (" := E");
1529 Set_Unit_Number (Unum);
1530 Set_String (" - 1;");
1531 Write_Statement_Buffer;
1534 if Interface_Library_Unit or not Bind_Main_Program then
1535 Set_String (" if E");
1536 Set_Unit_Number (Unum);
1537 Set_String (" = 0 then");
1538 Write_Statement_Buffer;
1545 Write_Statement_Buffer;
1547 if Interface_Library_Unit or not Bind_Main_Program then
1557 if Lib_Final_Built then
1559 -- It is possible that the finalization of a library-level object
1560 -- raised an exception. In that case import the actual exception
1561 -- and the routine necessary to raise it.
1563 if VM_Target = No_VM then
1564 WBI (" if LE_Set then");
1566 WBI (" LE : Ada.Exceptions.Exception_Occurrence;");
1568 Set_String (" pragma Import (Ada, LE, ");
1569 Set_String ("""__gnat_library_exception"");");
1570 Write_Statement_Buffer;
1572 Set_String (" procedure Raise_From_Controlled_");
1573 Set_String ("Operation (X : Ada.Exceptions.Exception_");
1574 Set_String ("Occurrence);");
1575 Write_Statement_Buffer;
1577 Set_String (" pragma Import (Ada, Raise_From_");
1578 Set_String ("Controlled_Operation, ");
1579 Set_String ("""__gnat_raise_from_controlled_operation"");");
1580 Write_Statement_Buffer;
1583 WBI (" Raise_From_Controlled_Operation (LE);");
1586 -- VM-specific code, use regular Ada to produce the desired behavior
1589 WBI (" if System.Soft_Links.Library_Exception_Set then");
1591 Set_String (" Ada.Exceptions.Reraise_Occurrence (");
1592 Set_String ("System.Soft_Links.Library_Exception);");
1593 Write_Statement_Buffer;
1597 WBI (" end finalize_library;");
1600 end Gen_Finalize_Library;
1606 procedure Gen_Main is
1608 if not No_Main_Subprogram then
1610 -- To call the main program, we declare it using a pragma Import
1611 -- Ada with the right link name.
1613 -- It might seem more obvious to "with" the main program, and call
1614 -- it in the normal Ada manner. We do not do this for three
1617 -- 1. It is more efficient not to recompile the main program
1618 -- 2. We are not entitled to assume the source is accessible
1619 -- 3. We don't know what options to use to compile it
1621 -- It is really reason 3 that is most critical (indeed we used
1622 -- to generate the "with", but several regression tests failed).
1624 if ALIs.Table (ALIs.First).Main_Program = Func then
1625 WBI (" function Ada_Main_Program return Integer;");
1627 WBI (" procedure Ada_Main_Program;");
1630 Set_String (" pragma Import (Ada, Ada_Main_Program, """);
1631 Get_Name_String (Units.Table (First_Unit_Entry).Uname);
1632 Set_Main_Program_Name;
1633 Set_String (""");");
1635 Write_Statement_Buffer;
1638 -- For CodePeer, declare a wrapper for the user-defined main program
1640 if CodePeer_Mode then
1641 Gen_CodePeer_Wrapper;
1645 if Exit_Status_Supported_On_Target then
1646 Set_String (" function ");
1648 Set_String (" procedure ");
1651 Set_String (Get_Main_Name);
1653 if Command_Line_Args_On_Target then
1654 Write_Statement_Buffer;
1655 WBI (" (argc : Integer;");
1656 WBI (" argv : System.Address;");
1657 WBI (" envp : System.Address)");
1659 if Exit_Status_Supported_On_Target then
1660 WBI (" return Integer");
1666 if Exit_Status_Supported_On_Target then
1667 Set_String (" return Integer is");
1672 Write_Statement_Buffer;
1675 if Opt.Default_Exit_Status /= 0
1676 and then Bind_Main_Program
1677 and then not Configurable_Run_Time_Mode
1679 WBI (" procedure Set_Exit_Status (Status : Integer);");
1680 WBI (" pragma Import (C, Set_Exit_Status, " &
1681 """__gnat_set_exit_status"");");
1685 -- Initialize and Finalize
1687 if not CodePeer_Mode
1688 and then not Cumulative_Restrictions.Set (No_Finalization)
1690 WBI (" procedure Initialize (Addr : System.Address);");
1691 WBI (" pragma Import (C, Initialize, ""__gnat_initialize"");");
1693 WBI (" procedure Finalize;");
1694 WBI (" pragma Import (C, Finalize, ""__gnat_finalize"");");
1697 -- If we want to analyze the stack, we must import corresponding symbols
1699 if Dynamic_Stack_Measurement then
1701 WBI (" procedure Output_Results;");
1702 WBI (" pragma Import (C, Output_Results, " &
1703 """__gnat_stack_usage_output_results"");");
1707 "procedure Initialize_Stack_Analysis (Buffer_Size : Natural);");
1708 WBI (" pragma Import (C, Initialize_Stack_Analysis, " &
1709 """__gnat_stack_usage_initialize"");");
1712 -- Deal with declarations for main program case
1714 if not No_Main_Subprogram then
1715 if ALIs.Table (ALIs.First).Main_Program = Func then
1716 WBI (" Result : Integer;");
1720 if Bind_Main_Program
1721 and not Suppress_Standard_Library_On_Target
1722 and not CodePeer_Mode
1724 WBI (" SEH : aliased array (1 .. 2) of Integer;");
1729 -- Generate a reference to Ada_Main_Program_Name. This symbol is
1730 -- not referenced elsewhere in the generated program, but is needed
1731 -- by the debugger (that's why it is generated in the first place).
1732 -- The reference stops Ada_Main_Program_Name from being optimized
1733 -- away by smart linkers, such as the AiX linker.
1735 -- Because this variable is unused, we make this variable "aliased"
1736 -- with a pragma Volatile in order to tell the compiler to preserve
1737 -- this variable at any level of optimization.
1739 if Bind_Main_Program and not CodePeer_Mode then
1740 WBI (" Ensure_Reference : aliased System.Address := " &
1741 "Ada_Main_Program_Name'Address;");
1742 WBI (" pragma Volatile (Ensure_Reference);");
1748 -- Acquire command line arguments if present on target
1750 if CodePeer_Mode then
1753 elsif Command_Line_Args_On_Target then
1754 WBI (" gnat_argc := argc;");
1755 WBI (" gnat_argv := argv;");
1756 WBI (" gnat_envp := envp;");
1759 -- If configurable run time and no command line args, then nothing
1760 -- needs to be done since the gnat_argc/argv/envp variables are
1761 -- suppressed in this case.
1763 elsif Configurable_Run_Time_On_Target then
1766 -- Otherwise set dummy values (to be filled in by some other unit?)
1769 WBI (" gnat_argc := 0;");
1770 WBI (" gnat_argv := System.Null_Address;");
1771 WBI (" gnat_envp := System.Null_Address;");
1774 if Opt.Default_Exit_Status /= 0
1775 and then Bind_Main_Program
1776 and then not Configurable_Run_Time_Mode
1778 Set_String (" Set_Exit_Status (");
1779 Set_Int (Opt.Default_Exit_Status);
1781 Write_Statement_Buffer;
1784 if Dynamic_Stack_Measurement then
1785 Set_String (" Initialize_Stack_Analysis (");
1786 Set_Int (Dynamic_Stack_Measurement_Array_Size);
1788 Write_Statement_Buffer;
1791 if not Cumulative_Restrictions.Set (No_Finalization)
1792 and then not CodePeer_Mode
1794 if not No_Main_Subprogram
1795 and then Bind_Main_Program
1796 and then not Suppress_Standard_Library_On_Target
1798 WBI (" Initialize (SEH'Address);");
1800 WBI (" Initialize (System.Null_Address);");
1804 WBI (" " & Ada_Init_Name.all & ";");
1806 if not No_Main_Subprogram then
1807 if CodePeer_Mode then
1808 if ALIs.Table (ALIs.First).Main_Program = Proc then
1809 WBI (" " & CodePeer_Wrapper_Name & ";");
1811 WBI (" Result := " & CodePeer_Wrapper_Name & ";");
1814 elsif ALIs.Table (ALIs.First).Main_Program = Proc then
1815 WBI (" Ada_Main_Program;");
1818 WBI (" Result := Ada_Main_Program;");
1822 -- Adafinal call is skipped if no finalization
1824 if not Cumulative_Restrictions.Set (No_Finalization) then
1828 -- Prints the result of static stack analysis
1830 if Dynamic_Stack_Measurement then
1831 WBI (" Output_Results;");
1834 -- Finalize is only called if we have a run time
1836 if not Cumulative_Restrictions.Set (No_Finalization)
1837 and then not CodePeer_Mode
1844 if Exit_Status_Supported_On_Target then
1845 if No_Main_Subprogram
1846 or else ALIs.Table (ALIs.First).Main_Program = Proc
1848 WBI (" return (gnat_exit_status);");
1850 WBI (" return (Result);");
1858 ------------------------------
1859 -- Gen_Object_Files_Options --
1860 ------------------------------
1862 procedure Gen_Object_Files_Options is
1864 -- This keeps track of the position in the sorted set of entries
1865 -- in the Linker_Options table of where the first entry from an
1866 -- internal file appears.
1868 Linker_Option_List_Started : Boolean := False;
1869 -- Set to True when "LINKER OPTION LIST" is displayed
1871 procedure Write_Linker_Option;
1872 -- Write binder info linker option
1874 -------------------------
1875 -- Write_Linker_Option --
1876 -------------------------
1878 procedure Write_Linker_Option is
1883 -- Loop through string, breaking at null's
1886 while Start < Name_Len loop
1888 -- Find null ending this section
1891 while Name_Buffer (Stop) /= ASCII.NUL
1892 and then Stop <= Name_Len loop
1896 -- Process section if non-null
1898 if Stop > Start then
1899 if Output_Linker_Option_List then
1900 if not Zero_Formatting then
1901 if not Linker_Option_List_Started then
1902 Linker_Option_List_Started := True;
1904 Write_Str (" LINKER OPTION LIST");
1912 Write_Str (Name_Buffer (Start .. Stop - 1));
1915 WBI (" -- " & Name_Buffer (Start .. Stop - 1));
1920 end Write_Linker_Option;
1922 -- Start of processing for Gen_Object_Files_Options
1925 WBI ("-- BEGIN Object file/option list");
1927 if Object_List_Filename /= null then
1928 Set_List_File (Object_List_Filename.all);
1931 for E in Elab_Order.First .. Elab_Order.Last loop
1933 -- If not spec that has an associated body, then generate a comment
1934 -- giving the name of the corresponding object file.
1936 if not Units.Table (Elab_Order.Table (E)).SAL_Interface
1937 and then Units.Table (Elab_Order.Table (E)).Utype /= Is_Spec
1941 (Units.Table (Elab_Order.Table (E)).My_ALI).Ofile_Full_Name);
1943 -- If the presence of an object file is necessary or if it exists,
1946 if not Hostparm.Exclude_Missing_Objects
1948 System.OS_Lib.Is_Regular_File (Name_Buffer (1 .. Name_Len))
1950 WBI (" -- " & Name_Buffer (1 .. Name_Len));
1952 if Output_Object_List then
1953 Write_Str (Name_Buffer (1 .. Name_Len));
1960 if Object_List_Filename /= null then
1964 -- Add a "-Ldir" for each directory in the object path
1965 if VM_Target /= CLI_Target then
1966 for J in 1 .. Nb_Dir_In_Obj_Search_Path loop
1968 Dir : constant String_Ptr := Dir_In_Obj_Search_Path (J);
1971 Add_Str_To_Name_Buffer ("-L");
1972 Add_Str_To_Name_Buffer (Dir.all);
1973 Write_Linker_Option;
1978 -- Sort linker options
1980 -- This sort accomplishes two important purposes:
1982 -- a) All application files are sorted to the front, and all GNAT
1983 -- internal files are sorted to the end. This results in a well
1984 -- defined dividing line between the two sets of files, for the
1985 -- purpose of inserting certain standard library references into
1986 -- the linker arguments list.
1988 -- b) Given two different units, we sort the linker options so that
1989 -- those from a unit earlier in the elaboration order comes later
1990 -- in the list. This is a heuristic designed to create a more
1991 -- friendly order of linker options when the operations appear in
1992 -- separate units. The idea is that if unit A must be elaborated
1993 -- before unit B, then it is more likely that B references
1994 -- libraries included by A, than vice versa, so we want libraries
1995 -- included by A to come after libraries included by B.
1997 -- These two criteria are implemented by function Lt_Linker_Option. Note
1998 -- that a special case of b) is that specs are elaborated before bodies,
1999 -- so linker options from specs come after linker options for bodies,
2000 -- and again, the assumption is that libraries used by the body are more
2001 -- likely to reference libraries used by the spec, than vice versa.
2004 (Linker_Options.Last,
2005 Move_Linker_Option'Access,
2006 Lt_Linker_Option'Access);
2008 -- Write user linker options, i.e. the set of linker options that come
2009 -- from all files other than GNAT internal files, Lgnat is left set to
2010 -- point to the first entry from a GNAT internal file, or past the end
2011 -- of the entries if there are no internal files.
2013 Lgnat := Linker_Options.Last + 1;
2015 for J in 1 .. Linker_Options.Last loop
2016 if not Linker_Options.Table (J).Internal_File then
2017 Get_Name_String (Linker_Options.Table (J).Name);
2018 Write_Linker_Option;
2025 -- Now we insert standard linker options that must appear after the
2026 -- entries from user files, and before the entries from GNAT run-time
2027 -- files. The reason for this decision is that libraries referenced
2028 -- by internal routines may reference these standard library entries.
2030 -- Note that we do not insert anything when pragma No_Run_Time has been
2031 -- specified or when the standard libraries are not to be used,
2032 -- otherwise on some platforms, such as VMS, we may get duplicate
2033 -- symbols when linking.
2035 if not (Opt.No_Run_Time_Mode or else Opt.No_Stdlib) then
2038 if Opt.Shared_Libgnat then
2039 Add_Str_To_Name_Buffer ("-shared");
2041 Add_Str_To_Name_Buffer ("-static");
2044 -- Write directly to avoid -K output (why???)
2046 WBI (" -- " & Name_Buffer (1 .. Name_Len));
2048 if With_DECGNAT then
2051 if Opt.Shared_Libgnat then
2052 Add_Str_To_Name_Buffer (Shared_Lib ("decgnat"));
2054 Add_Str_To_Name_Buffer ("-ldecgnat");
2057 Write_Linker_Option;
2063 if Opt.Shared_Libgnat then
2064 Add_Str_To_Name_Buffer (Shared_Lib ("gnarl"));
2066 Add_Str_To_Name_Buffer ("-lgnarl");
2069 Write_Linker_Option;
2074 if Opt.Shared_Libgnat then
2075 Add_Str_To_Name_Buffer (Shared_Lib ("gnat"));
2077 Add_Str_To_Name_Buffer ("-lgnat");
2080 Write_Linker_Option;
2083 -- Write linker options from all internal files
2085 for J in Lgnat .. Linker_Options.Last loop
2086 Get_Name_String (Linker_Options.Table (J).Name);
2087 Write_Linker_Option;
2090 if Output_Linker_Option_List and then not Zero_Formatting then
2094 WBI ("-- END Object file/option list ");
2095 end Gen_Object_Files_Options;
2097 ---------------------
2098 -- Gen_Output_File --
2099 ---------------------
2101 procedure Gen_Output_File (Filename : String) is
2103 -- Acquire settings for Interrupt_State pragmas
2105 Set_IS_Pragma_Table;
2107 -- Acquire settings for Priority_Specific_Dispatching pragma
2109 Set_PSD_Pragma_Table;
2111 -- For JGNAT the main program is already generated by the compiler
2113 if VM_Target = JVM_Target then
2114 Bind_Main_Program := False;
2117 -- Override time slice value if -T switch is set
2119 if Time_Slice_Set then
2120 ALIs.Table (ALIs.First).Time_Slice_Value := Opt.Time_Slice_Value;
2123 -- Count number of elaboration calls
2125 for E in Elab_Order.First .. Elab_Order.Last loop
2126 if Units.Table (Elab_Order.Table (E)).No_Elab then
2129 Num_Elab_Calls := Num_Elab_Calls + 1;
2133 -- Generate output file in appropriate language
2135 Check_System_Restrictions_Used;
2136 Check_Dispatching_Domains_Used;
2138 Gen_Output_File_Ada (Filename);
2139 end Gen_Output_File;
2141 -------------------------
2142 -- Gen_Output_File_Ada --
2143 -------------------------
2145 procedure Gen_Output_File_Ada (Filename : String) is
2147 Ada_Main : constant String := Get_Ada_Main_Name;
2148 -- Name to be used for generated Ada main program. See the body of
2149 -- function Get_Ada_Main_Name for details on the form of the name.
2151 Needs_Library_Finalization : constant Boolean :=
2152 not Configurable_Run_Time_On_Target
2153 and then Has_Finalizer;
2154 -- For restricted run-time libraries (ZFP and Ravenscar) tasks are
2155 -- non-terminating, so we do not want finalization.
2158 -- Name of generated bind file (spec)
2161 -- Name of generated bind file (body)
2164 -- Create spec first
2166 Create_Binder_Output (Filename, 's', Bfiles);
2168 -- We always compile the binder file in Ada 95 mode so that we properly
2169 -- handle use of Ada 2005 keywords as identifiers in Ada 95 mode. None
2170 -- of the Ada 2005 or Ada 2012 constructs are needed by the binder file.
2172 WBI ("pragma Ada_95;");
2174 -- If we are operating in Restrictions (No_Exception_Handlers) mode,
2175 -- then we need to make sure that the binder program is compiled with
2176 -- the same restriction, so that no exception tables are generated.
2178 if Cumulative_Restrictions.Set (No_Exception_Handlers) then
2179 WBI ("pragma Restrictions (No_Exception_Handlers);");
2182 -- Same processing for Restrictions (No_Exception_Propagation)
2184 if Cumulative_Restrictions.Set (No_Exception_Propagation) then
2185 WBI ("pragma Restrictions (No_Exception_Propagation);");
2188 -- Same processing for pragma No_Run_Time
2190 if No_Run_Time_Mode then
2191 WBI ("pragma No_Run_Time;");
2194 -- Generate with of System so we can reference System.Address
2196 WBI ("with System;");
2198 -- Generate with of System.Initialize_Scalars if active
2200 if Initialize_Scalars_Used then
2201 WBI ("with System.Scalar_Values;");
2204 -- Generate with of System.Secondary_Stack if active
2206 if Sec_Stack_Used and then Default_Sec_Stack_Size /= -1 then
2207 WBI ("with System.Secondary_Stack;");
2210 Resolve_Binder_Options;
2212 -- Usually, adafinal is called using a pragma Import C. Since Import C
2213 -- doesn't have the same semantics for VMs or CodePeer use standard Ada.
2215 if not Suppress_Standard_Library_On_Target then
2216 if CodePeer_Mode then
2217 WBI ("with System.Standard_Library;");
2218 elsif VM_Target /= No_VM then
2219 WBI ("with System.Soft_Links;");
2220 WBI ("with System.Standard_Library;");
2224 WBI ("package " & Ada_Main & " is");
2225 WBI (" pragma Warnings (Off);");
2227 -- Main program case
2229 if Bind_Main_Program then
2230 if VM_Target = No_VM then
2232 -- Generate argc/argv stuff unless suppressed
2234 if Command_Line_Args_On_Target
2235 or not Configurable_Run_Time_On_Target
2238 WBI (" gnat_argc : Integer;");
2239 WBI (" gnat_argv : System.Address;");
2240 WBI (" gnat_envp : System.Address;");
2242 -- If the standard library is not suppressed, these variables
2243 -- are in the run-time data area for easy run time access.
2245 if not Suppress_Standard_Library_On_Target then
2247 WBI (" pragma Import (C, gnat_argc);");
2248 WBI (" pragma Import (C, gnat_argv);");
2249 WBI (" pragma Import (C, gnat_envp);");
2253 -- Define exit status. Again in normal mode, this is in the
2254 -- run-time library, and is initialized there, but in the
2255 -- configurable runtime case, the variable is declared and
2256 -- initialized in this file.
2260 if Configurable_Run_Time_Mode then
2261 if Exit_Status_Supported_On_Target then
2262 WBI (" gnat_exit_status : Integer := 0;");
2266 WBI (" gnat_exit_status : Integer;");
2267 WBI (" pragma Import (C, gnat_exit_status);");
2271 -- Generate the GNAT_Version and Ada_Main_Program_Name info only for
2272 -- the main program. Otherwise, it can lead under some circumstances
2273 -- to a symbol duplication during the link (for instance when a C
2274 -- program uses two Ada libraries). Also zero terminate the string
2275 -- so that its end can be found reliably at run time.
2278 WBI (" GNAT_Version : constant String :=");
2279 WBI (" """ & Ver_Prefix &
2280 Gnat_Version_String &
2282 WBI (" pragma Export (C, GNAT_Version, ""__gnat_version"");");
2285 Set_String (" Ada_Main_Program_Name : constant String := """);
2286 Get_Name_String (Units.Table (First_Unit_Entry).Uname);
2288 if VM_Target = No_VM then
2289 Set_Main_Program_Name;
2290 Set_String (""" & ASCII.NUL;");
2292 Set_String (Name_Buffer (1 .. Name_Len - 2) & """;");
2295 Write_Statement_Buffer;
2298 (" pragma Export (C, Ada_Main_Program_Name, " &
2299 """__gnat_ada_main_program_name"");");
2303 WBI (" procedure " & Ada_Init_Name.all & ";");
2304 WBI (" pragma Export (C, " & Ada_Init_Name.all & ", """ &
2305 Ada_Init_Name.all & """);");
2307 -- If -a has been specified use pragma Linker_Constructor for the init
2308 -- procedure and pragma Linker_Destructor for the final procedure.
2310 if Use_Pragma_Linker_Constructor then
2311 WBI (" pragma Linker_Constructor (" & Ada_Init_Name.all & ");");
2314 if not Cumulative_Restrictions.Set (No_Finalization) then
2316 WBI (" procedure " & Ada_Final_Name.all & ";");
2317 WBI (" pragma Export (C, " & Ada_Final_Name.all & ", """ &
2318 Ada_Final_Name.all & """);");
2320 if Use_Pragma_Linker_Constructor then
2321 WBI (" pragma Linker_Destructor (" & Ada_Final_Name.all & ");");
2325 if Bind_Main_Program and then VM_Target = No_VM then
2329 if Exit_Status_Supported_On_Target then
2330 Set_String (" function ");
2332 Set_String (" procedure ");
2335 Set_String (Get_Main_Name);
2337 -- Generate argument list if present
2339 if Command_Line_Args_On_Target then
2340 Write_Statement_Buffer;
2341 WBI (" (argc : Integer;");
2342 WBI (" argv : System.Address;");
2344 (" envp : System.Address)");
2346 if Exit_Status_Supported_On_Target then
2347 Write_Statement_Buffer;
2348 WBI (" return Integer;");
2350 Write_Statement_Buffer (";");
2354 if Exit_Status_Supported_On_Target then
2355 Write_Statement_Buffer (" return Integer;");
2357 Write_Statement_Buffer (";");
2361 WBI (" pragma Export (C, " & Get_Main_Name & ", """ &
2362 Get_Main_Name & """);");
2371 WBI ("end " & Ada_Main & ";");
2372 Close_Binder_Output;
2374 -- Prepare to write body
2376 Create_Binder_Output (Filename, 'b', Bfileb);
2378 -- We always compile the binder file in Ada 95 mode so that we properly
2379 -- handle use of Ada 2005 keywords as identifiers in Ada 95 mode. None
2380 -- of the Ada 2005/2012 constructs are needed by the binder file.
2382 WBI ("pragma Ada_95;");
2384 -- Output Source_File_Name pragmas which look like
2386 -- pragma Source_File_Name (Ada_Main, Spec_File_Name => "sss");
2387 -- pragma Source_File_Name (Ada_Main, Body_File_Name => "bbb");
2389 -- where sss/bbb are the spec/body file names respectively
2391 Get_Name_String (Bfiles);
2392 Name_Buffer (Name_Len + 1 .. Name_Len + 3) := """);";
2394 WBI ("pragma Source_File_Name (" &
2396 ", Spec_File_Name => """ &
2397 Name_Buffer (1 .. Name_Len + 3));
2399 Get_Name_String (Bfileb);
2400 Name_Buffer (Name_Len + 1 .. Name_Len + 3) := """);";
2402 WBI ("pragma Source_File_Name (" &
2404 ", Body_File_Name => """ &
2405 Name_Buffer (1 .. Name_Len + 3));
2407 -- Generate with of System.Restrictions to initialize
2408 -- Run_Time_Restrictions.
2410 if System_Restrictions_Used
2411 and not Suppress_Standard_Library_On_Target
2414 WBI ("with System.Restrictions;");
2417 if Needs_Library_Finalization then
2418 WBI ("with Ada.Exceptions;");
2422 WBI ("package body " & Ada_Main & " is");
2423 WBI (" pragma Warnings (Off);");
2426 -- Generate externals for elaboration entities
2430 if not CodePeer_Mode then
2431 if not Suppress_Standard_Library_On_Target then
2433 -- Generate Priority_Specific_Dispatching pragma string
2436 (" Local_Priority_Specific_Dispatching : " &
2437 "constant String := """);
2439 for J in 0 .. PSD_Pragma_Settings.Last loop
2440 Set_Char (PSD_Pragma_Settings.Table (J));
2444 Write_Statement_Buffer;
2446 -- Generate Interrupt_State pragma string
2448 Set_String (" Local_Interrupt_States : constant String := """);
2450 for J in 0 .. IS_Pragma_Settings.Last loop
2451 Set_Char (IS_Pragma_Settings.Table (J));
2455 Write_Statement_Buffer;
2459 -- The B.1 (39) implementation advice says that the adainit/adafinal
2460 -- routines should be idempotent. Generate a flag to ensure that.
2462 WBI (" Is_Elaborated : Boolean := False;");
2466 -- Generate the adafinal routine unless there is no finalization to do
2468 if not Cumulative_Restrictions.Set (No_Finalization) then
2469 if Needs_Library_Finalization then
2470 Gen_Finalize_Library;
2478 if Bind_Main_Program and then VM_Target = No_VM then
2482 -- Output object file list and the Ada body is complete
2484 Gen_Object_Files_Options;
2487 WBI ("end " & Ada_Main & ";");
2489 Close_Binder_Output;
2490 end Gen_Output_File_Ada;
2492 ----------------------
2493 -- Gen_Restrictions --
2494 ----------------------
2496 procedure Gen_Restrictions is
2500 if Suppress_Standard_Library_On_Target
2501 or not System_Restrictions_Used
2506 WBI (" System.Restrictions.Run_Time_Restrictions :=");
2512 for J in Cumulative_Restrictions.Set'Range loop
2513 Set_Boolean (Cumulative_Restrictions.Set (J));
2517 if J /= Cumulative_Restrictions.Set'Last and then Count = 8 then
2518 Write_Statement_Buffer;
2524 Set_String_Replace ("),");
2525 Write_Statement_Buffer;
2526 Set_String (" Value => (");
2528 for J in Cumulative_Restrictions.Value'Range loop
2529 Set_Int (Int (Cumulative_Restrictions.Value (J)));
2533 Set_String_Replace ("),");
2534 Write_Statement_Buffer;
2535 WBI (" Violated =>");
2539 for J in Cumulative_Restrictions.Violated'Range loop
2540 Set_Boolean (Cumulative_Restrictions.Violated (J));
2544 if J /= Cumulative_Restrictions.Set'Last and then Count = 8 then
2545 Write_Statement_Buffer;
2551 Set_String_Replace ("),");
2552 Write_Statement_Buffer;
2553 Set_String (" Count => (");
2555 for J in Cumulative_Restrictions.Count'Range loop
2556 Set_Int (Int (Cumulative_Restrictions.Count (J)));
2560 Set_String_Replace ("),");
2561 Write_Statement_Buffer;
2562 Set_String (" Unknown => (");
2564 for J in Cumulative_Restrictions.Unknown'Range loop
2565 Set_Boolean (Cumulative_Restrictions.Unknown (J));
2569 Set_String_Replace ("))");
2571 Write_Statement_Buffer;
2572 end Gen_Restrictions;
2578 -- This routine generates lines such as:
2580 -- unnnnn : constant Integer := 16#hhhhhhhh#;
2581 -- pragma Export (C, unnnnn, unam);
2583 -- for each unit, where unam is the unit name suffixed by either B or S for
2584 -- body or spec, with dots replaced by double underscores, and hhhhhhhh is
2585 -- the version number, and nnnnn is a 5-digits serial number.
2587 procedure Gen_Versions is
2588 Ubuf : String (1 .. 6) := "u00000";
2590 procedure Increment_Ubuf;
2591 -- Little procedure to increment the serial number
2593 --------------------
2594 -- Increment_Ubuf --
2595 --------------------
2597 procedure Increment_Ubuf is
2599 for J in reverse Ubuf'Range loop
2600 Ubuf (J) := Character'Succ (Ubuf (J));
2601 exit when Ubuf (J) <= '9';
2606 -- Start of processing for Gen_Versions
2611 WBI (" type Version_32 is mod 2 ** 32;");
2612 for U in Units.First .. Units.Last loop
2613 if not Units.Table (U).SAL_Interface
2615 (not Bind_For_Library or else Units.Table (U).Directly_Scanned)
2618 WBI (" " & Ubuf & " : constant Version_32 := 16#" &
2619 Units.Table (U).Version & "#;");
2620 Set_String (" pragma Export (C, ");
2622 Set_String (", """);
2624 Get_Name_String (Units.Table (U).Uname);
2626 for K in 1 .. Name_Len loop
2627 if Name_Buffer (K) = '.' then
2631 elsif Name_Buffer (K) = '%' then
2635 Set_Char (Name_Buffer (K));
2639 if Name_Buffer (Name_Len) = 's' then
2645 Set_String (""");");
2646 Write_Statement_Buffer;
2651 ------------------------
2652 -- Get_Main_Unit_Name --
2653 ------------------------
2655 function Get_Main_Unit_Name (S : String) return String is
2656 Result : String := S;
2659 for J in S'Range loop
2660 if Result (J) = '.' then
2666 end Get_Main_Unit_Name;
2668 -----------------------
2669 -- Get_Ada_Main_Name --
2670 -----------------------
2672 function Get_Ada_Main_Name return String is
2673 Suffix : constant String := "_00";
2674 Name : String (1 .. Opt.Ada_Main_Name.all'Length + Suffix'Length) :=
2675 Opt.Ada_Main_Name.all & Suffix;
2679 -- The main program generated by JGNAT expects a package called
2680 -- ada_<main procedure>.
2681 if VM_Target /= No_VM then
2682 Get_Name_String (Units.Table (First_Unit_Entry).Uname);
2683 return "ada_" & Get_Main_Unit_Name (Name_Buffer (1 .. Name_Len - 2));
2686 -- For CodePeer, we want reproducible names (independent of other
2687 -- mains that may or may not be present) that don't collide
2688 -- when analyzing multiple mains and which are easily recognizable
2689 -- as "ada_main" names.
2690 if CodePeer_Mode then
2691 Get_Name_String (Units.Table (First_Unit_Entry).Uname);
2692 return "ada_main_for_" &
2693 Get_Main_Unit_Name (Name_Buffer (1 .. Name_Len - 2));
2696 -- This loop tries the following possibilities in order
2702 -- where <Ada_Main> is equal to Opt.Ada_Main_Name. By default,
2703 -- it is set to 'ada_main'.
2705 for J in 0 .. 99 loop
2707 Nlen := Name'Length - Suffix'Length;
2709 Nlen := Name'Length;
2710 Name (Name'Last) := Character'Val (J mod 10 + Character'Pos ('0'));
2711 Name (Name'Last - 1) :=
2712 Character'Val (J / 10 + Character'Pos ('0'));
2715 for K in ALIs.First .. ALIs.Last loop
2716 for L in ALIs.Table (K).First_Unit .. ALIs.Table (K).Last_Unit loop
2718 -- Get unit name, removing %b or %e at end
2720 Get_Name_String (Units.Table (L).Uname);
2721 Name_Len := Name_Len - 2;
2723 if Name_Buffer (1 .. Name_Len) = Name (1 .. Nlen) then
2729 return Name (1 .. Nlen);
2735 -- If we fall through, just use a peculiar unlikely name
2737 return ("Qwertyuiop");
2738 end Get_Ada_Main_Name;
2744 function Get_Main_Name return String is
2746 -- Explicit name given with -M switch
2748 if Bind_Alternate_Main_Name then
2749 return Alternate_Main_Name.all;
2751 -- Case of main program name to be used directly
2753 elsif Use_Ada_Main_Program_Name_On_Target then
2755 -- Get main program name
2757 Get_Name_String (Units.Table (First_Unit_Entry).Uname);
2759 -- If this is a child name, return only the name of the child, since
2760 -- we can't have dots in a nested program name. Note that we do not
2761 -- include the %b at the end of the unit name.
2763 for J in reverse 1 .. Name_Len - 2 loop
2764 if J = 1 or else Name_Buffer (J - 1) = '.' then
2765 return Name_Buffer (J .. Name_Len - 2);
2769 raise Program_Error; -- impossible exit
2771 -- Case where "main" is to be used as default
2778 ---------------------
2779 -- Get_WC_Encoding --
2780 ---------------------
2782 function Get_WC_Encoding return Character is
2784 -- If encoding method specified by -W switch, then return it
2786 if Wide_Character_Encoding_Method_Specified then
2787 return WC_Encoding_Letters (Wide_Character_Encoding_Method);
2789 -- If no main program, and not specified, set brackets, we really have
2790 -- no better choice. If some other encoding is required when there is
2791 -- no main, it must be set explicitly using -Wx.
2793 -- Note: if the ALI file always passed the wide character encoding of
2794 -- every file, then we could use the encoding of the initial specified
2795 -- file, but this information is passed only for potential main
2796 -- programs. We could fix this sometime, but it is a very minor point
2797 -- (wide character default encoding for [Wide_[Wide_]Text_IO when there
2798 -- is no main program).
2800 elsif No_Main_Subprogram then
2803 -- Otherwise if there is a main program, take encoding from it
2806 return ALIs.Table (ALIs.First).WC_Encoding;
2808 end Get_WC_Encoding;
2814 function Has_Finalizer return Boolean is
2819 for E in reverse Elab_Order.First .. Elab_Order.Last loop
2820 Unum := Elab_Order.Table (E);
2821 U := Units.Table (Unum);
2823 -- We are only interested in non-generic packages
2825 if U.Unit_Kind = 'p'
2826 and then U.Has_Finalizer
2827 and then not U.Is_Generic
2828 and then not U.No_Elab
2837 ----------------------
2838 -- Lt_Linker_Option --
2839 ----------------------
2841 function Lt_Linker_Option (Op1, Op2 : Natural) return Boolean is
2843 -- Sort internal files last
2845 if Linker_Options.Table (Op1).Internal_File
2847 Linker_Options.Table (Op2).Internal_File
2849 -- Note: following test uses False < True
2851 return Linker_Options.Table (Op1).Internal_File
2853 Linker_Options.Table (Op2).Internal_File;
2855 -- If both internal or both non-internal, sort according to the
2856 -- elaboration position. A unit that is elaborated later should come
2857 -- earlier in the linker options list.
2860 return Units.Table (Linker_Options.Table (Op1).Unit).Elab_Position
2862 Units.Table (Linker_Options.Table (Op2).Unit).Elab_Position;
2865 end Lt_Linker_Option;
2867 ------------------------
2868 -- Move_Linker_Option --
2869 ------------------------
2871 procedure Move_Linker_Option (From : Natural; To : Natural) is
2873 Linker_Options.Table (To) := Linker_Options.Table (From);
2874 end Move_Linker_Option;
2876 ----------------------------
2877 -- Resolve_Binder_Options --
2878 ----------------------------
2880 procedure Resolve_Binder_Options is
2882 for E in Elab_Order.First .. Elab_Order.Last loop
2883 Get_Name_String (Units.Table (Elab_Order.Table (E)).Uname);
2885 -- This is not a perfect approach, but is the current protocol
2886 -- between the run-time and the binder to indicate that tasking is
2887 -- used: system.os_interface should always be used by any tasking
2890 if Name_Buffer (1 .. 19) = "system.os_interface" then
2894 -- Ditto for declib and the "dec" package
2896 if OpenVMS_On_Target and then Name_Buffer (1 .. 5) = "dec%s" then
2897 With_DECGNAT := True;
2900 end Resolve_Binder_Options;
2906 procedure Set_Boolean (B : Boolean) is
2907 True_Str : constant String := "True";
2908 False_Str : constant String := "False";
2911 Statement_Buffer (Last + 1 .. Last + True_Str'Length) := True_Str;
2912 Last := Last + True_Str'Length;
2914 Statement_Buffer (Last + 1 .. Last + False_Str'Length) := False_Str;
2915 Last := Last + False_Str'Length;
2923 procedure Set_Char (C : Character) is
2926 Statement_Buffer (Last) := C;
2933 procedure Set_Int (N : Int) is
2945 Statement_Buffer (Last) :=
2946 Character'Val (N mod 10 + Character'Pos ('0'));
2950 -------------------------
2951 -- Set_IS_Pragma_Table --
2952 -------------------------
2954 procedure Set_IS_Pragma_Table is
2956 for F in ALIs.First .. ALIs.Last loop
2957 for K in ALIs.Table (F).First_Interrupt_State ..
2958 ALIs.Table (F).Last_Interrupt_State
2961 Inum : constant Int :=
2962 Interrupt_States.Table (K).Interrupt_Id;
2963 Stat : constant Character :=
2964 Interrupt_States.Table (K).Interrupt_State;
2967 while IS_Pragma_Settings.Last < Inum loop
2968 IS_Pragma_Settings.Append ('n');
2971 IS_Pragma_Settings.Table (Inum) := Stat;
2975 end Set_IS_Pragma_Table;
2977 ---------------------------
2978 -- Set_Main_Program_Name --
2979 ---------------------------
2981 procedure Set_Main_Program_Name is
2983 -- Note that name has %b on the end which we ignore
2985 -- First we output the initial _ada_ since we know that the main
2986 -- program is a library level subprogram.
2988 Set_String ("_ada_");
2990 -- Copy name, changing dots to double underscores
2992 for J in 1 .. Name_Len - 2 loop
2993 if Name_Buffer (J) = '.' then
2996 Set_Char (Name_Buffer (J));
2999 end Set_Main_Program_Name;
3001 ---------------------
3002 -- Set_Name_Buffer --
3003 ---------------------
3005 procedure Set_Name_Buffer is
3007 for J in 1 .. Name_Len loop
3008 Set_Char (Name_Buffer (J));
3010 end Set_Name_Buffer;
3012 -------------------------
3013 -- Set_PSD_Pragma_Table --
3014 -------------------------
3016 procedure Set_PSD_Pragma_Table is
3018 for F in ALIs.First .. ALIs.Last loop
3019 for K in ALIs.Table (F).First_Specific_Dispatching ..
3020 ALIs.Table (F).Last_Specific_Dispatching
3023 DTK : Specific_Dispatching_Record
3024 renames Specific_Dispatching.Table (K);
3027 while PSD_Pragma_Settings.Last < DTK.Last_Priority loop
3028 PSD_Pragma_Settings.Append ('F');
3031 for Prio in DTK.First_Priority .. DTK.Last_Priority loop
3032 PSD_Pragma_Settings.Table (Prio) := DTK.Dispatching_Policy;
3037 end Set_PSD_Pragma_Table;
3043 procedure Set_String (S : String) is
3045 Statement_Buffer (Last + 1 .. Last + S'Length) := S;
3046 Last := Last + S'Length;
3049 ------------------------
3050 -- Set_String_Replace --
3051 ------------------------
3053 procedure Set_String_Replace (S : String) is
3055 Statement_Buffer (Last - S'Length + 1 .. Last) := S;
3056 end Set_String_Replace;
3062 procedure Set_Unit_Name (Mode : Qualification_Mode := Double_Underscores) is
3064 for J in 1 .. Name_Len - 2 loop
3065 if Name_Buffer (J) = '.' then
3066 if Mode = Double_Underscores then
3068 elsif Mode = Dot then
3074 Set_Char (Name_Buffer (J));
3079 ---------------------
3080 -- Set_Unit_Number --
3081 ---------------------
3083 procedure Set_Unit_Number (U : Unit_Id) is
3084 Num_Units : constant Nat := Nat (Units.Last) - Nat (Unit_Id'First);
3085 Unum : constant Nat := Nat (U) - Nat (Unit_Id'First);
3088 if Num_Units >= 10 and then Unum < 10 then
3092 if Num_Units >= 100 and then Unum < 100 then
3097 end Set_Unit_Number;
3099 ----------------------------
3100 -- Write_Statement_Buffer --
3101 ----------------------------
3103 procedure Write_Statement_Buffer is
3105 WBI (Statement_Buffer (1 .. Last));
3107 end Write_Statement_Buffer;
3109 procedure Write_Statement_Buffer (S : String) is
3112 Write_Statement_Buffer;
3113 end Write_Statement_Buffer;