:man| Alphabetical   Categories   About us 
 
DLADDR (3) | C library functions | Unix Manual Pages | :man

NAME

dladdr - find the shared object containing a given address

CONTENTS

Library
Synopsis
Description
Errors
See Also
History
Bugs

LIBRARY


.Lb libc

SYNOPSIS


.In dlfcn.h int dladdr "const void *addr" "Dl_info *info"

DESCRIPTION

The dladdr function queries the dynamic linker for information about the shared object containing the address addr. The information is returned in the structure specified by info. The structure contains at least the following members:
"const char *dli_fname" The pathname of the shared object containing the address.
"void *dli_fbase" The base address at which the shared object is mapped into the address space of the calling process.
"const char *dli_sname" The name of the nearest run-time symbol with a value less than or equal to addr. When possible, the symbol name is returned as it would appear in C source code.

If no symbol with a suitable value is found, both this field and dli_saddr are set to NULL.

"void *dli_saddr" The value of the symbol returned in dli_sname.

The dladdr function is available only in dynamically linked programs.

ERRORS

If a mapped shared object containing addr cannot be found, dladdr returns 0. In that case, a message detailing the failure can be retrieved by calling dlerror.

On success, a non-zero value is returned.

SEE ALSO

rtld(1), dlopen(3)

HISTORY

BUGS

 
Created by Blin Media, 2008-2013