Home | History | Annotate | Line # | Download | only in intl 
      1 /* Provide relocatable packages.
      2    Copyright (C) 2003, 2005 Free Software Foundation, Inc.
      3    Written by Bruno Haible <bruno (at) 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
     17    Foundation, Inc., 51 Franklin Street, Fifth Floor, Boston, MA 02110-1301,
     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 HAVE_VISIBILITY && BUILDING_DLL
     35 # define RELOCATABLE_DLL_EXPORTED __attribute__((__visibility__("default")))
     36 #elif defined _MSC_VER && BUILDING_DLL
     37 # define RELOCATABLE_DLL_EXPORTED __declspec(dllexport)
     38 #else
     39 # define RELOCATABLE_DLL_EXPORTED
     40 #endif
     41 
     42 /* Sets the original and the current installation prefix of the package.
     43    Relocation simply replaces a pathname starting with the original prefix
     44    by the corresponding pathname with the current prefix instead.  Both
     45    prefixes should be directory names without trailing slash (i.e. use ""
     46    instead of "/").  */
     47 extern RELOCATABLE_DLL_EXPORTED void
     48        set_relocation_prefix (const char *orig_prefix,
     49 			      const char *curr_prefix);
     50 
     51 /* Returns the pathname, relocated according to the current installation
     52    directory.  */
     53 extern const char * relocate (const char *pathname);
     54 
     55 /* Memory management: relocate() leaks memory, because it has to construct
     56    a fresh pathname.  If this is a problem because your program calls
     57    relocate() frequently, think about caching the result.  */
     58 
     59 /* Convenience function:
     60    Computes the current installation prefix, based on the original
     61    installation prefix, the original installation directory of a particular
     62    file, and the current pathname of this file.  Returns NULL upon failure.  */
     63 extern const char * compute_curr_prefix (const char *orig_installprefix,
     64 					 const char *orig_installdir,
     65 					 const char *curr_pathname);
     66 
     67 #else
     68 
     69 /* By default, we use the hardwired pathnames.  */
     70 #define relocate(pathname) (pathname)
     71 
     72 #endif
     73 
     74 
     75 #ifdef __cplusplus
     76 }
     77 #endif
     78 
     79 #endif /* _RELOCATABLE_H */
     80