Return to relocatable.h CVS log

Up to [ELWIX - Embedded LightWeight unIX -] / embedaddon / libiconv / srclib

Annotation of embedaddon/libiconv/srclib/relocatable.h, revision 1.1

1.1     ! misho       1: /* Provide relocatable packages.
        !             2:    Copyright (C) 2003, 2005, 2008 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 General Public License as published
        !             7:    by the Free Software Foundation; either version 3, 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 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:    The returned string is either PATHNAME unmodified or a freshly allocated
        !            54:    string that you can free with free() after casting it to 'char *'.  */
        !            55: extern const char * relocate (const char *pathname);
        !            56: 
        !            57: /* Memory management: relocate() potentially allocates memory, because it has
        !            58:    to construct a fresh pathname.  If this is a problem because your program
        !            59:    calls relocate() frequently, think about caching the result.  Or free the
        !            60:    return value if it was different from the argument pathname.  */
        !            61: 
        !            62: /* Convenience function:
        !            63:    Computes the current installation prefix, based on the original
        !            64:    installation prefix, the original installation directory of a particular
        !            65:    file, and the current pathname of this file.
        !            66:    Returns it, freshly allocated.  Returns NULL upon failure.  */
        !            67: extern char * compute_curr_prefix (const char *orig_installprefix,
        !            68:                                   const char *orig_installdir,
        !            69:                                   const char *curr_pathname);
        !            70: 
        !            71: #else
        !            72: 
        !            73: /* By default, we use the hardwired pathnames.  */
        !            74: #define relocate(pathname) (pathname)
        !            75: 
        !            76: #endif
        !            77: 
        !            78: 
        !            79: #ifdef __cplusplus
        !            80: }
        !            81: #endif
        !            82: 
        !            83: #endif /* _RELOCATABLE_H */