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