dlsym()

obtain address of symbol from from dlopen() object 

Function


SYNOPSIS

#include <dlfcn.h>

void *dlsym(void *handle, const char *symbol);


DESCRIPTION

The dlsysm() function allows a process to obtain the address of a symbol defined within an object made accessible through a dlopen() call.


PARAMETERS

handle 

Is the value returned by a previous call to dlopen().

symbol 

Points to the character representation of the symbol's name.


RETURN VALUES

dlsym() returns the address binding of the symbol as it occurs in the shared object identified by handle. It returns a NULL pointer if the symbol cannot be found. More detailed diagnostic information is available through dlerror().


CONFORMANCE

UNIX 98, with restrictions.


MULTITHREAD SAFETY LEVEL

MT-Safe.


PORTING ISSUES

dlsym() is implemented as a pass-through to the Win32 function GetProcAddress(), and hence does not have all of the features available on some UNIX platforms. The special handle RTLD_NEXT specified in UNIX 98 is not supported. Please refer to the Win32 online documentation for more detailed information.


AVAILABILITY

PTC MKS Toolkit for Professional Developers
PTC MKS Toolkit for Professional Developers 64-Bit Edition
PTC MKS Toolkit for Enterprise Developers
PTC MKS Toolkit for Enterprise Developers 64-Bit Edition


SEE ALSO

Functions:
dlclose(), dlerror(), dlopen()


PTC MKS Toolkit 10.4 Documentation Build 39.