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>