]>
git.ipfire.org Git - thirdparty/glibc.git/blob - elf/dlfcn.h
b59bebd5b1c96fab0d7bf09596baeaf20308ea20
1 /* dlfcn.h -- User functions for run-time dynamic loading.
2 Copyright (C) 1995, 1996 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 Library General Public License as
7 published by the Free Software Foundation; either version 2 of the
8 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 Library General Public License for more details.
15 You should have received a copy of the GNU Library General Public
16 License along with the GNU C Library; see the file COPYING.LIB. If not,
17 write to the Free Software Foundation, Inc., 59 Temple Place - Suite 330,
18 Boston, MA 02111-1307, USA. */
25 /* The MODE argument to `dlopen' contains one of the following: */
26 #define RTLD_LAZY 0x001 /* Lazy function call binding. */
27 #define RTLD_NOW 0x002 /* Immediate function call binding. */
28 #define RTLD_BINDING_MASK 0x3 /* Mask of binding time value. */
30 /* If the following bit is set in the MODE argument to `dlopen',
31 the symbols of the loaded object and its dependencies are made
32 visible as if the object were linked directly into the program. */
33 #define RTLD_GLOBAL 0x100
35 /* Open the shared object FILE and map it in; return a handle that can be
36 passed to `dlsym' to get symbol values from it. */
37 extern void *dlopen
__P ((__const
char *__file
, int __mode
));
39 /* Unmap and close a shared object opened by `dlopen'.
40 The handle cannot be used again after calling `dlclose'. */
41 extern int dlclose
__P ((void *__handle
));
43 /* Find the run-time address in the shared object HANDLE refers to
44 of the symbol called NAME. */
45 extern void *dlsym
__P ((void *__handle
, __const
char *__name
));
47 /* When any of the above functions fails, call this function
48 to return a string describing the error. Each call resets
49 the error string so that a following call returns null. */
50 extern char *dlerror
__P ((void));
52 /* Fill in *INFO with the following information about ADDRESS.
53 Returns 0 iff no shared object's segments contain that address. */
56 __const
char *dli_fname
; /* File name of defining object. */
57 void *dli_fbase
; /* Load address of that object. */
58 __const
char *dli_sname
; /* Name of nearest symbol. */
59 void *dli_saddr
; /* Exact value of nearest symbol. */
61 extern int dladdr
__P ((void *__address
, Dl_info
*__info
));