]>
Commit | Line | Data |
---|---|---|
b0cacab0 TT |
1 | /* Provide relocatable packages. |
2 | Copyright (C) 2003 Free Software Foundation, Inc. | |
3 | Written by Bruno Haible <bruno@clisp.org>, 2003. | |
4 | ||
5 | This program is free software; you can redistribute it and/or modify it | |
6 | under the terms of the GNU Library General Public License as published | |
7 | by the Free Software Foundation; either version 2, or (at your option) | |
8 | any later version. | |
9 | ||
10 | This program is distributed in the hope that it will be useful, | |
11 | but WITHOUT ANY WARRANTY; without even the implied warranty of | |
12 | MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the GNU | |
13 | Library General Public License for more details. | |
14 | ||
15 | You should have received a copy of the GNU Library General Public | |
16 | License along with this program; if not, write to the Free Software | |
8785aaea | 17 | Foundation, Inc., 51 Franklin Street, Fifth Floor, Boston, MA 02110-1301, |
b0cacab0 TT |
18 | USA. */ |
19 | ||
20 | #ifndef _RELOCATABLE_H | |
21 | #define _RELOCATABLE_H | |
22 | ||
23 | #ifdef __cplusplus | |
24 | extern "C" { | |
25 | #endif | |
26 | ||
27 | ||
28 | /* This can be enabled through the configure --enable-relocatable option. */ | |
29 | #if ENABLE_RELOCATABLE | |
30 | ||
31 | /* When building a DLL, we must export some functions. Note that because | |
32 | this is a private .h file, we don't need to use __declspec(dllimport) | |
33 | in any case. */ | |
34 | #if defined _MSC_VER && BUILDING_DLL | |
35 | # define RELOCATABLE_DLL_EXPORTED __declspec(dllexport) | |
36 | #else | |
37 | # define RELOCATABLE_DLL_EXPORTED | |
38 | #endif | |
39 | ||
40 | /* Sets the original and the current installation prefix of the package. | |
41 | Relocation simply replaces a pathname starting with the original prefix | |
42 | by the corresponding pathname with the current prefix instead. Both | |
43 | prefixes should be directory names without trailing slash (i.e. use "" | |
44 | instead of "/"). */ | |
45 | extern RELOCATABLE_DLL_EXPORTED void | |
46 | set_relocation_prefix (const char *orig_prefix, | |
47 | const char *curr_prefix); | |
48 | ||
49 | /* Returns the pathname, relocated according to the current installation | |
50 | directory. */ | |
51 | extern const char * relocate (const char *pathname); | |
52 | ||
53 | /* Memory management: relocate() leaks memory, because it has to construct | |
54 | a fresh pathname. If this is a problem because your program calls | |
55 | relocate() frequently, think about caching the result. */ | |
56 | ||
57 | /* Convenience function: | |
58 | Computes the current installation prefix, based on the original | |
59 | installation prefix, the original installation directory of a particular | |
60 | file, and the current pathname of this file. Returns NULL upon failure. */ | |
61 | extern const char * compute_curr_prefix (const char *orig_installprefix, | |
62 | const char *orig_installdir, | |
63 | const char *curr_pathname); | |
64 | ||
65 | #else | |
66 | ||
67 | /* By default, we use the hardwired pathnames. */ | |
68 | #define relocate(pathname) (pathname) | |
69 | ||
70 | #endif | |
71 | ||
72 | ||
73 | #ifdef __cplusplus | |
74 | } | |
75 | #endif | |
76 | ||
77 | #endif /* _RELOCATABLE_H */ |