1 ------------------------------------------------------------------------------
3 -- GNAT COMPILER COMPONENTS --
5 -- G N A T . D I R E C T O R Y _ O P E R A T I O N S --
9 -- Copyright (C) 1998-2003 Ada Core Technologies, 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 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, 59 Temple Place - Suite 330, Boston, --
20 -- MA 02111-1307, USA. --
22 -- As a special exception, if other files instantiate generics from this --
23 -- unit, or you link this unit with other files to produce an executable, --
24 -- this unit does not by itself cause the resulting executable to be --
25 -- covered by the GNU General Public License. This exception does not --
26 -- however invalidate any other reasons why the executable file might be --
27 -- covered by the GNU Public License. --
29 -- GNAT was originally developed by the GNAT team at New York University. --
30 -- Extensive contributions were provided by Ada Core Technologies Inc. --
32 ------------------------------------------------------------------------------
34 with Ada.Characters.Handling;
35 with Ada.Strings.Fixed;
36 with Ada.Strings.Maps;
37 with Unchecked_Deallocation;
38 with Unchecked_Conversion;
39 with System; use System;
43 package body GNAT.Directory_Operations is
47 type Dir_Type_Value is new System.Address;
48 -- This is the low-level address directory structure as returned by the C
51 Filename_Max : constant Integer := 1024;
52 -- 1024 is the value of FILENAME_MAX in stdio.h
55 Unchecked_Deallocation (Dir_Type_Value, Dir_Type);
63 Suffix : String := "")
66 function Get_File_Names_Case_Sensitive return Integer;
68 (C, Get_File_Names_Case_Sensitive,
69 "__gnat_get_file_names_case_sensitive");
71 Case_Sensitive_File_Name : constant Boolean :=
72 Get_File_Names_Case_Sensitive = 1;
76 Suffix : String := "")
78 -- This function does the job. The only difference between Basename
79 -- and Base_Name (the parent function) is that the former is case
80 -- sensitive, while the latter is not. Path and Suffix are adjusted
81 -- appropriately before calling Basename under platforms where the
82 -- file system is not case sensitive.
90 Suffix : String := "")
93 Cut_Start : Natural :=
95 (Path, Dir_Seps, Going => Strings.Backward);
99 -- Cut_Start point to the first basename character
101 if Cut_Start = 0 then
102 Cut_Start := Path'First;
105 Cut_Start := Cut_Start + 1;
108 -- Cut_End point to the last basename character.
110 Cut_End := Path'Last;
112 -- If basename ends with Suffix, adjust Cut_End.
115 and then Path (Path'Last - Suffix'Length + 1 .. Cut_End) = Suffix
117 Cut_End := Path'Last - Suffix'Length;
120 Check_For_Standard_Dirs : declare
121 Offset : constant Integer := Path'First - Base_Name.Path'First;
122 BN : constant String :=
123 Base_Name.Path (Cut_Start - Offset .. Cut_End - Offset);
124 -- Here we use Base_Name.Path to keep the original casing
127 if BN = "." or else BN = ".." then
131 and then Characters.Handling.Is_Letter (BN (BN'First))
132 and then BN (BN'First + 1) = ':'
134 -- We have a DOS drive letter prefix, remove it
136 return BN (BN'First + 2 .. BN'Last);
141 end Check_For_Standard_Dirs;
144 -- Start processing for Base_Name
147 if Path'Length <= Suffix'Length then
151 if Case_Sensitive_File_Name then
152 return Basename (Path, Suffix);
155 (Characters.Handling.To_Lower (Path),
156 Characters.Handling.To_Lower (Suffix));
164 procedure Change_Dir (Dir_Name : Dir_Name_Str) is
165 C_Dir_Name : constant String := Dir_Name & ASCII.NUL;
167 function chdir (Dir_Name : String) return Integer;
168 pragma Import (C, chdir, "chdir");
171 if chdir (C_Dir_Name) /= 0 then
172 raise Directory_Error;
180 procedure Close (Dir : in out Dir_Type) is
182 function closedir (Directory : System.Address) return Integer;
183 pragma Import (C, closedir, "closedir");
186 pragma Warnings (Off, Discard);
189 if not Is_Open (Dir) then
190 raise Directory_Error;
193 Discard := closedir (System.Address (Dir.all));
201 function Dir_Name (Path : Path_Name) return Dir_Name_Str is
202 Last_DS : constant Natural :=
204 (Path, Dir_Seps, Going => Strings.Backward);
209 -- There is no directory separator, returns current working directory
211 return "." & Dir_Separator;
214 return Path (Path'First .. Last_DS);
224 Mode : Environment_Style := System_Default)
227 Environment_Variable_Char : Character;
228 pragma Import (C, Environment_Variable_Char, "__gnat_environment_char");
230 Result : OS_Lib.String_Access := new String (1 .. 200);
231 Result_Last : Natural := 0;
233 procedure Append (C : Character);
234 procedure Append (S : String);
237 procedure Double_Result_Size;
238 -- Reallocate Result, doubling its size
240 function Is_Var_Prefix (C : Character) return Boolean;
241 pragma Inline (Is_Var_Prefix);
243 procedure Read (K : in out Positive);
244 -- Update Result while reading current Path starting at position K. If
245 -- a variable is found, call Var below.
247 procedure Var (K : in out Positive);
248 -- Translate variable name starting at position K with the associated
249 -- environment value.
255 procedure Append (C : Character) is
257 if Result_Last = Result'Last then
261 Result_Last := Result_Last + 1;
262 Result (Result_Last) := C;
265 procedure Append (S : String) is
267 while Result_Last + S'Length - 1 > Result'Last loop
271 Result (Result_Last + 1 .. Result_Last + S'Length) := S;
272 Result_Last := Result_Last + S'Length;
275 ------------------------
276 -- Double_Result_Size --
277 ------------------------
279 procedure Double_Result_Size is
280 New_Result : constant OS_Lib.String_Access :=
281 new String (1 .. 2 * Result'Last);
284 New_Result (1 .. Result_Last) := Result (1 .. Result_Last);
285 OS_Lib.Free (Result);
286 Result := New_Result;
287 end Double_Result_Size;
293 function Is_Var_Prefix (C : Character) return Boolean is
295 return (C = Environment_Variable_Char and then Mode = System_Default)
297 (C = '$' and then (Mode = UNIX or else Mode = Both))
299 (C = '%' and then (Mode = DOS or else Mode = Both));
306 procedure Read (K : in out Positive) is
309 For_All_Characters : loop
310 if Is_Var_Prefix (Path (K)) then
313 -- Could be a variable
315 if K < Path'Last then
317 if Path (K + 1) = P then
319 -- Not a variable after all, this is a double $ or %,
320 -- just insert one in the result string.
326 -- Let's parse the variable
332 -- We have an ending $ or % sign
338 -- This is a standard character, just add it to the result
343 -- Skip to next character
347 exit For_All_Characters when K > Path'Last;
348 end loop For_All_Characters;
355 procedure Var (K : in out Positive) is
356 P : constant Character := Path (K);
363 if P = '%' or else Path (K) = '{' then
365 -- Set terminator character
374 -- Look for terminator character, k point to the first character
375 -- for the variable name.
381 exit when Path (E) = T or else E = Path'Last;
386 -- OK found, translate with environment value
389 Env : OS_Lib.String_Access :=
390 OS_Lib.Getenv (Path (K .. E - 1));
398 -- No terminator character, not a variable after all or a
399 -- syntax error, ignore it, insert string as-is.
401 Append (P); -- Add prefix character
403 if T = '}' then -- If we were looking for curly bracket
404 Append ('{'); -- terminator, add the curly bracket
407 Append (Path (K .. E));
411 -- The variable name is everything from current position to first
412 -- non letter/digit character.
416 -- Check that first chartacter is a letter
418 if Characters.Handling.Is_Letter (Path (E)) then
422 exit Var_Name when E > Path'Last;
424 if Characters.Handling.Is_Letter (Path (E))
425 or else Characters.Handling.Is_Digit (Path (E))
436 Env : OS_Lib.String_Access := OS_Lib.Getenv (Path (K .. E));
444 -- This is not a variable after all
455 -- Start of processing for Expand_Path
459 K : Positive := Path'First;
465 Returned_Value : constant String := Result (1 .. Result_Last);
468 OS_Lib.Free (Result);
469 return Returned_Value;
478 function File_Extension (Path : Path_Name) return String is
481 (Path, Dir_Seps, Going => Strings.Backward);
490 Dot := Strings.Fixed.Index (Path (First .. Path'Last),
492 Going => Strings.Backward);
494 if Dot = 0 or else Dot = Path'Last then
497 return Path (Dot .. Path'Last);
505 function File_Name (Path : Path_Name) return String is
507 return Base_Name (Path);
510 ---------------------
511 -- Format_Pathname --
512 ---------------------
514 function Format_Pathname
516 Style : Path_Style := System_Default)
519 N_Path : String := Path;
520 K : Positive := N_Path'First;
521 Prev_Dirsep : Boolean := False;
524 if Dir_Separator = '\'
525 and then Path'Length > 1
526 and then Path (K .. K + 1) = "\\"
529 N_Path (K .. K + 1) := "//";
535 for J in K .. Path'Last loop
536 if Strings.Maps.Is_In (Path (J), Dir_Seps) then
537 if not Prev_Dirsep then
539 when UNIX => N_Path (K) := '/';
540 when DOS => N_Path (K) := '\';
541 when System_Default => N_Path (K) := Dir_Separator;
550 N_Path (K) := Path (J);
552 Prev_Dirsep := False;
556 return N_Path (N_Path'First .. K - 1);
559 ---------------------
560 -- Get_Current_Dir --
561 ---------------------
564 pragma Import (C, Max_Path, "__gnat_max_path_len");
566 function Get_Current_Dir return Dir_Name_Str is
567 Current_Dir : String (1 .. Max_Path + 1);
571 Get_Current_Dir (Current_Dir, Last);
572 return Current_Dir (1 .. Last);
575 procedure Get_Current_Dir (Dir : out Dir_Name_Str; Last : out Natural) is
576 Path_Len : Natural := Max_Path;
577 Buffer : String (Dir'First .. Dir'First + Max_Path + 1);
579 procedure Local_Get_Current_Dir
580 (Dir : System.Address;
581 Length : System.Address);
582 pragma Import (C, Local_Get_Current_Dir, "__gnat_get_current_dir");
585 Local_Get_Current_Dir (Buffer'Address, Path_Len'Address);
587 if Dir'Length > Path_Len then
588 Last := Dir'First + Path_Len - 1;
593 Dir (Buffer'First .. Last) := Buffer (Buffer'First .. Last);
600 function Is_Open (Dir : Dir_Type) return Boolean is
602 return Dir /= Null_Dir
603 and then System.Address (Dir.all) /= System.Null_Address;
610 procedure Make_Dir (Dir_Name : Dir_Name_Str) is
611 C_Dir_Name : constant String := Dir_Name & ASCII.NUL;
613 function mkdir (Dir_Name : String) return Integer;
614 pragma Import (C, mkdir, "__gnat_mkdir");
617 if mkdir (C_Dir_Name) /= 0 then
618 raise Directory_Error;
628 Dir_Name : Dir_Name_Str)
630 C_File_Name : constant String := Dir_Name & ASCII.NUL;
634 return Dir_Type_Value;
635 pragma Import (C, opendir, "opendir");
638 Dir := new Dir_Type_Value'(opendir (C_File_Name));
640 if not Is_Open (Dir) then
643 raise Directory_Error;
652 (Dir : in out Dir_Type;
656 Filename_Addr : Address;
657 Filename_Len : Integer;
659 Buffer : array (0 .. Filename_Max + 12) of Character;
660 -- 12 is the size of the dirent structure (see dirent.h), without the
661 -- field for the filename.
663 function readdir_gnat
664 (Directory : System.Address;
665 Buffer : System.Address)
666 return System.Address;
667 pragma Import (C, readdir_gnat, "__gnat_readdir");
669 function strlen (S : Address) return Integer;
670 pragma Import (C, strlen, "strlen");
673 if not Is_Open (Dir) then
674 raise Directory_Error;
678 readdir_gnat (System.Address (Dir.all), Buffer'Address);
680 if Filename_Addr = System.Null_Address then
685 Filename_Len := strlen (Filename_Addr);
687 if Str'Length > Filename_Len then
688 Last := Str'First + Filename_Len - 1;
694 subtype Path_String is String (1 .. Filename_Len);
695 type Path_String_Access is access Path_String;
697 function Address_To_Access is new
700 Target => Path_String_Access);
702 Path_Access : constant Path_String_Access :=
703 Address_To_Access (Filename_Addr);
706 for J in Str'First .. Last loop
707 Str (J) := Path_Access (J - Str'First + 1);
712 -------------------------
713 -- Read_Is_Thread_Sage --
714 -------------------------
716 function Read_Is_Thread_Safe return Boolean is
718 function readdir_is_thread_safe return Integer;
720 (C, readdir_is_thread_safe, "__gnat_readdir_is_thread_safe");
723 return (readdir_is_thread_safe /= 0);
724 end Read_Is_Thread_Safe;
731 (Dir_Name : Dir_Name_Str;
732 Recursive : Boolean := False)
734 C_Dir_Name : constant String := Dir_Name & ASCII.NUL;
735 Current_Dir : constant Dir_Name_Str := Get_Current_Dir;
737 Str : String (1 .. Filename_Max);
739 Working_Dir : Dir_Type;
741 procedure rmdir (Dir_Name : String);
742 pragma Import (C, rmdir, "rmdir");
745 -- Remove the directory only if it is empty
747 if not Recursive then
750 if GNAT.OS_Lib.Is_Directory (Dir_Name) then
751 raise Directory_Error;
754 -- Remove directory and all files and directories that it may contain
757 Change_Dir (Dir_Name);
758 Open (Working_Dir, ".");
761 Read (Working_Dir, Str, Last);
764 if GNAT.OS_Lib.Is_Directory (Str (1 .. Last)) then
765 if Str (1 .. Last) /= "." and then Str (1 .. Last) /= ".." then
766 Remove_Dir (Str (1 .. Last), True);
767 Remove_Dir (Str (1 .. Last));
771 GNAT.OS_Lib.Delete_File (Str (1 .. Last), Success);
774 Change_Dir (Current_Dir);
775 raise Directory_Error;
780 Change_Dir (Current_Dir);
782 Remove_Dir (Dir_Name);
786 end GNAT.Directory_Operations;