1 /*
2 * CDDL HEADER START
3 *
4 * The contents of this file are subject to the terms of the
5 * Common Development and Distribution License (the "License").
6 * You may not use this file except in compliance with the License.
7 *
8 * You can obtain a copy of the license at usr/src/OPENSOLARIS.LICENSE
9 * or http://www.opensolaris.org/os/licensing.
10 * See the License for the specific language governing permissions
11 * and limitations under the License.
12 *
13 * When distributing Covered Code, include this CDDL HEADER in each
14 * file and include the License file at usr/src/OPENSOLARIS.LICENSE.
15 * If applicable, add the following below this CDDL HEADER, with the
16 * fields enclosed by brackets "[]" replaced with your own identifying
17 * information: Portions Copyright [yyyy] [name of copyright owner]
18 *
19 * CDDL HEADER END
20 */
21 /*
22 * Copyright (c) 1989, 2010, Oracle and/or its affiliates. All rights reserved.
23 *
24 * Copyright (c) 1989 AT&T
25 * All Rights Reserved
26 *
27 */
28
29 #ifndef _DLFCN_H
30 #define _DLFCN_H
31
32 #include <sys/feature_tests.h>
33 #include <sys/types.h>
34 #if !defined(_XOPEN_SOURCE) || defined(__EXTENSIONS__)
35 #include <sys/auxv.h>
36 #include <sys/mman.h>
37 #endif /* !defined(_XOPEN_SOURCE) || defined(__EXTENSIONS__) */
38
39 #ifdef __cplusplus
40 extern "C" {
41 #endif
42
43 /*
44 * Information structures for various dlinfo() requests.
45 */
46 #if !defined(_XOPEN_SOURCE) || defined(__EXTENSIONS__)
47 #ifdef __STDC__
48 typedef struct dl_info {
49 const char *dli_fname; /* file containing address range */
50 void *dli_fbase; /* base address of file image */
51 const char *dli_sname; /* symbol name */
52 void *dli_saddr; /* symbol address */
53 } Dl_info;
54 #else
55 typedef struct dl_info {
56 char *dli_fname;
57 void *dli_fbase;
58 char *dli_sname;
59 void *dli_saddr;
60 } Dl_info;
61 #endif /* __STDC__ */
62 typedef Dl_info Dl_info_t;
63
64 typedef struct dl_serpath {
65 char *dls_name; /* library search path name */
66 uint_t dls_flags; /* path information */
67 } Dl_serpath;
68 typedef Dl_serpath Dl_serpath_t;
69
70 typedef struct dl_serinfo {
71 size_t dls_size; /* total buffer size */
72 uint_t dls_cnt; /* number of path entries */
73 Dl_serpath dls_serpath[1]; /* there may be more than one */
74 } Dl_serinfo;
75 typedef Dl_serinfo Dl_serinfo_t;
76
77 typedef struct dl_argsinfo {
78 long dla_argc; /* process argument count */
79 char **dla_argv; /* process arguments */
80 char **dla_envp; /* process environment variables */
81 auxv_t *dla_auxv; /* process auxv vectors */
82 } Dl_argsinfo;
83 typedef Dl_argsinfo Dl_argsinfo_t;
84
85 typedef struct {
86 mmapobj_result_t *dlm_maps; /* mapping information */
87 uint_t dlm_acnt; /* number of dlm_maps mappings */
88 uint_t dlm_rcnt; /* number of returned mappings */
89 } Dl_mapinfo_t;
90
91 typedef struct {
92 uint_t dlui_version; /* version # */
93 uint_t dlui_flags; /* flags */
94 char *dlui_objname; /* path to object */
95 void *dlui_unwindstart; /* star of unwind hdr */
96 void *dlui_unwindend; /* end of unwind hdr */
97 void *dlui_segstart; /* start of segment described */
98 /* by unwind block */
99 void *dlui_segend; /* end of segment described */
100 /* by unwind block */
101 } Dl_amd64_unwindinfo;
102 typedef Dl_amd64_unwindinfo Dl_amd64_unwindinfo_t;
103
104 typedef struct {
105 const char *dld_refname; /* reference name */
106 const char *dld_depname; /* new dependency name */
107 } Dl_definfo_t;
108
109 #endif /* !defined(_XOPEN_SOURCE) || defined(__EXTENSIONS__) */
110
111
112 typedef ulong_t Lmid_t;
113
114 /*
115 * Declarations used for dynamic linking support routines.
116 */
117 #ifdef __STDC__
118 extern void *dlopen(const char *, int);
119 extern void *dlsym(void *_RESTRICT_KYWD, const char *_RESTRICT_KYWD);
120 extern int dlclose(void *);
121 extern char *dlerror(void);
122 #if !defined(_XOPEN_SOURCE) || defined(__EXTENSIONS__)
123 extern void *dlmopen(Lmid_t, const char *, int);
124 extern int dladdr(void *, Dl_info *);
125 extern int dladdr1(void *, Dl_info *, void **, int);
126 extern int dldump(const char *, const char *, int);
127 extern int dlinfo(void *, int, void *);
128 extern Dl_amd64_unwindinfo *dlamd64getunwind(void *, Dl_amd64_unwindinfo *);
129 #endif /* !defined(_XOPEN_SOURCE) || defined(__EXTENSIONS__) */
130 #else
131 extern void *dlopen();
132 extern void *dlsym();
133 extern int dlclose();
134 extern char *dlerror();
135 #if !defined(_XOPEN_SOURCE) || defined(__EXTENSIONS__)
136 extern void *dlmopen();
137 extern int dladdr();
138 extern int dladdr1();
139 extern int dldump();
140 extern int dlinfo();
141 extern Dl_amd64_unwindinfo *dlamd64getunwind();
142 #endif /* !defined(_XOPEN_SOURCE) || defined(__EXTENSIONS__) */
143 #endif /* __STDC__ */
144
145 #pragma unknown_control_flow(dlopen, dlsym, dlclose, dlerror)
146 #if !defined(_XOPEN_SOURCE) || defined(__EXTENSIONS__)
147 #pragma unknown_control_flow(dlmopen, dladdr, dladdr1, dldump, dlinfo)
148 #endif /* !defined(_XOPEN_SOURCE) || defined(__EXTENSIONS__) */
149
150 /*
151 * Valid values for handle argument to dlsym(3x).
152 */
153 #define RTLD_NEXT (void *)-1 /* look in `next' dependency */
154 #define RTLD_DEFAULT (void *)-2 /* look up symbol from scope */
155 /* of current object */
156 #define RTLD_SELF (void *)-3 /* look in `ourself' */
157 #define RTLD_PROBE (void *)-4 /* look up symbol from scope */
158 /* of current object, */
159 /* using currently */
160 /* loaded objects only. */
161 /*
162 * Valid values for mode argument to dlopen.
163 */
164 #define RTLD_LAZY 0x00001 /* deferred function binding */
165 #define RTLD_NOW 0x00002 /* immediate function binding */
166 #define RTLD_NOLOAD 0x00004 /* don't load object */
167
168 #define RTLD_GLOBAL 0x00100 /* export symbols to others */
169 #define RTLD_LOCAL 0x00000 /* symbols are only available */
170 /* to group members */
171 #define RTLD_PARENT 0x00200 /* add parent (caller) to */
172 /* a group dependencies */
173 #define RTLD_GROUP 0x00400 /* resolve symbols within */
174 /* members of the group */
175 #define RTLD_WORLD 0x00800 /* resolve symbols within */
176 /* global objects */
177 #define RTLD_NODELETE 0x01000 /* do not remove members */
178 #define RTLD_FIRST 0x02000 /* only first object is */
179 /* available for dlsym */
180 #define RTLD_CONFGEN 0x10000 /* crle(1) config generation */
181 /* internal use only */
182
183 /*
184 * Valid values for flag argument to dldump.
185 */
186 #define RTLD_REL_RELATIVE 0x00001 /* apply relative relocs */
187 #define RTLD_REL_EXEC 0x00002 /* apply symbolic relocs that */
188 /* bind to main */
189 #define RTLD_REL_DEPENDS 0x00004 /* apply symbolic relocs that */
190 /* bind to dependencies */
191 #define RTLD_REL_PRELOAD 0x00008 /* apply symbolic relocs that */
192 /* bind to preload objs */
193 #define RTLD_REL_SELF 0x00010 /* apply symbolic relocs that */
194 /* bind to ourself */
195 #define RTLD_REL_WEAK 0x00020 /* apply symbolic weak relocs */
196 /* even if unresolved */
197 #define RTLD_REL_ALL 0x00fff /* apply all relocs */
198
199 #define RTLD_MEMORY 0x01000 /* use memory sections */
200 #define RTLD_STRIP 0x02000 /* retain allocable sections */
201 /* only */
202 #define RTLD_NOHEAP 0x04000 /* do no save any heap */
203 #define RTLD_CONFSET 0x10000 /* crle(1) config generation */
204 /* internal use only */
205
206 /*
207 * Valid values for dladdr1() flags.
208 */
209 #define RTLD_DL_SYMENT 1 /* return symbol table entry */
210 #define RTLD_DL_LINKMAP 2 /* return public link-map */
211 #define RTLD_DL_MASK 0xffff
212
213
214 /*
215 * Arguments for dlinfo()
216 */
217 #define RTLD_DI_LMID 1 /* obtain link-map id */
218 #define RTLD_DI_LINKMAP 2 /* obtain link-map */
219 #define RTLD_DI_CONFIGADDR 3 /* obtain config addr */
220 #define RTLD_DI_SERINFO 4 /* obtain search path info or */
221 #define RTLD_DI_SERINFOSIZE 5 /* associated info size */
222 #define RTLD_DI_ORIGIN 6 /* obtain objects origin */
223 #define RTLD_DI_PROFILENAME 7 /* obtain profile object name */
224 /* internal use only */
225 #define RTLD_DI_PROFILEOUT 8 /* obtain profile output name */
226 /* internal use only */
227 #define RTLD_DI_GETSIGNAL 9 /* get termination signal */
228 #define RTLD_DI_SETSIGNAL 10 /* set termination signal */
229 #define RTLD_DI_ARGSINFO 11 /* get process arguments */
230 /* environment and auxv */
231 #define RTLD_DI_MMAPS 12 /* obtain objects mappings or */
232 #define RTLD_DI_MMAPCNT 13 /* mapping count */
233 #define RTLD_DI_DEFERRED 14 /* assign new dependency to a */
234 /* deferred dependency */
235 #define RTLD_DI_DEFERRED_SYM 15 /* assign new dependency to a */
236 /* deferred dependency */
237 /* using a symbol name */
238 #define RTLD_DI_MAX 15
239
240 #if !defined(_XOPEN_SOURCE) || defined(__EXTENSIONS__)
241 /*
242 * Version information for Dl_amd64_unwindinfo.dlui_version
243 */
244 #define DLUI_VERS_1 1
245 #define DLUI_VERS_CURRENT DLUI_VERS_1
246
247 /*
248 * Valid flags for Dl_amd64_unwindinfo.dlfi_flags
249 */
250 #define DLUI_FLG_NOUNWIND 0x0001 /* object has no Unwind info */
251 #define DLUI_FLG_NOOBJ 0x0002 /* no object was found */
252 /* matching the pc provided */
253 #endif /* !defined(_XOPEN_SOURCE) || defined(__EXTENSIONS__) */
254
255 #ifdef __cplusplus
256 }
257 #endif
258
259 #endif /* _DLFCN_H */