alloca: fix buf interaction
[glibc.git] / include / dlfcn.h
bloba67b2e3251e652c94cfcffad69422ff18949c30d
1 #ifndef _DLFCN_H
2 #include <dlfcn/dlfcn.h>
3 #ifndef _ISOMAC
4 #include <link.h> /* For ElfW. */
5 #include <stdbool.h>
7 /* Internally used flag. */
8 #define __RTLD_DLOPEN 0x80000000
9 #define __RTLD_SPROF 0x40000000
10 #define __RTLD_OPENEXEC 0x20000000
11 #define __RTLD_CALLMAP 0x10000000
12 #define __RTLD_AUDIT 0x08000000
13 #define __RTLD_SECURE 0x04000000 /* Apply additional security checks. */
14 #define __RTLD_NOIFUNC 0x02000000 /* Suppress calling ifunc functions. */
16 #define __LM_ID_CALLER -2
18 #ifdef SHARED
19 /* Locally stored program arguments. */
20 extern int __dlfcn_argc attribute_hidden;
21 extern char **__dlfcn_argv attribute_hidden;
22 #else
23 /* These variables are defined and initialized in the startup code. */
24 extern int __libc_argc attribute_hidden;
25 extern char **__libc_argv attribute_hidden;
27 # define __dlfcn_argc __libc_argc
28 # define __dlfcn_argv __libc_argv
29 #endif
32 /* Now define the internal interfaces. */
34 #define __libc_dlopen(name) \
35 __libc_dlopen_mode (name, RTLD_LAZY | __RTLD_DLOPEN)
36 extern void *__libc_dlopen_mode (const char *__name, int __mode);
37 extern void *__libc_dlsym (void *__map, const char *__name);
38 extern int __libc_dlclose (void *__map);
39 libc_hidden_proto (__libc_dlopen_mode)
40 libc_hidden_proto (__libc_dlsym)
41 libc_hidden_proto (__libc_dlclose)
43 /* Locate shared object containing the given address. */
44 #ifdef ElfW
45 extern int _dl_addr (const void *address, Dl_info *info,
46 struct link_map **mapp, const ElfW(Sym) **symbolp)
47 internal_function;
48 libc_hidden_proto (_dl_addr)
49 #endif
51 struct link_map;
53 /* Close an object previously opened by _dl_open. */
54 extern void _dl_close (void *map) attribute_hidden;
55 /* Same as above, but without locking and safety checks for user
56 provided map arguments. */
57 extern void _dl_close_worker (struct link_map *map) attribute_hidden;
59 /* Look up NAME in shared object HANDLE (which may be RTLD_DEFAULT or
60 RTLD_NEXT). WHO is the calling function, for RTLD_NEXT. Returns
61 the symbol value, which may be NULL. */
62 extern void *_dl_sym (void *handle, const char *name, void *who)
63 internal_function;
65 /* Look up version VERSION of symbol NAME in shared object HANDLE
66 (which may be RTLD_DEFAULT or RTLD_NEXT). WHO is the calling
67 function, for RTLD_NEXT. Returns the symbol value, which may be
68 NULL. */
69 extern void *_dl_vsym (void *handle, const char *name, const char *version,
70 void *who)
71 internal_function;
73 /* Call OPERATE, catching errors from `dl_signal_error'. If there is no
74 error, *ERRSTRING is set to null. If there is an error, *ERRSTRING is
75 set to a string constructed from the strings passed to _dl_signal_error,
76 and the error code passed is the return value and *OBJNAME is set to
77 the object name which experienced the problems. ERRSTRING if nonzero
78 points to a malloc'ed string which the caller has to free after use.
79 ARGS is passed as argument to OPERATE. MALLOCEDP is set to true only
80 if the returned string is allocated using the libc's malloc. */
81 extern int _dl_catch_error (const char **objname, const char **errstring,
82 bool *mallocedp, void (*operate) (void *),
83 void *args)
84 internal_function;
86 /* Helper function for <dlfcn.h> functions. Runs the OPERATE function via
87 _dl_catch_error. Returns zero for success, nonzero for failure; and
88 arranges for `dlerror' to return the error details.
89 ARGS is passed as argument to OPERATE. */
90 extern int _dlerror_run (void (*operate) (void *), void *args)
91 internal_function;
93 #ifdef SHARED
94 # define DL_CALLER_DECL /* Nothing */
95 # define DL_CALLER RETURN_ADDRESS (0)
96 #else
97 # define DL_CALLER_DECL , void *dl_caller
98 # define DL_CALLER dl_caller
99 #endif
101 struct dlfcn_hook
103 void *(*dlopen) (const char *file, int mode, void *dl_caller);
104 int (*dlclose) (void *handle);
105 void *(*dlsym) (void *handle, const char *name, void *dl_caller);
106 void *(*dlvsym) (void *handle, const char *name, const char *version,
107 void *dl_caller);
108 char *(*dlerror) (void);
109 int (*dladdr) (const void *address, Dl_info *info);
110 int (*dladdr1) (const void *address, Dl_info *info,
111 void **extra_info, int flags);
112 int (*dlinfo) (void *handle, int request, void *arg, void *dl_caller);
113 void *(*dlmopen) (Lmid_t nsid, const char *file, int mode, void *dl_caller);
114 void *pad[4];
117 extern struct dlfcn_hook *_dlfcn_hook;
118 libdl_hidden_proto (_dlfcn_hook)
120 extern void *__dlopen (const char *file, int mode DL_CALLER_DECL)
121 attribute_hidden;
122 extern void *__dlmopen (Lmid_t nsid, const char *file, int mode DL_CALLER_DECL)
123 attribute_hidden;
124 extern int __dlclose (void *handle)
125 attribute_hidden;
126 extern void *__dlsym (void *handle, const char *name DL_CALLER_DECL)
127 attribute_hidden;
128 extern void *__dlvsym (void *handle, const char *name, const char *version
129 DL_CALLER_DECL)
130 attribute_hidden;
131 extern char *__dlerror (void)
132 attribute_hidden;
133 extern int __dladdr (const void *address, Dl_info *info)
134 attribute_hidden;
135 extern int __dladdr1 (const void *address, Dl_info *info,
136 void **extra_info, int flags)
137 attribute_hidden;
138 extern int __dlinfo (void *handle, int request, void *arg DL_CALLER_DECL)
139 attribute_hidden;
141 #ifndef SHARED
142 struct link_map;
143 extern void * __libc_dlsym_private (struct link_map *map, const char *name)
144 attribute_hidden;
145 extern void __libc_register_dl_open_hook (struct link_map *map)
146 attribute_hidden;
147 extern void __libc_register_dlfcn_hook (struct link_map *map)
148 attribute_hidden;
149 #endif
150 #endif
152 #endif