[BZ #77]
[platform/upstream/glibc.git] / include / dlfcn.h
1 #ifndef _DLFCN_H
2 #include <dlfcn/dlfcn.h>
3 #include <link.h>               /* For ElfW.  */
4
5 /* Internally used flag.  */
6 #define __RTLD_DLOPEN   0x80000000
7 #define __RTLD_SPROF    0x40000000
8 #define __RTLD_OPENEXEC 0x20000000
9 #define __RTLD_CALLMAP  0x10000000
10
11 #define __LM_ID_CALLER  -2
12
13 /* Now define the internal interfaces.  */
14 extern void *__dlvsym (void *__handle, __const char *__name,
15                        __const char *__version);
16
17 #define __libc_dlopen(name) __libc_dlopen_mode (name, RTLD_LAZY)
18 extern void *__libc_dlopen_mode  (__const char *__name, int __mode);
19 extern void *__libc_dlsym   (void *__map, __const char *__name);
20 extern int   __libc_dlclose (void *__map);
21 libc_hidden_proto (__libc_dlopen_mode)
22 libc_hidden_proto (__libc_dlsym)
23 libc_hidden_proto (__libc_dlclose)
24
25 /* Locate shared object containing the given address.  */
26 #ifdef ElfW
27 extern int _dl_addr (const void *address, Dl_info *info,
28                      struct link_map **mapp, const ElfW(Sym) **symbolp)
29      internal_function;
30 libc_hidden_proto (_dl_addr)
31 #endif
32
33 /* Open the shared object NAME, relocate it, and run its initializer if it
34    hasn't already been run.  MODE is as for `dlopen' (see <dlfcn.h>).  If
35    the object is already opened, returns its existing map.  */
36 extern void *_dl_open (const char *name, int mode, const void *caller,
37                        Lmid_t nsid)
38      internal_function;
39 libc_hidden_proto (_dl_open)
40
41 /* Close an object previously opened by _dl_open.  */
42 extern void _dl_close (void *map)
43      internal_function;
44 libc_hidden_proto (_dl_close)
45
46 /* Look up NAME in shared object HANDLE (which may be RTLD_DEFAULT or
47    RTLD_NEXT).  WHO is the calling function, for RTLD_NEXT.  Returns
48    the symbol value, which may be NULL.  */
49 extern void *_dl_sym (void *handle, const char *name, void *who)
50     internal_function;
51
52 /* Look up version VERSION of symbol NAME in shared object HANDLE
53    (which may be RTLD_DEFAULT or RTLD_NEXT).  WHO is the calling
54    function, for RTLD_NEXT.  Returns the symbol value, which may be
55    NULL.  */
56 extern void *_dl_vsym (void *handle, const char *name, const char *version,
57                        void *who)
58     internal_function;
59
60 /* Call OPERATE, catching errors from `dl_signal_error'.  If there is no
61    error, *ERRSTRING is set to null.  If there is an error, *ERRSTRING is
62    set to a string constructed from the strings passed to _dl_signal_error,
63    and the error code passed is the return value and *OBJNAME is set to
64    the object name which experienced the problems.  ERRSTRING if nonzero
65    points to a malloc'ed string which the caller has to free after use.
66    ARGS is passed as argument to OPERATE.  */
67 extern int _dl_catch_error (const char **objname, const char **errstring,
68                             void (*operate) (void *),
69                             void *args)
70      internal_function;
71
72 /* Helper function for <dlfcn.h> functions.  Runs the OPERATE function via
73    _dl_catch_error.  Returns zero for success, nonzero for failure; and
74    arranges for `dlerror' to return the error details.
75    ARGS is passed as argument to OPERATE.  */
76 extern int _dlerror_run (void (*operate) (void *), void *args)
77      internal_function;
78
79 #endif