Annotation of sql/pgsql/libltdl/loaders/dlopen.c, revision 1.1

1.1     ! moko        1: /* loader-dlopen.c --  dynamic linking with dlopen/dlsym
        !             2: 
        !             3:    Copyright (C) 1998, 1999, 2000, 2004, 2006,
        !             4:                  2007, 2008 Free Software Foundation, Inc.
        !             5:    Written by Thomas Tanner, 1998
        !             6: 
        !             7:    NOTE: The canonical source of this file is maintained with the
        !             8:    GNU Libtool package.  Report bugs to bug-libtool@gnu.org.
        !             9: 
        !            10: GNU Libltdl is free software; you can redistribute it and/or
        !            11: modify it under the terms of the GNU Lesser General Public
        !            12: License as published by the Free Software Foundation; either
        !            13: version 2 of the License, or (at your option) any later version.
        !            14: 
        !            15: As a special exception to the GNU Lesser General Public License,
        !            16: if you distribute this file as part of a program or library that
        !            17: is built using GNU Libtool, you may include this file under the
        !            18: same distribution terms that you use for the rest of that program.
        !            19: 
        !            20: GNU Libltdl is distributed in the hope that it will be useful,
        !            21: but WITHOUT ANY WARRANTY; without even the implied warranty of
        !            22: MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.  See the
        !            23: GNU Lesser General Public License for more details.
        !            24: 
        !            25: You should have received a copy of the GNU Lesser General Public
        !            26: License along with GNU Libltdl; see the file COPYING.LIB.  If not, a
        !            27: copy can be downloaded from  http://www.gnu.org/licenses/lgpl.html,
        !            28: or obtained by writing to the Free Software Foundation, Inc.,
        !            29: 51 Franklin Street, Fifth Floor, Boston, MA 02110-1301, USA.
        !            30: */
        !            31: 
        !            32: #include "lt__private.h"
        !            33: #include "lt_dlloader.h"
        !            34: 
        !            35: /* Use the preprocessor to rename non-static symbols to avoid namespace
        !            36:    collisions when the loader code is statically linked into libltdl.
        !            37:    Use the "<module_name>_LTX_" prefix so that the symbol addresses can
        !            38:    be fetched from the preloaded symbol list by lt_dlsym():  */
        !            39: #define get_vtable     dlopen_LTX_get_vtable
        !            40: 
        !            41: LT_BEGIN_C_DECLS
        !            42: LT_SCOPE lt_dlvtable *get_vtable (lt_user_data loader_data);
        !            43: LT_END_C_DECLS
        !            44: 
        !            45: 
        !            46: /* Boilerplate code to set up the vtable for hooking this loader into
        !            47:    libltdl's loader list:  */
        !            48: static int      vl_exit  (lt_user_data loader_data);
        !            49: static lt_module vm_open  (lt_user_data loader_data, const char *filename,
        !            50:                            lt_dladvise advise);
        !            51: static int      vm_close (lt_user_data loader_data, lt_module module);
        !            52: static void *   vm_sym   (lt_user_data loader_data, lt_module module,
        !            53:                          const char *symbolname);
        !            54: 
        !            55: static lt_dlvtable *vtable = 0;
        !            56: 
        !            57: /* Return the vtable for this loader, only the name and sym_prefix
        !            58:    attributes (plus the virtual function implementations, obviously)
        !            59:    change between loaders.  */
        !            60: lt_dlvtable *
        !            61: get_vtable (lt_user_data loader_data)
        !            62: {
        !            63:   if (!vtable)
        !            64:     {
        !            65:       vtable = (lt_dlvtable *) lt__zalloc (sizeof *vtable);
        !            66:     }
        !            67: 
        !            68:   if (vtable && !vtable->name)
        !            69:     {
        !            70:       vtable->name             = "lt_dlopen";
        !            71: #if defined(DLSYM_USCORE)
        !            72:       vtable->sym_prefix       = "_";
        !            73: #endif
        !            74:       vtable->module_open      = vm_open;
        !            75:       vtable->module_close     = vm_close;
        !            76:       vtable->find_sym         = vm_sym;
        !            77:       vtable->dlloader_exit    = vl_exit;
        !            78:       vtable->dlloader_data    = loader_data;
        !            79:       vtable->priority         = LT_DLLOADER_PREPEND;
        !            80:     }
        !            81: 
        !            82:   if (vtable && (vtable->dlloader_data != loader_data))
        !            83:     {
        !            84:       LT__SETERROR (INIT_LOADER);
        !            85:       return 0;
        !            86:     }
        !            87: 
        !            88:   return vtable;
        !            89: }
        !            90: 
        !            91: 
        !            92: 
        !            93: /* --- IMPLEMENTATION --- */
        !            94: 
        !            95: 
        !            96: #if defined(HAVE_DLFCN_H)
        !            97: #  include <dlfcn.h>
        !            98: #endif
        !            99: 
        !           100: #if defined(HAVE_SYS_DL_H)
        !           101: #  include <sys/dl.h>
        !           102: #endif
        !           103: 
        !           104: 
        !           105: /* We may have to define LT_LAZY_OR_NOW in the command line if we
        !           106:    find out it does not work in some platform. */
        !           107: #if !defined(LT_LAZY_OR_NOW)
        !           108: #  if defined(RTLD_LAZY)
        !           109: #    define LT_LAZY_OR_NOW     RTLD_LAZY
        !           110: #  else
        !           111: #    if defined(DL_LAZY)
        !           112: #      define LT_LAZY_OR_NOW   DL_LAZY
        !           113: #    endif
        !           114: #  endif /* !RTLD_LAZY */
        !           115: #endif
        !           116: #if !defined(LT_LAZY_OR_NOW)
        !           117: #  if defined(RTLD_NOW)
        !           118: #    define LT_LAZY_OR_NOW     RTLD_NOW
        !           119: #  else
        !           120: #    if defined(DL_NOW)
        !           121: #      define LT_LAZY_OR_NOW   DL_NOW
        !           122: #    endif
        !           123: #  endif /* !RTLD_NOW */
        !           124: #endif
        !           125: #if !defined(LT_LAZY_OR_NOW)
        !           126: #  define LT_LAZY_OR_NOW       0
        !           127: #endif /* !LT_LAZY_OR_NOW */
        !           128: 
        !           129: /* We only support local and global symbols from modules for loaders
        !           130:    that provide such a thing, otherwise the system default is used.  */
        !           131: #if !defined(RTLD_GLOBAL)
        !           132: #  if defined(DL_GLOBAL)
        !           133: #    define RTLD_GLOBAL                DL_GLOBAL
        !           134: #  endif
        !           135: #endif /* !RTLD_GLOBAL */
        !           136: #if !defined(RTLD_LOCAL)
        !           137: #  if defined(DL_LOCAL)
        !           138: #    define RTLD_LOCAL         DL_LOCAL
        !           139: #  endif
        !           140: #endif /* !RTLD_LOCAL */
        !           141: 
        !           142: #if defined(HAVE_DLERROR)
        !           143: #  define DLERROR(arg) dlerror ()
        !           144: #else
        !           145: #  define DLERROR(arg) LT__STRERROR (arg)
        !           146: #endif
        !           147: 
        !           148: #define DL__SETERROR(errorcode) \
        !           149:        LT__SETERRORSTR (DLERROR (errorcode))
        !           150: 
        !           151: 
        !           152: /* A function called through the vtable when this loader is no
        !           153:    longer needed by the application.  */
        !           154: static int
        !           155: vl_exit (lt_user_data LT__UNUSED loader_data)
        !           156: {
        !           157:   vtable = NULL;
        !           158:   return 0;
        !           159: }
        !           160: 
        !           161: 
        !           162: /* A function called through the vtable to open a module with this
        !           163:    loader.  Returns an opaque representation of the newly opened
        !           164:    module for processing with this loader's other vtable functions.  */
        !           165: static lt_module
        !           166: vm_open (lt_user_data LT__UNUSED loader_data, const char *filename,
        !           167:          lt_dladvise advise)
        !           168: {
        !           169:   int          module_flags = LT_LAZY_OR_NOW;
        !           170:   lt_module    module;
        !           171: 
        !           172:   if (advise)
        !           173:     {
        !           174: #ifdef RTLD_GLOBAL
        !           175:       /* If there is some means of asking for global symbol resolution,
        !           176:          do so.  */
        !           177:       if (advise->is_symglobal)
        !           178:         module_flags |= RTLD_GLOBAL;
        !           179: #else
        !           180:       /* Otherwise, reset that bit so the caller can tell it wasn't
        !           181:          acted on.  */
        !           182:       advise->is_symglobal = 0;
        !           183: #endif
        !           184: 
        !           185: /* And similarly for local only symbol resolution.  */
        !           186: #ifdef RTLD_LOCAL
        !           187:       if (advise->is_symlocal)
        !           188:         module_flags |= RTLD_LOCAL;
        !           189: #else
        !           190:       advise->is_symlocal = 0;
        !           191: #endif
        !           192:     }
        !           193: 
        !           194:   module = dlopen (filename, module_flags);
        !           195: 
        !           196:   if (!module)
        !           197:     {
        !           198:       DL__SETERROR (CANNOT_OPEN);
        !           199:     }
        !           200: 
        !           201:   return module;
        !           202: }
        !           203: 
        !           204: 
        !           205: /* A function called through the vtable when a particular module
        !           206:    should be unloaded.  */
        !           207: static int
        !           208: vm_close (lt_user_data LT__UNUSED loader_data, lt_module module)
        !           209: {
        !           210:   int errors = 0;
        !           211: 
        !           212:   if (dlclose (module) != 0)
        !           213:     {
        !           214:       DL__SETERROR (CANNOT_CLOSE);
        !           215:       ++errors;
        !           216:     }
        !           217: 
        !           218:   return errors;
        !           219: }
        !           220: 
        !           221: 
        !           222: /* A function called through the vtable to get the address of
        !           223:    a symbol loaded from a particular module.  */
        !           224: static void *
        !           225: vm_sym (lt_user_data LT__UNUSED loader_data, lt_module module, const char *name)
        !           226: {
        !           227:   void *address = dlsym (module, name);
        !           228: 
        !           229:   if (!address)
        !           230:     {
        !           231:       DL__SETERROR (SYMBOL_NOT_FOUND);
        !           232:     }
        !           233: 
        !           234:   return address;
        !           235: }

E-mail: