1 /* ltdl.c -- system independent dlopen wrapper
2 Copyright (C) 1998, 1999, 2000, 2004, 2005 Free Software Foundation, Inc.
3 Originally by Thomas Tanner <tanner@ffii.org>
4 This file is part of GNU Libtool.
6 This library is free software; you can redistribute it and/or
7 modify it under the terms of the GNU Lesser General Public
8 License as published by the Free Software Foundation; either
9 version 2 of the License, or (at your option) any later version.
11 As a special exception to the GNU Lesser General Public License,
12 if you distribute this file as part of a program or library that
13 is built using GNU libtool, you may include it under the same
14 distribution terms that you use for the rest of that program.
16 This library is distributed in the hope that it will be useful,
17 but WITHOUT ANY WARRANTY; without even the implied warranty of
18 MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the GNU
19 Lesser General Public License for more details.
21 You should have received a copy of the GNU Lesser General Public
22 License along with this library; if not, write to the Free Software
23 Foundation, Inc., 51 Franklin Street, Fifth Floor, Boston, MA
40 /* Include the header defining malloc. On K&R C compilers,
41 that's <malloc.h>, on ANSI C and ISO C compilers, that's <stdlib.h>. */
78 #undef LT_USE_POSIX_DIRENT
83 # define LT_USE_POSIX_DIRENT
84 # endif /* HAVE_DIRENT_H */
85 # endif /* HAVE_READDIR */
86 # endif /* HAVE_OPENDIR */
87 #endif /* HAVE_CLOSEDIR */
90 #undef LT_USE_WINDOWS_DIRENT_EMULATION
91 #ifndef LT_USE_POSIX_DIRENT
93 # define LT_USE_WINDOWS_DIRENT_EMULATION
94 # endif /* __WINDOWS__ */
95 #endif /* LT_USE_POSIX_DIRENT */
98 #ifdef LT_USE_POSIX_DIRENT
100 # define LT_D_NAMLEN(dirent) (strlen((dirent)->d_name))
102 # ifdef LT_USE_WINDOWS_DIRENT_EMULATION
103 # define LT_D_NAMLEN(dirent) (strlen((dirent)->d_name))
105 # define dirent direct
106 # define LT_D_NAMLEN(dirent) ((dirent)->d_namlen)
108 # include <sys/ndir.h>
111 # include <sys/dir.h>
126 # define assert(arg) ((void) 0)
132 # include <dmalloc.h>
138 /* --- WINDOWS SUPPORT --- */
142 # define LT_GLOBAL_DATA __declspec(dllexport)
144 # define LT_GLOBAL_DATA
147 /* fopen() mode flags for reading a text file */
148 #undef LT_READTEXT_MODE
150 # define LT_READTEXT_MODE "rt"
152 # define LT_READTEXT_MODE "r"
155 #ifdef LT_USE_WINDOWS_DIRENT_EMULATION
159 #define dirent lt_dirent
171 WIN32_FIND_DATA Win32FindData;
173 struct dirent file_info;
176 #endif /* LT_USE_WINDOWS_DIRENT_EMULATION */
179 /* --- MANIFEST CONSTANTS --- */
182 /* Standard libltdl search path environment variable name */
183 #undef LTDL_SEARCHPATH_VAR
184 #define LTDL_SEARCHPATH_VAR "LTDL_LIBRARY_PATH"
186 /* Standard libtool archive file extension. */
187 #undef LTDL_ARCHIVE_EXT
188 #define LTDL_ARCHIVE_EXT ".la"
190 /* max. filename length */
191 #ifndef LT_FILENAME_MAX
192 # define LT_FILENAME_MAX 1024
195 /* This is the maximum symbol size that won't require malloc/free */
196 #undef LT_SYMBOL_LENGTH
197 #define LT_SYMBOL_LENGTH 128
199 /* This accounts for the _LTX_ separator */
200 #undef LT_SYMBOL_OVERHEAD
201 #define LT_SYMBOL_OVERHEAD 5
206 /* --- MEMORY HANDLING --- */
209 /* These are the functions used internally. In addition to making
210 use of the associated function pointers above, they also perform
212 static char *lt_estrdup LT_PARAMS((const char *str));
213 static lt_ptr lt_emalloc LT_PARAMS((size_t size));
214 static lt_ptr lt_erealloc LT_PARAMS((lt_ptr addr, size_t size));
216 /* static lt_ptr rpl_realloc LT_PARAMS((lt_ptr ptr, size_t size)); */
217 #define rpl_realloc realloc
219 /* These are the pointers that can be changed by the caller: */
220 LT_GLOBAL_DATA lt_ptr (*lt_dlmalloc) LT_PARAMS((size_t size))
221 = (lt_ptr (*) LT_PARAMS((size_t))) malloc;
222 LT_GLOBAL_DATA lt_ptr (*lt_dlrealloc) LT_PARAMS((lt_ptr ptr, size_t size))
223 = (lt_ptr (*) LT_PARAMS((lt_ptr, size_t))) rpl_realloc;
224 LT_GLOBAL_DATA void (*lt_dlfree) LT_PARAMS((lt_ptr ptr))
225 = (void (*) LT_PARAMS((lt_ptr))) free;
227 /* The following macros reduce the amount of typing needed to cast
231 #define LT_DLMALLOC(tp, n) ((tp *) xmalloc ((n) * sizeof(tp)))
232 #define LT_DLREALLOC(tp, p, n) ((tp *) xrealloc ((p), (n) * sizeof(tp)))
233 #define LT_DLFREE(p) \
234 LT_STMT_START { if (p) (p) = (xfree (p), (lt_ptr) 0); } LT_STMT_END
236 #define LT_EMALLOC(tp, n) ((tp *) xmalloc ((n) * sizeof(tp)))
237 #define LT_EREALLOC(tp, p, n) ((tp *) xrealloc ((p), (n) * sizeof(tp)))
241 #define LT_DLMALLOC(tp, n) ((tp *) lt_dlmalloc ((n) * sizeof(tp)))
242 #define LT_DLREALLOC(tp, p, n) ((tp *) lt_dlrealloc ((p), (n) * sizeof(tp)))
243 #define LT_DLFREE(p) \
244 LT_STMT_START { if (p) (p) = (lt_dlfree (p), (lt_ptr) 0); } LT_STMT_END
246 #define LT_EMALLOC(tp, n) ((tp *) lt_emalloc ((n) * sizeof(tp)))
247 #define LT_EREALLOC(tp, p, n) ((tp *) lt_erealloc ((p), (n) * sizeof(tp)))
251 #define LT_DLMEM_REASSIGN(p, q) LT_STMT_START { \
252 if ((p) != (q)) { if (p) lt_dlfree (p); (p) = (q); (q) = 0; } \
256 /* --- REPLACEMENT FUNCTIONS --- */
260 #define strdup rpl_strdup
262 static char *strdup LT_PARAMS((const char *str));
272 tmp = LT_DLMALLOC (char, 1+ strlen (str));
286 #define strcmp rpl_strcmp
288 static int strcmp LT_PARAMS((const char *str1, const char *str2));
302 for (;*str1 && *str2; ++str1, ++str2)
308 return (int)(*str1 - *str2);
316 # define strchr index
318 # define strchr rpl_strchr
320 static const char *strchr LT_PARAMS((const char *str, int ch));
329 for (p = str; *p != (char)ch && *p != LT_EOS_CHAR; ++p)
332 return (*p == (char)ch) ? p : 0;
336 #endif /* !HAVE_STRCHR */
342 # define strrchr rindex
344 # define strrchr rpl_strrchr
346 static const char *strrchr LT_PARAMS((const char *str, int ch));
353 const char *p, *q = 0;
355 for (p = str; *p != LT_EOS_CHAR; ++p)
369 /* NOTE: Neither bcopy nor the memcpy implementation below can
370 reliably handle copying in overlapping areas of memory. Use
371 memmove (for which there is a fallback implmentation below)
372 if you need that behaviour. */
376 # define memcpy(dest, src, size) bcopy (src, dest, size)
378 # define memcpy rpl_memcpy
380 static lt_ptr memcpy LT_PARAMS((lt_ptr dest, const lt_ptr src, size_t size));
383 memcpy (dest, src, size)
388 const char * s = src;
392 for (i = 0; i < size; ++i)
400 # endif /* !HAVE_BCOPY */
401 #endif /* !HAVE_MEMCPY */
404 # define memmove rpl_memmove
406 static lt_ptr memmove LT_PARAMS((lt_ptr dest, const lt_ptr src, size_t size));
409 memmove (dest, src, size)
414 const char * s = src;
419 for (i = 0; i < size; ++i)
423 else if (d > s && size > 0)
424 for (i = size -1; ; --i)
434 #endif /* !HAVE_MEMMOVE */
436 #ifdef LT_USE_WINDOWS_DIRENT_EMULATION
438 static void closedir LT_PARAMS((DIR *entry));
444 assert(entry != (DIR *) NULL);
445 FindClose(entry->hSearch);
446 lt_dlfree((lt_ptr)entry);
450 static DIR * opendir LT_PARAMS((const char *path));
456 char file_specification[LT_FILENAME_MAX];
459 assert(path != (char *) NULL);
460 /* allow space for: path + '\\' '\\' '*' '.' '*' + '\0' */
461 (void) strncpy (file_specification, path, LT_FILENAME_MAX-6);
462 file_specification[LT_FILENAME_MAX-6] = LT_EOS_CHAR;
463 (void) strcat(file_specification,"\\");
464 entry = LT_DLMALLOC (DIR,sizeof(DIR));
465 if (entry != (DIR *) 0)
467 entry->firsttime = TRUE;
468 entry->hSearch = FindFirstFile(file_specification,&entry->Win32FindData);
470 if (entry->hSearch == INVALID_HANDLE_VALUE)
472 (void) strcat(file_specification,"\\*.*");
473 entry->hSearch = FindFirstFile(file_specification,&entry->Win32FindData);
474 if (entry->hSearch == INVALID_HANDLE_VALUE)
484 static struct dirent *readdir LT_PARAMS((DIR *entry));
486 static struct dirent *readdir(entry)
492 if (entry == (DIR *) 0)
493 return((struct dirent *) 0);
494 if (!entry->firsttime)
496 status = FindNextFile(entry->hSearch,&entry->Win32FindData);
498 return((struct dirent *) 0);
500 entry->firsttime = FALSE;
501 (void) strncpy(entry->file_info.d_name,entry->Win32FindData.cFileName,
503 entry->file_info.d_name[LT_FILENAME_MAX - 1] = LT_EOS_CHAR;
504 entry->file_info.d_namlen = strlen(entry->file_info.d_name);
505 return(&entry->file_info);
508 #endif /* LT_USE_WINDOWS_DIRENT_EMULATION */
510 /* According to Alexandre Oliva <oliva@lsd.ic.unicamp.br>,
511 ``realloc is not entirely portable''
512 In any case we want to use the allocator supplied by the user without
513 burdening them with an lt_dlrealloc function pointer to maintain.
514 Instead implement our own version (with known boundary conditions)
515 using lt_dlmalloc and lt_dlfree. */
518 #define realloc rpl_realloc
521 /* You can't (re)define realloc unless you also (re)define malloc.
522 Right now, this code uses the size of the *destination* to decide
523 how much to copy. That's not right, but you can't know the size
524 of the source unless you know enough about, or wrote malloc. So
525 this code is disabled... */
534 /* For zero or less bytes, free the original memory */
544 /* Allow reallocation of a NULL pointer. */
545 return lt_dlmalloc (size);
549 /* Allocate a new block, copy and free the old block. */
550 lt_ptr mem = lt_dlmalloc (size);
554 memcpy (mem, ptr, size);
558 /* Note that the contents of PTR are not damaged if there is
559 insufficient memory to realloc. */
566 #if ! HAVE_ARGZ_APPEND
567 # define argz_append rpl_argz_append
569 static error_t argz_append LT_PARAMS((char **pargz, size_t *pargz_len,
570 const char *buf, size_t buf_len));
573 argz_append (pargz, pargz_len, buf, buf_len)
584 assert ((*pargz && *pargz_len) || (!*pargz && !*pargz_len));
586 /* If nothing needs to be appended, no more work is required. */
590 /* Ensure there is enough room to append BUF_LEN. */
591 argz_len = *pargz_len + buf_len;
592 argz = LT_DLREALLOC (char, *pargz, argz_len);
596 /* Copy characters from BUF after terminating '\0' in ARGZ. */
597 memcpy (argz + *pargz_len, buf, buf_len);
599 /* Assign new values. */
601 *pargz_len = argz_len;
605 #endif /* !HAVE_ARGZ_APPEND */
608 #if ! HAVE_ARGZ_CREATE_SEP
609 # define argz_create_sep rpl_argz_create_sep
611 static error_t argz_create_sep LT_PARAMS((const char *str, int delim,
612 char **pargz, size_t *pargz_len));
615 argz_create_sep (str, delim, pargz, pargz_len)
628 /* Make a copy of STR, but replacing each occurrence of
630 argz_len = 1+ LT_STRLEN (str);
636 argz = LT_DLMALLOC (char, argz_len);
640 for (p = str, q = argz; *p != LT_EOS_CHAR; ++p)
644 /* Ignore leading delimiters, and fold consecutive
645 delimiters in STR into a single '\0' in ARGZ. */
646 if ((q > argz) && (q[-1] != LT_EOS_CHAR))
654 /* Copy terminating LT_EOS_CHAR. */
658 /* If ARGZ_LEN has shrunk to nothing, release ARGZ's memory. */
662 /* Assign new values. */
664 *pargz_len = argz_len;
668 #endif /* !HAVE_ARGZ_CREATE_SEP */
671 #if ! HAVE_ARGZ_INSERT
672 # define argz_insert rpl_argz_insert
674 static error_t argz_insert LT_PARAMS((char **pargz, size_t *pargz_len,
675 char *before, const char *entry));
678 argz_insert (pargz, pargz_len, before, entry)
686 assert (entry && *entry);
688 /* No BEFORE address indicates ENTRY should be inserted after the
689 current last element. */
691 return argz_append (pargz, pargz_len, entry, 1+ LT_STRLEN (entry));
693 /* This probably indicates a programmer error, but to preserve
694 semantics, scan back to the start of an entry if BEFORE points
695 into the middle of it. */
696 while ((before > *pargz) && (before[-1] != LT_EOS_CHAR))
700 size_t entry_len = 1+ LT_STRLEN (entry);
701 size_t argz_len = *pargz_len + entry_len;
702 size_t offset = before - *pargz;
703 char *argz = LT_DLREALLOC (char, *pargz, argz_len);
708 /* Make BEFORE point to the equivalent offset in ARGZ that it
709 used to have in *PARGZ incase realloc() moved the block. */
710 before = argz + offset;
712 /* Move the ARGZ entries starting at BEFORE up into the new
713 space at the end -- making room to copy ENTRY into the
715 memmove (before + entry_len, before, *pargz_len - offset);
716 memcpy (before, entry, entry_len);
718 /* Assign new values. */
720 *pargz_len = argz_len;
725 #endif /* !HAVE_ARGZ_INSERT */
729 # define argz_next rpl_argz_next
731 static char *argz_next LT_PARAMS((char *argz, size_t argz_len,
735 argz_next (argz, argz_len, entry)
740 assert ((argz && argz_len) || (!argz && !argz_len));
744 /* Either ARGZ/ARGZ_LEN is empty, or ENTRY points into an address
745 within the ARGZ vector. */
746 assert ((!argz && !argz_len)
747 || ((argz <= entry) && (entry < (argz + argz_len))));
749 /* Move to the char immediately after the terminating
751 entry = 1+ strchr (entry, LT_EOS_CHAR);
753 /* Return either the new ENTRY, or else NULL if ARGZ is
755 return (entry >= argz + argz_len) ? 0 : (char *) entry;
759 /* This should probably be flagged as a programmer error,
760 since starting an argz_next loop with the iterator set
761 to ARGZ is safer. To preserve semantics, handle the NULL
762 case by returning the start of ARGZ (if any). */
769 #endif /* !HAVE_ARGZ_NEXT */
773 #if ! HAVE_ARGZ_STRINGIFY
774 # define argz_stringify rpl_argz_stringify
776 static void argz_stringify LT_PARAMS((char *argz, size_t argz_len,
780 argz_stringify (argz, argz_len, sep)
785 assert ((argz && argz_len) || (!argz && !argz_len));
789 --argz_len; /* don't stringify the terminating EOS */
790 while (--argz_len > 0)
792 if (argz[argz_len] == LT_EOS_CHAR)
793 argz[argz_len] = sep;
797 #endif /* !HAVE_ARGZ_STRINGIFY */
802 /* --- TYPE DEFINITIONS -- */
805 /* This type is used for the array of caller data sets in each handler. */
814 /* --- OPAQUE STRUCTURES DECLARED IN LTDL.H --- */
817 /* Extract the diagnostic strings from the error table macro in the same
818 order as the enumerated indices in ltdl.h. */
820 static const char *lt_dlerror_strings[] =
822 #define LT_ERROR(name, diagnostic) (diagnostic),
829 /* This structure is used for the list of registered loaders. */
831 struct lt_dlloader *next;
832 const char *loader_name; /* identifying name for each loader */
833 const char *sym_prefix; /* prefix for symbols */
834 lt_module_open *module_open;
835 lt_module_close *module_close;
836 lt_find_sym *find_sym;
837 lt_dlloader_exit *dlloader_exit;
838 lt_user_data dlloader_data;
841 struct lt_dlhandle_struct {
842 struct lt_dlhandle_struct *next;
843 lt_dlloader *loader; /* dlopening interface */
845 int depcount; /* number of dependencies */
846 lt_dlhandle *deplibs; /* dependencies */
847 lt_module module; /* system module handle */
848 lt_ptr system; /* system specific data */
849 lt_caller_data *caller_data; /* per caller associated data */
850 int flags; /* various boolean stats */
853 /* Various boolean flags can be stored in the flags field of an
854 lt_dlhandle_struct... */
855 #define LT_DLGET_FLAG(handle, flag) (((handle)->flags & (flag)) == (flag))
856 #define LT_DLSET_FLAG(handle, flag) ((handle)->flags |= (flag))
858 #define LT_DLRESIDENT_FLAG (0x01 << 0)
859 /* ...add more flags here... */
861 #define LT_DLIS_RESIDENT(handle) LT_DLGET_FLAG(handle, LT_DLRESIDENT_FLAG)
864 #define LT_DLSTRERROR(name) lt_dlerror_strings[LT_CONC(LT_ERROR_,name)]
866 static const char objdir[] = LTDL_OBJDIR;
867 static const char archive_ext[] = LTDL_ARCHIVE_EXT;
868 #ifdef LTDL_SHLIB_EXT
869 static const char shlib_ext[] = LTDL_SHLIB_EXT;
871 #ifdef LTDL_SYSSEARCHPATH
872 static const char sys_search_path[] = LTDL_SYSSEARCHPATH;
878 /* --- MUTEX LOCKING --- */
881 /* Macros to make it easier to run the lock functions only if they have
882 been registered. The reason for the complicated lock macro is to
883 ensure that the stored error message from the last error is not
884 accidentally erased if the current function doesn't generate an
886 #define LT_DLMUTEX_LOCK() LT_STMT_START { \
887 if (lt_dlmutex_lock_func) (*lt_dlmutex_lock_func)(); \
889 #define LT_DLMUTEX_UNLOCK() LT_STMT_START { \
890 if (lt_dlmutex_unlock_func) (*lt_dlmutex_unlock_func)();\
892 #define LT_DLMUTEX_SETERROR(errormsg) LT_STMT_START { \
893 if (lt_dlmutex_seterror_func) \
894 (*lt_dlmutex_seterror_func) (errormsg); \
895 else lt_dllast_error = (errormsg); } LT_STMT_END
896 #define LT_DLMUTEX_GETERROR(errormsg) LT_STMT_START { \
897 if (lt_dlmutex_seterror_func) \
898 (errormsg) = (*lt_dlmutex_geterror_func) (); \
899 else (errormsg) = lt_dllast_error; } LT_STMT_END
901 /* The mutex functions stored here are global, and are necessarily the
902 same for all threads that wish to share access to libltdl. */
903 static lt_dlmutex_lock *lt_dlmutex_lock_func = 0;
904 static lt_dlmutex_unlock *lt_dlmutex_unlock_func = 0;
905 static lt_dlmutex_seterror *lt_dlmutex_seterror_func = 0;
906 static lt_dlmutex_geterror *lt_dlmutex_geterror_func = 0;
907 static const char *lt_dllast_error = 0;
910 /* Either set or reset the mutex functions. Either all the arguments must
911 be valid functions, or else all can be NULL to turn off locking entirely.
912 The registered functions should be manipulating a static global lock
913 from the lock() and unlock() callbacks, which needs to be reentrant. */
915 lt_dlmutex_register (lock, unlock, seterror, geterror)
916 lt_dlmutex_lock *lock;
917 lt_dlmutex_unlock *unlock;
918 lt_dlmutex_seterror *seterror;
919 lt_dlmutex_geterror *geterror;
921 lt_dlmutex_unlock *old_unlock = unlock;
924 /* Lock using the old lock() callback, if any. */
927 if ((lock && unlock && seterror && geterror)
928 || !(lock || unlock || seterror || geterror))
930 lt_dlmutex_lock_func = lock;
931 lt_dlmutex_unlock_func = unlock;
932 lt_dlmutex_geterror_func = geterror;
936 LT_DLMUTEX_SETERROR (LT_DLSTRERROR (INVALID_MUTEX_ARGS));
940 /* Use the old unlock() callback we saved earlier, if any. Otherwise
941 record any errors using internal storage. */
945 /* Return the number of errors encountered during the execution of
953 /* --- ERROR HANDLING --- */
956 static const char **user_error_strings = 0;
957 static int errorcount = LT_ERROR_MAX;
960 lt_dladderror (diagnostic)
961 const char *diagnostic;
965 const char **temp = (const char **) 0;
971 errindex = errorcount - LT_ERROR_MAX;
972 temp = LT_EREALLOC (const char *, user_error_strings, 1 + errindex);
975 user_error_strings = temp;
976 user_error_strings[errindex] = diagnostic;
977 result = errorcount++;
980 LT_DLMUTEX_UNLOCK ();
986 lt_dlseterror (errindex)
993 if (errindex >= errorcount || errindex < 0)
995 /* Ack! Error setting the error message! */
996 LT_DLMUTEX_SETERROR (LT_DLSTRERROR (INVALID_ERRORCODE));
999 else if (errindex < LT_ERROR_MAX)
1001 /* No error setting the error message! */
1002 LT_DLMUTEX_SETERROR (lt_dlerror_strings[errindex]);
1006 /* No error setting the error message! */
1007 LT_DLMUTEX_SETERROR (user_error_strings[errindex - LT_ERROR_MAX]);
1010 LT_DLMUTEX_UNLOCK ();
1019 lt_ptr mem = lt_dlmalloc (size);
1021 LT_DLMUTEX_SETERROR (LT_DLSTRERROR (NO_MEMORY));
1026 lt_erealloc (addr, size)
1030 lt_ptr mem = lt_dlrealloc (addr, size);
1032 LT_DLMUTEX_SETERROR (LT_DLSTRERROR (NO_MEMORY));
1040 char *copy = strdup (str);
1041 if (LT_STRLEN (str) && !copy)
1042 LT_DLMUTEX_SETERROR (LT_DLSTRERROR (NO_MEMORY));
1049 /* --- DLOPEN() INTERFACE LOADER --- */
1054 /* dynamic linking with dlopen/dlsym */
1061 # include <sys/dl.h>
1065 # define LT_GLOBAL RTLD_GLOBAL
1068 # define LT_GLOBAL DL_GLOBAL
1070 #endif /* !RTLD_GLOBAL */
1072 # define LT_GLOBAL 0
1073 #endif /* !LT_GLOBAL */
1075 /* We may have to define LT_LAZY_OR_NOW in the command line if we
1076 find out it does not work in some platform. */
1077 #ifndef LT_LAZY_OR_NOW
1079 # define LT_LAZY_OR_NOW RTLD_LAZY
1082 # define LT_LAZY_OR_NOW DL_LAZY
1084 # endif /* !RTLD_LAZY */
1086 #ifndef LT_LAZY_OR_NOW
1088 # define LT_LAZY_OR_NOW RTLD_NOW
1091 # define LT_LAZY_OR_NOW DL_NOW
1093 # endif /* !RTLD_NOW */
1095 #ifndef LT_LAZY_OR_NOW
1096 # define LT_LAZY_OR_NOW 0
1097 #endif /* !LT_LAZY_OR_NOW */
1100 # define DLERROR(arg) dlerror ()
1102 # define DLERROR(arg) LT_DLSTRERROR (arg)
1106 sys_dl_open (loader_data, filename)
1107 lt_user_data loader_data;
1108 const char *filename;
1110 lt_module module = dlopen (filename, LT_GLOBAL | LT_LAZY_OR_NOW);
1114 LT_DLMUTEX_SETERROR (DLERROR (CANNOT_OPEN));
1121 sys_dl_close (loader_data, module)
1122 lt_user_data loader_data;
1127 if (dlclose (module) != 0)
1129 LT_DLMUTEX_SETERROR (DLERROR (CANNOT_CLOSE));
1137 sys_dl_sym (loader_data, module, symbol)
1138 lt_user_data loader_data;
1142 lt_ptr address = dlsym (module, symbol);
1146 LT_DLMUTEX_SETERROR (DLERROR (SYMBOL_NOT_FOUND));
1152 static struct lt_user_dlloader sys_dl =
1159 sys_dl_open, sys_dl_close, sys_dl_sym, 0, 0 };
1162 #endif /* HAVE_LIBDL */
1166 /* --- SHL_LOAD() INTERFACE LOADER --- */
1170 /* dynamic linking with shl_load (HP-UX) (comments from gmodule) */
1176 /* some flags are missing on some systems, so we provide
1177 * harmless defaults.
1180 * BIND_IMMEDIATE - Resolve symbol references when the library is loaded.
1181 * BIND_DEFERRED - Delay code symbol resolution until actual reference.
1184 * BIND_FIRST - Place the library at the head of the symbol search
1186 * BIND_NONFATAL - The default BIND_IMMEDIATE behavior is to treat all
1187 * unsatisfied symbols as fatal. This flag allows
1188 * binding of unsatisfied code symbols to be deferred
1190 * [Perl: For certain libraries, like DCE, deferred
1191 * binding often causes run time problems. Adding
1192 * BIND_NONFATAL to BIND_IMMEDIATE still allows
1193 * unresolved references in situations like this.]
1194 * BIND_NOSTART - Do not call the initializer for the shared library
1195 * when the library is loaded, nor on a future call to
1197 * BIND_VERBOSE - Print verbose messages concerning possible
1198 * unsatisfied symbols.
1200 * hp9000s700/hp9000s800:
1201 * BIND_RESTRICTED - Restrict symbols visible by the library to those
1202 * present at library load time.
1203 * DYNAMIC_PATH - Allow the loader to dynamically search for the
1204 * library specified by the path argument.
1207 #ifndef DYNAMIC_PATH
1208 # define DYNAMIC_PATH 0
1210 #ifndef BIND_RESTRICTED
1211 # define BIND_RESTRICTED 0
1214 #define LT_BIND_FLAGS (BIND_IMMEDIATE | BIND_NONFATAL | DYNAMIC_PATH)
1217 sys_shl_open (loader_data, filename)
1218 lt_user_data loader_data;
1219 const char *filename;
1221 static shl_t self = (shl_t) 0;
1222 lt_module module = shl_load (filename, LT_BIND_FLAGS, 0L);
1224 /* Since searching for a symbol against a NULL module handle will also
1225 look in everything else that was already loaded and exported with
1226 the -E compiler flag, we always cache a handle saved before any
1227 modules are loaded. */
1231 shl_findsym (&self, "main", TYPE_UNDEFINED, &address);
1240 module = shl_load (filename, LT_BIND_FLAGS, 0L);
1244 LT_DLMUTEX_SETERROR (LT_DLSTRERROR (CANNOT_OPEN));
1252 sys_shl_close (loader_data, module)
1253 lt_user_data loader_data;
1258 if (module && (shl_unload ((shl_t) (module)) != 0))
1260 LT_DLMUTEX_SETERROR (LT_DLSTRERROR (CANNOT_CLOSE));
1268 sys_shl_sym (loader_data, module, symbol)
1269 lt_user_data loader_data;
1275 /* sys_shl_open should never return a NULL module handle */
1276 if (module == (lt_module) 0)
1278 LT_DLMUTEX_SETERROR (LT_DLSTRERROR (INVALID_HANDLE));
1280 else if (!shl_findsym((shl_t*) &module, symbol, TYPE_UNDEFINED, &address))
1284 LT_DLMUTEX_SETERROR (LT_DLSTRERROR (SYMBOL_NOT_FOUND));
1291 static struct lt_user_dlloader sys_shl = {
1292 0, sys_shl_open, sys_shl_close, sys_shl_sym, 0, 0
1295 #endif /* HAVE_SHL_LOAD */
1300 /* --- LOADLIBRARY() INTERFACE LOADER --- */
1304 /* dynamic linking for Win32 */
1306 #include <windows.h>
1308 /* Forward declaration; required to implement handle search below. */
1309 static lt_dlhandle handles;
1312 sys_wll_open (loader_data, filename)
1313 lt_user_data loader_data;
1314 const char *filename;
1317 lt_module module = 0;
1318 const char *errormsg = 0;
1319 char *searchname = 0;
1321 char self_name_buf[MAX_PATH];
1325 /* Get the name of main module */
1327 GetModuleFileName (NULL, self_name_buf, sizeof (self_name_buf));
1328 filename = ext = self_name_buf;
1332 ext = strrchr (filename, '.');
1337 /* FILENAME already has an extension. */
1338 searchname = lt_estrdup (filename);
1342 /* Append a `.' to stop Windows from adding an
1343 implicit `.dll' extension. */
1344 searchname = LT_EMALLOC (char, 2+ LT_STRLEN (filename));
1346 sprintf (searchname, "%s.", filename);
1352 /* Silence dialog from LoadLibrary on some failures.
1353 No way to get the error mode, but to set it,
1354 so set it twice to preserve any previous flags. */
1355 UINT errormode = SetErrorMode(SEM_FAILCRITICALERRORS);
1356 SetErrorMode(errormode | SEM_FAILCRITICALERRORS);
1358 #if defined(__CYGWIN__)
1360 char wpath[MAX_PATH];
1361 cygwin_conv_to_full_win32_path (searchname, wpath);
1362 module = LoadLibrary (wpath);
1365 module = LoadLibrary (searchname);
1368 /* Restore the error mode. */
1369 SetErrorMode(errormode);
1372 LT_DLFREE (searchname);
1374 /* libltdl expects this function to fail if it is unable
1375 to physically load the library. Sadly, LoadLibrary
1376 will search the loaded libraries for a match and return
1377 one of them if the path search load fails.
1379 We check whether LoadLibrary is returning a handle to
1380 an already loaded module, and simulate failure if we
1392 if (cur->module == module)
1399 LT_DLMUTEX_UNLOCK ();
1403 LT_DLMUTEX_SETERROR (LT_DLSTRERROR (CANNOT_OPEN));
1411 sys_wll_close (loader_data, module)
1412 lt_user_data loader_data;
1417 if (FreeLibrary(module) == 0)
1419 LT_DLMUTEX_SETERROR (LT_DLSTRERROR (CANNOT_CLOSE));
1427 sys_wll_sym (loader_data, module, symbol)
1428 lt_user_data loader_data;
1432 lt_ptr address = GetProcAddress (module, symbol);
1436 LT_DLMUTEX_SETERROR (LT_DLSTRERROR (SYMBOL_NOT_FOUND));
1442 static struct lt_user_dlloader sys_wll = {
1443 0, sys_wll_open, sys_wll_close, sys_wll_sym, 0, 0
1446 #endif /* __WINDOWS__ */
1451 /* --- LOAD_ADD_ON() INTERFACE LOADER --- */
1456 /* dynamic linking for BeOS */
1458 #include <kernel/image.h>
1461 sys_bedl_open (loader_data, filename)
1462 lt_user_data loader_data;
1463 const char *filename;
1469 image = load_add_on (filename);
1475 if (get_next_image_info (0, &cookie, &info) == B_OK)
1476 image = load_add_on (info.name);
1481 LT_DLMUTEX_SETERROR (LT_DLSTRERROR (CANNOT_OPEN));
1485 return (lt_module) image;
1489 sys_bedl_close (loader_data, module)
1490 lt_user_data loader_data;
1495 if (unload_add_on ((image_id) module) != B_OK)
1497 LT_DLMUTEX_SETERROR (LT_DLSTRERROR (CANNOT_CLOSE));
1505 sys_bedl_sym (loader_data, module, symbol)
1506 lt_user_data loader_data;
1511 image_id image = (image_id) module;
1513 if (get_image_symbol (image, symbol, B_SYMBOL_TYPE_ANY, address) != B_OK)
1515 LT_DLMUTEX_SETERROR (LT_DLSTRERROR (SYMBOL_NOT_FOUND));
1522 static struct lt_user_dlloader sys_bedl = {
1523 0, sys_bedl_open, sys_bedl_close, sys_bedl_sym, 0, 0
1526 #endif /* __BEOS__ */
1531 /* --- DLD_LINK() INTERFACE LOADER --- */
1536 /* dynamic linking with dld */
1543 sys_dld_open (loader_data, filename)
1544 lt_user_data loader_data;
1545 const char *filename;
1547 lt_module module = strdup (filename);
1549 if (dld_link (filename) != 0)
1551 LT_DLMUTEX_SETERROR (LT_DLSTRERROR (CANNOT_OPEN));
1560 sys_dld_close (loader_data, module)
1561 lt_user_data loader_data;
1566 if (dld_unlink_by_file ((char*)(module), 1) != 0)
1568 LT_DLMUTEX_SETERROR (LT_DLSTRERROR (CANNOT_CLOSE));
1580 sys_dld_sym (loader_data, module, symbol)
1581 lt_user_data loader_data;
1585 lt_ptr address = dld_get_func (symbol);
1589 LT_DLMUTEX_SETERROR (LT_DLSTRERROR (SYMBOL_NOT_FOUND));
1595 static struct lt_user_dlloader sys_dld = {
1596 0, sys_dld_open, sys_dld_close, sys_dld_sym, 0, 0
1599 #endif /* HAVE_DLD */
1601 /* --- DYLD() MACOSX/DARWIN INTERFACE LOADER --- */
1605 #if HAVE_MACH_O_DYLD_H
1606 #if !defined(__APPLE_CC__) && !defined(__MWERKS__) && !defined(__private_extern__)
1607 /* Is this correct? Does it still function properly? */
1608 #define __private_extern__ extern
1610 # include <mach-o/dyld.h>
1612 #include <mach-o/getsect.h>
1614 /* We have to put some stuff here that isn't in older dyld.h files */
1615 #ifndef ENUM_DYLD_BOOL
1616 # define ENUM_DYLD_BOOL
1625 # define LC_REQ_DYLD 0x80000000
1627 #ifndef LC_LOAD_WEAK_DYLIB
1628 # define LC_LOAD_WEAK_DYLIB (0x18 | LC_REQ_DYLD)
1630 static const struct mach_header * (*ltdl_NSAddImage)(const char *image_name, unsigned long options) = 0;
1631 static NSSymbol (*ltdl_NSLookupSymbolInImage)(const struct mach_header *image,const char *symbolName, unsigned long options) = 0;
1632 static enum DYLD_BOOL (*ltdl_NSIsSymbolNameDefinedInImage)(const struct mach_header *image, const char *symbolName) = 0;
1633 static enum DYLD_BOOL (*ltdl_NSMakePrivateModulePublic)(NSModule module) = 0;
1635 #ifndef NSADDIMAGE_OPTION_NONE
1636 #define NSADDIMAGE_OPTION_NONE 0x0
1638 #ifndef NSADDIMAGE_OPTION_RETURN_ON_ERROR
1639 #define NSADDIMAGE_OPTION_RETURN_ON_ERROR 0x1
1641 #ifndef NSADDIMAGE_OPTION_WITH_SEARCHING
1642 #define NSADDIMAGE_OPTION_WITH_SEARCHING 0x2
1644 #ifndef NSADDIMAGE_OPTION_RETURN_ONLY_IF_LOADED
1645 #define NSADDIMAGE_OPTION_RETURN_ONLY_IF_LOADED 0x4
1647 #ifndef NSADDIMAGE_OPTION_MATCH_FILENAME_BY_INSTALLNAME
1648 #define NSADDIMAGE_OPTION_MATCH_FILENAME_BY_INSTALLNAME 0x8
1650 #ifndef NSLOOKUPSYMBOLINIMAGE_OPTION_BIND
1651 #define NSLOOKUPSYMBOLINIMAGE_OPTION_BIND 0x0
1653 #ifndef NSLOOKUPSYMBOLINIMAGE_OPTION_BIND_NOW
1654 #define NSLOOKUPSYMBOLINIMAGE_OPTION_BIND_NOW 0x1
1656 #ifndef NSLOOKUPSYMBOLINIMAGE_OPTION_BIND_FULLY
1657 #define NSLOOKUPSYMBOLINIMAGE_OPTION_BIND_FULLY 0x2
1659 #ifndef NSLOOKUPSYMBOLINIMAGE_OPTION_RETURN_ON_ERROR
1660 #define NSLOOKUPSYMBOLINIMAGE_OPTION_RETURN_ON_ERROR 0x4
1665 lt_int_dyld_error(othererror)
1668 /* return the dyld error string, or the passed in error string if none */
1669 NSLinkEditErrors ler;
1673 NSLinkEditError(&ler,&lerno,&file,&errstr);
1674 if (!errstr || !strlen(errstr)) errstr = othererror;
1678 static const struct mach_header *
1679 lt_int_dyld_get_mach_header_from_nsmodule(module)
1682 /* There should probably be an apple dyld api for this */
1683 int i=_dyld_image_count();
1685 const char *modname=NSNameOfModule(module);
1686 const struct mach_header *mh=NULL;
1687 if (!modname) return NULL;
1688 for (j = 0; j < i; j++)
1690 if (!strcmp(_dyld_get_image_name(j),modname))
1692 mh=_dyld_get_image_header(j);
1699 static const char* lt_int_dyld_lib_install_name(mh)
1700 const struct mach_header *mh;
1702 /* NSAddImage is also used to get the loaded image, but it only works if the lib
1703 is installed, for uninstalled libs we need to check the install_names against
1704 each other. Note that this is still broken if DYLD_IMAGE_SUFFIX is set and a
1705 different lib was loaded as a result
1708 struct load_command *lc;
1709 unsigned long offset = sizeof(struct mach_header);
1710 const char* retStr=NULL;
1711 for (j = 0; j < mh->ncmds; j++)
1713 lc = (struct load_command*)(((unsigned long)mh) + offset);
1714 if (LC_ID_DYLIB == lc->cmd)
1716 retStr=(char*)(((struct dylib_command*)lc)->dylib.name.offset +
1719 offset += lc->cmdsize;
1724 static const struct mach_header *
1725 lt_int_dyld_match_loaded_lib_by_install_name(const char *name)
1727 int i=_dyld_image_count();
1729 const struct mach_header *mh=NULL;
1730 const char *id=NULL;
1731 for (j = 0; j < i; j++)
1733 id=lt_int_dyld_lib_install_name(_dyld_get_image_header(j));
1734 if ((id) && (!strcmp(id,name)))
1736 mh=_dyld_get_image_header(j);
1744 lt_int_dyld_NSlookupSymbolInLinkedLibs(symbol,mh)
1746 const struct mach_header *mh;
1748 /* Safe to assume our mh is good */
1750 struct load_command *lc;
1751 unsigned long offset = sizeof(struct mach_header);
1752 NSSymbol retSym = 0;
1753 const struct mach_header *mh1;
1754 if ((ltdl_NSLookupSymbolInImage) && NSIsSymbolNameDefined(symbol) )
1756 for (j = 0; j < mh->ncmds; j++)
1758 lc = (struct load_command*)(((unsigned long)mh) + offset);
1759 if ((LC_LOAD_DYLIB == lc->cmd) || (LC_LOAD_WEAK_DYLIB == lc->cmd))
1761 mh1=lt_int_dyld_match_loaded_lib_by_install_name((char*)(((struct dylib_command*)lc)->dylib.name.offset +
1762 (unsigned long)lc));
1765 /* Maybe NSAddImage can find it */
1766 mh1=ltdl_NSAddImage((char*)(((struct dylib_command*)lc)->dylib.name.offset +
1768 NSADDIMAGE_OPTION_RETURN_ONLY_IF_LOADED +
1769 NSADDIMAGE_OPTION_WITH_SEARCHING +
1770 NSADDIMAGE_OPTION_RETURN_ON_ERROR );
1774 retSym = ltdl_NSLookupSymbolInImage(mh1,
1776 NSLOOKUPSYMBOLINIMAGE_OPTION_BIND_NOW
1777 | NSLOOKUPSYMBOLINIMAGE_OPTION_RETURN_ON_ERROR
1782 offset += lc->cmdsize;
1793 if (!_dyld_present()) {
1797 err = _dyld_func_lookup("__dyld_NSAddImage",(unsigned long*)<dl_NSAddImage);
1798 err = _dyld_func_lookup("__dyld_NSLookupSymbolInImage",(unsigned long*)<dl_NSLookupSymbolInImage);
1799 err = _dyld_func_lookup("__dyld_NSIsSymbolNameDefinedInImage",(unsigned long*)<dl_NSIsSymbolNameDefinedInImage);
1800 err = _dyld_func_lookup("__dyld_NSMakePrivateModulePublic",(unsigned long*)<dl_NSMakePrivateModulePublic);
1806 sys_dyld_open (loader_data, filename)
1807 lt_user_data loader_data;
1808 const char *filename;
1810 lt_module module = 0;
1811 NSObjectFileImage ofi = 0;
1812 NSObjectFileImageReturnCode ofirc;
1815 return (lt_module)-1;
1816 ofirc = NSCreateObjectFileImageFromFile(filename, &ofi);
1819 case NSObjectFileImageSuccess:
1820 module = NSLinkModule(ofi, filename,
1821 NSLINKMODULE_OPTION_RETURN_ON_ERROR
1822 | NSLINKMODULE_OPTION_PRIVATE
1823 | NSLINKMODULE_OPTION_BINDNOW);
1824 NSDestroyObjectFileImage(ofi);
1826 ltdl_NSMakePrivateModulePublic(module);
1828 case NSObjectFileImageInappropriateFile:
1829 if (ltdl_NSIsSymbolNameDefinedInImage && ltdl_NSLookupSymbolInImage)
1831 module = (lt_module)ltdl_NSAddImage(filename, NSADDIMAGE_OPTION_RETURN_ON_ERROR);
1835 LT_DLMUTEX_SETERROR (lt_int_dyld_error(LT_DLSTRERROR(CANNOT_OPEN)));
1838 if (!module) LT_DLMUTEX_SETERROR (lt_int_dyld_error(LT_DLSTRERROR(CANNOT_OPEN)));
1843 sys_dyld_close (loader_data, module)
1844 lt_user_data loader_data;
1849 if (module == (lt_module)-1) return 0;
1850 #ifdef __BIG_ENDIAN__
1851 if (((struct mach_header *)module)->magic == MH_MAGIC)
1853 if (((struct mach_header *)module)->magic == MH_CIGAM)
1856 LT_DLMUTEX_SETERROR("Can not close a dylib");
1862 /* Currently, if a module contains c++ static destructors and it is unloaded, we
1863 get a segfault in atexit(), due to compiler and dynamic loader differences of
1864 opinion, this works around that.
1866 if ((const struct section *)NULL !=
1867 getsectbynamefromheader(lt_int_dyld_get_mach_header_from_nsmodule(module),
1868 "__DATA","__mod_term_func"))
1870 flags += NSUNLINKMODULE_OPTION_KEEP_MEMORY_MAPPED;
1874 flags += NSUNLINKMODULE_OPTION_RESET_LAZY_REFERENCES;
1876 if (!NSUnLinkModule(module,flags))
1879 LT_DLMUTEX_SETERROR (lt_int_dyld_error(LT_DLSTRERROR(CANNOT_CLOSE)));
1887 sys_dyld_sym (loader_data, module, symbol)
1888 lt_user_data loader_data;
1893 NSSymbol *nssym = 0;
1895 const struct mach_header *mh=NULL;
1896 char saveError[256] = "Symbol not found";
1897 if (module == (lt_module)-1)
1899 _dyld_lookup_and_bind(symbol,(unsigned long*)&address,&unused);
1902 #ifdef __BIG_ENDIAN__
1903 if (((struct mach_header *)module)->magic == MH_MAGIC)
1905 if (((struct mach_header *)module)->magic == MH_CIGAM)
1908 if (ltdl_NSIsSymbolNameDefinedInImage && ltdl_NSLookupSymbolInImage)
1911 if (ltdl_NSIsSymbolNameDefinedInImage((struct mach_header*)module,symbol))
1913 nssym = ltdl_NSLookupSymbolInImage((struct mach_header*)module,
1915 NSLOOKUPSYMBOLINIMAGE_OPTION_BIND_NOW
1916 | NSLOOKUPSYMBOLINIMAGE_OPTION_RETURN_ON_ERROR
1923 nssym = NSLookupSymbolInModule(module, symbol);
1927 strncpy(saveError, lt_int_dyld_error(LT_DLSTRERROR(SYMBOL_NOT_FOUND)), 255);
1929 if (!mh) mh=lt_int_dyld_get_mach_header_from_nsmodule(module);
1930 nssym = lt_int_dyld_NSlookupSymbolInLinkedLibs(symbol,mh);
1934 LT_DLMUTEX_SETERROR (saveError);
1937 return NSAddressOfSymbol(nssym);
1940 static struct lt_user_dlloader sys_dyld =
1941 { "_", sys_dyld_open, sys_dyld_close, sys_dyld_sym, 0, 0 };
1944 #endif /* HAVE_DYLD */
1947 /* --- DLPREOPEN() INTERFACE LOADER --- */
1950 /* emulate dynamic linking using preloaded_symbols */
1952 typedef struct lt_dlsymlists_t
1954 struct lt_dlsymlists_t *next;
1955 const lt_dlsymlist *syms;
1958 static const lt_dlsymlist *default_preloaded_symbols = 0;
1959 static lt_dlsymlists_t *preloaded_symbols = 0;
1962 presym_init (loader_data)
1963 lt_user_data loader_data;
1969 preloaded_symbols = 0;
1970 if (default_preloaded_symbols)
1972 errors = lt_dlpreload (default_preloaded_symbols);
1975 LT_DLMUTEX_UNLOCK ();
1981 presym_free_symlists ()
1983 lt_dlsymlists_t *lists;
1987 lists = preloaded_symbols;
1990 lt_dlsymlists_t *tmp = lists;
1992 lists = lists->next;
1995 preloaded_symbols = 0;
1997 LT_DLMUTEX_UNLOCK ();
2003 presym_exit (loader_data)
2004 lt_user_data loader_data;
2006 presym_free_symlists ();
2011 presym_add_symlist (preloaded)
2012 const lt_dlsymlist *preloaded;
2014 lt_dlsymlists_t *tmp;
2015 lt_dlsymlists_t *lists;
2020 lists = preloaded_symbols;
2023 if (lists->syms == preloaded)
2027 lists = lists->next;
2030 tmp = LT_EMALLOC (lt_dlsymlists_t, 1);
2033 memset (tmp, 0, sizeof(lt_dlsymlists_t));
2034 tmp->syms = preloaded;
2035 tmp->next = preloaded_symbols;
2036 preloaded_symbols = tmp;
2044 LT_DLMUTEX_UNLOCK ();
2049 presym_open (loader_data, filename)
2050 lt_user_data loader_data;
2051 const char *filename;
2053 lt_dlsymlists_t *lists;
2054 lt_module module = (lt_module) 0;
2057 lists = preloaded_symbols;
2061 LT_DLMUTEX_SETERROR (LT_DLSTRERROR (NO_SYMBOLS));
2065 /* Can't use NULL as the reflective symbol header, as NULL is
2066 used to mark the end of the entire symbol list. Self-dlpreopened
2067 symbols follow this magic number, chosen to be an unlikely
2068 clash with a real module name. */
2071 filename = "@PROGRAM@";
2076 const lt_dlsymlist *syms = lists->syms;
2080 if (!syms->address && strcmp(syms->name, filename) == 0)
2082 module = (lt_module) syms;
2088 lists = lists->next;
2091 LT_DLMUTEX_SETERROR (LT_DLSTRERROR (FILE_NOT_FOUND));
2094 LT_DLMUTEX_UNLOCK ();
2099 presym_close (loader_data, module)
2100 lt_user_data loader_data;
2103 /* Just to silence gcc -Wall */
2109 presym_sym (loader_data, module, symbol)
2110 lt_user_data loader_data;
2114 lt_dlsymlist *syms = (lt_dlsymlist*) module;
2117 while (syms->address)
2119 if (strcmp(syms->name, symbol) == 0)
2121 return syms->address;
2127 LT_DLMUTEX_SETERROR (LT_DLSTRERROR (SYMBOL_NOT_FOUND));
2132 static struct lt_user_dlloader presym = {
2133 0, presym_open, presym_close, presym_sym, presym_exit, 0
2140 /* --- DYNAMIC MODULE LOADING --- */
2143 /* The type of a function used at each iteration of foreach_dirinpath(). */
2144 typedef int foreach_callback_func LT_PARAMS((char *filename, lt_ptr data1,
2147 static int foreach_dirinpath LT_PARAMS((const char *search_path,
2148 const char *base_name,
2149 foreach_callback_func *func,
2150 lt_ptr data1, lt_ptr data2));
2152 static int find_file_callback LT_PARAMS((char *filename, lt_ptr data,
2154 static int find_handle_callback LT_PARAMS((char *filename, lt_ptr data,
2156 static int foreachfile_callback LT_PARAMS((char *filename, lt_ptr data1,
2160 static int canonicalize_path LT_PARAMS((const char *path,
2161 char **pcanonical));
2162 static int argzize_path LT_PARAMS((const char *path,
2164 size_t *pargz_len));
2165 static FILE *find_file LT_PARAMS((const char *search_path,
2166 const char *base_name,
2168 static lt_dlhandle *find_handle LT_PARAMS((const char *search_path,
2169 const char *base_name,
2170 lt_dlhandle *handle));
2171 static int find_module LT_PARAMS((lt_dlhandle *handle,
2175 const char *old_name,
2177 static int free_vars LT_PARAMS((char *dlname, char *oldname,
2178 char *libdir, char *deplibs));
2179 static int load_deplibs LT_PARAMS((lt_dlhandle handle,
2181 static int trim LT_PARAMS((char **dest,
2183 static int try_dlopen LT_PARAMS((lt_dlhandle *handle,
2184 const char *filename));
2185 static int tryall_dlopen LT_PARAMS((lt_dlhandle *handle,
2186 const char *filename));
2187 static int unload_deplibs LT_PARAMS((lt_dlhandle handle));
2188 static int lt_argz_insert LT_PARAMS((char **pargz,
2191 const char *entry));
2192 static int lt_argz_insertinorder LT_PARAMS((char **pargz,
2194 const char *entry));
2195 static int lt_argz_insertdir LT_PARAMS((char **pargz,
2198 struct dirent *dp));
2199 static int lt_dlpath_insertdir LT_PARAMS((char **ppath,
2202 static int list_files_by_dir LT_PARAMS((const char *dirnam,
2204 size_t *pargz_len));
2205 static int file_not_found LT_PARAMS((void));
2207 static char *user_search_path= 0;
2208 static lt_dlloader *loaders = 0;
2209 static lt_dlhandle handles = 0;
2210 static int initialized = 0;
2212 /* Initialize libltdl. */
2220 /* Initialize only at first call. */
2221 if (++initialized == 1)
2224 user_search_path = 0; /* empty search path */
2227 errors += lt_dlloader_add (lt_dlloader_next (0), &sys_dl, "dlopen");
2230 errors += lt_dlloader_add (lt_dlloader_next (0), &sys_shl, "dlopen");
2233 errors += lt_dlloader_add (lt_dlloader_next (0), &sys_wll, "dlopen");
2236 errors += lt_dlloader_add (lt_dlloader_next (0), &sys_bedl, "dlopen");
2239 errors += lt_dlloader_add (lt_dlloader_next (0), &sys_dld, "dld");
2242 errors += lt_dlloader_add (lt_dlloader_next (0), &sys_dyld, "dyld");
2243 errors += sys_dyld_init();
2245 errors += lt_dlloader_add (lt_dlloader_next (0), &presym, "dlpreload");
2247 if (presym_init (presym.dlloader_data))
2249 LT_DLMUTEX_SETERROR (LT_DLSTRERROR (INIT_LOADER));
2252 else if (errors != 0)
2254 LT_DLMUTEX_SETERROR (LT_DLSTRERROR (DLOPEN_NOT_SUPPORTED));
2259 LT_DLMUTEX_UNLOCK ();
2265 lt_dlpreload (preloaded)
2266 const lt_dlsymlist *preloaded;
2272 errors = presym_add_symlist (preloaded);
2276 presym_free_symlists();
2279 if (default_preloaded_symbols)
2281 errors = lt_dlpreload (default_preloaded_symbols);
2283 LT_DLMUTEX_UNLOCK ();
2290 lt_dlpreload_default (preloaded)
2291 const lt_dlsymlist *preloaded;
2294 default_preloaded_symbols = preloaded;
2295 LT_DLMUTEX_UNLOCK ();
2302 /* shut down libltdl */
2303 lt_dlloader *loader;
2311 LT_DLMUTEX_SETERROR (LT_DLSTRERROR (SHUTDOWN));
2316 /* shut down only at last call. */
2317 if (--initialized == 0)
2321 while (handles && LT_DLIS_RESIDENT (handles))
2323 handles = handles->next;
2326 /* close all modules */
2327 for (level = 1; handles; ++level)
2329 lt_dlhandle cur = handles;
2330 int saw_nonresident = 0;
2334 lt_dlhandle tmp = cur;
2336 if (!LT_DLIS_RESIDENT (tmp))
2337 saw_nonresident = 1;
2338 if (!LT_DLIS_RESIDENT (tmp) && tmp->info.ref_count <= level)
2340 if (lt_dlclose (tmp))
2346 /* done if only resident modules are left */
2347 if (!saw_nonresident)
2351 /* close all loaders */
2354 lt_dlloader *next = loader->next;
2355 lt_user_data data = loader->dlloader_data;
2356 if (loader->dlloader_exit && loader->dlloader_exit (data))
2361 LT_DLMEM_REASSIGN (loader, next);
2367 LT_DLMUTEX_UNLOCK ();
2372 tryall_dlopen (handle, filename)
2373 lt_dlhandle *handle;
2374 const char *filename;
2377 lt_dlloader *loader;
2378 const char *saved_error;
2381 LT_DLMUTEX_GETERROR (saved_error);
2387 /* check whether the module was already opened */
2390 /* try to dlopen the program itself? */
2391 if (!cur->info.filename && !filename)
2396 if (cur->info.filename && filename
2397 && strcmp (cur->info.filename, filename) == 0)
2407 ++cur->info.ref_count;
2415 /* Comment out the check of file permissions using access.
2416 This call seems to always return -1 with error EACCES.
2418 /* We need to catch missing file errors early so that
2419 file_not_found() can detect what happened.
2420 if (access (filename, R_OK) != 0)
2422 LT_DLMUTEX_SETERROR (LT_DLSTRERROR (FILE_NOT_FOUND));
2427 cur->info.filename = lt_estrdup (filename);
2428 if (!cur->info.filename)
2436 cur->info.filename = 0;
2441 lt_user_data data = loader->dlloader_data;
2443 cur->module = loader->module_open (data, filename);
2445 if (cur->module != 0)
2449 loader = loader->next;
2454 LT_DLFREE (cur->info.filename);
2459 cur->loader = loader;
2460 LT_DLMUTEX_SETERROR (saved_error);
2463 LT_DLMUTEX_UNLOCK ();
2469 tryall_dlopen_module (handle, prefix, dirname, dlname)
2470 lt_dlhandle *handle;
2472 const char *dirname;
2477 size_t filename_len = 0;
2478 size_t dirname_len = LT_STRLEN (dirname);
2483 #ifdef LT_DIRSEP_CHAR
2484 /* Only canonicalized names (i.e. with DIRSEP chars already converted)
2485 should make it into this function: */
2486 assert (strchr (dirname, LT_DIRSEP_CHAR) == 0);
2489 if (dirname_len > 0)
2490 if (dirname[dirname_len -1] == '/')
2492 filename_len = dirname_len + 1 + LT_STRLEN (dlname);
2494 /* Allocate memory, and combine DIRNAME and MODULENAME into it.
2495 The PREFIX (if any) is handled below. */
2496 filename = LT_EMALLOC (char, dirname_len + 1 + filename_len + 1);
2500 sprintf (filename, "%.*s/%s", (int) dirname_len, dirname, dlname);
2502 /* Now that we have combined DIRNAME and MODULENAME, if there is
2503 also a PREFIX to contend with, simply recurse with the arguments
2504 shuffled. Otherwise, attempt to open FILENAME as a module. */
2507 error += tryall_dlopen_module (handle,
2508 (const char *) 0, prefix, filename);
2510 else if (tryall_dlopen (handle, filename) != 0)
2515 LT_DLFREE (filename);
2520 find_module (handle, dir, libdir, dlname, old_name, installed)
2521 lt_dlhandle *handle;
2525 const char *old_name;
2528 /* Try to open the old library first; if it was dlpreopened,
2529 we want the preopened version of it, even if a dlopenable
2530 module is available. */
2531 if (old_name && tryall_dlopen (handle, old_name) == 0)
2536 /* Try to open the dynamic library. */
2539 /* try to open the installed module */
2540 if (installed && libdir)
2542 if (tryall_dlopen_module (handle,
2543 (const char *) 0, libdir, dlname) == 0)
2547 /* try to open the not-installed module */
2550 if (tryall_dlopen_module (handle, dir, objdir, dlname) == 0)
2554 /* maybe it was moved to another directory */
2556 if (dir && (tryall_dlopen_module (handle,
2557 (const char *) 0, dir, dlname) == 0))
2567 canonicalize_path (path, pcanonical)
2571 char *canonical = 0;
2573 assert (path && *path);
2574 assert (pcanonical);
2576 canonical = LT_EMALLOC (char, 1+ LT_STRLEN (path));
2583 for (src = 0; path[src] != LT_EOS_CHAR; ++src)
2585 /* Path separators are not copied to the beginning or end of
2586 the destination, or if another separator would follow
2588 if (path[src] == LT_PATHSEP_CHAR)
2591 || (path[1+ src] == LT_PATHSEP_CHAR)
2592 || (path[1+ src] == LT_EOS_CHAR))
2596 /* Anything other than a directory separator is copied verbatim. */
2597 if ((path[src] != '/')
2598 #ifdef LT_DIRSEP_CHAR
2599 && (path[src] != LT_DIRSEP_CHAR)
2603 canonical[dest++] = path[src];
2605 /* Directory separators are converted and copied only if they are
2606 not at the end of a path -- i.e. before a path separator or
2608 else if ((path[1+ src] != LT_PATHSEP_CHAR)
2609 && (path[1+ src] != LT_EOS_CHAR)
2610 #ifdef LT_DIRSEP_CHAR
2611 && (path[1+ src] != LT_DIRSEP_CHAR)
2613 && (path[1+ src] != '/'))
2615 canonical[dest++] = '/';
2619 /* Add an end-of-string marker at the end. */
2620 canonical[dest] = LT_EOS_CHAR;
2623 /* Assign new value. */
2624 *pcanonical = canonical;
2630 argzize_path (path, pargz, pargz_len)
2641 if ((error = argz_create_sep (path, LT_PATHSEP_CHAR, pargz, pargz_len)))
2646 LT_DLMUTEX_SETERROR (LT_DLSTRERROR (NO_MEMORY));
2649 LT_DLMUTEX_SETERROR (LT_DLSTRERROR (UNKNOWN));
2659 /* Repeatedly call FUNC with each LT_PATHSEP_CHAR delimited element
2660 of SEARCH_PATH and references to DATA1 and DATA2, until FUNC returns
2661 non-zero or all elements are exhausted. If BASE_NAME is non-NULL,
2662 it is appended to each SEARCH_PATH element before FUNC is called. */
2664 foreach_dirinpath (search_path, base_name, func, data1, data2)
2665 const char *search_path;
2666 const char *base_name;
2667 foreach_callback_func *func;
2672 int filenamesize = 0;
2673 size_t lenbase = LT_STRLEN (base_name);
2674 size_t argz_len = 0;
2677 char *canonical = 0;
2681 if (!search_path || !*search_path)
2683 LT_DLMUTEX_SETERROR (LT_DLSTRERROR (FILE_NOT_FOUND));
2687 if (canonicalize_path (search_path, &canonical) != 0)
2690 if (argzize_path (canonical, &argz, &argz_len) != 0)
2695 while ((dir_name = argz_next (argz, argz_len, dir_name)))
2697 size_t lendir = LT_STRLEN (dir_name);
2699 if (lendir +1 +lenbase >= filenamesize)
2701 LT_DLFREE (filename);
2702 filenamesize = lendir +1 +lenbase +1; /* "/d" + '/' + "f" + '\0' */
2703 filename = LT_EMALLOC (char, filenamesize);
2708 assert (filenamesize > lendir);
2709 strcpy (filename, dir_name);
2711 if (base_name && *base_name)
2713 if (filename[lendir -1] != '/')
2714 filename[lendir++] = '/';
2715 strcpy (filename +lendir, base_name);
2718 if ((result = (*func) (filename, data1, data2)))
2727 LT_DLFREE (canonical);
2728 LT_DLFREE (filename);
2730 LT_DLMUTEX_UNLOCK ();
2735 /* If FILEPATH can be opened, store the name of the directory component
2736 in DATA1, and the opened FILE* structure address in DATA2. Otherwise
2737 DATA1 is unchanged, but DATA2 is set to a pointer to NULL. */
2739 find_file_callback (filename, data1, data2)
2744 char **pdir = (char **) data1;
2745 FILE **pfile = (FILE **) data2;
2748 assert (filename && *filename);
2752 if ((*pfile = fopen (filename, LT_READTEXT_MODE)))
2754 char *dirend = strrchr (filename, '/');
2756 if (dirend > filename)
2757 *dirend = LT_EOS_CHAR;
2760 *pdir = lt_estrdup (filename);
2761 is_done = (*pdir == 0) ? -1 : 1;
2768 find_file (search_path, base_name, pdir)
2769 const char *search_path;
2770 const char *base_name;
2775 foreach_dirinpath (search_path, base_name, find_file_callback, pdir, &file);
2781 find_handle_callback (filename, data, ignored)
2786 lt_dlhandle *handle = (lt_dlhandle *) data;
2787 int notfound = access (filename, R_OK);
2789 /* Bail out if file cannot be read... */
2793 /* Try to dlopen the file, but do not continue searching in any
2795 if (tryall_dlopen (handle, filename) != 0)
2801 /* If HANDLE was found return it, otherwise return 0. If HANDLE was
2802 found but could not be opened, *HANDLE will be set to 0. */
2803 static lt_dlhandle *
2804 find_handle (search_path, base_name, handle)
2805 const char *search_path;
2806 const char *base_name;
2807 lt_dlhandle *handle;
2812 if (!foreach_dirinpath (search_path, base_name, find_handle_callback,
2820 load_deplibs (handle, deplibs)
2824 #if LTDL_DLOPEN_DEPLIBS
2825 char *p, *save_search_path = 0;
2832 handle->depcount = 0;
2834 #if LTDL_DLOPEN_DEPLIBS
2842 if (user_search_path)
2844 save_search_path = lt_estrdup (user_search_path);
2845 if (!save_search_path)
2849 /* extract search paths and count deplibs */
2853 if (!isspace ((int) *p))
2856 while (*end && !isspace((int) *end))
2861 if (strncmp(p, "-L", 2) == 0 || strncmp(p, "-R", 2) == 0)
2864 *end = 0; /* set a temporary string terminator */
2865 if (lt_dladdsearchdir(p+2))
2890 names = LT_EMALLOC (char *, depcount * sizeof (char*));
2894 /* now only extract the actual deplibs */
2899 if (isspace ((int) *p))
2906 while (*end && !isspace ((int) *end))
2911 if (strncmp(p, "-L", 2) != 0 && strncmp(p, "-R", 2) != 0)
2915 *end = 0; /* set a temporary string terminator */
2916 if (strncmp(p, "-l", 2) == 0)
2918 size_t name_len = 3+ /* "lib" */ LT_STRLEN (p + 2);
2919 name = LT_EMALLOC (char, 1+ name_len);
2921 sprintf (name, "lib%s", p+2);
2924 name = lt_estrdup(p);
2929 names[depcount++] = name;
2936 /* load the deplibs (in reverse order)
2937 At this stage, don't worry if the deplibs do not load correctly,
2938 they may already be statically linked into the loading application
2939 for instance. There will be a more enlightening error message
2940 later on if the loaded module cannot resolve all of its symbols. */
2945 handle->deplibs = (lt_dlhandle*) LT_EMALLOC (lt_dlhandle *, depcount);
2946 if (!handle->deplibs)
2949 for (i = 0; i < depcount; ++i)
2951 handle->deplibs[j] = lt_dlopenext(names[depcount-1-i]);
2952 if (handle->deplibs[j])
2958 handle->depcount = j; /* Number of successfully loaded deplibs */
2963 for (i = 0; i < depcount; ++i)
2965 LT_DLFREE (names[i]);
2970 /* restore the old search path */
2971 if (user_search_path) {
2972 LT_DLFREE (user_search_path);
2973 user_search_path = save_search_path;
2975 LT_DLMUTEX_UNLOCK ();
2983 unload_deplibs (handle)
2989 if (handle->depcount)
2991 for (i = 0; i < handle->depcount; ++i)
2993 if (!LT_DLIS_RESIDENT (handle->deplibs[i]))
2995 errors += lt_dlclose (handle->deplibs[i]);
3008 /* remove the leading and trailing "'" from str
3009 and store the result in dest */
3010 const char *end = strrchr (str, '\'');
3011 size_t len = LT_STRLEN (str);
3019 if (len > 3 && str[0] == '\'')
3021 tmp = LT_EMALLOC (char, end - str);
3025 strncpy(tmp, &str[1], (end - str) - 1);
3026 tmp[len-3] = LT_EOS_CHAR;
3038 free_vars (dlname, oldname, libdir, deplibs)
3045 LT_DLFREE (oldname);
3047 LT_DLFREE (deplibs);
3053 try_dlopen (phandle, filename)
3054 lt_dlhandle *phandle;
3055 const char *filename;
3057 const char * ext = 0;
3058 const char * saved_error = 0;
3059 char * canonical = 0;
3060 char * base_name = 0;
3064 lt_dlhandle newhandle;
3067 assert (*phandle == 0);
3069 LT_DLMUTEX_GETERROR (saved_error);
3074 *phandle = (lt_dlhandle) LT_EMALLOC (struct lt_dlhandle_struct, 1);
3078 memset (*phandle, 0, sizeof(struct lt_dlhandle_struct));
3079 newhandle = *phandle;
3081 /* lt_dlclose()ing yourself is very bad! Disallow it. */
3082 LT_DLSET_FLAG (*phandle, LT_DLRESIDENT_FLAG);
3084 if (tryall_dlopen (&newhandle, 0) != 0)
3086 LT_DLFREE (*phandle);
3090 goto register_handle;
3093 assert (filename && *filename);
3095 /* Doing this immediately allows internal functions to safely
3096 assume only canonicalized paths are passed. */
3097 if (canonicalize_path (filename, &canonical) != 0)
3103 /* If the canonical module name is a path (relative or absolute)
3104 then split it into a directory part and a name part. */
3105 base_name = strrchr (canonical, '/');
3108 size_t dirlen = (1+ base_name) - canonical;
3110 dir = LT_EMALLOC (char, 1+ dirlen);
3117 strncpy (dir, canonical, dirlen);
3118 dir[dirlen] = LT_EOS_CHAR;
3123 base_name = canonical;
3125 assert (base_name && *base_name);
3127 /* Check whether we are opening a libtool module (.la extension). */
3128 ext = strrchr (base_name, '.');
3129 if (ext && strcmp (ext, archive_ext) == 0)
3131 /* this seems to be a libtool module */
3134 char * old_name = 0;
3140 /* if we can't find the installed flag, it is probably an
3141 installed libtool archive, produced with an old version
3145 /* extract the module name from the file name */
3146 name = LT_EMALLOC (char, ext - base_name + 1);
3153 /* canonicalize the module name */
3156 for (i = 0; i < ext - base_name; ++i)
3158 if (isalnum ((int)(base_name[i])))
3160 name[i] = base_name[i];
3167 name[ext - base_name] = LT_EOS_CHAR;
3170 /* Now try to open the .la file. If there is no directory name
3171 component, try to find it first in user_search_path and then other
3172 prescribed paths. Otherwise (or in any case if the module was not
3173 yet found) try opening just the module name as passed. */
3176 const char *search_path;
3179 search_path = user_search_path;
3181 file = find_file (user_search_path, base_name, &dir);
3182 LT_DLMUTEX_UNLOCK ();
3186 search_path = getenv (LTDL_SEARCHPATH_VAR);
3188 file = find_file (search_path, base_name, &dir);
3191 #ifdef LTDL_SHLIBPATH_VAR
3194 search_path = getenv (LTDL_SHLIBPATH_VAR);
3196 file = find_file (search_path, base_name, &dir);
3199 #ifdef LTDL_SYSSEARCHPATH
3200 if (!file && sys_search_path)
3202 file = find_file (sys_search_path, base_name, &dir);
3208 file = fopen (filename, LT_READTEXT_MODE);
3211 /* If we didn't find the file by now, it really isn't there. Set
3212 the status flag, and bail out. */
3215 LT_DLMUTEX_SETERROR (LT_DLSTRERROR (FILE_NOT_FOUND));
3220 line_len = LT_FILENAME_MAX;
3221 line = LT_EMALLOC (char, line_len);
3229 /* read the .la file */
3230 while (!feof (file))
3232 if (!fgets (line, (int) line_len, file))
3237 /* Handle the case where we occasionally need to read a line
3238 that is longer than the initial buffer size. */
3239 while ((line[LT_STRLEN(line) -1] != '\n') && (!feof (file)))
3241 line = LT_DLREALLOC (char, line, line_len *2);
3242 if (!fgets (&line[line_len -1], (int) line_len +1, file))
3249 if (line[0] == '\n' || line[0] == '#')
3255 #define STR_DLNAME "dlname="
3256 if (strncmp (line, STR_DLNAME, sizeof (STR_DLNAME) - 1) == 0)
3258 errors += trim (&dlname, &line[sizeof (STR_DLNAME) - 1]);
3261 #undef STR_OLD_LIBRARY
3262 #define STR_OLD_LIBRARY "old_library="
3263 else if (strncmp (line, STR_OLD_LIBRARY,
3264 sizeof (STR_OLD_LIBRARY) - 1) == 0)
3266 errors += trim (&old_name, &line[sizeof (STR_OLD_LIBRARY) - 1]);
3269 #define STR_LIBDIR "libdir="
3270 else if (strncmp (line, STR_LIBDIR, sizeof (STR_LIBDIR) - 1) == 0)
3272 errors += trim (&libdir, &line[sizeof(STR_LIBDIR) - 1]);
3275 #undef STR_DL_DEPLIBS
3276 #define STR_DL_DEPLIBS "dependency_libs="
3277 else if (strncmp (line, STR_DL_DEPLIBS,
3278 sizeof (STR_DL_DEPLIBS) - 1) == 0)
3280 errors += trim (&deplibs, &line[sizeof (STR_DL_DEPLIBS) - 1]);
3282 else if (strcmp (line, "installed=yes\n") == 0)
3286 else if (strcmp (line, "installed=no\n") == 0)
3291 #undef STR_LIBRARY_NAMES
3292 #define STR_LIBRARY_NAMES "library_names="
3293 else if (! dlname && strncmp (line, STR_LIBRARY_NAMES,
3294 sizeof (STR_LIBRARY_NAMES) - 1) == 0)
3297 errors += trim (&dlname, &line[sizeof (STR_LIBRARY_NAMES) - 1]);
3300 && (last_libname = strrchr (dlname, ' ')) != 0)
3302 last_libname = lt_estrdup (last_libname + 1);
3308 LT_DLMEM_REASSIGN (dlname, last_libname);
3319 /* allocate the handle */
3320 *phandle = (lt_dlhandle) LT_EMALLOC (struct lt_dlhandle_struct, 1);
3326 free_vars (dlname, old_name, libdir, deplibs);
3327 LT_DLFREE (*phandle);
3333 memset (*phandle, 0, sizeof(struct lt_dlhandle_struct));
3334 if (load_deplibs (*phandle, deplibs) == 0)
3336 newhandle = *phandle;
3337 /* find_module may replace newhandle */
3338 if (find_module (&newhandle, dir, libdir, dlname, old_name, installed))
3340 unload_deplibs (*phandle);
3349 free_vars (dlname, old_name, libdir, deplibs);
3352 LT_DLFREE (*phandle);
3356 if (*phandle != newhandle)
3358 unload_deplibs (*phandle);
3363 /* not a libtool module */
3364 *phandle = (lt_dlhandle) LT_EMALLOC (struct lt_dlhandle_struct, 1);
3371 memset (*phandle, 0, sizeof (struct lt_dlhandle_struct));
3372 newhandle = *phandle;
3374 /* If the module has no directory name component, try to find it
3375 first in user_search_path and then other prescribed paths.
3376 Otherwise (or in any case if the module was not yet found) try
3377 opening just the module name as passed. */
3378 if ((dir || (!find_handle (user_search_path, base_name, &newhandle)
3379 && !find_handle (getenv (LTDL_SEARCHPATH_VAR), base_name,
3381 #ifdef LTDL_SHLIBPATH_VAR
3382 && !find_handle (getenv (LTDL_SHLIBPATH_VAR), base_name,
3385 #ifdef LTDL_SYSSEARCHPATH
3386 && !find_handle (sys_search_path, base_name, &newhandle)
3390 if (tryall_dlopen (&newhandle, filename) != 0)
3398 LT_DLFREE (*phandle);
3405 LT_DLMEM_REASSIGN (*phandle, newhandle);
3407 if ((*phandle)->info.ref_count == 0)
3409 (*phandle)->info.ref_count = 1;
3410 LT_DLMEM_REASSIGN ((*phandle)->info.name, name);
3413 (*phandle)->next = handles;
3415 LT_DLMUTEX_UNLOCK ();
3418 LT_DLMUTEX_SETERROR (saved_error);
3423 LT_DLFREE (canonical);
3429 lt_dlopen (filename)
3430 const char *filename;
3432 lt_dlhandle handle = 0;
3434 /* Just incase we missed a code path in try_dlopen() that reports
3435 an error, but forgets to reset handle... */
3436 if (try_dlopen (&handle, filename) != 0)
3442 /* If the last error messge store was `FILE_NOT_FOUND', then return
3447 const char *error = 0;
3449 LT_DLMUTEX_GETERROR (error);
3450 if (error == LT_DLSTRERROR (FILE_NOT_FOUND))
3456 /* If FILENAME has an ARCHIVE_EXT or SHLIB_EXT extension, try to
3457 open the FILENAME as passed. Otherwise try appending ARCHIVE_EXT,
3458 and if a file is still not found try again with SHLIB_EXT appended
3461 lt_dlopenext (filename)
3462 const char *filename;
3464 lt_dlhandle handle = 0;
3472 return lt_dlopen (filename);
3477 len = LT_STRLEN (filename);
3478 ext = strrchr (filename, '.');
3480 /* If FILENAME already bears a suitable extension, there is no need
3481 to try appending additional extensions. */
3482 if (ext && ((strcmp (ext, archive_ext) == 0)
3483 #ifdef LTDL_SHLIB_EXT
3484 || (strcmp (ext, shlib_ext) == 0)
3488 return lt_dlopen (filename);
3491 /* First try appending ARCHIVE_EXT. */
3492 tmp = LT_EMALLOC (char, len + LT_STRLEN (archive_ext) + 1);
3496 strcpy (tmp, filename);
3497 strcat (tmp, archive_ext);
3498 errors = try_dlopen (&handle, tmp);
3500 /* If we found FILENAME, stop searching -- whether we were able to
3501 load the file as a module or not. If the file exists but loading
3502 failed, it is better to return an error message here than to
3503 report FILE_NOT_FOUND when the alternatives (foo.so etc) are not
3504 in the module search path. */
3505 if (handle || ((errors > 0) && !file_not_found ()))
3511 #ifdef LTDL_SHLIB_EXT
3512 /* Try appending SHLIB_EXT. */
3513 if (LT_STRLEN (shlib_ext) > LT_STRLEN (archive_ext))
3516 tmp = LT_EMALLOC (char, len + LT_STRLEN (shlib_ext) + 1);
3520 strcpy (tmp, filename);
3524 tmp[len] = LT_EOS_CHAR;
3527 strcat(tmp, shlib_ext);
3528 errors = try_dlopen (&handle, tmp);
3530 /* As before, if the file was found but loading failed, return now
3531 with the current error message. */
3532 if (handle || ((errors > 0) && !file_not_found ()))
3539 /* Still here? Then we really did fail to locate any of the file
3541 LT_DLMUTEX_SETERROR (LT_DLSTRERROR (FILE_NOT_FOUND));
3548 lt_argz_insert (pargz, pargz_len, before, entry)
3556 /* Prior to Sep 8, 2005, newlib had a bug where argz_insert(pargz,
3557 pargz_len, NULL, entry) failed with EINVAL. */
3559 error = argz_insert (pargz, pargz_len, before, entry);
3561 error = argz_append (pargz, pargz_len, entry, 1 + LT_STRLEN (entry));
3568 LT_DLMUTEX_SETERROR (LT_DLSTRERROR (NO_MEMORY));
3571 LT_DLMUTEX_SETERROR (LT_DLSTRERROR (UNKNOWN));
3581 lt_argz_insertinorder (pargz, pargz_len, entry)
3590 assert (entry && *entry);
3593 while ((before = argz_next (*pargz, *pargz_len, before)))
3595 int cmp = strcmp (entry, before);
3598 if (cmp == 0) return 0; /* No duplicates! */
3601 return lt_argz_insert (pargz, pargz_len, before, entry);
3605 lt_argz_insertdir (pargz, pargz_len, dirnam, dp)
3614 size_t end_offset = 0;
3622 dir_len = LT_STRLEN (dirnam);
3623 end = dp->d_name + LT_D_NAMLEN(dp);
3625 /* Ignore version numbers. */
3628 for (p = end; p -1 > dp->d_name; --p)
3629 if (strchr (".0123456789", p[-1]) == 0)
3636 /* Ignore filename extension. */
3639 for (p = end -1; p > dp->d_name; --p)
3647 /* Prepend the directory name. */
3648 end_offset = end - dp->d_name;
3649 buf_len = dir_len + 1+ end_offset;
3650 buf = LT_EMALLOC (char, 1+ buf_len);
3656 strcpy (buf, dirnam);
3658 strncat (buf, dp->d_name, end_offset);
3659 buf[buf_len] = LT_EOS_CHAR;
3661 /* Try to insert (in order) into ARGZ/ARGZ_LEN. */
3662 if (lt_argz_insertinorder (pargz, pargz_len, buf) != 0)
3671 list_files_by_dir (dirnam, pargz, pargz_len)
3679 assert (dirnam && *dirnam);
3682 assert (dirnam[LT_STRLEN(dirnam) -1] != '/');
3684 dirp = opendir (dirnam);
3687 struct dirent *dp = 0;
3689 while ((dp = readdir (dirp)))
3690 if (dp->d_name[0] != '.')
3691 if (lt_argz_insertdir (pargz, pargz_len, dirnam, dp))
3706 /* If there are any files in DIRNAME, call the function passed in
3707 DATA1 (with the name of each file and DATA2 as arguments). */
3709 foreachfile_callback (dirname, data1, data2)
3714 int (*func) LT_PARAMS((const char *filename, lt_ptr data))
3715 = (int (*) LT_PARAMS((const char *filename, lt_ptr data))) data1;
3719 size_t argz_len = 0;
3721 if (list_files_by_dir (dirname, &argz, &argz_len) != 0)
3728 while ((filename = argz_next (argz, argz_len, filename)))
3729 if ((is_done = (*func) (filename, data2)))
3740 /* Call FUNC for each unique extensionless file in SEARCH_PATH, along
3741 with DATA. The filenames passed to FUNC would be suitable for
3742 passing to lt_dlopenext. The extensions are stripped so that
3743 individual modules do not generate several entries (e.g. libfoo.la,
3744 libfoo.so, libfoo.so.1, libfoo.so.1.0.0). If SEARCH_PATH is NULL,
3745 then the same directories that lt_dlopen would search are examined. */
3747 lt_dlforeachfile (search_path, func, data)
3748 const char *search_path;
3749 int (*func) LT_PARAMS ((const char *filename, lt_ptr data));
3756 /* If a specific path was passed, search only the directories
3758 is_done = foreach_dirinpath (search_path, 0,
3759 foreachfile_callback, func, data);
3763 /* Otherwise search the default paths. */
3764 is_done = foreach_dirinpath (user_search_path, 0,
3765 foreachfile_callback, func, data);
3768 is_done = foreach_dirinpath (getenv("LTDL_LIBRARY_PATH"), 0,
3769 foreachfile_callback, func, data);
3772 #ifdef LTDL_SHLIBPATH_VAR
3775 is_done = foreach_dirinpath (getenv(LTDL_SHLIBPATH_VAR), 0,
3776 foreachfile_callback, func, data);
3779 #ifdef LTDL_SYSSEARCHPATH
3782 is_done = foreach_dirinpath (getenv(LTDL_SYSSEARCHPATH), 0,
3783 foreachfile_callback, func, data);
3795 lt_dlhandle cur, last;
3800 /* check whether the handle is valid */
3801 last = cur = handles;
3802 while (cur && handle != cur)
3810 LT_DLMUTEX_SETERROR (LT_DLSTRERROR (INVALID_HANDLE));
3815 handle->info.ref_count--;
3817 /* Note that even with resident modules, we must track the ref_count
3818 correctly incase the user decides to reset the residency flag
3819 later (even though the API makes no provision for that at the
3821 if (handle->info.ref_count <= 0 && !LT_DLIS_RESIDENT (handle))
3823 lt_user_data data = handle->loader->dlloader_data;
3825 if (handle != handles)
3827 last->next = handle->next;
3831 handles = handle->next;
3834 errors += handle->loader->module_close (data, handle->module);
3835 errors += unload_deplibs(handle);
3837 /* It is up to the callers to free the data itself. */
3838 LT_DLFREE (handle->caller_data);
3840 LT_DLFREE (handle->info.filename);
3841 LT_DLFREE (handle->info.name);
3847 if (LT_DLIS_RESIDENT (handle))
3849 LT_DLMUTEX_SETERROR (LT_DLSTRERROR (CLOSE_RESIDENT_MODULE));
3854 LT_DLMUTEX_UNLOCK ();
3860 lt_dlsym (handle, symbol)
3865 char lsym[LT_SYMBOL_LENGTH];
3872 LT_DLMUTEX_SETERROR (LT_DLSTRERROR (INVALID_HANDLE));
3878 LT_DLMUTEX_SETERROR (LT_DLSTRERROR (SYMBOL_NOT_FOUND));
3882 lensym = LT_STRLEN (symbol) + LT_STRLEN (handle->loader->sym_prefix)
3883 + LT_STRLEN (handle->info.name);
3885 if (lensym + LT_SYMBOL_OVERHEAD < LT_SYMBOL_LENGTH)
3891 sym = LT_EMALLOC (char, lensym + LT_SYMBOL_OVERHEAD + 1);
3894 LT_DLMUTEX_SETERROR (LT_DLSTRERROR (BUFFER_OVERFLOW));
3899 data = handle->loader->dlloader_data;
3900 if (handle->info.name)
3902 const char *saved_error;
3904 LT_DLMUTEX_GETERROR (saved_error);
3906 /* this is a libtool module */
3907 if (handle->loader->sym_prefix)
3909 strcpy(sym, handle->loader->sym_prefix);
3910 strcat(sym, handle->info.name);
3914 strcpy(sym, handle->info.name);
3917 strcat(sym, "_LTX_");
3918 strcat(sym, symbol);
3920 /* try "modulename_LTX_symbol" */
3921 address = handle->loader->find_sym (data, handle->module, sym);
3930 LT_DLMUTEX_SETERROR (saved_error);
3933 /* otherwise try "symbol" */
3934 if (handle->loader->sym_prefix)
3936 strcpy(sym, handle->loader->sym_prefix);
3937 strcat(sym, symbol);
3941 strcpy(sym, symbol);
3944 address = handle->loader->find_sym (data, handle->module, sym);
3958 LT_DLMUTEX_GETERROR (error);
3959 LT_DLMUTEX_SETERROR (0);
3961 return error ? error : NULL;
3965 lt_dlpath_insertdir (ppath, before, dir)
3971 char *canonical = 0;
3973 size_t argz_len = 0;
3976 assert (dir && *dir);
3978 if (canonicalize_path (dir, &canonical) != 0)
3984 assert (canonical && *canonical);
3986 /* If *PPATH is empty, set it to DIR. */
3989 assert (!before); /* BEFORE cannot be set without PPATH. */
3990 assert (dir); /* Without DIR, don't call this function! */
3992 *ppath = lt_estrdup (dir);
3999 assert (ppath && *ppath);
4001 if (argzize_path (*ppath, &argz, &argz_len) != 0)
4007 /* Convert BEFORE into an equivalent offset into ARGZ. This only works
4008 if *PPATH is already canonicalized, and hence does not change length
4009 with respect to ARGZ. We canonicalize each entry as it is added to
4010 the search path, and don't call this function with (uncanonicalized)
4011 user paths, so this is a fair assumption. */
4014 assert (*ppath <= before);
4015 assert (before - *ppath <= strlen (*ppath));
4017 before = before - *ppath + argz;
4020 if (lt_argz_insert (&argz, &argz_len, before, dir) != 0)
4026 argz_stringify (argz, argz_len, LT_PATHSEP_CHAR);
4027 LT_DLMEM_REASSIGN (*ppath, argz);
4030 LT_DLFREE (canonical);
4037 lt_dladdsearchdir (search_dir)
4038 const char *search_dir;
4042 if (search_dir && *search_dir)
4045 if (lt_dlpath_insertdir (&user_search_path, 0, search_dir) != 0)
4047 LT_DLMUTEX_UNLOCK ();
4054 lt_dlinsertsearchdir (before, search_dir)
4056 const char *search_dir;
4063 if ((before < user_search_path)
4064 || (before >= user_search_path + LT_STRLEN (user_search_path)))
4066 LT_DLMUTEX_UNLOCK ();
4067 LT_DLMUTEX_SETERROR (LT_DLSTRERROR (INVALID_POSITION));
4070 LT_DLMUTEX_UNLOCK ();
4073 if (search_dir && *search_dir)
4076 if (lt_dlpath_insertdir (&user_search_path,
4077 (char *) before, search_dir) != 0)
4081 LT_DLMUTEX_UNLOCK ();
4088 lt_dlsetsearchpath (search_path)
4089 const char *search_path;
4094 LT_DLFREE (user_search_path);
4095 LT_DLMUTEX_UNLOCK ();
4097 if (!search_path || !LT_STRLEN (search_path))
4103 if (canonicalize_path (search_path, &user_search_path) != 0)
4105 LT_DLMUTEX_UNLOCK ();
4111 lt_dlgetsearchpath ()
4113 const char *saved_path;
4116 saved_path = user_search_path;
4117 LT_DLMUTEX_UNLOCK ();
4123 lt_dlmakeresident (handle)
4130 LT_DLMUTEX_SETERROR (LT_DLSTRERROR (INVALID_HANDLE));
4135 LT_DLSET_FLAG (handle, LT_DLRESIDENT_FLAG);
4142 lt_dlisresident (handle)
4147 LT_DLMUTEX_SETERROR (LT_DLSTRERROR (INVALID_HANDLE));
4151 return LT_DLIS_RESIDENT (handle);
4157 /* --- MODULE INFORMATION --- */
4160 lt_dlgetinfo (handle)
4165 LT_DLMUTEX_SETERROR (LT_DLSTRERROR (INVALID_HANDLE));
4169 return &(handle->info);
4173 lt_dlhandle_next (place)
4176 return place ? place->next : handles;
4180 lt_dlforeach (func, data)
4181 int (*func) LT_PARAMS((lt_dlhandle handle, lt_ptr data));
4192 lt_dlhandle tmp = cur;
4195 if ((*func) (tmp, data))
4202 LT_DLMUTEX_UNLOCK ();
4208 lt_dlcaller_register ()
4210 static lt_dlcaller_id last_caller_id = 0;
4214 result = ++last_caller_id;
4215 LT_DLMUTEX_UNLOCK ();
4221 lt_dlcaller_set_data (key, handle, data)
4227 lt_ptr stale = (lt_ptr) 0;
4230 /* This needs to be locked so that the caller data can be updated
4231 simultaneously by different threads. */
4234 if (handle->caller_data)
4235 while (handle->caller_data[n_elements].key)
4238 for (i = 0; i < n_elements; ++i)
4240 if (handle->caller_data[i].key == key)
4242 stale = handle->caller_data[i].data;
4247 /* Ensure that there is enough room in this handle's caller_data
4248 array to accept a new element (and an empty end marker). */
4249 if (i == n_elements)
4251 lt_caller_data *temp
4252 = LT_DLREALLOC (lt_caller_data, handle->caller_data, 2+ n_elements);
4260 handle->caller_data = temp;
4262 /* We only need this if we needed to allocate a new caller_data. */
4263 handle->caller_data[i].key = key;
4264 handle->caller_data[1+ i].key = 0;
4267 handle->caller_data[i].data = data;
4270 LT_DLMUTEX_UNLOCK ();
4276 lt_dlcaller_get_data (key, handle)
4280 lt_ptr result = (lt_ptr) 0;
4282 /* This needs to be locked so that the caller data isn't updated by
4283 another thread part way through this function. */
4286 /* Locate the index of the element with a matching KEY. */
4289 for (i = 0; handle->caller_data[i].key; ++i)
4291 if (handle->caller_data[i].key == key)
4293 result = handle->caller_data[i].data;
4299 LT_DLMUTEX_UNLOCK ();
4306 /* --- USER MODULE LOADER API --- */
4310 lt_dlloader_add (place, dlloader, loader_name)
4312 const struct lt_user_dlloader *dlloader;
4313 const char *loader_name;
4316 lt_dlloader *node = 0, *ptr = 0;
4318 if ((dlloader == 0) /* diagnose null parameters */
4319 || (dlloader->module_open == 0)
4320 || (dlloader->module_close == 0)
4321 || (dlloader->find_sym == 0))
4323 LT_DLMUTEX_SETERROR (LT_DLSTRERROR (INVALID_LOADER));
4327 /* Create a new dlloader node with copies of the user callbacks. */
4328 node = LT_EMALLOC (lt_dlloader, 1);
4333 node->loader_name = loader_name;
4334 node->sym_prefix = dlloader->sym_prefix;
4335 node->dlloader_exit = dlloader->dlloader_exit;
4336 node->module_open = dlloader->module_open;
4337 node->module_close = dlloader->module_close;
4338 node->find_sym = dlloader->find_sym;
4339 node->dlloader_data = dlloader->dlloader_data;
4344 /* If there are no loaders, NODE becomes the list! */
4349 /* If PLACE is not set, add NODE to the end of the
4351 for (ptr = loaders; ptr->next; ptr = ptr->next)
4358 else if (loaders == place)
4360 /* If PLACE is the first loader, NODE goes first. */
4366 /* Find the node immediately preceding PLACE. */
4367 for (ptr = loaders; ptr->next != place; ptr = ptr->next)
4372 if (ptr->next != place)
4374 LT_DLMUTEX_SETERROR (LT_DLSTRERROR (INVALID_LOADER));
4379 /* Insert NODE between PTR and PLACE. */
4385 LT_DLMUTEX_UNLOCK ();
4391 lt_dlloader_remove (loader_name)
4392 const char *loader_name;
4394 lt_dlloader *place = lt_dlloader_find (loader_name);
4400 LT_DLMUTEX_SETERROR (LT_DLSTRERROR (INVALID_LOADER));
4406 /* Fail if there are any open modules which use this loader. */
4407 for (handle = handles; handle; handle = handle->next)
4409 if (handle->loader == place)
4411 LT_DLMUTEX_SETERROR (LT_DLSTRERROR (REMOVE_LOADER));
4417 if (place == loaders)
4419 /* PLACE is the first loader in the list. */
4420 loaders = loaders->next;
4424 /* Find the loader before the one being removed. */
4426 for (prev = loaders; prev->next; prev = prev->next)
4428 if (!strcmp (prev->next->loader_name, loader_name))
4435 prev->next = prev->next->next;
4438 if (place->dlloader_exit)
4440 errors = place->dlloader_exit (place->dlloader_data);
4446 LT_DLMUTEX_UNLOCK ();
4452 lt_dlloader_next (place)
4458 next = place ? place->next : loaders;
4459 LT_DLMUTEX_UNLOCK ();
4465 lt_dlloader_name (place)
4468 const char *name = 0;
4473 name = place ? place->loader_name : 0;
4474 LT_DLMUTEX_UNLOCK ();
4478 LT_DLMUTEX_SETERROR (LT_DLSTRERROR (INVALID_LOADER));
4485 lt_dlloader_data (place)
4488 lt_user_data *data = 0;
4493 data = place ? &(place->dlloader_data) : 0;
4494 LT_DLMUTEX_UNLOCK ();
4498 LT_DLMUTEX_SETERROR (LT_DLSTRERROR (INVALID_LOADER));
4505 lt_dlloader_find (loader_name)
4506 const char *loader_name;
4508 lt_dlloader *place = 0;
4511 for (place = loaders; place; place = place->next)
4513 if (strcmp (place->loader_name, loader_name) == 0)
4518 LT_DLMUTEX_UNLOCK ();