mirror of
git://git.savannah.gnu.org/libtool.git
synced 2024-11-27 06:09:57 +08:00
706e672811
operation of libtool (neither would work alone). First, there is a new feature that allows libraries to preopen modules. This entails a backwards incompatible change to the libltdl API for separating out the preloaded symbol lists by owner. Second, in the tradition of "eating our own dogfood", libltdl now preloads its own dlloaders. The internal API for dlloaders has also had to change in a backwards incompatible way in support of the new library preloading feature. If you don't use preloaded libraries, you needn't change your project sources, though you will need to recompile against the new libltdl. The API changes are mostly confined to dlloaders, so you probably needn't worry about those (unless you have written a custom loader that you want libltdl to use): * configure.ac (AC_CONFIG_FILES): Add libltdl/loaders/Makefile. * libltdl/configure.ac (AC_CONFIG_FILES): Add loaders/Makefile. * libltdl/loaders: New directory for module loaders, to simplify Makefile rules, and to give the loaders themselves names that are unique in the first few characters. * libtoolize.in (func_copy_all_files): Copy recursively to pick up the loaders directory contents. * libltdl/loaders/Makefile.am: New file. Move module building rules to here... * libltdl/Makefile.am: ...from here. (VERSION_INFO): Bumped version info to signify interface changes. (libltdl_la_CPPFLAGS, libltdlc_la_CPPFLAGS): Set LTDLOPEN appropriately for each library. * libltdl/loader-dld_link.c, libltdl/loader-dlopen.c, libltdl/loader-dyld.c, libltdl/loader-load_add_on.c, libltdl/loader-loadlibrary.c libltdl/loader-preopen.c, libltdl/loader-shl_load.c: Moved from here... * libltdl/loaders/dld_link.c, libltdl/loaders/dlopen.c, libltdl/loaders/dyld.c, libltdl/loaders/load_add_on.c, libltdl/loaders/loadlibrary.c libltdl/loaders/preopen.c, libltdl/loaders/shl_load.c: ...to here. (get_vtable): New entry function for each. * libltdl/loaders/preopen.c (lt_dlsymlists_t): Replaced by... (symlist_chain): ...a new structure which maps lists of preloaded symbols from the object that loads them. (lt_dlpreload_open): New function to automatically open all preloaded modules belonging to a named object (ORIGINATOR). * libltdl/lt__alloc.c (lt__zalloc): New function to return a block of zeroed out new memory. * libltdl/lt__alloc.h (lt__zalloc): Prototype it. * libltdl/lt__private.h (lt__alloc_die_callback): Add missing prototype. (lt__error_strings): Make this opaque to callers. * libltdl/lt_error.c (lt__error_strings): Move the implementation to here. * libltdl/lt_dlloader.h (lt_user_dlloader): Add extra fields to make originator focused preloading possible. *BREAKS BACKWARDS COMPATIBILITY* (lt_dlloader_add): Take advantage of new fields to simplify paramater list. * libltdl/lt_system.h (LT_STR): New ANSI stringification macro. (LT_CONC): Fix it to work from within macros. * libltdl/ltdl.c (loader_init, loader_init_callback): Simplify dlloader loading. (get_vtable, preloaded_symbols): Point these at the preopen.c symbols to bootstrap the loader chain. (lt_dlinit): Load the preopen dlloader manually, and then use it to load any other preloaded dlloaders. (lt_dlloader_add): Simplify parameter list. Populate new fields. Chain new loaders according to priority field. * libltdl/ltdl.h (lt_dlsymlist): Add a new originator field. (lt_dlpreload_callback_func): Type of a callback for automatic lt_dlpreload_open loading. (LTDL_SET_PRELOADED_SYMBOLS): Adjust to hook into preloaded symbols from the "@PROGRAM@" originator. * tests/demo/dlmain.c (main): Use mangled preloaded_symbols symbol. * tests/pdemo/longer_file_name_dlmain.c (main): Ditto. * ltmain.in: Don't spew spurious warnings when dlopening and dlpreopening modules. (func_generate_dlsyms): Factored out from multiple copies in the rest of the code. Generate originator keyed symbol lists. (func_extract_archives): Also factored. Extract the contents of convenience archives for linking with dependent libraries when --whole-archive is not available. [darwin]: Don't try to link $old_library unless it exists, and $lib is a bundle. * m4/ltdl.m4 (AC_LTDL_DLLIB): Check for all possible dynamic loading libraries/apis rather that stopping when an acceptable one is discovered. (LT_DLLOADERS): New variable for holding dlloaders that can be preloaded. * doc/libtool.texi: Document interface changes. * NEWS: Updated.
79 lines
3.1 KiB
C
79 lines
3.1 KiB
C
/* lt_error.h -- error propogation interface
|
|
Copyright (C) 1999, 2000, 2001, 2004 Free Software Foundation, Inc.
|
|
Originally by Thomas Tanner <tanner@ffii.org>
|
|
|
|
NOTE: The canonical source of this file is maintained with the
|
|
GNU Libtool package. Report bugs to bug-libtool@gnu.org.
|
|
|
|
This library is free software; you can redistribute it and/or
|
|
modify it under the terms of the GNU Lesser General Public
|
|
License as published by the Free Software Foundation; either
|
|
version 2 of the License, or (at your option) any later version.
|
|
|
|
As a special exception to the GNU Lesser General Public License,
|
|
if you distribute this file as part of a program or library that
|
|
is built using GNU libtool, you may include it under the same
|
|
distribution terms that you use for the rest of that program.
|
|
|
|
This library is distributed in the hope that it will be useful,
|
|
but WITHOUT ANY WARRANTY; without even the implied warranty of
|
|
MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the GNU
|
|
Lesser General Public License for more details.
|
|
|
|
You should have received a copy of the GNU Lesser General Public
|
|
License along with this library; if not, write to the Free
|
|
Software Foundation, Inc., 59 Temple Place, Suite 330, Boston, MA
|
|
02111-1307 USA
|
|
*/
|
|
|
|
/* Only include this header file once. */
|
|
#if !defined(LT_ERROR_H)
|
|
#define LT_ERROR_H 1
|
|
|
|
#include <libltdl/lt_system.h>
|
|
|
|
LT_BEGIN_C_DECLS
|
|
|
|
/* Defining error strings alongside their symbolic names in a macro in
|
|
this way allows us to expand the macro in different contexts with
|
|
confidence that the enumeration of symbolic names will map correctly
|
|
onto the table of error strings. */
|
|
#define lt_dlerror_table \
|
|
LT_ERROR(UNKNOWN, "unknown error") \
|
|
LT_ERROR(DLOPEN_NOT_SUPPORTED, "dlopen support not available") \
|
|
LT_ERROR(INVALID_LOADER, "invalid loader") \
|
|
LT_ERROR(INIT_LOADER, "loader initialization failed") \
|
|
LT_ERROR(REMOVE_LOADER, "loader removal failed") \
|
|
LT_ERROR(FILE_NOT_FOUND, "file not found") \
|
|
LT_ERROR(DEPLIB_NOT_FOUND, "dependency library not found") \
|
|
LT_ERROR(NO_SYMBOLS, "no symbols defined") \
|
|
LT_ERROR(CANNOT_OPEN, "can't open the module") \
|
|
LT_ERROR(CANNOT_CLOSE, "can't close the module") \
|
|
LT_ERROR(SYMBOL_NOT_FOUND, "symbol not found") \
|
|
LT_ERROR(NO_MEMORY, "not enough memory") \
|
|
LT_ERROR(INVALID_HANDLE, "invalid module handle") \
|
|
LT_ERROR(BUFFER_OVERFLOW, "internal buffer overflow") \
|
|
LT_ERROR(INVALID_ERRORCODE, "invalid errorcode") \
|
|
LT_ERROR(SHUTDOWN, "library already shutdown") \
|
|
LT_ERROR(CLOSE_RESIDENT_MODULE, "can't close resident module") \
|
|
LT_ERROR(INVALID_MUTEX_ARGS, "internal error (code withdrawn)") \
|
|
LT_ERROR(INVALID_POSITION, "invalid search path insert position")
|
|
|
|
/* Enumerate the symbolic error names. */
|
|
enum {
|
|
#define LT_ERROR(name, diagnostic) LT_CONC(LT_ERROR_, name),
|
|
lt_dlerror_table
|
|
#undef LT_ERROR
|
|
|
|
LT_ERROR_MAX
|
|
};
|
|
|
|
/* These functions are only useful from inside custom module loaders. */
|
|
LT_SCOPE int lt_dladderror (const char *diagnostic);
|
|
LT_SCOPE int lt_dlseterror (int errorcode);
|
|
|
|
|
|
LT_END_C_DECLS
|
|
|
|
#endif /*!defined(LT_ERROR_H)*/
|