1 /* Utility to update paths from internal to external forms.
2 Copyright (C) 1997-2022 Free Software Foundation, Inc.
4 This file is part of GCC.
6 GCC is free software; you can redistribute it and/or modify it under
7 the terms of the GNU Library General Public License as published by
8 the Free Software Foundation; either version 3 of the License, or (at
9 your option) any later version.
11 GCC is distributed in the hope that it will be useful,
12 but WITHOUT ANY WARRANTY; without even the implied warranty of
13 MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the GNU
14 Library General Public License for more details.
16 You should have received a copy of the GNU Library General Public
17 License along with GCC; see the file COPYING3. If not see
18 <http://www.gnu.org/licenses/>. */
20 /* This file contains routines to update a path, both to canonicalize
21 the directory format and to handle any prefix translation.
23 This file must be compiled with -DPREFIX= to specify the "prefix"
24 value used by configure. If a filename does not begin with this
25 prefix, it will not be affected other than by directory canonicalization.
27 Each caller of 'update_path' may specify both a filename and
28 a translation prefix and consist of the name of the package that contains
29 the file ("@GCC", "@BINUTIL", "@GNU", etc).
31 If the prefix is not specified, the filename will only undergo
32 directory canonicalization.
34 If it is specified, the string given by PREFIX will be replaced
35 by the specified prefix (with a '@' in front unless the prefix begins
36 with a '$') and further translation will be done as follows
37 until none of the two conditions below are met:
39 1) If the filename begins with '@', the string between the '@' and
40 the end of the name or the first '/' or directory separator will
41 be considered a "key" and looked up as follows:
43 -- If this is a Win32 OS, then the Registry will be examined for
46 HKEY_LOCAL_MACHINE\SOFTWARE\Free Software Foundation\<KEY>
48 if found, that value will be used. <KEY> defaults to GCC version
49 string, but can be overridden at configuration time.
51 -- If not found (or not a Win32 OS), the environment variable
52 key_ROOT (the value of "key" concatenated with the constant "_ROOT")
53 is tried. If that fails, then PREFIX (see above) is used.
55 2) If the filename begins with a '$', the rest of the string up
56 to the end or the first '/' or directory separator will be used
57 as an environment variable, whose value will be returned.
59 Once all this is done, any '/' will be converted to DIR_SEPARATOR,
60 if they are different.
62 NOTE: using resolve_keyed_path under Win32 requires linking with
69 #include "coretypes.h"
70 #if defined(_WIN32) && defined(ENABLE_WIN32_REGISTRY)
71 #define WIN32_LEAN_AND_MEAN
75 #include "common/common-target.h"
77 #define untested() { fprintf (stderr, "@@#\n@@@:%s:%d:%s\n", __FILE__, __LINE__, __func__); }
79 static const char *std_prefix
= PREFIX
;
81 static const char *get_key_value (char *);
82 static char *translate_name (char *);
83 static char *save_string (const char *, int);
84 static void tr (char *, int, int);
86 #if defined(_WIN32) && defined(ENABLE_WIN32_REGISTRY)
87 static char *lookup_key (char *);
88 static HKEY reg_key
= (HKEY
) INVALID_HANDLE_VALUE
;
91 /* Given KEY, as above, return its value. */
94 get_key_value (char *key
)
96 const char *prefix
= 0;
99 #if defined(_WIN32) && defined(ENABLE_WIN32_REGISTRY)
100 prefix
= lookup_key (key
);
104 prefix
= getenv (temp
= concat (key
, "_ROOT", NULL
));
114 /* Return a copy of a string that has been placed in the heap. */
117 save_string (const char *s
, int len
)
119 char *result
= XNEWVEC (char, len
+ 1);
121 memcpy (result
, s
, len
);
126 #if defined(_WIN32) && defined(ENABLE_WIN32_REGISTRY)
128 #ifndef WIN32_REGISTRY_KEY
129 # define WIN32_REGISTRY_KEY BASEVER
132 /* Look up "key" in the registry, as above. */
135 lookup_key (char *key
)
142 if (reg_key
== (HKEY
) INVALID_HANDLE_VALUE
)
144 res
= RegOpenKeyExA (HKEY_LOCAL_MACHINE
, "SOFTWARE", 0,
147 if (res
== ERROR_SUCCESS
)
148 res
= RegOpenKeyExA (reg_key
, "Free Software Foundation", 0,
151 if (res
== ERROR_SUCCESS
)
152 res
= RegOpenKeyExA (reg_key
, WIN32_REGISTRY_KEY
, 0,
155 if (res
!= ERROR_SUCCESS
)
157 reg_key
= (HKEY
) INVALID_HANDLE_VALUE
;
163 dst
= XNEWVEC (char, size
);
165 res
= RegQueryValueExA (reg_key
, key
, 0, &type
, (LPBYTE
) dst
, &size
);
166 if (res
== ERROR_MORE_DATA
&& type
== REG_SZ
)
168 dst
= XRESIZEVEC (char, dst
, size
);
169 res
= RegQueryValueExA (reg_key
, key
, 0, &type
, (LPBYTE
) dst
, &size
);
172 if (type
!= REG_SZ
|| res
!= ERROR_SUCCESS
)
182 /* If NAME, a malloc-ed string, starts with a '@' or '$', apply the
183 translation rules above and return a newly malloc-ed name.
184 Otherwise, return the given name. */
187 translate_name (char *name
)
190 char *key
, *old_name
;
197 if (code
!= '@' && code
!= '$')
201 (name
[keylen
+ 1] != 0 && !IS_DIR_SEPARATOR (name
[keylen
+ 1]));
205 key
= (char *) alloca (keylen
+ 1);
206 memcpy (key
, &name
[1], keylen
);
211 prefix
= get_key_value (key
);
216 prefix
= getenv (key
);
221 /* We used to strip trailing DIR_SEPARATORs here, but that can
222 sometimes yield a result with no separator when one was coded
223 and intended by the user, causing two path components to run
227 name
= concat (prefix
, &name
[keylen
+ 1], NULL
);
234 /* In a NUL-terminated STRING, replace character C1 with C2 in-place. */
236 tr (char *string
, int c1
, int c2
)
246 /* Update PATH using KEY if PATH starts with PREFIX as a directory.
247 The returned string is always malloc-ed, and the caller is
248 responsible for freeing it. */
251 update_path (const char *path
, const char *key
)
254 const int len
= strlen (std_prefix
);
256 if (! filename_ncmp (path
, std_prefix
, len
)
257 && (IS_DIR_SEPARATOR (path
[len
])
258 || path
[len
] == '\0')
261 bool free_key
= false;
265 key
= concat ("@", key
, NULL
);
269 result
= concat (key
, &path
[len
], NULL
);
271 free (CONST_CAST (char *, key
));
272 result
= translate_name (result
);
275 result
= xstrdup (path
);
285 /* Look for `/../' */
287 && IS_DIR_SEPARATOR (p
[2])
288 && (p
!= result
&& IS_DIR_SEPARATOR (p
[-1])))
291 if (1 // sdcpp !targetm_common.always_strip_dotdot
292 && access (result
, X_OK
) == 0)
299 /* We can't access the dir, so we won't be able to
300 access dir/.. either. Strip out `dir/../'. If `dir'
301 turns out to be `.', strip one more path component. */
306 while (dest
!= result
&& IS_DIR_SEPARATOR (*dest
))
308 while (dest
!= result
&& !IS_DIR_SEPARATOR (dest
[-1]))
311 while (dest
!= result
&& *dest
== '.');
312 /* If we have something like `./..' or `/..', don't
313 strip anything more. */
314 if (*dest
== '.' || IS_DIR_SEPARATOR (*dest
))
320 while (IS_DIR_SEPARATOR (*src
))
323 while ((*dest
++ = *src
++) != 0)
331 #ifdef UPDATE_PATH_HOST_CANONICALIZE
332 /* Perform host dependent canonicalization when needed. */
333 UPDATE_PATH_HOST_CANONICALIZE (result
);
336 #ifdef DIR_SEPARATOR_2
337 /* Convert DIR_SEPARATOR_2 to DIR_SEPARATOR. */
338 if (DIR_SEPARATOR_2
!= DIR_SEPARATOR
)
339 tr (result
, DIR_SEPARATOR_2
, DIR_SEPARATOR
);
342 #if defined (DIR_SEPARATOR) && !defined (DIR_SEPARATOR_2)
343 if (DIR_SEPARATOR
!= '/')
344 tr (result
, '/', DIR_SEPARATOR
);
350 /* Reset the standard prefix. */
352 set_std_prefix (const char *prefix
, int len
)
354 std_prefix
= save_string (prefix
, len
);