xref: /netbsd/include/dlfcn.h (revision 44436c4d)
1 /*	$NetBSD: dlfcn.h,v 1.25 2017/07/11 15:21:35 joerg 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  *
19  * THIS SOFTWARE IS PROVIDED BY THE NETBSD FOUNDATION, INC. AND CONTRIBUTORS
20  * ``AS IS'' AND ANY EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT LIMITED
21  * TO, THE IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR
22  * PURPOSE ARE DISCLAIMED.  IN NO EVENT SHALL THE FOUNDATION OR CONTRIBUTORS
23  * BE LIABLE FOR ANY DIRECT, INDIRECT, INCIDENTAL, SPECIAL, EXEMPLARY, OR
24  * CONSEQUENTIAL DAMAGES (INCLUDING, BUT NOT LIMITED TO, PROCUREMENT OF
25  * SUBSTITUTE GOODS OR SERVICES; LOSS OF USE, DATA, OR PROFITS; OR BUSINESS
26  * INTERRUPTION) HOWEVER CAUSED AND ON ANY THEORY OF LIABILITY, WHETHER IN
27  * CONTRACT, STRICT LIABILITY, OR TORT (INCLUDING NEGLIGENCE OR OTHERWISE)
28  * ARISING IN ANY WAY OUT OF THE USE OF THIS SOFTWARE, EVEN IF ADVISED OF THE
29  * POSSIBILITY OF SUCH DAMAGE.
30  */
31 
32 #ifndef _DLFCN_H_
33 #define _DLFCN_H_
34 
35 #include <sys/featuretest.h>
36 #include <sys/cdefs.h>
37 #include <machine/ansi.h>
38 
39 #ifdef	_BSD_SSIZE_T_
40 typedef	_BSD_SSIZE_T_	ssize_t;
41 #undef	_BSD_SSIZE_T_
42 #endif
43 
44 #if defined(_NETBSD_SOURCE)
45 typedef struct _dl_info {
46 	const char	*dli_fname;	/* File defining the symbol */
47 	void		*dli_fbase;	/* Base address */
48 	const char	*dli_sname;	/* Symbol name */
49 	const void	*dli_saddr;	/* Symbol address */
50 } Dl_info;
51 #endif /* defined(_NETBSD_SOURCE) */
52 
53 /*
54  * User interface to the run-time linker.
55  */
56 __BEGIN_DECLS
57 void *_dlauxinfo(void) __pure;
58 
59 void	*dlopen(const char *, int);
60 int	dlclose(void *);
61 void	*dlsym(void * __restrict, const char * __restrict);
62 #if defined(_NETBSD_SOURCE)
63 int	dladdr(const void * __restrict, Dl_info * __restrict);
64 int	dlctl(void *, int, void *);
65 int	dlinfo(void *, int, void *);
66 void	*dlvsym(void * __restrict, const char * __restrict,
67 	    const char * __restrict);
68 void	__dl_cxa_refcount(void *, ssize_t);
69 #endif
70 __aconst char *dlerror(void);
71 __END_DECLS
72 
73 /* Values for dlopen `mode'. */
74 #define RTLD_LAZY	1
75 #define RTLD_NOW	2
76 #define RTLD_GLOBAL	0x100		/* Allow global searches in object */
77 #define RTLD_LOCAL	0x200
78 #define RTLD_NODELETE	0x01000		/* Do not remove members. */
79 #define RTLD_NOLOAD	0x02000		/* Do not load if not already loaded. */
80 #if defined(_NETBSD_SOURCE)
81 #define DL_LAZY		RTLD_LAZY	/* Compat */
82 #endif
83 
84 /*
85  * Special handle arguments for dlsym().
86  */
87 #define	RTLD_NEXT	((void *) -1)	/* Search subsequent objects. */
88 #define	RTLD_DEFAULT	((void *) -2)	/* Use default search algorithm. */
89 #define	RTLD_SELF	((void *) -3)	/* Search the caller itself. */
90 
91 /*
92  * dlctl() commands
93  */
94 #if defined(_NETBSD_SOURCE)
95 #define DL_GETERRNO	1
96 #define DL_GETSYMBOL	2
97 #if 0
98 #define DL_SETSRCHPATH	x
99 #define DL_GETLIST	x
100 #define DL_GETREFCNT	x
101 #define DL_GETLOADADDR	x
102 #endif /* 0 */
103 #endif /* defined(_NETBSD_SOURCE) */
104 
105 /*
106  * dlinfo() commands
107  *
108  * From Solaris: http://docs.sun.com/app/docs/doc/816-5168/dlinfo-3c?a=view
109  */
110 #if defined(_NETBSD_SOURCE)
111 #define RTLD_DI_LINKMAP		3
112 #if 0
113 #define RTLD_DI_ARGSINFO	1
114 #define RTLD_DI_CONFIGADDR	2
115 #define RTLD_DI_LMID		4
116 #define RTLD_DI_SERINFO		5
117 #define RTLD_DI_SERINFOSIZE	6
118 #define RTLD_DI_ORIGIN		7
119 #define RTLD_DI_GETSIGNAL	8
120 #define RTLD_DI_SETSIGNAL	9
121 #endif
122 #endif /* _NETBSD_SOURCE */
123 
124 #endif /* !defined(_DLFCN_H_) */
125