Dead
[official-gcc.git] / gomp-20050608-branch / gcc / ada / xref_lib.adb
blobb04b5a66f38b96319c0673a6f27f0ceb917404ac
1 ------------------------------------------------------------------------------
2 -- --
3 -- GNAT COMPILER COMPONENTS --
4 -- --
5 -- X R E F _ L I B --
6 -- --
7 -- B o d y --
8 -- --
9 -- Copyright (C) 1998-2006, Free Software Foundation, Inc. --
10 -- --
11 -- GNAT is free software; you can redistribute it and/or modify it under --
12 -- terms of the GNU General Public License as published by the Free Soft- --
13 -- ware Foundation; either version 2, 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 COPYING. If not, write --
19 -- to the Free Software Foundation, 51 Franklin Street, Fifth Floor, --
20 -- Boston, MA 02110-1301, USA. --
21 -- --
22 -- GNAT was originally developed by the GNAT team at New York University. --
23 -- Extensive contributions were provided by Ada Core Technologies Inc. --
24 -- --
25 ------------------------------------------------------------------------------
27 with Osint;
28 with Output; use Output;
29 with Types; use Types;
31 with Unchecked_Deallocation;
33 with Ada.Strings.Fixed; use Ada.Strings.Fixed;
34 with Ada.Text_IO; use Ada.Text_IO;
36 with GNAT.Command_Line; use GNAT.Command_Line;
37 with GNAT.IO_Aux; use GNAT.IO_Aux;
39 package body Xref_Lib is
41 Type_Position : constant := 50;
42 -- Column for label identifying type of entity
44 ---------------------
45 -- Local Variables --
46 ---------------------
48 Pipe : constant Character := '|';
49 -- First character on xref lines in the .ali file
51 No_Xref_Information : exception;
52 -- Exception raised when there is no cross-referencing information in
53 -- the .ali files
55 procedure Parse_EOL
56 (Source : access String;
57 Ptr : in out Positive;
58 Skip_Continuation_Line : Boolean := False);
59 -- On return Source (Ptr) is the first character of the next line
60 -- or EOF. Source.all must be terminated by EOF.
62 -- If Skip_Continuation_Line is True, this subprogram skips as many
63 -- lines as required when the second or more lines starts with '.'
64 -- (continuation lines in ALI files).
66 function Current_Xref_File (File : ALI_File) return File_Reference;
67 -- Return the file matching the last 'X' line we found while parsing
68 -- the ALI file.
70 function File_Name (File : ALI_File; Num : Positive) return File_Reference;
71 -- Returns the dependency file name number Num
73 function Get_Full_Type (Decl : Declaration_Reference) return String;
74 -- Returns the full type corresponding to a type letter as found in
75 -- the .ali files.
77 procedure Open
78 (Name : String;
79 File : out ALI_File;
80 Dependencies : Boolean := False);
81 -- Open a new ALI file. If Dependencies is True, the insert every library
82 -- file 'with'ed in the files database (used for gnatxref)
84 procedure Parse_Identifier_Info
85 (Pattern : Search_Pattern;
86 File : in out ALI_File;
87 Local_Symbols : Boolean;
88 Der_Info : Boolean := False;
89 Type_Tree : Boolean := False;
90 Wide_Search : Boolean := True;
91 Labels_As_Ref : Boolean := True);
92 -- Output the file and the line where the identifier was referenced,
93 -- If Local_Symbols is False then only the publicly visible symbols
94 -- will be processed.
96 -- If Labels_As_Ref is true, then the references to the entities after
97 -- the end statements ("end Foo") will be counted as actual references.
98 -- The entity will never be reported as unreferenced by gnatxref -u
100 procedure Parse_Token
101 (Source : access String;
102 Ptr : in out Positive;
103 Token_Ptr : out Positive);
104 -- Skips any separators and stores the start of the token in Token_Ptr.
105 -- Then stores the position of the next separator in Ptr. On return
106 -- Source (Token_Ptr .. Ptr - 1) is the token. Separators are space
107 -- and ASCII.HT. Parse_Token will never skip to the next line.
109 procedure Parse_Number
110 (Source : access String;
111 Ptr : in out Positive;
112 Number : out Natural);
113 -- Skips any separators and parses Source upto the first character that
114 -- is not a decimal digit. Returns value of parsed digits or 0 if none.
116 procedure Parse_X_Filename (File : in out ALI_File);
117 -- Reads and processes "X..." lines in the ALI file
118 -- and updates the File.X_File information.
120 procedure Skip_To_First_X_Line
121 (File : in out ALI_File;
122 D_Lines : Boolean;
123 W_Lines : Boolean);
124 -- Skip the lines in the ALI file until the first cross-reference line
125 -- (^X...) is found. Search is started from the beginning of the file.
126 -- If not such line is found, No_Xref_Information is raised.
127 -- If W_Lines is false, then the lines "^W" are not parsed.
128 -- If D_Lines is false, then the lines "^D" are not parsed.
130 ----------------
131 -- Add_Entity --
132 ----------------
134 procedure Add_Entity
135 (Pattern : in out Search_Pattern;
136 Entity : String;
137 Glob : Boolean := False)
139 File_Start : Natural;
140 Line_Start : Natural;
141 Col_Start : Natural;
142 Line_Num : Natural := 0;
143 Col_Num : Natural := 0;
144 File_Ref : File_Reference := Empty_File;
146 begin
147 -- Find the end of the first item in Entity (pattern or file?)
148 -- If there is no ':', we only have a pattern
150 File_Start := Index (Entity, ":");
152 -- If the regular expression is invalid, just consider it as a string
154 if File_Start = 0 then
155 begin
156 Pattern.Entity := Compile (Entity, Glob, False);
157 Pattern.Initialized := True;
159 exception
160 when Error_In_Regexp =>
162 -- The basic idea is to insert a \ before every character
164 declare
165 Tmp_Regexp : String (1 .. 2 * Entity'Length);
166 Index : Positive := 1;
168 begin
169 for J in Entity'Range loop
170 Tmp_Regexp (Index) := '\';
171 Tmp_Regexp (Index + 1) := Entity (J);
172 Index := Index + 2;
173 end loop;
175 Pattern.Entity := Compile (Tmp_Regexp, True, False);
176 Pattern.Initialized := True;
177 end;
178 end;
180 Set_Default_Match (True);
181 return;
182 end if;
184 -- If there is a dot in the pattern, then it is a file name
186 if (Glob and then
187 Index (Entity (Entity'First .. File_Start - 1), ".") /= 0)
188 or else
189 (not Glob
190 and then Index (Entity (Entity'First .. File_Start - 1),
191 "\.") /= 0)
192 then
193 Pattern.Entity := Compile (".*", False);
194 Pattern.Initialized := True;
195 File_Start := Entity'First;
197 else
198 -- If the regular expression is invalid, just consider it as a string
200 begin
201 Pattern.Entity :=
202 Compile (Entity (Entity'First .. File_Start - 1), Glob, False);
203 Pattern.Initialized := True;
205 exception
206 when Error_In_Regexp =>
208 -- The basic idea is to insert a \ before every character
210 declare
211 Tmp_Regexp : String (1 .. 2 * (File_Start - Entity'First));
212 Index : Positive := 1;
214 begin
215 for J in Entity'First .. File_Start - 1 loop
216 Tmp_Regexp (Index) := '\';
217 Tmp_Regexp (Index + 1) := Entity (J);
218 Index := Index + 2;
219 end loop;
221 Pattern.Entity := Compile (Tmp_Regexp, True, False);
222 Pattern.Initialized := True;
223 end;
224 end;
226 File_Start := File_Start + 1;
227 end if;
229 -- Parse the file name
231 Line_Start := Index (Entity (File_Start .. Entity'Last), ":");
233 -- Check if it was a disk:\directory item (for NT and OS/2)
235 if File_Start = Line_Start - 1
236 and then Line_Start < Entity'Last
237 and then Entity (Line_Start + 1) = '\'
238 then
239 Line_Start := Index (Entity (Line_Start + 1 .. Entity'Last), ":");
240 end if;
242 if Line_Start = 0 then
243 Line_Start := Entity'Length + 1;
245 elsif Line_Start /= Entity'Last then
246 Col_Start := Index (Entity (Line_Start + 1 .. Entity'Last), ":");
248 if Col_Start = 0 then
249 Col_Start := Entity'Last + 1;
250 end if;
252 if Col_Start > Line_Start + 1 then
253 begin
254 Line_Num := Natural'Value
255 (Entity (Line_Start + 1 .. Col_Start - 1));
257 exception
258 when Constraint_Error =>
259 raise Invalid_Argument;
260 end;
261 end if;
263 if Col_Start < Entity'Last then
264 begin
265 Col_Num := Natural'Value (Entity
266 (Col_Start + 1 .. Entity'Last));
268 exception
269 when Constraint_Error => raise Invalid_Argument;
270 end;
271 end if;
272 end if;
274 File_Ref :=
275 Add_To_Xref_File
276 (Entity (File_Start .. Line_Start - 1), Visited => True);
277 Pattern.File_Ref := File_Ref;
278 Add_Line (Pattern.File_Ref, Line_Num, Col_Num);
279 File_Ref :=
280 Add_To_Xref_File
281 (ALI_File_Name (Entity (File_Start .. Line_Start - 1)),
282 Visited => False,
283 Emit_Warning => True);
284 end Add_Entity;
286 -------------------
287 -- Add_Xref_File --
288 -------------------
290 procedure Add_Xref_File (File : String) is
291 File_Ref : File_Reference := Empty_File;
292 pragma Unreferenced (File_Ref);
294 Iterator : Expansion_Iterator;
296 procedure Add_Xref_File_Internal (File : String);
297 -- Do the actual addition of the file
299 ----------------------------
300 -- Add_Xref_File_Internal --
301 ----------------------------
303 procedure Add_Xref_File_Internal (File : String) is
304 begin
305 -- Case where we have an ALI file, accept it even though this is
306 -- not official usage, since the intention is obvious
308 if Tail (File, 4) = ".ali" then
309 File_Ref := Add_To_Xref_File
310 (File, Visited => False, Emit_Warning => True);
312 -- Normal non-ali file case
314 else
315 File_Ref := Add_To_Xref_File (File, Visited => True);
317 File_Ref := Add_To_Xref_File
318 (ALI_File_Name (File),
319 Visited => False, Emit_Warning => True);
320 end if;
321 end Add_Xref_File_Internal;
323 -- Start of processing for Add_Xref_File
325 begin
326 -- Check if we need to do the expansion
328 if Ada.Strings.Fixed.Index (File, "*") /= 0
329 or else Ada.Strings.Fixed.Index (File, "?") /= 0
330 then
331 Start_Expansion (Iterator, File);
333 loop
334 declare
335 S : constant String := Expansion (Iterator);
337 begin
338 exit when S'Length = 0;
339 Add_Xref_File_Internal (S);
340 end;
341 end loop;
343 else
344 Add_Xref_File_Internal (File);
345 end if;
346 end Add_Xref_File;
348 -----------------------
349 -- Current_Xref_File --
350 -----------------------
352 function Current_Xref_File (File : ALI_File) return File_Reference is
353 begin
354 return File.X_File;
355 end Current_Xref_File;
357 --------------------------
358 -- Default_Project_File --
359 --------------------------
361 function Default_Project_File (Dir_Name : String) return String is
362 My_Dir : Dir_Type;
363 Dir_Ent : File_Name_String;
364 Last : Natural;
366 begin
367 Open (My_Dir, Dir_Name);
369 loop
370 Read (My_Dir, Dir_Ent, Last);
371 exit when Last = 0;
373 if Tail (Dir_Ent (1 .. Last), 4) = ".adp" then
375 -- The first project file found is the good one
377 Close (My_Dir);
378 return Dir_Ent (1 .. Last);
379 end if;
380 end loop;
382 Close (My_Dir);
383 return String'(1 .. 0 => ' ');
385 exception
386 when Directory_Error => return String'(1 .. 0 => ' ');
387 end Default_Project_File;
389 ---------------
390 -- File_Name --
391 ---------------
393 function File_Name
394 (File : ALI_File;
395 Num : Positive) return File_Reference
397 begin
398 return File.Dep.Table (Num);
399 end File_Name;
401 --------------------
402 -- Find_ALI_Files --
403 --------------------
405 procedure Find_ALI_Files is
406 My_Dir : Rec_DIR;
407 Dir_Ent : File_Name_String;
408 Last : Natural;
410 File_Ref : File_Reference;
411 pragma Unreferenced (File_Ref);
413 function Open_Next_Dir return Boolean;
414 -- Tries to open the next object directory, and return False if
415 -- the directory cannot be opened.
417 -------------------
418 -- Open_Next_Dir --
419 -------------------
421 function Open_Next_Dir return Boolean is
422 begin
423 -- Until we are able to open a new directory
425 loop
426 declare
427 Obj_Dir : constant String := Next_Obj_Dir;
429 begin
430 -- Case of no more Obj_Dir lines
432 if Obj_Dir'Length = 0 then
433 return False;
434 end if;
436 Open (My_Dir.Dir, Obj_Dir);
437 exit;
439 exception
441 -- Could not open the directory
443 when Directory_Error => null;
444 end;
445 end loop;
447 return True;
448 end Open_Next_Dir;
450 -- Start of processing for Find_ALI_Files
452 begin
453 Reset_Obj_Dir;
455 if Open_Next_Dir then
456 loop
457 Read (My_Dir.Dir, Dir_Ent, Last);
459 if Last = 0 then
460 Close (My_Dir.Dir);
462 if not Open_Next_Dir then
463 return;
464 end if;
466 elsif Last > 4 and then Dir_Ent (Last - 3 .. Last) = ".ali" then
467 File_Ref :=
468 Add_To_Xref_File (Dir_Ent (1 .. Last), Visited => False);
469 end if;
470 end loop;
471 end if;
472 end Find_ALI_Files;
474 -------------------
475 -- Get_Full_Type --
476 -------------------
478 function Get_Full_Type (Decl : Declaration_Reference) return String is
480 function Param_String return String;
481 -- Return the string to display depending on whether Decl is a
482 -- parameter or not
484 ------------------
485 -- Param_String --
486 ------------------
488 function Param_String return String is
489 begin
490 if Is_Parameter (Decl) then
491 return "parameter ";
492 else
493 return "";
494 end if;
495 end Param_String;
497 -- Start of processing for Get_Full_Type
499 begin
500 case Get_Type (Decl) is
501 when 'A' => return "array type";
502 when 'B' => return "boolean type";
503 when 'C' => return "class-wide type";
504 when 'D' => return "decimal type";
505 when 'E' => return "enumeration type";
506 when 'F' => return "float type";
507 when 'I' => return "integer type";
508 when 'M' => return "modular type";
509 when 'O' => return "fixed type";
510 when 'P' => return "access type";
511 when 'R' => return "record type";
512 when 'S' => return "string type";
513 when 'T' => return "task type";
514 when 'W' => return "protected type";
516 when 'a' => return "array type";
517 when 'b' => return Param_String & "boolean object";
518 when 'c' => return Param_String & "class-wide object";
519 when 'd' => return Param_String & "decimal object";
520 when 'e' => return Param_String & "enumeration object";
521 when 'f' => return Param_String & "float object";
522 when 'i' => return Param_String & "integer object";
523 when 'm' => return Param_String & "modular object";
524 when 'o' => return Param_String & "fixed object";
525 when 'p' => return Param_String & "access object";
526 when 'r' => return Param_String & "record object";
527 when 's' => return Param_String & "string object";
528 when 't' => return Param_String & "task object";
529 when 'w' => return Param_String & "protected object";
530 when 'x' => return Param_String & "abstract procedure";
531 when 'y' => return Param_String & "abstract function";
533 when 'K' => return "package";
534 when 'k' => return "generic package";
535 when 'L' => return "statement label";
536 when 'l' => return "loop label";
537 when 'N' => return "named number";
538 when 'n' => return "enumeration literal";
539 when 'q' => return "block label";
540 when 'U' => return "procedure";
541 when 'u' => return "generic procedure";
542 when 'V' => return "function";
543 when 'v' => return "generic function";
544 when 'X' => return "exception";
545 when 'Y' => return "entry";
547 when '+' => return "private type";
549 -- The above should be the only possibilities, but for this kind
550 -- of informational output, we don't want to bomb if we find
551 -- something else, so just return three question marks when we
552 -- have an unknown Abbrev value
554 when others =>
555 return "??? (" & Get_Type (Decl) & ")";
556 end case;
557 end Get_Full_Type;
559 --------------------------
560 -- Skip_To_First_X_Line --
561 --------------------------
563 procedure Skip_To_First_X_Line
564 (File : in out ALI_File;
565 D_Lines : Boolean;
566 W_Lines : Boolean)
568 Ali : String_Access renames File.Buffer;
569 Token : Positive;
570 Ptr : Positive := Ali'First;
571 Num_Dependencies : Natural := 0;
572 File_Start : Positive;
573 File_End : Positive;
574 Gnatchop_Offset : Integer;
575 Gnatchop_Name : Positive;
577 File_Ref : File_Reference;
578 pragma Unreferenced (File_Ref);
580 begin
581 -- Read all the lines possibly processing with-clauses and dependency
582 -- information and exit on finding the first Xref line.
583 -- A fall-through of the loop means that there is no xref information
584 -- which is an error condition.
586 while Ali (Ptr) /= EOF loop
587 if D_Lines and then Ali (Ptr) = 'D' then
589 -- Found dependency information. Format looks like:
590 -- D src-nam time-stmp checksum [subunit-name] [line:file-name]
592 -- Skip the D and parse the filenam
594 Ptr := Ptr + 1;
595 Parse_Token (Ali, Ptr, Token);
596 File_Start := Token;
597 File_End := Ptr - 1;
599 Num_Dependencies := Num_Dependencies + 1;
600 Set_Last (File.Dep, Num_Dependencies);
602 Parse_Token (Ali, Ptr, Token); -- Skip time-stamp
603 Parse_Token (Ali, Ptr, Token); -- Skip checksum
604 Parse_Token (Ali, Ptr, Token); -- Read next entity on the line
606 if not (Ali (Token) in '0' .. '9') then
607 Parse_Token (Ali, Ptr, Token); -- Was a subunit name
608 end if;
610 -- Did we have a gnatchop-ed file with a pragma Source_Reference ?
612 Gnatchop_Offset := 0;
614 if Ali (Token) in '0' .. '9' then
615 Gnatchop_Name := Token;
616 while Ali (Gnatchop_Name) /= ':' loop
617 Gnatchop_Name := Gnatchop_Name + 1;
618 end loop;
620 Gnatchop_Offset :=
621 2 - Natural'Value (Ali (Token .. Gnatchop_Name - 1));
622 Token := Gnatchop_Name + 1;
623 end if;
625 File.Dep.Table (Num_Dependencies) := Add_To_Xref_File
626 (Ali (File_Start .. File_End),
627 Gnatchop_File => Ali (Token .. Ptr - 1),
628 Gnatchop_Offset => Gnatchop_Offset);
630 elsif W_Lines and then Ali (Ptr) = 'W' then
632 -- Found with-clause information. Format looks like:
633 -- "W debug%s debug.adb debug.ali"
635 -- Skip the W and parse the .ali filename (3rd token)
637 Parse_Token (Ali, Ptr, Token);
638 Parse_Token (Ali, Ptr, Token);
639 Parse_Token (Ali, Ptr, Token);
641 File_Ref :=
642 Add_To_Xref_File (Ali (Token .. Ptr - 1), Visited => False);
644 elsif Ali (Ptr) = 'X' then
646 -- Found a cross-referencing line - stop processing
648 File.Current_Line := Ptr;
649 File.Xref_Line := Ptr;
650 return;
651 end if;
653 Parse_EOL (Ali, Ptr);
654 end loop;
656 raise No_Xref_Information;
657 end Skip_To_First_X_Line;
659 ----------
660 -- Open --
661 ----------
663 procedure Open
664 (Name : String;
665 File : out ALI_File;
666 Dependencies : Boolean := False)
668 Ali : String_Access renames File.Buffer;
670 begin
671 if File.Buffer /= null then
672 Free (File.Buffer);
673 end if;
675 Init (File.Dep);
677 begin
678 Read_File (Name, Ali);
680 exception
681 when Ada.Text_IO.Name_Error | Ada.Text_IO.End_Error =>
682 raise No_Xref_Information;
683 end;
685 Skip_To_First_X_Line (File, D_Lines => True, W_Lines => Dependencies);
686 end Open;
688 ---------------
689 -- Parse_EOL --
690 ---------------
692 procedure Parse_EOL
693 (Source : access String;
694 Ptr : in out Positive;
695 Skip_Continuation_Line : Boolean := False)
697 begin
698 loop
699 -- Skip to end of line
701 while Source (Ptr) /= ASCII.CR and then Source (Ptr) /= ASCII.LF
702 and then Source (Ptr) /= EOF
703 loop
704 Ptr := Ptr + 1;
705 end loop;
707 if Source (Ptr) /= EOF then
708 Ptr := Ptr + 1; -- skip CR or LF
709 end if;
711 -- Skip past CR/LF or LF/CR combination
713 if (Source (Ptr) = ASCII.CR or else Source (Ptr) = ASCII.LF)
714 and then Source (Ptr) /= Source (Ptr - 1)
715 then
716 Ptr := Ptr + 1;
717 end if;
719 exit when not Skip_Continuation_Line or else Source (Ptr) /= '.';
720 end loop;
721 end Parse_EOL;
723 ---------------------------
724 -- Parse_Identifier_Info --
725 ---------------------------
727 procedure Parse_Identifier_Info
728 (Pattern : Search_Pattern;
729 File : in out ALI_File;
730 Local_Symbols : Boolean;
731 Der_Info : Boolean := False;
732 Type_Tree : Boolean := False;
733 Wide_Search : Boolean := True;
734 Labels_As_Ref : Boolean := True)
736 Ptr : Positive renames File.Current_Line;
737 Ali : String_Access renames File.Buffer;
739 E_Line : Natural; -- Line number of current entity
740 E_Col : Natural; -- Column number of current entity
741 E_Type : Character; -- Type of current entity
742 E_Name : Positive; -- Pointer to begin of entity name
743 E_Global : Boolean; -- True iff entity is global
745 R_Line : Natural; -- Line number of current reference
746 R_Col : Natural; -- Column number of current reference
747 R_Type : Character; -- Type of current reference
749 Decl_Ref : Declaration_Reference;
750 File_Ref : File_Reference := Current_Xref_File (File);
752 function Get_Symbol_Name (Eun, Line, Col : Natural) return String;
753 -- Returns the symbol name for the entity defined at the specified
754 -- line and column in the dependent unit number Eun. For this we need
755 -- to parse the ali file again because the parent entity is not in
756 -- the declaration table if it did not match the search pattern.
758 procedure Skip_To_Matching_Closing_Bracket;
759 -- When Ptr points to an opening square bracket, moves it to the
760 -- character following the matching closing bracket
762 ---------------------
763 -- Get_Symbol_Name --
764 ---------------------
766 function Get_Symbol_Name (Eun, Line, Col : Natural) return String is
767 Ptr : Positive := 1;
768 E_Eun : Positive; -- Unit number of current entity
769 E_Line : Natural; -- Line number of current entity
770 E_Col : Natural; -- Column number of current entity
771 E_Name : Positive; -- Pointer to begin of entity name
773 begin
774 -- Look for the X lines corresponding to unit Eun
776 loop
777 if Ali (Ptr) = 'X' then
778 Ptr := Ptr + 1;
779 Parse_Number (Ali, Ptr, E_Eun);
780 exit when E_Eun = Eun;
781 end if;
783 Parse_EOL (Ali, Ptr, Skip_Continuation_Line => True);
784 end loop;
786 -- Here we are in the right Ali section, we now look for the entity
787 -- declared at position (Line, Col).
789 loop
790 Parse_Number (Ali, Ptr, E_Line);
791 exit when Ali (Ptr) = EOF;
792 Ptr := Ptr + 1;
793 Parse_Number (Ali, Ptr, E_Col);
794 exit when Ali (Ptr) = EOF;
795 Ptr := Ptr + 1;
797 if Line = E_Line and then Col = E_Col then
798 Parse_Token (Ali, Ptr, E_Name);
799 return Ali (E_Name .. Ptr - 1);
800 end if;
802 Parse_EOL (Ali, Ptr, Skip_Continuation_Line => True);
803 exit when Ali (Ptr) = EOF;
804 end loop;
806 -- We were not able to find the symbol, this should not happend but
807 -- since we don't want to stop here we return a string of three
808 -- question marks as the symbol name.
810 return "???";
811 end Get_Symbol_Name;
813 --------------------------------------
814 -- Skip_To_Matching_Closing_Bracket --
815 --------------------------------------
817 procedure Skip_To_Matching_Closing_Bracket is
818 Num_Brackets : Natural;
820 begin
821 Num_Brackets := 1;
822 while Num_Brackets /= 0 loop
823 Ptr := Ptr + 1;
824 if Ali (Ptr) = '[' then
825 Num_Brackets := Num_Brackets + 1;
826 elsif Ali (Ptr) = ']' then
827 Num_Brackets := Num_Brackets - 1;
828 end if;
829 end loop;
831 Ptr := Ptr + 1;
832 end Skip_To_Matching_Closing_Bracket;
834 -- Start of processing for Parse_Identifier_Info
836 begin
837 -- The identifier info looks like:
838 -- "38U9*Debug 12|36r6 36r19"
840 -- Extract the line, column and entity name information
842 Parse_Number (Ali, Ptr, E_Line);
844 if Ali (Ptr) > ' ' then
845 E_Type := Ali (Ptr);
846 Ptr := Ptr + 1;
847 end if;
849 -- Ignore some of the entities (labels,...)
851 case E_Type is
852 when 'l' | 'L' | 'q' =>
853 Parse_EOL (Ali, Ptr, Skip_Continuation_Line => True);
854 return;
856 when others =>
857 null;
858 end case;
860 Parse_Number (Ali, Ptr, E_Col);
862 E_Global := False;
863 if Ali (Ptr) >= ' ' then
864 E_Global := (Ali (Ptr) = '*');
865 Ptr := Ptr + 1;
866 end if;
868 Parse_Token (Ali, Ptr, E_Name);
870 -- Exit if the symbol does not match
871 -- or if we have a local symbol and we do not want it
873 if (not Local_Symbols and not E_Global)
874 or else (Pattern.Initialized
875 and then not Match (Ali (E_Name .. Ptr - 1), Pattern.Entity))
876 or else (E_Name >= Ptr)
877 then
878 Decl_Ref := Add_Declaration
879 (File.X_File, Ali (E_Name .. Ptr - 1), E_Line, E_Col, E_Type,
880 Remove_Only => True);
881 Parse_EOL (Ali, Ptr, Skip_Continuation_Line => True);
882 return;
883 end if;
885 -- Insert the declaration in the table
887 Decl_Ref := Add_Declaration
888 (File.X_File, Ali (E_Name .. Ptr - 1), E_Line, E_Col, E_Type);
890 if Ali (Ptr) = '[' then
891 Skip_To_Matching_Closing_Bracket;
892 end if;
894 if Ali (Ptr) = '<'
895 or else Ali (Ptr) = '('
896 or else Ali (Ptr) = '{'
897 then
898 -- Here we have a type derivation information. The format is
899 -- <3|12I45> which means that the current entity is derived from the
900 -- type defined in unit number 3, line 12 column 45. The pipe and
901 -- unit number is optional. It is specified only if the parent type
902 -- is not defined in the current unit.
904 -- We also have the format for generic instantiations, as in
905 -- 7a5*Uid(3|5I8[4|2]) 2|4r74
907 -- We could also have something like
908 -- 16I9*I<integer>
909 -- that indicates that I derives from the predefined type integer.
911 Ptr := Ptr + 1;
913 if Ali (Ptr) in '0' .. '9' then
914 Parse_Derived_Info : declare
915 P_Line : Natural; -- parent entity line
916 P_Column : Natural; -- parent entity column
917 P_Eun : Positive; -- parent entity file number
919 begin
920 Parse_Number (Ali, Ptr, P_Line);
922 -- If we have a pipe then the first number was the unit number
924 if Ali (Ptr) = '|' then
925 P_Eun := P_Line;
926 Ptr := Ptr + 1;
928 -- Now we have the line number
930 Parse_Number (Ali, Ptr, P_Line);
932 else
933 -- We don't have a unit number specified, so we set P_Eun to
934 -- the current unit.
936 for K in Dependencies_Tables.First .. Last (File.Dep) loop
937 P_Eun := K;
938 exit when File.Dep.Table (K) = File_Ref;
939 end loop;
940 end if;
942 -- Then parse the type and column number
944 Ptr := Ptr + 1;
945 Parse_Number (Ali, Ptr, P_Column);
947 -- Skip the information for generics instantiations
949 if Ali (Ptr) = '[' then
950 Skip_To_Matching_Closing_Bracket;
951 end if;
953 -- Skip '>', or ')' or '>'
955 Ptr := Ptr + 1;
957 -- The derived info is needed only is the derived info mode is
958 -- on or if we want to output the type hierarchy
960 if Der_Info or else Type_Tree then
961 declare
962 Symbol : constant String :=
963 Get_Symbol_Name (P_Eun, P_Line, P_Column);
964 begin
965 if Symbol /= "???" then
966 Add_Parent
967 (Decl_Ref,
968 Symbol,
969 P_Line,
970 P_Column,
971 File.Dep.Table (P_Eun));
972 end if;
973 end;
974 end if;
976 if Type_Tree
977 and then (Pattern.File_Ref = Empty_File
978 or else
979 Pattern.File_Ref = Current_Xref_File (File))
980 then
981 Search_Parent_Tree : declare
982 Pattern : Search_Pattern; -- Parent type pattern
983 File_Pos_Backup : Positive;
985 begin
986 Add_Entity
987 (Pattern,
988 Get_Symbol_Name (P_Eun, P_Line, P_Column)
989 & ':' & Get_Gnatchop_File (File.Dep.Table (P_Eun))
990 & ':' & Get_Line (Get_Parent (Decl_Ref))
991 & ':' & Get_Column (Get_Parent (Decl_Ref)),
992 False);
994 -- No default match is needed to look for the parent type
995 -- since we are using the fully qualified symbol name:
996 -- symbol:file:line:column
998 Set_Default_Match (False);
1000 -- The parent hierarchy is defined in the same unit as
1001 -- the derived type. So we want to revisit the unit.
1003 File_Pos_Backup := File.Current_Line;
1005 Skip_To_First_X_Line
1006 (File, D_Lines => False, W_Lines => False);
1008 while File.Buffer (File.Current_Line) /= EOF loop
1009 Parse_X_Filename (File);
1010 Parse_Identifier_Info
1011 (Pattern => Pattern,
1012 File => File,
1013 Local_Symbols => False,
1014 Der_Info => Der_Info,
1015 Type_Tree => True,
1016 Wide_Search => False,
1017 Labels_As_Ref => Labels_As_Ref);
1018 end loop;
1020 File.Current_Line := File_Pos_Backup;
1021 end Search_Parent_Tree;
1022 end if;
1023 end Parse_Derived_Info;
1025 else
1026 while Ali (Ptr) /= '>'
1027 and then Ali (Ptr) /= ')'
1028 and then Ali (Ptr) /= '}'
1029 loop
1030 Ptr := Ptr + 1;
1031 end loop;
1032 Ptr := Ptr + 1;
1033 end if;
1035 elsif Ali (Ptr) = '=' then
1036 declare
1037 P_Line, P_Column : Natural;
1039 begin
1040 Ptr := Ptr + 1;
1041 Parse_Number (Ali, Ptr, P_Line);
1042 Ptr := Ptr + 1;
1043 Parse_Number (Ali, Ptr, P_Column);
1044 end;
1045 end if;
1047 -- To find the body, we will have to parse the file too
1049 if Wide_Search then
1050 declare
1051 File_Ref : File_Reference;
1052 pragma Unreferenced (File_Ref);
1053 File_Name : constant String := Get_Gnatchop_File (File.X_File);
1054 begin
1055 File_Ref := Add_To_Xref_File (ALI_File_Name (File_Name), False);
1056 end;
1057 end if;
1059 -- Parse references to this entity.
1060 -- Ptr points to next reference with leading blanks
1062 loop
1063 -- Process references on current line
1065 while Ali (Ptr) = ' ' or Ali (Ptr) = ASCII.HT loop
1067 -- For every reference read the line, type and column,
1068 -- optionally preceded by a file number and a pipe symbol.
1070 Parse_Number (Ali, Ptr, R_Line);
1072 if Ali (Ptr) = Pipe then
1073 Ptr := Ptr + 1;
1074 File_Ref := File_Name (File, R_Line);
1076 Parse_Number (Ali, Ptr, R_Line);
1077 end if;
1079 if Ali (Ptr) > ' ' then
1080 R_Type := Ali (Ptr);
1081 Ptr := Ptr + 1;
1082 end if;
1084 -- Imported entities might special indication as to their external
1085 -- name:
1086 -- 5U14*Foo2 5>20 6b<c,myfoo2>22
1088 if R_Type = 'b'
1089 and then Ali (Ptr) = '<'
1090 then
1091 while Ptr <= Ali'Last
1092 and then Ali (Ptr) /= '>'
1093 loop
1094 Ptr := Ptr + 1;
1095 end loop;
1096 Ptr := Ptr + 1;
1097 end if;
1099 Parse_Number (Ali, Ptr, R_Col);
1101 -- Insert the reference or body in the table
1103 Add_Reference
1104 (Decl_Ref, File_Ref, R_Line, R_Col, R_Type, Labels_As_Ref);
1106 -- Skip generic information, if any
1108 if Ali (Ptr) = '[' then
1109 declare
1110 Num_Nested : Integer := 1;
1112 begin
1113 Ptr := Ptr + 1;
1114 while Num_Nested /= 0 loop
1115 if Ali (Ptr) = ']' then
1116 Num_Nested := Num_Nested - 1;
1117 elsif Ali (Ptr) = '[' then
1118 Num_Nested := Num_Nested + 1;
1119 end if;
1121 Ptr := Ptr + 1;
1122 end loop;
1123 end;
1124 end if;
1126 end loop;
1128 Parse_EOL (Ali, Ptr);
1130 -- Loop until new line is no continuation line
1132 exit when Ali (Ptr) /= '.';
1133 Ptr := Ptr + 1;
1134 end loop;
1135 end Parse_Identifier_Info;
1137 ------------------
1138 -- Parse_Number --
1139 ------------------
1141 procedure Parse_Number
1142 (Source : access String;
1143 Ptr : in out Positive;
1144 Number : out Natural)
1146 begin
1147 -- Skip separators
1149 while Source (Ptr) = ' ' or else Source (Ptr) = ASCII.HT loop
1150 Ptr := Ptr + 1;
1151 end loop;
1153 Number := 0;
1154 while Source (Ptr) in '0' .. '9' loop
1155 Number :=
1156 10 * Number + (Character'Pos (Source (Ptr)) - Character'Pos ('0'));
1157 Ptr := Ptr + 1;
1158 end loop;
1159 end Parse_Number;
1161 -----------------
1162 -- Parse_Token --
1163 -----------------
1165 procedure Parse_Token
1166 (Source : access String;
1167 Ptr : in out Positive;
1168 Token_Ptr : out Positive)
1170 In_Quotes : Character := ASCII.NUL;
1172 begin
1173 -- Skip separators
1175 while Source (Ptr) = ' ' or else Source (Ptr) = ASCII.HT loop
1176 Ptr := Ptr + 1;
1177 end loop;
1179 Token_Ptr := Ptr;
1181 -- Find end-of-token
1183 while (In_Quotes /= ASCII.NUL or else
1184 not (Source (Ptr) = ' '
1185 or else Source (Ptr) = ASCII.HT
1186 or else Source (Ptr) = '<'
1187 or else Source (Ptr) = '{'
1188 or else Source (Ptr) = '['
1189 or else Source (Ptr) = '='
1190 or else Source (Ptr) = '('))
1191 and then Source (Ptr) >= ' '
1192 loop
1193 -- Double-quotes are used for operators
1194 -- Simple-quotes are used for character constants, for instance when
1195 -- they are found in an enumeration type "type A is ('+', '-');"
1197 case Source (Ptr) is
1198 when '"' | ''' =>
1199 if In_Quotes = Source (Ptr) then
1200 In_Quotes := ASCII.NUL;
1201 elsif In_Quotes = ASCII.NUL then
1202 In_Quotes := Source (Ptr);
1203 end if;
1205 when others =>
1206 null;
1207 end case;
1209 Ptr := Ptr + 1;
1210 end loop;
1211 end Parse_Token;
1213 ----------------------
1214 -- Parse_X_Filename --
1215 ----------------------
1217 procedure Parse_X_Filename (File : in out ALI_File) is
1218 Ali : String_Access renames File.Buffer;
1219 Ptr : Positive renames File.Current_Line;
1220 File_Nr : Natural;
1222 begin
1223 while Ali (Ptr) = 'X' loop
1225 -- The current line is the start of a new Xref file section,
1226 -- whose format looks like:
1228 -- " X 1 debug.ads"
1230 -- Skip the X and read the file number for the new X_File
1232 Ptr := Ptr + 1;
1233 Parse_Number (Ali, Ptr, File_Nr);
1235 if File_Nr > 0 then
1236 File.X_File := File.Dep.Table (File_Nr);
1237 end if;
1239 Parse_EOL (Ali, Ptr);
1240 end loop;
1241 end Parse_X_Filename;
1243 --------------------
1244 -- Print_Gnatfind --
1245 --------------------
1247 procedure Print_Gnatfind
1248 (References : Boolean;
1249 Full_Path_Name : Boolean)
1251 Decls : constant Declaration_Array_Access := Get_Declarations;
1252 Decl : Declaration_Reference;
1253 Arr : Reference_Array_Access;
1255 procedure Print_Ref
1256 (Ref : Reference;
1257 Msg : String := " ");
1258 -- Print a reference, according to the extended tag of the output
1260 ---------------
1261 -- Print_Ref --
1262 ---------------
1264 procedure Print_Ref
1265 (Ref : Reference;
1266 Msg : String := " ")
1268 F : String_Access :=
1269 Osint.To_Host_File_Spec
1270 (Get_Gnatchop_File (Ref, Full_Path_Name));
1272 Buffer : constant String :=
1273 F.all &
1274 ":" & Get_Line (Ref) &
1275 ":" & Get_Column (Ref) &
1276 ": ";
1278 Num_Blanks : Integer := Longest_File_Name + 10 - Buffer'Length;
1280 begin
1281 Free (F);
1282 Num_Blanks := Integer'Max (0, Num_Blanks);
1283 Write_Line
1284 (Buffer
1285 & String'(1 .. Num_Blanks => ' ')
1286 & Msg & " " & Get_Symbol (Decl));
1288 if Get_Source_Line (Ref)'Length /= 0 then
1289 Write_Line (" " & Get_Source_Line (Ref));
1290 end if;
1291 end Print_Ref;
1293 -- Start of processing for Print_Gnatfind
1295 begin
1296 for D in Decls'Range loop
1297 Decl := Decls (D);
1299 if Match (Decl) then
1301 -- Output the declaration
1303 declare
1304 Parent : constant Declaration_Reference := Get_Parent (Decl);
1306 F : String_Access :=
1307 Osint.To_Host_File_Spec
1308 (Get_Gnatchop_File (Decl, Full_Path_Name));
1310 Buffer : constant String :=
1311 F.all &
1312 ":" & Get_Line (Decl) &
1313 ":" & Get_Column (Decl) &
1314 ": ";
1316 Num_Blanks : Integer := Longest_File_Name + 10 - Buffer'Length;
1318 begin
1319 Free (F);
1320 Num_Blanks := Integer'Max (0, Num_Blanks);
1321 Write_Line
1322 (Buffer & String'(1 .. Num_Blanks => ' ')
1323 & "(spec) " & Get_Symbol (Decl));
1325 if Parent /= Empty_Declaration then
1326 F := Osint.To_Host_File_Spec (Get_Gnatchop_File (Parent));
1327 Write_Line
1328 (Buffer & String'(1 .. Num_Blanks => ' ')
1329 & " derived from " & Get_Symbol (Parent)
1330 & " ("
1331 & F.all
1332 & ':' & Get_Line (Parent)
1333 & ':' & Get_Column (Parent) & ')');
1334 Free (F);
1335 end if;
1336 end;
1338 if Get_Source_Line (Decl)'Length /= 0 then
1339 Write_Line (" " & Get_Source_Line (Decl));
1340 end if;
1342 -- Output the body (sorted)
1344 Arr := Get_References (Decl, Get_Bodies => True);
1346 for R in Arr'Range loop
1347 Print_Ref (Arr (R), "(body)");
1348 end loop;
1350 Free (Arr);
1352 if References then
1353 Arr := Get_References
1354 (Decl, Get_Writes => True, Get_Reads => True);
1356 for R in Arr'Range loop
1357 Print_Ref (Arr (R));
1358 end loop;
1360 Free (Arr);
1361 end if;
1362 end if;
1363 end loop;
1364 end Print_Gnatfind;
1366 ------------------
1367 -- Print_Unused --
1368 ------------------
1370 procedure Print_Unused (Full_Path_Name : Boolean) is
1371 Decls : constant Declaration_Array_Access := Get_Declarations;
1372 Decl : Declaration_Reference;
1373 Arr : Reference_Array_Access;
1374 F : String_Access;
1376 begin
1377 for D in Decls'Range loop
1378 Decl := Decls (D);
1380 if References_Count
1381 (Decl, Get_Reads => True, Get_Writes => True) = 0
1382 then
1383 F := Osint.To_Host_File_Spec
1384 (Get_Gnatchop_File (Decl, Full_Path_Name));
1385 Write_Str (Get_Symbol (Decl)
1386 & " ("
1387 & Get_Full_Type (Decl)
1388 & ") "
1389 & F.all
1390 & ':'
1391 & Get_Line (Decl)
1392 & ':'
1393 & Get_Column (Decl));
1394 Free (F);
1396 -- Print the body if any
1398 Arr := Get_References (Decl, Get_Bodies => True);
1400 for R in Arr'Range loop
1401 F := Osint.To_Host_File_Spec
1402 (Get_Gnatchop_File (Arr (R), Full_Path_Name));
1403 Write_Str (' '
1404 & F.all
1405 & ':' & Get_Line (Arr (R))
1406 & ':' & Get_Column (Arr (R)));
1407 Free (F);
1408 end loop;
1410 Write_Eol;
1411 Free (Arr);
1412 end if;
1413 end loop;
1414 end Print_Unused;
1416 --------------
1417 -- Print_Vi --
1418 --------------
1420 procedure Print_Vi (Full_Path_Name : Boolean) is
1421 Tab : constant Character := ASCII.HT;
1422 Decls : constant Declaration_Array_Access :=
1423 Get_Declarations (Sorted => False);
1424 Decl : Declaration_Reference;
1425 Arr : Reference_Array_Access;
1426 F : String_Access;
1428 begin
1429 for D in Decls'Range loop
1430 Decl := Decls (D);
1432 F := Osint.To_Host_File_Spec (Get_File (Decl, Full_Path_Name));
1433 Write_Line (Get_Symbol (Decl) & Tab & F.all & Tab & Get_Line (Decl));
1434 Free (F);
1436 -- Print the body if any
1438 Arr := Get_References (Decl, Get_Bodies => True);
1440 for R in Arr'Range loop
1441 F := Osint.To_Host_File_Spec (Get_File (Arr (R), Full_Path_Name));
1442 Write_Line
1443 (Get_Symbol (Decl) & Tab & F.all & Tab & Get_Line (Arr (R)));
1444 Free (F);
1445 end loop;
1447 Free (Arr);
1449 -- Print the modifications
1451 Arr := Get_References (Decl, Get_Writes => True, Get_Reads => True);
1453 for R in Arr'Range loop
1454 F := Osint.To_Host_File_Spec (Get_File (Arr (R), Full_Path_Name));
1455 Write_Line
1456 (Get_Symbol (Decl) & Tab & F.all & Tab & Get_Line (Arr (R)));
1457 Free (F);
1458 end loop;
1460 Free (Arr);
1461 end loop;
1462 end Print_Vi;
1464 ----------------
1465 -- Print_Xref --
1466 ----------------
1468 procedure Print_Xref (Full_Path_Name : Boolean) is
1469 Decls : constant Declaration_Array_Access := Get_Declarations;
1470 Decl : Declaration_Reference;
1472 Margin : constant := 10;
1473 -- Column where file names start
1475 procedure New_Line80;
1476 -- Go to start of new line
1478 procedure Print80 (S : String);
1479 -- Print the text, respecting the 80 columns rule
1481 procedure Print_Ref (Line, Column : String);
1482 -- The beginning of the output is aligned on a column multiple of 9
1484 procedure Print_List
1485 (Decl : Declaration_Reference;
1486 Msg : String;
1487 Get_Reads : Boolean := False;
1488 Get_Writes : Boolean := False;
1489 Get_Bodies : Boolean := False);
1490 -- Print a list of references. If the list is not empty, Msg will
1491 -- be printed prior to the list.
1493 ----------------
1494 -- New_Line80 --
1495 ----------------
1497 procedure New_Line80 is
1498 begin
1499 Write_Eol;
1500 Write_Str (String'(1 .. Margin - 1 => ' '));
1501 end New_Line80;
1503 -------------
1504 -- Print80 --
1505 -------------
1507 procedure Print80 (S : String) is
1508 Align : Natural := Margin - (Integer (Column) mod Margin);
1510 begin
1511 if Align = Margin then
1512 Align := 0;
1513 end if;
1515 Write_Str (String'(1 .. Align => ' ') & S);
1516 end Print80;
1518 ---------------
1519 -- Print_Ref --
1520 ---------------
1522 procedure Print_Ref (Line, Column : String) is
1523 Line_Align : constant Integer := 4 - Line'Length;
1525 S : constant String := String'(1 .. Line_Align => ' ')
1526 & Line & ':' & Column;
1528 Align : Natural := Margin - (Integer (Output.Column) mod Margin);
1530 begin
1531 if Align = Margin then
1532 Align := 0;
1533 end if;
1535 if Integer (Output.Column) + Align + S'Length > 79 then
1536 New_Line80;
1537 Align := 0;
1538 end if;
1540 Write_Str (String'(1 .. Align => ' ') & S);
1541 end Print_Ref;
1543 ----------------
1544 -- Print_List --
1545 ----------------
1547 procedure Print_List
1548 (Decl : Declaration_Reference;
1549 Msg : String;
1550 Get_Reads : Boolean := False;
1551 Get_Writes : Boolean := False;
1552 Get_Bodies : Boolean := False)
1554 Arr : Reference_Array_Access :=
1555 Get_References
1556 (Decl,
1557 Get_Writes => Get_Writes,
1558 Get_Reads => Get_Reads,
1559 Get_Bodies => Get_Bodies);
1560 File : File_Reference := Empty_File;
1561 F : String_Access;
1563 begin
1564 if Arr'Length /= 0 then
1565 Write_Eol;
1566 Write_Str (Msg);
1567 end if;
1569 for R in Arr'Range loop
1570 if Get_File_Ref (Arr (R)) /= File then
1571 if File /= Empty_File then
1572 New_Line80;
1573 end if;
1575 File := Get_File_Ref (Arr (R));
1576 F := Osint.To_Host_File_Spec
1577 (Get_Gnatchop_File (Arr (R), Full_Path_Name));
1578 Write_Str (F.all & ' ');
1579 Free (F);
1580 end if;
1582 Print_Ref (Get_Line (Arr (R)), Get_Column (Arr (R)));
1583 end loop;
1585 Free (Arr);
1586 end Print_List;
1588 F : String_Access;
1590 -- Start of processing for Print_Xref
1592 begin
1593 for D in Decls'Range loop
1594 Decl := Decls (D);
1596 Write_Str (Get_Symbol (Decl));
1598 while Column < Type_Position loop
1599 Write_Char (' ');
1600 end loop;
1602 Write_Line (Get_Full_Type (Decl));
1604 Write_Parent_Info : declare
1605 Parent : constant Declaration_Reference := Get_Parent (Decl);
1607 begin
1608 if Parent /= Empty_Declaration then
1609 Write_Str (" Ptype: ");
1610 F := Osint.To_Host_File_Spec (Get_Gnatchop_File (Parent));
1611 Print80 (F.all);
1612 Free (F);
1613 Print_Ref (Get_Line (Parent), Get_Column (Parent));
1614 Print80 (" " & Get_Symbol (Parent));
1615 Write_Eol;
1616 end if;
1617 end Write_Parent_Info;
1619 Write_Str (" Decl: ");
1620 F := Osint.To_Host_File_Spec
1621 (Get_Gnatchop_File (Decl, Full_Path_Name));
1622 Print80 (F.all & ' ');
1623 Free (F);
1624 Print_Ref (Get_Line (Decl), Get_Column (Decl));
1626 Print_List
1627 (Decl, " Body: ", Get_Bodies => True);
1628 Print_List
1629 (Decl, " Modi: ", Get_Writes => True);
1630 Print_List
1631 (Decl, " Ref: ", Get_Reads => True);
1632 Write_Eol;
1633 end loop;
1634 end Print_Xref;
1636 ------------
1637 -- Search --
1638 ------------
1640 procedure Search
1641 (Pattern : Search_Pattern;
1642 Local_Symbols : Boolean;
1643 Wide_Search : Boolean;
1644 Read_Only : Boolean;
1645 Der_Info : Boolean;
1646 Type_Tree : Boolean)
1648 type String_Access is access String;
1649 procedure Free is new Unchecked_Deallocation (String, String_Access);
1651 ALIfile : ALI_File;
1652 File_Ref : File_Reference;
1653 Strip_Num : Natural := 0;
1654 Ali_Name : String_Access;
1656 begin
1657 -- If we want all the .ali files, then find them
1659 if Wide_Search then
1660 Find_ALI_Files;
1661 end if;
1663 loop
1664 -- Get the next unread ali file
1666 File_Ref := Next_Unvisited_File;
1668 exit when File_Ref = Empty_File;
1670 -- Find the ALI file to use. Most of the time, it will be the unit
1671 -- name, with a different extension. However, when dealing with
1672 -- separates the ALI file is in fact the parent's ALI file (and this
1673 -- is recursive, in case the parent itself is a separate).
1675 Strip_Num := 0;
1676 loop
1677 Free (Ali_Name);
1678 Ali_Name := new String'
1679 (Get_File (File_Ref, With_Dir => True, Strip => Strip_Num));
1681 -- Stripped too many things...
1683 if Ali_Name.all = "" then
1684 if Get_Emit_Warning (File_Ref) then
1685 Set_Standard_Error;
1686 Write_Line
1687 ("warning : file " & Get_File (File_Ref, With_Dir => True)
1688 & " not found");
1689 Set_Standard_Output;
1690 end if;
1691 Free (Ali_Name);
1692 exit;
1694 -- If not found, try the parent's ALI file (this is needed for
1695 -- separate units and subprograms).
1697 -- Reset the cached directory first, in case the separate's
1698 -- ALI file is not in the same directory.
1700 elsif not File_Exists (Ali_Name.all) then
1701 Strip_Num := Strip_Num + 1;
1702 Reset_Directory (File_Ref);
1704 -- Else we finally found it
1706 else
1707 exit;
1708 end if;
1709 end loop;
1711 -- If we had to get the parent's ALI, insert it in the list as usual.
1712 -- This is to avoid parsing it twice in case it has already been
1713 -- parsed.
1715 if Ali_Name /= null and then Strip_Num /= 0 then
1716 File_Ref := Add_To_Xref_File
1717 (File_Name => Ali_Name.all,
1718 Visited => False);
1720 -- Now that we have a file name, parse it to find any reference to
1721 -- the entity.
1723 elsif Ali_Name /= null
1724 and then (Read_Only or else Is_Writable_File (Ali_Name.all))
1725 then
1726 begin
1727 Open (Ali_Name.all, ALIfile);
1728 while ALIfile.Buffer (ALIfile.Current_Line) /= EOF loop
1729 Parse_X_Filename (ALIfile);
1730 Parse_Identifier_Info
1731 (Pattern, ALIfile, Local_Symbols,
1732 Der_Info, Type_Tree, Wide_Search, Labels_As_Ref => True);
1733 end loop;
1735 exception
1736 when No_Xref_Information =>
1737 if Get_Emit_Warning (File_Ref) then
1738 Set_Standard_Error;
1739 Write_Line
1740 ("warning : No cross-referencing information in "
1741 & Ali_Name.all);
1742 Set_Standard_Output;
1743 end if;
1744 end;
1745 end if;
1746 end loop;
1748 Free (Ali_Name);
1749 end Search;
1751 -----------------
1752 -- Search_Xref --
1753 -----------------
1755 procedure Search_Xref
1756 (Local_Symbols : Boolean;
1757 Read_Only : Boolean;
1758 Der_Info : Boolean)
1760 ALIfile : ALI_File;
1761 File_Ref : File_Reference;
1762 Null_Pattern : Search_Pattern;
1764 begin
1765 Null_Pattern.Initialized := False;
1767 loop
1768 -- Find the next unvisited file
1770 File_Ref := Next_Unvisited_File;
1771 exit when File_Ref = Empty_File;
1773 -- Search the object directories for the .ali file
1775 declare
1776 F : constant String := Get_File (File_Ref, With_Dir => True);
1778 begin
1779 if Read_Only or else Is_Writable_File (F) then
1780 Open (F, ALIfile, True);
1782 while ALIfile.Buffer (ALIfile.Current_Line) /= EOF loop
1783 Parse_X_Filename (ALIfile);
1784 Parse_Identifier_Info
1785 (Null_Pattern, ALIfile, Local_Symbols, Der_Info,
1786 Labels_As_Ref => False);
1787 end loop;
1788 end if;
1790 exception
1791 when No_Xref_Information => null;
1792 end;
1793 end loop;
1794 end Search_Xref;
1796 end Xref_Lib;