1 /* Utility to update paths from internal to external forms.
2 Copyright (C) 1997, 1998, 1999, 2000, 2001, 2002, 2003, 2004, 2005
3 Free Software Foundation, Inc.
5 This file is part of GCC.
7 GCC is free software; you can redistribute it and/or modify it under
8 the terms of the GNU Library General Public License as published by
9 the Free Software Foundation; either version 2 of the License, or (at
10 your option) any later version.
12 GCC is distributed in the hope that it will be useful,
13 but WITHOUT ANY WARRANTY; without even the implied warranty of
14 MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the GNU
15 Library General Public License for more details.
17 You should have received a copy of the GNU Library General Public
18 License along with GCC; see the file COPYING. If not, write to the Free
19 Software Foundation, Inc., 51 Franklin Street, Fifth Floor,
20 Boston, MA 02110-1301, USA. */
22 /* This file contains routines to update a path, both to canonicalize
23 the directory format and to handle any prefix translation.
25 This file must be compiled with -DPREFIX= to specify the "prefix"
26 value used by configure. If a filename does not begin with this
27 prefix, it will not be affected other than by directory canonicalization.
29 Each caller of 'update_path' may specify both a filename and
30 a translation prefix and consist of the name of the package that contains
31 the file ("@GCC", "@BINUTIL", "@GNU", etc).
33 If the prefix is not specified, the filename will only undergo
34 directory canonicalization.
36 If it is specified, the string given by PREFIX will be replaced
37 by the specified prefix (with a '@' in front unless the prefix begins
38 with a '$') and further translation will be done as follows
39 until none of the two conditions below are met:
41 1) If the filename begins with '@', the string between the '@' and
42 the end of the name or the first '/' or directory separator will
43 be considered a "key" and looked up as follows:
45 -- If this is a Win32 OS, then the Registry will be examined for
48 HKEY_LOCAL_MACHINE\SOFTWARE\Free Software Foundation\<KEY>
50 if found, that value will be used. <KEY> defaults to GCC version
51 string, but can be overridden at configuration time.
53 -- If not found (or not a Win32 OS), the environment variable
54 key_ROOT (the value of "key" concatenated with the constant "_ROOT")
55 is tried. If that fails, then PREFIX (see above) is used.
57 2) If the filename begins with a '$', the rest of the string up
58 to the end or the first '/' or directory separator will be used
59 as an environment variable, whose value will be returned.
61 Once all this is done, any '/' will be converted to DIR_SEPARATOR,
62 if they are different.
64 NOTE: using resolve_keyed_path under Win32 requires linking with
70 #include "coretypes.h"
72 #if defined(_WIN32) && defined(ENABLE_WIN32_REGISTRY)
77 static const char *std_prefix
= PREFIX
;
79 static const char *get_key_value (char *);
80 static char *translate_name (char *);
81 static char *save_string (const char *, int);
82 static void tr (char *, int, int);
84 #if defined(_WIN32) && defined(ENABLE_WIN32_REGISTRY)
85 static char *lookup_key (char *);
86 static HKEY reg_key
= (HKEY
) INVALID_HANDLE_VALUE
;
89 /* Given KEY, as above, return its value. */
92 get_key_value (char *key
)
94 const char *prefix
= 0;
97 #if defined(_WIN32) && defined(ENABLE_WIN32_REGISTRY)
98 prefix
= lookup_key (key
);
102 prefix
= getenv (temp
= concat (key
, "_ROOT", NULL
));
113 /* Return a copy of a string that has been placed in the heap. */
116 save_string (const char *s
, int len
)
118 char *result
= XNEWVEC (char, len
+ 1);
120 memcpy (result
, s
, len
);
125 #if defined(_WIN32) && defined(ENABLE_WIN32_REGISTRY)
127 #ifndef WIN32_REGISTRY_KEY
128 # define WIN32_REGISTRY_KEY BASEVER
131 /* Look up "key" in the registry, as above. */
134 lookup_key (char *key
)
141 if (reg_key
== (HKEY
) INVALID_HANDLE_VALUE
)
143 res
= RegOpenKeyExA (HKEY_LOCAL_MACHINE
, "SOFTWARE", 0,
146 if (res
== ERROR_SUCCESS
)
147 res
= RegOpenKeyExA (reg_key
, "Free Software Foundation", 0,
150 if (res
== ERROR_SUCCESS
)
151 res
= RegOpenKeyExA (reg_key
, WIN32_REGISTRY_KEY
, 0,
154 if (res
!= ERROR_SUCCESS
)
156 reg_key
= (HKEY
) INVALID_HANDLE_VALUE
;
162 dst
= xmalloc (size
);
164 res
= RegQueryValueExA (reg_key
, key
, 0, &type
, (LPBYTE
) dst
, &size
);
165 if (res
== ERROR_MORE_DATA
&& type
== REG_SZ
)
167 dst
= xrealloc (dst
, size
);
168 res
= RegQueryValueExA (reg_key
, key
, 0, &type
, (LPBYTE
) dst
, &size
);
171 if (type
!= REG_SZ
|| res
!= ERROR_SUCCESS
)
181 /* If NAME, a malloc-ed string, starts with a '@' or '$', apply the
182 translation rules above and return a newly malloc-ed name.
183 Otherwise, return the given name. */
186 translate_name (char *name
)
189 char *key
, *old_name
;
196 if (code
!= '@' && code
!= '$')
200 (name
[keylen
+ 1] != 0 && !IS_DIR_SEPARATOR (name
[keylen
+ 1]));
204 key
= (char *) alloca (keylen
+ 1);
205 strncpy (key
, &name
[1], keylen
);
210 prefix
= get_key_value (key
);
215 prefix
= getenv (key
);
220 /* We used to strip trailing DIR_SEPARATORs here, but that can
221 sometimes yield a result with no separator when one was coded
222 and intended by the user, causing two path components to run
226 name
= concat (prefix
, &name
[keylen
+ 1], NULL
);
233 /* In a NUL-terminated STRING, replace character C1 with C2 in-place. */
235 tr (char *string
, int c1
, int c2
)
245 /* Update PATH using KEY if PATH starts with PREFIX as a directory.
246 The returned string is always malloc-ed, and the caller is
247 responsible for freeing it. */
250 update_path (const char *path
, const char *key
)
253 const int len
= strlen (std_prefix
);
255 if (! strncmp (path
, std_prefix
, len
)
256 && (IS_DIR_SEPARATOR(path
[len
])
257 || path
[len
] == '\0')
260 bool free_key
= false;
264 key
= concat ("@", key
, NULL
);
268 result
= concat (key
, &path
[len
], NULL
);
271 result
= translate_name (result
);
274 result
= xstrdup (path
);
276 #ifndef ALWAYS_STRIP_DOTDOT
277 #define ALWAYS_STRIP_DOTDOT 0
288 /* Look for `/../' */
290 && IS_DIR_SEPARATOR (p
[2])
291 && (p
!= result
&& IS_DIR_SEPARATOR (p
[-1])))
294 if (!ALWAYS_STRIP_DOTDOT
&& access (result
, X_OK
) == 0)
301 /* We can't access the dir, so we won't be able to
302 access dir/.. either. Strip out `dir/../'. If `dir'
303 turns out to be `.', strip one more path component. */
308 while (dest
!= result
&& IS_DIR_SEPARATOR (*dest
))
310 while (dest
!= result
&& !IS_DIR_SEPARATOR (dest
[-1]))
313 while (dest
!= result
&& *dest
== '.');
314 /* If we have something like `./..' or `/..', don't
315 strip anything more. */
316 if (*dest
== '.' || IS_DIR_SEPARATOR (*dest
))
322 while (IS_DIR_SEPARATOR (*src
))
325 while ((*dest
++ = *src
++) != 0)
333 #ifdef UPDATE_PATH_HOST_CANONICALIZE
334 /* Perform host dependent canonicalization when needed. */
335 UPDATE_PATH_HOST_CANONICALIZE (result
);
338 #ifdef DIR_SEPARATOR_2
339 /* Convert DIR_SEPARATOR_2 to DIR_SEPARATOR. */
340 if (DIR_SEPARATOR_2
!= DIR_SEPARATOR
)
341 tr (result
, DIR_SEPARATOR_2
, DIR_SEPARATOR
);
344 #if defined (DIR_SEPARATOR) && !defined (DIR_SEPARATOR_2)
345 if (DIR_SEPARATOR
!= '/')
346 tr (result
, '/', DIR_SEPARATOR
);
352 /* Reset the standard prefix. */
354 set_std_prefix (const char *prefix
, int len
)
356 std_prefix
= save_string (prefix
, len
);