mirror of
git://git.savannah.gnu.org/libtool.git
synced 2024-11-27 06:09:57 +08:00
8bd0890c7b
* libltdl/ltdl.c (lt_dlhandle_struct): ...from here. Changed all callers. * libltdl/loader-loadlibrary.c (sys_wll_open): Use new inteface to scan loaded handle->info.module fields for previously loaded modules. * doc/libtool.texi (User defined module data): Document changes to the interface. * NEWS: Updated. Reported by Chuck Wilson <cwilson@ece.gatech.edu>
168 lines
5.1 KiB
C
168 lines
5.1 KiB
C
/* ltdl.h -- generic dlopen functions
|
||
Copyright (C) 1998-2000, 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(LTDL_H)
|
||
#define LTDL_H 1
|
||
|
||
#include <libltdl/lt_system.h>
|
||
#include <libltdl/lt_error.h>
|
||
#include <libltdl/lt_dlloader.h>
|
||
|
||
LT_BEGIN_C_DECLS
|
||
|
||
|
||
/* LT_STRLEN can be used safely on NULL pointers. */
|
||
#define LT_STRLEN(s) (((s) && (s)[0]) ? strlen (s) : 0)
|
||
|
||
|
||
|
||
/* --- DYNAMIC MODULE LOADING API --- */
|
||
|
||
|
||
typedef struct lt_dlhandle_struct *lt_dlhandle; /* A loaded module. */
|
||
|
||
/* Initialisation and finalisation functions for libltdl. */
|
||
LT_SCOPE int lt_dlinit (void);
|
||
LT_SCOPE int lt_dlexit (void);
|
||
|
||
/* Module search path manipulation. */
|
||
LT_SCOPE int lt_dladdsearchdir (const char *search_dir);
|
||
LT_SCOPE int lt_dlinsertsearchdir (const char *before,
|
||
const char *search_dir);
|
||
LT_SCOPE int lt_dlsetsearchpath (const char *search_path);
|
||
LT_SCOPE const char *lt_dlgetsearchpath (void);
|
||
LT_SCOPE int lt_dlforeachfile (
|
||
const char *search_path,
|
||
int (*func) (const char *filename, void *data),
|
||
void *data);
|
||
|
||
/* Portable libltdl versions of the system dlopen() API. */
|
||
LT_SCOPE lt_dlhandle lt_dlopen (const char *filename);
|
||
LT_SCOPE lt_dlhandle lt_dlopenext (const char *filename);
|
||
LT_SCOPE void * lt_dlsym (lt_dlhandle handle, const char *name);
|
||
LT_SCOPE const char *lt_dlerror (void);
|
||
LT_SCOPE int lt_dlclose (lt_dlhandle handle);
|
||
|
||
/* Module residency management. */
|
||
LT_SCOPE int lt_dlmakeresident (lt_dlhandle handle);
|
||
LT_SCOPE int lt_dlisresident (lt_dlhandle handle);
|
||
|
||
|
||
|
||
|
||
/* --- PRELOADED MODULE SUPPORT --- */
|
||
|
||
|
||
/* A preopened symbol. Arrays of this type comprise the exported
|
||
symbols for a dlpreopened module. */
|
||
typedef struct {
|
||
const char *name;
|
||
void * address;
|
||
} lt_dlsymlist;
|
||
|
||
LT_SCOPE int lt_dlpreload (const lt_dlsymlist *preloaded);
|
||
LT_SCOPE int lt_dlpreload_default (const lt_dlsymlist *preloaded);
|
||
|
||
#define LTDL_SET_PRELOADED_SYMBOLS() LT_STMT_START{ \
|
||
extern const lt_dlsymlist lt_preloaded_symbols[]; \
|
||
lt_dlpreload_default(lt_preloaded_symbols); \
|
||
}LT_STMT_END
|
||
|
||
|
||
|
||
|
||
/* --- MODULE INFORMATION --- */
|
||
|
||
|
||
/* Read only information pertaining to a loaded module. */
|
||
typedef struct {
|
||
char * filename; /* file name */
|
||
char * name; /* module name */
|
||
int ref_count; /* number of times lt_dlopened minus
|
||
number of times lt_dlclosed. */
|
||
lt_module module; /* system module handle */
|
||
} lt_dlinfo;
|
||
|
||
LT_SCOPE const lt_dlinfo *lt_dlgetinfo (lt_dlhandle handle);
|
||
LT_SCOPE lt_dlhandle lt_dlhandle_next (lt_dlhandle place);
|
||
LT_SCOPE lt_dlhandle lt_dlhandle_find (const char *module_name);
|
||
LT_SCOPE int lt_dlforeach (
|
||
int (*func) (lt_dlhandle handle, void *data),
|
||
void *data);
|
||
|
||
/* Associating user data with loaded modules. */
|
||
typedef unsigned lt_dlcaller_id;
|
||
|
||
LT_SCOPE lt_dlcaller_id lt_dlcaller_register (void);
|
||
LT_SCOPE void * lt_dlcaller_set_data (lt_dlcaller_id key,
|
||
lt_dlhandle handle, void *data);
|
||
LT_SCOPE void * lt_dlcaller_get_data (lt_dlcaller_id key,
|
||
lt_dlhandle handle);
|
||
|
||
|
||
|
||
/* --- BINARY COMPATIBILITY WITH OLD LIBLTDL --- */
|
||
|
||
typedef void lt_dlmutex_lock (void);
|
||
typedef void lt_dlmutex_unlock (void);
|
||
typedef void lt_dlmutex_seterror (const char *errmsg);
|
||
typedef const char *lt_dlmutex_geterror (void);
|
||
|
||
LT_SCOPE void * (*lt_dlmalloc) (size_t size);
|
||
LT_SCOPE void * (*lt_dlrealloc) (void *ptr, size_t size);
|
||
LT_SCOPE void (*lt_dlfree) (void *ptr);
|
||
|
||
|
||
LT_SCOPE int lt_dlmutex_register (lt_dlmutex_lock *lock,
|
||
lt_dlmutex_unlock *unlock,
|
||
lt_dlmutex_seterror *seterror,
|
||
lt_dlmutex_geterror *geterror);
|
||
|
||
# define lt_ptr void *
|
||
|
||
|
||
|
||
/* --- SOURCE COMPATIBILITY WITH ANCIENT LIBLTDL --- */
|
||
|
||
|
||
#if defined(LT_NON_POSIX_NAMESPACE)
|
||
# define lt_ptr_t void *
|
||
# define lt_module_t lt_module
|
||
# define lt_module_open_t lt_module_open
|
||
# define lt_module_close_t lt_module_close
|
||
# define lt_find_sym_t lt_find_sym
|
||
# define lt_dlloader_exit_t lt_dlloader_exit
|
||
# define lt_dlloader_t lt_dlloader
|
||
# define lt_dlloader_data_t lt_user_data
|
||
#endif
|
||
|
||
LT_END_C_DECLS
|
||
|
||
#endif /*!defined(LTDL_H)*/
|