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

1.1     ! misho       1: /* Provide relocatable packages.
        !             2:    Copyright (C) 2003, 2005 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
        !            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 */

FreeBSD-CVSweb <freebsd-cvsweb@FreeBSD.org>