2001-06-02 17:46:38 +00:00
|
|
|
|
/* ltdl.h -- generic dlopen functions
|
|
|
|
|
|
2010-03-01 18:43:38 +00:00
|
|
|
|
Copyright (C) 1998-2000, 2004, 2005,
|
|
|
|
|
2007, 2008 Free Software Foundation, Inc.
|
|
|
|
|
Written by Thomas Tanner, 1998
|
|
|
|
|
|
|
|
|
|
NOTE: The canonical source of this file is maintained with the
|
|
|
|
|
GNU Libtool package. Report bugs to bug-libtool@gnu.org.
|
|
|
|
|
|
|
|
|
|
GNU Libltdl is free software; you can redistribute it and/or
|
2001-06-02 17:46:38 +00:00
|
|
|
|
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
|
2010-03-01 18:43:38 +00:00
|
|
|
|
is built using GNU Libtool, you may include this file under the
|
|
|
|
|
same distribution terms that you use for the rest of that program.
|
2001-06-02 17:46:38 +00:00
|
|
|
|
|
2010-03-01 18:43:38 +00:00
|
|
|
|
GNU Libltdl is distributed in the hope that it will be useful,
|
2001-06-02 17:46:38 +00:00
|
|
|
|
but WITHOUT ANY WARRANTY; without even the implied warranty of
|
2010-03-01 18:43:38 +00:00
|
|
|
|
MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the
|
|
|
|
|
GNU Lesser General Public License for more details.
|
2001-06-02 17:46:38 +00:00
|
|
|
|
|
|
|
|
|
You should have received a copy of the GNU Lesser General Public
|
2010-03-01 18:43:38 +00:00
|
|
|
|
License along with GNU Libltdl; see the file COPYING.LIB. If not, a
|
|
|
|
|
copy can be downloaded from http://www.gnu.org/licenses/lgpl.html,
|
|
|
|
|
or obtained by writing to the Free Software Foundation, Inc.,
|
|
|
|
|
51 Franklin Street, Fifth Floor, Boston, MA 02110-1301, USA.
|
2001-06-02 17:46:38 +00:00
|
|
|
|
*/
|
|
|
|
|
|
|
|
|
|
/* Only include this header file once. */
|
2010-03-01 18:43:38 +00:00
|
|
|
|
#if !defined(LTDL_H)
|
2001-06-02 17:46:38 +00:00
|
|
|
|
#define LTDL_H 1
|
|
|
|
|
|
2010-03-01 18:43:38 +00:00
|
|
|
|
#include <libltdl/lt_system.h>
|
|
|
|
|
#include <libltdl/lt_error.h>
|
|
|
|
|
#include <libltdl/lt_dlloader.h>
|
2001-06-02 17:46:38 +00:00
|
|
|
|
|
|
|
|
|
LT_BEGIN_C_DECLS
|
|
|
|
|
|
|
|
|
|
|
2001-08-08 21:47:15 +00:00
|
|
|
|
/* LT_STRLEN can be used safely on NULL pointers. */
|
|
|
|
|
#define LT_STRLEN(s) (((s) && (s)[0]) ? strlen (s) : 0)
|
2001-06-02 17:46:38 +00:00
|
|
|
|
|
|
|
|
|
|
|
|
|
|
/* --- DYNAMIC MODULE LOADING API --- */
|
|
|
|
|
|
|
|
|
|
|
2010-03-01 18:43:38 +00:00
|
|
|
|
typedef struct lt__handle *lt_dlhandle; /* A loaded module. */
|
2001-06-02 17:46:38 +00:00
|
|
|
|
|
|
|
|
|
/* Initialisation and finalisation functions for libltdl. */
|
2010-03-01 18:43:38 +00:00
|
|
|
|
LT_SCOPE int lt_dlinit (void);
|
|
|
|
|
LT_SCOPE int lt_dlexit (void);
|
2001-06-02 17:46:38 +00:00
|
|
|
|
|
2001-08-05 12:00:03 +00:00
|
|
|
|
/* Module search path manipulation. */
|
2010-03-01 18:43:38 +00:00
|
|
|
|
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 (
|
2001-08-05 12:00:03 +00:00
|
|
|
|
const char *search_path,
|
2010-03-01 18:43:38 +00:00
|
|
|
|
int (*func) (const char *filename, void *data),
|
|
|
|
|
void *data);
|
|
|
|
|
|
|
|
|
|
/* User module loading advisors. */
|
|
|
|
|
LT_SCOPE int lt_dladvise_init (lt_dladvise *advise);
|
|
|
|
|
LT_SCOPE int lt_dladvise_destroy (lt_dladvise *advise);
|
|
|
|
|
LT_SCOPE int lt_dladvise_ext (lt_dladvise *advise);
|
|
|
|
|
LT_SCOPE int lt_dladvise_resident (lt_dladvise *advise);
|
|
|
|
|
LT_SCOPE int lt_dladvise_local (lt_dladvise *advise);
|
|
|
|
|
LT_SCOPE int lt_dladvise_global (lt_dladvise *advise);
|
|
|
|
|
LT_SCOPE int lt_dladvise_preload (lt_dladvise *advise);
|
2001-06-02 17:46:38 +00:00
|
|
|
|
|
|
|
|
|
/* Portable libltdl versions of the system dlopen() API. */
|
2010-03-01 18:43:38 +00:00
|
|
|
|
LT_SCOPE lt_dlhandle lt_dlopen (const char *filename);
|
|
|
|
|
LT_SCOPE lt_dlhandle lt_dlopenext (const char *filename);
|
|
|
|
|
LT_SCOPE lt_dlhandle lt_dlopenadvise (const char *filename,
|
|
|
|
|
lt_dladvise advise);
|
|
|
|
|
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);
|
2001-06-02 17:46:38 +00:00
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
/* --- PRELOADED MODULE SUPPORT --- */
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
/* A preopened symbol. Arrays of this type comprise the exported
|
|
|
|
|
symbols for a dlpreopened module. */
|
|
|
|
|
typedef struct {
|
|
|
|
|
const char *name;
|
2010-03-01 18:43:38 +00:00
|
|
|
|
void *address;
|
2001-06-02 17:46:38 +00:00
|
|
|
|
} lt_dlsymlist;
|
|
|
|
|
|
2010-03-01 18:43:38 +00:00
|
|
|
|
typedef int lt_dlpreload_callback_func (lt_dlhandle handle);
|
2001-06-02 17:46:38 +00:00
|
|
|
|
|
2010-03-01 18:43:38 +00:00
|
|
|
|
LT_SCOPE int lt_dlpreload (const lt_dlsymlist *preloaded);
|
|
|
|
|
LT_SCOPE int lt_dlpreload_default (const lt_dlsymlist *preloaded);
|
|
|
|
|
LT_SCOPE int lt_dlpreload_open (const char *originator,
|
|
|
|
|
lt_dlpreload_callback_func *func);
|
|
|
|
|
|
|
|
|
|
#define lt_preloaded_symbols lt__PROGRAM__LTX_preloaded_symbols
|
|
|
|
|
#define LTDL_SET_PRELOADED_SYMBOLS() LT_STMT_START{ \
|
2001-06-02 17:46:38 +00:00
|
|
|
|
extern const lt_dlsymlist lt_preloaded_symbols[]; \
|
|
|
|
|
lt_dlpreload_default(lt_preloaded_symbols); \
|
2010-03-01 18:43:38 +00:00
|
|
|
|
}LT_STMT_END
|
2001-06-02 17:46:38 +00:00
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
/* --- MODULE INFORMATION --- */
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
/* Associating user data with loaded modules. */
|
2010-03-01 18:43:38 +00:00
|
|
|
|
typedef void * lt_dlinterface_id;
|
|
|
|
|
typedef int lt_dlhandle_interface (lt_dlhandle handle, const char *id_string);
|
2001-06-02 17:46:38 +00:00
|
|
|
|
|
2010-03-01 18:43:38 +00:00
|
|
|
|
LT_SCOPE lt_dlinterface_id lt_dlinterface_register (const char *id_string,
|
|
|
|
|
lt_dlhandle_interface *iface);
|
|
|
|
|
LT_SCOPE void lt_dlinterface_free (lt_dlinterface_id key);
|
|
|
|
|
LT_SCOPE void * lt_dlcaller_set_data (lt_dlinterface_id key,
|
|
|
|
|
lt_dlhandle handle, void *data);
|
|
|
|
|
LT_SCOPE void * lt_dlcaller_get_data (lt_dlinterface_id key,
|
|
|
|
|
lt_dlhandle handle);
|
2001-06-02 17:46:38 +00:00
|
|
|
|
|
|
|
|
|
|
2010-03-01 18:43:38 +00:00
|
|
|
|
/* 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. */
|
|
|
|
|
unsigned int is_resident:1; /* module can't be unloaded. */
|
|
|
|
|
unsigned int is_symglobal:1; /* module symbols can satisfy
|
|
|
|
|
subsequently loaded modules. */
|
|
|
|
|
unsigned int is_symlocal:1; /* module symbols are only available
|
|
|
|
|
locally. */
|
|
|
|
|
} lt_dlinfo;
|
2001-06-02 17:46:38 +00:00
|
|
|
|
|
2010-03-01 18:43:38 +00:00
|
|
|
|
LT_SCOPE const lt_dlinfo *lt_dlgetinfo (lt_dlhandle handle);
|
2001-06-02 17:46:38 +00:00
|
|
|
|
|
2010-03-01 18:43:38 +00:00
|
|
|
|
LT_SCOPE lt_dlhandle lt_dlhandle_iterate (lt_dlinterface_id iface,
|
|
|
|
|
lt_dlhandle place);
|
|
|
|
|
LT_SCOPE lt_dlhandle lt_dlhandle_fetch (lt_dlinterface_id iface,
|
|
|
|
|
const char *module_name);
|
|
|
|
|
LT_SCOPE int lt_dlhandle_map (lt_dlinterface_id iface,
|
|
|
|
|
int (*func) (lt_dlhandle handle, void *data),
|
|
|
|
|
void *data);
|
2001-06-02 17:46:38 +00:00
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
2010-03-01 18:43:38 +00:00
|
|
|
|
/* Deprecated module residency management API. */
|
|
|
|
|
LT_SCOPE int lt_dlmakeresident (lt_dlhandle handle);
|
|
|
|
|
LT_SCOPE int lt_dlisresident (lt_dlhandle handle);
|
2001-06-02 17:46:38 +00:00
|
|
|
|
|
2010-03-01 18:43:38 +00:00
|
|
|
|
#define lt_ptr void *
|
2001-06-02 17:46:38 +00:00
|
|
|
|
|
|
|
|
|
LT_END_C_DECLS
|
|
|
|
|
|
2010-03-01 18:43:38 +00:00
|
|
|
|
#endif /*!defined(LTDL_H)*/
|