/* $OpenBSD: dlfcn.h,v 1.17 2024/09/01 04:27:45 guenther Exp $ */ /* $NetBSD: dlfcn.h,v 1.2 1995/06/05 19:38:00 pk Exp $ */ /* * Copyright (c) 1995 Paul Kranenburg * All rights reserved. * * Redistribution and use in source and binary forms, with or without * modification, are permitted provided that the following conditions * are met: * 1. Redistributions of source code must retain the above copyright * notice, this list of conditions and the following disclaimer. * 2. Redistributions in binary form must reproduce the above copyright * notice, this list of conditions and the following disclaimer in the * documentation and/or other materials provided with the distribution. * 3. All advertising materials mentioning features or use of this software * must display the following acknowledgement: * This product includes software developed by Paul Kranenburg. * 4. The name of the author may not be used to endorse or promote products * derived from this software without specific prior written permission * * THIS SOFTWARE IS PROVIDED BY THE AUTHOR ``AS IS'' AND ANY EXPRESS OR * IMPLIED WARRANTIES, INCLUDING, BUT NOT LIMITED TO, THE IMPLIED WARRANTIES * OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE ARE DISCLAIMED. * IN NO EVENT SHALL THE AUTHOR BE LIABLE FOR ANY DIRECT, INDIRECT, * INCIDENTAL, SPECIAL, EXEMPLARY, OR CONSEQUENTIAL DAMAGES (INCLUDING, BUT * NOT LIMITED TO, PROCUREMENT OF SUBSTITUTE GOODS OR SERVICES; LOSS OF USE, * DATA, OR PROFITS; OR BUSINESS INTERRUPTION) HOWEVER CAUSED AND ON ANY * THEORY OF LIABILITY, WHETHER IN CONTRACT, STRICT LIABILITY, OR TORT * (INCLUDING NEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY OUT OF THE USE OF * THIS SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF SUCH DAMAGE. */ #ifndef _DLFCN_H_ #define _DLFCN_H_ #include <sys/cdefs.h> /* Values for dlopen `mode'. */ #define RTLD_LAZY 1 #define RTLD_NOW 2 #define RTLD_GLOBAL 0x100 #define RTLD_LOCAL 0x000 #define RTLD_TRACE 0x200 #define RTLD_NODELETE 0x400 #define RTLD_NOLOAD 0x800 /* * Special handle arguments for dlsym(). */ #define RTLD_NEXT ((void *) -1) /* Search subsequent objects. */ #define RTLD_DEFAULT ((void *) -2) /* Use default search algorithm. */ #define RTLD_SELF ((void *) -3) /* Search the caller itself. */ #if __BSD_VISIBLE || __POSIX_VISIBLE >= 202405 /* * Structure filled in by dladdr(). */ typedef struct #if __BSD_VISIBLE dl_info #endif { const char *dli_fname; /* Pathname of shared object. */ void *dli_fbase; /* Base address of shared object. */ const char *dli_sname; /* Name of nearest symbol. */ void *dli_saddr; /* Address of nearest symbol. */ } Dl_info_t; #endif /* __BSD_VISIBLE || __POSIX_VISIBLE >= 202405 */ #if __BSD_VISIBLE typedef Dl_info_t Dl_info; /* * dlctl() commands */ #define DL_GETERRNO 1 #define DL_SETSRCHPATH x #define DL_GETLIST x #define DL_GETREFCNT x #define DL_GETLOADADDR x #define DL_SETTHREADLCK 2 #define DL_SETBINDLCK 3 #define DL_REFERENCE 4 #define DL_LAZY RTLD_LAZY /* Compat */ #endif /* __BSD_VISIBLE */ /* * User interface to the run-time linker. */ __BEGIN_DECLS void *dlopen(const char *, int); int dlclose(void *); void *dlsym(void *__restrict, const char *__restrict); char *dlerror(void); #if __BSD_VISIBLE || __POSIX_VISIBLE >= 202405 int dladdr(const void *__restrict, Dl_info_t *__restrict); #endif #if __BSD_VISIBLE int dlctl(void *, int, void *); #endif /* __BSD_VISIBLE */ __END_DECLS #endif /* _DLFCN_H_ */