1 /* User functions for run-time dynamic loading.
2 Copyright (C) 1995-1999, 2000 Free Software Foundation, Inc.
3 This file is part of the GNU C Library.
5 The GNU C Library is free software; you can redistribute it and/or
6 modify it under the terms of the GNU Lesser General Public
7 License as published by the Free Software Foundation; either
8 version 2.1 of the License, or (at your option) any later version.
10 The GNU C Library is distributed in the hope that it will be useful,
11 but WITHOUT ANY WARRANTY; without even the implied warranty of
12 MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the GNU
13 Lesser General Public License for more details.
15 You should have received a copy of the GNU Lesser General Public
16 License along with the GNU C Library; if not, write to the Free
17 Software Foundation, Inc., 59 Temple Place, Suite 330, Boston, MA
27 /* Collect various system dependent definitions and declarations. */
28 #include <bits/dlfcn.h>
32 /* If the first argument of `dlsym' or `dlvsym' is set to RTLD_NEXT
33 the run-time address of the symbol called NAME in the next shared
34 object is returned. The "next" relation is defined by the order
35 the shared objects were loaded. */
36 # define RTLD_NEXT ((void *) -1l)
38 /* If the first argument to `dlsym' or `dlvsym' is set to RTLD_DEFAULT
39 the run-time address of the symbol called NAME in the global scope
41 # define RTLD_DEFAULT ((void *) 0)
46 /* Open the shared object FILE and map it in; return a handle that can be
47 passed to `dlsym' to get symbol values from it. */
48 extern void *dlopen (__const char *__file, int __mode) __THROW;
50 /* Unmap and close a shared object opened by `dlopen'.
51 The handle cannot be used again after calling `dlclose'. */
52 extern int dlclose (void *__handle) __THROW;
54 /* Find the run-time address in the shared object HANDLE refers to
55 of the symbol called NAME. */
56 extern void *dlsym (void *__restrict __handle,
57 __const char *__restrict __name) __THROW;
59 /* When any of the above functions fails, call this function
60 to return a string describing the error. Each call resets
61 the error string so that a following call returns null. */
62 extern char *dlerror (void) __THROW;
65 /* Structure containing information about object searched using
69 __const char *dli_fname; /* File name of defining object. */
70 void *dli_fbase; /* Load address of that object. */
71 __const char *dli_sname; /* Name of nearest symbol. */
72 void *dli_saddr; /* Exact value of nearest symbol. */
75 /* Fill in *INFO with the following information about ADDRESS.
76 Returns 0 iff no shared object's segments contain that address. */
77 extern int dladdr (const void *__address, Dl_info *__info) __THROW;
79 /* Get information about the shared objects currently loaded */
80 extern int dlinfo (void);