xref: /openbsd/include/dlfcn.h (revision 3cab2bb3)
1 /*	$OpenBSD: dlfcn.h,v 1.14 2017/11/28 17:19:47 kettenis Exp $	*/
2 /*	$NetBSD: dlfcn.h,v 1.2 1995/06/05 19:38:00 pk Exp $	*/
3 
4 /*
5  * Copyright (c) 1995 Paul Kranenburg
6  * All rights reserved.
7  *
8  * Redistribution and use in source and binary forms, with or without
9  * modification, are permitted provided that the following conditions
10  * are met:
11  * 1. Redistributions of source code must retain the above copyright
12  *    notice, this list of conditions and the following disclaimer.
13  * 2. Redistributions in binary form must reproduce the above copyright
14  *    notice, this list of conditions and the following disclaimer in the
15  *    documentation and/or other materials provided with the distribution.
16  * 3. All advertising materials mentioning features or use of this software
17  *    must display the following acknowledgement:
18  *      This product includes software developed by Paul Kranenburg.
19  * 4. The name of the author may not be used to endorse or promote products
20  *    derived from this software without specific prior written permission
21  *
22  * THIS SOFTWARE IS PROVIDED BY THE AUTHOR ``AS IS'' AND ANY EXPRESS OR
23  * IMPLIED WARRANTIES, INCLUDING, BUT NOT LIMITED TO, THE IMPLIED WARRANTIES
24  * OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE ARE DISCLAIMED.
25  * IN NO EVENT SHALL THE AUTHOR BE LIABLE FOR ANY DIRECT, INDIRECT,
26  * INCIDENTAL, SPECIAL, EXEMPLARY, OR CONSEQUENTIAL DAMAGES (INCLUDING, BUT
27  * NOT LIMITED TO, PROCUREMENT OF SUBSTITUTE GOODS OR SERVICES; LOSS OF USE,
28  * DATA, OR PROFITS; OR BUSINESS INTERRUPTION) HOWEVER CAUSED AND ON ANY
29  * THEORY OF LIABILITY, WHETHER IN CONTRACT, STRICT LIABILITY, OR TORT
30  * (INCLUDING NEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY OUT OF THE USE OF
31  * THIS SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF SUCH DAMAGE.
32  */
33 
34 #ifndef _DLFCN_H_
35 #define _DLFCN_H_
36 
37 #include <sys/cdefs.h>
38 
39 /* Values for dlopen `mode'. */
40 #define RTLD_LAZY	1
41 #define RTLD_NOW	2
42 #define RTLD_GLOBAL	0x100
43 #define RTLD_LOCAL	0x000
44 #define RTLD_TRACE	0x200
45 
46 /*
47  * Special handle arguments for dlsym().
48  */
49 #define	RTLD_NEXT	((void *) -1)	/* Search subsequent objects. */
50 #define	RTLD_DEFAULT	((void *) -2)	/* Use default search algorithm. */
51 #define	RTLD_SELF	((void *) -3)	/* Search the caller itself. */
52 
53 #if __BSD_VISIBLE
54 
55 /*
56  * Structure filled in by dladdr().
57  */
58 typedef	struct dl_info {
59 	const char	*dli_fname;	/* Pathname of shared object. */
60 	void		*dli_fbase;	/* Base address of shared object. */
61 	const char	*dli_sname;	/* Name of nearest symbol. */
62 	void		*dli_saddr;	/* Address of nearest symbol. */
63 } Dl_info;
64 
65 /*
66  * dlctl() commands
67  */
68 #define DL_GETERRNO	1
69 #define DL_SETSRCHPATH	x
70 #define DL_GETLIST	x
71 #define DL_GETREFCNT	x
72 #define DL_GETLOADADDR	x
73 #define DL_SETTHREADLCK	2
74 #define DL_SETBINDLCK	3
75 #define DL_REFERENCE	4
76 
77 #define	DL_LAZY		RTLD_LAZY	/* Compat */
78 
79 #endif /* __BSD_VISIBLE */
80 
81 
82 /*
83  * User interface to the run-time linker.
84  */
85 __BEGIN_DECLS
86 void	*dlopen(const char *, int);
87 int	dlclose(void *);
88 void	*dlsym(void *__restrict, const char *__restrict);
89 char	*dlerror(void);
90 
91 #if __BSD_VISIBLE
92 int	dladdr(const void *, Dl_info *);
93 int	dlctl(void *, int, void *);
94 #endif /* __BSD_VISIBLE */
95 
96 __END_DECLS
97 
98 #endif /* _DLFCN_H_ */
99